物联网开发平台 物模型 Topic 消息通信

这篇说明通过定义物模型事件Topic,使用MQTTX工具对接入腾讯云物联网开发平台的产品进行设备调试,包括下发指令到设备与设备上报消息到平台的操作步骤及注意事项。 下发物模型指令:订阅事件下行Topic后通过云API调用PublishMessage发送指令。 设备上报消息:在物模型定义中添加事件标识符,通过MQTTX使用JSON报文上报事件数据。

相关产品
物联网开发平台 产品页,含版本规格、价格与购买入口。

这篇主要说明如何通过定义物模型事件 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 通信内容。

赞 (0)
上一篇 4天前
下一篇 4天前