Releasing new firmware

The hps-firmware-images package installs signed HPS firmware images into the ChromiumOS disk image under /usr/lib/firmware/hps. This is the firmware which hpsd will load and run on the user’s Chromebook. “Releasing” new firmware therefore means updating the signed images in hps-firmware-images.

Follow these steps:

  1. Choose a suitable brya-release build to take signed firmware from. Typically this would be the most recent successful dev-channel brya build, which contains HPS firmware built from the main branch. Use go/deneye to find the build number.

  2. In the src/platform/hps-firmware-images directory, run the helper script to fetch the signed firmware. For example:

    script/get_signed_binary.sh R105 14983.0.0
    
  3. The helper script creates a git commit with the updated firmware. Use git commit --amend to reword the commit as necessary: update BUG= and TEST= and describe the changes included in the new firmware.

  4. Test the new firmware on a DUT. You can use the standard cros workon and cros deploy workflows.

  5. Upload your change for review using repo upload.