KJX ENGINEERING GUIDE · 04

K230 AI 实验规划与配套验收指南

围绕 KJX K230 核心模组梳理配置确认、视觉实验、接口输出和参考配单。本文提供实施与验收步骤;可运行镜像、模型和脚本需与具体模组及底板版本一起确认。

参考指南 · 目标组合待验证 实验开发 参考学习时长 6-16 课时 核查 2026-09-08
CanMV-K230 V1.1 开发板实物参考;非可简芯自研整板或定制整机 V1.1 开发板实物参考 · CanMV-K230 视觉开发板应用基线
适用说明:本手册用于 KJX K230 1GB/2GB 核心模组、K230 视觉底板、摄像头、显示屏、存储卡、联网模块与执行器;具体接口、固件和外设批次以订单锁定清单为准。实施时请以目标板卡、固件和外设的实际版本为准;正式交付的功能、资料与验收标准以订单或技术协议为准。
返回配置:CanMV-K230 视觉开发板应用基线 · 同版参考基线。手册是适用范围内的工程参考,不代表所选配置已经完成实测。

准备与目标

适用范围KJX K230 1GB/2GB 核心模组、K230 视觉底板、摄像头、显示屏、存储卡、联网模块与执行器;具体接口、固件和外设批次以订单锁定清单为准
实施方式参考指南 · 目标组合待验证;按目标硬件执行并记录结果

开始前准备

  • KJX K230 1GB 或 2GB 核心模组,确认 PCB 丝印、内存容量、供电方式和底板接口
  • Type-C 数据线、TF/SD 存储介质、串口日志工具和可复现的烧录镜像
  • 至少一颗已确认驱动支持的摄像头;如做交互演示,需准备屏幕、按键、蜂鸣器、舵机或电机
  • 联网实验需准备 Wi-Fi/以太网模块、局域网环境、MQTT/HTTP 测试服务或本地调试服务器
  • 如需项目交付,提前确认目标功能、资料范围、知识产权与验收方式

完成后应得到

  • 了解 K230 板卡可实现的识图、交互、联网和综合控制类项目
  • 形成一套可直接生成参考 BOM 的实验包,包含主控、摄像头、显示、存储、线材和常用执行器
  • 把演示效果、代码包、版本说明、接线说明和验收项组成可复现的资料包
  • 明确核心固件、授权策略、关键模型和量产配置的交付范围,便于后续项目开发

01 · 开箱与版本确认

先把客户拿到的板子、固件和外设版本确认清楚,后续所有实验都基于同一套硬件基线。

4 个步骤
  1. 记录核心模组为 1GB 或 2GB 版本,拍摄板卡正反面,保存丝印、批次、接口方向和底板版本。
  2. 烧录约定镜像,保存镜像文件名、校验值、烧录工具版本和首次启动串口日志。
  3. 完成最小系统验证:上电、串口输出、存储读写、按键/LED/GPIO 基础测试。
  4. 把可选外设列成清单:摄像头、显示屏、Wi-Fi/以太网、舵机、电机、传感器和线材。
✓ 版本可追溯✓ 启动日志可复现✓ 外设清单可配单
停止条件:未确认供电电压、排线方向或镜像版本时,不进入摄像头和执行器实验。

02 · Python 基础与外设实验

给入门客户一条可理解的学习路径:先跑通语法和基础外设,再叠加视觉和联网。

4 个步骤
  1. 准备 Python3 基础练习:变量、条件、循环、函数、模块、文件读写和异常日志。
  2. 跑通 GPIO、按键、LED、蜂鸣器、PWM、ADC、UART、I2C 等基础实验,并记录使用的引脚。
  3. 选择目标固件支持的最小例程,记录代码版本、使用引脚、依赖和所需按键、显示、传感器及线材。
  4. 保存实际运行画面和串口日志,附正确输出与测试条件,方便其他人复现。
✓ 另一名使用者可按步骤复现✓ 引脚和物料对应✓ 结果有图有日志

03 · 摄像头、屏幕与 AI 识图

固定一个识别任务,用输入样本、画面和输出结果验证完整链路。

4 个步骤
  1. 先单独点亮摄像头,确认分辨率、帧率、方向、色彩和暗光表现,再接入屏幕显示。
  2. 准备三类演示:物料/图卡识别、颜色/形状识别、二维码或 AprilTag 识别。
  3. 将 AI 输出整理为结构化结果,例如类别、置信度、坐标、截图、时间戳和处理耗时。
  4. 演示页面明确标注“参考演示/可定制训练”;正式项目按样本、场景和验收指标重新确认。
