( PH:0x02, SH:0x20 ) - Trust Center Install Code AddOverviewThe Trust Center Install Code Add command is sent by the Host to the Module to commission a new device to the network with that install code. This is used in the scenario when Module is configured as a coordinator (trust center) and trying to commission other devices onto the network. Module will use a link key derived from the install code to authenticate the joining device. Host must add the install codes before opening the permit join window for devices to join. The install codes are cleared when Module leaves the network, or loses power, or receives the command Clear Trust Center Install Codes. The maximum number of device install codes that can be added is indicated by Trust Center Install Code Max Count Response(Default size of 3). NOTE: The Maximum number of devices that can be added by install code at once is 3. Once devices have been commissioned onto the network, the Install Codes should be cleared by sending the 'Clear Trust Center Install Codes' command or waiting 5 minutes for the Install Code table to clear. Once new Install Codes are added using this command, the user should initiate network steering to commission the new devices. Users implementing their own Host application should consider how users will commissioning devices using Install Codes and provide the required interfaces. NOTE: If a device that joins a network by install code, subsequently leaves the network, the user must re-add the device install code in order for it to join the network by install code again.
Payload Byte Index | Field Name | Notes |
---|
0..7 | EUI64 Address | EUI64 of the device, which the install code belongs to, LSB First | 8 | Install Code Size | The size in bytes n of the Installation Code, including the two-byte CRC, where n can be any of 8, 10, 14, or 18 | 9..8+n | Install Code | MSB First |
Effect on ReceiptModule shall send Status Response with the following list of possible status Status Response | Enum | Description |
---|
Success | 0x00 | Install code successfully added | Invalid Data | 0x02 | Install code is invalid (e.g. invalid length, invalid CRC) | Storage Full | 0x04 | Exceeding max number of device install codes that can be added |
Allowed ContextNetwork Up. Sent By Host/ModuleHost. |