设备消息调试

ThingsCloud 控制台为您提供了快捷的设备消息调试界面，可以帮助您：

• 实时监视设备和云平台之间双向传输的所有消息，包括 JSON、Plaintext、二进制等格式。
• 查看消息错误的提示信息。
• 快速向设备下发消息进行测试，包括：下发属性、下发命令、下发自定义数据。

设备和平台之间的所有通信，都体现在消息中，这些消息既包括设备发送给平台的消息，也包括平台下发给设备的消息。因此，通过监视设备消息，可以帮助您快速定位和排查设备和平台的通信是否符合预期。

开启消息日志

要查看设备消息，首先需要开启设备的消息日志。开启消息日志后，平台会记录该设备的所有消息。如下图：

每条消息可以点击右侧的图标，查看消息详情，如下图：

ThingsCloud 不仅支持 JSON 消息格式，还支持二进制和 Plaintext 格式，例如 RS485/Modbus RTU 消息是二进制格式，通常用 HEX 十六进制字符串形式来表示它。如下图：

查看错误信息

通过消息日志，还可以监视消息格式错误的原因，帮助您排查问题。

例如，如果您在设备类型中添加了属性定义，但设备上报的属性值不符合该属性定义时，云平台会拒绝接收消息，并产生错误信息。

这里以温度属性为例，假如我们将属性的最大值设置为 10。

当设备上报的属性值不符合这个范围时，该消息便无法被平台接收。

您可以点击查看错误详情，如下图：

在错误信息的 JSON 中，有详细的错误原因说明。这个 JSON 信息也可以由设备在上报消息后，通过订阅上报响应消息，来实时获得。

向设备下发消息

在设备调试界面中，可以快速为设备下发各类消息，可用于协议调试和设备故障排查。

学习视频

下发属性

选择属性下发，在编辑器中填写要下发的属性 JSON 消息。

下发命令

下发自定义数据

我们在设备类型中添加自定义数据流，如下图：

这样一来，我们在设备调试界面就可以选择自定义数据流，作为下发消息的通道。

这里我们为接入的 DTU 设备下发一个 Modbus RTU 的查询指令，使用 HEX 消息格式。

DTU 将指令透传到 RS485 串口总线，获得传感器的回复消息，同时解析为传感器属性 JSON，进入设备属性。

利用 HEX 下发消息调试功能，您还可以在设备安装部署时快捷执行一些一次性的指令，例如修改设备 Modbus 从机站号、对设备初始化配置等。