KJX ENGINEERING GUIDE · 07

低代码视觉传感器到主控的接口与课程验收

把外购视觉传感器的演示功能、通信协议与 KJX 定制开发分开说明,先让一个识别事件稳定进入主控,再编排课程和执行器。

参考流程 · 具体传感器与课程待验证 教学配套 参考学习时长 按传感器款型与课程数量评估 核查 2026-10-03
DFRobot HUSKYLENS2 SEN0638 / K230 / UART 或 I²C

公开资料核对,不使用未经确认的整机照片。

适用说明:本手册用于 具体 HUSKYLENS 2 等外购视觉传感器与指定 ESP32-S3/Arduino 主控,或单独立项的 KJX K230 开发方案;两类固件不可混用。实施时请以目标板卡、固件和外设的实际版本为准;正式交付的功能、资料与验收标准以订单或技术协议为准。

准备与目标

适用范围具体 HUSKYLENS 2 等外购视觉传感器与指定 ESP32-S3/Arduino 主控,或单独立项的 KJX K230 开发方案;两类固件不可混用
实施方式参考流程 · 具体传感器与课程待验证;按目标硬件执行并记录结果

开始前准备

  • 完整传感器与主控型号、固件版本
  • 原厂协议与接线依据
  • 授权的教学图片/目标和课程任务
  • 限流供电、线缆和独立执行器驱动

完成后应得到

  • 将成品原厂能力与自有开发区分
  • 保留型号和协议的一致性
  • 使一课一物料一结果可复验

01 · 选择成品或开发路线

不是所有 K230 设备都可使用同一固件。

3 个步骤
  1. 若采用外购视觉传感器,记录品牌、完整型号、固件与官方支持功能;保留原厂身份,不改称本站自研机芯。
  2. 若采用 KJX 模组路线,另列底板、相机、镜像、UI和协议的开发任务,不把外购成品功能视为已完成。
  3. 将主控、视觉传感器、线材、电源和执行器配套到项目 BOM,注明本课必选和后续选配。
✓ 两条路线明确✓ 品牌与功能来源可追溯✓ 课程 BOM 对应配置

02 · 先独立识别,再接主控

把视觉问题和通信问题拆开。

3 个步骤
  1. 用原厂界面或示例验证一个功能,记录样本、距离、光照、标签及失败条件。
  2. 根据该型号协议确认 UART/I2C 等实际接口、电平、地址/波特率和数据字段,断电完成接线。
  3. 先在主控打印原始结果和时间戳,不驱动电机;确认无目标、多目标和断连的返回方式。
✓ 单独识别可重复✓ 协议字段有出处✓ 空结果可区分

03 · 控制逻辑与课堂任务

识别事件必须经过限幅和异常处理。

3 个步骤
  1. 定义只包含一个目标的课堂任务,使用稳定次数、置信阈值或超时过滤偶发结果。
  2. 先用 LED/串口展示事件,再通过独立电源和驱动连接执行器,加入限位、超时和人工停止。
  3. 记录不同样本和遮挡条件的输出,检验重复消息、串口丢包及重启后默认状态。
✓ 错误事件不直接驱动✓ 执行器边界明确✓ 故障可复现

04 · 一课一包与复现

课程包不能只有效果图和购物清单。

3 个步骤
  1. 每课保存目标、版本、BOM、接线依据、已验证程序入口、预期输出和排障卡;缺少实测程序的课标为准备中。
  2. 由另一位使用者按资料复现,记录成功/失败、耗时、替代料差异和需要的指导。
  3. 尊重原厂教材、图像和固件许可;本站新编课程单独署名,不将原厂资料改标为自有。
✓ 课程材料成套✓ 结果经他人复现✓ 来源与新增内容清楚

故障定位

现象常见原因建议动作
传感器屏幕识别正常但主控无结果接口模式、电平、地址/波特率或协议版本不一致回到原厂通信示例,只保留一条接口,先记录原始帧再恢复课程逻辑。

验收与归档

  • 成品与自研路线不混淆
  • 识别/通信/执行分层验收
  • 每课物料和实际程序对应
  • 原厂与本站资料权属明确

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