Skip to content

数据调试 ​

页面导读 ​

适用场景设备接入调试阶段,需要在平台侧快速生成、下发指令并查看解析结果,替代 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 形式展示,解析成功后标记为已解析,并按物模型展示名称、标识符和数据值;点击更多解析可查看本条报文解析出的全部物模型字段。
数据解析可视化 1数据解析可视化 2

4. 验证与排障 ​

4.1. 验证 ​

  1. 生成指令后先点击点击生成预览,核对下发输入框中的十六进制指令与预期一致(从机地址、功能码、寄存器地址与数据)。
  2. 点击发送后,在数据调试页面观察设备上报记录,确认响应报文被标记为已解析,且物模型名称、标识符、数据值正确。
  3. 对需要重复使用的指令点击添加至常用,确认其出现在常用快捷指令列表中。

4.2. 常见问题排查 ​

  • 无法生成指令:确认产品通讯协议为 ModbusRtu、ModbusTcp、ModbusTcpOverRtu 或 JSON 解析协议之一,其他协议暂不支持指令生成。
  • 发送后无响应报文:确认设备在线、页面上方的下发设备号与目标设备一致,并核对从机地址、功能码与设备实际配置匹配。
  • 报文未解析或解析字段缺失:检查产品物模型定义与设备上报数据位的对应关系是否正确。