[RFC PATCH v2 7/8] doc: rockchip: Update for new binman image generation

Andrew Abbott andrew at mirx.dev
Mon May 16 13:07:11 CEST 2022


Update the Rockchip documentation for image generation with binman,
including the new automatically-created SPI image.

Signed-off-by: Andrew Abbott <andrew at mirx.dev>
---

Changes in v2:
- Remove note from docs about different offsets in SPI flash for
  different SoCs - this was a bad assumption on my part, it doesn't work
  this way.
- Update name of SD/MMC image in the docs from u-boot-rockchip-sdmmc.bin
  to u-boot-rockchip.bin.

 doc/board/rockchip/rockchip.rst | 29 +++++++----------------------
 1 file changed, 7 insertions(+), 22 deletions(-)

diff --git a/doc/board/rockchip/rockchip.rst b/doc/board/rockchip/rockchip.rst
index 4ca7b00b1f..a96ca0b582 100644
--- a/doc/board/rockchip/rockchip.rst
+++ b/doc/board/rockchip/rockchip.rst
@@ -172,8 +172,8 @@ Flashing
 SD Card
 ^^^^^^^
 
-All Rockchip platforms (except rk3128 which doesn't use SPL) are now
-supporting a single boot image using binman and pad_cat.
+All Rockchip platforms, (except rk3128 which doesn't use SPL) generate a
+SD/MMC full boot image using binman.
 
 To write an image that boots from a SD card (assumed to be /dev/sda):
 
@@ -224,31 +224,16 @@ is u-boot-dtb.img
 SPI
 ^^^
 
-The SPI boot method requires the generation of idbloader.img with help of the mkimage tool.
+Some platforms also generate a SPI flash full boot image, controlled by the
+CONFIG_ROCKCHIP_SPI_IMAGE configuration option.
 
-SPL-alone SPI boot image:
-
-.. code-block:: bash
-
-        ./tools/mkimage -n rk3399 -T rkspi -d spl/u-boot-spl.bin idbloader.img
-
-TPL+SPL SPI boot image:
-
-.. code-block:: bash
-
-        ./tools/mkimage -n rk3399 -T rkspi -d tpl/u-boot-tpl.bin:spl/u-boot-spl.bin idbloader.img
-
-Copy SPI boot images into SD card and boot from SD:
+This image can be copied onto an SD card and written to SPI flash:
 
 .. code-block:: bash
 
         sf probe
-        load mmc 1:1 $kernel_addr_r idbloader.img
-        sf erase 0 +$filesize
-        sf write $kernel_addr_r 0 ${filesize}
-        load mmc 1:1 ${kernel_addr_r} u-boot.itb
-        sf erase 0x60000 +$filesize
-        sf write $kernel_addr_r 0x60000 ${filesize}
+        load mmc 1:1 $kernel_addr_r u-boot-rockchip-spi.bin
+        sf update $kernel_addr_r 0 ${filesize}
 
 2. Package the image with Rockchip miniloader
 ---------------------------------------------
-- 
2.36.0



More information about the U-Boot mailing list