用途:这一工具面向已经用 m5-onboard 配置好的 Cardputer-Adv 设备,用于迭代其 MicroPython 应用包,包含 Claude Buddy、Snake、Hello 等应用。工作位置是本地 build-with-claude 克隆中的 buddy/ 目录,该目录是 m5-onboard 安装到 /flash/ 的 MicroPython 载荷。
设备布局:/flash/ 下有 main.py(启动菜单,替代 UIFlow 的启动流程)、buddy_*.py(BLE、UI、状态、协议、字符等共享库)、burst_frames.py(精灵帧)以及 apps/ 目录。apps/ 下包括 claude_buddy.py(BLE 客户端,连接 Claude Desktop 的 Hardware Buddy)、hello_cardputer.py 和 snake.py。main.py 在启动时扫描 /flash/apps/,把每个 .py 列为菜单项,因此把文件放入 buddy/device/apps/ 并推送后,下次启动即可出现。
新增应用:可参考 buddy/device/apps/hello_cardputer.py,它是最小的键盘轮询、字体和退出约定示例。推送而不重新刷写:python3 onboard/scripts/install_apps.py --port <PORT> --src buddy。其中 <PORT> 为 detect.py 上次报告的端口,例如 /dev/cu.usbmodem1101、/dev/ttyACM0 或 COM3。
开发循环工具位于 buddy/scripts/:推送部分文件 —— python3 buddy/scripts/push.py --port <PORT> --files apps/snake.py;查看设备日志 —— python3 buddy/scripts/tail_serial.py --port <PORT>;一次性 REPL 执行 —— python3 buddy/scripts/repl_run.py --port <PORT> --script "import os; print(os.listdir('/flash'))"。
限制:资料未提供支持的系统要求、依赖版本、收费或价格、以及对非 Cardputer-Adv 设备的兼容性说明。