本课验证范围：本课为操作与验收方法。尚无对应 KJX 板型的实机记录，不作为已适配或量产承诺。
起步包提供原创说明、可在电脑运行的示例、板端参考代码和记录表。镜像、模型权重及第三方 EDA 工程需从对应来源获取；此包不是可烧录 BSP。
选择你的开发配置
课程、配件入口与下载包保持同一板型；选择不代表兼容性已验证
开始前准备
- 先阅读板型与版本课，并确认本课是否需要目标硬件。
- 下载起步包；保留原始配置，不直接覆盖板上的 main.py。
操作步骤
先定义识别任务
色块定位和二维码读取不必直接上神经网络。约定输入场景、光照、最小目标尺寸以及无目标时的行为。
准备可复现样本
使用自己的色纸或测试码，保留不同距离与光照的测试编号。默认不上传人脸和现场原图。
统一输出字段
将识别器的目标框转为 vision_events.py 使用的像素 xyxy 输入，输出坐标为归一化值。调用方可填写 timestamp_ms，未填则为 None；二维码文本另存数据字段，本例程不读取或传输二维码内容。不要直接执行文本中的URL或指令。
检查失败分支
无目标、模糊、低置信度与越界框分别测试。没有识别不能沿用上一帧的动作命令。
预期结果与核对
- 输出区分‘发现目标’与‘无目标’；有效目标含归一化坐标，时间戳需调用方显式提供。
- 识别准确率由自己的样本测试得出，不沿用别家演示数字。
遇到问题时
- 色块随光照飘动
- 记录曝光和白平衡，使用当前场景重新采样阈值。
- 有图像但二维码不出内容
- 检查像素格式、清晰度和码在画面中的占比，再检查接口版本。
本课配套文件
当前下载配置：尚未选择板型。下载并解压后，进入 KJX-K230-starter 目录，再按以下相对路径打开文件；先看 CONFIGURATION.md 中的适用范围。
vision_events.py本课相关源文件或操作说明；见包内 README 的验证范围。HANDS_ON.md本课相关源文件或操作说明；见包内 README 的验证范围。courses/color-and-qr.md本课完整离线说明，与网页同源。CONFIGURATION.md当前所选板型、起步配置清单与适用边界；不替代实物配置文件。
