
On Mon, 24 Jul 2023 at 04:04, Heinrich Schuchardt heinrich.schuchardt@canonical.com wrote:
- Add a new page about the emulation of block devices
- Add semihosting to the emulation index page
- Set toc maxdepth to 1 to improve readability
Signed-off-by: Heinrich Schuchardt heinrich.schuchardt@canonical.com
doc/board/emulation/blkdev.rst | 38 ++++++++++++++++++++++++++++++++++ doc/board/emulation/index.rst | 4 +++- 2 files changed, 41 insertions(+), 1 deletion(-) create mode 100644 doc/board/emulation/blkdev.rst
Reviewed-by: Simon Glass sjg@chromium.org
diff --git a/doc/board/emulation/blkdev.rst b/doc/board/emulation/blkdev.rst new file mode 100644 index 0000000000..dc83a00526 --- /dev/null +++ b/doc/board/emulation/blkdev.rst @@ -0,0 +1,38 @@ +.. 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 \
-device sd-card,drive=MMC1 \
-drive if=none,file=disk.img,format=raw,id=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
diff --git a/doc/board/emulation/index.rst b/doc/board/emulation/index.rst index b5b6c3fa0d..932c65adeb 100644 --- a/doc/board/emulation/index.rst +++ b/doc/board/emulation/index.rst @@ -4,8 +4,10 @@ Emulation =========
.. toctree::
- :maxdepth: 2
:maxdepth: 1
blkdev
../../usage/semihosting qemu-arm qemu-mips qemu-ppce500
-- 2.40.1