<p>Logan Carlson has uploaded this change for <strong>review</strong>.</p><p><a href="https://review.coreboot.org/20753">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">Documentation: Added binary extraction documentation<br><br>Added documentation on how to extract binaries from a ROM image,<br>including:<br><br>- Using ifdtool to extract binaries.<br>- Using cbfstool to extract binaries.<br>- Changing menuconfig to use the extracted binaries.<br><br>Change-Id: Ia31b01afc66789f95c7d21a0d41b532bc19a6430<br>Signed-off-by: Logan Carlson <logancarlson@google.com><br>---<br>A Documentation/Binary Extraction.md<br>1 file changed, 51 insertions(+), 0 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://review.coreboot.org:29418/coreboot refs/changes/53/20753/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">diff --git a/Documentation/Binary Extraction.md b/Documentation/Binary Extraction.md<br>new file mode 100644<br>index 0000000..5407f6b<br>--- /dev/null<br>+++ b/Documentation/Binary Extraction.md<br>@@ -0,0 +1,51 @@<br>+# Binary Extraction Tutorial<br>+<br>+### Part 1: Extracting Binaries<br>+<br>+To begin extracting the binaries, first create a directory labeled "binaries"<br>+in the coreboot directory (i.e. /coreboot/binaries/).<br>+<br>+Now, execute the following commands to extract the binaries from a ROM image.<br>+**Note:** Make sure you are in the root coreboot directory.<br>+<br>+    cd util/ifdtool<br>+    ./ifdtool <ROM IMAGE><br>+    ./ifdtool -d <ROM IMAGE><br>+    ./ifdtool -x <ROM IMAGE><br>+<br>+In the above steps, <ROM IMAGE> is the name of the ROM image to extract the<br>+binaries from, including the file path (ex. /build/coreboot.rom).<br>+<br>+Copy the extracted .bin files to the binaries directory you created previously.<br>+**Note:** You may want to rename your various .bin files to more clearly<br>+indicate what they are and their purpose.<br>+<br>+To extract the mrc.bin, move to the /coreboot/build directory and run the<br>+following command:<br>+<br>+    ./cbfstool <ROM IMAGE> extract -n mrc.bin -f <DEST>/<filename><br>+<br>+where <ROM IMAGE> is the filepath to the ROM image (same image as above),<br>+<DEST> is the filepath to the destination directory and <filename> is the<br>+output filename. An example command is given below:<br>+<br>+    ./cbfstool coreboot.rom extract -n mrc.bin -f ../binaries/mrc.bin<br>+<br>+### Part 2: Changing the coreboot configuration settings<br>+<br>+From the main coreboot directory, run "make menuconfig". Select "General Setup",<br>+then select "Allow use of binary-only repository", then exit to the main menu.<br>+<br>+To configure the ROM image for the specific board you want to use and select<br>+"Mainboard". Select "Mainboard vendor" and scroll to the correct vendor. Then<br>+select "Mainboard model" and select the name of the board model. Exit back to<br>+the main menu.<br>+<br>+To add the binaries you extracted, select "Chipset". Scroll and select "Add a<br>+System Agent Binary" and set the filepath to your mrc.bin file's filepath.<br>+Scroll and select "Add Intel descriptor.bin file" and type the filepath for<br>+your descriptor.bin file. Scroll down and select "Add Intel ME/TXE firmware<br>+file" and type the filepath for your ME file. Exit to the main menu.<br>+<br>+Select "Exit", and select "Yes" if prompted to save your configuration<br>+settings.<br></pre><p>To view, visit <a href="https://review.coreboot.org/20753">change 20753</a>. To unsubscribe, visit <a href="https://review.coreboot.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://review.coreboot.org/20753"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: coreboot </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>
<div style="display:none"> Gerrit-Change-Id: Ia31b01afc66789f95c7d21a0d41b532bc19a6430 </div>
<div style="display:none"> Gerrit-Change-Number: 20753 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Logan Carlson <logancarlson@google.com> </div>