Linux 串口編程核心：struct termios 結構體字段全解析與配置實戰

前言：termios——串口配置的「控制面板」

在 Linux/Unix 系統中，struct termios 是終端/串口屬性配置的核心數據結構。掌握其四大標志組 (c_iflag/oflag/cflag/lflag) 及控制字符數組 c_cc，是編寫健壯串口通信程序、Modbus 主站、GPS 解析器、調試終端的前提。本文系統梳理每個字段含義、常用宏定義、配置函數族 (tcgetattr/setattr 等)、波特率設置、cfmakeraw 原始模式一鍵配置。

一、 termios 結構體定義

struct termios {
    tcflag_t c_iflag;   // 輸入模式標志
    tcflag_t c_oflag;   // 輸出模式標志
    tcflag_t c_cflag;   // 控制模式標志 (波特率、數據位、校驗位、停止位)
    tcflag_t c_lflag;   // 本地模式標志 (規範/非規範、回顯、信號)
    cc_t     c_cc[NCCS]; // 控制字符數組 (VMIN, VTIME, VEOF, VINTR...)
};

二、 四大標志組詳細字段表

1. c_iflag：輸入處理模式

2. c_oflag：輸出處理模式

3. c_cflag：硬件控制模式 (最關鍵)

4. c_lflag：本地/行規範模式

三、 核心配置函數族

1. tcgetattr / tcsetattr：屬性讀寫

int tcgetattr(int fd, struct termios *termios_p);
int tcsetattr(int fd, int optional_actions, const struct termios *termios_p);

• optional_actions：TCSANOW 立即生效、TCSADRAIN 等輸出完成、TCSAFLUSH 等輸出完成並刷新輸入。
• **模式**：讀取 → 修改 → 寫回，保留未修改字段。

2. 流控與斷續函數

• tcsendbreak(fd, duration)：發送 BREAK 信號。
• tcdrain(fd)：等待輸出緩衝區排空。
• tcflush(fd, queue_selector)：TCIFLUSH 刷輸入、TCOFLUSH 刷輸出、TCIOFLUSH 雙刷。
• tcflow(fd, action)：TCOOFF 停止輸出、TCOON 恢復、TCIOFF 發 XOFF、TCION 發 XON。

3. 波特率便捷函數

speed_t cfgetospeed(const struct termios *);
int cfsetospeed(struct termios *, speed_t);
speed_t cfgetispeed(const struct termios *);
int cfsetispeed(struct termios *, speed_t);

• 常用常量：B9600, B115200, B921600 等。
• B0：掛斷 (降低 DTR/RTS)。
• 修改後必須 tcsetattr 才生效。

4. cfmakeraw：一鍵進入原始模式

// 等效手動配置
termios_p->c_iflag &= ~(IGNBRK|BRKINT|PARMRK|ISTRIP|INLCR|IGNCR|ICRNL|IXON);
termios_p->c_oflag &= ~OPOST;
termios_p->c_lflag &= ~(ECHO|ECHONL|ICANON|ISIG|IEXTEN);
termios_p->c_cflag &= ~(CSIZE|PARENB);
termios_p->c_cflag |= CS8;  // 8 數據位，無校驗，1 停止位

**原始模式特點**：字節流直通、無回顯、無行緩衝、無信號干擾、無流控，適合二進制協議 (Modbus RTU、自定義幀)。

四、 實戰配置模板：115200 8N1 原始模式

int setup_serial(int fd) {
    struct termios opt;
    if (tcgetattr(fd, &opt) < 0) return -1;

    cfmakeraw(&opt);  // 基礎原始模式
    
    // 設置波特率
    cfsetispeed(&opt, B115200);
    cfsetospeed(&opt, B115200);
    
    // 8N1 顯式確認
    opt.c_cflag &= ~CSIZE;
    opt.c_cflag |= CS8;      // 8 數據位
    opt.c_cflag &= ~PARENB;  // 無校驗
    opt.c_cflag &= ~CSTOPB;  // 1 停止位
    
    // 必置標志
    opt.c_cflag |= (CLOCAL | CREAD);  // 忽略 Modem 線、啟用接收
    
    // 非規範讀取超時設置 (100ms 無數據返回)
    opt.c_cc[VMIN] = 0;
    opt.c_cc[VTIME] = 10;  // 0.1s * 10 = 1s (實際單位 0.1s)
    
    if (tcsetattr(fd, TCSANOW, &opt) < 0) return -1;
    tcflush(fd, TCIOFLUSH);  // 清空殘留數據
    return 0;
}

五、 避坑指南

1. 打開串口必用 O_RDWR | O_NOCTTY | O_NDELAY：非控制終端、非阻塞 (配合 fcntl 切換阻塞)。
2. 波特率設置順序：先 cfsetispeed/ospeed，再 tcsetattr。
3. VMIN/VTIME` 交互複雜：VMIN=0, VTIME>0` 為帶超時非阻塞讀；VMIN>0, VTIME=0` 為阻塞等滿。
4. 權限問題：需加入 dialout 組或 chmod 666 /dev/ttyUSB0。
5. 殘留數據：配置前後 tcflush(fd, TCIOFLUSH)，防舊數據干擾。