К основному содержанию
скилл CX Codex

raspberry-pi-pico2 — скилл для Claude Code: Pico 2 и установка

Скилл для Claude Code помогает настраивать сборку и отладку Raspberry Pi Pico 2 и Pi Debug Probe. Охватывает RP2350, SDK, OpenOCD и GDB.

Apache-2.0 ★ 173 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sammcj/agentic-coding --skill raspberry-pi-pico2 -a claude-code
Открыть на GitHub

Что делает raspberry-pi-pico2

Скилл содержит справочные материалы по платам RP2350, настройке pico-sdk и работе с Pi Debug Probe. Он помогает выбрать параметры CMake для Pico 2, подключить отладчик по SWD или UART и пройти типичные шаги отладки через OpenOCD и GDB. Для разных задач он направляет к отдельным файлам references/pico2-hardware.md, references/debug-probe.md и references/sdk-toolchain.md.

В материалах разобраны сборки ARM и RISC-V, прошивка через SWD и BOOTSEL, а также частые ошибки конфигурации. Например, для Pico 2 нужно явно задать -DPICO_BOARD=pico2: иначе SDK соберёт проект для Pico 1. Для отладки RISC-V нужна чистая папка сборки; Debug Probe сам не питает плату, поэтому Pico 2 подключают к отдельному источнику питания.

Какие задачи решает

  • выбрать CMake-параметры для сборки под Pico 2
  • подключить Pi Debug Probe по SWD или UART
  • настроить OpenOCD и GDB для отладки RP2350
  • разобраться, почему прошивка не подходит выбранному способу загрузки

Примеры запросов агенту

  • Используй скилл raspberry-pi-pico2 и настрой сборку проекта для Raspberry Pi Pico 2.
  • Подскажи, как подключить Pi Debug Probe к Pico 2 по SWD и запустить отладку через OpenOCD и GDB.
  • Настрой сборку для RISC-V на RP2350 и объясни, что нужно изменить при переключении с ARM.

Как установить raspberry-pi-pico2

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill raspberry-pi-pico2 -a claude-code

2Вручную: положить файлы

~/.claude/skills/raspberry-pi/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/raspberry-pi/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о raspberry-pi-pico2

Как установить raspberry-pi-pico2 в Claude Code?

Выполните npx skills add sammcj/agentic-coding --skill raspberry-pi -a claude-code. Файл скилла находится по пути ~/.claude/skills/raspberry-pi/SKILL.md.

Что делает скилл raspberry-pi-pico2?

Он помогает с разработкой для Raspberry Pi Pico 2 и Pi Debug Probe: настройкой SDK и CMake, прошивкой и отладкой с OpenOCD и GDB.

Почему сборка для Pico 2 может не запуститься на плате?

SDK по умолчанию настраивает сборку для Pico 1. Для Pico 2 задайте -DPICO_BOARD=pico2, иначе бинарный файл будет собран для RP2040.

Исходный текст

SKILL.md · Apache-2.0
---
name: raspberry-pi-pico2
description: >
  Use when developing with Raspberry Pi Pico 2 or the Pi Debug Probe.
allowed-tools: Bash Read Write Edit Grep Glob Agent
disable-model-invocation: true
argument-hint: "Thing you want to do"
---

# Raspberry Pi Pico 2 and Debug Probe

This skill covers development with Raspberry Pi Pico 2 (RP2350) boards and the Raspberry Pi Debug Probe. It includes hardware specs, SDK setup, build configuration, debugging workflows, and common pitfalls.

## Reference Files

Consult these for detailed technical content. Read only the file relevant to the current task:

- `references/pico2-hardware.md` - RP2350 specs, RP2040 vs RP2350 comparison, pin layout, wireless variant, security features, chip variants
- `references/debug-probe.md` - Debug Probe hardware, wiring diagrams, OpenOCD setup, GDB workflow, UART serial, RTT, VS Code integration, rescue mode, troubleshooting
- `references/sdk-toolchain.md` - pico-sdk setup, CMake configuration, ARM vs RISC-V builds, picotool commands, MicroPython/CircuitPython, project structure

## Quick Reference

### Board Selection (CMake)

