03 // MAKER树莓派 5阅读与复现约 11 分钟
树莓派 5 离线语音与视觉 AI 实验箱：完整物料清单 (BOM)、供电排坑与分步验证
基于树莓派 5 (8GB) 搭建完全离线的 AI 实验终端：提供精确到规格的物料清单、新手最易翻车的供电与散热自检，以及真实耗时评估。
[核心实测结论 / TL;DR]在 Tinker AI 实测工坊针对「树莓派 5 离线语音与视觉 AI 实验箱：完整物料清单 (BOM)、供电排坑与分步验证」的复现测试中（实测环境：Raspberry Pi 5 (8GB 内存版) · 官方 27W (5V/5A) PD 电源 · 官方主动散热器 · 64GB A2 卡或 NVMe 扩展板，软件版本：Raspberry Pi OS Bookworm (64-bit) / Ollama 0.5.7 ARM64 / qwen2.5:3b-instruct-q4_K_M，验证日期：2026-10-23）：基于树莓派 5 (8GB) 搭建完全离线的 AI 实验终端：提供精确到规格的物料清单、新手最易翻车的供电与散热自检，以及真实耗时评估。 离线边界为「部署完成后支持拔掉网线 100% 离线运行」（非常适合创客课堂、家庭科普实验与无外网环境下独立演示。），关键限制包括：真实耗时说明：新手从零烧录系统、配置 ALSA 音频权限到拉取模型完成验收，真实耗时约为 90–150 分钟（通常超过 2 小时），切勿轻信未经实测的“半小时极速搞定”承诺。
REPRODUCIBILITY MANIFEST // 实测环境与边界清单
最后实测验证日期：2026-10-23实测硬件与操作系统 (Tested Hardware & OS)
Raspberry Pi 5 (8GB 内存版) · 官方 27W (5V/5A) PD 电源 · 官方主动散热器 · 64GB A2 卡或 NVMe 扩展板
锁定软件与模型版本 (Pinned Stack Versions)
Raspberry Pi OS Bookworm (64-bit)Ollama 0.5.7 ARM64qwen2.5:3b-instruct-q4_K_M
离线与外部连接核查 (Offline & Network Boundary)
部署完成后支持拔掉网线 100% 离线运行
非常适合创客课堂、家庭科普实验与无外网环境下独立演示。
已知限制与失败案例 (Known Limits)
- 真实耗时说明：新手从零烧录系统、配置 ALSA 音频权限到拉取模型完成验收，真实耗时约为 90–150 分钟（通常超过 2 小时），切勿轻信未经实测的“半小时极速搞定”承诺。
- 供电硬性限制：使用普通 5V/3A 手机充电器在四核满载推理时会触发低电压限制，导致 USB 麦克风或摄像头随机掉线。
遇到环境异常？打开排障诊断树 →
1. 经实测验证的物料清单 (BOM) 与选型避坑说明
动手前请逐一核对以下核心物料规格（任何一项缩水都会导致后续实验卡死）：
• **主板**：Raspberry Pi 5 8GB 内存版（4GB 版本扣除系统后仅剩约 2.6GB，跑 3B 模型加语音缓冲会频繁卡死）。
• **电源**：官方 27W USB-C PD 电源（必须具备 5.1V / 5A 档位，否则树莓派 5 会将 USB 外设限流在 600mA）。
• **散热**：官方主动涡轮散热器 Active Cooler（本地推理会让 4 颗 Cortex-A76 核心满载，纯被动散热片约 90 秒就会触及 80°C 降频线）。
• **存储**：64GB A2 等级高速 TF 卡或 PCIe NVMe 固态（普通低速卡仅冷启动加载模型权重就需耗时 45 秒以上）。
• **外设**：免驱 USB 麦克风（支持 Linux UAC 标准）与 USB 摄像头。
表 1：树莓派 5 离线 AI 实验箱完整物料清单 (BOM) 与降级风险对照
| 物料模块 | 实测通过规格 | 参考预算 | 偷工减料导致的典型翻车 |
|---|---|---|---|
| 核心主板 | Raspberry Pi 5 (8GB 内存版) | ¥620 ($80) | 4GB 版同时跑语音识别与 3B 模型会触发严重内存交换卡死 |
| 供电电源 | 官方 27W PD 电源 (5.1V / 5A) | ¥85 ($12) | 普通 5V/3A 充电头会将 USB 限流 600mA，满载时麦克风随机断连 |
| 散热模块 | 官方 PWM 主动涡轮散热器 | ¥35 ($5) | 纯被动贴片散热在连续生成 90 秒后触及 80°C 红线，算力降频 40% |
| 系统存储 | 64GB A2 高速 TF 卡或 NVMe 扩展 | ¥65 – ¥220 | 劣质低速卡首次将 2.1GB 模型映射进内存需卡顿 45 秒以上 |
2. 供电、温控自检与树莓派 5 实测性能基线
运行配套的硬件自检脚本（`pi5-offline-ai-verify.sh`）检查 `vcgencmd get_throttled`。返回值必须为 `throttled=0x0`。在 24°C 室温配合主动散热器下，`qwen2.5:3b`（`Q4_K_M`, `num_ctx=2048`）可稳定保持 **8.4–9.6 tokens/s** 的生成速度，峰值温度稳定在 63°C，完全满足离线语音对答需求。
Check Undervoltage & ALSA Audio Permissions on Pi 5
# 1. Verify zero under-voltage (0x0 is healthy; 0x50000 or 0x50005 means power supply is weak) vcgencmd get_throttled # 2. Grant current user direct access to USB audio & video devices without sudo sudo usermod -aG audio,video $USER # 3. Record a 3-second test clip from USB microphone (Card 1, Device 0) arecord -D plughw:1,0 -f S16_LE -r 16000 -d 3 test-mic.wav && aplay test-mic.wav
3. 拔网线离线自启动验证与模型权重预热
在无外网的创客课堂或科展现场演示时，如果学生提出第一个问题要等 45 秒冷启动读卡，互动体验会大打折扣。建议在开机启动脚本中通过一条 `keep_alive: -1` 的预热请求将 `qwen2.5:3b` 锁定在内存中，并彻底断开 Wi-Fi 与网线进行断网实测验收。
FIELD Q&A // 常见实测疑问与边界解答
复现常见疑问与深层原理解答
Q: 运行 `vcgencmd get_throttled` 显示 `throttled=0x50000` 或 `0x50005` 代表什么？
这代表树莓派在启动或满载推理期间触发过“输入电压低于 4.63V 欠压保护”。请立即更换为支持 5.1V / 5A 档位的官方 27W PD 电源，避免 SD 卡文件系统损坏或 USB 掉线。
Q: 树莓派 5 (8GB) 能强行跑 7B 参数量的模型吗？
在关闭桌面 GUI 的纯命令行模式下，8GB 树莓派 5 勉强能加载 7B Q4_K_M（约 4.7GB），但受限于 17 GB/s 的内存带宽，生成速度仅约 2.8–3.4 tok/s。在交互式实验箱场景下，选用 `qwen2.5:3b`（约 9 tok/s）体验好得多。
REPRODUCIBLE ARTIFACT // 配套可参数化附件
pi5-offline-ai-verify.sh ↗树莓派 5 离线语音/视觉 AI 实验箱 — 硬件、供电与温控自检脚本
在运行本地模型前，一键检测树莓派 5 27W PD 供电降频状态、CPU 温度、USB 麦克风/摄像头挂载及推理环境。
修改上方参数将实时更新下方配置内容
#!/usr/bin/env bash
# Tinker AI Maker Lab — Raspberry Pi 5 Pre-Flight & BOM Verification
set -euo pipefail
echo "=== [1/4] Checking Power Supply & Thermal Throttling ==="
if command -v vcgencmd >/dev/null 2>&1; then
THROTTLED=$(vcgencmd get_throttled)
TEMP=$(vcgencmd measure_temp)
echo "Status: $THROTTLED | Temp: $TEMP"
if [ "$THROTTLED" != "throttled=0x0" ]; then
echo "WARNING: Under-voltage or thermal throttling detected! Use official 5V/5A (27W) USB-C PD supply + active cooler."
fi
fi
echo "=== [2/4] Verifying USB Audio (USB) & Camera Devices ==="
arecord -l | grep -i "USB" || echo "Notice: Matching USB microphone not found."
ls -l /dev/video* 2>/dev/null || echo "Notice: No /dev/video* camera node detected."
echo "=== [3/4] Checking Available Memory (Require >= 4.5GB Free for qwen2.5:3b) ==="
free -h
echo "=== [4/4] Smoke-Testing Offline Model (qwen2.5:3b, num_ctx=2048) ==="
ollama run "qwen2.5:3b" "Reply in 10 words: confirm offline edge node is operational."