EmberInitialSecurityState Struct Reference

Ember Common Data Types

This bitmask enumerates which security features should be used and the presence of valid data within other elements of the EmberInitialSecurityState data structure. For more details, see the EmberInitialSecurityBitmask .

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 EmberInitialSecurityState::bitmask sets the bit indicating EMBER_HAVE_NETWORK_KEY .

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 EMBER_HAVE_NETWORK_KEY is set. Generally, it should be set to 0 when forming the network; joining devices can ignore this value.

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 EmberInitialSecurityState::bitmask sets the bit indicating EMBER_HAVE_PRECONFIGURED_KEY .

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 EMBER_HAVE_TRUST_CENTER_EUI64 is set in the EmberInitialSecurityState::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.