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.


Definition at line 2186 of file stack/include/sl_zigbee_types.h

preconfiguredKey#

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.


Definition at line 2195 of file stack/include/sl_zigbee_types.h

networkKey#

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.


Definition at line 2201 of file stack/include/sl_zigbee_types.h

networkKeySequenceNumber#

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.


Definition at line 2208 of file stack/include/sl_zigbee_types.h

preconfiguredTrustCenterEui64#

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.


Definition at line 2216 of file stack/include/sl_zigbee_types.h