Linux 串口使用指南

举报
yd_244592142 发表于 2026/11/16 09:58:30 2026/11/16
【摘要】 一、串口基础概念 1.1 什么是串口串口是一种逐位(bit by bit)传输数据的通信接口。与并口一次传输多位不同,串口只需要一根发送线(TX)、一根接收线(RX)和一根地线(GND)即可完成全双工通信。最常见的串口标准是 RS-232,你在台式机上见到的那个 9 针 D-Sub 接口就是它。而在嵌入式领域,更多使用的是 UART(通用异步收发传输器),它通常通过 TTL 电平(3.3V...

一、串口基础概念

1.1 什么是串口

串口是一种逐位(bit by bit)传输数据的通信接口。与并口一次传输多位不同,串口只需要一根发送线(TX)、一根接收线(RX)和一根地线(GND)即可完成全双工通信。

最常见的串口标准是 RS-232,你在台式机上见到的那个 9 针 D-Sub 接口就是它。而在嵌入式领域,更多使用的是 UART(通用异步收发传输器),它通常通过 TTL 电平(3.3V 或 5V)直接通信。

1.2 Linux 中的串口设备文件

Linux 遵循"一切皆文件"的哲学,串口也不例外。在 Linux 中,串口设备以字符设备文件的形式存在于 /dev 目录下:

设备文件 说明
/dev/ttyS0, /dev/ttyS1, … 硬件串口(主板上的 RS-232 接口)
/dev/ttyUSB0, /dev/ttyUSB1, … USB 转串口设备(如 CH340、FT232、PL2303 芯片)
/dev/ttyACM0, /dev/ttyACM1, … USB CDC ACM 设备(如 Arduino、某些 STM32 板)
/dev/ttyAMA0 ARM 平台的 AMBA UART(树莓派的串口)

你可以用以下命令查看系统当前识别到的串口设备:

# 查看所有 tty 类设备
ls -l /dev/tty*

# 只看串口相关的
ls -l /dev/ttyS* /dev/ttyUSB* /dev/ttyACM* 2>/dev/null

# 查看内核日志中串口识别信息
dmesg | grep -i tty

插入一个 USB 转串口模块后,dmesg 通常会输出类似这样的信息:

[  123.456789] usb 1-1: new full-speed USB device number 2 using xhci_hcd
[  123.789012] ch341 1-1:1.0: ch341-uart converter now attached to ttyUSB0

1.3 串口权限问题

默认情况下,串口设备文件的属主是 root,普通用户没有读写权限:

$ ls -l /dev/ttyUSB0
crw-rw---- 1 root dialout 188, 0 Nov 16 10:00 /dev/ttyUSB0

解决方法有两种:

方法一:将用户加入 dialout 组(推荐)

sudo usermod -aG dialout $USER
# 需要重新登录或执行 newgrp dialout 生效
newgrp dialout

方法二:临时修改权限(不推荐,重启后失效)

sudo chmod 666 /dev/ttyUSB0

二、命令行下的串口操作

2.1 使用 stty 查看和设置串口参数

stty 是 Linux 自带的终端设置工具,可以直接用来配置串口参数:

# 查看当前串口设置
stty -F /dev/ttyUSB0

# 设置波特率为 115200,8 数据位,无校验,1 停止位(即 8N1)
stty -F /dev/ttyUSB0 115200 cs8 -parenb -cstopb

# 设置参数详解:
#   115200    波特率
#   cs8       8 个数据位(cs5/cs6/cs7/cs8)
#   -parenb   禁用奇偶校验(parenb 为启用)
#   -cstopb   1 个停止位(cstopb 为 2 个停止位)
#   -ixon     禁用软件流控(ixon 为启用 XON/XOFF 流控)

2.2 使用 echo 和 cat 进行简单收发

设置好串口参数后,可以直接用 echo 和 cat 进行最简单的数据收发:

# 发送数据(注意:echo 默认会加换行符 \n)
echo "Hello Serial" > /dev/ttyUSB0

# 发送不带换行的数据
echo -n "AT" > /dev/ttyUSB0

# 接收数据(会一直阻塞等待)
cat /dev/ttyUSB0

# 接收数据并显示十六进制
cat /dev/ttyUSB0 | xxd

提示:这种方式适合快速验证串口是否通,但无法处理二进制数据,也无法同时收发。实际开发中请使用下面的专业工具。

2.3 使用 minicom

minicom 是最经典的串口终端工具,功能完善,几乎所有 Linux 发行版都可以安装:

# 安装
sudo apt install minicom      # Debian/Ubuntu
sudo yum install minicom      # CentOS/RHEL

# 启动配置界面
sudo minicom -s

在配置界面中设置:

  • Serial port setup → /dev/ttyUSB0
  • Bps/Par/Bits → 115200 8N1
  • Hardware Flow Control → No
  • Software Flow Control → No

配置完成后选择 Save setup as dfl 保存默认配置,然后 Exit 即可进入串口终端。

常用快捷键(先按 Ctrl+A,再按对应键):

快捷键 功能
Ctrl+A → Z 显示帮助
Ctrl+A → X 退出 minicom
Ctrl+A → W 自动换行
Ctrl+A → E 本地回显开关
Ctrl+A → C 清屏

2.4 使用 screen

screen 是一个终端复用器,但用来做串口终端也非常方便,比 minicom 更轻量:

# 安装
sudo apt install screen

# 连接串口(波特率 115200)
screen /dev/ttyUSB0 115200

# 指定 8N1 参数(默认就是 8N1,通常不需要额外指定)
screen /dev/ttyUSB0 115200,8N1

# 退出:先按 Ctrl+A,再按 K,然后按 Y 确认

2.5 使用 picocom

picocom 是一个专为串口设计的轻量级终端,退出时不会发送乱码,非常适合嵌入式调试:

# 安装
sudo apt install picocom

# 启动(-b 波特率)
picocom -b 115200 /dev/ttyUSB0

# 退出:先按 Ctrl+A,再按 Ctrl+X

三、C 语言串口编程

命令行工具适合调试,但如果你需要在程序中读写串口,就需要使用 Linux 提供的 termios API。

3.1 termios 结构体

termios 是 POSIX 定义的标准终端接口结构体,定义在 <termios.h> 中:

struct termios {
    tcflag_t c_iflag;   // 输入模式标志
    tcflag_t c_oflag;   // 输出模式标志
    tcflag_t c_cflag;   // 控制模式标志
    tcflag_t c_lflag;   // 本地模式标志
    cc_t     c_cc[NCCS]; // 控制字符
};

每个标志位的含义:

c_cflag(控制模式,最常用):

标志 含义
B9600 / B115200 / … 波特率
CS5 / CS6 / CS7 / CS8 数据位
PARENB 启用奇偶校验
PARODD 奇校验(否则为偶校验)
CSTOPB 2 个停止位(否则为 1 个)
CLOCAL 忽略调制解调器控制线
CRTSCTS 硬件流控

c_iflag(输入模式):

标志 含义
IXON / IXOFF 软件流控
IGNPAR 忽略奇偶校验错误

c_lflag(本地模式):

标志 含义
ICANON 规范模式(行缓冲)
ECHO 回显
ISIG 信号字符使能

关键点:串口编程通常需要设置为 原始模式(raw mode),即清除 ICANON、ECHO、ISIG 等标志,这样数据才能逐字节透明传输,不会被终端特殊处理。

3.2 完整的串口初始化代码

下面是一个完整的串口初始化函数,可以直接用于实际项目:

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <fcntl.h>
#include <termios.h>
#include <errno.h>

/**
 * 打开并配置串口
 * @param portname  串口设备路径,如 "/dev/ttyUSB0"
 * @param baudrate  波特率,如 B115200
 * @return          成功返回文件描述符,失败返回 -1
 */
int serial_open(const char *portname, speed_t baudrate)
{
    int fd;

    // 1. 打开串口设备
    // O_RDWR:   读写
    // O_NOCTTY: 不将设备作为控制终端
    // O_NDELAY: 不阻塞等待 DCD 信号线
    fd = open(portname, O_RDWR | O_NOCTTY | O_NDELAY);
    if (fd < 0) {
        fprintf(stderr, "打开串口失败: %s (%s)\n", portname, strerror(errno));
        return -1;
    }

    // 恢复阻塞模式(清除 O_NDELAY)
    fcntl(fd, F_SETFL, 0);

    // 2. 获取当前串口配置
    struct termios options;
    tcgetattr(fd, &options);

    // 3. 设置控制模式 (c_cflag)
    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;          // 无硬件流控

    // 4. 设置输入模式 (c_iflag)
    options.c_iflag &= ~(IXON | IXOFF | IXANY);  // 无软件流控
    options.c_iflag &= ~(IGNBRK | BRKINT | PARMRK | ISTRIP | INLCR | IGNCR | ICRNL);
    // 禁用特殊输入处理,使数据原始传输

    // 5. 设置输出模式 (c_oflag)
    options.c_oflag &= ~OPOST;  // 禁用输出处理(原始输出)
    options.c_oflag &= ~(ONLCR | OCRNL);

    // 6. 设置本地模式 (c_lflag)
    options.c_lflag &= ~(ICANON | ECHO | ECHOE | ISIG);  // 原始模式,无回显,无信号

    // 7. 设置控制字符 (c_cc)
    // VTIME 和 VMIN 定义 read() 的行为:
    //   VMIN  = 0:  即使没有数据也立即返回
    //   VTIME = 0:  无超时,无限等待
    //   VMIN  = 1:  至少读到 1 个字节才返回
    //   VTIME = 10: 读取等待超时约 1 秒(单位是 0.1 秒)
    options.c_cc[VMIN]  = 1;   // 至少读取 1 个字节
    options.c_cc[VTIME] = 10;  // 超时 1 秒

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

    // 9. 应用配置(TCSANOW 表示立即生效)
    if (tcsetattr(fd, TCSANOW, &options) != 0) {
        fprintf(stderr, "设置串口属性失败: %s\n", strerror(errno));
        close(fd);
        return -1;
    }

    // 10. 清空输入输出缓冲区
    tcflush(fd, TCIOFLUSH);

    return fd;
}

3.3 串口读写

/**
 * 向串口写入数据
 * @param fd    文件描述符
 * @param data  待发送数据
 * @param len   数据长度
 * @return      实际写入的字节数
 */
int serial_write(int fd, const void *data, size_t len)
{
    ssize_t ret = write(fd, data, len);
    if (ret < 0) {
        fprintf(stderr, "串口写入失败: %s\n", strerror(errno));
        return -1;
    }
    // 等待数据发送完成
    tcdrain(fd);
    return (int)ret;
}

/**
 * 从串口读取数据(带超时)
 * @param fd        文件描述符
 * @param buf       接收缓冲区
 * @param len       缓冲区大小
 * @param timeout_ms 超时时间(毫秒)
 * @return          实际读取的字节数,超时返回 0,出错返回 -1
 */
int serial_read(int fd, void *buf, size_t len, int timeout_ms)
{
    fd_set read_fds;
    struct timeval timeout;

    FD_ZERO(&read_fds);
    FD_SET(fd, &read_fds);

    timeout.tv_sec  = timeout_ms / 1000;
    timeout.tv_usec = (timeout_ms % 1000) * 1000;

    int ret = select(fd + 1, &read_fds, NULL, NULL, &timeout);
    if (ret < 0) {
        fprintf(stderr, "select 错误: %s\n", strerror(errno));
        return -1;
    }
    if (ret == 0) {
        return 0;  // 超时
    }

    ret = read(fd, buf, len);
    if (ret < 0) {
        fprintf(stderr, "串口读取失败: %s\n", strerror(errno));
        return -1;
    }
    return ret;
}

3.4 完整示例:串口收发程序

将上面的代码组合起来,写一个完整的收发示例:

#include <sys/select.h>

/* serial_open, serial_write, serial_read 函数实现见上文 */

int main(int argc, char *argv[])
{
    const char *port = "/dev/ttyUSB0";

    if (argc > 1) {
        port = argv[1];
    }

    // 打开串口,115200 8N1
    int fd = serial_open(port, B115200);
    if (fd < 0) {
        return EXIT_FAILURE;
    }

    printf("串口 %s 已打开 (fd=%d),开始收发...\n", port, fd);

    // 发送测试数据
    const char *msg = "Hello from Linux Serial!\r\n";
    serial_write(fd, msg, strlen(msg));
    printf("已发送: %s", msg);

    // 循环接收数据
    unsigned char buf[256];
    while (1) {
        int n = serial_read(fd, buf, sizeof(buf), 5000);  // 5 秒超时
        if (n > 0) {
            printf("收到 %d 字节: ", n);
            for (int i = 0; i < n; i++) {
                if (buf[i] >= 0x20 && buf[i] < 0x7f) {
                    putchar(buf[i]);
                } else {
                    printf("\\x%02X", buf[i]);
                }
            }
            printf("\n");

            // 收到 "quit" 则退出
            if (n >= 4 && strncmp((char *)buf, "quit", 4) == 0) {
                break;
            }
        } else if (n == 0) {
            printf("(超时,无数据)\n");
        } else {
            break;
        }
    }

    close(fd);
    printf("串口已关闭\n");
    return EXIT_SUCCESS;
}

编译和运行:

gcc -o serial_test serial_test.c
./serial_test /dev/ttyUSB0

3.5 非标准波特率设置

有时你需要使用非标准波特率(如 250000、500000 等),标准的 cfsetispeed/cfsetospeed 不支持这些值。在 Linux 中可以用 ioctl 配合 struct termios2 来设置:

#include <sys/ioctl.h>
#include <asm/termios.h>  // 提供 termios2 和 BOTHER 定义

/**
 * 设置任意波特率
 * @param fd   串口文件描述符
 * @param baud 波特率数值,如 250000
 * @return     成功返回 0,失败返回 -1
 */
int serial_set_custom_baud(int fd, int baud)
{
    struct termios2 tio;

    if (ioctl(fd, TCGETS2, &tio) < 0) {
        perror("TCGETS2");
        return -1;
    }

    tio.c_cflag &= ~CBAUD;       // 清除标准波特率标志
    tio.c_cflag |= BOTHER;       // 使用自定义波特率
    tio.c_ispeed = baud;         // 输入波特率
    tio.c_ospeed = baud;         // 输出波特率

    if (ioctl(fd, TCSETS2, &tio) < 0) {
        perror("TCSETS2");
        return -1;
    }

    return 0;
}

注意:asm/termios.h 是 Linux 特有头文件,此方法不可移植到其他 Unix 系统。部分嵌入式 Linux 内核可能未启用 BOTHER 支持,使用前请确认。

四、Python 串口编程(pyserial)

如果你不想写 C 代码,Python 的 pyserial 库是一个极好的选择,几行代码就能完成串口操作:

# 安装
pip install pyserial

4.1 基本收发

import serial
import time

# 打开串口
ser = serial.Serial(
    port='/dev/ttyUSB0',
    baudrate=115200,
    bytesize=serial.EIGHTBITS,     # 8 数据位
    parity=serial.PARITY_NONE,     # 无校验
    stopbits=serial.STOPBITS_ONE,  # 1 停止位
    timeout=1                      # 读超时 1 秒
)

# 发送数据
ser.write(b'Hello Serial!\r\n')

# 接收数据
data = ser.read(10)  # 读取 10 字节(或超时返回)
print(f"收到: {data}")

# 按行读取(适合文本协议)
line = ser.readline()
print(f"收到一行: {line.decode('utf-8', errors='replace').strip()}")

# 查看接收缓冲区中待读字节数
print(f"待读字节: {ser.in_waiting}")

# 关闭串口
ser.close()

4.2 使用上下文管理器(推荐)

import serial

with serial.Serial('/dev/ttyUSB0', 115200, timeout=1) as ser:
    ser.write(b'AT\r\n')
    response = ser.readline()
    print(response.decode('utf-8', errors='replace'))
# 离开 with 块后串口自动关闭

4.3 串口扫描工具

import serial.tools.list_ports

# 列出所有可用串口
ports = serial.tools.list_ports.comports()
for port in ports:
    print(f"设备: {port.device}, 描述: {port.description}, VID:PID: {port.vid}:{port.pid}")

五、常见问题与排障

5.1 串口打不开:Permission denied

打开串口失败: /dev/ttyUSB0 (Permission denied)

原因:当前用户没有串口读写权限。

解决:

sudo usermod -aG dialout $USER
newgrp dialout

5.2 USB 转串口设备识别不到

排查步骤:

# 1. 查看 USB 设备是否被识别
lsusb

# 2. 查看内核日志
dmesg | tail -20

# 3. 查看已加载的 USB 串口驱动
lsmod | grep -E "ch341|ftdi_sio|pl2303|cp210x"

# 4. 如果驱动未加载,手动加载
sudo modprobe ch341       # CH340 芯片
sudo modprobe ftdi_sio    # FT232 芯片
sudo modprobe pl2303      # PL2303 芯片
sudo modprobe cp210x      # CP2102 芯片

5.3 数据乱码

常见原因:

  1. 波特率不匹配:两端的波特率必须一致。用 stty -F /dev/ttyUSB0 确认当前设置。
  2. 电平不匹配:RS-232(±12V)和 TTL(3.3V/5V)不能直接连接,需要 MAX232 等电平转换芯片。
  3. 校验位/停止位不匹配:确认两端的帧格式一致(如都是 8N1)。
  4. 线序接反:TX 和 RX 需要交叉连接(一端的 TX 接另一端的 RX)。

5.4 read() 一直阻塞不返回

原因:VMIN 和 VTIME 设置导致 read() 无限等待。

解决:根据需求调整:

  • 需要超时返回:设 VMIN=0, VTIME>0
  • 需要读到指定字节才返回:设 VMIN=N, VTIME=0
  • 需要两者结合:设 VMIN=N, VTIME=T(等待 N 个字节,或 T×0.1 秒内无新数据则返回)

或者使用 select()/poll() 实现超时机制(见上文 serial_read 函数)。

5.5 串口被占用

# 查看哪个进程占用了串口
fuser /dev/ttyUSB0

# 或用 lsof
lsof /dev/ttyUSB0

# 杀掉占用进程
fuser -k /dev/ttyUSB0

5.6 树莓派串口无法使用

树莓派默认将串口分配给了蓝牙,需要手动释放:

# 编辑配置
sudo raspi-config
# → Interface Options → Serial Port
# → "Would you like a login shell to be accessible over serial?" → No
# → "Would you like the serial port hardware to be enabled?" → Yes

# 重启
sudo reboot

重启后串口设备通常为 /dev/ttyAMA0(或 /dev/serial0 符号链接)。

六、进阶技巧

6.1 使用 select 实现多串口同时监控

当需要同时监控多个串口时,可以用 select 将多个文件描述符加入读集合:

fd_set read_fds;
int max_fd = -1;

while (1) {
    FD_ZERO(&read_fds);

    for (int i = 0; i < num_ports; i++) {
        FD_SET(fds[i], &read_fds);
        if (fds[i] > max_fd) max_fd = fds[i];
    }

    struct timeval tv = { .tv_sec = 1, .tv_usec = 0 };
    int ret = select(max_fd + 1, &read_fds, NULL, NULL, &tv);

    if (ret > 0) {
        for (int i = 0; i < num_ports; i++) {
            if (FD_ISSET(fds[i], &read_fds)) {
                int n = read(fds[i], buf, sizeof(buf));
                // 处理串口 i 的数据
            }
        }
    }
}

6.2 获取串口硬件状态信号

通过 ioctl 的 TIOCMGET 可以读取 DTR、RTS、CTS、DSR 等硬件控制线的状态:

int status;
ioctl(fd, TIOCMGET, &status);

int dtr = (status & TIOCM_DTR) ? 1 : 0;  // Data Terminal Ready
int rts = (status & TIOCM_RTS) ? 1 : 0;  // Request To Send
int cts = (status & TIOCM_CTS) ? 1 : 0;  // Clear To Send
int dsr = (status & TIOCM_DSR) ? 1 : 0;  // Data Set Ready
int cd  = (status & TIOCM_CD)  ? 1 : 0;  // Carrier Detect

设置 DTR/RTS 信号线:

// 拉高 DTR
int status = TIOCM_DTR;
ioctl(fd, TIOCMBIS, &status);

// 拉低 DTR
ioctl(fd, TIOCMBIC, &status);

6.3 使用 udev 规则固定串口设备名

当你有多个 USB 转串口设备时,ttyUSB0、ttyUSB1 的编号可能会因插入顺序不同而变化。可以通过 udev 规则给每个设备分配固定的名称:

# 查看设备的属性
udevadm info -a -n /dev/ttyUSB0 | grep -E "idVendor|idProduct|serial"

# 创建 udev 规则
sudo tee /etc/udev/rules.d/99-serial.rules << 'EOF'
# 根据 VID:PID 和序列号固定设备名
SUBSYSTEM=="tty", ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="7523", ATTRS{serial}=="xxx", SYMLINK+="my_serial"
EOF

# 重新加载 udev 规则
sudo udevadm control --reload-rules
sudo udevadm trigger

# 之后可以通过 /dev/my_serial 访问该设备,名称固定不变
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。