Raspberry Pi Debug Probe kit with probe board, case, USB cable and debug leads

Raspberry Pi Debug Probe USB Debugging Kit | ShillehTek Product Manual

ArduinoESP32Raspberry PiPicomanual-product-10645386395935
$22.50 USD In stock · Order by 3pm ET, ships today

Overview

The Raspberry Pi Debug Probe is a small USB adapter for debugging and programming microcontrollers. It gives your computer two things at once: an SWD debug connection for loading and stepping through code, and a UART serial bridge for reading the target's console output. It was designed for the Raspberry Pi Pico family and also works with other Arm microcontrollers that use SWD.

The probe speaks the standard CMSIS-DAP protocol, so OpenOCD, GDB and the Raspberry Pi Pico extension for VS Code work with it without vendor drivers. The kit includes the probe in its case, a USB cable and three debug cables for boards with a debug socket, header pins or sockets.

At a Glance

Type
USB to SWD and UART debug probe
Protocol
CMSIS-DAP
D Port
SWD: SWCLK, SWDIO, GND
U Port
UART: TX, RX, GND
I/O Level
3.3 V
In the Kit
Probe, USB cable, 3 debug cables

Specifications

Parameter Value
Probe Raspberry Pi Debug Probe, based on the RP2040
Functions USB to SWD debug and USB to UART serial
Debug protocol CMSIS-DAP, supported by OpenOCD and GDB
D connector 3-pin JST-SH: SC (SWCLK), GND, SD (SWDIO)
U connector 3-pin JST-SH: TX, GND, RX
I/O voltage 3.3 V
Target power Not supplied: power the target separately and share ground
Wire colors, D port Orange SWCLK, black GND, yellow SWDIO
Wire colors, U port Orange TX (from the probe), black GND, yellow RX (to the probe)
Board size 22 × 32 mm
Kit contents Probe in case, USB cable, and three cables: JST-SH to JST-SH, JST-SH to male pins, JST-SH to female sockets

Wiring Guide

The probe has two 3-pin ports: D for SWD debug and U for UART serial. Connect either or both to the target, then power the target from its own USB cable or supply. The probe does not power the target, and all signals are 3.3 V.

SWD Debug Port (D) to a Pico

A Pico H has a 3-pin debug socket: plug the JST-SH to JST-SH cable straight in. On a Pico with debug header pins, use the JST-SH to female sockets cable. A plain Pico has three debug pads at the end of the board, which need pins soldered on first.

Probe Wire Pico Debug Pin Signal
Orange SWCLK Clock
Black GND Ground
Yellow SWDIO Data
Power: The probe does not power the target. Plug the Pico into USB or its own supply as well.

UART Serial Port (U) to a Pico

Probe Wire Pico Pin Direction
Orange (TX) GP1 (Pin 2), UART0 RX Probe to Pico
Yellow (RX) GP0 (Pin 1), UART0 TX Pico to probe
Black GND (Pin 3) Ground
Crossed: TX goes to RX and RX goes to TX. If you see no text, check that orange and yellow are not swapped.

Other SWD Targets

The probe is a generic CMSIS-DAP adapter, so it can debug other Arm Cortex-M boards that expose SWD, as long as the target runs at 3.3 V and your tools have a configuration for that chip.

Probe Signal Target Pin
SC (orange, D port) SWCLK
SD (yellow, D port) SWDIO
GND (black) GND
TX and RX (U port) The target's UART RX and TX, optional
3.3 V only: Do not connect the probe to 5 V signals. It is made for targets with 3.3 V logic.

Software Setup

The probe needs no vendor driver. It appears to the computer as a CMSIS-DAP debug adapter plus a USB serial port.

Task Tool
Flash and debug from the command line OpenOCD with interface/cmsis-dap.cfg, plus GDB
Flash and debug from an editor Raspberry Pi Pico extension for VS Code
Serial console Any terminal program at 115200 baud, for example minicom

Code Examples

View or download this product's example code on GitHub.

The first block installs the tools on Raspberry Pi OS, Debian or Ubuntu and flashes an ELF file to a Pico. SWD loads ELF files, not UF2 files. For a Pico 2, use target/rp2350.cfg with an OpenOCD build that supports the RP2350. The second block opens the probe's serial port.

Flash a Program Over SWD (OpenOCD)

flash_swd.sh
# Install the tools (Raspberry Pi OS, Debian, Ubuntu)
sudo apt install openocd gdb-multiarch

# Flash an ELF file to a Pico over SWD, then reset and run it
openocd -f interface/cmsis-dap.cfg -f target/rp2040.cfg -c "adapter speed 5000" -c "program blink.elf verify reset exit"

Open the Serial Console

serial_monitor.sh
# Open the probe's UART at 115200 baud
# The port name can differ - list the candidates with: ls /dev/ttyACM*
sudo apt install minicom
minicom -b 115200 -o -D /dev/ttyACM0

Frequently Asked Questions

Do I need to install a driver?
No. The probe uses the standard CMSIS-DAP protocol and a standard USB serial interface, so current versions of Windows, macOS and Linux recognize it without vendor drivers. You only need debug software such as OpenOCD and GDB, or the Raspberry Pi Pico extension for VS Code.
Does the probe power my board?
No. It connects signals and ground only. Power the target from its own USB cable or supply, and make sure the probe's black GND wire is connected so both share a ground.
Which cable do I use?
Use the JST-SH to JST-SH cable for boards with a 3-pin debug socket, such as the Pico H. Use the JST-SH to female sockets cable for boards with header pins, and the JST-SH to male pins cable for breadboards and female headers. The wire colors are the same on all three: orange, black and yellow.
Why can I not flash a UF2 file with it?
UF2 files are for the drag-and-drop USB bootloader. Over SWD, OpenOCD programs ELF files instead. Your build already produces an ELF file next to the UF2, so point the openocd command at that file.
Can I debug an ESP32 or an Arduino Uno with it?
No. The probe speaks SWD, which Arm Cortex-M chips such as the RP2040 and RP2350 use. ESP32 boards and classic AVR Arduinos use different debug interfaces. The UART side is more general: it works as a USB serial adapter for any board with a 3.3 V serial port.
I get no serial output. What should I check?
Check that probe TX (orange) goes to the target's RX and probe RX (yellow) to the target's TX, with black on ground. Confirm the baud rate, usually 115200, and that your program sends its output to the UART and not to USB. On a Pico, UART0 is on GP0 and GP1 by default.
What does adapter speed 5000 mean?
It sets the SWD clock to 5000 kHz, the speed used in Raspberry Pi's own instructions for this probe with a Pico. If the connection is unreliable, for example with long jumper wires, lower the number and try again.

Related Tutorials

Datasheets & downloads

Reference documents for the Raspberry Pi Debug Probe USB Debugging Kit. This manual covers wiring and code; the documents below carry the full electrical specifications.