Hi Johan, On 7/30/2026 3:33 PM, Johan Jonker wrote: > Add text that explains how to get into BootROM mode. > > Signed-off-by: Johan Jonker <[email protected]> > --- > > Changed V3: > remove MaskROM > reword connect > use eMMC > wrap > --- > doc/board/rockchip/rockchip.rst | 16 ++++++++++++++++ > 1 file changed, 16 insertions(+) > > -- > 2.39.5 > > diff --git a/doc/board/rockchip/rockchip.rst b/doc/board/rockchip/rockchip.rst > index 5144cbccef78..fab1af73b22a 100644 > --- a/doc/board/rockchip/rockchip.rst > +++ b/doc/board/rockchip/rockchip.rst > @@ -325,6 +325,22 @@ To build rk3588 boards: > make evb-rk3588_defconfig > make CROSS_COMPILE=aarch64-linux-gnu- > > +BootROM mode > +------------ > + > +Options to get your board into BootROM mode:
We typically call this mode 'maskrom mode', i.e. the mode bootrom fallback into that listens to 0x471/0x472 usb commands. > + > +* Holding the recovery button when you boot the board. Holding a recovery button does not always take you to the maskrom mode, it typically depends on current firmware and how such recovery button is wired. > +* Remove the SD card. Maybe make this more generic, today we have e.g. SD card, eMMC modules and UFS modules that can be removed from some boards. > +* Erase the NAND, eMMC or SPI chip part where the BootROM blocks are located. BootROM blocks is a bad phrase to use here, the BootROM is read-only and located inside the SoC. The intent here is likely closer to 'erase any storage media containing boot firmware' or similar. > + > +Methods of last resort (USE AT YOUR OWN RISK): > + > +* NAND: connect pin 8 and 9 of the NAND flash with a needle while > + reconnecting to the USB OTG port to a PC. > +* eMMC: connect the clock line to ground while > + reconnecting to the USB OTG port to a PC. Not all boards get power from USB OTG port, so this phrase is maybe too narrow? The intent is likely that the pins should be connected/sorted for a short period when the board is connected to power, so that bootrom cannot locate any boot firmware and falls back into maskrom mode. Regards, Jonas > + > Flashing > -------- >
