SuperAPI AI 工具集

raspberry-pi-ai

编程与开发

查看项目

更新于 11-03 05:17

技能介绍

用途

该技能用于支持开发稳健、安全且性能良好的 Raspberry Pi 边缘 AI 项目。它以资深嵌入式系统架构师的角色工作,强调解释“为什么”而不仅是“怎么做”,并使用瑞士德语正字法。适用于用户规划 Pi 项目、需要含组件清单的搭建方案、涉及传感器、NPU 或边缘 AI 推理,以及需要调试硬件或软件问题的场景。

主要能力

  • 分级分析深度:根据复杂度选择分析层级。Level 1 直接执行 CLI 命令与包管理;Level 2 处理多组件与传感器融合,要求创建 plan.md 并检查电源、引脚与库;Level 3 分析异步、内核与安全问题,包括竞态条件和内存泄漏;Level 4 检查 NPU 流水线、量化、张量运算、带宽与散热。
  • 需求分析与选型指导:在实现前明确目标硬件(Pi 4 或 Pi 5,内存 1/2/4/8/16 GB)、电源预算与散热、实时性要求、网络连接、使用环境、PCIe 需求(NVMe 与 NPU 共用同一接口,只能二选一)以及 NPU 变体。资料指出 AI Kit 已停产,AI HAT+ 与 AI HAT+ 2 可选;只有 AI HAT+ 2(Hailo-10H)能在 NPU 上运行语言模型,Hailo-8 和 8L 是纯视觉加速器,无法通过软件升级获得该能力。
  • 预检清单:项目开始前检查电源适配器功率(Pi 5 为 27W USB-C PD;仅 3A 时外设限流 600 mA)、Active Cooler 安装、电源预算低于 80%、Python venv(PEP 668,Bookworm 起适用)、工作环境温度 0–70°C、放置稳定且不导电、外壳不被遮盖。首次安装或无头配置时还检查启动介质容量与上限、SSH 或 Raspberry Pi Connect 是否在 Imager 中启用、WiFi 配置方式、设备支持的 WiFi 频段、上电顺序、唯一主机名、外部访问使用 VPN 或 Connect 而非开放 SSH/VNC。长期运行或现场设备还要求配置可复现、fstab 条目带 nofail、日志策略、只读覆盖文件系统、关机行为、基于密钥的 SSH 与 UFW、看门狗设置、远程更新使用 A/B 启动、执行器外部下拉电阻。Pi 5 还检查 Mini-CSI 线缆(22 针与 15 针不同)、RP1 兼容性、PCIe 模式(Gen 2 为规范,Gen 3 为选配无保证)、Wayland 与 X11 选择。PCIe 配件还检查 FFC 线缆长度与类型、M.2 尺寸、M.2 HAT+ 的 50°C 上限、自研板下拉电阻。外壳与 HAT 堆叠还检查尺寸 88×56 mm、官方 Bumper 尺寸 89.6×60.6×10 mm、孔距 58×49 mm 与 Ø2.7 mm、内部高度约 19 mm、通风。
  • 项目规划:对超过 10 行代码或涉及硬件集成的项目,基于模板创建 plan.md。
  • 安全清单:GPIO 工作前验证所有信号 ≤3.3V、驱动电流限制(Pi 1/2/3/Zero 16 mA,Pi 5 12 mA 默认 4 mA,Pi 4 仅 8 mA,所有引脚合计约 50 mA)、电机与继电器通过晶体管或 H 桥、Pi 5 使用 5.1V/5A USB-C PD 电源、避免触摸电路板。
  • 实现标准:使用当前主版本 Trixie 或上一版 Bookworm,边缘 AI 必须 64 位;更新使用 sudo apt update && sudo apt full-upgrade;Python 使用 python3 -m venv .venv --system-site-packages,能用 apt 安装的包不编译;GPIO 使用 gpiozero 而非 RPi.GPIO;网络使用 nmcli 而非 dhcpcd;I2C/SPI 使用 smbus2、spidev、Adafruit Blinka;固件通过 apt 更新,预发布软件通过 raspi-config 的 Beta Access 而非 rpi-update;内核模块通过 apt 安装头文件(linux-headers-rpi-v8),顺序为更新→重启→头文件→模块;配置通过 raspi-config 或 /boot/firmware/config.txt 而非桌面 GUI。采用增量构建:OS 基础配置、逐个测试硬件组件、软件层 1、软件层 2、集成、端到端测试。
  • 调试支持:遇到问题时先加载调试手册,采用三步隔离法(硬件隔离:GPIO LED 闪烁、i2cdetect -y 1、rpicam-still、arecord/aplay;软件隔离:Mock 数据脚本、库可导入、服务可达;接口检查:权限组、venv 激活、设备节点存在)。提供大量快速诊断命令,如 vcgencmd get_throttled、vcgencmd get_config total_mem、vcgencmd measure_temp、vcgencmd measure_clock arm、vcgencmd pmic_read_adc EXT5V_V、free -h、vcgencmd get_config int/str、hostname -I、nmcli device show、avahi-browse -a、ethtool -P eth0、i2cdetect -y 1、lsusb -t、rpicam-hello --list-cameras、systemctl status、journalctl、dmesg、vclog --msg、读取电源协商电流、hailortcli fw-control identify、dkms status、Ollama 与 hailo-ollama 的本地 API 检查。
  • 常见问题覆盖:列出大量 Pi 5 特定陷阱与通用问题,例如 Mini-CSI 线缆不兼容、RP1 驱动不兼容、PEP 668 pip 阻止、PCIe Gen 3 不稳定、Wayland/X11 冲突、HAT 堆叠、环境温度超限、FFC 线缆问题、M.2 HAT+ 温度上限、从 Pi 4 代码移植导致的位操作问题、驱动电流误解、传感器电压阈值差异、外设限流、无头设备不可达、显示器无输出、apt upgrade 与 full-upgrade 区别、get_mem arm 误报、串口设备映射、dtoverlay 静默失败、Pi 5 平台覆盖映射、LED 行为、NVMe 启动顺序、cmdline.txt 换行、dtoverlay 行长度限制、配置过滤器作用域、[pi5] 匹配范围、include 文件中无效选项、看门狗未生效、继电器上电误动作、CPU 频率读取误区、超频电压设置、显示模式限制、NoIR 相机调优、过时相机命令、SSH X 转发预览、相机自动检测、Pi 5 视频编码 CPU 开销、H.264 播放、rpicam-apps 阶段缺失、Hailo 安装方式、LLM 在 NPU 上的限制、hailo-all 与 hailo-h10-all 冲突、自编译 Hailo 模型版本匹配、hailortcli 中 N/A 含义、TOPS 规格匹配、热降频、PCIe 资源冲突、AI Camera 启动延迟、IMX500 模型转换链、GenAI 模型大小与 HAT 内存、TOPS 比较的数据类型差异、GPS 干扰、Build HAT 平台支持、Sense HAT 温度测量、音频板设备选择等。

使用方式

用户触发该技能后,按其复杂度选择分析层级;Level 2 及以上创建 plan.md;实现前执行预检清单与安全清单;实现中遵循软件标准与增量构建;遇到问题先查阅调试手册并应用三步隔离法与诊断命令。资料还引用了 /mnt/skills/user/raspberry-pi-ai/references/debugging-playbook.md、/mnt/skills/user/raspberry-pi-ai/assets/plan-template.md 以及 edge-ai.md、camera.md、accessories.md 等参考文件,但未提供这些文件的完整内容。

适用场景

适合 Raspberry Pi 边缘 AI 项目的规划、硬件选型、搭建方案编写、GPIO 与传感器集成、NPU 加速器配置、系统调试与故障排查。尤其适合 Pi 5 平台、涉及 Hailo NPU、NVMe、相机模块、长期运行或现场部署的项目。

限制

资料未提供该技能的价格、收费模式、性能保证或具体项目效果。部分内容(如 AI Kit 已停产、Build HAT 在 Trixie 上尚未支持)为资料中的状态描述,可能随时间变化。引用文件的具体内容暂未提供。分类依据明确用途选为编程与开发。