串口调试助手

串口助手用于观察原始收发、发送已知协议命令、保存通信记录。日常改终端参数优先使用串口配置；助手不会自动把任意收到的数据解释为正确配置。

串口调试与收发记录 · 下载视频

从哪里打开

首页选择 串口调试助手。已经进入设备配置页时，也可用 更多（⋮）→ 串口调试助手 打开调试面板；返回配置页面 用于关闭该面板回到配置页。

串口助手：左侧观察收发，右侧设置连接参数、显示方式和日志操作。 点击放大

串口助手：左侧观察收发，右侧设置连接参数、显示方式和日志操作。

1. 设置并打开串口

1. 根据插拔前后的端口列表确认适配器，选择正确端口。
2. 按对端要求设置波特率、数据位、停止位、校验位。
3. 首页参数区点击 开始连接 进入收发页；在收发页的 设置 面板中，未连接时按钮是 打开串口，已连接时是 关闭串口。连接中或已连接时设置面板的通信参数锁定，要改端口/波特率先关闭串口。
4. 若从配置页进入，先查看当前连接，不要重复打开已占用端口。
5. 等待对端主动上报，或按协议发起一次已知查询。

从蓝牙配置页打开 串口调试助手，操作的仍是电脑串口，不会自动变为蓝牙收发工具。蓝牙原始记录使用 更多 → 蓝牙日志。

同一端口通常不能同时被配置页、Modbus 工具和其他软件独占打开。端口打开失败先查占用；打开成功却没数据，继续检查对端是否应主动发送、供电、接线和通信参数。

连接与显示设置区域。使用自己的端口参数，不照抄截图端口。 点击放大

连接与显示设置区域。使用自己的端口参数，不照抄截图端口。

2. 选择接收显示方式

选项	何时使用	怎样理解结果
HEX 显示	二进制、Modbus、自定义帧	两个 HEX 字符为一个字节
文本显示	可打印字符、文本命令	二进制可能显示乱码，不代表字节丢失
时间显示	分析请求/响应顺序和间隔	显示行不一定就是一个完整协议帧
气泡/经典视图	按阅读习惯观察	只改变呈现方式
高性能/兼容渲染	调整大量日志时的显示	不改变协议、波特率和实际发送内容

开启接收 HEX 后，当前气泡视图可同时显示文本和十六进制字节。文本列仍有不可打印字符时，对照字节列查看，不将乱码当成丢字节。

接收 HEX 和发送 HEX 是两个方向的选项。 改成 HEX 显示，并不意味着发送框也已按 HEX 发出。发送前单独检查发送面板。

3. 手动发送一条指令

发送面板和指令分组：本图为测试 DTU 的已知唤醒命令，不能直接套给其他设备。先核对格式、换行和目标，再发送。 点击放大

发送面板和指令分组：本图为测试 DTU 的已知唤醒命令，不能直接套给其他设备。先核对格式、换行和目标，再发送。

1. 取得适用于目标型号/固件的完整命令。
2. 选择 HEX 或文本发送模式。
3. 填入内容，核对长度、地址、功能码、校验。
4. 按协议决定是否追加 CRLF（回车换行）。二进制帧不要随意追加文本换行。
5. 核对当前端口，发送一次。
6. 对照接收记录确认响应地址、命令、长度、内容和校验。

输入 01 03	实际含义
HEX 发送	两个字节：0x01、0x03
文本发送	字符 0、1、空格、0、3

上表只解释格式，不是完整设备查询指令。写寄存器、控制输出、重启和恢复出厂可能改变现场状态，应先确认命令用途。

4. 搜索、清空与保存记录

在 设置 面板将 渲染模式 选为 高性能，才会显示 搜索，且 保存 菜单才提供选中日志、搜索结果等范围。兼容 模式只提供全部日志保存。搜索入口是否出现取决于渲染模式，与气泡/经典视图是两项独立设置。

1. 问题发生后先保留当前记录，不立即清空。
2. 搜索目标命令或地址，定位前后收发。
3. 保存时确认范围涵盖请求、响应和错误，而非只有最后一行。
4. 在选定目录确认文件已保存，并打开检查内容。
5. 确定无需保留后，再清空显示以开始新一轮测试。

设置面板下方的搜索、保存和视图选项；保存前先核对日志范围。 点击放大

设置面板下方的搜索、保存和视图选项；保存前先核对日志范围。

清空显示不是恢复终端，也不会撤销已发送命令。问题反馈时附上操作时间、端口参数、发送格式以及完整 TX/RX，见日志说明。

高性能渲染：搜索可用，保存菜单有全部、选中、搜索结果三项。离线界面示例。 点击放大

高性能渲染：搜索可用，保存菜单有全部、选中、搜索结果三项。离线界面示例。

兼容渲染：搜索隐藏，保存菜单仅有全部数据。离线界面示例，未发送指令。 点击放大

兼容渲染：搜索隐藏，保存菜单仅有全部数据。离线界面示例，未发送指令。

5. 管理常用指令

1. 按用途建立/选择分组，例如“某型号-只读查询”。
2. 添加指令，名称写清作用、适用型号和必要条件。
3. 核对指令内容、HEX/文本和换行选项。
4. 使用前再次检查当前目标设备。
5. 交接时通过指令分组自己的导入/导出入口处理，并附协议说明。

指令列表文件与终端配置 JSON 不同。切换分组后仍检查发送格式，不因指令名叫“读取”就认定内容一定只读。

6. 测试结束

保存需要的记录，确认没有发送中的任务后点击 关闭串口。这是原始端口关闭操作；配置页的 断开设备 会先尝试重启，二者不同。

发送后无响应或乱码

现象	处理
端口打不开	检查占用、驱动、插拔变化和设备权限
TX 有记录，RX 没有	核对对端供电、接线、地址、命令、HEX/文本、换行和校验
RX 是乱码	先切 HEX，再核对串口参数；二进制本来就不一定可打印
RX 有数据但不是预期	检查是否为其他上报/回显，按协议重新分帧判断
多条记录交错	停止并行任务，单次发送复现，保留时间信息