fu540.rst 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423
  1. .. SPDX-License-Identifier: GPL-2.0+
  2. HiFive Unleashed
  3. ================
  4. FU540-C000 RISC-V SoC
  5. ---------------------
  6. The FU540-C000 is the world’s first 4+1 64-bit RISC-V SoC from SiFive.
  7. The HiFive Unleashed development platform is based on FU540-C000 and capable
  8. of running Linux.
  9. Mainline support
  10. ----------------
  11. The support for following drivers are already enabled:
  12. 1. SiFive UART Driver.
  13. 2. SiFive PRCI Driver for clock.
  14. 3. Cadence MACB ethernet driver for networking support.
  15. 4. SiFive SPI Driver.
  16. 5. MMC SPI Driver for MMC/SD support.
  17. TODO:
  18. 1. U-Boot expects the serial console device entry to be present under /chosen
  19. DT node. Without a serial console U-Boot will panic. Example:
  20. .. code-block:: none
  21. chosen {
  22. stdout-path = "/soc/serial@10010000:115200";
  23. };
  24. Building
  25. --------
  26. 1. Add the RISC-V toolchain to your PATH.
  27. 2. Setup ARCH & cross compilation enviornment variable:
  28. .. code-block:: none
  29. export ARCH=riscv
  30. export CROSS_COMPILE=<riscv64 toolchain prefix>
  31. 3. make sifive_fu540_defconfig
  32. 4. make
  33. Flashing
  34. --------
  35. The current U-Boot port is supported in S-mode only and loaded from DRAM.
  36. A prior stage M-mode firmware/bootloader (e.g OpenSBI) is required to
  37. boot the u-boot.bin in S-mode and provide M-mode runtime services.
  38. Currently, the u-boot.bin is used as a payload of the OpenSBI FW_PAYLOAD
  39. firmware. We need to compile OpenSBI with below command:
  40. .. code-block:: none
  41. make PLATFORM=sifive/fu540 FW_PAYLOAD_PATH=<path to u-boot-dtb.bin>
  42. More detailed description of steps required to build FW_PAYLOAD firmware
  43. is beyond the scope of this document. Please refer OpenSBI documenation.
  44. (Note: OpenSBI git repo is at https://github.com/riscv/opensbi.git)
  45. Once the prior stage firmware/bootloader binary is generated, it should be
  46. copied to the first partition of the sdcard.
  47. .. code-block:: none
  48. sudo dd if=<prior_stage_firmware_binary> of=/dev/disk2s1 bs=1024
  49. Booting
  50. -------
  51. Once you plugin the sdcard and power up, you should see the U-Boot prompt.
  52. Sample boot log from HiFive Unleashed board
  53. -------------------------------------------
  54. .. code-block:: none
  55. U-Boot 2019.07-00024-g350ff02f5b (Jul 22 2019 - 11:45:02 +0530)
  56. CPU: rv64imafdc
  57. Model: SiFive HiFive Unleashed A00
  58. DRAM: 8 GiB
  59. MMC: spi@10050000:mmc@0: 0
  60. In: serial@10010000
  61. Out: serial@10010000
  62. Err: serial@10010000
  63. Net: eth0: ethernet@10090000
  64. Hit any key to stop autoboot: 0
  65. => version
  66. U-Boot 2019.07-00024-g350ff02f5b (Jul 22 2019 - 11:45:02 +0530)
  67. riscv64-linux-gcc.br_real (Buildroot 2018.11-rc2-00003-ga0787e9) 8.2.0
  68. GNU ld (GNU Binutils) 2.31.1
  69. => mmc info
  70. Device: spi@10050000:mmc@0
  71. Manufacturer ID: 3
  72. OEM: 5344
  73. Name: SU08G
  74. Bus Speed: 20000000
  75. Mode: SD Legacy
  76. Rd Block Len: 512
  77. SD version 2.0
  78. High Capacity: Yes
  79. Capacity: 7.4 GiB
  80. Bus Width: 1-bit
  81. Erase Group Size: 512 Bytes
  82. => mmc part
  83. Partition Map for MMC device 0 -- Partition Type: EFI
  84. Part Start LBA End LBA Name
  85. Attributes
  86. Type GUID
  87. Partition GUID
  88. 1 0x00000800 0x000107ff "bootloader"
  89. attrs: 0x0000000000000000
  90. type: 2e54b353-1271-4842-806f-e436d6af6985
  91. guid: 393bbd36-7111-491c-9869-ce24008f6403
  92. 2 0x00040800 0x00ecdfde ""
  93. attrs: 0x0000000000000000
  94. type: 0fc63daf-8483-4772-8e79-3d69d8477de4
  95. guid: 7fc9a949-5480-48c7-b623-04923080757f
  96. Now you can configure your networking, tftp server and use tftp boot method to
  97. load uImage.
  98. .. code-block:: none
  99. => setenv ipaddr 10.206.7.133
  100. => setenv netmask 255.255.252.0
  101. => setenv serverip 10.206.4.143
  102. => setenv gateway 10.206.4.1
  103. If you want to use a flat kernel image such as Image file
  104. .. code-block:: none
  105. => tftpboot ${kernel_addr_r} /sifive/fu540/Image
  106. ethernet@10090000: PHY present at 0
  107. ethernet@10090000: Starting autonegotiation...
  108. ethernet@10090000: Autonegotiation complete
  109. ethernet@10090000: link up, 1000Mbps full-duplex (lpa: 0x3c00)
  110. Using ethernet@10090000 device
  111. TFTP from server 10.206.4.143; our IP address is 10.206.7.133
  112. Filename '/sifive/fu540/Image'.
  113. Load address: 0x84000000
  114. Loading: #################################################################
  115. #################################################################
  116. #################################################################
  117. #################################################################
  118. #################################################################
  119. #################################################################
  120. #################################################################
  121. #################################################################
  122. #################################################################
  123. #################################################################
  124. #################################################################
  125. #################################################################
  126. #################################################################
  127. #################################################################
  128. #################################################################
  129. #################################################################
  130. #################################################################
  131. #################################################################
  132. #################################################################
  133. #################################################################
  134. #################################################################
  135. #################################################################
  136. #################################################################
  137. #################################################################
  138. #################################################################
  139. #################################################################
  140. ##########################################
  141. 1.2 MiB/s
  142. done
  143. Bytes transferred = 8867100 (874d1c hex)
  144. Or if you want to use a compressed kernel image file such as Image.gz
  145. .. code-block:: none
  146. => tftpboot ${kernel_addr_r} /sifive/fu540/Image.gz
  147. ethernet@10090000: PHY present at 0
  148. ethernet@10090000: Starting autonegotiation...
  149. ethernet@10090000: Autonegotiation complete
  150. ethernet@10090000: link up, 1000Mbps full-duplex (lpa: 0x3c00)
  151. Using ethernet@10090000 device
  152. TFTP from server 10.206.4.143; our IP address is 10.206.7.133
  153. Filename '/sifive/fu540/Image.gz'.
  154. Load address: 0x84000000
  155. Loading: #################################################################
  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. #################################################################
  181. ##########################################
  182. 1.2 MiB/s
  183. done
  184. Bytes transferred = 4809458 (4962f2 hex)
  185. =>setenv kernel_comp_addr_r 0x90000000
  186. =>setenv kernel_comp_size 0x500000
  187. By this time, correct kernel image is loaded and required enviornment variables
  188. are set. You can proceed to load the ramdisk and device tree from the tftp server
  189. as well.
  190. .. code-block:: none
  191. => tftpboot ${ramdisk_addr_r} /sifive/fu540/uRamdisk
  192. ethernet@10090000: PHY present at 0
  193. ethernet@10090000: Starting autonegotiation...
  194. ethernet@10090000: Autonegotiation complete
  195. ethernet@10090000: link up, 1000Mbps full-duplex (lpa: 0x3c00)
  196. Using ethernet@10090000 device
  197. TFTP from server 10.206.4.143; our IP address is 10.206.7.133
  198. Filename '/sifive/fu540/uRamdisk'.
  199. Load address: 0x88300000
  200. Loading: #################################################################
  201. #################################################################
  202. #################################################################
  203. #################################################################
  204. #################################################################
  205. #################################################################
  206. #################################################################
  207. ##############
  208. 418.9 KiB/s
  209. done
  210. Bytes transferred = 2398272 (249840 hex)
  211. => tftpboot ${fdt_addr_r} /sifive/fu540/hifive-unleashed-a00.dtb
  212. ethernet@10090000: PHY present at 0
  213. ethernet@10090000: Starting autonegotiation...
  214. ethernet@10090000: Autonegotiation complete
  215. ethernet@10090000: link up, 1000Mbps full-duplex (lpa: 0x7c00)
  216. Using ethernet@10090000 device
  217. TFTP from server 10.206.4.143; our IP address is 10.206.7.133
  218. Filename '/sifive/fu540/hifive-unleashed-a00.dtb'.
  219. Load address: 0x88000000
  220. Loading: ##
  221. 1000 Bytes/s
  222. done
  223. Bytes transferred = 5614 (15ee hex)
  224. => setenv bootargs "root=/dev/ram rw console=ttySIF0 ip=dhcp earlycon=sbi"
  225. => booti ${kernel_addr_r} ${ramdisk_addr_r} ${fdt_addr_r}
  226. ## Loading init Ramdisk from Legacy Image at 88300000 ...
  227. Image Name: Linux RootFS
  228. Image Type: RISC-V Linux RAMDisk Image (uncompressed)
  229. Data Size: 2398208 Bytes = 2.3 MiB
  230. Load Address: 00000000
  231. Entry Point: 00000000
  232. Verifying Checksum ... OK
  233. ## Flattened Device Tree blob at 88000000
  234. Booting using the fdt blob at 0x88000000
  235. Using Device Tree in place at 0000000088000000, end 00000000880045ed
  236. Starting kernel ...
  237. [ 0.000000] OF: fdt: Ignoring memory range 0x80000000 - 0x80200000
  238. [ 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
  239. [ 0.000000] earlycon: sbi0 at I/O port 0x0 (options '')
  240. [ 0.000000] printk: bootconsole [sbi0] enabled
  241. [ 0.000000] Initial ramdisk at: 0x(____ptrval____) (2398208 bytes)
  242. [ 0.000000] Zone ranges:
  243. [ 0.000000] DMA32 [mem 0x0000000080200000-0x00000000ffffffff]
  244. [ 0.000000] Normal [mem 0x0000000100000000-0x000000027fffffff]
  245. [ 0.000000] Movable zone start for each node
  246. [ 0.000000] Early memory node ranges
  247. [ 0.000000] node 0: [mem 0x0000000080200000-0x000000027fffffff]
  248. [ 0.000000] Initmem setup node 0 [mem 0x0000000080200000-0x000000027fffffff]
  249. [ 0.000000] software IO TLB: mapped [mem 0xfbfff000-0xfffff000] (64MB)
  250. [ 0.000000] CPU with hartid=0 is not available
  251. [ 0.000000] CPU with hartid=0 is not available
  252. [ 0.000000] elf_hwcap is 0x112d
  253. [ 0.000000] percpu: Embedded 18 pages/cpu s34584 r8192 d30952 u73728
  254. [ 0.000000] Built 1 zonelists, mobility grouping on. Total pages: 2067975
  255. [ 0.000000] Kernel command line: root=/dev/ram rw console=ttySIF0 ip=dhcp earlycon=sbi
  256. [ 0.000000] Dentry cache hash table entries: 1048576 (order: 11, 8388608 bytes, linear)
  257. [ 0.000000] Inode-cache hash table entries: 524288 (order: 10, 4194304 bytes, linear)
  258. [ 0.000000] Sorting __ex_table...
  259. [ 0.000000] mem auto-init: stack:off, heap alloc:off, heap free:off
  260. [ 0.000000] Memory: 8182308K/8386560K available (5916K kernel code, 368K rwdata, 1840K rodata, 213K init, 304K bss, 204252K reserved, 0K cma-reserved)
  261. [ 0.000000] SLUB: HWalign=64, Order=0-3, MinObjects=0, CPUs=4, Nodes=1
  262. [ 0.000000] rcu: Hierarchical RCU implementation.
  263. [ 0.000000] rcu: RCU restricting CPUs from NR_CPUS=8 to nr_cpu_ids=4.
  264. [ 0.000000] rcu: RCU calculated value of scheduler-enlistment delay is 25 jiffies.
  265. [ 0.000000] rcu: Adjusting geometry for rcu_fanout_leaf=16, nr_cpu_ids=4
  266. [ 0.000000] NR_IRQS: 0, nr_irqs: 0, preallocated irqs: 0
  267. [ 0.000000] plic: mapped 53 interrupts with 4 handlers for 9 contexts.
  268. [ 0.000000] riscv_timer_init_dt: Registering clocksource cpuid [0] hartid [1]
  269. [ 0.000000] clocksource: riscv_clocksource: mask: 0xffffffffffffffff max_cycles: 0x1d854df40, max_idle_ns: 3526361616960 ns
  270. [ 0.000006] sched_clock: 64 bits at 1000kHz, resolution 1000ns, wraps every 2199023255500ns
  271. [ 0.008559] Console: colour dummy device 80x25
  272. [ 0.012989] Calibrating delay loop (skipped), value calculated using timer frequency.. 2.00 BogoMIPS (lpj=4000)
  273. [ 0.023104] pid_max: default: 32768 minimum: 301
  274. [ 0.028273] Mount-cache hash table entries: 16384 (order: 5, 131072 bytes, linear)
  275. [ 0.035765] Mountpoint-cache hash table entries: 16384 (order: 5, 131072 bytes, linear)
  276. [ 0.045307] rcu: Hierarchical SRCU implementation.
  277. [ 0.049875] smp: Bringing up secondary CPUs ...
  278. [ 0.055729] smp: Brought up 1 node, 4 CPUs
  279. [ 0.060599] devtmpfs: initialized
  280. [ 0.064819] random: get_random_u32 called from bucket_table_alloc.isra.10+0x4e/0x160 with crng_init=0
  281. [ 0.073720] clocksource: jiffies: mask: 0xffffffff max_cycles: 0xffffffff, max_idle_ns: 7645041785100000 ns
  282. [ 0.083176] futex hash table entries: 1024 (order: 4, 65536 bytes, linear)
  283. [ 0.090721] NET: Registered protocol family 16
  284. [ 0.106319] vgaarb: loaded
  285. [ 0.108670] SCSI subsystem initialized
  286. [ 0.112515] usbcore: registered new interface driver usbfs
  287. [ 0.117758] usbcore: registered new interface driver hub
  288. [ 0.123167] usbcore: registered new device driver usb
  289. [ 0.128905] clocksource: Switched to clocksource riscv_clocksource
  290. [ 0.141239] NET: Registered protocol family 2
  291. [ 0.145506] tcp_listen_portaddr_hash hash table entries: 4096 (order: 4, 65536 bytes, linear)
  292. [ 0.153754] TCP established hash table entries: 65536 (order: 7, 524288 bytes, linear)
  293. [ 0.163466] TCP bind hash table entries: 65536 (order: 8, 1048576 bytes, linear)
  294. [ 0.173468] TCP: Hash tables configured (established 65536 bind 65536)
  295. [ 0.179739] UDP hash table entries: 4096 (order: 5, 131072 bytes, linear)
  296. [ 0.186627] UDP-Lite hash table entries: 4096 (order: 5, 131072 bytes, linear)
  297. [ 0.194117] NET: Registered protocol family 1
  298. [ 0.198417] RPC: Registered named UNIX socket transport module.
  299. [ 0.203887] RPC: Registered udp transport module.
  300. [ 0.208664] RPC: Registered tcp transport module.
  301. [ 0.213429] RPC: Registered tcp NFSv4.1 backchannel transport module.
  302. [ 0.219944] PCI: CLS 0 bytes, default 64
  303. [ 0.224170] Unpacking initramfs...
  304. [ 0.262347] Freeing initrd memory: 2336K
  305. [ 0.266531] workingset: timestamp_bits=62 max_order=21 bucket_order=0
  306. [ 0.280406] NFS: Registering the id_resolver key type
  307. [ 0.284798] Key type id_resolver registered
  308. [ 0.289048] Key type id_legacy registered
  309. [ 0.293114] nfs4filelayout_init: NFSv4 File Layout Driver Registering...
  310. [ 0.300262] NET: Registered protocol family 38
  311. [ 0.304432] Block layer SCSI generic (bsg) driver version 0.4 loaded (major 254)
  312. [ 0.311862] io scheduler mq-deadline registered
  313. [ 0.316461] io scheduler kyber registered
  314. [ 0.356421] Serial: 8250/16550 driver, 4 ports, IRQ sharing disabled
  315. [ 0.363004] 10010000.serial: ttySIF0 at MMIO 0x10010000 (irq = 4, base_baud = 0) is a SiFive UART v0
  316. [ 0.371468] printk: console [ttySIF0] enabled
  317. [ 0.371468] printk: console [ttySIF0] enabled
  318. [ 0.380223] printk: bootconsole [sbi0] disabled
  319. [ 0.380223] printk: bootconsole [sbi0] disabled
  320. [ 0.389589] 10011000.serial: ttySIF1 at MMIO 0x10011000 (irq = 1, base_baud = 0) is a SiFive UART v0
  321. [ 0.398680] [drm] radeon kernel modesetting enabled.
  322. [ 0.412395] loop: module loaded
  323. [ 0.415214] sifive_spi 10040000.spi: mapped; irq=3, cs=1
  324. [ 0.420628] sifive_spi 10050000.spi: mapped; irq=5, cs=1
  325. [ 0.425897] libphy: Fixed MDIO Bus: probed
  326. [ 0.429964] macb 10090000.ethernet: Registered clk switch 'sifive-gemgxl-mgmt'
  327. [ 0.436743] macb: GEM doesn't support hardware ptp.
  328. [ 0.441621] libphy: MACB_mii_bus: probed
  329. [ 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)
  330. [ 0.615857] macb 10090000.ethernet eth0: Cadence GEM rev 0x10070109 at 0x10090000 irq 6 (70:b3:d5:92:f2:f3)
  331. [ 0.625634] e1000e: Intel(R) PRO/1000 Network Driver - 3.2.6-k
  332. [ 0.631381] e1000e: Copyright(c) 1999 - 2015 Intel Corporation.
  333. [ 0.637382] ehci_hcd: USB 2.0 'Enhanced' Host Controller (EHCI) Driver
  334. [ 0.643799] ehci-pci: EHCI PCI platform driver
  335. [ 0.648261] ehci-platform: EHCI generic platform driver
  336. [ 0.653497] ohci_hcd: USB 1.1 'Open' Host Controller (OHCI) Driver
  337. [ 0.659599] ohci-pci: OHCI PCI platform driver
  338. [ 0.664055] ohci-platform: OHCI generic platform driver
  339. [ 0.669448] usbcore: registered new interface driver uas
  340. [ 0.674575] usbcore: registered new interface driver usb-storage
  341. [ 0.680642] mousedev: PS/2 mouse device common for all mice
  342. [ 0.709493] mmc_spi spi1.0: SD/MMC host mmc0, no DMA, no WP, no poweroff, cd polling
  343. [ 0.716615] usbcore: registered new interface driver usbhid
  344. [ 0.722023] usbhid: USB HID core driver
  345. [ 0.726738] NET: Registered protocol family 10
  346. [ 0.731359] Segment Routing with IPv6
  347. [ 0.734332] sit: IPv6, IPv4 and MPLS over IPv4 tunneling driver
  348. [ 0.740687] NET: Registered protocol family 17
  349. [ 0.744660] Key type dns_resolver registered
  350. [ 0.806775] mmc0: host does not support reading read-only switch, assuming write-enable
  351. [ 0.814020] mmc0: new SDHC card on SPI
  352. [ 0.820137] mmcblk0: mmc0:0000 SU08G 7.40 GiB
  353. [ 0.850220] mmcblk0: p1 p2
  354. [ 3.821524] macb 10090000.ethernet eth0: link up (1000/Full)
  355. [ 3.828938] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready
  356. [ 3.848919] Sending DHCP requests .., OK
  357. [ 6.252076] IP-Config: Got DHCP answer from 10.206.4.1, my address is 10.206.7.133
  358. [ 6.259624] IP-Config: Complete:
  359. [ 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
  360. [ 6.272809] host=dhcp-10-206-7-133, domain=sdcorp.global.sandisk.com, nis-domain=(none)
  361. [ 6.281228] bootserver=10.206.126.11, rootserver=10.206.126.11, rootpath=
  362. [ 6.281232] nameserver0=10.86.1.1, nameserver1=10.86.2.1
  363. [ 6.294179] ntpserver0=10.86.1.1, ntpserver1=10.86.2.1
  364. [ 6.301026] Freeing unused kernel memory: 212K
  365. [ 6.304683] This architecture does not have kernel memory protection.
  366. [ 6.311121] Run /init as init process
  367. _ _
  368. | ||_|
  369. | | _ ____ _ _ _ _
  370. | || | _ \| | | |\ \/ /
  371. | || | | | | |_| |/ \
  372. |_||_|_| |_|\____|\_/\_/
  373. Busybox Rootfs
  374. Please press Enter to activate this console.
  375. / #