K230 · DEVELOPER SUPPORT

03 / 开发工具与第一次运行

连接 REPL、读取环境，再建立自己的工程目录。

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

本课验证范围：PC 示例具备配套单元测试；板端连接与工具适配仍需实际硬件确认。

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

选择你的开发配置

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

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

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

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

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

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

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

当前配置：尚未选择板型

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

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

咨询板型与配套查看当前参考方案

开始前准备

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

操作步骤

  1. 准备电脑开发环境

    电脑安装 Python 3 可运行本包纯计算示例；板端使用与固件匹配的 CanMV VSCode 扩展。首次只接调试连接，不连接电机。

  2. 先在电脑验证文件

    解压进入起步包目录，运行环境探针。它只读取系统信息，不连接网络、不烧录；部分系统的 uname 可能包含主机名，分享报告前先检查。

    python -B runtime_probe.py
python -B -m unittest discover -s tests -p test_examples.py -v

  3. 再连接目标板

    按实际固件说明打开 REPL，手动运行 runtime_probe.py。记录结果和串口/扩展版本；只打印成功不等于相机或 IO 已工作。

  4. 保存工程副本

    在电脑保存源文件，在板上单独目录调试。先可重复运行，再考虑开机入口；保留停止脚本和恢复入口的方法。

预期结果与核对

  • 电脑测试可执行，能区分 CPython 与板端解释器输出。
  • 取得目标板运行日志后再标记板端连接通过。

遇到问题时

找不到 Python
安装 Python 3 后重新打开终端；Windows 可用 py -3 替代 python。
找不到设备或预览
分别检查数据线、USB模式、串口权限和扩展/固件版本，不反复更换镜像碰运气。

本课配套文件

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

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