Skip to content

Commit 920c82e

Browse files
committed
program_rpiboot_gpio: Fixup board info and rationale for this property
The documenation has become a bit mangled here. Clarify that this is only for Raspberry Pi 4 family products that lack a dedicated nRPIBOOT GPIO jumper.
1 parent 6cdfdf8 commit 920c82e

File tree

1 file changed

+6
-4
lines changed
  • documentation/asciidoc/computers/config_txt

1 file changed

+6
-4
lines changed

documentation/asciidoc/computers/config_txt/boot.adoc

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -267,7 +267,9 @@ Default: `0`
267267
[[program_rpiboot_gpio]]
268268
==== `program_rpiboot_gpio`
269269

270-
Compute Modules have a dedicated `nRPIBOOT` jumper to select `RPIBOOT` mode. Flagship and Keyboard Raspberry Pi devices with EEPROM lack a dedicated `nRPIBOOT` jumper. To select `RPIBOOT` mode on Flagship and Keyboard devices, pull one of the following GPIO pins low:
270+
Raspberry Pi 4B and Raspberry Pi 400 only.
271+
272+
Compute Module 4 and 4S have a dedicated `nRPIBOOT` jumper to select `RPIBOOT` mode. Raspberry Pi 4B and Raspberry Pi 400 lack a dedicated `nRPIBOOT` jumper so one of the following GPIOs must be selected for use as `nRPIBOOT`.
271273

272274
* `2`
273275
* `4`
@@ -276,11 +278,11 @@ Compute Modules have a dedicated `nRPIBOOT` jumper to select `RPIBOOT` mode. Fla
276278
* `7`
277279
* `8`
278280

279-
This property does not depend on `secure-boot`. However, you should verify that this GPIO configuration does not conflict with any HATs which might pull the GPIO low during boot.
281+
The GPIO may be used as a general-purpose I/O pin after the OS has started. However, you should verify that this GPIO configuration does not conflict with any HATs which might pull the GPIO low during boot.
280282

281-
For safety, this property can _only_ be programmed via `RPIBOOT`. As a result, you must first clear the bootloader EEPROM using `erase_eeprom`. This causes the ROM to failover to `RPIBOOT` mode, which then allows this option to be set.
283+
Although `secure-boot` requires this property to be set on Raspberry Pi 4B and Raspberry Pi 400, it does not depend on `secure-boot`. For example, `RPIBOOT` can be useful for automated testing.
282284

283-
On BCM2712, you can alternatively force `RPIBOOT` mode by holding down the power button while simultaneously connecting a USB-C power supply.
285+
For safety, this OTP value can _only_ be programmed via `RPIBOOT`. As a result, you must first clear the bootloader EEPROM using `erase_eeprom`. The blank EEPROM causes the ROM to failover to `RPIBOOT` mode, which then allows this option to be set.
284286

285287
Default: `{nbsp}`
286288

0 commit comments

Comments
 (0)