RE: [PATCH v7 22/22] doc: sifive: fu540: Add description for RISC-V FU540 U-Boot SPL

2 May 2020

Hi Jagan,
...
-----Original Message-----
From: Jagan Teki jagan@amarulasolutions.com
Sent: 02 May 2020 21:53
To: Pragnesh Patel pragnesh.patel@sifive.com
Cc: U-Boot-Denx u-boot@lists.denx.de; Atish Patra
atish.patra@wdc.com; Palmer Dabbelt palmerdabbelt@google.com; Bin
Meng bmeng.cn@gmail.com; Paul Walmsley paul.walmsley@sifive.com;
Troy Benjegerdes troy.benjegerdes@sifive.com; Anup Patel
anup.patel@wdc.com; Sagar Kadam sagar.kadam@sifive.com; Rick Chen
rick@andestech.com; Joe Hershberger joe.hershberger@ni.com
Subject: Re: [PATCH v7 22/22] doc: sifive: fu540: Add description for RISC-V
FU540 U-Boot SPL
[External Email] Do not click links or attachments unless you recognize the
sender and know the content is safe
On Sat, May 2, 2020 at 3:39 PM Pragnesh Patel pragnesh.patel@sifive.com
wrote:
...
Add descriptions about U-Boot SPL feature and how to build and run
from MMC.
Signed-off-by: Pragnesh Patel pragnesh.patel@sifive.com
Signed-off-by: Jagan Teki jagan@amarulasolutions.com

doc/board/sifive/fu540.rst | 376
+++++++++++++++++++++++++++++++++++++
 1 file changed, 376 insertions(+)

diff --git a/doc/board/sifive/fu540.rst b/doc/board/sifive/fu540.rst
index 1c3d4740f3..2911e3652e 100644
--- a/doc/board/sifive/fu540.rst
+++ b/doc/board/sifive/fu540.rst
@@ -38,6 +38,9 @@ TODO:
                reg = <0x0 0x2000000 0x0 0xc0000>;
        };
+Booting from MMC using FSBL
+---------------------------



Building
@@ -428,3 +431,376 @@ as well.
Please press Enter to activate this console.
/ #




+Booting from MMC using U-Boot SPL
+---------------------------------



+Building
+--------



+Before building U-Boot SPL, OpenSBI must be built first. OpenSBI can
+be cloned and built for FU540 as below:



+.. code-block:: console


  git clone https://github.com/riscv/opensbi.git


  cd opensbi


  make PLATFORM=generic FW_DYNAMIC=y




+Copy OpenSBI FW_DYNAMIC image
+(build/platform/sifive/fu540/firmware/fw_dynamic.bin) into U-Boot
+root directory



+.. code-block:: console


  cp build/platform/sifive/fu540/firmware/fw_dynamic.bin


<u-boot-dir>



+Now build the U-Boot SPL and U-Boot proper



+.. code-block:: console


  cd <U-Boot-dir>


  make sifive_fu540_defconfig


  make




+This will generate spl/u-boot-spl.bin and FIT image (u-boot.itb)




+Flashing
+--------



+ZSBL loads the U-Boot SPL (u-boot-spl.bin) from a partition with GUID
+type
+5B193300-FC78-40CD-8002-E86C45580B47



+U-Boot SPL expects a U-Boot FIT image (u-boot.itb) from a partition
+with GUID type 2E54B353-1271-4842-806F-E436D6AF6985



+FIT image (u-boot.itb) is a combination of fw_dynamic.bin,
+u-boot-nodtb.bin and device tree blob (hifive-unleashed-a00.dtb)



+Format the SD card (make sure the disk has GPT, otherwise use gdisk
+to switch)



+.. code-block:: none


  # sudo sgdisk --clear \


  > --set-alignment=2 \


  > --new=1:34:2081 --change-name=1:loader1 --typecode=1:5B193300-



FC78-40CD-8002-E86C45580B47 \
...

  > --new=2:2082:10273 --change-name=2:loader2 --



typecode=2:2E54B353-1271-4842-806F-E436D6AF6985 \
...

  > --new=3:10274: --change-name=3:rootfs --typecode=3:0FC63DAF-



8483-4772-8E79-3D69D8477DE4 \
...

  > /dev/sda




+Program the SD card



+.. code-block:: none


  sudo dd if=spl/u-boot-spl.bin of=/dev/sda seek=34


  sudo dd if=u-boot.itb of=/dev/sda seek=2082




+Booting
+-------
+Once you plugin the sdcard and power up, you should see the U-Boot
prompt.
...



+Sample boot log from HiFive Unleashed board
+-------------------------------------------



+.. code-block:: none


  U-Boot SPL 2020.04-rc2-00109-g63efc7e07e-dirty (Apr 30 2020 -



13:52:36 +0530)
...

  Trying to boot from MMC1




  U-Boot 2020.04-rc2-00109-g63efc7e07e-dirty (Apr 30 2020 -


13:52:36 +0530)

  CPU:   rv64imafdc


  Model: SiFive HiFive Unleashed A00


  DRAM:  8 GiB


  MMC:   spi@10050000:mmc@0: 0


  In:    serial@10010000


  Out:   serial@10010000


  Err:   serial@10010000


  Board serial number should not be 0 !!


  Net:


  Warning: ethernet@10090000 (eth0) using random MAC address -



96:06:92:18:eb:04
...

  eth0: ethernet@10090000


  Hit any key to stop autoboot:  0


  => version


  U-Boot 2020.04-rc2-00109-g63efc7e07e-dirty (Apr 30 2020 -


13:52:36 +0530)

  riscv64-unknown-linux-gnu-gcc (crosstool-NG 1.24.0.37-3f461da) 9.2.0


  GNU ld (crosstool-NG 1.24.0.37-3f461da) 2.32


  => mmc info


  Device: spi@10050000:mmc@0


  Manufacturer ID: 3


  OEM: 5344


  Name: SC16G


  Bus Speed: 20000000


  Mode: SD Legacy


  Rd Block Len: 512


  SD version 2.0


  High Capacity: Yes


  Capacity: 14.8 GiB


  Bus Width: 1-bit


  Erase Group Size: 512 Bytes


  => mmc part



  Partition Map for MMC device 0  --   Partition Type: EFI



  Part    Start LBA       End LBA         Name


  Attributes


  Type GUID


  Partition GUID


  1     0x00000022      0x00000821      "loader1"


  attrs:  0x0000000000000000


  type:   5b193300-fc78-40cd-8002-e86c45580b47


  guid:   66e2b5d2-74db-4df8-ad6f-694b3617f87f


  2     0x00000822      0x00002821      "loader2"


  attrs:  0x0000000000000000


  type:   2e54b353-1271-4842-806f-e436d6af6985


  guid:   8befaeaf-bca0-435d-b002-e201f37c0a2f


  3     0x00002822      0x01dacbde      "rootfs"


  attrs:  0x0000000000000000


  type:   0fc63daf-8483-4772-8e79-3d69d8477de4


  type:   linux


  guid:   9faa81b6-39b1-4418-af5e-89c48f29c20d



Upto this, will be a valid doc for SPL MMC boot, but squash it on the patch
where you enable the SPL MMC. the rest I feel unnecessary.
I am okay with your suggestion, will update in v8.
...
Jagan.

    