OvmfPkg/README

   1
   2 === OVMF OVERVIEW ===
   3
   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:
   7
   8   https://edk2.tianocore.org/OVMF.html
   9
  10 === STATUS ===
  11
  12 Current status: Alpha
  13
  14 Current capabilities:
  15 * IA32 and X64 architectures
  16 * QEMU (0.9.1 or later)
  17   - Video, keyboard, IDE, CD-ROM, serial
  18   - Runs UEFI shell
  19 * UEFI Linux has booted (but is not stable)
  20
  21 === FUTURE PLANS ===
  22
  23 * Stabilize UEFI Linux boot
  24 * Test/Stabilize UEFI Self-Certification Tests (SCT) results
  25
  26 === BUILDING OVMF ===
  27
  28 Pre-requisites:
  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
  32       or
  33   * Microsoft ASL compiler: Available from http://www.acpi.info
  34
  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
  40
  41 Following the edk2 build process, you will find OVMF.fd at:
  42 $WORKSPACE/Build/*/*/FV/OVMF.fd
  43
  44 === RUNNING OVMF on QEMU ===
  45
  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
  51   is located.
  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
  59   removable media.
  60