Linux串口通信开发实战指南-嵌云网-嵌入式AI开发资源站

Linux串口通信开发实战指南

松哥是个好人耶

1. 串口通信基础与开发环境准备

在嵌入式系统和工业控制领域，串口通信是最基础也最可靠的通信方式之一。不同于网络通信的复杂性，串口通信以其简单、稳定的特性，在调试接口、设备控制等场景中占据不可替代的地位。Linux系统从内核层面对串口提供了完善的支持，开发者可以在应用层通过操作设备文件的方式实现完整的串口通信功能。

我从事嵌入式开发多年，处理过各种串口通信问题，从简单的传感器数据采集到复杂的工业协议解析。在这个过程中，我深刻体会到正确配置串口参数的重要性——一个错误的标志位设置可能导致数据丢失或设备无法响应。本文将基于Linux 6.1内核，详细讲解应用层串口编程的全流程，包含那些官方文档很少提及的实战经验。

开发环境建议：

硬件：任何带有标准串口或USB转串口的设备（如树莓派、BeagleBone等开发板）
操作系统：Linux内核6.1及以上版本
工具链：GCC编译器、基本的Linux开发工具包
调试工具：minicom、screen或picocom作为串口终端验证工具

提示：虽然现代系统多采用USB或网络通信，但在工业现场、嵌入式设备调试等场景，串口仍然是首选方案。掌握底层串口编程能力，能让你在设备异常时快速定位问题。

2. 串口设备文件与访问管理

2.1 设备文件命名规则演变

Linux系统中的串口设备经历了从传统命名到现代命名的演变过程。理解这种变化对设备管理至关重要：

bash复制# 查看系统中的串口设备
ls -l /dev/ttyS* /dev/ttyUSB* /dev/serial*

传统命名方式直接反映了设备在系统中的注册顺序：

/dev/ttyS0：第一个原生串口（通常是主板上的COM1）
/dev/ttyUSB0：第一个USB转串口设备

现代Linux系统（使用systemd/udev）引入了更稳定的设备标识方式：

/dev/serial0：指向当前系统的第一个串口（通常是ttyS0的符号链接）
/dev/serial/by-id/：包含基于设备唯一ID的符号链接
/dev/serial/by-path/：包含基于设备物理连接路径的符号链接

经验分享：在产品开发中，我强烈建议使用/dev/serial/by-id/下的设备节点。这样即使设备插拔顺序变化，也能确保始终访问正确的串口。例如，我们的生产线测试工具就固定使用/dev/serial/by-id/usb-FTDI_FT232R_USB_UART_AI03XPMO-if00-port0这样的路径。

2.2 访问权限管理实践

串口设备默认通常只有root用户有读写权限，这在实际开发中很不方便。以下是几种管理方案对比：

方法	命令示例	优点	缺点
直接chmod	`sudo chmod 666 /dev/ttyUSB0`	简单快速	设备重启后失效
udev规则	`SUBSYSTEM=="tty", ATTRS{idVendor}=="0403", MODE="0666"`	永久生效	需要了解udev语法
用户组	`sudo usermod -aG dialout $USER`	一劳永逸	需要注销重新登录

我个人的推荐方案是创建自定义udev规则。在/etc/udev/rules.d/99-serial.rules文件中添加：

bash复制# FTDI USB转串口设备
SUBSYSTEM=="tty", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", MODE="0666", GROUP="plugdev"

# 原生串口
KERNEL=="ttyS[0-9]*", MODE="0666"

然后重新加载udev规则：

bash复制sudo udevadm control --reload-rules
sudo udevadm trigger

避坑指南：曾经有个项目因为权限问题导致串口间歇性失败，最后发现是多个进程同时竞争设备访问权。建议在代码中使用flock()对设备文件加锁，避免并发访问问题。

3. 串口打开与基础配置

3.1 正确打开串口设备

打开串口看似简单，但有几个关键细节需要注意：

c复制int open_serial_port(const char *device) {
    int fd = open(device, O_RDWR | O_NOCTTY | O_NDELAY);
    if (fd < 0) {
        perror("open");
        return -1;
    }
    
    // 恢复阻塞模式
    if(fcntl(fd, F_SETFL, 0) < 0) {
        perror("fcntl");
        close(fd);
        return -1;
    }
    
    // 检查是否为终端设备
    if(!isatty(fd)) {
        fprintf(stderr, "%s is not a terminal device\n", device);
        close(fd);
        return -1;
    }
    
    return fd;
}

