设备消息调试
设备消息调试
ThingsCloud 控制台为您提供了快捷的设备消息调试界面,可以帮助您:
- 实时监视设备和云平台之间双向传输的所有消息。
- 查看消息格式错误的提示信息。
- 向设备下发消息,包括:下发属性、下发命令、下发自定义数据。
这些消息包括设备发送给云平台的消息,以及云平台下发给设备的消息。设备和云平台之间的所有互动都体现在消息中,所以,通过监视设备消息,可以帮助您快速定位和排查设备和云平台的通信是否符合预期。
开启消息日志
要查看这些消息,首先需要开启设备的消息日志,如下图:
每个消息可以点击右侧的图标,查看消息详情,如下图:
ThingsCloud 不仅支持 JSON
消息格式,还支持 二进制
和 Plaintext
格式,例如 RS485/Modbus RTU 消息是二进制格式,我们用 HEX
十六进制字符串形式来表示。如下图:
查看错误信息
通过消息日志,还可以监视消息格式错误的原因,帮助您排查问题。
例如,如果您在设备类型中添加了属性定义,但设备上报的属性值不符合该属性定义时,云平台会拒绝接收消息,并产生错误信息。
这里以温度属性为例,加入我们将属性的最大值设置为 10。
当设备上报的属性值不符合这个范围时,该消息便无法被云平台接收。
您可以点击查看错误详情,如下图:
在错误信息的 JSON
中,有详细的错误原因说明。这个 JSON
信息也可以由设备在上报消息后,通过订阅上报响应消息,来实时获得。
向设备下发消息
在设备调试界面中,可以快速为设备下发各类消息,可用于协议调试和设备故障排查。
下发属性
提示
如何在设备上接收云平台下发的属性?请查看 设备接收云端下发属性。
下发命令
提示
如何在设备上接收云平台下发的命令?请查看 设备接收云端下发命令。
下发自定义数据
提示
如何在设备上接收云平台下发的自定义数据?请查看 自定义数据流的 MQTT 主题。
我们在设备类型中添加自定义数据流,如下图:
这样一来,我们在设备调试界面就可以选择自定义数据流,作为下发消息的通道。
这里我们为接入的 DTU 设备下发一个 Modbus RTU 的查询指令,使用 HEX
消息格式。
DTU 将指令透传到 RS485 串口总线,获得传感器的回复消息,同时解析为传感器属性 JSON
,进入设备属性。
利用 HEX
下发消息调试功能,您还可以在设备安装部署时快捷执行一些一次性的指令,例如修改设备 Modbus 从机站号、对设备初始化配置等。