(0x02) Security Configuration Frames
This section describes commands that set and report on security keys.
( PH:0x02, SH:0x03 ) - Install Code Request Command
Overview
The Install Code Request frame is sent by the Host to the Module to query the application Installation Code. It should be noted that the Installation Code is assigned to the Module at production time and cannot be modified.
Payload
This command has no payload.
Effect on Receipt
The Module responds with an Install Code Response
Allowed Context
All Contexts.
Sent By Host/Module
Host.
( PH:0x02, SH:0x04 ) - Install Code Response Command
Overview
The Install Code Response frame is sent by the Module to the Host when queried with an Install Code Request.
Payload
Byte Index | Field Name | Notes |
|---|---|---|
0 | Installation Code Length | 8, 10, 14, or 18 as defined by the Zigbee Smart Energy Specification + 2 due to inclusion of CRC |
1..n | Installation Code | MSB First |
Effect on Receipt
None.
Allowed Context
Same context as request.
Sent By Host/Module
Module.
( PH:0x02, SH:0x05 ) - Link Key Write Command
Overview
The Link Key Write command is sent by the Host to the Module in order to set the application Preconfigured Link Key. The Host may only set the Preconfigured Link Key while the application is in the Network Down state.
If the Host subsequently forms a network as a coordinator, the key will be applied as the Global Trust Center Link Key. Otherwise, if the Host joins a network as either a router or end device, the key will be applied as the Joining Key.
The Preconfigured Link Key is not stored in non-volatile memory and must therefore be set prior to forming or joining a network subsequent to a Reset or power-cycle. If the Host does not manually set the key, the application will use the default Preconfigured Link Key specified by the Zigbee Home Automation Specification.
Payload
Byte Index | Field Name | Notes |
|---|---|---|
0..15 | Preconfigured Link Key | Default = {0x5A, 0x69, 0x67, 0x42, 0x65, 0x65, 0x41, 0x6C, 0x6C, 0x69, 0x61, 0x6E, 0x63, 0x65, 0x30, 0x39} = “ZigbeeAlliance09” |
Effect on Receipt
The Module will apply this Preconfigured Link Key when it either forms or joins a network, the latter when the Joining Key Option corresponds to Preconfigured Link Key.
Allowed Context
Network Down.
Sent By Host/Module
Host.