KJX ENGINEERING GUIDE · 07

Pi 5 AI HAT+ 2 运行时与模型验收

将 Pi 5、AI HAT+ 2、PCIe 配套、供电散热和模型运行时锁定为一套配置,不混用上一代 HAT 的安装与性能结论。

参考流程 · 目标模型与整机待验证 进阶 参考学习时长 按系统镜像与模型范围评估 核查 2026-10-03
Pi 5 + AI HAT+ 2 本地模型开发原作者实物参考 原作者实物参考 · 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 · 明确型号和采购范围

扩展卡有算力不表示任意模型即插即用。

3 个步骤
  1. 逐项核对 Pi 5 内存、AI HAT+ 2 型号、线缆/固定件、存储、电源和散热,区分内含与另购。
  2. 查原厂 AI 软件文档,记录系统、内核、驱动、运行时和目标模型的支持组合。
  3. 把模型许可、转换工具和网络下载需求单列;未受支持模型列为适配任务,不直接承诺本地运行。
✓ BOM 无漏件或重复件✓ 支持组合有依据✓ 模型适配范围明确

02 · 断电装配与设备枚举

先让系统正确识别扩展卡。

3 个步骤
  1. 按原厂说明关机断电安装 PCIe 排线与支撑件,检查线缆方向、散热和固定;不带电插拔。
  2. 保留原系统备份,按锁定版本安装依赖并记录设备枚举及驱动日志。
  3. 在不运行模型时检查供电告警、温度与系统稳定性,再执行对应硬件的原厂最小样例。
✓ 安装方向可核对✓ 设备与驱动可见✓ 最小样例通过

03 · 模型正确性与负载

先单任务,再测实际多模态组合。

3 个步骤
  1. 固定模型哈希、输入/输出格式、运行参数和样本,保存预期与实际结果。
  2. 分别记录模型加载、首次响应、持续吞吐、内存和温升,注明是否包含预处理/相机或音频链路。
  3. 增加第二个任务前核对资源与并发支持;性能下降时先查供电、降频和运行时,不用峰值算力推算业务速度。
✓ 输出有对照✓ 时延口径明确✓ 并发支持实测

04 · 配置与恢复交付

交接同一套系统、模型和硬件记录。

3 个步骤
  1. 归档系统镜像信息、驱动/运行时、模型、BOM、运行入口、样本及许可说明。
  2. 在测试设备验证应用重启、模型缺失、网络不可用及恢复;保留离线能做与不能做的边界。
  3. 按约定时长连续运行,记录热状态与异常;更新模型或镜像后复测受影响项。
✓ 版本与硬件对应✓ 失败提示可理解✓ 长稳条件有记录

故障定位

现象常见原因建议动作
系统识别扩展卡但模型不能加载模型目标、运行时或组件版本不匹配恢复对应硬件的原厂最小模型,逐项对照模型格式和版本,不先更换整套硬件。

验收与归档

  • 采购配置与原厂支持列表一致
  • 设备枚举和最小样例通过
  • 目标模型与并发条件有记录
  • 恢复路径和交付权限明确

建议随订单保存:板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论,方便后续复现、维护与售后。