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

[Jagan Teki]

On Sat, May 2, 2020 at 3:39 PM Pragnesh Patel <pragnesh.patel at 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 at sifive.com>
> Signed-off-by: Jagan Teki <jagan at 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 at 10050000:mmc at 0: 0
> +       In:    serial at 10010000
> +       Out:   serial at 10010000
> +       Err:   serial at 10010000
> +       Board serial number should not be 0 !!
> +       Net:
> +       Warning: ethernet at 10090000 (eth0) using random MAC address - 96:06:92:18:eb:04
> +       eth0: ethernet at 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 at 10050000:mmc at 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.

Jagan.