From 8319b87ffe2e9b89a69223c088c9a33786e9d486 Mon Sep 17 00:00:00 2001
From: Francis Rowe <info@gluglug.org.uk>
Date: Fri, 30 Jan 2015 04:59:16 +0000
Subject: Add QEMU (i440fx/piix4) support to libreboot

---
 docs/git/index.html     | 35 ++++++++++++++++++++++++++++++++++-
 docs/install/index.html | 10 ++++++++++
 2 files changed, 44 insertions(+), 1 deletion(-)

(limited to 'docs')

diff --git a/docs/git/index.html b/docs/git/index.html
index 81645032..fb6882b7 100644
--- a/docs/git/index.html
+++ b/docs/git/index.html
@@ -35,6 +35,7 @@
 					<li><a href="#config_t60">ThinkPad T60</a></li>
 					<li><a href="#config_x200">ThinkPad X200</a></li>
 					<li><a href="#config_macbook21">MacBook2,1</a></li>
+					<li><a href="#config_qemu_i440fx_piix4">QEMU (x86 i440fx/piix4)</a></li>
 				</ul>
 			</li>
 			<li><a href="#build">How to build the ROM images</a></li>
@@ -445,6 +446,38 @@
 				The resulting .config file was saved as resources/libreboot/config/<b>macbook21/config</b> and is used by the build
 				scripts for this machine. <b>This config is also used for the MacBook1,1</b>.
 			</p>
+			
+		<h2 id="config_qemu_i440fx_piix4">
+			QEMU (x86 i440fx/piix4) configuration (file: resources/libreboot/config/qemu_i440fx_piix4/config)
+		</h2>
+			<ul>
+				<li>General / Expert mode = <i>enable</i></li>
+				<li>Mainboard / Mainboard vendor = <i>Emulation</i></li>
+				<li>Mainboard / Mainboard model = <i>QEMU x86 i440fx/piix4 (aka qemu -M pc)</i></li>
+				<li>Mainboard / ROM chip size = <i>8192 KB (8 MB)</i></li>
+				<li>Devices / Use native graphics initialization = <i>enable</i> (should already be enabled)</li>
+				<li>
+					Display / Keep VESA framebuffer = <i>enable</i> (disable for text-mode graphics, enable for coreboot vesa framebuffer)
+					<ul>
+						<li>Libreboot provides this with framebuffer enabled by default, but it automatically patches a copy of the config at build time
+						to enable coreboot text-mode for a separate set of ROM images, in each machine.</li>
+					</ul>
+				</li>
+				<li>Console / Send console output to a CBMEM buffer = <i>enable</i></li>
+				<li>Payload / Add a payload = <i>An ELF executable payload</i></li>
+				<li>Payload / Payload path and filename = <i>grub.elf</i></li>
+			</ul>
+			<p>
+				Go back and disable option ROMs:
+			</p>
+			<ul>
+				<li>Devices / Run VGA Option ROMs = <i>disable</i></li>
+				<li>Devices / Run Option ROMs on PCI devices = <i>disable</i></li>
+			</ul>
+			<p>
+				The resulting .config file was saved as resources/libreboot/config/<b>macbook21/config</b> and is used by the build
+				scripts for this machine. <b>This config is also used for the MacBook1,1</b>.
+			</p>
 
 		<p><a href="#pagetop">Back to top of page.</a></p>
 
@@ -579,7 +612,7 @@
 <hr/>
 
 	<p>
-		Copyright &copy; 2014 Francis Rowe &lt;info@gluglug.org.uk&gt;<br/>
+		Copyright &copy; 2014, 2015 Francis Rowe &lt;info@gluglug.org.uk&gt;<br/>
 		This document is released under the Creative Commons Attribution-ShareAlike 4.0 International Public License and all future versions.
 		A copy of the license can be found at <a href="../license.txt">../license.txt</a>.
 	</p>
diff --git a/docs/install/index.html b/docs/install/index.html
index e5d8f651..ab3e1307 100644
--- a/docs/install/index.html
+++ b/docs/install/index.html
@@ -26,6 +26,7 @@
 			</ul>
 		<h2>Installing libreboot (software)</h2>
 			<ul>
+				<li><a href="#qemu">QEMU</a></li>
 				<li><a href="#rom">Recommended ROMs to flash</a></li>
 				<li><a href="#flashrom_lenovobios">X60/X60S/X60T/T60: How to flash your ROM (if running Lenovo BIOS firmware)</a></li>
 				<li><a href="#flashrom_macbook21">macbook21: How to flash your ROM (if running Apple EFI firmware)</a></li>
@@ -39,6 +40,15 @@
 				<li><a href="t60_unbrick.html">ThinkPad T60: How to unbrick</a></li>
 				<li><a href="x200_external.html">ThinkPad X200: How to unbrick</a> (also the initial installation guide for this machine)</li>
 			</ul>
+			
+<hr/>
+
+	<h1 id="qemu">QEMU</h1>
+	
+		<p>
+			You don't really do anything here, just run (example):<br/>
+			$ <b>qemu-system-i386 -m 512 -bios qemu_i440fx_piix4_ukdvorak_vesafb.rom</b>
+		</p>
 
 <hr/>
 
-- 
cgit v1.2.3-70-g09d2