K230 · DEVELOPER SUPPORT

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

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

附 PC 可运行示例阅读与电脑练习参考 20–40 分钟;板端联调按配置另评估 资料版本 2026.10.28-r1更新 2026-10-28

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

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

选择你的开发配置

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

当前配置: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 2GB 核心模组方案。下载并解压后,进入 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当前所选板型、起步配置清单与适用边界;不替代实物配置文件。