From 544bc2693a515b5fa72c767d637a9f99f998a572 Mon Sep 17 00:00:00 2001 From: Hung-Te Lin Date: Sat, 28 Sep 2019 10:23:28 +0800 Subject: util/chromeos: revise description for more utility scripts in future The description.md and README.md was explicitly made for downloading or extracting some resources, but we need to add more Chrome OS related scripts soon; so the description should be revised. Also changed README.md for better markdown style, for example - Use #, ## to replace the old '-' headers - Use code format for file names - Use code block for example of shell execution Change-Id: Icc3677fa318b03f4aee1b0f5fb13b2095f2afe64 Signed-off-by: Hung-Te Lin Reviewed-on: https://review.coreboot.org/c/coreboot/+/35664 Tested-by: build bot (Jenkins) Reviewed-by: Patrick Georgi --- util/chromeos/README.md | 25 +++++++++++++------------ util/chromeos/description.md | 6 +++--- 2 files changed, 16 insertions(+), 15 deletions(-) diff --git a/util/chromeos/README.md b/util/chromeos/README.md index 3c3d721a3c..7a3897d8a0 100644 --- a/util/chromeos/README.md +++ b/util/chromeos/README.md @@ -1,27 +1,28 @@ -Chrome OS binary extraction -=========================== +# Chrome OS Scripts -These scripts can be used to extract System Agent reference code -and other blobs (e.g. mrc.bin, refcode, VGA option roms) from a -Chrome OS recovery image. +These scripts can be used to access or generate Chrome OS resources, for example +to extract System Agent reference code and other blobs (e.g. `mrc.bin`, refcode, +VGA option roms) from a Chrome OS recovery image. -crosfirmware.sh ---------------- +## crosfirmware.sh -crosfirmware.sh downloads a Chrome OS recovery image from the recovery +`crosfirmware.sh` downloads a Chrome OS recovery image from the recovery image server, unpacks it, extracts the firmware update shell archive, extracts the firmware images from the shell archive. To download all Chrome OS firmware images, run +``` $ ./crosfirmware.sh +``` To download, e.g. the Panther firmware image, run +``` $ ./crosfirmware.sh panther +``` -extract_blobs.sh ----------------- +## extract_blobs.sh -extract_blobs.sh extracts the blobs from a Chrome OS firmware image. +`extract_blobs.sh` extracts the blobs from a Chrome OS firmware image. Right now it will produce the ME firmware blob, IFD, VGA option rom, -and mrc.bin +and `mrc.bin`. diff --git a/util/chromeos/description.md b/util/chromeos/description.md index d2da57770e..840e58927e 100644 --- a/util/chromeos/description.md +++ b/util/chromeos/description.md @@ -1,3 +1,3 @@ -These scripts can be used to extract System Agent reference code and -other blobs (e.g. mrc.bin, refcode, VGA option roms) from a Chrome OS -recovery image. `C` +These scripts can be used to access Chrome OS resources, for example to extract +System Agent reference code and other blobs (e.g. mrc.bin, refcode, VGA option +roms) from a Chrome OS recovery image. `C` -- cgit v1.2.3