Skip to the content
2 layers26.6 × 11 mmPico debug swd adapter, the printed circuit board in 3D

Pico debug swd adapter

mikeysklar/pi-debug-swd-adapter

Passive adapter: Raspberry Pi Debug Probe (JST-SH 3-pin) to standard 2x5 1.27mm ARM Cortex SWD header. Single-sided, home-etched.

Size
26.6 × 11 mm
Copper layers
2
Thickness
1.6 mm
Parts
2
Nets
9
Pads
15
Tracks, vias
10, 0
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
26 Jul 2026
Updated
26 Jul 2026

Overview

Pico debug swd adapter is an open-source printed circuit board by mikeysklar, from the mikeysklar/pi-debug-swd-adapter repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 26.6 × 11 mm with 2 parts on 9 nets, routed with 10 tracks and 0 vias.

It is built around the BM03B-SRSS-TB. It belongs with the interfaces and adapters and sensors and measurement boards and the RP2040 boards of this library.

Main components

1

README

README.md

Laser-etched stencil with finished boards and parts

pi-debug-swd-adapter

Connects the $12 Raspberry Pi Debug Probe to a standard 2x5 SWD connector.

How it was made

Voice dictated to Claude, which sourced the parts and wrote out the KiCad schematic and PCB board file. No MCP server, no skill, no reference design.

See CLAUDE.md for what it was used. This file represents the on-going changes I had Claude make after the first pass.

Fabrication: a Bantam CNC to cut the single sided PCB blanks, and an xTool F1 Ultra fiber laser to etch, silkscreen, and expose the pads under a green resin layer was applied. The steel business card stencil was cut on the same laser.

About

The Raspberry Pi Debug Probe ends in a 3-pin JST-SH connector. Many Adafruit Metro and Feather boards expose debug on the standard 2x5 1.27 mm SWD header. This board bridges the two.

No active parts — just three signals and a ground pour on a 26.6 × 11 mm single-sided board.

Design files are in kicad/.


Assembled board

Assembled adapter with both connectors soldered

The finished prototype, backlit. Both connectors reflowed onto the laser-exposed pads, with the copper silkscreen and board name still readable through the green resin.

Working debugger setup

Adapter connecting a Raspberry Pi Debug Probe to an Adafruit Metro M0 Express

The whole chain in use: Debug Probe on the left, its 3-pin JST-SH lead into the adapter at bottom right, and a 2x5 1.27 mm ribbon up to the SWD header on an Adafruit Metro M0 Express.

KiCad 3D render

KiCad 3D render of the assembled board

What the board was supposed to look like before any copper got cut.

KiCad board layout

KiCad PCB editor view of the F.Cu layer

The original layout, and the oldest artifact here. The board name is set in copper so it etches as readable text.

Etched copper — trace check

Backlit etched board showing the copper traces

A freshly etched board held up to a light to check the traces. All copper is on one side — no vias.

CNC-cut blank

Blank copper-clad PCB cut on the Bantam CNC

The raw blank milled on the Bantam CNC, with rounded corners and two M2.5 mounting holes.


Design files

Designed in KiCad 9. The project lives in kicad/:

  • pico-debug-swd-adapter.kicad_pro — project file
  • pico-debug-swd-adapter.kicad_sch — schematic
  • pico-debug-swd-adapter.kicad_pcb — PCB layout
  • pico-debug-swd-adapter.step — 3D model export
  • pi-debug-swd_recovered.xcs — xTool Creative Space laser job
  • 3dmodels/ — project-local STEP models
  • etch/etch-FCu-MIRRORED-1to1.pdf — print at 100% for toner transfer
  • etch/etch-FCu-reference.pdf — same artwork unmirrored, for checking

Bill of materials

RefPartDescription
J1JST BM03B-SRSS-TB3-pin 1.00 mm vertical SMT receptacle
J2CNC Tech 3220-10-0300-002x5 1.27 mm shrouded SWD box header, SMT

Plus two M2.5 screws and a 2x5 1.27 mm ribbon cable.

Pinout

Debug Probe "D" (J1)Cortex Debug 2x5 (J2)
1 — SC4 — SWCLK
2 — GND3, 5 — GND
3 — SD2 — SWDIO

Everything else on J2 is left unconnected. Use the "D" port on the probe, not "U".

Using it

