aboutsummaryrefslogtreecommitdiff
path: root/board/pc
diff options
context:
space:
mode:
authorGravatar Erico Nunes <nunes.erico@gmail.com>2017-10-22 15:54:25 +0200
committerGravatar Thomas Petazzoni <thomas.petazzoni@free-electrons.com>2017-10-22 16:29:07 +0200
commitdd3766316124892fbe6391793b88fd45b482fddf (patch)
tree1a47b0833662ae45337dd70665630a3205f7f5d5 /board/pc
parent6fab2432375cb2ba0f9aa1af4de55d43afae68a9 (diff)
downloadbuildroot-dd3766316124892fbe6391793b88fd45b482fddf.tar.gz
buildroot-dd3766316124892fbe6391793b88fd45b482fddf.tar.bz2
board/pc: add documentation for testing with qemu
Add some documentation about running the pc defconfigs in qemu. In particular, document the use of the -bios parameter to use the OVMF firmware to test the UEFI image. Signed-off-by: Erico Nunes <nunes.erico@gmail.com> Cc: Peter Korsgaard <peter@korsgaard.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Diffstat (limited to 'board/pc')
-rw-r--r--board/pc/readme.txt41
1 files changed, 41 insertions, 0 deletions
diff --git a/board/pc/readme.txt b/board/pc/readme.txt
index 68ca21166f..ca3b5123c1 100644
--- a/board/pc/readme.txt
+++ b/board/pc/readme.txt
@@ -35,3 +35,44 @@ Bare PC sample config
the setup as well.
3. Enjoy
+
+Emulation in qemu (BIOS)
+========================
+
+1. Edit grub-bios.cfg
+
+ Since the driver will show up in the virtual machine as /dev/vda,
+ change board/pc/grub-bios.cfg to use root=/dev/vda2 instead of
+ root=/dev/sda2. Then rebuild grub2 and the image.
+
+2. Run the emulation with:
+
+qemu-system-x86_64 \
+ -M pc \
+ -drive file=output/images/disk.img,if=virtio,format=raw \
+ -net nic,model=virtio \
+ -net user
+
+
+Emulation in qemu (UEFI)
+========================
+
+1. Edit grub-efi.cfg
+
+ Since the driver will show up in the virtual machine as /dev/vda,
+ change board/pc/grub-efi.cfg to use root=/dev/vda2 instead of
+ root=/dev/sda2. Then rebuild grub2 and the image.
+
+2. Run the emulation with:
+
+qemu-system-x86_64 \
+ -M pc \
+ -bios </path/to/OVMF_CODE.fd> \
+ -drive file=output/images/disk.img,if=virtio,format=raw \
+ -net nic,model=virtio \
+ -net user
+
+Note that </path/to/OVMF.fd> needs to point to a valid x86_64 UEFI
+firmware image for qemu. It may be provided by your distribution as a
+edk2 or OVMF package, in path such as
+/usr/share/edk2/ovmf/OVMF_CODE.fd .