关键点解析：

O_NOCTTY：防止设备成为控制终端（避免影响信号处理）
O_NDELAY：初始以非阻塞方式打开（后续再设为阻塞模式）
isatty()验证：确保打开的是真正的终端设备

3.2 串口配置数据结构全景

Linux通过termios结构体管理串口参数，这个结构体包含多个关键字段：

c复制struct termios {
    tcflag_t c_cflag;    // 控制模式标志
    tcflag_t c_iflag;    // 输入模式标志 
    tcflag_t c_oflag;    // 输出模式标志
    tcflag_t c_lflag;    // 本地模式标志
    cc_t c_cc[NCCS];     // 控制字符数组
    speed_t c_ispeed;    // 输入波特率
    speed_t c_ospeed;    // 输出波特率
};

每个标志位都控制着特定的串口行为。接下来我们将深入解析最重要的配置选项。

4. 串口详细配置解析

4.1 波特率设置标准与技巧

波特率是串口通信最基本的参数，Linux提供了标准波特率常量：

c复制// 标准波特率常量
B0, B50, B75, B110, B134, B150, B200, B300, B600, 
B1200, B1800, B2400, B4800, B9600, B19200, B38400, 
B57600, B115200, B230400, B460800, B500000, B576000, 
B921600, B1000000, B1152000, B1500000, B2000000, 
B2500000, B3000000, B3500000, B4000000

设置波特率的正确流程：

c复制struct termios options;
tcgetattr(fd, &options);  // 获取当前配置

// 设置输入输出波特率
cfsetispeed(&options, B115200);
cfsetospeed(&options, B115200);

// 对于非标准波特率（Linux 6.1+）
options.c_cflag &= ~CBAUD;
options.c_cflag |= CBAUDEX;
options.c_ispeed = 75000;  // 75kbps
options.c_ospeed = 75000;

实战经验：在工业现场遇到过设备需要特殊的57600波特率，但实际测量发现存在偏差。后来发现是时钟分频导致的误差，解决方法是在内核配置中调整UART时钟源。

4.2 控制标志(c_cflag)深度解析

c_cflag是最重要的配置字段，控制着数据帧格式和硬件特性：

c复制options.c_cflag |= (CLOCAL | CREAD);  // 忽略调制解调器状态，启用接收
options.c_cflag &= ~CSIZE;  // 清除数据位掩码
options.c_cflag |= CS8;     // 8数据位
options.c_cflag &= ~PARENB; // 无奇偶校验
options.c_cflag &= ~CSTOPB; // 1停止位
options.c_cflag &= ~CRTSCTS; // 无硬件流控

关键选项说明：

CLOCAL：忽略调制解调器控制线（必备）
CREAD：启用接收器（必备）
CSIZE：数据位设置（CS5/6/7/8）
PARENB：奇偶校验使能
CSTOPB：2停止位（0表示1停止位）
CRTSCTS：硬件流控（RTS/CTS）

4.3 输入输出标志精细控制

输入标志(c_iflag)处理接收数据的预处理：

c复制options.c_iflag &= ~(IXON | IXOFF | IXANY); // 禁用软件流控
options.c_iflag &= ~(INLCR | ICRNL); // 禁止特殊字符转换
options.c_iflag &= ~IGNBRK;  // 不忽略BREAK条件

输出标志(c_oflag)控制发送数据的处理方式：

c复制options.c_oflag &= ~OPOST;  // 原始输出模式
options.c_oflag &= ~ONLCR;  // 不将换行转换为回车换行

调试技巧：曾经遇到串口接收数据出现额外字符的问题，最后发现是ICRNL标志将回车转换为换行导致的。在原始模式下，建议清除所有输入输出转换标志。

5. 高级配置与特殊模式

5.1 本地模式(c_lflag)与原始配置

本地模式控制终端的特性：

c复制options.c_lflag &= ~(ICANON | ECHO | ECHOE | ISIG);

ICANON：禁用规范模式（原始模式）
ECHO：禁用回显
ISIG：禁用信号产生

原始模式配置模板：

c复制options.c_cflag |= (CLOCAL | CREAD);
options.c_cflag &= ~CSIZE;
options.c_cflag |= CS8;
options.c_cflag &= ~PARENB;
options.c_cflag &= ~CSTOPB;
options.c_cflag &= ~CRTSCTS;

