[PATCH v7 22/22] doc: sifive: fu540: Add description for RISC-V FU540 U-Boot SPL
Pragnesh Patel
pragnesh.patel at sifive.com
Sat May 2 18:53:22 CEST 2020
Hi Jagan,
>-----Original Message-----
>From: Jagan Teki <jagan at amarulasolutions.com>
>Sent: 02 May 2020 21:53
>To: Pragnesh Patel <pragnesh.patel at sifive.com>
>Cc: U-Boot-Denx <u-boot at lists.denx.de>; Atish Patra
><atish.patra at wdc.com>; Palmer Dabbelt <palmerdabbelt at google.com>; Bin
>Meng <bmeng.cn at gmail.com>; Paul Walmsley <paul.walmsley at sifive.com>;
>Troy Benjegerdes <troy.benjegerdes at sifive.com>; Anup Patel
><anup.patel at wdc.com>; Sagar Kadam <sagar.kadam at sifive.com>; Rick Chen
><rick at andestech.com>; Joe Hershberger <joe.hershberger at 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 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.
I am okay with your suggestion, will update in v8.
>
>Jagan.
More information about the U-Boot
mailing list