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 > ------------ >
