【经验】EmberZnet 中如何添加 Zll link key 和 Zll Master Key？

EFR32MG多协议SoC是 SILICON LABS 专门针对 IoT 推出的 ZigBee 方案，高达19.5dbm的发射功率，-102.7dbm的接收灵敏度，在业界内拥有最佳的RF射频性能，具有最全的Zigbee网络协议，被广泛应用在智能家居，工业控制，照明等行业。Zigbee light lighting 是专为照明设置的 zigbee profile，例如 Philips Hue ，IKEA TRÅDFRI 都是标准的 ZLL 产品；为了能够与其他 lighting 设备互联互通，这些设备都需要遵循一致的安全等级及密钥，即设备在上市之时需要使用 master key 和 zll link key；当您的产品通过 zigbee 认证后可向联盟申请上述 keys。Silicon Labs 的 EmberZNet 提供完整的方法来供用户根据实际使用场景修改 keys。

Zll Commissioning plugin 默认情况下使用 certification key，当你的产品需要上市时需要更换成 master key，那么你需要根据以下步骤来实现这个功能。

1、确定在 Plugin 表单中使能 ZLL Commissioning 和 Network Steering

2、在 callback 表单中使能 Get Distributed Key 和 Initial Security State 两个 callback

3、在projectName_callbacks.c 中实现上述两个 callback ，参考如下

EmberKeyData zllLinkKeyData = {{0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx}};

EmberKeyData zllMasterKeyData = {{0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx,0xxx}};

/** @brief Initial Security State

 *

 * This function is called by the ZLL Commissioning plugin to determine the

 * initial security state to be used by the device.  The application must

 * populate the ::EmberZllInitialSecurityState structure with a configuration

 * appropriate for the network being formed, joined, or started.  Once the

 * device forms, joins, or starts a network, the same security configuration

 * will remain in place until the device leaves the network.

 *

 * @param securityState The security configuration to be populated by the

 * application and ultimately set in the stack.  Ver.: always

 */

void emberAfPluginZllCommissioningInitialSecurityStateCallback(EmberZllInitialSecurityState *securityState)

{

emberAfCorePrintln("zllSecurityInit");

  // By default, the plugin will configure the stack for the certification

  // encryption algorithm.  Devices that are certified should instead use the

  // master encryption algorithm and set the appropriate encryption key and

  // pre-configured link key.

securityState->keyIndex = EMBER_ZLL_KEY_INDEX_MASTER ;

    MEMMOVE(emberKeyContents(&securityState->encryptionKey),

    emberKeyContents(&zllMasterKeyData),

            EMBER_ENCRYPTION_KEY_SIZE);

    MEMMOVE(emberKeyContents(&securityState->preconfiguredKey),

    emberKeyContents(&zllLinkKeyData),

            EMBER_ENCRYPTION_KEY_SIZE);

    return;

}

/** @brief Get Distributed Key

 *

 * This callback is fired when the Network Steering plugin needs to set the distributed

 * key. The application set the distributed key from Zigbee Alliance thru this callback

 * or the network steering will use the default test key.

 *

 * @param pointer to the distributed key struct

 * @return true if the key is loaded successfully, otherwise false.

 * level. Ver.: always

 */

bool emberAfPluginNetworkSteeringGetDistributedKeyCallback(EmberKeyData * key)

{

    MEMMOVE(emberKeyContents(key),

    emberKeyContents(&zllLinkKeyData),

            EMBER_ENCRYPTION_KEY_SIZE);

    return true;

}