util/chromeos/README.md

   1 # Chrome OS Scripts
   2
   3 These scripts can be used to access or generate Chrome OS resources, for example
   4 to extract System Agent reference code and other blobs (e.g. `mrc.bin`, refcode,
   5 VGA option roms) from a Chrome OS recovery image.
   6
   7 ## crosfirmware.sh
   8
   9 `crosfirmware.sh` downloads a Chrome OS recovery image from the recovery
  10 image server, unpacks it, extracts the firmware update shell archive,
  11 extracts the firmware images from the shell archive.
  12
  13 To download all Chrome OS firmware images, run
  14
  15     $ ./crosfirmware.sh
  16
  17
  18 To download, e.g. the Panther firmware image, run
  19
  20     $ ./crosfirmware.sh panther
  21
  22 ## extract_blobs.sh
  23
  24 `extract_blobs.sh` extracts the blobs from a Chrome OS firmware image.
  25
  26 Right now it will produce the ME firmware blob, IFD, VGA option rom,
  27 and `mrc.bin`.
  28
  29 ## gen_test_hwid.sh
  30
  31 `gen_test_hwid.sh` generates a test-only identifier in Chrome OS HWID v2
  32 compatible format.
  33
  34 Usage:
  35
  36     $ ./gen_test_hwid.sh BOARD_NAME
  37
  38 Example:
  39
  40     $ ./gen_test_hwid.sh Kukui
  41     KUKUI TEST 9847