From 4ff5a94eb974a783081ee358966b2022aaf1fb20 Mon Sep 17 00:00:00 2001
From: Francis Rowe <info@gluglug.org.uk>
Date: Sun, 28 Dec 2014 17:33:50 +0000
Subject: ich9deblob: added ich9gen utility

This can generate the descriptor+gbe images from scratch, without
the need for a factory.bin dump.
---
 docs/hcl/x200_remove_me.html | 59 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

(limited to 'docs/hcl/x200_remove_me.html')

diff --git a/docs/hcl/x200_remove_me.html b/docs/hcl/x200_remove_me.html
index 0cef79b4..532b4990 100644
--- a/docs/hcl/x200_remove_me.html
+++ b/docs/hcl/x200_remove_me.html
@@ -28,6 +28,49 @@
 			Or <a href="x200.html">back to main X200 compatibility page (x200.html)</a>.
 		</p>
 
+<hr/>
+
+	<h1 id="ich9gen">ICH9 gen utility</h1>
+	
+		<p>
+			It is no longer necessary to use <a href="#ich9deblob">ich9deblob</a> to generate
+			a deblobbed descriptor+gme image for the X200. ich9gen is a small utility within
+			ich9deblob that can generate them from scratch, without a factory.bin dump.
+		</p>
+		
+		<p>
+			Run:<br/>
+			$ <b>./ich9gen</b>
+		</p>
+		
+		<p>
+			Two new files will be created:
+		</p>
+			<ul>
+				<li>ich9fdgbe_4m.bin: this is for X200 laptops with the 4MB flash chip.</li>
+				<li>ich9fdgbe_8m.bin: this is for X200 laptops with the 8MB flash chip.</li>
+			</ul>
+			
+		<p>
+			ich9gen executables can be found under ./ich9gen/ statically compiled in
+			libreboot_bin. If you are using src or git, build ich9gen from source with:<br/>
+			$ <b>./builddeps-ich9deblob</b><br/>
+			The executable will appear under resources/utilities/ich9deblob/
+		</p>
+		
+		<p>
+			Assuming that your X200 libreboot image is named <b>libreboot.rom</b>, copy
+			the file to where <b>libreboot.rom</b> is located
+			and then run, for instance:<br/>
+			$ <b>dd if=ich9fdgbe_8m.bin of=libreboot.rom bs=1 count=12k conv=notrunc</b><br/>
+			or:<br/>
+			$ <b>dd if=ich9fdgbe_4m.bin of=libreboot.rom bs=1 count=12k conv=notrunc</b>
+		</p>
+		
+		<p>
+			Your X200 libreboot.rom image is now ready to be flashed on the machine.
+		</p>
+
 <hr/>
 
 	<h1 id="ich9deblob">ICH9 deblob utility</h1>
@@ -66,6 +109,22 @@
 			$ <b>dd if=deblobbed_descriptor.bin of=libreboot.rom bs=1 count=12k conv=notrunc</b>
 		</p>
 		
+		<p>
+			The utility will also generate 4 additional files:
+		</p>
+			<ul>
+				<li>mkdescriptor.c</li>
+				<li>mkdescriptor.h</li>
+				<li>mkgbe.c</li>
+				<li>mkgbe.h</li>
+			</ul>
+		<p>
+			These are C source files that can re-generate the very same Gbe and Descriptor structs
+			(from ich9deblob/ich9gen). To use these, place them in src/ich9gen/ in ich9deblob, then re-build. 
+			The newly built <b>ich9gen</b> executable will be able to re-create the very same 12KiB file from scratch,
+			based on the C structs, this time <b>without</b> the need for a factory.rom dump!
+		</p>
+		
 		<p>
 			You should now have a <b>libreboot.rom</b> image containing the correct 4K descriptor and 8K gbe regions, which
 			will then be safe to flash. Refer back to <a href="../install/index.html#flashrom_x200">../install/index.html#flashrom_x200</a>
-- 
cgit v1.2.3-70-g09d2