Merge pull request #4242 from raspberrypi/develop

JeuneseRPi · web-flow · commit 022ce65abe4c · 2025-11-06T11:48:56.000Z
Two pieces of work
diff --git a/documentation/asciidoc/computers/config_txt/boot.adoc b/documentation/asciidoc/computers/config_txt/boot.adoc
@@ -165,6 +165,8 @@ Default: `0x0`
 [[enable_rp1_uart]]
 ==== `enable_rp1_uart`
 
+Raspberry Pi 5 only.
+
 When set to `1`, firmware initialises RP1 UART0 to 115200bps and doesn't reset RP1 before starting the OS (separately configurable using `pciex4_reset=1`).
 This makes it easier to get UART output on the 40-pin header in early boot-code, for instance during bare-metal debug.
 
diff --git a/documentation/asciidoc/computers/processors/bcm2836.adoc b/documentation/asciidoc/computers/processors/bcm2836.adoc
@@ -1,8 +1,10 @@
 == BCM2836
 
-The Broadcom chip used in the Raspberry Pi 2 Model B. The underlying architecture in BCM2836 is identical to BCM2835. The only significant difference is the removal of the ARM1176JZF-S processor and replacement with a quad-core Cortex-A7 cluster.
+The Broadcom chip used in early models of Raspberry Pi 2 Model B. The underlying architecture in BCM2836 is identical to BCM2835. The only significant difference is the replacement of the ARM1176JZF-S processor with a quad-core Cortex-A7 cluster.
 
 You should refer to:
 
 * https://datasheets.raspberrypi.com/bcm2836/bcm2836-peripherals.pdf[BCM2836 ARM-local peripherals]
 * https://developer.arm.com/documentation/ddi0464/f/[Cortex-A7 MPcore Processor Reference Manual]
+
+IMPORTANT: This SoC is discontinued. Later Raspberry Pi 2 Model B revisions use a different SoC. For more information, see https://pip.raspberrypi.com/documents/RP-004577-PC-1?disposition=inline[Raspberry Pi 2 Model B Product Change Note].
diff --git a/documentation/asciidoc/computers/processors/bcm2837.adoc b/documentation/asciidoc/computers/processors/bcm2837.adoc
@@ -1,10 +1,12 @@
 == BCM2837
 
-This is the Broadcom chip used in the Raspberry Pi 3 Model B, later models of the Raspberry Pi 2 Model B, and the Raspberry Pi Compute Module 3. The underlying architecture of the BCM2837 is identical to the BCM2836. The only significant difference is the replacement of the Armv7 quad core cluster with a quad-core Arm Cortex A53 (Armv8) cluster.
+This is the Broadcom chip used in early models of Raspberry Pi 3 Model B, some models of Raspberry Pi 2 Model B, and Raspberry Pi Compute Module 3. The underlying architecture of the BCM2837 is identical to the BCM2836. The only significant difference is the replacement of the Armv7 quad core cluster with a quad-core Arm Cortex A53 (Armv8) cluster.
 
-The Arm cores run at 1.2GHz, making the device about 50% faster than the Raspberry Pi 2. The VideoCore IV runs at 400MHz.
+The Arm cores run at 1.2 GHz, making the device about 50% faster than the Raspberry Pi 2. The VideoCore IV runs at 400 MHz.
 
 Please refer to the following BCM2836 document for details on the Arm peripherals specification, which also applies to the BCM2837.
 
 * https://datasheets.raspberrypi.com/bcm2836/bcm2836-peripherals.pdf[BCM2836 Arm-local peripherals]
 * https://developer.arm.com/documentation/ddi0500/latest/[Cortex-A53 MPCore Processor Technical Reference Manual]
+
+IMPORTANT: This SoC is discontinued. Raspberry Pi devices that include this chip are either End-of-Life or use a different SoC. For more information, see https://pip.raspberrypi.com/documents/RP-001029-PC-1?disposition=inline[Raspberry Pi 3 Model B Product Change Notification], https://pip.raspberrypi.com/documents/RP-009284-PC-2?disposition=inline[Raspberry Pi 2 Model B revisions 1.1 and 1.2 Obsolescence Notice 1], and https://pip.raspberrypi.com/documents/RP-009286-PC?disposition=inline[Raspberry Pi Compute Module 3 and Compute Module 3 Lite Obsolescence Notice 2].
diff --git a/documentation/asciidoc/computers/processors/bcm2837b0.adoc b/documentation/asciidoc/computers/processors/bcm2837b0.adoc
@@ -1,8 +1,8 @@
 == BCM2837B0
 
-This is the Broadcom chip used in the Raspberry Pi 3 Models A+, B+, and the Raspberry Pi Compute Module 3+. The underlying architecture of the BCM2837B0 is identical to the BCM2837 chip used in other versions of the Raspberry Pi. The Arm core hardware is the same, only the frequency is rated higher.
+This is the Broadcom chip used in later models of Raspberry Pi 2 Model B, later models of Raspberry Pi 3 Model B, Raspberry Pi 3 Models A+, B+, and Raspberry Pi Compute Module 3+. The underlying architecture of the BCM2837B0 is identical to the BCM2837 chip used in other versions of the Raspberry Pi. The Arm core hardware is the same; only the frequency is rated higher.
 
-The Arm cores are capable of running at up to 1.4GHz, making the 3B+/3A+ about 17% faster than the original Raspberry Pi 3. The VideoCore IV runs at 400MHz. The Arm core is 64-bit, while the VideoCore IV is 32-bit.
+The Arm cores are capable of running at up to 1.4 GHz, making the 3B+ and 3A+ about 17% faster than the original Raspberry Pi 3. The VideoCore IV runs at 400 MHz. The Arm core is 64-bit, while the VideoCore IV is 32-bit.
 
 The BCM2837B0 chip is packaged slightly differently to the BCM2837, and most notably includes a heat spreader for better thermals. This allows higher clock frequencies, and more accurate monitoring and control of the chip's temperature.
 
