From 98bc6434e92d6f7141e55de93d7b26914980faa3 Mon Sep 17 00:00:00 2001 From: Manu3l0us Date: Tue, 28 Oct 2025 10:36:34 +0100 Subject: [PATCH 1/4] Add warning for signal line connections Added a warning about connecting signal lines when using separate power sources. --- .../asciidoc/microcontrollers/debug-probe/introduction.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc b/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc index 3703a213c..6c3a6a9f7 100644 --- a/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc +++ b/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc @@ -34,6 +34,8 @@ Yellow:: RX/SD (Input to Probe or I/O) While the cable with three-pin JST-SH connectors is intended to be used with the https://rpltd.co/debug-spec[standard three-pin connector] which newer Raspberry Pi boards use for the SWD debug port and UART connectors. +WARNING: When the target is supplied from a separate power source or computer, ensure a common reference before connecting signal lines. Either remove power from the target or connect GND between the target and the Raspberry Pi Debug Probe first; only after GND is connected may you attach RX, TX, SC, and SD. Potential differences between the two systems can cause destructive currents and damage the probe. + The Debug Probe has five LEDs, a red LED to indicate power, and four more activity indicator LEDs image::images/debug-leds.png[width="70%"] From 1f89bdf958a0f5a4e4f85186693a27c91a0dd9ba Mon Sep 17 00:00:00 2001 From: Manu3l0us Date: Tue, 28 Oct 2025 15:01:07 +0100 Subject: [PATCH 2/4] Update documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc --- .../asciidoc/microcontrollers/debug-probe/introduction.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc b/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc index 6c3a6a9f7..e725120b1 100644 --- a/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc +++ b/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc @@ -34,7 +34,7 @@ Yellow:: RX/SD (Input to Probe or I/O) While the cable with three-pin JST-SH connectors is intended to be used with the https://rpltd.co/debug-spec[standard three-pin connector] which newer Raspberry Pi boards use for the SWD debug port and UART connectors. -WARNING: When the target is supplied from a separate power source or computer, ensure a common reference before connecting signal lines. Either remove power from the target or connect GND between the target and the Raspberry Pi Debug Probe first; only after GND is connected may you attach RX, TX, SC, and SD. Potential differences between the two systems can cause destructive currents and damage the probe. +WARNING: When the target is powered from a separate power source or computer, ensure a common reference before connecting signal lines. Either remove power from the target or connect GND between the target and the Raspberry Pi Debug Probe first; only after GND is connected may you attach RX, TX, SC, and SD. Potential voltage differences between the two systems can cause damage to the probe. The Debug Probe has five LEDs, a red LED to indicate power, and four more activity indicator LEDs From 74266242726973527f763b2826d33a4e9961e583 Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 6 Nov 2025 09:35:59 +0000 Subject: [PATCH 3/4] Update documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc --- .../asciidoc/microcontrollers/debug-probe/introduction.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc b/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc index e725120b1..12b6356bd 100644 --- a/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc +++ b/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc @@ -34,7 +34,7 @@ Yellow:: RX/SD (Input to Probe or I/O) While the cable with three-pin JST-SH connectors is intended to be used with the https://rpltd.co/debug-spec[standard three-pin connector] which newer Raspberry Pi boards use for the SWD debug port and UART connectors. -WARNING: When the target is powered from a separate power source or computer, ensure a common reference before connecting signal lines. Either remove power from the target or connect GND between the target and the Raspberry Pi Debug Probe first; only after GND is connected may you attach RX, TX, SC, and SD. Potential voltage differences between the two systems can cause damage to the probe. +WARNING: When the target is powered from a separate power source or computer, ensure a common reference before connecting signal lines. Either remove power from the target or connect GND between the target and the Raspberry Pi Debug Probe first; you can attach RX, TX, SC, and SD after GND is connected. Potential voltage differences between the two systems can cause damage to the probe. The Debug Probe has five LEDs, a red LED to indicate power, and four more activity indicator LEDs From 9448b0207abb5a9492dc23d7b05d6879c59d993b Mon Sep 17 00:00:00 2001 From: Jeunese Date: Thu, 6 Nov 2025 09:36:51 +0000 Subject: [PATCH 4/4] Update documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc --- .../asciidoc/microcontrollers/debug-probe/introduction.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc b/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc index 12b6356bd..eb32d9516 100644 --- a/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc +++ b/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc @@ -32,7 +32,7 @@ Orange:: TX/SC (Output from Probe) Black:: GND Yellow:: RX/SD (Input to Probe or I/O) -While the cable with three-pin JST-SH connectors is intended to be used with the https://rpltd.co/debug-spec[standard three-pin connector] which newer Raspberry Pi boards use for the SWD debug port and UART connectors. +The cable with three-pin JST-SH connectors is intended to be used with the https://rpltd.co/debug-spec[standard three-pin connector] that newer Raspberry Pi boards use for the SWD debug port and UART connectors. WARNING: When the target is powered from a separate power source or computer, ensure a common reference before connecting signal lines. Either remove power from the target or connect GND between the target and the Raspberry Pi Debug Probe first; you can attach RX, TX, SC, and SD after GND is connected. Potential voltage differences between the two systems can cause damage to the probe.