From 17a6750abe2355fd7a418fd392983ea0895d2d9a Mon Sep 17 00:00:00 2001 From: Ahmad Fatoum Date: Sun, 28 Feb 2021 20:08:35 +0100 Subject: virtio: support virtio-based device drivers over PCI This driver provides support for virtio based paravirtual device drivers over PCI. This is useful with Qemu for boards that barebox has PCI support for, e.g. MIPS Malta. Signed-off-by: Ahmad Fatoum Signed-off-by: Sascha Hauer --- Documentation/user/virtio.rst | 30 +++++++++++++++++------------- 1 file changed, 17 insertions(+), 13 deletions(-) (limited to 'Documentation') diff --git a/Documentation/user/virtio.rst b/Documentation/user/virtio.rst index 5d2a8c8208..7e125c0ca8 100644 --- a/Documentation/user/virtio.rst +++ b/Documentation/user/virtio.rst @@ -20,7 +20,7 @@ just the guest's device driver "knows" it is running in a virtual environment, and cooperates with the hypervisor. This enables guests to get high performance network and disk operations, and gives most of the performance benefits of paravirtualization. In the barebox case, the guest is barebox itself, while the -virtual environment will normally be QEMU_ targets like ARM, RISC-V and x86. +virtual environment will normally be QEMU_ targets like ARM, MIPS, RISC-V or x86. Status ------ @@ -31,8 +31,8 @@ embedded devices models like ARM/RISC-V, which does not normally come with PCI support might use simple memory mapped device (MMIO) instead of the PCI device. The memory mapped virtio device behaviour is based on the PCI device specification. Therefore most operations including device initialization, -queues configuration and buffer transfers are nearly identical. Only MMIO -is currently supported in barebox. +queues configuration and buffer transfers are nearly identical. Both MMIO +and non-legacy PCI are supported in barebox. The VirtIO spec defines a lots of VirtIO device types, however at present only block, console and RNG devices are supported. @@ -67,16 +67,20 @@ to pass barebox a fixed-up device tree describing the ``virtio-mmio`` rings. Except for the console, multiple instances of a VirtIO device can be created -by appending more '-device' parameters. For example to create one HWRNG -and 2 block devices:: - - $ qemu-system-arm -m 256M -M virt -nographic \ - -kernel ./images/barebox-dt-2nd.img \ - -device virtio-rng-device \ - -drive if=none,file=/tmp/first.hdimg,format=raw,id=hd0 \ - -device virtio-blk-device,drive=hd0 \ - -drive if=none,file=/tmp/second.hdimg,format=raw,id=hd1 \ - -device virtio-blk-device,drive=hd1 +by appending more '-device' parameters. For example to extend a MIPS +malta VM with one HWRNG and 2 block VirtIO PCI devices:: + + $ qemu-system-mips -m 256M -M malta -serial stdio \ + -bios ./images/barebox-qemu-malta.img -monitor null \ + -device virtio-rng-pci,disable-legacy=on \ + -drive if=none,file=image1.hdimg,format=raw,id=hd0 \ + -device virtio-blk-pci,drive=hd0,disable-legacy=on \ + -drive if=none,file=image2.hdimg,format=raw,id=hd1 \ + -device virtio-blk-pci,drive=hd1,disable-legacy=on + +Note the use of ``disable-legacy=on``. barebox doesn't support legacy +or transitional VirtIO devices. Some versions of QEMU may need to +have ``,disable-modern=off`` specfied as well. .. _VirtIO: http://docs.oasis-open.org/virtio/virtio/v1.0/virtio-v1.0.pdf .. _qemu: https://www.qemu.org -- cgit v1.2.3