[OpenOCD-commit] Main OpenOCD repository branch, master, updated. v0.12.0-1032-ge23a6bbc6

[openocd-gerrit <ope...@us...>]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Main OpenOCD repository".

The branch, master has been updated
       via  e23a6bbc635aa426668c040abda8c2d38628e8d4 (commit)
       via  7abc0f9e6593694059db56bf6f4ad64972b45ad7 (commit)
      from  6a40fe64d63568d307fdfbb4666784a848222787 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit e23a6bbc635aa426668c040abda8c2d38628e8d4
Author: Jonathan Bell <jon...@ra...>
Date:   Wed May 21 15:37:25 2025 +0100

    tcl: fix broken Raspberry Pi website links
    
    raspberrypi.com is the home for technical information, raspberrypi.org
    is the Foundation's site (though there are intelligent redirects).
    
    Several pages have moved around, fix these.
    
    Also tweak a few comments for style and correctness.
    
    Signed-off-by: Jonathan Bell <jon...@ra...>
    Change-Id: I7f52bcc362fb213b50987e3a42866fe4a6fec883
    Reviewed-on: https://review.openocd.org/c/openocd/+/8885
    Tested-by: jenkins
    Reviewed-by: Antonio Borneo <bor...@gm...>
    Reviewed-by: Tomas Vanek <va...@fb...>

diff --git a/tcl/board/rpi3.cfg b/tcl/board/rpi3.cfg
index fd93a9d9d..a08bfeb12 100644
--- a/tcl/board/rpi3.cfg
+++ b/tcl/board/rpi3.cfg
@@ -1,10 +1,10 @@
 # SPDX-License-Identifier: GPL-2.0-or-later
 
 # This is the Raspberry Pi 3 board with BCM2837 chip
-# https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2837/README.md
+# https://www.raspberrypi.com/documentation/computers/processors.html#bcm2837
 #
 # Enable JTAG GPIO on Raspberry Pi boards
-# https://www.raspberrypi.org/documentation/configuration/config-txt/gpio.md
+# https://www.raspberrypi.com/documentation/computers/legacy_config_txt.html#enable_jtag_gpio
 
 source [find target/bcm2837.cfg]
 transport select jtag
diff --git a/tcl/board/rpi4b.cfg b/tcl/board/rpi4b.cfg
index 5b046af7b..7d937e8c0 100644
--- a/tcl/board/rpi4b.cfg
+++ b/tcl/board/rpi4b.cfg
@@ -1,10 +1,10 @@
 # SPDX-License-Identifier: GPL-2.0-or-later
 
 # This is the Raspberry Pi 4 model B board with BCM2711 chip
-# https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2711/README.md
+# https://www.raspberrypi.com/documentation/computers/processors.html#bcm2711
 #
 # Enable JTAG GPIO on Raspberry Pi boards
-# https://www.raspberrypi.org/documentation/configuration/config-txt/gpio.md
+# https://www.raspberrypi.com/documentation/computers/legacy_config_txt.html#enable_jtag_gpio
 
 source [find target/bcm2711.cfg]
 transport select jtag
diff --git a/tcl/target/bcm2711.cfg b/tcl/target/bcm2711.cfg
index f8d2b3a65..9704daf81 100644
--- a/tcl/target/bcm2711.cfg
+++ b/tcl/target/bcm2711.cfg
@@ -3,8 +3,8 @@
 # The Broadcom BCM2711 used in Raspberry Pi 4
 # No documentation was found on Broadcom website
 
