KJX ENGINEERING GUIDE · 05

RK / RV 模型部署与结果核对指南

把准确板型、RKNN 工具链、模型、输入输出与运行记录关联起来。先验证一个任务的正确输出,再测试取流、预处理、推理和后处理的完整性能。

原厂参考 · 需目标板实测 进阶 预计 按模型与 BSP 适配范围确认 核查 2026-09-08
Radxa CM5 RK3588S2 核心模块官方实物参考 原厂核心板与底板参考 · RK3588 AI 边缘算力终端
适用说明:本手册用于 RK3566、RK3568、RK3588 及 RV1103/RV1106 的具体板型;型号后缀与工具链支持分别核对。实施时请以目标板卡、固件和外设的实际版本为准;正式交付的功能、资料与验收标准以订单或技术协议为准。

准备与目标

适用范围RK3566、RK3568、RK3588 及 RV1103/RV1106 的具体板型;型号后缀与工具链支持分别核对
实施方式原厂参考 · 需目标板实测;按目标硬件执行并记录结果

开始前准备

  • 准确 SoC、板卡修订、内存和系统镜像
  • 模型来源、许可、版本与输入样本
  • RKNN Toolkit/Runtime/Driver 配套信息
  • 目标相机及可保存日志的环境

完成后应得到

  • 排除平台或版本混用
  • 验证转换前后输出
  • 获得完整处理链的可复查记录

01 · 板型与工具链

模型转换端和板端使用同一条受支持版本链。

3 个步骤
  1. 记录芯片后缀、板卡修订、RAM、镜像、内核、SDK commit 和相机配置。
  2. 查 Toolkit2 与 Model Zoo 的目标平台支持表;RV1103/RV1106 按逐模型支持核对,旧 RV1126 不直接沿用此配置。
  3. 记录转换器、板端 Runtime 与 NPU 驱动版本;Lite2 或 C/C++ 部署方式按平台支持选择。
✓ 目标平台受支持✓ 模型与运行库对应✓ 版本信息可复查

02 · 输入与转换

先固定输入定义,避免模型能运行但输出错误。

3 个步骤
  1. 保存模型来源、版本或哈希、输入 shape/layout、RGB/BGR、归一化和标签顺序。
  2. 记录量化类型、代表性校准集与转换配置,保留转换日志。
  3. 用相同输入比较原模型与板端输出,检查坐标缩放、类别、阈值和后处理。
✓ 输入处理一致✓ 转换结果可追溯✓ 正确与失败样本都有记录

03 · 运行与性能

区分 NPU 调用耗时与相机到结果的完整延迟。

3 个步骤
  1. 先用固定图片运行示例,记录命令、依赖、预期输出与实际输出。
  2. 加入相机后分别记录采集、预处理、推理、后处理与显示或事件输出耗时。
  3. 测量内存峰值、温升和持续运行情况;同时记录输入尺寸、线程与电源散热条件。
✓ 固定样本输出正确✓ 端到端与推理耗时分开✓ 并发与长稳条件明确

04 · 资料与配置交接

让使用者能够确定该用哪一套文件。

3 个步骤
  1. 归档板型、镜像、工具链、模型、配置、启动步骤、样本、日志及已知问题。
  2. 列清核心板、载板、相机、排线、电源与散热配件,并标注必选和选配。
  3. 将原厂参考、本板运行、精度验收与持续运行结果分别记录;变更模型或镜像后重测受影响项。
✓ 资料与 BOM 同一配置✓ 适配状态有记录✓ 失败与恢复方式明确

故障定位

现象常见原因建议动作
同一 RKNN 文件在另一平台加载失败目标 SoC、转换目标、Runtime 或驱动版本不一致先对比版本表和平台支持记录,按正确目标重新转换并复测。
推理耗时很短但画面仍卡顿采集、CPU 前后处理、传输或显示未计入推理基准逐段测量完整处理链,记录内存与并发负载后定位耗时。

验收与归档

  • 模型与板型版本一致
  • 相同输入的输出差异已评估
  • 端到端结果与资源记录完整
  • 资料、BOM 和已知限制可交接

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