diff --git a/documentation/asciidoc/computers/config_txt/boot.adoc b/documentation/asciidoc/computers/config_txt/boot.adoc index 8afd90026..a7dadaeff 100644 --- a/documentation/asciidoc/computers/config_txt/boot.adoc +++ b/documentation/asciidoc/computers/config_txt/boot.adoc @@ -25,13 +25,34 @@ The Raspberry Pi 5 firmware defaults to loading `kernel_2712.img` because this i === `arm_64bit` + If set to 1, the kernel will be started in 64-bit mode. Setting to 0 selects 32-bit mode. In 64-bit mode, the firmware will choose an appropriate kernel (e.g. `kernel8.img`), unless there is an explicit `kernel` option defined, in which case that is used instead. -Defaults to 1 on Pi 4s (Pi 4B, Pi 400, CM4 and CM4S), and 0 on all other platforms. However, if the name given in an explicit `kernel` option matches one of the known kernels then `arm_64bit` will be set accordingly. +Defaults to 1 on Raspberry Pi 4, 400 and Compute Module 4, 4S platforms. Defaults to 0 on all other platforms. However, if the name given in an explicit `kernel` option matches one of the known kernels then `arm_64bit` will be set accordingly. + +64-bit kernels come in the following forms: + +* uncompressed image files +* gzip archives of an image + +Both forms may use the `img` file extension; the bootloader recognizes archives using signature bytes at the start of the file. + +The following Raspberry Pi models support this flag: + +* 2B rev 1.2 +* 3 +* 3+ +* 4 +* 400 +* Zero 2 W +* Compute Module 3 +* Compute Module 3+ +* Compute Module 4 +* Compute Module 4S -NOTE: 64-bit kernels may be uncompressed image files or a gzip archive of an image (which can still be called kernel8.img; the bootloader will recognize the archive from the signature bytes at the beginning). The 64-bit kernel will only work on the Raspberry Pi 3, 3+, 4, 400, Zero 2 W and 2B rev 1.2, and Raspberry Pi Compute Modules 3, 3+ and 4. Raspberry Pi 5 only supports a 64-bit kernel, so this parameter has been removed for that device. +Later models, such as Raspberry Pi 5, _only_ support the 64-bit kernel. Such models do not support this flag. === `ramfsfile`