## 页面导读

- **适用场景**: 设备接入调试阶段，需要在平台侧快速生成、下发指令并查看解析结果，替代 MQTTX、TCP 模拟器等外部工具。
- **前置条件**: 产品已发布，且产品通讯协议为 ModbusRtu、ModbusTcp、ModbusTcpOverRtu 或 JSON 解析协议之一；设备已创建并接入平台。
- **操作路径**: 设备管理 → 设备详情 → 数据调试 → 指令生成 → 发送 → 查看数据解析。
- **验收点**: 生成的指令与预期一致，设备响应报文出现在数据调试页面并被正确解析为物模型数据。

## 1. 简介

数据调试功能是类似于MQTTX，TCP模拟器，包含以下功能：

* 指令的生成
* 常用快捷指令
* 数据解析的展示

::: tip 说明
目前只支持产品通讯协议为**ModbusRtu协议、ModbusTcp协议、ModbusTcpOverRtu协议、JSON解析协议**的指令生成，后续会进行扩展
:::

## 2. 指令生成

### 2.1. 打开数据调试

在设备管理中打开目标设备的**设备详情**，切换到**数据调试**页签。页面上方显示当前下发设备号，底部为指令输入与发送区域。

### 2.2. 配置并生成指令

点击**指令生成**，在「生成指令数据」弹窗中根据需求配置参数：

* **从机地址**：Modbus 从站地址，如 `01`
* **指令类型**：选择「下发」
* **功能码**：如 `01 读取线圈状态`
* **起始寄存器地址**：可切换十六进制显示（如 `0x0000`）
* **线圈个数**：读取或写入的线圈数量

配置完成后先点击**点击生成预览**，生成的十六进制指令（示例 `010300010001d5ca`）会显示在页面底部的下发输入框中，确认无误后点击**发送**下发到设备；也可以点击**复制数据**，将指令复制到其他工具中使用。<br> <img src="./images/debug/img21.png" style="border:1px solid #ccc;border-radius:1px;" alt="数据调试指令生成" loading="lazy"/>

### 2.3. 常用快捷指令

配置好后先点击生成预览，然后点击**添加至常用**按钮，即可添加为常用快捷指令，之后可在页面右上角的常用快捷指令列表中一键填充复用。<br> <img src="./images/debug/img22.png" style="border:1px solid #ccc;border-radius:1px;" alt="常用快捷指令" loading="lazy"/>

## 3. 数据解析

即是数据解析可视化，后续会将指令解析报错等信息也上报在数据调试模块。设备上报的原始报文以 Hex 形式展示，解析成功后标记为**已解析**，并按物模型展示名称、标识符和数据值；点击**更多解析**可查看本条报文解析出的全部物模型字段。<br> <img src="./images/debug/img23.png" style="border:1px solid #ccc;border-radius:1px;" alt="数据解析可视化 1" loading="lazy"/> <img src="./images/debug/img24.png" style="border:1px solid #ccc;border-radius:1px;" alt="数据解析可视化 2" loading="lazy"/>

## 4. 验证与排障

### 4.1. 验证

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

### 4.2. 常见问题排查

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