ZPS_eAplZdpDiscoveryCacheRequest

ZPS\_teStatus ZPS\_eAplZdpDiscoveryCacheRequest\(
    PDUM\_thAPduInstance hAPduInst,
    uint8 *pu8SeqNumber,
    ZPS\_tsAplZdpDiscoveryCacheReq
                    *psZdpDiscoveryCacheReq);

Description

This function is used to discover which nodes in the network have a primary discovery cache - that is, a bank of information about other nodes in the network. The function broadcasts a Discovery_Cache_req request to the network.

The request includes the network and IEEE addresses of the sending device, and is represented by the structure below (further detailed in Section 9.2.2.15).

typedef struct {

uint16 u16NwkAddr;

uint64 u64IeeeAddr;

} ZPS_tsAplZdpDiscoveryCacheReq;

A node with a primary discovery cache replies with a Discovery_Cache_rsp response, which should be collected using the function ZQ_bZQueueReceive() and stored in a structure of type ZPS_tsAplZdpDiscoveryCacheRsp(detailed in Section 9.2.3.14).

Parent topic:ZPS_eAplZdpDiscoveryCacheRequest

Parameters

  • hAPduInst: Handle of APDU instance in which request is sent.

  • *pu8SeqNumber: Pointer to sequence number of request.

  • *psZdpDiscoveryCacheReq: Pointer to request (see above).

Parent topic:ZPS_eAplZdpDiscoveryCacheRequest

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_eAplZdpDiscoveryCacheRequest

Parent topic:Service Discovery functions