The ffx target flash
command can flash a Fuchsia image
on a device.
Concepts
Fuchsia uses a Fastboot-based flashing mechanism to install a Fuchsia product on a hardware device. The Fastboot protocol (originally part of Android) is a mechanism for communicating with bootloaders over USB or Ethernet. This mechanism allows you to flash a Fuchsia prebuilt image on the device's non-volatile memory.
To be able to flash a Fuchsia image on a device, the bootloader of the device
must support Fastboot mode. Once the device can boot into Fastboot
mode, you can then use ffx target flash
to flash a Fuchsia image on the
device. However, if your device's bootloader doesn't support Fastboot, you'd
first need to update the bootloader. Updating a device's bootloader (to support
Fastboot) typically requires instructions that are specific to the type and
maker of the device, which is not covered in this guide.
Fuchsia prebuilt images can be obtained from various sources, such as Google Cloud Storage and project repositories. Additionally, custom prebuilt images can be generated from a Fuchsia source checkout. In either case, the prebuilt image used for flashing must match the target device.
Flash the device
To flash a Fuchsia image on your device, do the following:
- Connect the device to the host machine over USB or Ethernet.
Check the device's state:
ffx target list
This command prints output similar to the following:
$ ffx target list NAME SERIAL TYPE STATE ADDRS/IP RCS <unknown> 01234ABCD012YZ Unknown Fastboot [] N
Verify that the device's state is
Fastboot
.Flash the device:
ffx target flash <FUCHSIA_IMAGE>
Replace
FUCHSIA_IMAGE
with an archive file that contains a Fuchsia prebuilt image and its flash manifest file, for example:$ ffx target flash ~/Downloads/fuchsia-image-example.zip
Once the flashing is finished, the device reboots and starts running Fuchsia.
Boot the device into Fastboot mode
To trigger a Fuchsia device to boot into Fastboot mode, run the following command:
ffx target reboot -b
After rebooting, the device boots into Fastboot mode.