当前位置：首页 > news >正文

树莓派4B串口通信实战：从硬件配置到软件调试的完整避坑指南

news 2026/3/27 4:51:11

1. 树莓派4B串口通信入门指南

第一次接触树莓派串口通信的新手们，你们是否遇到过这样的场景：按照教程连接好USB转TTL模块，配置好波特率，却发现怎么也收不到数据？或者明明硬件连接正确，却总是提示"无法打开串口"？作为一个在嵌入式领域摸爬滚打多年的老手，我完全理解这种挫败感。今天我就带大家从头开始，一步步解决树莓派4B串口通信中的各种"坑"。

树莓派4B相比前代产品在性能上有显著提升，但串口配置却变得更加复杂。这主要是因为蓝牙模块占用了硬件串口资源，导致传统的配置方法不再适用。在实际项目中，我经常看到新手卡在以下几个典型问题上：分不清ttyAMA0和ttyS0的区别、不知道如何释放被蓝牙占用的串口、或者配置完成后发现串口被系统控制台占用。别担心，接下来我会用最直白的语言，配合具体操作示例，带你避开这些常见陷阱。

2. 硬件准备与连接

2.1 所需材料清单

在开始之前，我们需要准备以下硬件：

树莓派4B开发板（任何内存版本均可）
5V/3A电源适配器
16GB以上Micro SD卡（建议使用Class10以上速度等级）
USB转TTL模块（推荐使用CH340G或CP2102芯片的型号，稳定性较好）
杜邦线若干（建议使用母对母的线材）

这里特别提醒一下USB转TTL模块的选择。我实测过市面上常见的几种型号，发现PL2303芯片的兼容性较差，在Linux系统下经常需要额外安装驱动。而CH340G和CP2102基本都能即插即用，特别适合新手。价格方面，这些模块都在10-20元之间，没必要追求高端型号。

2.2 硬件连接详解

正确的接线是串口通信的基础，但也是新手最容易出错的地方。树莓派4B的40针GPIO接口中，我们需要关注的是第6、8、10三个引脚：

第6针(GND)：接USB转TTL的GND
第8针(TXD)：接USB转TTL的RXD
第10针(RXD)：接USB转TTL的TXD

这里有个记忆技巧："TX永远对着RX"。也就是说，树莓派的发送端(TX)要接模块的接收端(RX)，反之亦然。我刚开始时就经常接反，导致通信失败。如果连接后没有反应，第一个要检查的就是线序是否正确。

安全提示：连接时务必先接GND线，再接信号线。我曾遇到过因为静电导致串口芯片损坏的情况，虽然概率不高，但谨慎点总是好的。另外建议使用彩色杜邦线，比如黑色固定接GND，红色接VCC（虽然我们现在不用），绿色和黄色接信号线，这样一目了然不容易出错。

3. 系统配置与串口设置

3.1 基础系统配置

首先确保你的树莓派安装了最新版的Raspberry Pi OS。我推荐使用Lite版本，因为没有图形界面会更节省资源。使用Raspberry Pi Imager工具烧录系统时，记得提前配置好SSH和Wi-Fi，这样装好系统后可以直接远程登录，不需要接显示器。

烧录完成后，第一次启动前有个重要步骤：在boot分区新建一个名为ssh的空文件，这样可以启用SSH服务。同时建议新建wpa_supplicant.conf文件配置Wi-Fi，这样树莓派启动后就能自动联网。这些准备工作能让你后续操作更方便。

3.2 串口功能配置

通过SSH登录树莓派后，第一件事就是配置串口。输入以下命令：

sudo raspi-config

在菜单中选择"Interface Options" → "Serial Port"，会出现两个问题：

第一个问是否启用串口硬件，选择是
第二个问是否启用串口登录shell，选择否

这一步非常关键！如果启用了串口登录，系统会将串口用作控制台，导致我们的通信程序无法使用。这也是新手常踩的坑之一。配置完成后需要重启才能生效。

重启后，检查串口设备是否存在：

ls /dev/tty*

你应该能看到ttyAMA0和ttyS0两个设备文件。在树莓派4B上，默认情况下：

ttyAMA0是硬件串口，但被蓝牙占用
ttyS0是mini串口，性能较差但可供我们使用

4. 串口通信测试与调试

4.1 使用minicom进行基础测试

minicom是Linux下常用的串口调试工具，安装命令如下：

sudo apt-get install minicom

安装完成后，用以下命令启动minicom连接USB转TTL模块：

minicom -D /dev/ttyS0 -b 115200

这里的参数说明：

-D 指定设备文件
-b 设置波特率（需要与PC端串口助手保持一致）

如果一切正常，你应该能在PC端的串口助手中看到树莓派发送的数据。测试时可以尝试在两端互相发送数据，验证收发是否正常。

minicom有几个实用快捷键需要掌握：

Ctrl+A → E：开启本地回显
Ctrl+A → Q：退出minicom
Ctrl+A → C：清屏

4.2 常见问题排查

如果minicom无法正常工作，可以按照以下步骤排查：

检查硬件连接：确认TX/RX没有接反，接触良好
检查权限问题：当前用户需要有串口设备的读写权限
检查波特率设置：两端必须使用相同的波特率
检查串口是否被占用：使用lsof /dev/ttyS0查看