-# Partial information is available in raspberry pi website:
-# https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2711/
+# Partial information is available on the Raspberry Pi website:
+#  https://www.raspberrypi.com/documentation/computers/processors.html#bcm2711
 
 if { [info exists CHIPNAME] } {
 	set  _CHIPNAME $CHIPNAME
diff --git a/tcl/target/bcm2835.cfg b/tcl/target/bcm2835.cfg
index 32a03666c..645588730 100644
--- a/tcl/target/bcm2835.cfg
+++ b/tcl/target/bcm2835.cfg
@@ -3,8 +3,8 @@
 # This is the Broadcom chip used in the Raspberry Pi Model A, B, B+,
 # the Compute Module, and the Raspberry Pi Zero.
 
-# Partial information is available in raspberry pi website:
-# https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2835
+# Partial information is available on the Raspberry Pi website:
+# https://www.raspberrypi.com/documentation/computers/processors.html#bcm2835
 
 if { [info exists CHIPNAME] } {
 	set  _CHIPNAME $CHIPNAME
diff --git a/tcl/target/bcm2836.cfg b/tcl/target/bcm2836.cfg
index 04921315e..695426e7a 100644
--- a/tcl/target/bcm2836.cfg
+++ b/tcl/target/bcm2836.cfg
@@ -1,9 +1,9 @@
 # SPDX-License-Identifier: GPL-2.0-or-later
 
-# The Broadcom chip used in the Raspberry Pi 2 Model B
+# The Broadcom chip used in the Raspberry Pi 2 Model B v1.1
 
-# Partial information is available in raspberry pi website:
-# https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2836
+# Partial information is available on the Raspberry Pi website:
+# https://www.raspberrypi.com/documentation/computers/processors.html#bcm2836
 
 if { [info exists CHIPNAME] } {
 	set  _CHIPNAME $CHIPNAME
diff --git a/tcl/target/bcm2837.cfg b/tcl/target/bcm2837.cfg
index 749de3103..d41892c43 100644
--- a/tcl/target/bcm2837.cfg
+++ b/tcl/target/bcm2837.cfg
@@ -3,9 +3,9 @@
 # This is the Broadcom chip used in the Raspberry Pi 3,
 # and in later models of the Raspberry Pi 2.
 
-# Partial information is available in raspberry pi website:
-# https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2837
-# https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2837b0
+# Partial information is available on the Raspberry Pi website:
+# https://www.raspberrypi.com/documentation/computers/processors.html#bcm2837
+# https://www.raspberrypi.com/documentation/computers/processors.html#bcm2837b0
 
 if { [info exists CHIPNAME] } {
 	set  _CHIPNAME $CHIPNAME
diff --git a/tcl/target/rp2040.cfg b/tcl/target/rp2040.cfg
index f64d4322b..da88a3125 100644
--- a/tcl/target/rp2040.cfg
+++ b/tcl/target/rp2040.cfg
@@ -1,7 +1,7 @@
 # SPDX-License-Identifier: GPL-2.0-or-later
 
 # RP2040 is a microcontroller with dual Cortex-M0+ core.
-# https://www.raspberrypi.com/documentation/microcontrollers/rp2040.html
+# https://www.raspberrypi.com/documentation/microcontrollers/silicon.html#rp2040
 
 # The device requires multidrop SWD for debug.
 transport select swd
diff --git a/tcl/target/rp2350.cfg b/tcl/target/rp2350.cfg
index b7617acd4..96bb9298f 100644
--- a/tcl/target/rp2350.cfg
+++ b/tcl/target/rp2350.cfg
@@ -1,7 +1,7 @@
 # SPDX-License-Identifier: GPL-2.0-or-later
 
 # RP2350 is a microcontroller with dual Cortex-M33 cores or dual Hazard3 RISC-V cores.
-# https://www.raspberrypi.com/documentation/microcontrollers/rp2350.html
+# https://www.raspberrypi.com/documentation/microcontrollers/silicon.html#rp2350
 
 transport select swd
 

commit 7abc0f9e6593694059db56bf6f4ad64972b45ad7
Author: Jonathan Bell <jon...@ra...>
Date:   Wed May 21 15:26:20 2025 +0100

    doc: bcm2835gpio: remove broken link and clarify usage
    
    The peripheral address details have been removed from the documentation
    part of the website (instead presented in the SoC datasheets).
    
    Pi 5 GPIOs are provided by the RP1 southbridge, which requires the use
    of libgpiod. The associated Linux driver for the GPIO interface must be
    used when bitbashing on Pi 5, as the timing of pin state changes is not
    guaranteed across the PCIe link without special treatment.
    
    Using libgpiod, the typical maximum swclk speed is 1MHz.
    
    Signed-off-by: Jonathan Bell <jon...@ra...>
    Change-Id: I8b2c44ec5edd71abaa0a763ba4d4f4603a211348
    Reviewed-on: https://review.openocd.org/c/openocd/+/8884
    Tested-by: jenkins
    Reviewed-by: Antonio Borneo <bor...@gm...>
    Reviewed-by: Tomas Vanek <va...@fb...>

diff --git a/doc/openocd.texi b/doc/openocd.texi
index c7d8c7d0d..bd6b3704a 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -3346,8 +3346,10 @@ The string will be of the format "DDDD:BB:SS.F" such as "0000:65:00.1".
 @end deffn
 
 @deffn {Interface Driver} {bcm2835gpio}
-This SoC is present in Raspberry Pi which is a cheap single-board computer
-exposing some GPIOs on its expansion header.
+This GPIO interface is present in Raspberry Pi 0-4 which is a cheap
+single-board computer exposing some GPIOs on its expansion header.
+
+@emph{Note:} for Raspberry Pi 5, use @b{linuxgpiod} not this driver.
 
 The driver accesses memory-mapped GPIO peripheral registers directly
 for maximum performance, but the only possible race condition is for
@@ -3386,9 +3388,7 @@ and drive strength is reduced to 4 mA (2 mA on RPi 4).
 @deffn {Config Command} {bcm2835gpio peripheral_base} @var{base}
 Set the peripheral base register address to access GPIOs.
 Ignored if @file{/dev/gpiomem} is used. For the RPi1, use
-0x20000000. For RPi2 and RPi3, use 0x3F000000. For RPi4, use 0xFE000000. A full
-list can be found in the
-@uref{https://www.raspberrypi.org/documentation/hardware/raspberrypi/peripheral_addresses.md, official guide}.
+0x20000000. For RPi2 and RPi3, use 0x3F000000. For RPi4, use 0xFE000000.
 @end deffn
 
 @end deffn

-----------------------------------------------------------------------

Summary of changes:
 doc/openocd.texi       | 10 +++++-----
 tcl/board/rpi3.cfg     |  4 ++--
 tcl/board/rpi4b.cfg    |  4 ++--
 tcl/target/bcm2711.cfg |  4 ++--
 tcl/target/bcm2835.cfg |  4 ++--
 tcl/target/bcm2836.cfg |  6 +++---
 tcl/target/bcm2837.cfg |  6 +++---
 tcl/target/rp2040.cfg  |  2 +-
 tcl/target/rp2350.cfg  |  2 +-
 9 files changed, 21 insertions(+), 21 deletions(-)


hooks/post-receive
-- 
Main OpenOCD repository