文档中心>物联网开发平台>入门指引>物模型 Topic 消息通信

物模型 Topic 消息通信

最近更新时间:2025-12-29 15:26:14

我的收藏
本文主要说明如何通过定义物模型事件 Topic 对接入实例的产品进行设备调试。

前提条件

已按 实例接入指引 在用户自有账号下创建完产品、导入对应的物模型以及创建完一个设备。
已下载 MQTTX 调试工具

操作步骤

下发物模型指令到设备

1. 登录 物联网开发平台,进入目标设备的设备详情页面。
2. Topic 列表查看当前设备的物模型(属性/事件/行为)Topic。

设备事件上报
当设备需要向云端上报事件时,如上报设备的故障、告警数据,平台为设备设定了默认的 Topic:
设备事件上行请求 Topic:$thing/up/event/{ProductID}/{DeviceName}
设备事件下行响应 Topic:$thing/down/event/{ProductID}/{DeviceName}
3. 当 MQTTX 连接成功后,需要在 MQTT 工具内订阅物模型事件下行Topic

注意:
MQTT 工具提示无法订阅 Error:Not authorized(code:128),表示 Topic 字符串有误,需要检查是否添加“$”符号。

4. 打开 物模型指令控制 的云 API 在线调试,输入对应的参数后发起调用,可查看响应结果。

若发送请求返回提示“消息发送失败,设备未订阅Topic”,则需回到第3步重新订阅。

5. 发送成功后,返回至设备详情页的云日志 > 内容日志中验证通信内容是否有显示。

6. 同时也可查看 MQTTX 工具中订阅的物模型 Topic 是否有收到下发的内容指令。


设备上报消息到平台

1. 进入产品详情的功能定义页面,单击新增功能
2. 在物模型定义中添加事件类型的标识符。以定义一个电量信息的标识符为例:

3. 在 MQTTX 工具中填写物模型事件上行响应 Topic。
设备端请求报文示例:
{
"method":"event_post",
"clientToken":"1234",
"version":"1.0",
"eventId":"dianliang",
"type":"info",
"params":{
"dianliang":11
}
}
复制报文示例进行设备上行数据上报,具体参数可参见 参数说明

4. 可在设备详情页的云日志 > 内容日志事件日志查看通过 MQTTX 工具上报的指令,以及 Topic 通信内容。