1 .. SPDX-License-Identifier: GPL-2.0+
8 The FU540-C000 is the world’s first 4+1 64-bit RISC-V SoC from SiFive.
10 The HiFive Unleashed development platform is based on FU540-C000 and capable
15 The support for following drivers are already enabled:
17 1. SiFive UART Driver.
18 2. SiFive PRCI Driver for clock.
19 3. Cadence MACB ethernet driver for networking support.
21 5. MMC SPI Driver for MMC/SD support.
25 1. U-Boot expects the serial console device entry to be present under /chosen
26 DT node. Without a serial console U-Boot will panic. Example:
31 stdout-path = "/soc/serial@10010000:115200";
34 Booting from MMC using FSBL
35 ---------------------------
40 1. Add the RISC-V toolchain to your PATH.
41 2. Setup ARCH & cross compilation enviornment variable:
45 export CROSS_COMPILE=<riscv64 toolchain prefix>
47 3. make sifive_fu540_defconfig
53 The current U-Boot port is supported in S-mode only and loaded from DRAM.
55 A prior stage M-mode firmware/bootloader (e.g OpenSBI) is required to
56 boot the u-boot.bin in S-mode and provide M-mode runtime services.
58 Currently, the u-boot.bin is used as a payload of the OpenSBI FW_PAYLOAD
59 firmware. We need to compile OpenSBI with below command:
63 make PLATFORM=sifive/fu540 FW_PAYLOAD_PATH=<path to u-boot-dtb.bin>
65 More detailed description of steps required to build FW_PAYLOAD firmware
66 is beyond the scope of this document. Please refer OpenSBI documenation.
67 (Note: OpenSBI git repo is at https://github.com/riscv/opensbi.git)
69 Once the prior stage firmware/bootloader binary is generated, it should be
70 copied to the first partition of the sdcard.
74 sudo dd if=<prior_stage_firmware_binary> of=/dev/disk2s1 bs=1024
78 Once you plugin the sdcard and power up, you should see the U-Boot prompt.
80 Sample boot log from HiFive Unleashed board
81 -------------------------------------------
85 U-Boot 2019.07-00024-g350ff02f5b (Jul 22 2019 - 11:45:02 +0530)
88 Model: SiFive HiFive Unleashed A00
90 MMC: spi@10050000:mmc@0: 0
94 Net: eth0: ethernet@10090000
95 Hit any key to stop autoboot: 0
97 U-Boot 2019.07-00024-g350ff02f5b (Jul 22 2019 - 11:45:02 +0530)
99 riscv64-linux-gcc.br_real (Buildroot 2018.11-rc2-00003-ga0787e9) 8.2.0
100 GNU ld (GNU Binutils) 2.31.1
102 Device: spi@10050000:mmc@0
113 Erase Group Size: 512 Bytes
116 Partition Map for MMC device 0 -- Partition Type: EFI
118 Part Start LBA End LBA Name
122 1 0x00000800 0x000107ff "bootloader"
123 attrs: 0x0000000000000000
124 type: 2e54b353-1271-4842-806f-e436d6af6985
125 guid: 393bbd36-7111-491c-9869-ce24008f6403
126 2 0x00040800 0x00ecdfde ""
127 attrs: 0x0000000000000000
128 type: 0fc63daf-8483-4772-8e79-3d69d8477de4
129 guid: 7fc9a949-5480-48c7-b623-04923080757f
131 Now you can configure your networking, tftp server and use tftp boot method to
136 => setenv ipaddr 10.206.7.133
137 => setenv netmask 255.255.252.0
138 => setenv serverip 10.206.4.143
139 => setenv gateway 10.206.4.1
141 If you want to use a flat kernel image such as Image file
145 => tftpboot ${kernel_addr_r} /sifive/fu540/Image
146 ethernet@10090000: PHY present at 0
147 ethernet@10090000: Starting autonegotiation...
148 ethernet@10090000: Autonegotiation complete
149 ethernet@10090000: link up, 1000Mbps full-duplex (lpa: 0x3c00)
150 Using ethernet@10090000 device
151 TFTP from server 10.206.4.143; our IP address is 10.206.7.133
152 Filename '/sifive/fu540/Image'.
153 Load address: 0x84000000
154 Loading: #################################################################
155 #################################################################
156 #################################################################
157 #################################################################
158 #################################################################
159 #################################################################
160 #################################################################
161 #################################################################
162 #################################################################
163 #################################################################
164 #################################################################
165 #################################################################
166 #################################################################
167 #################################################################
168 #################################################################
169 #################################################################
170 #################################################################
171 #################################################################
172 #################################################################
173 #################################################################
174 #################################################################
175 #################################################################
176 #################################################################
177 #################################################################
178 #################################################################
179 #################################################################
180 ##########################################
183 Bytes transferred = 8867100 (874d1c hex)
185 Or if you want to use a compressed kernel image file such as Image.gz
189 => tftpboot ${kernel_addr_r} /sifive/fu540/Image.gz
190 ethernet@10090000: PHY present at 0
191 ethernet@10090000: Starting autonegotiation...
192 ethernet@10090000: Autonegotiation complete
193 ethernet@10090000: link up, 1000Mbps full-duplex (lpa: 0x3c00)
194 Using ethernet@10090000 device
195 TFTP from server 10.206.4.143; our IP address is 10.206.7.133
196 Filename '/sifive/fu540/Image.gz'.
197 Load address: 0x84000000
198 Loading: #################################################################
199 #################################################################
200 #################################################################
201 #################################################################
202 #################################################################
203 #################################################################
204 #################################################################
205 #################################################################
206 #################################################################
207 #################################################################
208 #################################################################
209 #################################################################
210 #################################################################
211 #################################################################
212 #################################################################
213 #################################################################
214 #################################################################
215 #################################################################
216 #################################################################
217 #################################################################
218 #################################################################
219 #################################################################
220 #################################################################
221 #################################################################
222 #################################################################
223 #################################################################
224 ##########################################
227 Bytes transferred = 4809458 (4962f2 hex)
228 =>setenv kernel_comp_addr_r 0x90000000
229 =>setenv kernel_comp_size 0x500000
231 By this time, correct kernel image is loaded and required enviornment variables
232 are set. You can proceed to load the ramdisk and device tree from the tftp server
237 => tftpboot ${ramdisk_addr_r} /sifive/fu540/uRamdisk
238 ethernet@10090000: PHY present at 0
239 ethernet@10090000: Starting autonegotiation...
240 ethernet@10090000: Autonegotiation complete
241 ethernet@10090000: link up, 1000Mbps full-duplex (lpa: 0x3c00)
242 Using ethernet@10090000 device
243 TFTP from server 10.206.4.143; our IP address is 10.206.7.133
244 Filename '/sifive/fu540/uRamdisk'.
245 Load address: 0x88300000
246 Loading: #################################################################
247 #################################################################
248 #################################################################
249 #################################################################
250 #################################################################
251 #################################################################
252 #################################################################
256 Bytes transferred = 2398272 (249840 hex)
257 => tftpboot ${fdt_addr_r} /sifive/fu540/hifive-unleashed-a00.dtb
258 ethernet@10090000: PHY present at 0
259 ethernet@10090000: Starting autonegotiation...
260 ethernet@10090000: Autonegotiation complete
261 ethernet@10090000: link up, 1000Mbps full-duplex (lpa: 0x7c00)
262 Using ethernet@10090000 device
263 TFTP from server 10.206.4.143; our IP address is 10.206.7.133
264 Filename '/sifive/fu540/hifive-unleashed-a00.dtb'.
265 Load address: 0x88000000
269 Bytes transferred = 5614 (15ee hex)
270 => setenv bootargs "root=/dev/ram rw console=ttySIF0 ip=dhcp earlycon=sbi"
271 => booti ${kernel_addr_r} ${ramdisk_addr_r} ${fdt_addr_r}
272 ## Loading init Ramdisk from Legacy Image at 88300000 ...
273 Image Name: Linux RootFS
274 Image Type: RISC-V Linux RAMDisk Image (uncompressed)
275 Data Size: 2398208 Bytes = 2.3 MiB
276 Load Address: 00000000
277 Entry Point: 00000000
278 Verifying Checksum ... OK
279 ## Flattened Device Tree blob at 88000000
280 Booting using the fdt blob at 0x88000000
281 Using Device Tree in place at 0000000088000000, end 00000000880045ed
285 [ 0.000000] OF: fdt: Ignoring memory range 0x80000000 - 0x80200000
286 [ 0.000000] Linux version 5.3.0-rc1-00003-g460ac558152f (anup@anup-lab-machine) (gcc version 8.2.0 (Buildroot 2018.11-rc2-00003-ga0787e9)) #6 SMP Mon Jul 22 10:01:01 IST 2019
287 [ 0.000000] earlycon: sbi0 at I/O port 0x0 (options '')
288 [ 0.000000] printk: bootconsole [sbi0] enabled
289 [ 0.000000] Initial ramdisk at: 0x(____ptrval____) (2398208 bytes)
290 [ 0.000000] Zone ranges:
291 [ 0.000000] DMA32 [mem 0x0000000080200000-0x00000000ffffffff]
292 [ 0.000000] Normal [mem 0x0000000100000000-0x000000027fffffff]
293 [ 0.000000] Movable zone start for each node
294 [ 0.000000] Early memory node ranges
295 [ 0.000000] node 0: [mem 0x0000000080200000-0x000000027fffffff]
296 [ 0.000000] Initmem setup node 0 [mem 0x0000000080200000-0x000000027fffffff]
297 [ 0.000000] software IO TLB: mapped [mem 0xfbfff000-0xfffff000] (64MB)
298 [ 0.000000] CPU with hartid=0 is not available
299 [ 0.000000] CPU with hartid=0 is not available
300 [ 0.000000] elf_hwcap is 0x112d
301 [ 0.000000] percpu: Embedded 18 pages/cpu s34584 r8192 d30952 u73728
302 [ 0.000000] Built 1 zonelists, mobility grouping on. Total pages: 2067975
303 [ 0.000000] Kernel command line: root=/dev/ram rw console=ttySIF0 ip=dhcp earlycon=sbi
304 [ 0.000000] Dentry cache hash table entries: 1048576 (order: 11, 8388608 bytes, linear)
305 [ 0.000000] Inode-cache hash table entries: 524288 (order: 10, 4194304 bytes, linear)
306 [ 0.000000] Sorting __ex_table...
307 [ 0.000000] mem auto-init: stack:off, heap alloc:off, heap free:off
308 [ 0.000000] Memory: 8182308K/8386560K available (5916K kernel code, 368K rwdata, 1840K rodata, 213K init, 304K bss, 204252K reserved, 0K cma-reserved)
309 [ 0.000000] SLUB: HWalign=64, Order=0-3, MinObjects=0, CPUs=4, Nodes=1
310 [ 0.000000] rcu: Hierarchical RCU implementation.
311 [ 0.000000] rcu: RCU restricting CPUs from NR_CPUS=8 to nr_cpu_ids=4.
312 [ 0.000000] rcu: RCU calculated value of scheduler-enlistment delay is 25 jiffies.
313 [ 0.000000] rcu: Adjusting geometry for rcu_fanout_leaf=16, nr_cpu_ids=4
314 [ 0.000000] NR_IRQS: 0, nr_irqs: 0, preallocated irqs: 0
315 [ 0.000000] plic: mapped 53 interrupts with 4 handlers for 9 contexts.
316 [ 0.000000] riscv_timer_init_dt: Registering clocksource cpuid [0] hartid [1]
317 [ 0.000000] clocksource: riscv_clocksource: mask: 0xffffffffffffffff max_cycles: 0x1d854df40, max_idle_ns: 3526361616960 ns
318 [ 0.000006] sched_clock: 64 bits at 1000kHz, resolution 1000ns, wraps every 2199023255500ns
319 [ 0.008559] Console: colour dummy device 80x25
320 [ 0.012989] Calibrating delay loop (skipped), value calculated using timer frequency.. 2.00 BogoMIPS (lpj=4000)
321 [ 0.023104] pid_max: default: 32768 minimum: 301
322 [ 0.028273] Mount-cache hash table entries: 16384 (order: 5, 131072 bytes, linear)
323 [ 0.035765] Mountpoint-cache hash table entries: 16384 (order: 5, 131072 bytes, linear)
324 [ 0.045307] rcu: Hierarchical SRCU implementation.
325 [ 0.049875] smp: Bringing up secondary CPUs ...
326 [ 0.055729] smp: Brought up 1 node, 4 CPUs
327 [ 0.060599] devtmpfs: initialized
328 [ 0.064819] random: get_random_u32 called from bucket_table_alloc.isra.10+0x4e/0x160 with crng_init=0
329 [ 0.073720] clocksource: jiffies: mask: 0xffffffff max_cycles: 0xffffffff, max_idle_ns: 7645041785100000 ns
330 [ 0.083176] futex hash table entries: 1024 (order: 4, 65536 bytes, linear)
331 [ 0.090721] NET: Registered protocol family 16
332 [ 0.106319] vgaarb: loaded
333 [ 0.108670] SCSI subsystem initialized
334 [ 0.112515] usbcore: registered new interface driver usbfs
335 [ 0.117758] usbcore: registered new interface driver hub
336 [ 0.123167] usbcore: registered new device driver usb
337 [ 0.128905] clocksource: Switched to clocksource riscv_clocksource
338 [ 0.141239] NET: Registered protocol family 2
339 [ 0.145506] tcp_listen_portaddr_hash hash table entries: 4096 (order: 4, 65536 bytes, linear)
340 [ 0.153754] TCP established hash table entries: 65536 (order: 7, 524288 bytes, linear)
341 [ 0.163466] TCP bind hash table entries: 65536 (order: 8, 1048576 bytes, linear)
342 [ 0.173468] TCP: Hash tables configured (established 65536 bind 65536)
343 [ 0.179739] UDP hash table entries: 4096 (order: 5, 131072 bytes, linear)
344 [ 0.186627] UDP-Lite hash table entries: 4096 (order: 5, 131072 bytes, linear)
345 [ 0.194117] NET: Registered protocol family 1
346 [ 0.198417] RPC: Registered named UNIX socket transport module.
347 [ 0.203887] RPC: Registered udp transport module.
348 [ 0.208664] RPC: Registered tcp transport module.
349 [ 0.213429] RPC: Registered tcp NFSv4.1 backchannel transport module.
350 [ 0.219944] PCI: CLS 0 bytes, default 64
351 [ 0.224170] Unpacking initramfs...
352 [ 0.262347] Freeing initrd memory: 2336K
353 [ 0.266531] workingset: timestamp_bits=62 max_order=21 bucket_order=0
354 [ 0.280406] NFS: Registering the id_resolver key type
355 [ 0.284798] Key type id_resolver registered
356 [ 0.289048] Key type id_legacy registered
357 [ 0.293114] nfs4filelayout_init: NFSv4 File Layout Driver Registering...
358 [ 0.300262] NET: Registered protocol family 38
359 [ 0.304432] Block layer SCSI generic (bsg) driver version 0.4 loaded (major 254)
360 [ 0.311862] io scheduler mq-deadline registered
361 [ 0.316461] io scheduler kyber registered
362 [ 0.356421] Serial: 8250/16550 driver, 4 ports, IRQ sharing disabled
363 [ 0.363004] 10010000.serial: ttySIF0 at MMIO 0x10010000 (irq = 4, base_baud = 0) is a SiFive UART v0
364 [ 0.371468] printk: console [ttySIF0] enabled
365 [ 0.371468] printk: console [ttySIF0] enabled
366 [ 0.380223] printk: bootconsole [sbi0] disabled
367 [ 0.380223] printk: bootconsole [sbi0] disabled
368 [ 0.389589] 10011000.serial: ttySIF1 at MMIO 0x10011000 (irq = 1, base_baud = 0) is a SiFive UART v0
369 [ 0.398680] [drm] radeon kernel modesetting enabled.
370 [ 0.412395] loop: module loaded
371 [ 0.415214] sifive_spi 10040000.spi: mapped; irq=3, cs=1
372 [ 0.420628] sifive_spi 10050000.spi: mapped; irq=5, cs=1
373 [ 0.425897] libphy: Fixed MDIO Bus: probed
374 [ 0.429964] macb 10090000.ethernet: Registered clk switch 'sifive-gemgxl-mgmt'
375 [ 0.436743] macb: GEM doesn't support hardware ptp.
376 [ 0.441621] libphy: MACB_mii_bus: probed
377 [ 0.601316] Microsemi VSC8541 SyncE 10090000.ethernet-ffffffff:00: attached PHY driver [Microsemi VSC8541 SyncE] (mii_bus:phy_addr=10090000.ethernet-ffffffff:00, irq=POLL)
378 [ 0.615857] macb 10090000.ethernet eth0: Cadence GEM rev 0x10070109 at 0x10090000 irq 6 (70:b3:d5:92:f2:f3)
379 [ 0.625634] e1000e: Intel(R) PRO/1000 Network Driver - 3.2.6-k
380 [ 0.631381] e1000e: Copyright(c) 1999 - 2015 Intel Corporation.
381 [ 0.637382] ehci_hcd: USB 2.0 'Enhanced' Host Controller (EHCI) Driver
382 [ 0.643799] ehci-pci: EHCI PCI platform driver
383 [ 0.648261] ehci-platform: EHCI generic platform driver
384 [ 0.653497] ohci_hcd: USB 1.1 'Open' Host Controller (OHCI) Driver
385 [ 0.659599] ohci-pci: OHCI PCI platform driver
386 [ 0.664055] ohci-platform: OHCI generic platform driver
387 [ 0.669448] usbcore: registered new interface driver uas
388 [ 0.674575] usbcore: registered new interface driver usb-storage
389 [ 0.680642] mousedev: PS/2 mouse device common for all mice
390 [ 0.709493] mmc_spi spi1.0: SD/MMC host mmc0, no DMA, no WP, no poweroff, cd polling
391 [ 0.716615] usbcore: registered new interface driver usbhid
392 [ 0.722023] usbhid: USB HID core driver
393 [ 0.726738] NET: Registered protocol family 10
394 [ 0.731359] Segment Routing with IPv6
395 [ 0.734332] sit: IPv6, IPv4 and MPLS over IPv4 tunneling driver
396 [ 0.740687] NET: Registered protocol family 17
397 [ 0.744660] Key type dns_resolver registered
398 [ 0.806775] mmc0: host does not support reading read-only switch, assuming write-enable
399 [ 0.814020] mmc0: new SDHC card on SPI
400 [ 0.820137] mmcblk0: mmc0:0000 SU08G 7.40 GiB
401 [ 0.850220] mmcblk0: p1 p2
402 [ 3.821524] macb 10090000.ethernet eth0: link up (1000/Full)
403 [ 3.828938] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready
404 [ 3.848919] Sending DHCP requests .., OK
405 [ 6.252076] IP-Config: Got DHCP answer from 10.206.4.1, my address is 10.206.7.133
406 [ 6.259624] IP-Config: Complete:
407 [ 6.262831] device=eth0, hwaddr=70:b3:d5:92:f2:f3, ipaddr=10.206.7.133, mask=255.255.252.0, gw=10.206.4.1
408 [ 6.272809] host=dhcp-10-206-7-133, domain=sdcorp.global.sandisk.com, nis-domain=(none)
409 [ 6.281228] bootserver=10.206.126.11, rootserver=10.206.126.11, rootpath=
410 [ 6.281232] nameserver0=10.86.1.1, nameserver1=10.86.2.1
411 [ 6.294179] ntpserver0=10.86.1.1, ntpserver1=10.86.2.1
412 [ 6.301026] Freeing unused kernel memory: 212K
413 [ 6.304683] This architecture does not have kernel memory protection.
414 [ 6.311121] Run /init as init process
418 | || | _ \| | | |\ \/ /
419 | || | | | | |_| |/ \
420 |_||_|_| |_|\____|\_/\_/
424 Please press Enter to activate this console.
427 Booting from MMC using U-Boot SPL
428 ---------------------------------
433 Before building U-Boot SPL, OpenSBI must be built first. OpenSBI can be
434 cloned and built for FU540 as below:
436 .. code-block:: console
438 git clone https://github.com/riscv/opensbi.git
440 make PLATFORM=generic
441 export OPENSBI=<path to opensbi/build/platform/generic/firmware/fw_dynamic.bin>
443 Now build the U-Boot SPL and U-Boot proper
445 .. code-block:: console
448 make sifive_fu540_defconfig
451 This will generate spl/u-boot-spl.bin and FIT image (u-boot.itb)
457 ZSBL loads the U-Boot SPL (u-boot-spl.bin) from a partition with GUID type
458 5B193300-FC78-40CD-8002-E86C45580B47
460 U-Boot SPL expects a U-Boot FIT image (u-boot.itb) from a partition with GUID
461 type 2E54B353-1271-4842-806F-E436D6AF6985
463 FIT image (u-boot.itb) is a combination of fw_dynamic.bin, u-boot-nodtb.bin and
464 device tree blob (hifive-unleashed-a00.dtb)
466 Format the SD card (make sure the disk has GPT, otherwise use gdisk to switch)
470 # sudo sgdisk --clear \
471 > --set-alignment=2 \
472 > --new=1:34:2081 --change-name=1:loader1 --typecode=1:5B193300-FC78-40CD-8002-E86C45580B47 \
473 > --new=2:2082:10273 --change-name=2:loader2 --typecode=2:2E54B353-1271-4842-806F-E436D6AF6985 \
474 > --new=3:10274: --change-name=3:rootfs --typecode=3:0FC63DAF-8483-4772-8E79-3D69D8477DE4 \
481 sudo dd if=spl/u-boot-spl.bin of=/dev/sda seek=34
482 sudo dd if=u-boot.itb of=/dev/sda seek=2082
486 Once you plugin the sdcard and power up, you should see the U-Boot prompt.
488 Sample boot log from HiFive Unleashed board
489 -------------------------------------------
493 U-Boot SPL 2020.04-rc2-00109-g63efc7e07e-dirty (Apr 30 2020 - 13:52:36 +0530)
494 Trying to boot from MMC1
497 U-Boot 2020.04-rc2-00109-g63efc7e07e-dirty (Apr 30 2020 - 13:52:36 +0530)
500 Model: SiFive HiFive Unleashed A00
502 MMC: spi@10050000:mmc@0: 0
506 Net: eth0: ethernet@10090000
507 Hit any key to stop autoboot: 0
509 U-Boot 2020.04-rc2-00109-g63efc7e07e-dirty (Apr 30 2020 - 13:52:36 +0530)
511 riscv64-unknown-linux-gnu-gcc (crosstool-NG 1.24.0.37-3f461da) 9.2.0
512 GNU ld (crosstool-NG 1.24.0.37-3f461da) 2.32
514 Device: spi@10050000:mmc@0
525 Erase Group Size: 512 Bytes
528 Partition Map for MMC device 0 -- Partition Type: EFI
530 Part Start LBA End LBA Name
534 1 0x00000022 0x00000821 "loader1"
535 attrs: 0x0000000000000000
536 type: 5b193300-fc78-40cd-8002-e86c45580b47
537 guid: 66e2b5d2-74db-4df8-ad6f-694b3617f87f
538 2 0x00000822 0x00002821 "loader2"
539 attrs: 0x0000000000000000
540 type: 2e54b353-1271-4842-806f-e436d6af6985
541 guid: 8befaeaf-bca0-435d-b002-e201f37c0a2f
542 3 0x00002822 0x01dacbde "rootfs"
543 attrs: 0x0000000000000000
544 type: 0fc63daf-8483-4772-8e79-3d69d8477de4
546 guid: 9faa81b6-39b1-4418-af5e-89c48f29c20d