ZPS_eAplZdoRequestKeyReq

ZPS_teStatus ZPS_eAplZdoRequestKeyReq(
                    uint8 u8KeyType,
                    uint64 u64IeeePartnerAddr);

Description

This function can be used to request a link key from the Trust Centre for application-level security. The possible key types that can be requested are:

• Application link key: This key is used to encrypt/decrypt communications with another ‘partner node’. The IEEE/MAC address of this partner node must be specified as part of the function call. The Trust Centre responds by sending the application link key to both the local node and the partner node. When it arrives, the stack automatically saves this key. Also, the event ZPS_EVENT_ZDO_LINK_KEY is generated once the link key has been installed and is ready for use.

• Trust Centre Link Key (TCLK): This key is used to encrypt/decrypt communications between the Trust Centre and the local node. The Trust Centre responds by sending the TCLK to the requesting node.

While requesting a TCLK, the function parameter u64IeeePartnerAddris ignored.

For more information on requesting link keys, refer to Section 6.8.3.2.

Parent topic:ZPS_eAplZdoRequestKeyReq

Parameters

• u8KeyType Type of key to request:

  • 2 - application link key

  • 4 - Trust Centre Link Key (TCLK)

  • All other values reserved

• u64IeeePartnerAddr IEEE/MAC address of partner node (for application link key)

Parent topic:ZPS_eAplZdoRequestKeyReq

Returns

• ZPS_E_SUCCESS (request successfully sent)

• APS return codes, listed and described in Section 11.2.2

• NWK return codes, listed and described in Section 11.2.3

• MAC return codes, listed and described in Section 11.2.4

Parent topic:ZPS_eAplZdoRequestKeyReq

Parent topic:Security functions