eSE_HandleReadMeterAttributesResponse

teSE_Status eSE_HandleReadAttributesResponse(
    tsZCL_CallBackEvent *psEvent,
    uint8 *puTransactionSequenceNumber);

Description

This function should be called after eSE_ReadMeterAttributes(). The function examines the response to a ‘read attributes’ request for the Simple Metering cluster and determines whether the response is complete - that is, whether it contains all the Simple Metering attributes (the response may be incomplete if the returned data is too large to fit into a single APDU). If the response is not complete, the function will re-send ‘read attributes’ requests until all attribute values have been obtained. Any further attribute values obtained are written to the local shared device structure containing the attributes.

This function call should normally be included in the user-defined callback function that is invoked when the event E_ZCL_CBET_READ_ATTRIBUTES_RESPONSE is generated. This is the callback function which is specified when the (requesting) endpoint is registered using the appropriate endpoint registration function. The callback function must pass the generated event into eSE_HandleReadAttributesResponse().

You are also required to provide a pointer to a location to receive a Transaction Sequence Number (TSN) for the request/response.

Parameters

  • psEvent: Pointer to the generated event E_ZCL_CBET_READ_ATTRIBUTES_RESPONSE

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

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:Functions