ich9deblob: added ich9gen utility

This can generate the descriptor+gbe images from scratch, without
the need for a factory.bin dump.

2 files changed, 62 insertions, 0 deletions

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
@@ -30,6 +30,49 @@
 
 <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>
 	
 		<p>
@@ -67,6 +110,22 @@
 		</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>
 			for how to flash it.
diff --git a/docs/release.html b/docs/release.html
index e99947ed..24c68079 100644
--- a/docs/release.html
+++ b/docs/release.html
@@ -120,6 +120,9 @@
 			Changes for this release (latest changes first, earliest changes last)
 		</h2>
 			<ul>
+				<li>ich9deblob: added new utility <b>ich9gen</b>: this can generate a descriptor+gbe image without a factory.rom dump present.</li>
+				<li>Modified ich9deblob to use a struct for Gbe, documenting everything.</li>
+				<li>Massively updated the ich9deblob utility: re-factored everything completely.</li>
 				<li>Enabled cstates 1 and 2 on macbook21. This reduces idle heat / power consumption.</li>
 				<li>buildrom-withgrub: disabled creation of *txtmode*.rom for X200 (only framebuffer graphics work)</li>
 				<li>Updated SeaBIOS (again)</li>