[PATCH v4 2/9] rockchip: doc: add mask ROM mode text

Add text that explains how to get into mask ROM mode.

Signed-off-by: Johan Jonker <[email protected]>
---
 doc/board/rockchip/rockchip.rst | 26 ++++++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/doc/board/rockchip/rockchip.rst b/doc/board/rockchip/rockchip.rst
index de2df3046e28..d31b6d182c5e 100644
--- a/doc/board/rockchip/rockchip.rst
+++ b/doc/board/rockchip/rockchip.rst
@@ -325,6 +325,28 @@ To build rk3588 boards:
         make evb-rk3588_defconfig
         make CROSS_COMPILE=aarch64-linux-gnu-
 
+Mask ROM mode
+-------------
+
+The mode that the boot ROM falls back into that listens to
+0x471/0x472 USB commands.
+
+Options to get your board into Mask ROM mode:
+
+* Holding the recovery button, depending on firmware support or wiring,
+  when booting the board.
+* Remove any SD cards, removable eMMC or removable UFS modules.
+* Erase any storage media containing boot firmware.
+
+Methods of last resort (USE AT YOUR OWN RISK):
+
+Pins that should be connected/sorted for a
+short period when the board is connected to power, so that boot ROM
+cannot locate any boot firmware and falls back into Mask ROM mode.
+
+* NAND: connect pin 8 and 9 of the NAND flash with a needle.
+* eMMC: connect the clock line to ground.
+
 Flashing
 --------
 
@@ -485,9 +507,9 @@ To write a U-Boot image to the SD card (assumed to be /dev/sda):
 NAND
 """"
 
-Bring device in BootROM mode:
+Bring device in Mask ROM mode:
 
-If bricked and no BootROM mode shows up then connect pin 8 and 9 of the NAND flash
+If bricked and no Mask ROM mode shows up then connect pin 8 and 9 of the NAND flash
 with a needle while reconnecting to the USB OTG port to a PC.
 
 Show connected devices with:
-- 
2.39.5