options.c_iflag &= ~(IXON | IXOFF | IXANY | INLCR | ICRNL | IGNBRK);
options.c_oflag &= ~OPOST;
options.c_lflag &= ~(ICANON | ECHO | ECHOE | ISIG);

options.c_cc[VMIN] = 1;   // 读取至少1个字符
options.c_cc[VTIME] = 10; // 超时时间(0.1秒单位)

5.2 控制字符(c_cc)与超时设置

c_cc数组定义了特殊控制字符和超时行为：

c复制// 禁用所有特殊控制字符
options.c_cc[VINTR] = _POSIX_VDISABLE;
options.c_cc[VQUIT] = _POSIX_VDISABLE;
options.c_cc[VERASE] = _POSIX_VDISABLE;
// ...其他控制字符同理

// 设置读取超时和最小字符数
options.c_cc[VMIN] = 0;   // 非阻塞模式
options.c_cc[VTIME] = 5;  // 0.5秒超时

超时行为组合：

VMIN=0, VTIME=0：完全非阻塞
VMIN>0, VTIME=0：阻塞直到读取VMIN个字符
VMIN=0, VTIME>0：阻塞直到超时或任意数据到达
VMIN>0, VTIME>0：阻塞直到读取VMIN个字符或超时

6. 配置应用与状态管理

6.1 应用配置的完整流程

c复制int configure_serial(int fd, int baudrate, int databits, int parity, int stopbits) {
    struct termios options;
    
    if(tcgetattr(fd, &options) < 0) {
        perror("tcgetattr");
        return -1;
    }
    
    // 设置波特率
    set_baudrate(&options, baudrate);
    
    // 设置数据位
    options.c_cflag &= ~CSIZE;
    switch(databits) {
        case 5: options.c_cflag |= CS5; break;
        case 6: options.c_cflag |= CS6; break;
        case 7: options.c_cflag |= CS7; break;
        case 8: 
        default: options.c_cflag |= CS8; break;
    }
    
    // 设置奇偶校验
    switch(parity) {
        case 'O': case 'o':
            options.c_cflag |= PARENB;
            options.c_cflag |= PARODD;
            break;
        case 'E': case 'e':
            options.c_cflag |= PARENB;
            options.c_cflag &= ~PARODD;
            break;
        case 'N': case 'n':
        default:
            options.c_cflag &= ~PARENB;
            break;
    }
    
    // 设置停止位
    if(stopbits == 2)
        options.c_cflag |= CSTOPB;
    else
        options.c_cflag &= ~CSTOPB;
    
    // 应用配置
    if(tcsetattr(fd, TCSANOW, &options) < 0) {
        perror("tcsetattr");
        return -1;
    }
    
    return 0;
}

6.2 缓冲区管理与流控制

c复制// 清空输入输出缓冲区
tcflush(fd, TCIOFLUSH);

// 等待所有输出数据发送完成
tcdrain(fd);

// 流控制示例（暂停/恢复接收）
tcflow(fd, TCOOFF);  // 暂停输出
sleep(1);
tcflow(fd, TCOON);   // 恢复输出

7. 数据读写与错误处理

7.1 可靠读写实现方案

c复制ssize_t serial_write(int fd, const void *buf, size_t count) {
    size_t total = 0;
    const char *ptr = (const char*)buf;
    
    while(total < count) {
        ssize_t written = write(fd, ptr + total, count - total);
        if(written < 0) {
            if(errno == EINTR) continue;  // 被信号中断，重试
            return -1;  // 其他错误
        }
        total += written;
    }
    
    return total;
}

ssize_t serial_read(int fd, void *buf, size_t count, int timeout_ms) {
    fd_set rfds;
    struct timeval tv;
    int ret;
    
    FD_ZERO(&rfds);
    FD_SET(fd, &rfds);
    
    tv.tv_sec = timeout_ms / 1000;
    tv.tv_usec = (timeout_ms % 1000) * 1000;
    
    ret = select(fd + 1, &rfds, NULL, NULL, &tv);
    if(ret > 0) {
        if(FD_ISSET(fd, &rfds)) {
            return read(fd, buf, count);
        }
    }
    
    return ret;  // 超时或错误
}

7.2 串口状态监测与错误处理

