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

Andrew Abbott
2022-05-16T11:10:49Z

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

Signed-off-by: Andrew Abbott <andrew@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