]> git.proxmox.com Git - mirror_edk2.git/commitdiff
Add more details to OvmfPkg/README for building & running.
authorjljusten <jljusten@6f19259b-4bc3-4df7-8a09-765794883524>
Thu, 28 May 2009 18:02:25 +0000 (18:02 +0000)
committerjljusten <jljusten@6f19259b-4bc3-4df7-8a09-765794883524>
Thu, 28 May 2009 18:02:25 +0000 (18:02 +0000)
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8402 6f19259b-4bc3-4df7-8a09-765794883524

OvmfPkg/README

index 3e761444a8dc13b97f5f87a82c8d7c866627d500..96e115b87769ad5aa4bf616ad96d254388092611 100644 (file)
@@ -23,3 +23,38 @@ Current capabilities:
 * Stabilize UEFI Linux boot\r
 * Test/Stabilize UEFI Self-Certification Tests (SCT) results\r
 \r
+=== BUILDING OVMF ===\r
+\r
+Pre-requisites:\r
+* Build environment capable of build the edk2 MdeModulePkg.\r
+* A properly configured ASL compiler\r
+  * Intel ASL compiler: Available from http://www.acpica.org\r
+      or\r
+  * Microsoft ASL compiler: Available from http://www.acpi.info\r
+\r
+Update Conf/target.txt ACTIVE_PLATFORM for OVMF:\r
+                             PEI arch   DXE arch   UEFI interfaces\r
+* OvmfPkg/OvmfPkgIa32.dsc      IA32       IA32           IA32\r
+* OvmfPkg/OvmfPkgIa32X64.dsc   IA32       X64            X64\r
+* OvmfPkg/OvmfPkgX64.dsc       X64        X64            X64\r
+\r
+Following the edk2 build process, you will find OVMF.fd at:\r
+$WORKSPACE/Build/*/*/FV/OVMF.fd\r
+\r
+=== RUNNING OVMF on QEMU ===\r
+\r
+* QEMU 0.9.1 or later is required.\r
+* Either copy, rename or symlink OVMF.fd => bios.bin\r
+* Be sure to use qemu-system-x86_64, if you are using and X64 firmware.\r
+  (qemu-system-x86_64 works for the IA32 firmware as well, of course.)\r
+* Use the QEMU -L parameter to specify the directory where bios.bin\r
+  is located.\r
+* If QEMU returns an error about not finding a video bios, you can\r
+  try creating an empty copy of the video bios file, or copy the\r
+  video bios from QEMU's BIOS directory.\r
+* Optionally you can use the QEMU -serial command to capture the\r
+  OVMF debug messages.  For example: -serial file:serial.log\r
+* The EFI shell is built into OVMF builds at this time, so it should\r
+  run automatically if a UEFI boot application is not found on the\r
+  removable media.\r
+\r