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 http://sourceforge.net/apps/mediawiki/tianocore/index.php?title=OVMF
   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 Update Conf/target.txt TARGET_ARCH based on the .dsc file:
  42                              TARGET_ARCH
  43 * OvmfPkg/OvmfPkgIa32.dsc     IA32
  44 * OvmfPkg/OvmfPkgIa32X64.dsc  IA32 X64
  45 * OvmfPkg/OvmfPkgX64.dsc      X64
  46
  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
  50 these binary outputs:
  51 * OVMF.Fv
  52   * Please note!  This filename has changed.  Older releases used OVMF.fd.
  53 * CirrusLogic5446.rom
  54
  55 More information on building OVMF can be found at:
  56
  57 http://sourceforge.net/apps/mediawiki/tianocore/index.php?title=How_to_build_OVMF
  58
  59 === RUNNING OVMF on QEMU ===
  60
  61 * QEMU 0.9.1 or later is required.
  62 * Either copy, rename or symlink OVMF.Fv => bios.bin
  63 * Either copy, rename or symlink CirrusLogic5446.rom => vgabios-cirrus.bin
  64 * Be sure to use qemu-system-x86_64, if you are using and X64 firmware.
  65   (qemu-system-x86_64 works for the IA32 firmware as well, of course.)
  66 * Use the QEMU -L parameter to specify the directory where the bios.bin
  67   and vgabios-cirrus.bin files are located.
  68 * Optionally you can use the QEMU -serial command to capture the
  69   OVMF debug messages.  For example: -serial file:serial.log
  70 * The EFI shell is built into OVMF builds at this time, so it should
  71   run automatically if a UEFI boot application is not found on the
  72   removable media.
  73 * On Linux, newer version of QEMU may enable KVM feature, and this might cause OVMF
  74   to fail to boot.  The QEMU '-no-kvm' may allow OVMF to boot.
  75