diff options
| author | Stafford Horne <shorne@gmail.com> | 2022-07-01 08:29:17 +0900 |
|---|---|---|
| committer | Stafford Horne <shorne@gmail.com> | 2022-09-04 07:02:57 +0100 |
| commit | b14df228d7c4fe6e86e7f8a4998e9ccf4967b678 (patch) | |
| tree | 1e7235fb2cae6d8fa14dc8e4d9ff27b04de03fae /docs/system/openrisc/virt.rst | |
| parent | c6fe3e6b4cd8d7b98ea37bf37fb3686ecd1304fe (diff) | |
| download | focaccia-qemu-b14df228d7c4fe6e86e7f8a4998e9ccf4967b678.tar.gz focaccia-qemu-b14df228d7c4fe6e86e7f8a4998e9ccf4967b678.zip | |
docs/system: openrisc: Add OpenRISC documentation
Reviewed-by: Richard Henderson <richard.henderson@linaro.org> Signed-off-by: Stafford Horne <shorne@gmail.com>
Diffstat (limited to 'docs/system/openrisc/virt.rst')
| -rw-r--r-- | docs/system/openrisc/virt.rst | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/docs/system/openrisc/virt.rst b/docs/system/openrisc/virt.rst new file mode 100644 index 0000000000..2fe61ac942 --- /dev/null +++ b/docs/system/openrisc/virt.rst @@ -0,0 +1,50 @@ +'virt' generic virtual platform +=============================== + +The ``virt`` board is a platform which does not correspond to any +real hardware; it is designed for use in virtual machines. +It is the recommended board type if you simply want to run +a guest such as Linux and do not care about reproducing the +idiosyncrasies and limitations of a particular bit of real-world +hardware. + +Supported devices +----------------- + + * PCI/PCIe devices + * 8 virtio-mmio transport devices + * 16550A UART + * Goldfish RTC + * SiFive Test device for poweroff and reboot + * SMP (OpenRISC multicore using ompic) + +Boot options +------------ + +The virt machine can be started using the ``-kernel`` and ``-initrd`` options +to load a Linux kernel and optional disk image. For example: + +.. code-block:: bash + + $ qemu-system-or1k -cpu or1220 -M or1k-sim -nographic \ + -device virtio-net-device,netdev=user -netdev user,id=user,net=10.9.0.1/24,host=10.9.0.100 \ + -device virtio-blk-device,drive=d0 -drive file=virt.qcow2,id=d0,if=none,format=qcow2 \ + -kernel vmlinux \ + -initrd initramfs.cpio.gz \ + -m 128 + +Linux guest kernel configuration +"""""""""""""""""""""""""""""""" + +The 'virt_defconfig' for Linux openrisc kernels includes the right drivers for +the ``virt`` machine. + +Hardware configuration information +"""""""""""""""""""""""""""""""""" + +The ``virt`` board automatically generates a device tree blob ("dtb") which it +passes to the guest. This provides information about the addresses, interrupt +lines and other configuration of the various devices in the system. + +The location of the DTB will be passed in register ``r3`` to the guest operating +system. |