KJX ENGINEERING GUIDE · 07
Pi 5 AI HAT+ 2 运行时与模型验收
将 Pi 5、AI HAT+ 2、PCIe 配套、供电散热和模型运行时锁定为一套配置,不混用上一代 HAT 的安装与性能结论。
参考流程 · 目标模型与整机待验证
进阶
参考学习时长 按系统镜像与模型范围评估
核查 2026-10-03
原作者实物参考 · Pi 5 + AI HAT+ 2 本地模型开发
适用说明:本手册用于 Raspberry Pi 5 与 AI HAT+ 2 / Hailo-10H 的实际版本;旧 AI HAT+ 或其他 Hailo 设备分别核对。实施时请以目标板卡、固件和外设的实际版本为准;正式交付的功能、资料与验收标准以订单或技术协议为准。
准备与目标
适用范围Raspberry Pi 5 与 AI HAT+ 2 / Hailo-10H 的实际版本;旧 AI HAT+ 或其他 Hailo 设备分别核对
实施方式参考流程 · 目标模型与整机待验证;按目标硬件执行并记录结果
开始前准备
- Pi 5、AI HAT+ 2 及实际内含配件
- 符合原厂要求的供电、PCIe 线与散热
- 受支持系统镜像和运行时版本
- 有权限部署的目标模型及样本
完成后应得到
- 防止代际与运行时混配
- 分离硬件枚举和模型可用性
- 将性能与热稳定结果留证
01 · 明确型号和采购范围
扩展卡有算力不表示任意模型即插即用。
- 逐项核对 Pi 5 内存、AI HAT+ 2 型号、线缆/固定件、存储、电源和散热,区分内含与另购。
- 查原厂 AI 软件文档,记录系统、内核、驱动、运行时和目标模型的支持组合。
- 把模型许可、转换工具和网络下载需求单列;未受支持模型列为适配任务,不直接承诺本地运行。
✓ BOM 无漏件或重复件✓ 支持组合有依据✓ 模型适配范围明确
02 · 断电装配与设备枚举
先让系统正确识别扩展卡。
- 按原厂说明关机断电安装 PCIe 排线与支撑件,检查线缆方向、散热和固定;不带电插拔。
- 保留原系统备份,按锁定版本安装依赖并记录设备枚举及驱动日志。
- 在不运行模型时检查供电告警、温度与系统稳定性,再执行对应硬件的原厂最小样例。
✓ 安装方向可核对✓ 设备与驱动可见✓ 最小样例通过
03 · 模型正确性与负载
先单任务,再测实际多模态组合。
- 固定模型哈希、输入/输出格式、运行参数和样本,保存预期与实际结果。
- 分别记录模型加载、首次响应、持续吞吐、内存和温升,注明是否包含预处理/相机或音频链路。
- 增加第二个任务前核对资源与并发支持;性能下降时先查供电、降频和运行时,不用峰值算力推算业务速度。
✓ 输出有对照✓ 时延口径明确✓ 并发支持实测
04 · 配置与恢复交付
交接同一套系统、模型和硬件记录。
- 归档系统镜像信息、驱动/运行时、模型、BOM、运行入口、样本及许可说明。
- 在测试设备验证应用重启、模型缺失、网络不可用及恢复;保留离线能做与不能做的边界。
- 按约定时长连续运行,记录热状态与异常;更新模型或镜像后复测受影响项。
✓ 版本与硬件对应✓ 失败提示可理解✓ 长稳条件有记录
故障定位
| 现象 | 常见原因 | 建议动作 |
|---|---|---|
| 系统识别扩展卡但模型不能加载 | 模型目标、运行时或组件版本不匹配 | 恢复对应硬件的原厂最小模型,逐项对照模型格式和版本,不先更换整套硬件。 |
验收与归档
- 采购配置与原厂支持列表一致
- 设备枚举和最小样例通过
- 目标模型与并发条件有记录
- 恢复路径和交付权限明确
建议随订单保存:板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论,方便后续复现、维护与售后。