SuperAPI AI 工具集

cardputer-buddy

编程与开发

查看项目

更新于 11-10 16:22

技能介绍

用途 Cardputer Buddy 是 Cardputer-Adv 的 MicroPython 应用包,用于在设备已由 m5-onboard 完成初始化之后,继续迭代设备上的应用。它适合在本地 build-with-claude 克隆仓库的 buddy/ 目录内工作,该目录是 m5-onboard 安装到 /flash/ 的 MicroPython 负载。

主要能力 应用包含一个启动器菜单与三个应用:claude_buddy.py(BLE 客户端,连接 Antigravity Desktop 的 Hardware Buddy)、hello_cardputer.py 和 snake.py。main.py 在启动时扫描 /flash/apps/ 目录,把其中每个 .py 文件列为菜单项;向 buddy/device/apps/ 放入文件并推送后,下次启动即会出现。

设备目录布局 /flash/ 下包含 main.py(启动器菜单,替代 UIFlow 的启动流程)、buddy_*.py 共享库(BLE、UI、状态、协议、字符)、burst_frames.py 精灵帧,以及 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/) 通过 USB 串口推送部分文件: 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 上的应用进行开发、调试与增量部署。资料未提供收费、价格、平台支持范围或具体效果等信息;使用前需已通过 m5-onboard 完成设备初始化,并在本地克隆仓库中操作。