TinkerLab
ARTIFACT // PI5-OFFLINE-AI-VERIFY.SH (SHELL)

树莓派 5 离线语音/视觉 AI 实验箱 — 硬件、供电与温控自检脚本 (pi5-offline-ai-verify.sh)

在运行本地模型前,一键检测树莓派 5 27W PD 供电降频状态、CPU 温度、USB 麦克风/摄像头挂载及推理环境。

[核心实测结论 / TL;DR]本配置包「树莓派 5 离线语音/视觉 AI 实验箱 — 硬件、供电与温控自检脚本」(文件名:pi5-offline-ai-verify.sh,格式:SHELL)是 Tinker AI 实测工坊配套指南《pi5-offline-voice-vision-box》的参数化生产模板。支持在本地浏览器实时定制 边缘轻量模型 Tag (PI_MODEL_TAG=qwen2.5:3b)、USB 麦克风设备名关键字 (AUDIO_CARD_HINT=USB) 等 2 项核心变量,默认遵循 127.0.0.1 回环绑定与最小权限规范。
03 // MAKERAI 创客 / STEM· 验证日期:2026-10-23
查看全部 42 套配置附件 →
pi5-offline-ai-verify.sh

树莓派 5 离线语音/视觉 AI 实验箱 — 硬件、供电与温控自检脚本

在运行本地模型前,一键检测树莓派 5 27W PD 供电降频状态、CPU 温度、USB 麦克风/摄像头挂载及推理环境。

查看配套实测指南 →
参数化定制变量 (Variables — 自动保存在本地浏览器)
UTF-8 编码 · 零延迟实时编译
#!/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."
PARAMETER SPECIFICATION // 参数化变量规范说明表

「pi5-offline-ai-verify.sh」可定制环境变量与默认值说明

本配置模板(SHELL 格式)支持 2 项运行时参数注入,所有替换均在本地浏览器内完成。

模板占位符参数用途说明安全默认值填写示例
{{PI_MODEL_TAG}}边缘轻量模型 Tagqwen2.5:3bqwen2.5:3b
{{AUDIO_CARD_HINT}}USB 麦克风设备名关键字USBUSB
PAIRED HARDWARE MANIFEST // 配套实测环境与边界记录

配套指南《树莓派 5 离线语音与视觉 AI 实验箱:完整物料清单 (BOM)、供电排坑与分步验证》验证基线

实测硬件与操作系统 (Hardware & OS)

Raspberry Pi 5 (8GB 内存版) · 官方 27W (5V/5A) PD 电源 · 官方主动散热器 · 64GB A2 卡或 NVMe 扩展板

锁定软件栈与模型版本 (Pinned Versions)
Raspberry Pi OS Bookworm (64-bit)Ollama 0.5.7 ARM64qwen2.5:3b-instruct-q4_K_M
离线与安全边界 (部署完成后支持拔掉网线 100% 离线运行)

非常适合创客课堂、家庭科普实验与无外网环境下独立演示。

已知限制与失败边界 (Known Limits)
  • 真实耗时说明:新手从零烧录系统、配置 ALSA 音频权限到拉取模型完成验收,真实耗时约为 90–150 分钟(通常超过 2 小时),切勿轻信未经实测的“半小时极速搞定”承诺。
  • 供电硬性限制:使用普通 5V/3A 手机充电器在四核满载推理时会触发低电压限制,导致 USB 麦克风或摄像头随机掉线。
DEPLOYMENT CHECKLIST // 配置落地核验步骤

部署 pi5-offline-ai-verify.sh 后的 3 步验收清单

  1. 执行 `uname -m` 确认系统为 `aarch64`(64 位 Bookworm 系统,而非 32 位版本)。
  2. 在模型推理期间检查 `vcgencmd get_throttled`,确认输出为 `throttled=0x0` 无欠压或过热降频。
  3. 已将边缘模型上下文 `num_ctx` 限制为 2048,确保 8GB 内存留有充足安全余量。