KJX ENGINEERING GUIDE · 05
RK / RV 模型部署与结果核对指南
把准确板型、RKNN 工具链、模型、输入输出与运行记录关联起来。先验证一个任务的正确输出,再测试取流、预处理、推理和后处理的完整性能。
原厂参考 · 需目标板实测
进阶
预计 按模型与 BSP 适配范围确认
核查 2026-09-08
原厂核心板与底板参考 · RK3588 AI 边缘算力终端
适用说明:本手册用于 RK3566、RK3568、RK3588 及 RV1103/RV1106 的具体板型;型号后缀与工具链支持分别核对。实施时请以目标板卡、固件和外设的实际版本为准;正式交付的功能、资料与验收标准以订单或技术协议为准。
准备与目标
适用范围RK3566、RK3568、RK3588 及 RV1103/RV1106 的具体板型;型号后缀与工具链支持分别核对
实施方式原厂参考 · 需目标板实测;按目标硬件执行并记录结果
开始前准备
- 准确 SoC、板卡修订、内存和系统镜像
- 模型来源、许可、版本与输入样本
- RKNN Toolkit/Runtime/Driver 配套信息
- 目标相机及可保存日志的环境
完成后应得到
- 排除平台或版本混用
- 验证转换前后输出
- 获得完整处理链的可复查记录
01 · 板型与工具链
模型转换端和板端使用同一条受支持版本链。
- 记录芯片后缀、板卡修订、RAM、镜像、内核、SDK commit 和相机配置。
- 查 Toolkit2 与 Model Zoo 的目标平台支持表;RV1103/RV1106 按逐模型支持核对,旧 RV1126 不直接沿用此配置。
- 记录转换器、板端 Runtime 与 NPU 驱动版本;Lite2 或 C/C++ 部署方式按平台支持选择。
✓ 目标平台受支持✓ 模型与运行库对应✓ 版本信息可复查
02 · 输入与转换
先固定输入定义,避免模型能运行但输出错误。
- 保存模型来源、版本或哈希、输入 shape/layout、RGB/BGR、归一化和标签顺序。
- 记录量化类型、代表性校准集与转换配置,保留转换日志。
- 用相同输入比较原模型与板端输出,检查坐标缩放、类别、阈值和后处理。
✓ 输入处理一致✓ 转换结果可追溯✓ 正确与失败样本都有记录
03 · 运行与性能
区分 NPU 调用耗时与相机到结果的完整延迟。
- 先用固定图片运行示例,记录命令、依赖、预期输出与实际输出。
- 加入相机后分别记录采集、预处理、推理、后处理与显示或事件输出耗时。
- 测量内存峰值、温升和持续运行情况;同时记录输入尺寸、线程与电源散热条件。
✓ 固定样本输出正确✓ 端到端与推理耗时分开✓ 并发与长稳条件明确
04 · 资料与配置交接
让使用者能够确定该用哪一套文件。
- 归档板型、镜像、工具链、模型、配置、启动步骤、样本、日志及已知问题。
- 列清核心板、载板、相机、排线、电源与散热配件,并标注必选和选配。
- 将原厂参考、本板运行、精度验收与持续运行结果分别记录;变更模型或镜像后重测受影响项。
✓ 资料与 BOM 同一配置✓ 适配状态有记录✓ 失败与恢复方式明确
故障定位
| 现象 | 常见原因 | 建议动作 |
|---|---|---|
| 同一 RKNN 文件在另一平台加载失败 | 目标 SoC、转换目标、Runtime 或驱动版本不一致 | 先对比版本表和平台支持记录,按正确目标重新转换并复测。 |
| 推理耗时很短但画面仍卡顿 | 采集、CPU 前后处理、传输或显示未计入推理基准 | 逐段测量完整处理链,记录内存与并发负载后定位耗时。 |
验收与归档
- 模型与板型版本一致
- 相同输入的输出差异已评估
- 端到端结果与资源记录完整
- 资料、BOM 和已知限制可交接
建议随订单保存:板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论,方便后续复现、维护与售后。