eSE_PriceGetConversionFactorEntry

teSE_PriceStatus eSE_PriceGetConversionFactorEntry(
    uint8 u8SourceEndPointId,
    bool_t bIsServer,
    uint8 u8TableIndex,
    sSE_PricePublishConversionCmdPayload
    **ppsPublishConversionCmdPayload);

Description

This function can be used to obtain the entry with the specified index from the conversion factor list on the local device. For example, the function can be used on an IPD to obtain a conversion factor to display.

You must specify the endpoint on which the local Price cluster resides and whether this cluster instance is a server or a client.

Parameters

  • u8SourceEndPointId: Number of the local endpoint for the conversion factor list to be accessed

  • bIsServer: Nature of the Price cluster instance containing the list:

    • TRUE - server (example on ESP)

    • FALSE - client (example on IPD)

  • u8TableIndex: The index of the entry to obtain from the conversion factor list (index 0 is the entry with the oldest start-time and may contain the currently active conversion factor)

  • ppsPublishConversionCmdPayload: Pointer to a pointer to a structure which will be used to store the obtained conversion factor information (see Section40.11.2), if found. The pointer value that is returned in this parameter points to the structure in the internal storage associated with the list. The data in the structure will be valid as long as the item remains in the list

Returns

  • E_ZCL_SUCCESS

  • E_ZCL_FAIL

  • E_ZCL_ERR_PARAMETER_NULL

  • E_ZCL_ERR_CLUSTER_NOT_FOUND

  • E_SE_PRICE_TABLE_NOT_FOUND

Parent topic:Functions