From: Andrew Abbott <andrew@mirx.dev>
To: U-Boot Mailing List <u-boot@lists.denx.de>
Cc: Jagan Teki <jagan@amarulasolutions.com>,
Johan Jonker <jbx6244@gmail.com>, Simon Glass <sjg@chromium.org>,
Samuel Dionne-Riel <samuel@dionne-riel.com>,
Peter Robinson <pbrobinson@gmail.com>,
Kever Yang <kever.yang@rock-chips.com>,
Philipp Tomsich <philipp.tomsich@vrull.eu>,
Andrew Abbott <andrew@mirx.dev>,
Alper Nebi Yasak <alpernebiyasak@gmail.com>,
"Marty E. Plummer" <hanetzer@startmail.com>,
Philipp Tomsich <philipp.tomsich@theobroma-systems.com>
Subject: [RFC PATCH v2 7/8] doc: rockchip: Update for new binman image generation
Date: Mon, 16 May 2022 21:07:11 +1000 [thread overview]
Message-ID: <20220516110712.178958-8-andrew@mirx.dev> (raw)
In-Reply-To: <20220516110712.178958-1-andrew@mirx.dev>
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
next prev parent reply other threads:[~2022-05-16 11:10 UTC|newest]
Thread overview: 22+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-05-16 11:07 [RFC PATCH v2 0/8] Build Rockchip final images using binman Andrew Abbott
2022-05-16 11:07 ` [RFC PATCH v2 1/8] binman: mkimage: Support ':'-separated inputs Andrew Abbott
2022-05-19 11:36 ` Alper Nebi Yasak
2022-05-22 0:03 ` Andrew Abbott
2022-05-16 11:07 ` [RFC PATCH v2 2/8] rockchip: Add binman definitions for final images Andrew Abbott
2022-05-19 11:36 ` Alper Nebi Yasak
2022-05-22 0:55 ` Andrew Abbott
2022-05-29 16:31 ` Alper Nebi Yasak
2022-05-16 11:07 ` [RFC PATCH v2 3/8] soc: rockchip: Include common U-Boot dtsi file Andrew Abbott
2022-05-19 11:36 ` Alper Nebi Yasak
2022-05-16 11:07 ` [RFC PATCH v2 4/8] board: rockchip: Move SPI U-Boot offset to config Andrew Abbott
2022-05-19 11:36 ` Alper Nebi Yasak
2022-05-16 11:07 ` [RFC PATCH v2 5/8] rockchip: Remove obsolete Makefile targets Andrew Abbott
2022-05-16 11:07 ` [RFC PATCH v2 6/8] rockchip: Enable binman for ARM64 Andrew Abbott
2022-05-19 11:37 ` Alper Nebi Yasak
2022-05-22 1:27 ` Andrew Abbott
2022-05-16 11:07 ` Andrew Abbott [this message]
2022-05-16 11:07 ` [RFC PATCH v2 8/8] board: rockpro64: Enable building SPI image Andrew Abbott
2022-05-16 15:13 ` [RFC PATCH v2 0/8] Build Rockchip final images using binman Jerome Forissier
2022-05-19 9:59 ` Andrew Abbott
2022-05-19 11:35 ` Alper Nebi Yasak
2022-05-21 23:47 ` Andrew Abbott
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20220516110712.178958-8-andrew@mirx.dev \
--to=andrew@mirx.dev \
--cc=alpernebiyasak@gmail.com \
--cc=hanetzer@startmail.com \
--cc=jagan@amarulasolutions.com \
--cc=jbx6244@gmail.com \
--cc=kever.yang@rock-chips.com \
--cc=pbrobinson@gmail.com \
--cc=philipp.tomsich@theobroma-systems.com \
--cc=philipp.tomsich@vrull.eu \
--cc=samuel@dionne-riel.com \
--cc=sjg@chromium.org \
--cc=u-boot@lists.denx.de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.