The Debug Probe shows up as CMSIS-DAP, so no special driver is needed. Connecting to the Adafruit Metro M0 Express in the photo above, through this adapter:

console
$ openocd -f interface/cmsis-dap.cfg -f target/at91samdXX.cfg \
    -c "adapter speed 400" -c "init; reset halt; flash probe 0; targets; shutdown"

Open On-Chip Debugger 0.12.0
adapter speed: 400 kHz

Info : Using CMSIS-DAPv2 interface with VID:PID=0x2e8a:0x000c, serial=E6614103E7687D25
Info : CMSIS-DAP: SWD supported
Info : CMSIS-DAP: FW Version = 2.0.0
Info : CMSIS-DAP: Interface Initialised (SWD)
Info : CMSIS-DAP: Interface ready
Info : clock speed 400 kHz
Info : SWD DPIDR 0x0bc11477
Info : [at91samd.cpu] Cortex-M0+ r0p1 processor detected
Info : [at91samd.cpu] target has 4 breakpoints, 2 watchpoints
Info : starting gdb server for at91samd.cpu on 3333
Info : Listening on port 3333 for gdb connections
[at91samd.cpu] halted due to debug-request, current mode: Thread
xPSR: 0x71000000 pc: 0x00000264 msp: 0x20002de0
Info : SAMD MCU: SAMD21G18A (256KB Flash, 32KB RAM)
shutdown command invoked

SWD DPIDR 0x0bc11477 is the handshake landing. After that the probe halts the core and reads the chip back as a SAMD21G18A, which is the part on the Metro M0.

The Debug Probe does not power the target, so bring the target up on its own supply and leave it powered before starting OpenOCD. A target that is off gives Error: Error connecting DP: cannot read IDR.


License

GPLv3

Parts

2
QtyValueFootprintReferences
13220-10-0300-00PinHeader_2x05_P1.27mm_Vertical_SMDJ2
1BM03B-SRSS-TBJST_SH_BM03B-SRSS-TB_1x03-1MP_P1.00mm_VerticalJ1

Similar boards

  • 4 layers53.7 × 21 mmPico WH, the printed circuit board in 3D

    Pico WH

    sabogalc/project-piCo

    Because it should be a crime to release a product with Micro-USB in the 2020s

    93 parts159WTFPL
  • 4 layers27.9 × 63.5 mmPico2-ice, the printed circuit board in 3D

    Pico2-ice

    tinyvision-ai-inc/pico2-ice

    Doc | Hardware | SDK | Schematic | Assembly | Discord

    124 parts60MIT
  • 2 layers46 × 19 mmMCU Link Standalone, the printed circuit board in 3D

    MCU Link Standalone

    ErichStyger/McuLink-Mini

    Version of the NXP MCU-Link Debug CMSIS-DAP Debug Probe.

    69 parts32MIT
  • 2 layers54 × 85.6 mmBoard43, the printed circuit board in 3D

    Board43

    smartbank-inc/Board43

    Board43 is an RP2350A-based microcontroller development board. Flash PicoRuby or your favorite firmware and start hacking.

    583 parts30
  • 2 layers42.8 × 72.5 mmTWV, the printed circuit board in 3D

    TWV

    Uhome-systems/Uhome

    Config files for my GitHub profile.

    79 parts13
  • 4 layers129 × 79.5 mmStimjim, the printed circuit board in 3D

    Stimjim

    open-ephys/stimjim

    A precise intra and extracellular electrical stimulator

    236 parts7
  • 2 layers89 × 83 mmPico2-nx, the printed circuit board in 3D

    Pico2-nx

    tinyvision-ai-inc/pico2-nx

    RP2350+Lattice Crosslink NX FPGA board

    242 parts5MIT
  • 4 layers93.5 × 81 mmUM Controller, the printed circuit board in 3D

    UM Controller

    Aptustech/Micromanipulator_uM_NG

    Next generation Micromanipulator controller

    173 parts2

Questions

How big is the Pico debug swd adapter PCB?

It measures 26.6 × 11 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Pico debug swd adapter use?

2 parts, built around the BM03B-SRSS-TB. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Pico debug swd adapter KiCad files?

From the mikeysklar/pi-debug-swd-adapter repository on GitHub, at the commit this page was made from: the board is kicad/pico-debug-swd-adapter.kicad_pcb and its schematic kicad/pico-debug-swd-adapter.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Pico debug swd adapter design in my own project?

Its repository publishes it under the GPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).