14.2.3.1.3 BDB Security
InstallCode
In Centralized network, there are two types of key that can be used to allow the devices to join.
- i. Global trust center link key
- This is the link key used for joining centralized security networks. Which is 0x5a 0x69 0x67 0x42 0x65 0x65 0x41 0x6c 0x6c 0x69 0x61 0x6e 0x63 0x65 0x30 0x39
- ii. Install code link key
- This is the link key derived from install code from joining device to create unique trust center link key for joining.
The install code derived preconfigured link key is generated from a random install code created for the product and provided to the node in a manufacturer-specific way and referred to during installation.
Application interface API to be used to configure install code:
void BDB_ConfigureInstallCode(ExtAddr_t deviceAddress, uint8_t *installCode,IcStatusCallback_t pfCallback);
Following example illustrates the usage of configuring install code
// define the callback to be called after configuring install code void myICCallback(InstallCode_Configuration_Status_t status) { .... } ExtAddr_t devAddr = 0xFFFFFFFFFFFFFFFF; //Update the install code from user input uint8_t icode[18]; BDB_ConfigureInstallCode(devAddr, icode, myICCallback);
Parameters:
- deviceAddress -device address shall be 0xfffffffffffffff on Joining device & Extended Address of the joining device on Trust center
- installCode - 18-byte install code (including 16 byte install code + 2 byte CRC)
- pfCallback - Callback to be called once the operation is complete