# 设备消息调试

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

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

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

# 开启消息日志

要查看这些消息，首先需要开启设备的消息日志，如下图：

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

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

# 查看错误信息

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

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

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

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

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

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

# 向设备下发消息

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

# 下发属性

# 下发命令

# 下发自定义数据

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

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

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

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

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