| Board | CMake Flag | Platform |
|-------|-----------|----------|
| Pico 1 | `-DPICO_BOARD=pico` (default) | rp2040 |
| Pico 1 W | `-DPICO_BOARD=pico_w` | rp2040 |
| Pico 2 | `-DPICO_BOARD=pico2` | rp2350-arm-s |
| Pico 2 W | `-DPICO_BOARD=pico2_w` | rp2350-arm-s |
| Pico 2 RISC-V | `-DPICO_BOARD=pico2 -DPICO_PLATFORM=rp2350-riscv` | rp2350-riscv |

### Debug Probe Wiring (SWD)

| Debug Probe "D" Pin | Wire Colour | Pico 2 SWD Pad |
|---------------------|-------------|-----------------|
| SC | Orange | SWCLK |
| GND | Black | GND |
| SD | Yellow | SWDIO |

### Debug Probe Wiring (UART)

| Debug Probe "U" Pin | Wire Colour | Pico 2 Pin | GPIO |
|---------------------|-------------|------------|------|
| TX | Orange | Pin 2 | GP1 (RX) |
| RX | Yellow | Pin 1 | GP0 (TX) |
| GND | Black | Pin 3 | GND |

Note the crossover: probe TX to Pico RX, probe RX to Pico TX.

### OpenOCD Target Configs

| Target | Config File |
|--------|------------|
| Pico 1 (RP2040) | `target/rp2040.cfg` |
| Pico 2 (RP2350) | `target/rp2350.cfg` |
| Pico 2 RISC-V | `target/rp2350.cfg` with `-c "set USE_CORE { rv0 rv1 }"` |
| Rescue (RP2350) | `target/rp2350.cfg` with `-c "set RESCUE 1"` |

### Typical Debug Session

```bash
# Terminal 1: OpenOCD
openocd -f interface/cmsis-dap.cfg -f target/rp2350.cfg -c "adapter speed 5000"

# Terminal 2: GDB
arm-none-eabi-gdb my_app.elf
(gdb) target remote localhost:3333
(gdb) monitor reset init
(gdb) load
(gdb) break main
(gdb) continue
```

### Flash via SWD

```bash
openocd -f interface/cmsis-dap.cfg -f target/rp2350.cfg \
  -c "adapter speed 5000" \
  -c "program my_app.elf verify reset exit"
```

Use the `.elf` file for SWD flashing, not `.uf2`.

## Gotchas

These are the most common mistakes and non-obvious behaviours. Pay close attention.

1. **SDK defaults to Pico 1.** You must explicitly pass `-DPICO_BOARD=pico2` to target RP2350. Forgetting this builds for RP2040 and the binary will not run on a Pico 2.

2. **Use the Raspberry Pi fork of OpenOCD.** Upstream OpenOCD (0.12.0) lacks full RP2350 support. Clone from `https://github.com/raspberrypi/openocd.git` branch `rpi-common`.

3. **Wrong target config = failed connection.** Using `rp2040.cfg` with a Pico 2 silently fails. Always match the target config to the chip.

4. **SWD uses .elf, BOOTSEL uses .uf2.** These are different formats for different flashing methods. Do not try to flash a .uf2 via OpenOCD/SWD.

5. **Debug builds required for meaningful debugging.** Always pass `-DCMAKE_BUILD_TYPE=Debug` to cmake. Release builds optimise away variable state and reorder code, making breakpoints unreliable.

6. **RISC-V mode has no FPU.** The hardware floating-point unit is only available on Cortex-M33. RISC-V mode uses software float, which is significantly slower for float-heavy code.

7. **RISC-V requires a clean build directory.** When switching between ARM and RISC-V, delete the build directory and re-run cmake. In-place switching does not work.

8. **RISC-V debugging requires pre-selection.** The RP2350 boots into Cortex-M33 by default. To debug RISC-V: `picotool reboot -u -c riscv`, then use OpenOCD with `set USE_CORE { rv0 rv1 }`.

9. **Debug Probe does not power the target.** The Pico 2 must be powered via its own USB or VSYS. The SWD connector carries no power.

10. **LED pin differs on wireless models.** Non-wireless Pico 2 uses GP25 for the onboard LED. Pico 2 W uses WL_GPIO0 through the CYW43439 wireless chip. Code must be conditional.

11. **Git submodules are required.** The pico-sdk needs `git submodule update --init` to pull tinyusb, cyw43-driver, lwip, btstack, and mbedtls. Missing submodules cause cryptic build failures.

