From 61d355a8ffd232c65621e27ad678ee70672610d8 Mon Sep 17 00:00:00 2001 From: Andrew Scheller Date: Wed, 3 Sep 2025 17:31:28 +0100 Subject: [PATCH 1/4] Add note about checking Debug Probe firmware version --- .../debug-probe/updating-firmware.adoc | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc b/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc index f0c3af0b9..b01b7a314 100644 --- a/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc +++ b/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc @@ -2,7 +2,17 @@ Firmware for the Debug Probe is available as a UF2 file distributed by Raspberry Pi. -The latest version of the Debug Probe firmware is version 2.2. If you're running an older version, or if you have accidentally overwritten the firmware on your Debug Probe, you can find the latest release of the firmware in https://github.com/raspberrypi/debugprobe/releases/latest[the debugprobe GitHub repository]. +The latest version of the Debug Probe firmware is version 2.2.3. If you're running an older version, or if you have accidentally overwritten the firmware on your Debug Probe, you can find the latest release of the firmware in https://github.com/raspberrypi/debugprobe/releases/latest[the debugprobe GitHub repository]. + +[NOTE] +-- +The `Info : CMSIS-DAP: FW Version = 2.0.0` line reported by `openocd` only refers to the CMSIS-DAP protocol level (which is different to the Debug Probe firmware version). To check the firmware version of your Debug Probe, run: + +[source, console] +---- +$ lsusb -v -d 2e8a: | grep bcdDevice +---- +-- Download `debugprobe.uf2` from the latest release. From 0219e9beafbf49a64c9e198ce423dca02516e154 Mon Sep 17 00:00:00 2001 From: Andrew Scheller Date: Thu, 4 Sep 2025 09:48:23 +0100 Subject: [PATCH 2/4] Clarify Debug Probe bcdDevice version --- .../asciidoc/microcontrollers/debug-probe/updating-firmware.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc b/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc index b01b7a314..09fec1542 100644 --- a/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc +++ b/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc @@ -12,6 +12,7 @@ The `Info : CMSIS-DAP: FW Version = 2.0.0` line reported by `openocd` only refer ---- $ lsusb -v -d 2e8a: | grep bcdDevice ---- +which will report `bcdDevice 2.23` for Debug Probe firmware version 2.2.3. -- Download `debugprobe.uf2` from the latest release. From 3c32015fca86297e7eb06274a2f10794ee0ce17a Mon Sep 17 00:00:00 2001 From: Andrew Scheller Date: Tue, 9 Sep 2025 17:08:56 +0100 Subject: [PATCH 3/4] Update documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc Co-authored-by: Jeunese --- .../microcontrollers/debug-probe/updating-firmware.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc b/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc index 09fec1542..72e004d68 100644 --- a/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc +++ b/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc @@ -12,7 +12,7 @@ The `Info : CMSIS-DAP: FW Version = 2.0.0` line reported by `openocd` only refer ---- $ lsusb -v -d 2e8a: | grep bcdDevice ---- -which will report `bcdDevice 2.23` for Debug Probe firmware version 2.2.3. +This will report `bcdDevice 2.23` for Debug Probe firmware version 2.2.3. -- Download `debugprobe.uf2` from the latest release. From f9f2acc852dc233a94524cc13225823534402378 Mon Sep 17 00:00:00 2001 From: Andrew Scheller Date: Tue, 9 Sep 2025 17:18:47 +0100 Subject: [PATCH 4/4] More significant rejig of updating DebugProbe firmware --- .../debug-probe/updating-firmware.adoc | 22 ++++++++----------- 1 file changed, 9 insertions(+), 13 deletions(-) diff --git a/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc b/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc index 72e004d68..4fb879a5c 100644 --- a/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc +++ b/documentation/asciidoc/microcontrollers/debug-probe/updating-firmware.adoc @@ -4,23 +4,19 @@ Firmware for the Debug Probe is available as a UF2 file distributed by Raspberry The latest version of the Debug Probe firmware is version 2.2.3. If you're running an older version, or if you have accidentally overwritten the firmware on your Debug Probe, you can find the latest release of the firmware in https://github.com/raspberrypi/debugprobe/releases/latest[the debugprobe GitHub repository]. -[NOTE] --- -The `Info : CMSIS-DAP: FW Version = 2.0.0` line reported by `openocd` only refers to the CMSIS-DAP protocol level (which is different to the Debug Probe firmware version). To check the firmware version of your Debug Probe, run: - +To check the firmware version of your Debug Probe, run: [source, console] ---- -$ lsusb -v -d 2e8a: | grep bcdDevice +$ lsusb -v -d 2e8a:000c | grep bcdDevice ---- This will report `bcdDevice 2.23` for Debug Probe firmware version 2.2.3. --- - -Download `debugprobe.uf2` from the latest release. - -Pinch to remove the top of the Debug Probe enclosure. -Push and hold the BOOTSEL button as you plug the Debug Probe into your computer to mount a volume called "RPI-RP2". +NOTE: The `Info : CMSIS-DAP: FW Version = 2.0.0` line reported by `openocd` only refers to the CMSIS-DAP protocol level (which is different to the Debug Probe firmware version). -Copy `debugprobe.uf2` onto the "RPI-RP2" volume. The volume will dismount automatically after the file finishes copying onto the device. +To update the firmware version of your Debug Probe: -Your Debug Probe will reboot and now runs an updated version of the Debug Probe firmware. It is now ready for debugging. +1. Download `debugprobe.uf2` from the latest release. +1. Pinch to remove the top of the Debug Probe enclosure. +1. Push and hold the BOOTSEL button as you plug the Debug Probe into your computer, to mount a volume called "RPI-RP2". +1. Copy `debugprobe.uf2` onto the "RPI-RP2" volume. The volume will dismount automatically after the file finishes copying onto the device. +1. Your Debug Probe will reboot and now runs an updated version of the Debug Probe firmware. It is now ready for debugging.