diff --git a/documentation/asciidoc/computers/raspberry-pi/introduction.adoc b/documentation/asciidoc/computers/raspberry-pi/introduction.adoc
@@ -14,7 +14,9 @@ Raspberry Pi makes computers in several different **series**:
 *Model B* indicates the presence of an Ethernet port.
 *Model A* indicates a lower-cost model in a smaller form factor with no Ethernet port, reduced RAM, and fewer USB ports to limit board height.
 
-[cols="6a,2,2,3,5"]
+IMPORTANT: Raspberry Pi 2 Model B revisions 1.1 and 1.2 have reached End-of-Life (EoL) due to the discontinuation of the core SoC used in these products. The official EoL date was 16 October 2025. Raspberry Pi 2 Model B revision 1.3 offers the same mechanical footprint and a BCM2837B0 processor, and so is recommended for existing designs. For more information, see the official https://pip.raspberrypi.com/documents/RP-009284-PC-2[Obsolescence Notice].
+
+[cols="6a,3,2,3,5"]
 |===
 | Model | SoC | Memory | GPIO | Connectivity
 
@@ -81,7 +83,11 @@ a|
 ^.^a|
 .Raspberry Pi 2 Model B
 image::images/2-model-b.jpg[alt="Raspberry Pi 2 Model B"]
-| xref:processors.adoc#bcm2836[BCM2836] (in version 1.2, switched to xref:processors.adoc#bcm2837[BCM2837]) | 1 GB | 40-pin GPIO header
+a|
+* revision 1.1: xref:processors.adoc#bcm2836[BCM2836]
+* revision 1.2: xref:processors.adoc#bcm2837[BCM2837]
+* revision 1.3: xref:processors.adoc#bcm2837b0[BCM2837B0]
+ ^.^a| 1 GB | 40-pin GPIO header
 a|
 * HDMI
 * 4 × USB 2.0
@@ -94,7 +100,10 @@ a|
 ^.^a|
 .Raspberry Pi 3 Model B
 image::images/3-model-b.jpg[alt="Raspberry Pi 3 Model B"]
-| xref:processors.adoc#bcm2837[BCM2837] | 1 GB | 40-pin GPIO header
+a|
+* revision 1.1: xref:processors.adoc#bcm2837[BCM2837]
+* revision 1.2: xref:processors.adoc#bcm2837b0[BCM2837B0]
+ ^.^a| 1 GB | 40-pin GPIO header
 a|
 * HDMI
 * 4 × USB 2.0
@@ -109,7 +118,7 @@ a|
 ^.^a|
 .Raspberry Pi 3 Model B+
 image::images/3-model-b-plus.jpg[alt="Raspberry Pi 3 Model B+"]
-| xref:processors.adoc#bcm2837b0[BCM2837b0] | 1 GB | 40-pin GPIO header
+| xref:processors.adoc#bcm2837b0[BCM2837B0] | 1 GB | 40-pin GPIO header
 a|
 * HDMI
 * 4 × USB 2.0
@@ -124,7 +133,7 @@ a|
 ^.^a|
 .Raspberry Pi 3 Model A+
 image::images/3-model-a-plus.jpg[alt="Raspberry Pi 3 Model A+"]
-| xref:processors.adoc#bcm2837b0[BCM2837b0] | 512 MB | 40-pin GPIO header
+| xref:processors.adoc#bcm2837b0[BCM2837B0] | 512 MB | 40-pin GPIO header
 a|
 * HDMI
 * USB 2.0
@@ -294,7 +303,7 @@ a|
 [[compute-module-series]]
 === Compute Module series
 
-IMPORTANT: Raspberry Pi Compute Module 3 (CM3) and Compute Module 3 Lite (CM3Lite) have reached End-of-Life (EoL) due to the discontinuation of the core SoC used in these products. The official EoL date was 16 October 2025. The closest equivalent to CM3 is Raspberry Pi Compute Module 3+, which offers the same mechanical footprint, improved thermal design, and a BCM2837B0 processor, and so is recommended for existing designs. For new designs requiring the SODIMM form factor, we recommend Compute Module 4S. For all other new designs, we recommend Compute Module 4 or Compute Module 5. For more information, see the official https://pip.raspberrypi.com/documents/RP-009286-PC?disposition=inline[Obsolescence Notice].
+IMPORTANT: Raspberry Pi Compute Module 3 (CM3) and Compute Module 3 Lite (CM3Lite) have reached End-of-Life (EoL) due to the discontinuation of the core SoC used in these products. The official EoL date was 16 October 2025. The closest equivalent to CM3 is Raspberry Pi Compute Module 3+, which offers the same mechanical footprint, improved thermal design, and a BCM2837B0 processor, and so is recommended for existing designs. For new designs requiring the SODIMM form factor, we recommend Compute Module 4S. For all other new designs, we recommend Compute Module 4 or Compute Module 5. For more information, see the official https://pip.raspberrypi.com/documents/RP-009286-PC[Obsolescence Notice].
 
 For more detailed information about the Raspberry Pi Compute Module hardware, see xref:compute-module.adoc[Compute Module hardware].
 
diff --git a/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc b/documentation/asciidoc/microcontrollers/debug-probe/introduction.adoc
@@ -32,7 +32,9 @@ 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.
 
 The Debug Probe has five LEDs, a red LED to indicate power, and four more activity indicator LEDs
 