12. **OTP is irreversible.** Writing OTP bits is permanent. Misconfiguring secure boot (setting `SECURE_BOOT_ENABLE` without a boot key and with PICOBOOT disabled) permanently bricks the device.

13. **Wireless SPI pin sharing.** On Pico 2 W, the VSYS ADC reading and CYW43439 IRQ checking are blocked during SPI transactions to the wireless chip.

14. **Connect GND first.** When the Pico 2 is powered from a separate source, connect GND between the target and Debug Probe before any signal lines. Voltage differences can damage the probe.

15. **macOS: OpenOCD needs hidapi and libusb.** Install via `brew install hidapi libusb`. If OpenOCD cannot find the probe, check no other process (VS Code, another OpenOCD instance) holds the USB device.

16. **Multiple debug probes.** If multiple CMSIS-DAP devices are connected, specify the serial number: `adapter serial <serial_number>` in your OpenOCD config.

© sammcj · Apache-2.0 · sammcj/agentic-coding

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
freertos mohitmishra786 Помогает писать код для FreeRTOS: создавать задачи, передавать данные через очереди, ловить переполнение стека и отлаживать потоки в GDB. CX Codex +1 739установок openocd-jtag mohitmishra786 Скилл openocd-jtag учит агента настраивать OpenOCD, прошивать микроконтроллеры через JTAG или SWD и подключать GDB для низкоуровневой отладки. CX Codex +1 637установок rp2350a-weact alexex1993 Скилл rp2350a-weact помогает писать прошивки под WeAct Studio RP2350A, учитывает различия ревизий V1.0 и V2.0 и защищает от ошибок в распиновке. CX Codex +1 ★ 29звёзд репо wendy wendylabsinc Скилл обучает ассистента сборке и развёртыванию приложений под WendyOS на платах Raspberry Pi или NVIDIA Jetson. Помогает настроить права контейнера и удалённую отладку Swift. CX Codex +1 ★ 64звёзд репо nginx-c-module-debug pproenca Скилл nginx-c-module-debug для Claude Code помогает разбирать падения nginx C-модулей, ошибки памяти и сбои в потоке запросов. Для диагностики используются GDB, core dump и трассировка. CX Codex +1 260установок wendy-contributing wendylabsinc Скилл wendy-contributing помогает собирать образы WendyOS через Yocto, разрабатывать wendy-agent и запускать сквозные тесты для встроенных систем. CX Codex +1 ★ 64звёзд репо

Из того же набора73

Весь набор →
qa-to-issues Скилл qa-to-issues превращает баг-репорты в готовые задачи на GitHub через диалог. Скилл опрашивает вас, изучает репозиторий и сам публикует тикеты без лишних деталей реализации. CX Codex +1 ★ 173звёзд репо systematic-debugging Скилл systematic-debugging для Claude Code пошагово разбирает стойкие баги по изменённой методике Fagan Inspection. Выявляет первопричину после нескольких неудачных попыток исправления. CX Codex +1 ★ 173звёзд репо personal-genomics Скилл personal-genomics разбирает сырые файлы ДНК локально: фармакогеномика, риски болезней, носительство, происхождение и признаки. Генетические данные не покидают машину. CX Codex +1 ★ 173звёзд репо markedit-tools Скилл markedit-tools помогает обновлять macOS-редактор MarkEdit, подключать расширения и менять настройки программы через Claude Code. CX Codex +1 ★ 173звёзд репо prompt-enhancer Скилл prompt-enhancer для Claude Code превращает неточные промпты в запросы, составленные по образцу экспертной коммуникации. Улучшает собственные запросы и переписывает их для другой ИИ-системы. CX Codex +1 ★ 173звёзд репо piper-tts-training Скилл piper-tts-training для Claude Code готовит датасеты, запускает дообучение и экспортирует голоса Piper в ONNX. Голоса предназначены для синтеза речи на микрокомпьютерах вроде Raspberry Pi. CX Codex +1 ★ 173звёзд репо html-design-examples Скилл html-design-examples для Claude Code создаёт одностраничные HTML-материалы по образцам из галереи. Он создаёт планы, отчёты, прототипы и другие материалы для чтения в браузере. CX Codex +1 ★ 173звёзд репо step-back Субагент step-back для проверки, не перегружён ли текущий подход избыточными абстракциями. Анализирует код или дизайн и выносит вердикт: продолжать, упрощать или переделать с нуля. CX Codex ★ 173звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой