Releasing Data

Updated on 2022-02-24 GMT+08:00

View PDF

API Function

This API is used by the gateway to release data of directly connected devices or indirectly connected devices to the IoT platform. For data releasing scenarios, the released data can be defined as a topic. In addition, the package body needs to be assembled to the input parameters. The data is transparently transmitted internally instead of being assembled.

API Description

1	HW_INT IOTA_MqttDataPub (HW_UINT uiCookie, const HW_UCHAR pucTopic, HW_UINT uiQos, const HW_BYTES pbstrServiceData);

Parameter Description

Parameter	Mandatory or Optional	Type	Description
uiCookie	Optional	unsign int	The value ranges from 1 to 65535.
pucTopic	Mandatory	String	Specifies the topic for releasing data. The value must end with \0.
uiQos	Mandatory	unsign int	Specifies the value of MQTT. Default value: 1
pbstrServiceData	Mandatory	HW_BYTES	Specifies the package for releasing data.

Return Value

For details, see 4.2 Function Return Values.

Output

Broadcast Name	Broadcast Parameter	Member	Description
IOTA_TOPIC_MQTT_DATA_PUB_RSP	HW_MSG object	EN_IOTA_DATATRANS_IE_RESULT	Specifies the data release result. 0: indicating that the data is released. 1: indicates that the data releasing fails.

Broadcast Name

Broadcast Parameter

Member

Description

IOTA_TOPIC_MQTT_DATA_PUB_RSP

HW_MSG object

EN_IOTA_DATATRANS_IE_RESULT

Specifies the data release result.

0: indicating that the data is released.
1: indicates that the data releasing fails.

Example

1
2
3

HW_BYTES bstrBody; 
...
IOTA_MqttDataPub (1211, "/huawei/v1/devices/336d9bac-9ebf-44e9-95cf-efac5f05da3a/services/Storage", 1, bstrBody);

The device waits for the data reporting result.

//Developers call this API to register the function for subsequent processing after the device service data is reported.
HW_iNT Device_DataPubResultHandler(HW_UiNT uiCookie, HW_MSG pstMsg) 
{
    uiResult = HW_MsgGetUint(pstMsg, EN_IOTA_DATATRANS_IE_RESULT);
    if (HW_SUCCESS != uiResult) 
    {
        // retry with uiCookie 
        return 0;
    }
    return 0;
}
//After the device is added, register a broadcast to receive the service data reporting result: HW_BroadCastReg("IOTA_TOPIC_MQTT_DATA_PUB_RSP", Device_AddResultHandler);

Parent topic: API Description

Previous topic: Receiving Device Commands

Next topic: JSON Component Description

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot