📥 免费 A4 树莓派 40 针 GPIO 与 Linux 速查表（矢量 PDF，英文版）
为创客与开发者制作的 8 区矢量 A4 参考海报已上线：彩色 40 针排针图、常用 vcgencmd 命令、看门狗、OverlayFS、ZRAM 与 PCIe Gen 3 设置配方。
📊 一览：树莓派架构与关键阈值
把单板计算机变成不会崩溃的高性能工业设备所需的技术里程碑与安全阈值。[1][4][5]
| 严重欠压 | 4.63V（电压瞬时跌破此值，PMIC 会把 CPU 频率限制到 600 MHz）。[4] |
|---|---|
| 温度降频 | 80°C / 85°C（80°C 起逐步降频；85°C 时核心电压锁定并严重降频）。[4] |
| GPIO 逻辑电平 | 3.3V LVTTL（排针绝不耐受 5V；直接接触 5V 会永久烧毁 SoC）。[5] |
| 根文件系统保护 | OverlayFS（把 ext4 日志写入重定向到 RAM 的 tmpfs，保证 SD 卡零损坏）。[6] |
| 内存加速 | ZRAM（lz4/zstd）（在 RAM 内压缩内存块，消除 SD 卡交换 I/O 瓶颈）。[7] |
| 硬件哨兵 | bcm2835_wdt（博通 SoC 定时器；内核恐慌后 15 秒执行冷硬件重启）。[8] |
2012 年 2 月一个结冰的早晨。剑桥大学计算机实验室的走廊。
实验室主任 Eben Upton 和同事们正在讨论一个令人不安的趋势。1980 年代，大学申请者从小摆弄 BBC Micro 和 Commodore 64；他们是熟悉机器码、烙铁和硬件寄存器的年轻黑客。到了 2000 年代，申请者只会在商业操作系统的封闭围墙内浏览网页。能够直接与微控制器交互的学生数量已接近零。[1]
Upton 和团队定下一个大胆目标：造一台信用卡大小、售价仅 25 美元、便宜到孩子用零花钱就能买的完整 Linux 计算机。[1][2]
最初预计销量也许只有 1,000 到 10,000 台，如今这块不起眼的绿色电路板全球销量已超过 6,000 万块，支撑着国际空间站实验、海洋研究浮标、自动化工厂和数百万创客工作台。[1][3]
型号家族与硬件选择矩阵（2026）
选择正确的板子需要在功耗、价格和散热之间取得平衡：
| 型号 | SoC / 处理器 | 内存 | PCIe 与 NVMe | 供电与功耗 | 理想用途 |
|---|---|---|---|---|---|
| Raspberry Pi 5 | Broadcom BCM2712（4× A76 @ 2.4 GHz） | 2GB – 16GB LPDDR4X | ✅ 1 通道 PCIe Gen 2/3 | 5V / 5.0A USB-C PD（3.5W – 12W） | 桌面 PC、边缘 AI、NVMe 服务器、Docker 主机 |
| Raspberry Pi 4 Model B | Broadcom BCM2711（4× A72 @ 1.8 GHz） | 1GB – 8GB LPDDR4 | ❌ 无外部通道 | 5V / 3.0A USB-C（3.0W – 7.5W） | 媒体中心（Kodi）、Home Assistant、RetroPie、NAS |
| Raspberry Pi 3 Model B+ | Broadcom BCM2837B0（4× A53 @ 1.4 GHz） | 1GB LPDDR2 | ❌ 无 | 5V / 2.5A Micro-USB（2.5W – 5.5W） | Pi-hole DNS 黑洞、复古模拟、轻量 IoT |
| Raspberry Pi 2 Model B | Broadcom BCM2836（4× A7 @ 900 MHz, v1.1）/ BCM2837（v1.2） | 1GB LPDDR2 | ❌ 无 | 5V / 2.0A Micro-USB（1.5W – 3.5W） | 气隙有线网络（无内置 Wi-Fi/蓝牙）、Pi-hole、MQTT、复古街机 |
| Raspberry Pi Zero 2 W | RP3A0 SiP（4× A53 @ 1.0 GHz，64 位） | 512MB LPDDR2（SiP 内） | ❌ 无 | 5V / 1.5A Micro-USB（0.7W – 2.8W） | 便携 IoT、无人机、安防摄像头、Pwnagotchi |
| Raspberry Pi Pico 2 | RP2350（双 Cortex-M33 + 双 RISC-V） | 520KB SRAM + 4MB Flash | ❌ 微控制器 | 1.8V – 5.5V 输入（0.05W – 0.2W） | 实时电机控制、传感器遥测、裸机开发 |
⚡ 第一个转折：SD 卡神话与脆弱存储
90% 的 SD 卡损坏并非劣质闪存颗粒造成，而是 Linux ext4 日志文件系统在断电时被中断。解决办法不是买昂贵卡，而是把根文件系统锁定为只读模式。[6]
1. 阻止 SD 卡损坏：OverlayFS（只读根）
OverlayFS 把物理 SD 卡严格锁定为只读。所有系统写入、临时文件和日志都被重定向到易失的 tmpfs RAM 层。即使一天断电 50 次，也不会有任何一个损坏字节写入 SD 卡。[6]
sudo raspi-config
# -> Performance Options -> Overlay File System -> Enable -> Yes
# -> Boot partition read-only -> Yes -> Reboot
# 2. 验证状态（根目录运行在 tmpfs overlay 上）：
mount | grep “overlay on /”
2. ZRAM 内存压缩：低内存板子的救星
在 Pi Zero 2 W（512 MB）或 1GB/2GB 的 Pi 4 上，传统磁盘交换会把 SD 卡拖到停滞（I/O 抖动）。ZRAM 把一部分 RAM 变成压缩的虚拟块设备。使用 lz4 时，数据以 1:3 比例实时压缩，让 512 MB 的板子获得约 1.2 GB 的有效余量，且零磁盘磨损。[7]
sudo dphys-swapfile swapoff && sudo systemctl disable dphys-swapfile
# 安装 zram-tools：
sudo apt update && sudo apt install -y zram-tools
# 编辑 /etc/default/zramswap：
PERCENTAGE=60
ALGO=lz4
PRIORITY=100
sudo systemctl restart zramswap && zramctl
3. 硬件看门狗定时器：防崩溃自动重启哨兵
博通 SoC 内置硬件倒计时定时器（bcm2835_wdt）。如果 Linux 内核挂起或冻结，系统无法“喂狗”，硬件会在 15 秒后触发冷复位，无需人工干预即可恢复。[8]
dtparam=watchdog=on
# 2. 配置 /etc/systemd/system.conf：
RuntimeWatchdogSec=14s
RebootWatchdogSec=10min
# 3. 重启并模拟一次硬内核崩溃：
echo 1 | sudo tee /proc/sys/kernel/sysrq
echo c | sudo tee /proc/sysrq-trigger
4. USB OTG Gadget 模式：一根 USB 线完成无头 SSH
用普通 USB 线把 Raspberry Pi Zero、Zero 2 W 或 Pi 4 连接到电脑；板子会枚举为一块虚拟以太网卡，让你无需显示器或本地 Wi-Fi 路由器即可直接 SSH 登录。[9]
# 1. 在 config.txt 添加：dtoverlay=dwc2
# 2. 在 cmdline.txt 的 rootwait 之后追加：modules-load=dwc2,g_ether
# 3. 生成空的 ‘ssh’ 与 ‘userconf.txt’ 文件。
# 4. 插入电脑并连接：
ssh pi@raspberrypi.local
⚡ 第二个转折：电压错觉与 4.63V 之谜
大多数莫名其妙的崩溃不是软件 bug。劣质手机充电器在负载下会掉压，一旦跌破 4.63V，硬件就会把时钟降到 600 MHz。vcgencmd get_throttled 命令能立刻揭穿这一点。[4]
5. 欠压诊断：解读 vcgencmd get_throttled
| 十六进制码 | 含义 | 诊断与处理 |
|---|---|---|
0x1 |
当前欠压（<4.63V） | 板子供电不足！立即更换电源或线缆。 |
0x2 |
当前 Arm 频率被限制 | 低电压导致 CPU 时钟被限制。 |
0x4 |
当前温度降频（>80°C） | SoC 超过 80°C；需要主动散热。 |
0x50000 |
曾经发生欠压与温度事件 | 自启动以来经历过掉压和过热。 |
0x0 |
完全健康 | 未检测到电压跌落或温度事件。 |
6. 树莓派 5 PCIe Gen 3 与 NVMe SSD 启动
Pi 5 上的 PCIe FPC 排线接口默认 Gen 2.0（450 MB/s）。搭配优质 NVMe HAT+，可以强制 Gen 3.0 速度（870+ MB/s），并配置 EEPROM 在完全无 SD 卡的情况下启动。[10]
dtparam=pciex1
dtparam=pciex1_gen=3
# 2. 在 EEPROM 中设置 NVMe 启动优先级：
sudo rpi-eeprom-config –edit
# BOOT_ORDER=0xf416（6=NVMe，1=SD 卡）
# 3. 测试 NVMe 读取速度：
sudo hdparm -t /dev/nvme0n1 # 850 – 890 MB/sec！
7. 40 针 GPIO 与 3.3V LVTTL 生存规则
与 5V 传感器配合时，务必使用双电阻分压（1kΩ / 2kΩ）或双向逻辑电平转换器。每个引脚的安全灌/拉电流为 3-8 mA（绝对最大 16 mA），所有引脚合计预算为 50 mA。[5]
8. Kiosk 模式：静默无头启动
为商业仪表盘和 kiosk 隐藏 Linux 控制台输出、树莓派 logo 和光标闪烁：
quiet loglevel=3 logo.nologo consoleblank=1 vt.global_cursor_default=0
# 添加到 /boot/firmware/config.txt：
disable_splash=1
常见问题（FAQ）
技术参考资料
- Upton, E. & Halfacree, G. (2014). Raspberry Pi User Guide (3rd Edition). John Wiley & Sons. [ISBN: 978-1118921661]
- Cellan-Jones, R. (2012). A £15 computer to inspire young programmers. BBC News Technology. bbc.com/news/technology-13294371
- Raspberry Pi Foundation. (2024). Annual Review and 60 Million Units Milestone. raspberrypi.org/about
- Raspberry Pi Documentation. (2026). Power Supply & Under-voltage Warning System (vcgencmd). raspberrypi.com/documentation/computers/raspberry-pi.html
- Broadcom BCM2835 / BCM2711 Peripherals Datasheet. (2020). General Purpose I/O (GPIO) Electrical Specifications & 3.3V LVTTL Limitations. Broadcom Corporation.
- Linux Kernel Documentation. (2025). Overlay Filesystem (OverlayFS) Specification. docs.kernel.org/filesystems/overlayfs.html
- Kernel.org. (2025). ZRAM: Compressed Virtual Memory for Linux. docs.kernel.org/admin-guide/blockdev/zram.html
- Raspberry Pi Hardware Architecture. (2025). Watchdog Timer Integration (bcm2835_wdt). raspberrypi.com/documentation/computers/configuration.html
- Linux USB Gadget Subsystem Documentation. (2024). Ethernet over USB (g_ether) Architecture. docs.kernel.org/usb/gadget_testing.html
- Plowman, J. (2023). Introducing Raspberry Pi 5: The RP1 I/O Controller & PCIe Architecture. Raspberry Pi Engineering Blog. raspberrypi.com/news/introducing-raspberry-pi-5