c复制int get_serial_status(int fd) {
    int status;
    if(ioctl(fd, TIOCMGET, &status) < 0) {
        perror("ioctl(TIOCMGET)");
        return -1;
    }
    
    printf("CTS: %s\n", (status & TIOCM_CTS) ? "ON" : "OFF");
    printf("DSR: %s\n", (status & TIOCM_DSR) ? "ON" : "OFF");
    printf("DCD: %s\n", (status & TIOCM_CAR) ? "ON" : "OFF");
    printf("RI:  %s\n", (status & TIOCM_RNG) ? "ON" : "OFF");
    
    return 0;
}

8. 常见配置组合与内核特性

8.1 典型配置模板

8N1无流控（最常用）

c复制options.c_cflag = B115200 | CS8 | CLOCAL | CREAD;
options.c_iflag = IGNPAR;
options.c_oflag = 0;
options.c_lflag = 0;
options.c_cc[VMIN] = 1;
options.c_cc[VTIME] = 0;

7E1硬件流控

c复制options.c_cflag = B9600 | CS7 | PARENB | CLOCAL | CREAD | CRTSCTS;
options.c_iflag = IGNPAR;
options.c_oflag = 0;
options.c_lflag = 0;

8.2 Linux 6.1内核特有功能

c复制// 设置非标准波特率（需要内核支持）
struct serial_struct serinfo;
ioctl(fd, TIOCGSERIAL, &serinfo);
serinfo.flags &= ~ASYNC_SPD_MASK;
serinfo.flags |= ASYNC_SPD_CUST;
serinfo.custom_divisor = (serinfo.baud_base + (bps/2)) / bps;
ioctl(fd, TIOCSSERIAL, &serinfo);

9. 完整示例与调试技巧

9.1 完整工作示例代码

c复制#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <fcntl.h>
#include <termios.h>
#include <errno.h>
#include <string.h>
#include <sys/select.h>

int set_serial_attr(int fd, int speed, int parity) {
    struct termios tty;
    memset(&tty, 0, sizeof(tty));
    
    if(tcgetattr(fd, &tty) != 0) {
        perror("tcgetattr");
        return -1;
    }
    
    cfsetospeed(&tty, speed);
    cfsetispeed(&tty, speed);
    
    tty.c_cflag = (tty.c_cflag & ~CSIZE) | CS8;
    tty.c_iflag &= ~IGNBRK;
    tty.c_lflag = 0;
    tty.c_oflag = 0;
    tty.c_cc[VMIN] = 1;
    tty.c_cc[VTIME] = 5;
    
    tty.c_iflag &= ~(IXON | IXOFF | IXANY);
    tty.c_cflag |= (CLOCAL | CREAD);
    tty.c_cflag &= ~(PARENB | PARODD);
    tty.c_cflag |= parity;
    tty.c_cflag &= ~CSTOPB;
    tty.c_cflag &= ~CRTSCTS;
    
    if(tcsetattr(fd, TCSANOW, &tty) != 0) {
        perror("tcsetattr");
        return -1;
    }
    
    return 0;
}

int main(int argc, char **argv) {
    if(argc < 2) {
        fprintf(stderr, "Usage: %s <device>\n", argv[0]);
        return 1;
    }
    
    int fd = open(argv[1], O_RDWR | O_NOCTTY | O_SYNC);
    if(fd < 0) {
        perror("open");
        return 1;
    }
    
    if(set_serial_attr(fd, B115200, 0) < 0) {
        close(fd);
        return 1;
    }
    
    // 简单回环测试
    char buf[256];
    while(1) {
        ssize_t n = read(fd, buf, sizeof(buf));
        if(n > 0) {
            write(fd, buf, n);
        } else if(n < 0) {
            perror("read");
            break;
        }
    }
    
    close(fd);
    return 0;
}

9.2 调试技巧与常见问题排查

问题1：串口能发送但不能接收数据

检查CREAD标志是否设置
验证硬件连接（RX/TX是否交叉）
使用示波器或逻辑分析仪检查信号

问题2：接收数据出现乱码

确认双方波特率一致（误差应小于3%）
检查数据位、停止位和奇偶校验设置
尝试降低波特率测试

问题3：长时间运行后通信中断

检查DCD/DSR信号状态
使用ioctl(fd, TIOCMGET, &status)获取当前状态
可能是硬件流控导致的锁定

最后��享一个真实案例：某项目中使用USB转串口适配器，发现每传输约1MB数据就会卡死。最终发现是适配器内部缓冲区溢出导致的，解决方法是在代码中增加tcdrain()调用并降低传输速度。这个经验告诉我，串口通信的稳定性不仅取决于软件配置，硬件特性同样重要。