✓ 画面稳定✓ 识别结果可解释✓ 模型边界写清楚
停止条件:通用识图演示不等于已经适配任意场景;正式识别精度由约定样本和测试集决定。

04 · 情境感知与 Agent 联动

把检测结果整理成可供上位机处理的事件,并验证数据字段和异常响应。

4 个步骤
  1. 先按已选模型定义类别、置信度、坐标、帧号和时间;JSON 是数据格式,传输方式另选串口、HTTP 或 MQTT 中的一种。
  2. 明确一个使用场景与对应规则,保存正常、无目标、低置信度和重复事件的输入输出样本。
  3. 验证消息字段、时间单位、重试与去重、断线恢复;接口说明与实际日志采用同一版本。
  4. 注明采集、检测和语义处理分别运行在板端、上位机还是云端,并确认图片是否离开设备及保存方式。
✓ 事件字段标准化✓ 可接入后端✓ 边缘与云端分工清楚

05 · 手势、目标跟随与执行器

把识别结果变成可控制的动作,适合做视觉小车、云台、机械臂和互动游戏。

4 个步骤
  1. 从手势、人体关键点、色块或二维码中提取控制量,例如方向、速度、角度、目标坐标。
  2. 将控制量映射到舵机、电机、云台或灯光,并设置死区、限位、超时和急停逻辑。
  3. 准备两个演示层级:桌面小实验和整机项目,例如视觉小车/目标跟踪云台。
  4. 把执行器、电机驱动、供电、线材和结构件同步写入参考 BOM,避免客户只买主控缺配件。
✓ 动作不抖动✓ 限位保护明确✓ 配件 BOM 完整
停止条件:执行器实验涉及电源和机械结构,不能默认所有 USB 口都能直接带动电机或舵机。

06 · 联网与设备管理

按实际网络硬件验证连接、状态上报、配置下发和故障定位。

4 个步骤
  1. 跑通 Wi-Fi 或以太网连接,记录 SSID、IP、网关、DNS、重连耗时和失败日志。
  2. 准备 Socket、HTTP、MQTT 三类通信示例,至少完成一类稳定上报。
  3. 为每块板绑定设备 ID、固件版本、配置版本和授权状态,方便售后定位。
  4. 确认升级与恢复方式,列清客户可更新的文件、维护方负责的内容及资料交接范围。
✓ 联网日志完整✓ 设备身份明确✓ 升级范围明确

07 · 综合项目与参考配单

按一个具体用途选定配置,生成参考 BOM 后核对型号、数量、附件与开发范围。

4 个步骤
  1. 按用途拆成项目包:AI 识图终端、视觉小车、目标跟踪云台、实验教学套件、联网巡检节点。
  2. 每个项目包包含主控、摄像头、显示、存储、线材、传感器、执行器和必要结构件,缺少批次确认的物料标记为待核价。
  3. 生成参考配单后先核对套数、型号和缺项;待配置与报价确认,再进入后续采购或开发流程。
  4. 正式交付时提供报价单、采购合同、基础资料包、接线说明、测试记录;完整工程文件和定制模型按项目协议另行交付。
✓ 项目能落到 BOM✓ 套数可调整✓ 交付范围清楚

故障定位

现象常见原因建议动作
拿到板卡后不清楚先做什么只有主控参数,没有分阶段实验路径按开箱、基础外设、视觉、联网、综合项目顺序实施,并在每步核对配套物料。
项目资料与目标硬件对应不上板卡、固件、BOM、接口和测试版本没有统一统一记录目标板版本、适配内容、BOM、测试结果和订单交付范围。
识别效果与实际场景差异大样本、光线、镜头、模型和验收指标没有提前锁定报价前提交代表样本与场景说明,并在正式订单中写入测试范围和通过标准。
执行器动作不稳定或供电异常主控、驱动、电机和电源没有作为整体系统核对把驱动板、独立电源、保险/限流、线材和结构件纳入参考 BOM。

验收与归档

  • 资料页已明确 1GB/2GB K230 模组分别适合的实验和项目
  • 每个实验阶段都有目标、物料、步骤、结果和注意事项
  • 至少能生成一个视觉类项目参考 BOM,并能按套数进入报价流程
  • 公开资料与订单交付资料边界清楚,具体交付范围可追溯
  • 资料页中的演示效果、商品页参数和订单附件口径一致

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