diff options
| author | Francis Rowe <info@gluglug.org.uk> | 2014-12-28 12:33:50 (EST) |
|---|---|---|
| committer | Francis Rowe <info@gluglug.org.uk> | 2014-12-28 12:33:50 (EST) |
| commit | 4ff5a94eb974a783081ee358966b2022aaf1fb20 (patch) | |
| tree | 242d67dcfcf3fb4f1f9f0f06097757ec707a7520 /docs/hcl | |
| parent | 779f26c4b48b792873438d99526ebe51c9db2565 (diff) | |
| download | libreboot-4ff5a94eb974a783081ee358966b2022aaf1fb20.zip libreboot-4ff5a94eb974a783081ee358966b2022aaf1fb20.tar.gz libreboot-4ff5a94eb974a783081ee358966b2022aaf1fb20.tar.bz2 | |
ich9deblob: added ich9gen utility
This can generate the descriptor+gbe images from scratch, without
the need for a factory.bin dump.
Diffstat (limited to 'docs/hcl')
| -rw-r--r-- | docs/hcl/x200_remove_me.html | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/docs/hcl/x200_remove_me.html b/docs/hcl/x200_remove_me.html index 0cef79b..532b499 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. |