4 The Open Virtual Machine Firmware (OVMF) project aims
5 to support firmware for Virtual Machines using the edk2
6 code base. More information can be found at:
8 https://edk2.tianocore.org/OVMF.html
15 * IA32 and X64 architectures
16 * QEMU (0.9.1 or later)
17 - Video, keyboard, IDE, CD-ROM, serial
19 * UEFI Linux has booted (but is not stable)
23 * Stabilize UEFI Linux boot
24 * Test/Stabilize UEFI Self-Certification Tests (SCT) results
29 * Build environment capable of build the edk2 MdeModulePkg.
30 * A properly configured ASL compiler
31 * Intel ASL compiler: Available from http://www.acpica.org
33 * Microsoft ASL compiler: Available from http://www.acpi.info
35 Update Conf/target.txt ACTIVE_PLATFORM for OVMF:
36 PEI arch DXE arch UEFI interfaces
37 * OvmfPkg/OvmfPkgIa32.dsc IA32 IA32 IA32
38 * OvmfPkg/OvmfPkgIa32X64.dsc IA32 X64 X64
39 * OvmfPkg/OvmfPkgX64.dsc X64 X64 X64
41 Update Conf/target.txt TARGET_ARCH based on the .dsc file:
43 * OvmfPkg/OvmfPkgIa32.dsc IA32
44 * OvmfPkg/OvmfPkgIa32X64.dsc IA32 X64
45 * OvmfPkg/OvmfPkgX64.dsc X64
47 Following the edk2 build process, you will find the OVMF binaries
48 under the $WORKSPACE/Build/*/*/FV directory. The actual path will
49 depend on how your build is configured. You can expect to find
54 More information on building OVMF can be found at:
55 * https://edk2.tianocore.org/build-ovmf.html
57 === RUNNING OVMF on QEMU ===
59 * QEMU 0.9.1 or later is required.
60 * Either copy, rename or symlink OVMF.fd => bios.bin
61 * Either copy, rename or symlink CirrusLogic5446.rom => vgabios-cirrus.bin
62 * Be sure to use qemu-system-x86_64, if you are using and X64 firmware.
63 (qemu-system-x86_64 works for the IA32 firmware as well, of course.)
64 * Use the QEMU -L parameter to specify the directory where the bios.bin
65 and vgabios-cirrus.bin files are located.
66 * Optionally you can use the QEMU -serial command to capture the
67 OVMF debug messages. For example: -serial file:serial.log
68 * The EFI shell is built into OVMF builds at this time, so it should
69 run automatically if a UEFI boot application is not found on the