Linux 串口使用指南
一、串口基础概念
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 数据乱码
常见原因:
- 波特率不匹配:两端的波特率必须一致。用
stty -F /dev/ttyUSB0确认当前设置。 - 电平不匹配:RS-232(±12V)和 TTL(3.3V/5V)不能直接连接,需要 MAX232 等电平转换芯片。
- 校验位/停止位不匹配:确认两端的帧格式一致(如都是 8N1)。
- 线序接反: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 访问该设备,名称固定不变
- 点赞
- 收藏
- 关注作者
评论(0)