我遇到过最棘手的问题是权限不足，表现为"Permission denied"。解决方法是将用户加入dialout组：

sudo usermod -a -G dialout $USER

然后需要重新登录才能生效。

5. 编程实现串口通信

5.1 使用wiringPi库编程

对于需要编程控制串口的场景，wiringPi库是个不错的选择。首先安装库：

sudo apt-get install wiringpi

然后创建一个简单的发送程序serial_send.c：

#include <stdio.h> #include <wiringPi.h> #include <wiringSerial.h> int main() { int fd; if(wiringPiSetup() == -1) { printf("wiringPi初始化失败！\n"); return 1; } fd = serialOpen("/dev/ttyS0", 115200); if(fd < 0) { printf("无法打开串口！\n"); return 1; } while(1) { serialPuts(fd, "Hello from Raspberry Pi!\n"); delay(1000); // 每秒发送一次 } serialClose(fd); return 0; }

编译命令：

gcc -o serial_send serial_send.c -lwiringPi

5.2 解决"无法打开串口"错误

很多新手运行上面的程序时会遇到"无法打开串口"的错误。这是因为树莓派4B的硬件串口默认分配给了蓝牙模块。要解决这个问题，我们需要释放硬件串口并交换映射关系。

首先编辑config.txt文件：

sudo nano /boot/config.txt

在文件末尾添加：

dtoverlay=pi3-disable-bt

这会禁用蓝牙并释放硬件串口。

然后禁用串口控制台服务：

sudo systemctl stop serial-getty@ttyAMA0.service sudo systemctl disable serial-getty@ttyAMA0.service

最后编辑cmdline.txt，删除console=serial0,115200这部分内容：

sudo nano /boot/cmdline.txt

重启后，硬件串口ttyAMA0就可以自由使用了。记得把程序中的设备文件改为/dev/ttyAMA0。

6. 性能优化与高级技巧

6.1 硬件串口 vs 软件串口

经过上面的配置，我们现在有两个串口可用：

/dev/ttyAMA0：硬件串口，性能稳定，适合高速通信
/dev/ttyS0：mini串口，受CPU频率影响，适合低速场景

实测发现，在115200波特率下，硬件串口的误码率几乎为0，而mini串口在CPU负载高时会出现数据丢失。因此对于可靠性要求高的应用，建议使用硬件串口。

6.2 提高通信可靠性

在实际项目中，我总结了几点提高串口通信可靠性的经验：

添加数据校验：最简单的做法是在数据末尾加校验和
使用数据帧结构：比如"帧头+长度+数据+校验"的格式
降低波特率：长距离传输时，9600比115200更稳定
添加超时重发机制：当数据丢失时能够自动重发

下面是一个带简单校验的发送示例：

void sendWithChecksum(int fd, const char *data) { unsigned char sum = 0; int len = strlen(data); for(int i=0; i<len; i++) { sum += data[i]; } serialPuts(fd, data); serialPrintf(fd, "*%02X\n", sum); // 发送校验和 }

6.3 多线程串口通信

对于需要同时收发数据的应用，可以使用多线程。下面是一个简单的双线程示例：

#include <pthread.h> void *receiveThread(void *arg) { int fd = *(int *)arg; while(1) { if(serialDataAvail(fd)) { char c = serialGetchar(fd); putchar(c); // 打印接收到的字符 fflush(stdout); } delay(10); } } int main() { // ...初始化代码... pthread_t tid; pthread_create(&tid, NULL, receiveThread, &fd); // 主线程负责发送 while(1) { serialPuts(fd, "Ping\n"); delay(1000); } // ...清理代码... }

记得编译时要加上-pthread参数：

gcc -o serial_thread serial_thread.c -lwiringPi -pthread

7. 实际项目中的应用案例

7.1 与传感器通信

串口通信最常见的应用场景就是连接各种传感器。以GPS模块为例，通常都采用串口通信。下面是一个读取NMEA数据的代码片段：

fd = serialOpen("/dev/ttyAMA0", 9600); // GPS常用波特率 while(1) { if(serialDataAvail(fd)) { char nmea[256]; int i = 0; while(serialDataAvail(fd) && i < 255) { nmea[i] = serialGetchar(fd); if(nmea[i] == '\n') break; i++; } nmea[i] = '\0'; if(strstr(nmea, "$GPRMC")) { // 定位数据 printf("GPS数据: %s", nmea); } } delay(100); }

7.2 与STM32等MCU通信

在物联网项目中，经常需要用树莓派作为上位机与STM32等单片机通信。这时可以定义简单的通信协议：

// 树莓派发送指令 void sendCommand(int fd, char cmd, int value) { char buf[32]; sprintf(buf, "[%c:%04d]", cmd, value); sendWithChecksum(fd, buf); } // 解析单片机回复 void parseResponse(const char *data) { if(data[0] == '(' && strchr(data, ')')) { char cmd; int value; if(sscanf(data, "(%c:%04d)", &cmd, &value) == 2) { printf("收到响应: 指令%c, 值%d\n", cmd, value); } } }

这种简单的协议格式在实践中非常实用，既容易实现又足够可靠。

查看全文

http://www.jsqmd.com/news/523570/