返回串口调试

技术知识库 & 调试文档 65 篇硬核手册

Web Serial Pro Multi-Module Offline Documentation Hub

主题 同步中 本地离线 知识库总览
ID: SERIAL-BASIC-08 串口通信核心基础 (Core Serial Basics)

串口中的转义字符:在调试助手发送框内处理 \r\n 以及特殊十六进制码

#串口帧尾结束符 CRLF#HEX 与 ASCII 转换#串口调试指令预设

串口调试里经常要发送 不可见控制字符:回车 \r(0x0D)、换行 \n(0x0A)、Tab、ESC 等。若发送框只是「原样文本」,输入反斜杠和字母会发出 0x5C 与 0x72,而不是 CR——设备就会表现为「指令手册对了,从站无响应」。

先说结论 | 你想发出去的 | 错误输入(当纯文本) | 正确做法 | |--------------|----------------------|----------| | 回车 CR | 字面 \r 两字符 | 开转义 → \r 或 HEX 0D | | 换行 LF | 字面 \n | 开转义 → \n 或 HEX 0A | | CRLF 行尾 | 回车键(视工具而定) | \r\n0D 0A | | 任意字节 | 猜键盘 | HEX 模式按字节输入 | 先确认设备要 CR、LF 还是 CRLF,再用 HEX 接收区核对真实落线字节。

转义引擎在做什么? 专业助手在 ASCII 模式下会做一层转义解析,例如: - \r \n \t → 对应控制字节 - \x41 → 0x41('A') - 有的还支持重复发送或更复杂转义 这样可在同一行混合「可读命令 + 二进制后缀」,例如 START\r\nAT+GMR\r\n

与 HEX 模式的分工 | 模式 | 适合 | 注意 | |------|------|------| | ASCII + 转义 | AT、行协议、人读指令 | 必须确认转义开关已开 | | HEX | Modbus RTU、CRC 帧、含 0x00 | 空格通常只作分隔,不发送 | | 混用 | 日志 ASCII + 偶发二进制 | 接收长期开 HEX 对照 |

用本站操作(Web Serial Pro) 1. 打开 https://www.serialpro.top/ ,连接 COM,波特率与设备一致。 2. ASCII 发送 + 转义开:输入 AT\r\n(示例),发送后到接收区开 HEX,应看到末尾 0D 0A。 3. 若设备只要 CR:发 CMD\r,HEX 末尾仅 0D。 4. 纯二进制:切 HEX 发送,输入 01 03 00 00 00 0A 一类,不要再叠文本换行。 5. 把常用带帧尾指令存进预设,避免每次手打转义。

常见坑 1. 转义关闭时发送 \r\n 五个可见字符 → 从站当数据,不认帧尾。 2. Windows 记事本式「只按回车」在部分工具里变成 LF,在部分变成 CRLF——以 HEX 为准。 3. RTU 帧误开转义或附带 \r\n → CRC 全错。 4. 中文与转义无关:中文乱码查 UTF-8/GBK(见 data-format / fault 文)。

设备帧尾速查 | 设备类型 | 常见帧尾 | |----------|----------| | 多数 AT 模组 | \r\n | | 部分单片机行协议 | \n\r | | Modbus RTU | 文本帧尾,靠静默间隔 | | 老式工控 | 以手册为准,可能是单独 CR |

相关文档 - HEX 与 ASCII 怎么选:/help/serial-basic-09 - 乱码排查:/help/fault-01 - Modbus 帧:/help/industrial-01 - 回环自测:/help/serial-basic-10 弄清转义与 HEX 的边界,能消灭一大类「指令看起来对、总线上却多了反斜杠」的假问题。联调记录里建议贴一段发送前后的 HEX。