aboutsummaryrefslogtreecommitdiff
path: root/docs/platform/qemu_sifive_u.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/platform/qemu_sifive_u.md')
-rw-r--r--docs/platform/qemu_sifive_u.md56
1 files changed, 33 insertions, 23 deletions
diff --git a/docs/platform/qemu_sifive_u.md b/docs/platform/qemu_sifive_u.md
index da1315b..b3f73d6 100644
--- a/docs/platform/qemu_sifive_u.md
+++ b/docs/platform/qemu_sifive_u.md
@@ -1,42 +1,52 @@
-QEMU SiFive Unleashed Machine
-=============================
+QEMU SiFive Unleashed Machine Platform
+======================================
-The **QEMU SiFive Unleashed Machine** is an emulation of
-SiFive Unleashed platform.
+The **QEMU SiFive Unleashed Machine** is an emulation of the SiFive Unleashed
+platform.
-To build platform specific library and firmwares, provide
-`PLATFORM=qemu/sifive_u` parameter to top-level make.
+To build this platform specific library and firmwares, provide the
+*PLATFORM=qemu/sifive_u* parameter to the top level `make` command line.
Platform Options
----------------
-We don't have any platform specific options for this platform.
+The *QEMU SiFive Unleashed Machine* platform does not have any platform specific
+options.
-Try on QEMU RISC-V 64bit
-------------------------
+Executing on QEMU RISC-V 64bit
+------------------------------
-**No Payload**
+**No Payload Case**
-*Build*:
+Build:
```
- make PLATFORM=qemu/virt
+make PLATFORM=qemu/virt
```
-*Run*:
+
+Run:
```
- qemu-system-riscv64 -M sifive_u -m 256M -display none -serial stdio -kernel build/platform/qemu/sifive_u/firmware/fw_payload.elf
+qemu-system-riscv64 -M sifive_u -m 256M -display none -serial stdio \
+ -kernel build/platform/qemu/sifive_u/firmware/fw_payload.elf
```
-**U-Boot Payload**
+**U-Boot as a Payload**
-*Note*: We assume that U-Boot is compiled using `qemu-riscv64_smode_defconfig`.
+Note: the command line examples here assume that U-Boot was compiled using
+the `qemu-riscv64_smode_defconfig` configuration.
-*Build*:
+Build:
+```
+make PLATFORM=qemu/virt FW_PAYLOAD_PATH=<uboot_build_directory>/u-boot.bin
+```
+
+Run:
+```
+qemu-system-riscv64 -M sifive_u -m 256M -display none -serial stdio \
+ -kernel build/platform/qemu/sifive_u/firmware/fw_payload.elf
```
- make PLATFORM=qemu/virt FW_PAYLOAD_PATH=<uboot_build_directory>/u-boot.bin
+or
```
-*Run*:
+qemu-system-riscv64 -M sifive_u -m 256M -display none -serial stdio \
+ -kernel build/platform/qemu/sifive_u/firmware/fw_jump.elf \
+ -device loader,file=<uboot_build_directory>/u-boot.bin,addr=0x80200000
```
- qemu-system-riscv64 -M sifive_u -m 256M -display none -serial stdio -kernel build/platform/qemu/sifive_u/firmware/fw_payload.elf
- or
- qemu-system-riscv64 -M sifive_u -m 256M -display none -serial stdio -kernel build/platform/qemu/sifive_u/firmware/fw_jump.elf -device loader,file=<uboot_build_directory>/u-boot.bin,addr=0x80200000
-``` \ No newline at end of file