//

Trust Center Frames#


Name: trustCenterPostJoinHandler	ID: 0x0024
Description: The NCP uses the trust center behavior policy to decide whether to allow a new node to join the network (part of the trust center pre-join handler). The Host cannot change the current decision in this post-join callback, but it can change the policy for future decisions using the setPolicy command. This frame is a response to the callback command.
Response Parameters:
sl_802154_short_addr_t newNodeId	The Node Id of the node whose status changed
sl_802154_long_addr_t newNodeEui64	The EUI64 of the node whose status changed.
sl_zigbee_device_update_t status	The status of the node: Secure Join/Rejoin, Unsecure Join/Rejoin, Device left.
sl_zigbee_join_decision_t policyDecision	An sl_zigbee_join_decision_t reflecting the decision made.
sl_802154_short_addr_t parentOfNewNodeId	The parent of the node whose status has changed.


Name: broadcastNextNetworkKey	ID: 0x0073
Description: This function broadcasts a new encryption key, but does not tell the nodes in the network to start using it. To tell nodes to switch to the new key, use sl_zigbee_send_network_key_switch(). This is only valid for the Trust Center/Coordinator. It is up to the application to determine how quickly to send the Switch Key after sending the alternate encryption key.
Command Parameters:
sl_zigbee_key_data_t key	An optional pointer to a 16-byte encryption key (SL_ZIGBEE_ENCRYPTION_KEY_SIZE). An all zero key may be passed in, which will cause the stack to randomly generate a new key.
Response Parameters:
sl_status_t status	sl_status_t value that indicates the success or failure of the command.


Name: broadcastNetworkKeySwitch	ID: 0x0074
Description: This function broadcasts a switch key message to tell all nodes to change to the sequence number of the previously sent Alternate Encryption Key.
Command Parameters: None
Response Parameters:
sl_status_t status	sl_status_t value that indicates the success or failure of the command.


Name: aesMmoHash	ID: 0x006F
Description: This routine processes the passed chunk of data and updates the hash context based on it. If the 'finalize' parameter is not set, then the length of the data passed in must be a multiple of 16. If the 'finalize' parameter is set then the length can be any value up 1-16, and the final hash value will be calculated.
Command Parameters:
sl_zigbee_aes_mmo_hash_context_t context	The hash context to update.
bool finalize	This indicates whether the final hash value should be calculated
uint8_t length	The length of the data to hash.
uint8_t[] data	The data to hash.
Response Parameters:
sl_status_t status	The result of the operation
sl_zigbee_aes_mmo_hash_context_t returnContext	The updated hash context.


Name: removeDevice	ID: 0x00A8
Description: This command sends an APS remove device using APS encryption to the destination indicating either to remove itself from the network, or one of its children.
Command Parameters:
sl_802154_short_addr_t destShort	The node ID of the device that will receive the message
sl_802154_long_addr_t destLong	The long address (EUI64) of the device that will receive the message.
sl_802154_long_addr_t targetLong	The long address (EUI64) of the device to be removed.
Response Parameters:
sl_status_t status	An sl_status_t value indicating success, or the reason for failure.


Name: unicastNwkKeyUpdate	ID: 0x00A9
Description: This command will send a unicast transport key message with a new NWK key to the specified device. APS encryption using the device's existing link key will be used.
Command Parameters:
sl_802154_short_addr_t destShort	The node ID of the device that will receive the message
sl_802154_long_addr_t destLong	The long address (EUI64) of the device that will receive the message.
sl_zigbee_key_data_t key	The NWK key to send to the new device.
Response Parameters:
sl_status_t status	An sl_status_t value indicating success, or the reason for failure.