树莓派5串口通信保姆级教程：从GPIO引脚接线到Python代码测试，一次搞定
树莓派5串口通信全流程实战指南：硬件配置到Python脚本调试
第一次拿到树莓派5准备玩转串口通信时，我也被网上各种互相矛盾的教程搞得晕头转向。不同代际树莓派的串口配置差异、GPIO引脚的变化、系统配置的调整——这些细节问题往往会让初学者在硬件连接和软件调试阶段反复踩坑。本文将用最直白的语言，带你完整走通树莓派5的串口通信全流程，从硬件接线到Python代码测试，确保你一次成功。
1. 硬件准备与安全须知
树莓派5的40针GPIO接口布局虽然与前代相似，但串口相关的引脚功能有重要变化。先准备好这些硬件：
- 树莓派5主板（务必确认型号）
- USB-TTL串口转换器（推荐使用CP2102或CH340芯片版本）
- 杜邦线（母对母，建议不同颜色区分功能）
- 万用表（可选，用于线路检查）
重要安全提醒：
- 操作前务必断开树莓派电源
- 切勿将5V电源线接入信号引脚（可能烧毁设备）
- 建议使用防静电手环或在金属表面释放静电
树莓派5的串口引脚定义如下：
| 引脚编号 | 物理位置 | 功能定义 | 对应转换器接口 |
|---|---|---|---|
| GPIO14 | 第8针 | TXD（发送端） | RXD |
| GPIO15 | 第10针 | RXD（接收端） | TXD |
| GND | 第6针 | 接地 | GND |
注意：USB-TTL转换器的TXD/RXD需要与树莓派交叉连接，即TXD接RXD，RXD接TXD。这是串口通信的标准接法。
2. 系统配置与串口启用
连接好硬件后，启动树莓派进行系统配置。树莓派5的串口管理方式与早期版本有显著不同：
# 首先更新系统 sudo apt update && sudo apt upgrade -y # 进入配置界面 sudo raspi-config在配置界面中按以下路径操作：
- 选择
Interface Options - 选择
Serial Port - 当询问"Would you like a login shell..."时选择No
- 当询问"Would you like the serial port hardware..."时选择Yes
- 完成后退回主界面，选择
Finish并重启
验证串口映射关系：
ls /dev/ttyAMA*树莓派5会显示两个串口设备：
/dev/ttyAMA0- 主串口（连接GPIO14/15）/dev/ttyAMA10- 新增独立串口（需额外配置）
3. 串口调试工具安装与使用
推荐使用minicom作为命令行调试工具：
# 安装minicom sudo apt install minicom -y # 基本使用命令 minicom -D /dev/ttyAMA0 -b 115200常用操作快捷键：
Ctrl+A→Z查看帮助菜单Ctrl+A→O进入配置界面Ctrl+A→X退出minicom
如果需要更直观的图形界面，可以安装putty：
sudo apt install putty -y配置Putty连接参数：
- Connection type: Serial
- Serial line: /dev/ttyAMA0
- Speed: 115200
4. Python串口编程实战
下面是一个功能完整的Python串口通信示例，包含发送和接收功能：
import serial import threading def serial_reader(ser): while True: if ser.in_waiting > 0: data = ser.readline().decode('utf-8').strip() print(f"Received: {data}") try: # 配置串口参数 ser = serial.Serial( port='/dev/ttyAMA0', baudrate=115200, parity=serial.PARITY_NONE, stopbits=serial.STOPBITS_ONE, bytesize=serial.EIGHTBITS, timeout=1 ) # 启动接收线程 reader_thread = threading.Thread(target=serial_reader, args=(ser,)) reader_thread.daemon = True reader_thread.start() print("串口通信已启动 (输入'exit'退出)") while True: user_input = input("发送内容> ") if user_input.lower() == 'exit': break ser.write(f"{user_input}\n".encode('utf-8')) except serial.SerialException as e: print(f"串口错误: {e}") except KeyboardInterrupt: print("\n程序终止") finally: if 'ser' in locals() and ser.is_open: ser.close()代码功能说明：
- 使用独立线程处理接收数据，避免阻塞主程序
- 支持双向通信，可同时发送和接收数据
- 包含完善的异常处理和资源释放
- 波特率可自由调整（需与对方设备匹配）
5. 常见问题排查指南
遇到通信问题时，可以按照以下步骤排查：
检查物理连接
- 确认TXD-RXD交叉连接
- 确保GND线正确连接
- 用万用表检查线路通断
验证串口配置
# 查看串口权限 ls -l /dev/ttyAMA0 # 如果没有读写权限，需要添加用户组 sudo usermod -a -G dialout $USER测试串口回环
- 短接树莓派的TXD和RXD引脚
- 发送数据应该能立即收到相同内容
- 如果失败说明硬件或驱动有问题
调整波特率容错
# 在Python中尝试添加这个参数 ser = serial.Serial(..., inter_byte_timeout=0.1)
树莓派5的串口稳定性相比前代有所提升，但在高波特率(>500kbps)下仍可能出现数据丢失。如果需要进行高速通信，建议：
- 降低波特率
- 增加数据校验
- 使用硬件流控（需额外连接CTS/RTS引脚）
6. 进阶应用：多串口管理与自动化
树莓派5的额外串口ttyAMA10可以用于创建更复杂的通信系统。首先需要激活该串口：
# 编辑设备树配置 sudo nano /boot/config.txt添加以下内容：
dtoverlay=uart5保存后重启，即可使用/dev/ttyAMA10。多串口应用的典型场景包括：
- 同时连接多个传感器设备
- 实现串口数据中继
- 构建调试监控系统
下面是一个多串口管理的Python示例框架：
class MultiSerialManager: def __init__(self, ports): self.serials = {} for port, config in ports.items(): try: ser = serial.Serial(**config) self.serials[port] = ser threading.Thread(target=self._listener, args=(ser,)).start() except serial.SerialException as e: print(f"Failed to open {port}: {e}") def _listener(self, ser): while True: data = ser.read_all() if data: self.handle_data(ser.port, data) def handle_data(self, port, data): # 自定义数据处理逻辑 print(f"[{port}] Received: {data.decode('utf-8', errors='ignore')}") # 使用示例 ports = { '/dev/ttyAMA0': {'baudrate': 115200, 'timeout': 1}, '/dev/ttyAMA10': {'baudrate': 9600, 'timeout': 1} } manager = MultiSerialManager(ports)这个框架可以轻松扩展支持更多串口设备，每个端口都有独立的配置和数据处理逻辑。