Start the Fuchsia emulator on the host machine and configure the emulator instance to use Fuchsia’s new driver framework (DFv2).

The tasks include:

• Download Fuchsia's Workstation prebuilt image from Google Cloud Storage.
• Start the Fuchsia emulator.
• Set the emulator instance as your host machine’s default target device.
• Start the Fuchsia package server.
• Register the system package repository to the emulator instance.

Do the following:

1. Download the latest Workstation image for the emulator:

   tools/ffx product-bundle get workstation_eng.qemu-x64 --force-repo --repository workstation-packages
   

   This command may take a few minutes to download the image and product metadata.

   Once the download is finished, the ffx product-bundle get command creates a local Fuchsia package repository named workstation-packages on your host machine. This package repository hosts additional system packages for this Workstation prebuilt image. Later in step 8 you’ll register this package repository to the emulator instance.

2. Stop all emulator instances:

   tools/ffx emu stop --all
   

3. Start the Fuchsia emulator:

   tools/ffx emu start workstation_eng.qemu-x64 --headless \
     --kernel-args "driver_manager.use_driver_framework_v2=true" \
     --kernel-args "driver_manager.root-driver=fuchsia-boot:///#meta/platform-bus.cm" \
     --kernel-args "devmgr.enable-ephemeral=true"
   

   This command starts a headless emulator instance running the Workstation prebuilt image.

   When the instance is up and running, the command prints output similar to the following:

   $ tools/ffx emu start workstation_eng.qemu-x64 --headless \
     --kernel-args "driver_manager.use_driver_framework_v2=true" \
     --kernel-args "driver_manager.root-driver=fuchsia-boot:///#meta/platform-bus.cm" \
     --kernel-args "devmgr.enable-ephemeral=true"
   ...
   Logging to "/home/alice/.local/share/Fuchsia/ffx/emu/instances/fuchsia-emulator/emulator.log"
   Waiting for Fuchsia to start (up to 60 seconds).
   Emulator is ready.
   

4. Verify that the new emulator instance is running:

   tools/ffx emu list
   

   This command prints output similar to the following:

   $ tools/ffx emu list
   [Active]  fuchsia-emulator
   

5. Set the default target device:

   tools/ffx target default set fuchsia-emulator
   

   This command exits silently without output.

6. Start the Fuchsia package server:

   tools/ffx repository server start
   

   This command prints output similar to the following:

   $ tools/ffx repository server start
   ffx repository server is listening on [::]:8083
   

7. Check the list of Fuchsia package repositories available on your host machine:

   tools/ffx repository list
   

   This command prints output similar to the following:

   $ tools/ffx repository list
   +-----------------------+------+-------------------------------------------------------------------------------------------------+
   | NAME                  | TYPE | EXTRA                                                                                           |
   +=======================+======+=================================================================================================+
   | workstation-packages* | pm   | /home/alice/.local/share/Fuchsia/ffx/pbms/4751486831982119909/workstation_eng.qemu-x64/packages |
   +-----------------------+------+-------------------------------------------------------------------------------------------------+
   

   Notice a package repository named workstation-packages is created for the Workstation prebuilt image.

8. Register the workstation-packages package repository to the target device:

   tools/ffx target repository register -r workstation-packages --alias fuchsia.com --alias chromium.org
   

   This command exits silently without output.