[7/7] doc: rockchip: Document Rockchip miniloader flashing

Message ID 20200724105119.13123-8-jagan@amarulasolutions.com
State New
Headers show
Series
  • rockchip: Add Engicam PX30.Core support
Related show

Commit Message

Jagan Teki July 24, 2020, 10:51 a.m. UTC
This would be useful and recommended boot flow for new boards
which has doesn't have the DDR support yet in mainline.

Sometimes it is very useful for debugging mainline DDR support.

Documen it for px30 boot flow.

Signed-off-by: Jagan Teki <jagan@amarulasolutions.com>
---
 doc/board/rockchip/rockchip.rst | 40 ++++++++++++++++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

Comments

Kever Yang Aug. 8, 2020, 9:51 a.m. UTC | #1
Hi Jagan,

在 2020/7/24 下午6:51, Jagan Teki 写道:
> This would be useful and recommended boot flow for new boards
> which has doesn't have the DDR support yet in mainline.
>
> Sometimes it is very useful for debugging mainline DDR support.
>
> Documen it for px30 boot flow.
typo for Doc?
>
> Signed-off-by: Jagan Teki <jagan@amarulasolutions.com>
> ---
>   doc/board/rockchip/rockchip.rst | 40 ++++++++++++++++++++++++++++++++-
>   1 file changed, 39 insertions(+), 1 deletion(-)
>
> diff --git a/doc/board/rockchip/rockchip.rst b/doc/board/rockchip/rockchip.rst
> index 8c92de0c92..ea061ad171 100644
> --- a/doc/board/rockchip/rockchip.rst
> +++ b/doc/board/rockchip/rockchip.rst
> @@ -123,6 +123,9 @@ To build rk3399 boards::
>   Flashing
>   --------
>   
> +1. Package the image with U-Boot TPL/SPL
> +-----------------------------------------
> +
>   SD Card
>   ^^^^^^^
>   
> @@ -187,6 +190,39 @@ Copy SPI boot images into SD card and boot from SD::
>           sf erase 0x60000 +$filesize
>           sf write $kernel_addr_r 0x60000 ${filesize}
>   
> +2. Package the image with Rockchip miniloader
> +---------------------------------------------
> +
> +Image package with Rockchip miniloader requires robin [1].
typo robin/rkbin
> +
> +Create idbloader.img
> +
> +.. code-block:: none
What do you mean by all these 'code-block'? I think we can just say use 
all the binaries from rkbin?
> +
> +  cd u-boot
> +  ./tools/mkimage -n px30 -T rksd -d rkbin/bin/rk33/px30_ddr_333MHz_v1.15.bin idbloader.img
> +  cat rkbin/bin/rk33/px30_miniloader_v1.22.bin >> idbloader.img
It would be better to use new format instead of 'cat' for miniloader part.
> +  sudo dd if=idbloader.img of=/dev/sda seek=64
> +
> +Create trust.img
> +
> +.. code-block:: none
> +
> +  cd rkbin
> +  ./tools/trust_merger RKTRUST/PX30TRUST.ini
> +  sudo dd if=trust.img of=/dev/sda seek=24576
> +
> +Create uboot.img
> +
> +.. code-block:: none
> +
> +  rbink/tools/loaderimage --pack --uboot u-boot-dtb.bin uboot.img 0x200000
> +  sudo dd if=uboot.img of=/dev/sda seek=16384
> +
> +Note:
> +1. 0x200000 is load address and it's an optional in some platforms.
0x200000 is CONFIG_SYS_TEXT_BASE, use this macro will help user better 
under stand.
> +2. rkbin binaries are kept on updating, so would recommend to use the latest versions.
> +
>   TODO
>   ----
>   
> @@ -195,5 +231,7 @@ TODO
>   - Document SPI flash boot
>   - Add missing SoC's with it boards list
>   
> +[1] https://github.com/rockchip-linux/rkbin
> +
>   .. Jagan Teki <jagan@amarulasolutions.com>
> -.. Tuesday 02 June 2020 12:18:57 AM IST
> +.. Thursday 23 July 2020 04:50:22 PM IST

Patch

diff --git a/doc/board/rockchip/rockchip.rst b/doc/board/rockchip/rockchip.rst
index 8c92de0c92..ea061ad171 100644
--- a/doc/board/rockchip/rockchip.rst
+++ b/doc/board/rockchip/rockchip.rst
@@ -123,6 +123,9 @@  To build rk3399 boards::
 Flashing
 --------
 
+1. Package the image with U-Boot TPL/SPL
+-----------------------------------------
+
 SD Card
 ^^^^^^^
 
@@ -187,6 +190,39 @@  Copy SPI boot images into SD card and boot from SD::
         sf erase 0x60000 +$filesize
         sf write $kernel_addr_r 0x60000 ${filesize}
 
+2. Package the image with Rockchip miniloader
+---------------------------------------------
+
+Image package with Rockchip miniloader requires robin [1].
+
+Create idbloader.img
+
+.. code-block:: none
+
+  cd u-boot
+  ./tools/mkimage -n px30 -T rksd -d rkbin/bin/rk33/px30_ddr_333MHz_v1.15.bin idbloader.img
+  cat rkbin/bin/rk33/px30_miniloader_v1.22.bin >> idbloader.img
+  sudo dd if=idbloader.img of=/dev/sda seek=64
+
+Create trust.img
+
+.. code-block:: none
+
+  cd rkbin
+  ./tools/trust_merger RKTRUST/PX30TRUST.ini
+  sudo dd if=trust.img of=/dev/sda seek=24576
+
+Create uboot.img
+
+.. code-block:: none
+
+  rbink/tools/loaderimage --pack --uboot u-boot-dtb.bin uboot.img 0x200000
+  sudo dd if=uboot.img of=/dev/sda seek=16384
+
+Note:
+1. 0x200000 is load address and it's an optional in some platforms.
+2. rkbin binaries are kept on updating, so would recommend to use the latest versions.
+
 TODO
 ----
 
@@ -195,5 +231,7 @@  TODO
 - Document SPI flash boot
 - Add missing SoC's with it boards list
 
+[1] https://github.com/rockchip-linux/rkbin
+
 .. Jagan Teki <jagan@amarulasolutions.com>
-.. Tuesday 02 June 2020 12:18:57 AM IST
+.. Thursday 23 July 2020 04:50:22 PM IST