mirror of
https://github.com/Fishwaldo/opensbi.git
synced 2025-03-27 17:21:37 +00:00
82fd42fcce
Remove the unnecessary blank line at the end of the doc. Signed-off-by: Bin Meng <bmeng.cn@gmail.com> Reviewed-by: Anup Patel <anup.patel@wdc.com>
151 lines
3.8 KiB
Markdown
151 lines
3.8 KiB
Markdown
QEMU RISC-V Virt Machine Platform
|
|
=================================
|
|
|
|
The **QEMU RISC-V Virt Machine** is a virtual platform created for RISC-V
|
|
software development and testing. It is also referred to as
|
|
*QEMU RISC-V VirtIO machine* because it uses VirtIO devices for network,
|
|
storage, and other types of IO.
|
|
|
|
To build the platform-specific library and firmware images, provide the
|
|
*PLATFORM=qemu/virt* parameter to the top level `make` command.
|
|
|
|
Platform Options
|
|
----------------
|
|
|
|
The *QEMU RISC-V Virt Machine* platform does not have any platform-specific
|
|
options.
|
|
|
|
Execution on QEMU RISC-V 64-bit
|
|
-------------------------------
|
|
|
|
**No Payload Case**
|
|
|
|
Build:
|
|
```
|
|
make PLATFORM=qemu/virt
|
|
```
|
|
|
|
Run:
|
|
```
|
|
qemu-system-riscv64 -M virt -m 256M -nographic \
|
|
-kernel build/platform/qemu/virt/firmware/fw_payload.elf
|
|
```
|
|
|
|
**U-Boot Payload**
|
|
|
|
Note: the command line examples here assume that U-Boot was compiled using
|
|
the `qemu-riscv64_smode_defconfig` configuration.
|
|
|
|
Build:
|
|
```
|
|
make PLATFORM=qemu/virt FW_PAYLOAD_PATH=<uboot_build_directory>/u-boot.bin
|
|
```
|
|
|
|
Run:
|
|
```
|
|
qemu-system-riscv64 -M virt -m 256M -nographic \
|
|
-kernel build/platform/qemu/virt/firmware/fw_payload.elf
|
|
```
|
|
or
|
|
```
|
|
qemu-system-riscv64 -M virt -m 256M -nographic \
|
|
-kernel build/platform/qemu/virt/firmware/fw_jump.elf \
|
|
-device loader,file=<uboot_build_directory>/u-boot.bin,addr=0x80200000
|
|
```
|
|
|
|
**Linux Kernel Payload**
|
|
|
|
Note: We assume that the Linux kernel is compiled using
|
|
*arch/riscv/configs/defconfig*.
|
|
|
|
Build:
|
|
```
|
|
make PLATFORM=qemu/virt FW_PAYLOAD_PATH=<linux_build_directory>/arch/riscv/boot/Image
|
|
```
|
|
|
|
Run:
|
|
```
|
|
qemu-system-riscv64 -M virt -m 256M -nographic \
|
|
-kernel build/platform/qemu/virt/firmware/fw_payload.elf \
|
|
-drive file=<path_to_linux_rootfs>,format=raw,id=hd0 \
|
|
-device virtio-blk-device,drive=hd0 \
|
|
-append "root=/dev/vda rw console=ttyS0"
|
|
```
|
|
or
|
|
```
|
|
qemu-system-riscv64 -M virt -m 256M -nographic \
|
|
-kernel build/platform/qemu/virt/firmware/fw_jump.elf \
|
|
-device loader,file=<linux_build_directory>/arch/riscv/boot/Image,addr=0x80200000 \
|
|
-drive file=<path_to_linux_rootfs>,format=raw,id=hd0 \
|
|
-device virtio-blk-device,drive=hd0 \
|
|
-append "root=/dev/vda rw console=ttyS0"
|
|
```
|
|
|
|
|
|
Execution on QEMU RISC-V 32-bit
|
|
-------------------------------
|
|
|
|
**No Payload Case**
|
|
|
|
Build:
|
|
```
|
|
make PLATFORM=qemu/virt
|
|
```
|
|
|
|
Run:
|
|
```
|
|
qemu-system-riscv32 -M virt -m 256M -nographic \
|
|
-kernel build/platform/qemu/virt/firmware/fw_payload.elf
|
|
```
|
|
|
|
**U-Boot Payload**
|
|
|
|
Note: the command line examples here assume that U-Boot was compiled using
|
|
the `qemu-riscv32_smode_defconfig` configuration.
|
|
|
|
Build:
|
|
```
|
|
make PLATFORM=qemu/virt FW_PAYLOAD_PATH=<uboot_build_directory>/u-boot.bin
|
|
```
|
|
|
|
Run:
|
|
```
|
|
qemu-system-riscv32 -M virt -m 256M -nographic \
|
|
-kernel build/platform/qemu/virt/firmware/fw_payload.elf
|
|
```
|
|
or
|
|
```
|
|
qemu-system-riscv32 -M virt -m 256M -nographic \
|
|
-kernel build/platform/qemu/virt/firmware/fw_jump.elf \
|
|
-device loader,file=<uboot_build_directory>/u-boot.bin,addr=0x80400000
|
|
```
|
|
|
|
**Linux Kernel Payload**
|
|
|
|
Note: We assume that the Linux kernel is compiled using
|
|
*arch/riscv/configs/rv32_defconfig* (kernel 5.1 and newer)
|
|
respectively using *arch/riscv/configs/defconfig* plus setting
|
|
CONFIG_ARCH_RV32I=y (kernel 5.0 and older).
|
|
|
|
Build:
|
|
```
|
|
make PLATFORM=qemu/virt FW_PAYLOAD_PATH=<linux_build_directory>/arch/riscv/boot/Image
|
|
```
|
|
|
|
Run:
|
|
```
|
|
qemu-system-riscv32 -M virt -m 256M -nographic \
|
|
-kernel build/platform/qemu/virt/firmware/fw_payload.elf \
|
|
-drive file=<path_to_linux_rootfs>,format=raw,id=hd0 \
|
|
-device virtio-blk-device,drive=hd0 \
|
|
-append "root=/dev/vda rw console=ttyS0"
|
|
```
|
|
or
|
|
```
|
|
qemu-system-riscv32 -M virt -m 256M -nographic \
|
|
-kernel build/platform/qemu/virt/firmware/fw_jump.elf \
|
|
-device loader,file=<linux_build_directory>/arch/riscv/boot/Image,addr=0x80400000 \
|
|
-drive file=<path_to_linux_rootfs>,format=raw,id=hd0 \
|
|
-device virtio-blk-device,drive=hd0 \
|
|
-append "root=/dev/vda rw console=ttyS0"
|
|
```
|