util/chromeos/README.md

   1 # ChromeOS Scripts
   2
   3 These scripts can be used to access or generate ChromeOS resources, for example
   4 to extract System Agent reference code and other blobs (e.g. `mrc.bin`, refcode,
   5 VGA option roms) from a ChromeOS recovery image.
   6
   7 ## crosfirmware.sh
   8
   9 `crosfirmware.sh` downloads a ChromeOS 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 ChromeOS 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 ChromeOS 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 ChromeOS 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