fflash

go/cros-fflash

fflash is a tool to update a ChromiumOS device with a test image from gs:// (Google Cloud Storage).

Setup & Build

Dependencies:

• bazel
• A C++ toolchain

In-repo setup

cd ~/chromiumos/src/platform/dev/contrib/fflash
bazel build //cmd/fflash

The binary is at bazel-bin/cmd/fflash/fflash_/fflash.

(Alternative) Out of source tree setup

git clone https://chromium.googlesource.com/chromiumos/platform/dev-util
cd dev-util/contrib/fflash
bazel build //cmd/fflash

The binary is at bazel-bin/cmd/fflash/fflash_/fflash.

(Alternative) Ninja setup

cd ~/chromiumos/src/platform/dev/contrib/fflash
ninja -v

The binary is at bin/fflash.

Run

1. Make sure you can ssh ${dut_host} without typing a password

   If using crosfleet devices, you might need to copy https://chrome-internal.googlesource.com/chromeos/sshkeys/+/HEAD/partner_testing_rsa to ~/.ssh/partner_testing_rsa. Refer to b/260010430 for more information.

2. path/to/fflash ${dut_host}
   

   Where ${dut_host} is the ssh target.

Usage examples

fflash ${dut_host}  # flash latest canary
fflash ${dut_host} --clobber-stateful=yes  # flash latest canary and clobber stateful
fflash ${dut_host} -R104  # flash latest R104
fflash ${dut_host} -R104-14911.0.0  # flash 104-14911.0.0
fflash ${dut_host} --board=cherry64 -R104  # flash latest R104 for board cherry64
fflash ${dut_host} --gs=gs://chromeos-image-archive/cherry-release/R104-14911.0.0  # flash specified gs:// directory
fflash ${dut_host} --postsubmit  # flash a recent postsubmit build
fflash ${dut_host} --postsubmit -R115  # flash a R115 postsubmit build
fflash ${dut_host} --postsubmit -R115-15474.0.0-82578-  # flash the snapshot 82578
fflash ${dut_host} --dry-run  # print what would be flashed without actually flashing
fflash --help

What fflash does

• flashes the specified image, or latest image on the device
• clobbers stateful (optional, disabled by default)
• disables verified boot
• clears tpm owner (optional, disabled by default)
• reboot the device

it does not

• ask for sudo password
• flash minios

fflash is faster than cros flash if the connection between cros flash and the DUT is slow. cros flash proxies the gs://chromeos-image-archive images for the DUT (Google Cloud -> workstation -> DUT). fflash makes the DUT download the OS images directly, by granting the DUT a restricted access token to the Chrome OS release image directory (Google Cloud -> DUT).

Development

Testing

Unit tests

bazel test //...

Integration tests

bazel run //cmd/integration-test ${dut_host}

Add go source

Add the source normally and:

bazel run //:gazelle

to update the BUILD.bazel files.

Update all go deps

go get -u -d ./...
go mod tidy
bazel run //:gazelle-update-repos

Bugs & Feedback

• Join the fflash-users Google Group (Googlers only).

• File a bug in our issue tracker.

Related tools

• cros flash is the officially supported tool to image ChromiumOS devices. It also allow flashing locally-built images.

• quick-provision is useful if your OS image is already on your ChromiumOS device.