u-boot/doc/board/emulation/blkdev.rst
Heinrich Schuchardt ba187bd38e doc: describe QEMU virtio block device
Enhance the description of QEMU block devices

* Describe how to attach a virtio-blk device.
* Sort the command lines for MMC to match the other devices.

Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
Reviewed-by: Simon Glass <sjg@chromium.org>
2023-08-03 09:21:02 +02:00

48 lines
1 KiB
ReStructuredText

.. SPDX-License-Identifier: GPL-2.0+
Emulation of block devices
--------------------------
QEMU can emulate common block devices by adding the following parameters to
the qemu-system-<arch> command line:
* MMC
.. code-block:: bash
-device sdhci-pci,sd-spec-version=3 \
-drive if=none,file=disk.img,format=raw,id=MMC1 \
-device sd-card,drive=MMC1
* NVMe
.. code-block:: bash
-drive if=none,file=disk.img,format=raw,id=NVME1 \
-device nvme,drive=NVME1,serial=nvme-1
* SATA
.. code-block:: bash
-device ahci,id=ahci0 \
-drive if=none,file=disk.img,format=raw,id=SATA1 \
-device ide-hd,bus=ahci0.0,drive=SATA1
* USB
.. code-block:: bash
-device qemu-xhci \
-drive if=none,file=disk.img,format=raw,id=USB1 \
-device usb-storage,drive=USB1
* Virtio
.. code-block:: bash
-drive if=none,file=disk.img,format=raw,id=VIRTIO1 \
-device virtio-blk,drive=VIRTIO1
.. note::
As of v2023.07 U-Boot does not have a driver for virtio-scsi-pci.