Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
98bc643
Add warning for signal line connections
Manu3l0us Oct 28, 2025
1f89bdf
Update documentation/asciidoc/microcontrollers/debug-probe/introducti…
Manu3l0us Oct 28, 2025
3bce8a7
EoL note for 2B
katshann-raspberry Oct 29, 2025
07def0e
Update documentation/asciidoc/computers/raspberry-pi/introduction.adoc
katshann-raspberry Oct 30, 2025
506f981
Update documentation/asciidoc/computers/raspberry-pi/introduction.adoc
katshann-raspberry Oct 30, 2025
dc3d649
Add EoL mention to processor info.
katshann-raspberry Oct 30, 2025
db7ae31
More information in processor article.
katshann-raspberry Nov 4, 2025
236849b
Update documentation/asciidoc/computers/processors/bcm2837.adoc
katshann-raspberry Nov 5, 2025
d3e41d7
Update documentation/asciidoc/computers/raspberry-pi/introduction.adoc
katshann-raspberry Nov 5, 2025
778e6ca
Update documentation/asciidoc/computers/processors/bcm2837b0.adoc
katshann-raspberry Nov 5, 2025
33f9e4d
Flag enable_rp1_uart as being Pi5-only
lurch Nov 5, 2025
3902ff3
Further updates
katshann-raspberry Nov 6, 2025
182671b
Merge pull request #4240 from raspberrypi/lurch-patch-1
lurch Nov 6, 2025
18f6e7e
Dealing with final comments and added spaces before units of measure.
JeuneseRPi Nov 6, 2025
d715bb5
Merge pull request #4231 from raspberrypi/2b-eol
JeuneseRPi Nov 6, 2025
7426624
Update documentation/asciidoc/microcontrollers/debug-probe/introducti…
JeuneseRPi Nov 6, 2025
9448b02
Update documentation/asciidoc/microcontrollers/debug-probe/introducti…
JeuneseRPi Nov 6, 2025
c8a07f5
Merge pull request #4230 from Manu3l0us/patch-2
JeuneseRPi Nov 6, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions documentation/asciidoc/computers/config_txt/boot.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
4 changes: 3 additions & 1 deletion documentation/asciidoc/computers/processors/bcm2836.adoc
Original file line number Diff line number Diff line change
@@ -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].
6 changes: 4 additions & 2 deletions documentation/asciidoc/computers/processors/bcm2837.adoc
Original file line number Diff line number Diff line change
@@ -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].
4 changes: 2 additions & 2 deletions documentation/asciidoc/computers/processors/bcm2837b0.adoc
Original file line number Diff line number Diff line change
@@ -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.

Expand Down
21 changes: 15 additions & 6 deletions documentation/asciidoc/computers/raspberry-pi/introduction.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -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].

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down