5.1.2.15 ZDO_ResolveAddrReq Function

Syntax

void ZDO_ResolveAddrReq(ZDO_ResolveAddrReq_t *req);

Description

The function actively resolves the missing short address using the corresponding extended address or vice versa. It initiates a ZDP request based on the required address type, which is an IEEE® address ZDP request for determining the extended address or a short address ZDP request for the short address. Upon completion, the function’s callback reports the ZDP request’s outcome. Successful requests yield the necessary addressing information as an argument.

The stack calls this function in various scenarios where a device’s pair of short and extended addresses is incomplete. These scenarios include:
  • Sending a data request with incomplete destination information
  • Utilizing APS_EXT_ADDRESS or APS_NO_ADDRESS modes when the short address is unknown
  • Employing short address addressing with link key security but lacking the extended address for link key retrieval
  • Verifying the extended address upon receiving an encrypted frame
The function’s response statuses are accessible through the ZDO_ResolveAddrConf_t-status field in the ZDO_ResolveAddrReq_t-ZDO_ResolveAddrConf callback’s argument. The statuses include:
  • ZDO_SUCCESS_STATUS (0x00) – Indicates successful determination of the requested address
  • ZDO_INVALID_REQUEST_STATUS (0x80) – Signifies that the address resolving module is not enabled
  • Additional error codes as reported by the ZDO_ZdpReq() function
Input Parameters
Parameter NameDescription
reqRequest structure to pass attribute ID
Return Type and Values
  • None