串口原始模式是关闭termios所有字符解释逻辑(如icanon、echo、isig等),使0x00–0xff字节原样透传;它非默认启用,必须显式调用tcsetattr()生效,并需手动配置波特率、数据位及调用tcflush()清空残留缓冲区。

什么是串口原始模式,为什么必须显式设置
Linux 串口默认走 termios 终端驱动栈,会把 0x03(Ctrl+C)当信号、0x04(Ctrl+D)当 EOF、0x1A(Ctrl+Z)当挂起——哪怕你只是想传二进制帧。原始模式(Raw Mode)本质是关掉所有输入处理(ICANON、ECHO、ISIG 等),让字节原样进出。它不是“打开串口就自动生效”,必须调用 tcsetattr() 显式配置。
用 cfmakeraw() 最快但要注意它不碰波特率和硬件控制
cfmakeraw() 是 libc 提供的便捷函数,它等价于手动清空 c_iflag、c_oflag、c_lflag 中所有影响字符解释的位,并设 c_cc[VMIN] = 1、c_cc[VTIME] = 0(阻塞读直到至少 1 字节)。但它**完全不修改** c_cflag(比如 CBAUD、CS8、CREAD)和 c_ispeed/c_ospeed。所以你得自己先设好波特率:
struct termios tty;
if (tcgetattr(fd, &tty) != 0) { /* 错误处理 */ }
<p>cfmakeraw(&tty); // 清除所有转义/回显/行编辑逻辑</p><p>// 必须手动补全关键标志
tty.c_cflag |= CREAD | CLOCAL; // 允许接收,忽略 Modem 控制线
tty.c_cflag &= ~CSIZE; // 清除数据位掩码
tty.c_cflag |= CS8; // 设为 8 数据位
tty.c_cflag &= ~PARENB; // 关闭校验
tty.c_cflag &= ~CSTOPB; // 1 停止位</p><p>cfsetispeed(&tty, B115200); // 输入波特率
cfsetospeed(&tty, B115200); // 输出波特率</p><p>tcsetattr(fd, TCSANOW, &tty); // 立即生效
</p>
绕过 cfmakeraw() 手动置零更可控,尤其要禁用 IGNBRK 和 BRKINT
有些设备(如某些 GPS 模块或自定义协议硬件)会在空闲线上发长低电平(break),触发 SIGINT 或被当成特殊事件丢弃。这时光靠 cfmakeraw() 不够,必须显式关掉 break 处理:
tty.c_iflag &= ~(IGNBRK | BRKINT | PARMRK | ISTRIP | INLCR | IGNCR | ICRNL | IXON)-
tty.c_oflag &= ~OPOST(确保输出不经过任何转换) tty.c_lflag &= ~(ECHO | ECHONL | ICANON | ISIG | IEXTEN)-
tty.c_cflag &= ~(CSIZE | PARENB | PARODD | CRTSCTS | CSTOPB | CMSPAR)—— 再清一次,避免残留 - 最后再设
CS8、CREAD、CLOCAL和波特率
漏掉 IGNBRK 或 BRKINT 会导致串口收到 break 时要么丢字节、要么进程被中断——这在无人值守嵌入式场景里极难排查。
别忘了 tcflush() 清空残留缓冲区
设置完 termios 后,内核缓冲区里可能还卡着旧配置下解析失败的字节(比如未完成的 escape 序列)。不清理会导致第一次 read() 返回一堆乱码。务必在 tcsetattr() 后加:
tcflush(fd, TCIOFLUSH); // 清输入+输出缓冲区
用 TCIFLUSH 只清输入也行,但 TCIOFLUSH 更彻底。这步常被跳过,结果调试时看到“开头几个字节总是错”,其实只是历史残留。
原始模式的核心就三件事:关掉所有 termios 的解释逻辑、设对硬件参数、清掉旧缓存。少做任何一步,都可能让 0x00–0xFF 里的某个字节突然消失或触发意外行为。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











