cardputer-buddy について
cardputer-buddyは、Cardputer向けのMicroPythonアプリ一式と開発スキルです。起動メニューや複数のサンプルアプリに加え、USBシリアル経由のファイル転送、ログ確認、REPLスクリプト実行ツールを備えています。
主な機能
- 01アプリを走査して起動メニューに表示
- 02Claude Buddy、Hello、Snakeアプリを収録
- 03USBシリアル経由で指定ファイルを転送
- 04デバイスログの監視とREPL実行
活用シーン
- 01Cardputerにアプリを追加して実行
- 02再フラッシュせずにアプリを更新
- 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 対応