零基础也能懂：树莓派5 vs 树莓派4，引脚到底变了哪些？一文讲透！
你有没有这样的经历：手头的树莓派4项目刚调通，结果听说树莓派5性能翻倍，立马下单换新板——可一插HAT扩展板，发现风扇不转、屏幕黑屏、系统还反复重启？别急，问题很可能不在代码，而藏在那排熟悉的40针GPIO接口里。
没错，虽然树莓派5和树莓派4长得几乎一模一样，都是2×20排列的金属引脚，但“内功”已经大不一样。尤其是那些控制电源、通信、复用功能的关键信号线，稍不留神就会踩坑。今天我们就抛开术语堆砌，用最直白的语言，带你搞清楚：树莓派5的引脚到底改了什么？老外设还能不能用？怎么安全迁移项目？
为什么外观一样，却不能无脑兼容？
先说结论：物理兼容 ≠ 功能兼容。
树莓派团队很聪明地保留了40针的标准布局（P1到P40），这意味着你的杜邦线、面包板、HAT模块都能直接插上去。但从内部看，SoC芯片从BCM2711升级到了基于RP3A0-B（本质是BCM2712）的新架构，GPIO控制器也换了代。这就像两辆外形相同的汽车，一辆是燃油车，另一辆是混动——方向盘位置没变，但油门响应、电路逻辑全变了。
所以哪怕你把树莓派4的代码原封不动搬到Pi 5上跑，也可能因为底层时钟源、默认使能状态或新增控制信号的不同，导致外设失灵甚至系统异常。
引脚核心差异全景图：一张表看懂关键变化
我们先不谈复杂原理，直接上干货。以下是树莓派4与树莓派5在GPIO层面最关键的几项对比：
| 特性 | 树莓派4 | 树莓派5 | 实际影响 |
|---|---|---|---|
| SoC 芯片 | BCM2711 | RP3A0-B (BCM2712) | 内部资源调度机制不同 |
| GPIO总数（可用） | 28个 | 28个 | 数量不变，功能重映射 |
| 单引脚最大输出电流 | 12mA | 16mA | 可更稳定驱动LED、继电器等负载 |
| 默认I²C总线用途 | I²C-1用于传感器 | I²C-1传感器 +I²C-0专用于HAT识别 | 老HAT可能无法自动加载配置 |
| UART实现方式 | PL011 + mini-UART双模式 | 仅保留PL011 UART，mini-UART弃用 | 减少串口干扰，提升稳定性 |
| PWM精度与时钟源 | 软件模拟为主，频率不稳定 | 硬件级高频基准时钟 | 更适合电机、音频应用 |
| 新增专用控制引脚 | 无 | ✅RUN（启动）、✅GLOBAL_EN（电源使能） | 增强系统控制能力，但也增加误触发风险 |
看到没？驱动能力更强了、通信更稳了、控制更智能了——这些都是进步。但代价是：如果你不了解这些“隐藏规则”，就容易掉进坑里。
最值得关 注的两个新角色：RUN 和 GLOBAL_EN
这两个引脚是树莓派5最大的变化之一，也是最容易出问题的地方。
🟢 RUN 引脚（对应物理Pin 31 / GPIO4）
- 作用：相当于系统的“复位按钮”。正常情况下它被内部上拉为高电平，系统运行。
- 操作方式：将该引脚短暂接地（GND），即可软重启树莓派，无需断电。
- 妙用场景：
- 搭建一个物理重启按钮；
- 在程序崩溃后通过外部MCU触发重启；
- 自动化测试中实现非破坏性重置。
💡 小技巧：可以用一个轻触开关连接 GPIO4 和 GND，做成真正的“重启键”。
🔴 GLOBAL_EN 引脚（物理Pin 18 / 实际为电源管理信号，非普通GPIO）
⚠️ 注意！这不是普通的GPIO18！它是PMIC（电源管理芯片）的使能信号。
- 作用：当此信号被拉低时，整个主板供电会被切断——也就是“关机”。
- 风险点：如果你的HAT扩展板错误地把这个引脚当作普通GPIO使用，并在某些条件下将其接地，就会导致树莓派5突然断电！
- 设计建议：
- 不要在HAT设计中将Pin 18作为通用IO；
- 若必须连接，务必加入电平隔离或缓冲器；
- 明确标注：“本板不兼容树莓派5”或“请确认电源控制逻辑”。
这个改动让电源管理更灵活，但也要求开发者更加谨慎。
I²C、SPI、UART 还能照搬吗？
好消息是：常用通信接口的基本接法仍然一致，但细节上有优化。
I²C：现在有两条“专用通道”
- I²C-1（GPIO2/3）：继续用于连接传感器、OLED屏等设备，地址扫描命令仍是：
bash i2cdetect -y 1 - 新增 I²C-0（GPIO44/45）：专门用来读取HAT模块上的EEPROM信息（即HAT ID）。这是实现自动识别和设备树加载的关键。
📌常见问题：为什么我的旧HAT插上去没反应？
➡️ 很可能是它的ID EEPROM挂在I²C-1上，而Pi 5优先查找I²C-0。解决办法有两个：
1. 手动加载设备树覆盖文件：bash sudo dtoverlay your-hat-overlay
2. 更新HAT固件，支持I²C-0挂载EEPROM。
SPI：基本不变，放心用
- MOSI/GPIO10、MISO/GPIO9、SCLK/GPIO11、CS/GPIO8&7
- 使用方式与Pi 4完全相同，现有代码无需修改。
UART：终于统一了！
树莓派4时代有个头疼的问题：有两个UART，一个质量好（PL011），一个靠软件模拟（mini-UART），经常抢资源。
而在Pi 5上，只保留高质量的PL011 UART，绑定到GPIO14(TX)和GPIO15(RX)，通信更可靠，抗干扰更强。
✅ 推荐做法：始终使用串口调试线接入这两个引脚进行日志输出或故障排查。
实战演示：在树莓派5上读取温湿度传感器
我们以常见的SHT-30为例，走一遍完整流程，验证兼容性和正确配置方法。
第一步：接线（和Pi 4一样）
SHT-30 → 树莓派5 VCC → 3.3V (Pin 1) GND → GND (Pin 6) SDA → GPIO2 (Pin 3) SCL → GPIO3 (Pin 5)⚠️ 切记不要接到5V！所有GPIO均为3.3V电平，且不支持5V耐受，接错可能永久损坏主板！
第二步：启用I²C接口
sudo raspi-config # 选择 Interface Options → I2C → Yes第三步：检查设备是否挂载
i2cdetect -y 1如果看到类似下面的输出，说明成功了：
0 1 2 3 4 5 6 7 8 9 a b c d e f 00: -- -- -- -- -- -- -- -- 10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 40: -- -- -- -- -- -- -- -- 44 -- -- -- -- -- -- -- 50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- ...第四步：Python读取温度（兼容Pi 4 & Pi 5）
import smbus2 import time I2C_BUS = 1 SENSOR_ADDR = 0x44 # SHT-30默认地址 def read_temperature(): bus = smbus2.SMBus(I2C_BUS) # 发送单次测量命令（高重复性） bus.write_i2c_block_data(SENSOR_ADDR, 0x2C, [0x06]) time.sleep(0.05) # 等待转换完成 # 读取6字节数据（温度+湿度） data = bus.read_i2c_block_data(SENSOR_ADDR, 0x00, 6) raw_temp = (data[0] << 8) | data[1] temp_c = -45 + (175 * raw_temp / 65535.0) return round(temp_c, 2) if __name__ == "__main__": print("当前温度:", read_temperature(), "°C")只要I²C已启用，这段代码在Pi 4和Pi 5上都可以运行，完全兼容。
常见“翻车”现场及应对秘籍
❌ 现象1：插入USB设备后系统反复重启
🔥根本原因：你的HAT或底板意外拉低了GLOBAL_EN（Pin 18），导致电源被切断。
🔧解决方案：
- 检查电路设计，确保Pin 18未与其他低电平信号短接；
- 加装三态缓冲器或光耦隔离；
- 改用其他GPIO做信号传输，避开此敏感引脚。
❌ 现象2：PWM控制风扇转速不线性、噪音大
🔥原因：树莓派5的PWM时钟源变了，传统RPi.GPIO库的软件PWM不再精准。
🔧推荐方案：使用pigpio守护进程实现硬件级PWM：
sudo pigpiod # 启动守护进程import pigpio pi = pigpio.pi() if not pi.connected: exit(1) # 设置频率为1kHz，适用于大多数DC风扇 pi.set_PWM_frequency(18, 1000) pi.set_PWM_dutycycle(18, 128) # 50% 占空比（0~255）✔️ 效果：转速平稳、噪声小、响应快，远胜于软件模拟。
❌ 现象3：HAT无法自动识别，设备树没加载
🔥 原因：老HAT的ID EEPROM挂在I²C-1上，而Pi 5期望在I²C-0读取。
🔧 解决路径：
1. 查看是否存在/proc/device-tree/hat/目录；
2. 如果没有，尝试手动加载.dtbo文件；
3. 或联系厂商获取Pi 5兼容版本。
给开发者的五条黄金建议
永远不要假设“插上去就能用”
即使是同一型号的HAT，在不同代际间也可能行为不同。动手前先查文档。善用工具查看真实引脚状态
使用命令实时查询当前配置：bash raspi-gpio get
输出示例：GPIO 0: level=1 fsel=0 func=INPUT GPIO 1: level=1 fsel=0 func=INPUT ... GPIO 2: level=1 fsel=4 func=ALT0
可直观看到每个引脚的功能模式（ALT0通常是I²C）。优先使用高级抽象库
推荐顺序：gpiozero>pigpio>RPi.GPIO
前两者对跨平台兼容性处理更好，尤其gpiozero自带大量设备驱动模板。区分物理编号和BCM编号
- 物理编号：板子边上印的数字（如Pin 12）
- BCM编号：编程使用的GPIO编号（如GPIO18）
混淆会导致接错线！建议画图时同时标注两者。留好调试退路
不要占用GPIO14/15（UART TX/RX）去做别的事。一旦系统出问题，它们是你最后的“救命通道”。
写在最后：理解变化，才能驾驭升级
树莓派5不是简单的“性能增强版”，它是一次深层次的系统重构。引脚虽看似未变，实则暗流涌动。但只要你掌握了这些关键差异——特别是RUN和GLOBAL_EN的存在、I²C分工的细化、PWM机制的升级——就能从容应对项目迁移中的各种“诡异现象”。
未来的Compute Module 5、工业级Pi产品都将延续这套设计理念。早一点适应，就能早一步释放性能红利。
如果你正在从Pi 4转向Pi 5，欢迎在评论区分享你的实战经验或遇到的坑，我们一起填平升级路上的每一个陷阱。
