This describes the Initial Security features and requirements that will be used when forming or joining the network.
Public Attribute Documentation#
bitmask#
uint16_t sl_zigbee_initial_security_state_t::bitmask
This bitmask enumerates which security features should be used and the presence of valid data within other elements of the sl_zigbee_initial_security_state_t data structure. For more details, see the sl_zigbee_initial_security_bitmask_t.
2196 of file stack/include/sl_zigbee_types.hpreconfiguredKey#
sl_zigbee_key_data_t sl_zigbee_initial_security_state_t::preconfiguredKey
This is the pre-configured key that can be used by devices when joining the network if the Trust Center does not send the initial security data in-the-clear. For the Trust Center, it will be the global link key and must be set regardless of whether joining devices are expected to have a pre-configured Link Key. This parameter will only be used if the sl_zigbee_initial_security_state_t::bitmask sets the bit indicating SL_ZIGBEE_HAVE_PRECONFIGURED_KEY.
2205 of file stack/include/sl_zigbee_types.hnetworkKey#
sl_zigbee_key_data_t sl_zigbee_initial_security_state_t::networkKey
This is the Network Key used when initially forming the network. It must be set on the Trust Center and is not needed for devices joining the network. This parameter will only be used if the sl_zigbee_initial_security_state_t::bitmask sets the bit indicating SL_ZIGBEE_HAVE_NETWORK_KEY.
2211 of file stack/include/sl_zigbee_types.hnetworkKeySequenceNumber#
uint8_t sl_zigbee_initial_security_state_t::networkKeySequenceNumber
This is the sequence number associated with the network key. It must be set if the Network Key is set and is used to indicate a particular of the network key for updating and switching. This parameter will only be used if the SL_ZIGBEE_HAVE_NETWORK_KEY is set. Generally, it should be set to 0 when forming the network; joining devices can ignore this value.
2218 of file stack/include/sl_zigbee_types.hpreconfiguredTrustCenterEui64#
sl_802154_long_addr_t sl_zigbee_initial_security_state_t::preconfiguredTrustCenterEui64
This is the long address of the trust center on the network that will be joined. It is usually NOT set prior to joining the network and is learned during the joining message exchange. This field is only examined if SL_ZIGBEE_HAVE_TRUST_CENTER_EUI64 is set in the sl_zigbee_initial_security_state_t::bitmask. Most devices should clear that bit and leave this field alone. This field must be set when using commissioning mode. It is required to be in little-endian format.
2226 of file stack/include/sl_zigbee_types.h