Re: [PATCH v3 07/12] rockchip: doc: add boot medium layout text

Hi Johan,

On 7/30/2026 3:34 PM, Johan Jonker wrote:
> Add text that explains the boot medium layout options.
> 
> Signed-off-by: Johan Jonker <[email protected]>
> ---
> 
> Changed V3:
> wrap
> remove 'the'
> use eMMC
> add unit and block size
> ---
>  doc/board/rockchip/rockchip.rst | 26 ++++++++++++++++++++++++++
>  1 file changed, 26 insertions(+)
> 
> --
> 2.39.5
> 
> diff --git a/doc/board/rockchip/rockchip.rst b/doc/board/rockchip/rockchip.rst
> index c089419b65e5..6b9007103257 100644
> --- a/doc/board/rockchip/rockchip.rst
> +++ b/doc/board/rockchip/rockchip.rst
> @@ -353,6 +353,32 @@ To build rk3588 boards:
>          make evb-rk3588_defconfig
>          make CROSS_COMPILE=aarch64-linux-gnu-
> 
> +Boot media layout
> +-----------------
> +
> +The boot ROM only checks a boot medium for a limited number of pages or blocks

I do not like that we keep using inconsistent naming for 'BootROM'.

> +for data. It is not possible to place these blocks randomly.
> +
> +* eMMC/SD card:
> +
> +  Rockchip uses a unified GPT partition layout for it's open source products.
> +  With this GPT partition layout U-Boot can be compatible with other components,
> +  like miniloader, trusted-os, arm-trusted-firmware.
> +
> +  There are some documents about partitions in the link below.
> +  https://web.archive.org/web/20260501050119/https://opensource.rock-chips.com/wiki_Partitions

Please drop this entire 'unified GPT partition layout' section, it is
not something we should encourage user to use. It is legacy and nothing
in mainline U-Boot that depends on this layout.

It has mostly been used to simplify flashing and locating vendor boot
firmware.

For mainline a more appropriate layout would be to reserve initial 0-16
MiB of boot media for partition table and firmware, and use remaining
freely.

> +
> +  Write u-boot-rockchip.bin to block offset 64 (block size: 512 byte).
> +
> +* SPI:
> +
> +  Write u-boot-rockchip-spi.bin to flash offset 0 (unit: bytes).
> +
> +* NAND:
> +
> +  The closed source usbplug binaries and RKMTD use the NAND erase blocks [2-6]
> +  for TPL/SPL.
> +

We should likely also mention UFS if we are listing all other supported
boot media.

Regards,
Jonas

>  BootROM mode
>  ------------
>