ZPS_eAplZdpIEEEAddrRequest

ZPS\_teStatus ZPS\_eAplZdpIeeeAddrRequest\(
     PDUM\_thAPduInstance hAPduInst,
     ZPS\_tuAddress uDstAddr,
     bool bExtAddr,
     uint8 *pu8SeqNumber,
     ZPS\_tsAplZdpIeeeAddrReq *psZdpIeeeAddrReq);

Description

This function requests the 64-bit IEEE (MAC) address of the node with a particular 16-bit network address. The function sends an IEEE_addr_req request to the relevant node, specified through uDstAddr.

The network address of the node of interest must also be specified in the request, represented by the structure below (detailed further in Section 9.2.2.2).

typedef struct {

uint16 u16NwkAddrOfInterest; uint8 u8RequestType;

uint8 u8StartIndex;

} ZPS_tsAplZdpIeeeAddrReq;

The required IEEE address is received in an IEEE_addr_resp response, which should be collected using the function ZQ_bZQueueReceive() and stored in a structure of type ZPS_tsAplZdpIeeeAddrRsp(detailed in Section 9.2.3.2). Note that this response can optionally contain the IEEE addresses of the responding node’s neighbors (this option is selected as part of the request through u8RequestType).

Parent topic:ZPS_eAplZdpIEEEAddrRequest

Parameters

  • hAPduInst Handle of APDU instance in which request is sent

  • uDstAddr Network address of destination node of request (bExtAddrmust be set to FALSE - see below)

  • bExtAddr Type of destination address: TRUE: 64-bit IEEE (MAC) address FALSE: 16-bit network address

    • * pu8SeqNumber Pointer to sequence number of request

    • * psZdpIeeeAddrReq Pointer to request (see above)

Parent topic:ZPS_eAplZdpIEEEAddrRequest

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_eAplZdpIEEEAddrRequest

Parent topic:Address discovery functions