mcpField
C
cardputer-buddy

cardputer-buddy

github.com/anthropics开发45.1k3.0k 次安装1 天前更新
代码仓库

关于 cardputer-buddy

cardputer-buddy 是面向 Cardputer 的 MicroPython 应用包与开发技能，包含启动菜单和多个示例应用。它还提供通过 USB 串口推送文件、查看日志和执行 REPL 脚本的工具。

主要功能

  1. 01启动时扫描并列出应用菜单
  2. 02提供 Claude Buddy、Hello 和 Snake 应用
  3. 03通过 USB 串口推送指定文件
  4. 04查看设备日志并执行 REPL 脚本

适用场景

  1. 01为 Cardputer 添加并运行应用
  2. 02无需重新刷机即可推送应用更新
  3. 03调试设备程序并查看串口输出

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/anthropics/claude-plugins-official --skill cardputer-buddy

安装后在 Claude Code 中输入/cardputer-buddy确认已加载。

详细介绍

Cardputer Buddy 应用包

本地 build-with-claude 克隆中的 buddy/ 目录是 m5-onboard 安装到 /flash/ 的 MicroPython 载荷。请在该克隆内操作。

设备布局

/flash/
├── main.py              launcher menu (replaces UIFlow's boot flow)
├── buddy_*.py           shared libs (BLE, UI, state, protocol, chars)
├── burst_frames.py      sprite frames
└── apps/
    ├── claude_buddy.py  BLE client → Claude Desktop's 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/）

# Push a subset of files over USB-serial
python3 buddy/scripts/push.py --port <PORT> --files apps/snake.py

# Watch device logs
python3 buddy/scripts/tail_serial.py --port <PORT>

# One-shot REPL exec
python3 buddy/scripts/repl_run.py --port <PORT> --script "import os; print(os.listdir('/flash'))"

评论

支持 Markdown