| 49ba9447 |
1 | \r |
| 2 | === OVMF OVERVIEW ===\r |
| 3 | \r |
| 4 | The Open Virtual Machine Firmware (OVMF) project aims\r |
| 5 | to support firmware for Virtual Machines using the edk2\r |
| 6 | code base. More information can be found at:\r |
| 7 | \r |
| 8 | https://edk2.tianocore.org/OVMF.html\r |
| 9 | \r |
| 10 | === STATUS ===\r |
| 11 | \r |
| 12 | Current status: Alpha\r |
| 13 | \r |
| 14 | Current capabilities:\r |
| 15 | * IA32 and X64 architectures\r |
| 16 | * QEMU (0.9.1 or later)\r |
| 17 | - Video, keyboard, IDE, CD-ROM, serial\r |
| 18 | - Runs UEFI shell\r |
| 19 | * UEFI Linux has booted (but is not stable)\r |
| 20 | \r |
| 21 | === FUTURE PLANS ===\r |
| 22 | \r |
| 23 | * Stabilize UEFI Linux boot\r |
| 24 | * Test/Stabilize UEFI Self-Certification Tests (SCT) results\r |
| 25 | \r |
| 37e97c51 |
26 | === BUILDING OVMF ===\r |
| 27 | \r |
| 28 | Pre-requisites:\r |
| 29 | * Build environment capable of build the edk2 MdeModulePkg.\r |
| 30 | * A properly configured ASL compiler\r |
| 31 | * Intel ASL compiler: Available from http://www.acpica.org\r |
| 32 | or\r |
| 33 | * Microsoft ASL compiler: Available from http://www.acpi.info\r |
| 34 | \r |
| 35 | Update Conf/target.txt ACTIVE_PLATFORM for OVMF:\r |
| 36 | PEI arch DXE arch UEFI interfaces\r |
| 37 | * OvmfPkg/OvmfPkgIa32.dsc IA32 IA32 IA32\r |
| 38 | * OvmfPkg/OvmfPkgIa32X64.dsc IA32 X64 X64\r |
| 39 | * OvmfPkg/OvmfPkgX64.dsc X64 X64 X64\r |
| 40 | \r |
| 41 | Following the edk2 build process, you will find OVMF.fd at:\r |
| 42 | $WORKSPACE/Build/*/*/FV/OVMF.fd\r |
| 43 | \r |
| 44 | === RUNNING OVMF on QEMU ===\r |
| 45 | \r |
| 46 | * QEMU 0.9.1 or later is required.\r |
| 47 | * Either copy, rename or symlink OVMF.fd => bios.bin\r |
| 48 | * Be sure to use qemu-system-x86_64, if you are using and X64 firmware.\r |
| 49 | (qemu-system-x86_64 works for the IA32 firmware as well, of course.)\r |
| 50 | * Use the QEMU -L parameter to specify the directory where bios.bin\r |
| 51 | is located.\r |
| 52 | * If QEMU returns an error about not finding a video bios, you can\r |
| 53 | try creating an empty copy of the video bios file, or copy the\r |
| 54 | video bios from QEMU's BIOS directory.\r |
| 55 | * Optionally you can use the QEMU -serial command to capture the\r |
| 56 | OVMF debug messages. For example: -serial file:serial.log\r |
| 57 | * The EFI shell is built into OVMF builds at this time, so it should\r |
| 58 | run automatically if a UEFI boot application is not found on the\r |
| 59 | removable media.\r |
| 60 | \r |
projects / mirror_edk2.git / blame