BUILDS / DEBUG-PROBE / V2

debug-probe

v2 · draftversions v1 v2

Changed from v1: The lab's probe is a Raspberry Pi Debug Probe, the accessory the debugprobe firmware is written for, in place of a Pico 2 running that firmware. v1 still shows how to make one from a Pico 2.

Flashes and debugs a target over SWD, and bridges the target's UART to USB.

Parts

QTYPARTFORM
1RP2040Raspberry Pi Debug Probe, with its cablesauthorized sellers only

Firmware

NAME
debugprobe · MIT
RELEASE
debugprobe-v2.3.1
FILE
debugprobe.uf2
SHA-256
aae9585f456c28c00865eb3df4d4bfc184f8e7ae60ebed3cc32a32512521a1b8

Walkthrough

At your own risk: not certified or calibrated test equipment. Legal

  1. Download the firmware and check its hash. The probe may already run it; loading the pinned file anyway makes it the firmware this version names.

    curl -LO https://github.com/raspberrypi/debugprobe/releases/download/debugprobe-v2.3.1/debugprobe.uf2
    shasum -a 256 debugprobe.uf2

    EXPECTaae9585f456c28c00865eb3df4d4bfc184f8e7ae60ebed3cc32a32512521a1b8

  2. Pinch the top off the probe's case, then hold BOOTSEL and plug it, with its USB cable, into the computer it is used from (the lab's: a Raspberry Pi).

    EXPECTA drive named RPI-RP2 appears.

  3. Copy debugprobe.uf2 onto the RPI-RP2 drive.

    EXPECTThe drive disappears, and the probe comes back as a USB device named “Debug Probe (CMSIS-DAP)”.

    AGENTSFlashing is a hardware action: only for a board on the lab-target list or with a person's approval, and logged.

  4. With the target powered off, connect the probe's D port to the target's SWD pins with the female header cable: orange to SWCLK, black to GND, yellow to SWDIO. A board without a three-pin JST-SH debug connector, such as a Pico 2 that is not an H, needs a male header soldered to those three pins first (the documentation's getting-started page). Targets with 3.3 V logic only.

  5. Power the target and ask the probe what it sees.

    probe-rs info

    EXPECTprobe-rs finds the probe and reads the target's debug port.

Claims

CLAIMSIMULATIONON THE BENCH
Enumerates over USB as “Debug Probe (CMSIS-DAP)”.unknownunknown
Reads a 3.3 V target's debug port over SWD.unknownunknown