K230 · DEVELOPER SUPPORT

10 / AI 模型、版本与实测指标

从模型文件走到可解释的部署结果:版本、预处理、标签和测试集缺一不可。

操作指南 · 待实机核对阅读与电脑练习参考 20–40 分钟;板端联调按配置另评估 资料版本 2026.10.28-r1更新 2026-10-28

本课验证范围:本课为操作与验收方法。尚无对应 KJX 板型的实机记录,不作为已适配或量产承诺。

起步包提供原创说明、可在电脑运行的示例、板端参考代码和记录表。镜像、模型权重及第三方 EDA 工程需从对应来源获取;此包不是可烧录 BSP。

选择你的开发配置

课程、配件入口与下载包保持同一板型;选择不代表兼容性已验证

当前配置:尚未选择板型

通用学习说明;未指定可直接搭建的硬件组合。

当前参考方案独立展示,不代表所选板型的已确认 BOM;板型与配套需求请通过技术支持核对。

开始前准备

  • 先阅读板型与版本课,并确认本课是否需要目标硬件。
  • 下载起步包;保留原始配置,不直接覆盖板上的 main.py。

操作步骤

  1. 记录模型身份

    保存来源、许可、模型版本、输入形状、颜色顺序、归一化、标签顺序和编译器版本。来源不清的权重不进入公共包。

  2. 对齐运行时

    固件内运行时与模型编译工具按官方兼容说明配套。使用固定tag进行复现,不混合旧教程代码和未发布接口。

  3. 先测静态输入

    用一组已知标签样本检查预处理和输出解释,再接实时相机;分别记录模型推理耗时和端到端帧率。

  4. 评估真实场景

    记录漏检、误检、光照与距离变化、内存占用和长时间运行。验收表保留未通过项,不能以一次演示替代交付验收。

预期结果与核对

  • 模型卡和固件版本可以关联到具体测试结果。
  • 性能用本套板、模型与输入尺寸实测,不以芯片算力代替帧率。

遇到问题时

能加载但类别全错
核对RGB/BGR、尺寸、归一化和标签顺序。
运行一段时间后内存不足
检查图像缓冲、对象释放和模型输入缓存;先简化单模型复现。

本课配套文件

当前下载配置:尚未选择板型。下载并解压后,进入 KJX-K230-starter 目录,再按以下相对路径打开文件;先看 CONFIGURATION.md 中的适用范围。

  • FIRMWARE.md本课相关源文件或操作说明;见包内 README 的验证范围。
  • records/model-record.json本课相关源文件或操作说明;见包内 README 的验证范围。
  • courses/ai-model-deployment.md本课完整离线说明,与网页同源。
  • CONFIGURATION.md当前所选板型、起步配置清单与适用边界;不替代实物配置文件。