友善串口调试助手帮助中心

快速开始

如果只是想确认软件、驱动、线缆和目标设备能否正常通信，可以先按这条路径走。

1. 从下载页面获取最新版本并完成安装。
2. 安装开发板或 USB 转串口适配器需要的驱动。
3. 插入目标设备，在设备管理器里确认 COM 口已经出现。
4. 选择对应端口，并让参数与设备一致。常见起点是 115200 / 8 / 1 / None。
5. 可读命令和日志优先用 Text 模式；二进制报文和逐字节核对优先用 Hex 模式。
6. 发送一条已知命令，观察连接状态以及 Rx、Tx 计数是否变化。

第一次测试失败时，不要同时改很多设置。建议按端口、驱动、线缆、串口参数、行尾符的顺序逐项确认。

连接与串口参数

串口通信能否成功，核心前提是两端链路参数完全一致。

• 端口：操作系统分配的 COM 口。设备重新插拔后端口号可能变化。
• 波特率：必须与目标设备一致，常见值包括 9600、115200、460800、921600。
• 数据位：通常是 8。
• 停止位：通常是 1。
• 校验位：通常是 None，但工业设备可能使用 Even 或 Odd。
• 流控：除非设备文档明确要求 RTS/CTS 或 XON/XOFF，否则先保持关闭。
• 行尾符：AT 类设备经常要求 CRLF，有些老设备只要求 CR 或 LF。

软件支持自定义波特率，但高速通信是否稳定仍取决于串口芯片、驱动、线缆质量和目标固件。

Text 与 Hex 使用方式

协议可读时优先用 Text 模式，例如 AT 命令、启动日志、控制台输出和按行返回的消息。

协议是二进制时优先用 Hex 模式，例如 Modbus RTU、私有 UART 帧、传感器报文、Bootloader 帧或包含不可打印字节的数据。

实用检查方法：

• 文本乱码时，先确认波特率，再检查编码和显示模式。
• 二进制命令无效时，用 Hex 模式核对实际发出的每个字节。
• 命令需要行尾符时，优先配置自动追加，不要手动输入不可见字符。
• 常用报文建议保留空格，例如 01 03 00 00 00 02 C4 0B，后续排查更容易读。

自动发送与命令清单

自动发送适合轮询、老化测试和重复协议检查。

• 循环发送：按固定间隔重复发送当前命令。
• 按行发送：把多条命令按行依次发送。
• 发送历史：高频调试时可快速复用常用命令。
• 暂停和停止：需要观察数据或切换固件、释放端口时使用。

如果要做设备初始化脚本，建议每行一条命令，先用较慢间隔验证顺序，再逐步降低发送间隔。

日志与长时间抓取

问题偶发、需要复现或需要交给别人分析时，建议提前开启日志。

推荐习惯：

• 为每条接收和发送数据启用时间戳。
• 日志文件名里带上端口、项目或日期。
• 长时间测试时按大小或时间轮转日志。
• 问题出现后先打开当前日志，并保留原始文件。
• 联系支持时附上一小段报文样例，方便复现症状。

做 24 小时测试或产线记录前，先确认日志保存位置和轮转规则。

CRC 与 Modbus 校验

CRC 不一致通常来自四类原因：载荷字节不对、字节序不对、CRC 算法参数不对，或者报文边界/行尾处理不对。

推荐流程：

1. 复制不含 CRC 字节的原始 Hex 载荷。
2. 选择目标协议要求的 CRC 算法，例如 Modbus RTU 常见的是 CRC-16/MODBUS。
3. 如果供应商文档给出参数，核对 width、poly、init、xorout、refin、refout。
4. 按协议要求的字节序把计算结果追加到报文末尾。
5. 发送报文，并对照设备返回的原始字节。

如果设备完全不返回，先确认物理链路和串口参数。只有设备确实收到报文后，CRC 排查才有意义。

TCP 与 UDP 调试

串口转网络模块、DTU 和网关设备，经常需要同时看串口侧和网络侧。

• TCP Client：连接设备、网关或测试服务器。
• TCP Server：本地监听端口，观察客户端接入和上报。
• UDP：测试数据报协议、类似广播的发现流程或网关转发。
• Hex 模式：TCP/UDP 传二进制载荷时同样适用，不只用于串口。
• 日志：对比串口侧和网络侧数据时，建议同时保存网络侧日志。

TCP 或 UDP 不通时，重点检查 IP、端口、防火墙、子网、网关模式，以及本地端口是否已经被其他进程占用。

排障清单

看不到串口：

• 重新插拔 USB 设备，换一根线或换一个 USB 口。
• 打开设备管理器，安装正确的 CH340、CP210x、FTDI 或厂商驱动。
• 确认设备已供电，并且不处于只能刷固件的特殊模式。

串口无法打开：

• 关闭其他串口工具、IDE 串口监视器和烧录工具。
• 设备重启后重新核对 COM 号。
• 尝试重新插拔适配器。

收不到数据：

• 核对波特率、校验位、数据位和停止位。
• 确认目标设备确实会主动发送数据，或会响应当前命令。
• 检查 TX/RX 接线，RS485 场景还要检查 A/B 线。
• 换一条已知可用命令，并降低发送频率。

数据显示乱码：

• 优先检查波特率和校验位。
• 在 Text 和 Hex 之间切换，判断原始字节是否正确。
• 确认设备是否使用不同编码，或本身就是二进制协议。

RS485 设备不响应：

• 确认 A/B 接线、终端电阻和共地。
• 确认总线上没有多个主站同时发送。
• 核对设备地址、功能码和 CRC。

高波特率不稳定：

• 缩短线缆，换质量更好的适配器。
• 降低界面显示压力，并开启日志保存。
• 长测前先单独验证目标速率是否可靠。

订单、激活与 Cloud Sync

官网把本地桌面调试流程和账号/服务流程分开处理。

• 下载：获取当前 Windows 或 macOS 版本，并查看更新说明。
• 服务：购买、订单查询和离线激活在服务页面完成。
• 离线激活：提前准备软件中显示的 CID，以及订单中的授权信息。
• Cloud Sync：账号相关流程可连接设备、授权和消息记录，用于支持或运维场景。
• 隐私：开启在线流程前，建议先阅读隐私说明，确认哪些数据会被使用。

如果只需要本地串口调试，先从下载和快速开始部分走起即可。

联系支持前请准备

尽量提供以下信息：

• 操作系统版本和友善串口调试助手版本。
• 设备型号、串口适配器型号和驱动名称。
• 串口参数：端口、波特率、数据位、停止位、校验位和流控。
• 当前使用 Text 还是 Hex、行尾符设置，以及实际发送的命令。
• 连接状态、Rx/Tx 计数截图。
• 能体现请求和响应的一小段日志或样例报文。
• 订单或激活问题：订单号、下单邮箱、CID 和授权类型。