coreboot-kgpe-d16/util/chromeos
Hung-Te Lin 117453e890 vboot: create board-specific test-only GBB HWID if not set
The HWID in vboot GBB is an identifier for machine model. On Chrome OS,
that should be provisioned in manufacturing process (by collecting real
hardware information), and will be checked in system startup.

For bring up developers, they usually prefer to generate a test-only
string for HWID. However that format was not well documented and cause
problems. Further more, most Chromebooks are using HWID v3+ today while
the test-only HWID is usually v2. Non-Chrome OS developers may also
prefer their own format.

To simplify development process, the GBB_CONFIG now defaults to empty
string, and will be replaced by a board-specific test-only v2 HWID
automatically. Developers can still override that in mainboard Kconfig
if they prefer v3 or other arbitrary format.

BUG=b:140067412
TEST=Built 'kukui' successfully. Removed kukui GBB config and built
     again, still seeing correct test HWID.

Change-Id: I0cda17a374641589291ec8dfb1d66c553f7cbf35
Signed-off-by: Hung-Te Lin <hungte@chromium.org>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/35634
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Patrick Georgi <pgeorgi@google.com>
2019-09-30 11:33:20 +00:00
..
README.md vboot: create board-specific test-only GBB HWID if not set 2019-09-30 11:33:20 +00:00
crosfirmware.sh util/chromeos/crosfirmware.sh: Print more messages 2019-01-03 16:53:57 +00:00
description.md util/chromeos: revise description for more utility scripts in future 2019-09-30 11:09:22 +00:00
extract_blobs.sh
gen_test_hwid.sh vboot: create board-specific test-only GBB HWID if not set 2019-09-30 11:33:20 +00:00

README.md

Chrome OS Scripts

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 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 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.

gen_test_hwid.sh

gen_test_hwid.sh generates a test-only identifier in Chrome OS HWID v2 compatible format.

Usage:

$ ./gen_test_hwid.sh BOARD_NAME

Example:

$ ./gen_test_hwid.sh Kukui
KUKUI TEST 9847