eZCL_HandleReadAttributesResponse

teZCL_Status eZCL_HandleReadAttributesResponse(
    tsZCL_CallBackEvent *psEvent,
    uint8 *pu8TransactionSequenceNumber);

Description

This function can be used to examine the response to a ‘read attributes’ request for a remote cluster and determine whether the response is complete - that is, whether the ‘read attributes’ response contains all the relevant attribute values (it may be incomplete if the returned data is too large to fit into a single APDU).

eZCL_HandleReadAttributesResponse() should normally be included in the user-defined callback function that is invoked on generation of the event E_ZCL_CBET_READ_ATTRIBUTES_RESPONSE. The callback function must pass the generated event into eZCL_HandleReadAttributesResponse().

If the ‘read attributes’ response is not complete, the function will re-send ‘read attributes’ requests until all relevant attribute values have been received.

You are also required to provide a pointer to a location to receive a Transaction Sequence Number (TSN) for the request. The TSN in the response is set to match the TSN in the request, allowing an incoming response to be paired with a request. This is useful when sending more than one request to the same destination endpoint.

Parameters

  • psEvent        Pointer to generated event of the type E_ZCL_CBET_READ_ATTRIBUTES_RESPONSE

  • pu8TransactionSequenceNumber        Pointer to a location to store the Transaction Sequence Number (TSN) of the request

Returns

  • E_ZCL_SUCCESS

  • E_ZCL_ERR_CLUSTER_NOT_FOUND

  • E_ZCL_ERR_CLUSTER_ID_RANGE

  • E_ZCL_ERR_EP_UNKNOWN

  • E_ZCL_ERR_EP_RANGE

  • E_ZCL_ERR_ATTRIBUTE_WO

  • E_ZCL_ERR_ATTRIBUTES_ACCESS

  • E_ZCL_ERR_ATTRIBUTE_NOT_FOUND

  • E_ZCL_ERR_PARAMETER_NULL

  • E_ZCL_ERR_PARAMETER_RANGE

Parent topic:Attribute Access Functions