用途:为刚接入 USB 的 M5Stack ESP32 设备(Cardputer、Cardputer-Adv、Core、CoreS3、Stick 等)完成冷启动全流程:检测端口、识别型号、刷写 UIFlow 2.0 固件、安装 MicroPython 应用包。
主要能力:脚本位于 https://github.com/moremas/build-with-claude 的本地克隆中,需在 onboard/ 目录下运行。onboard.py 为主编排器,依次调用 detect.py(端口发现与芯片识别)、fetch_firmware.py(查询 M5Burner 清单并下载固件)、flash.py(esptool 刷写)、install_apps.py(通过粘贴模式 REPL 上传 .py 到 /flash/)、smoke_test.py(I2C、LCD、扬声器、按键自检)。默认命令:python3 scripts/onboard.py --apps buddy;仅刷新应用:python3 scripts/install_apps.py --port <PORT> --src buddy。
使用方式:在 Claude Code 中须以 run_in_background: true 后台运行并 tee 到日志,再用 Monitor 或 tail 跟踪进度;原生 USB 的 ESP32-S3 板需用户手动按住 G0、短按 RST 进入下载模式,屏幕全黑才算成功。
限制:原生 USB 板无软件进入下载模式路径;UART 桥接波特率 460800,原生 USB 用 115200 --no-stub;NVS 写入须用 set_str;REPL 多行块需粘贴模式;Cardputer-Adv 的 BLE 外设需 boot_option=2 与自定义 main.py。依赖 pyserial(内置 3.5)与 esptool(pip 安装)。