数据调试
页面导读
适用场景设备接入调试阶段,需要在平台侧快速生成、下发指令并查看解析结果,替代 MQTTX、TCP 模拟器等外部工具。
前置条件产品已发布,且产品通讯协议为 ModbusRtu、ModbusTcp、ModbusTcpOverRtu 或 JSON 解析协议之一;设备已创建并接入平台。
操作路径设备管理 → 设备详情 → 数据调试 → 指令生成 → 发送 → 查看数据解析。
验收点生成的指令与预期一致,设备响应报文出现在数据调试页面并被正确解析为物模型数据。
1. 简介
数据调试功能是类似于MQTTX,TCP模拟器,包含以下功能:
- 指令的生成
- 常用快捷指令
- 数据解析的展示
说明
目前只支持产品通讯协议为ModbusRtu协议、ModbusTcp协议、ModbusTcpOverRtu协议、JSON解析协议的指令生成,后续会进行扩展
2. 指令生成
2.1. 打开数据调试
在设备管理中打开目标设备的设备详情,切换到数据调试页签。页面上方显示当前下发设备号,底部为指令输入与发送区域。
2.2. 配置并生成指令
点击指令生成,在「生成指令数据」弹窗中根据需求配置参数:
- 从机地址:Modbus 从站地址,如
01 - 指令类型:选择「下发」
- 功能码:如
01 读取线圈状态 - 起始寄存器地址:可切换十六进制显示(如
0x0000) - 线圈个数:读取或写入的线圈数量
配置完成后先点击点击生成预览,生成的十六进制指令(示例 010300010001d5ca)会显示在页面底部的下发输入框中,确认无误后点击发送下发到设备;也可以点击复制数据,将指令复制到其他工具中使用。
2.3. 常用快捷指令
配置好后先点击生成预览,然后点击添加至常用按钮,即可添加为常用快捷指令,之后可在页面右上角的常用快捷指令列表中一键填充复用。
3. 数据解析
即是数据解析可视化,后续会将指令解析报错等信息也上报在数据调试模块。设备上报的原始报文以 Hex 形式展示,解析成功后标记为已解析,并按物模型展示名称、标识符和数据值;点击更多解析可查看本条报文解析出的全部物模型字段。

4. 验证与排障
4.1. 验证
- 生成指令后先点击点击生成预览,核对下发输入框中的十六进制指令与预期一致(从机地址、功能码、寄存器地址与数据)。
- 点击发送后,在数据调试页面观察设备上报记录,确认响应报文被标记为已解析,且物模型名称、标识符、数据值正确。
- 对需要重复使用的指令点击添加至常用,确认其出现在常用快捷指令列表中。
4.2. 常见问题排查
- 无法生成指令:确认产品通讯协议为 ModbusRtu、ModbusTcp、ModbusTcpOverRtu 或 JSON 解析协议之一,其他协议暂不支持指令生成。
- 发送后无响应报文:确认设备在线、页面上方的下发设备号与目标设备一致,并核对从机地址、功能码与设备实际配置匹配。
- 报文未解析或解析字段缺失:检查产品物模型定义与设备上报数据位的对应关系是否正确。


