Приложения для Cardputer Buddy
Помогает добавлять и обновлять MicroPython-приложения на мини-устройстве Cardputer-Adv, смотреть его логи и запускать команды.
- Что делает
- Помогает добавлять и обновлять MicroPython-приложения на мини-устройстве Cardputer-Adv, смотреть его логи и запускать команды.
- Когда брать
- Когда устройство уже настроено через m5-onboard и нужно добавить приложение, залить правку или посмотреть логи.
- Когда не брать
- Если устройство ещё не настроено: сначала пройди m5-onboard.
- Пример запроса
- Добавь на мой Cardputer новое приложение и залей его на устройство без перепрошивки.
- Нужно подключить
- терминал, Python, устройство Cardputer-Adv по USB, клон репозитория build-with-claude
Входит в плагин cwc-makers. В Cowork и Claude Code можно поставить плагин целиком.
Как включить
- Скачайте архив и распакуйте его.
- Положите папку
cardputer-buddyв~/.claude/skills/. - Откройте Claude Code и опишите задачу своими словами: Claude подхватит скилл по описанию.
Текст
---
name: cardputer-buddy
description: Дорабатывай набор приложений MicroPython для Cardputer-Adv (Claude Buddy, Snake, Hello) после того, как устройство уже настроено через m5-onboard. Используй, когда пользователь хочет добавить новое приложение, загрузить на устройство один изменённый .py без повторной прошивки, следить за последовательными логами устройства или выполнить одну команду в REPL. Срабатывает на «добавь приложение», «залей на cardputer», «покажи логи устройства», «запусти на устройстве» или на последующую работу после /maker-setup.
---
Набор приложений Cardputer Buddy
Каталог buddy/ в локальном клоне build-with-claude — это полезная нагрузка на MicroPython, которую m5-onboard устанавливает в /flash/. Работай внутри этого клона.
Устройство файлов на девайсе
/flash/
├── main.py меню запуска (заменяет стандартную загрузку UIFlow)
├── buddy_*.py общие библиотеки (BLE, интерфейс, состояние, протокол, символы)
├── burst_frames.py кадры спрайтов
└── apps/
├── claude_buddy.py BLE-клиент → Hardware Buddy в Claude Desktop
├── 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'))"
Перевод: iiuniversitet. Оригинал: https://github.com/anthropics/claude-plugins-official/tree/main/plugins/cwc-makers/skills/cardputer-buddy, лицензия Apache-2.0. Изменения: перевод на русский язык.
Оригинал на английском
---
name: cardputer-buddy
description: Iterate on the Cardputer-Adv MicroPython app bundle (Claude Buddy, Snake, Hello) after the device is already provisioned via m5-onboard. Use when the user wants to add a new app, push a single changed .py without re-flashing, watch device serial logs, or run a one-shot REPL command. Trigger on "add an app", "push to the cardputer", "tail the device", "run on the device", or follow-up work after /maker-setup.
---
# Cardputer Buddy app bundle
The `buddy/` directory in the local `build-with-claude` clone is the MicroPython payload that `m5-onboard` installs onto `/flash/`. Work inside that clone.
## Device layout
```
/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` scans `/flash/apps/` at boot and lists every `.py` as a menu entry. Drop a file into `buddy/device/apps/`, push it, and it appears on next boot.
## Adding an app
Crib from `buddy/device/apps/hello_cardputer.py` — smallest example of keyboard polling, font, and exit conventions. Then push without re-flashing:
```bash
python3 onboard/scripts/install_apps.py --port <PORT> --src buddy
```
`<PORT>` is whatever `detect.py` reported last run (e.g. `/dev/cu.usbmodem1101`, `/dev/ttyACM0`, `COM3`).
## Dev loop tooling (`buddy/scripts/`)
```bash
# 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'))"
```
Источник: anthropics/claude-plugins-official / cwc-makers / cardputer-buddy ↗. Ссылка проверена 2026-10-10.