Help Center> IoT Device Access> API Reference> 设备侧MQTT接口参考> 设备消息> 设备消息上报
View PDF

设备消息上报

功能描述

是指设备无法按照产品模型中定义的属性格式进行数据上报时，可调用此接口将设备的自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。

消息上报和属性上报的区别，请查看消息通信说明。

低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网平台通信时，可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。

Topic

上行：$oc/devices/{device_id}/sys/messages/up

消息上报时除了使用系统预置的消息上报topic外，设备也可以使用非平台声明的topic。如/usr/xxx/data/up

参数说明

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

消息对应的最终目标设备，没有携带则表示目标设备即topic中指定的设备。

name

可选

String

消息名称。

id

可选

String

消息的唯一标识。

content

必选

Object

消息内容。

设备消息上报时平台不会校验消息格式，这里的参数说明和示例为给的消息样例，设备可以根据需要进行自定义数据格式的上报。

示例

Topic: $oc/devices/{device_id}/sys/messages/up  
数据格式：
{
    "object_device_id": "{object_device_id}",
    "name": "name",
    "id": "id",
    "content": {"hello":"123"}
}
父主题： 设备消息