树莓派5串口通信实战指南：从引脚定义到稳定通信的完整路径

你有没有遇到过这样的情况——接好了线，写好了代码，树莓派却收不到GPS模块的数据？或者串口输出全是乱码，调试信息像天书一样？

别急，这多半不是你的程序出了问题，而是UART引脚配置没搞明白。尤其是刚从树莓派3/4迁移过来的朋友，面对树莓派5的新电源架构和设备树机制，很容易在“看似简单”的串口通信上栽跟头。

今天我们就来彻底讲清楚：树莓派5到底哪些引脚能用来做串口？怎么用才不会出错？主串口和迷你串口有什么区别？为什么有时候明明连对了就是不通？

我们不堆术语，不抄手册，只讲你在开发板前真正需要知道的东西。

为什么UART仍是嵌入式开发的“基本功”？

尽管I²C、SPI甚至以太网都越来越普及，但UART依然是最实用、最可靠的调试与通信手段之一。原因很简单：

• 只需两根信号线（TX/RX）+ 地线就能双向通信
• 几乎所有微控制器、传感器、模组都支持
• Linux系统默认通过串口输出启动日志（console）
• 不依赖时钟线，布线灵活，适合长距离传输（配合电平转换）

更重要的是，当你SSH连不上、网络不通的时候，只有串口还能救你一命。

而要让这一切正常工作，第一步就是搞清物理引脚和功能映射之间的关系。

树莓派5的40针GPIO里，哪几个是用来跑UART的？

树莓派5延续了经典的40针排布，但内部SoC（BCM2712）的功能复用逻辑更复杂了。我们先看最关键的两个引脚：

✅结论先行：
如果你要接 GPS、蓝牙、Wi-Fi 模组或任何串口设备，优先使用 Pin 8 和 Pin 10，也就是 GPIO14 和 GPIO15。

这两个引脚对应的是Primary UART（PL011 UART0），性能强、稳定性高，是官方推荐用于关键通信的通道。

那其他GPIO也能当串口用吗？

可以，但有条件。

比如：
- GPIO16 / GPIO17（Pin 28 / Pin 27）可配置为 Mini UART 的 TX/RX
- 其他GPIO可通过软件模拟（bit-banging），但仅限低速场景

不过我们要重点提醒一句：Mini UART 是个“坑点密集区”，稍后细说。

Primary UART vs Mini UART：别再傻傻分不清

很多人踩坑，就是因为不知道树莓派有两个串口控制器。它们的区别，直接决定了你项目的成败。

举个真实案例：

一位开发者用 Mini UART 连接一个波特率为 115200 的温湿度传感器，白天运行正常，晚上偶尔断联。查了一周才发现：系统节能模式下调低了 core_freq，导致实际波特率偏差超过容限！

解决方法？换成/dev/ttyAMA0，问题消失。

所以记住一句话：

要做可靠通信，就用 Primary UART；Mini UART 只适合临时用途。

如何正确启用串口？三步走，一步都不能少

很多初学者以为“插上线就能通”，结果发现根本读不到数据。其实背后有三个关键步骤必须完成：

第一步：关闭串口登录 shell（禁用控制台）

这是最常见的冲突来源！

树莓派出厂默认把串口当作系统控制台使用，意味着：
- 内核启动信息会从串口输出
- 系统还会监听串口等待用户登录

这就占用了/dev/ttyAMA0，你的程序自然打不开它。

✅ 解决方案：

运行：

sudo raspi-config

进入Interfacing Options → Serial Port：
- 是否启用登录 shell？ →No
- 是否启用硬件串口？ →Yes

保存退出并重启。

或者手动编辑/boot/firmware/cmdline.txt，删除其中的：

console=serial0,115200

⚠️ 注意：树莓派5的配置文件路径是/boot/firmware/，不再是旧版的/boot/！

第二步：确保用户有权访问串口设备

Linux下串口设备属于dialout组，默认普通用户无权操作。

运行这条命令把你当前用户加进去：

sudo usermod -aG dialout $USER

然后注销重新登录，权限才会生效。

