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 Following the edk2 build process, you will find OVMF.fd at:
42 $WORKSPACE/Build/*/*/FV/OVMF.fd
44 === RUNNING OVMF on QEMU ===
46 * QEMU 0.9.1 or later is required.
47 * Either copy, rename or symlink OVMF.fd => bios.bin
48 * Be sure to use qemu-system-x86_64, if you are using and X64 firmware.
49 (qemu-system-x86_64 works for the IA32 firmware as well, of course.)
50 * Use the QEMU -L parameter to specify the directory where bios.bin
52 * If QEMU returns an error about not finding a video bios, you can
53 try creating an empty copy of the video bios file, or copy the
54 video bios from QEMU's BIOS directory.
55 * Optionally you can use the QEMU -serial command to capture the
56 OVMF debug messages. For example: -serial file:serial.log
57 * The EFI shell is built into OVMF builds at this time, so it should
58 run automatically if a UEFI boot application is not found on the