K230 · DEVELOPER SUPPORT

06 / 相机采集与第一幅画面

从已确认的 CSI 配置开始，只连接一个相机并输出 IDE 预览。

开始本课全部课程 下载开发起步包 ZIP
附板端参考代码 · 未上板阅读与电脑练习参考 20–40 分钟；板端联调按配置另评估 资料版本 2026.10.28-r1更新 2026-10-28

本课验证范围：代码需通过语法与模拟接口测试；没有真实 KJX 相机画面证据。默认配置不会启动相机。

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

选择你的开发配置

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

参考配单CanMV-K230 V1.1 参考套件

按开发板、OV5647、存储与供电清单起步；不等同于 KJX 核心模组套装。

 整机定制评估KJX K230 1GB 核心模组方案

核心模组可单独采购；底板、相机和固件按目标接口确认。

 当前选择 · 整机定制评估KJX K230 2GB 核心模组方案

核心模组可单独采购；按模型与外设需求确认整机配置，不默认继承其他板型配件。

当前配置：KJX K230 2GB 核心模组方案

仅所选核心模组有明确商品入口；底板、相机、供电、线材和固件待组合确认，不是完整开发套件。

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

核对所选板型与配套查看当前参考方案清除板型选择

开始前准备

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

操作步骤

  1. 断电安装相机

    按目标底板确认连接器、排线方向、传感器供电、CSI号及复位/I2C配置。相同针数不代表相同定义。

  2. 填写板型配置

    阅读 BOARD_PROFILE.md，复制示例配置为 board_profile.json，按真实证据填写。默认未确认会拒绝运行；不要只为消除报错而改 confirmed。

  3. 运行参考代码

    在匹配 CanMV 固件与IDE预览连接下手动运行 reference_camera.py；先选择虚拟显示，不同时初始化未知屏幕。

    # 在 CanMV IDE 中手动运行，不在电脑上当作硬件测试
# 文件：reference_camera.py
# 配置：board_profile.json

  4. 记录帧与退出

    检查方向、颜色、连续画面及停止后资源释放。重新运行确认不会因资源占用失败，再固定此次配置。

预期结果与核对

  • 默认配置拒绝硬件初始化，避免误接误跑。
  • 目标验收：确认配置后能显示画面并正常停止；当前参考例程尚待对应板型实机验证。

遇到问题时

Sensor初始化失败
保留异常，核对传感器驱动、CSI编号和接线；不要先改分辨率掩盖连线问题。
黑屏但无异常
先核对是否使用虚拟显示、IDE是否打开预览，再检查曝光、像素格式和实际采集。

本课配套文件

当前下载配置：KJX K230 2GB 核心模组方案。下载并解压后，进入 KJX-K230-starter 目录，再按以下相对路径打开文件；先看 CONFIGURATION.md 中的适用范围。

  • reference_camera.py本课相关源文件或操作说明；见包内 README 的验证范围。
  • BOARD_PROFILE.md本课相关源文件或操作说明；见包内 README 的验证范围。
  • board-profile.example.json本课相关源文件或操作说明；见包内 README 的验证范围。
  • courses/camera-preview.md本课完整离线说明，与网页同源。
  • CONFIGURATION.md当前所选板型、起步配置清单与适用边界；不替代实物配置文件。
下载开发起步包 ZIP