验证是否成功：

ls -l /dev/ttyAMA0

应看到类似：

crw-rw---- 1 root dialout 204, 64 Apr 5 10:00 /dev/ttyAMA0

如果你的用户名在dialout组里，就可以读写了。

第三步：正确选择设备节点

记住这个对应关系：

如果要用 Mini UART（比如主串口已被占用），还需要在/boot/firmware/config.txt中添加：

dtoverlay=uart1

然后重启生效。

实战代码示例：C语言 & Python 怎么写？

C语言：直接操作 ttyAMA0 发送数据

#include <stdio.h> #include <fcntl.h> #include <termios.h> #include <unistd.h> int main() { int fd = open("/dev/ttyAMA0", O_RDWR); struct termios options; if (fd == -1) { perror("无法打开串口"); return -1; } tcgetattr(fd, &options); cfsetispeed(&options, B115200); cfsetospeed(&options, B115200); options.c_cflag = (options.c_cflag & ~CSIZE) | CS8; // 8位数据 options.c_cflag &= ~(PARENB | CSTOPB); // 无校验，1停止位 options.c_cflag |= CLOCAL | CREAD; // 启用接收 tcsetattr(fd, TCSANOW, &options); write(fd, "Hello Pi5!\n", 11); close(fd); return 0; }

编译运行：

gcc uart_send.c -o uart_send ./uart_send

💡 提示：若提示权限错误，请确认已加入dialout组。

Python：用 pyserial 快速实现收发循环

安装依赖：

pip install pyserial

代码如下：

import serial import time # 打开主串口，波特率115200 ser = serial.Serial('/dev/ttyAMA0', 115200, timeout=1) try: while True: ser.write(b'Ping\n') response = ser.readline() if response: print(f"收到: {response.decode().strip()}") time.sleep(1) except KeyboardInterrupt: print("\n退出") finally: ser.close()

这段代码每秒发一次“Ping”，并监听回应，非常适合测试传感器回传。

常见问题排查清单（附解决方案）

🔥血泪教训提醒：
树莓派所有GPIO都是3.3V TTL电平，绝对不能直接接5V设备！
即使只是短暂通电，也可能永久损坏SoC。
对接 Arduino Uno、STM32F103 等5V系统时，请务必使用电平转换模块。

最佳实践建议：老手是怎么做的？

1. 始终优先使用 GPIO14/GPIO15（Pin 8/10）作为主通信通道
   - 性能稳、兼容好、不易出问题

2. 调试阶段开启串口日志记录
   bash screen /dev/ttyAMA0 115200 > log.txt
   把原始数据存下来，方便事后分析协议格式或异常行为。

3. 避免热插拔
   - 插拔瞬间可能产生电压尖峰
   - 建议断电接线，或使用光耦/磁耦隔离模块

4. 多串口需求怎么办？
   - 方案一：USB转TTL适配器（CP2102、CH340）——即插即用
   - 方案二：I²C/SPI转UART桥芯片（如 MCP2200）——节省USB口
   - 方案三：软件模拟UART（仅限<9600bps）

5. 生产环境建议固定核心频率
   若不得不使用 Mini UART，可在config.txt添加：
   ini core_freq=250
   防止动态调频导致波特率失准。

写在最后：掌握串口，才算真正入门嵌入式

你看，UART看起来只是“发几个字节”的小事，但它背后涉及：
- 引脚复用机制
- 设备树配置
- 权限管理
- 电平匹配
- 系统资源竞争

这些正是嵌入式开发的核心思维方式。

当你能在树莓派5上稳定地与GPS、LoRa、PLC、电机驱动器通过串口对话时，你就已经迈过了从“玩玩具”到“做产品”的门槛。

而这本该是一份手册就能教会你的事。

希望这篇指南能成为你工具箱里那张磨得发亮的接线图——每次遇到通信问题，翻出来一看，就知道该从哪里下手。

如果你正在做一个需要用串口连接外部设备的项目，欢迎在评论区留言交流。遇到了什么奇怪的现象？我们一起拆解。