跳至主要內容

数据上报

技术中心大约 2 分钟

数据上报

通过MQTTX上报数据

获取通过MQTTX上报数据TOPIC

获取TOPIC
获取TOPIC

构建上报数据

通过MQTTX模拟设备上报数据,消息Topic和上报格式如下:
Topic为上一步获取的/sys/87jDnFiXv/nwBYzJE5fB/thing/event/property/post
上报json数据格式为:

{
    "id": "123",
    "version": "1.0",
    "params": {
        "temp": 23.9,
        "humidity": 94.6
    },
    "method": "thing.event.property.post"
}

数据内容说明:

参数类型说明
idString消息ID号。String类型的数字,取值范围0~4294967295,且每个消息ID在当前设备中具有唯一性。
versionString协议版本号,目前协议版本号唯一取值为1.0。
methodString请求方法。例如:thing.event.property.post
paramsObject请求参数。如以上示例中,设备上报了的两个属性Power(电源)和WF(工作电流)的信息。具体属性信息,包含属性上报时间(time)和上报的属性值(value)。

若仅传入属性值,无需上传字段timevalueparams示例如下:

"params": {
    "temp": 23.9,
    "humidity": 94.6
}

如果是自定义模块属性,属性标识符格式为${模块标识符}:${属性标识符}(中间为英文冒号)。例如:

"test:temp": {
    "value": 23.9,
    "time": 1524448722000
},
"test:humidity": {
    "value": 94.6,
    "time": 1524448722000
},
timeLong属性上报时间戳,类型为UTC毫秒级时间。该参数为可选字段。根据您的业务场景决定消息中是否带时间戳。如果消息频繁,需根据时间戳判断消息顺序,建议消息中带有时间戳。
  • 若上传time,物联网平台的云端保存上传的时间作为属性上报时间。
  • 若不上传time,物联网平台的云端自动生成属性上报时间并保存。
valueObject上报的属性值。

若不上传time,可不上传value,直接上传参数值即可。

使用MQTTX发送数据到平台

设备连接MQTTX后,推送正确数据格式,设备物模型数据显示推送的值和更新数据时间。
发送数据
发送数据
发送数据