This guide provides step-by-step instructions that walk you through the basic workflows of building, running, debugging, and updating drivers in a Fuchsia system using the Fuchsia SDK.
Important: This guide is the driver equivalent of the Get started with the Fuchsia SDK guide. If you haven‘t already, it’s strongly recommended that you first complete the Get started with the Fuchsia SDK guide to become familiar with the comprehensive set of Fuchsia SDK-based workflows.
Complete the following sections:
Found an issue? Please let us know{:.external}.
This guide requires that your host machine meets the following criteria:
Clone the SDK driver samples repository{:.external} on your host machine. This repository contains sample driver components and the Bazel-based Fuchsia SDK.
The tasks include:
ffx commands.Do the following:
In a terminal, change to your home directory:
Note: This guide uses the home directory ($HOME) as a base directory. This is where a new work directory (drivers) will be created for this guide. You may also select a different base directory (for instance, cd $HOME/my-fuchsia-project).
cd $HOME
Clone the SDK driver samples repository:
git clone https://fuchsia.googlesource.com/sdk-samples/drivers --recurse-submodules
This creates a new directory named drivers, which clones the content of the SDK driver samples repository.
Go to the new directory:
cd drivers
Run the bootstrap script to install Bazel and other required dependencies:
scripts/bootstrap.sh
To verify the Fuchsia SDK environment setup, build the sample drivers:
tools/bazel build --config=fuchsia_x64 //src/qemu_edu/drivers:qemu_edu
The first build may take a few minutes to download dependencies, such as Bazel build rules, Clang, and Fuchsia IDK (which includes the ffx tool).
When finished successfully, it prints output similar to the following in the end:
$ tools/bazel build --config=fuchsia_x64 //src/qemu_edu/drivers:qemu_edu ... INFO: Elapsed time: 263.954s, Critical Path: 67.11s INFO: 952 processes: 587 internal, 365 linux-sandbox. INFO: Build completed successfully, 952 total actions
To verify that you can use the ffx tool in your environment, run the following command:
tools/ffx sdk version
This command prints output similar to the following:
$ tools/ffx sdk version 9.20220919.2.1
At this point, you only need to confirm that you can run ffx commands without error. (However for your information, the output above shows the version 9.20220919.2.1, which indicates that this SDK was built and published on September 19, 2022.)
Note: To ensure that you’re using the right version of ffx during development, consider updating your PATH to include the SDK‘s tools directory (for instance, export PATH="$PATH:$HOME/fuchsia-getting-started/tools"). However, if you don’t wish to update your PATH, ensure that you specify the relative path to this ffx tool (tools/ffx) whenever you run ffx commands.
Start the Fuchsia emulator on the host machine while configuring the emulator instance to use Fuchsia’s new driver framework (DFv2).
The tasks include:
Do the following:
Download the latest Workstation image for the emulator:
tools/ffx product-bundle get workstation_eng.qemu-x64 --repository workstation-packages
This command may take a few minutes to download the image and product metadata.
Note: If the product-bundle command fails with an error due to multiple product bundle instances or SDK versions, clean up the environment before proceeding.
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.
Stop all emulator instances:
tools/ffx emu stop --all
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" Creating SSH key pair: /home/alice/.ssh/fuchsia_ed25519 Writing authorized_keys file: /home/alice/.ssh/fuchsia_authorized_keys 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.
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
Set the default target device:
tools/ffx target default set fuchsia-emulator
This command exits silently without output.
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
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 (workstation-packages) is created for the Workstation prebuilt image.
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.
The Fuchsia emulator (launched in the Start the emulator section above) is configured to create a virtual device named edu, which is an educational device for writing drivers. In the previous section, when the emulator started, Fuchsia’s driver framework detected this edu device in the system, but it wasn’t able to find a driver that could serve the edu device. So the edu device was left unmatched.
In this section, we build and publish the qemu_edu sample driver (which is a Fuchsia component). Upon detecting a new driver, the driver framework will discover that this new qemu_edu driver is a match for the edu device. Once matched, the qemu_edu driver starts providing the edu device’s services (capabilities) to other components in the system – one of the services provided by the edu device is that it computes a factorial given an integer.
The tasks include:
qemu_edu driver component.qemu_edu driver is loaded to the emulator instance.qemu_edu component.Do the following:
View the list of the currently loaded drivers:
tools/ffx driver list --loaded
This command prints output similar to the following:
$ tools/ffx driver list --loaded fuchsia-boot:///#meta/block.core.cm fuchsia-boot:///#meta/bus-pci.cm fuchsia-boot:///#meta/display.cm fuchsia-boot:///#meta/fvm.cm fuchsia-boot:///#meta/goldfish-display.cm fuchsia-boot:///#meta/goldfish.cm fuchsia-boot:///#meta/goldfish_address_space.cm fuchsia-boot:///#meta/goldfish_control.cm fuchsia-boot:///#meta/goldfish_sensor.cm fuchsia-boot:///#meta/goldfish_sync.cm fuchsia-boot:///#meta/hid-input-report.cm fuchsia-boot:///#meta/hid.cm fuchsia-boot:///#meta/intel-hda.cm fuchsia-boot:///#meta/intel-rtc.cm fuchsia-boot:///#meta/netdevice-migration.cm fuchsia-boot:///#meta/network-device.cm fuchsia-boot:///#meta/pc-ps2.cm fuchsia-boot:///#meta/platform-bus-x86.cm fuchsia-boot:///#meta/platform-bus.cm fuchsia-boot:///#meta/qemu-audio-codec.cm fuchsia-boot:///#meta/ramdisk.cm fuchsia-boot:///#meta/sysmem.cm fuchsia-boot:///#meta/virtio_block.cm fuchsia-boot:///#meta/virtio_ethernet.cm fuchsia-boot:///#meta/virtio_input.cm fuchsia-pkg://fuchsia.com/virtual_audio#meta/virtual_audio_driver.cm fuchsia-boot:///#meta/ahci.cm
Build and publish the qemu_edu driver component:
tools/bazel run --config=fuchsia_x64 //src/qemu_edu/drivers:pkg.component
This command prints output similar to the following:
$ tools/bazel run --config=fuchsia_x64 //src/qemu_edu/drivers:pkg.component INFO: Analyzed target //src/qemu_edu/drivers:pkg.component (8 packages loaded, 513 targets configured). INFO: Found 1 target... Target //src/qemu_edu/drivers:pkg.component up-to-date: bazel-bin/src/qemu_edu/drivers/pkg.component_run_component.sh INFO: Elapsed time: 101.652s, Critical Path: 66.01s INFO: 970 processes: 596 internal, 373 linux-sandbox, 1 local. INFO: Build completed successfully, 970 total actions INFO: Build completed successfully, 970 total actions added repository bazel.pkg.component Registering fuchsia-pkg://bazel.pkg.component/qemu_edu#meta/qemu_edu.cm Successfully bound: Node 'root.sys.platform.platform-passthrough.PCI0.bus.00_06_0_.pci-00_06.0-fidl', Driver 'fuchsia-pkg://bazel.pkg.component/qemu_edu#meta/qemu_edu.cm'.
Verify that the qemu_edu driver is now loaded to the Fuchsia emulator instance:
tools/ffx driver list --loaded
This command prints output similar to the following:
$ tools/ffx driver list --loaded fuchsia-boot:///#meta/block.core.cm fuchsia-boot:///#meta/bus-pci.cm fuchsia-boot:///#meta/display.cm fuchsia-boot:///#meta/fvm.cm fuchsia-boot:///#meta/goldfish-display.cm fuchsia-boot:///#meta/goldfish.cm fuchsia-boot:///#meta/goldfish_address_space.cm fuchsia-boot:///#meta/goldfish_control.cm fuchsia-boot:///#meta/goldfish_sensor.cm fuchsia-boot:///#meta/goldfish_sync.cm fuchsia-boot:///#meta/hid-input-report.cm fuchsia-boot:///#meta/hid.cm fuchsia-boot:///#meta/intel-hda.cm fuchsia-boot:///#meta/intel-rtc.cm fuchsia-boot:///#meta/netdevice-migration.cm fuchsia-boot:///#meta/network-device.cm fuchsia-boot:///#meta/pc-ps2.cm fuchsia-boot:///#meta/platform-bus-x86.cm fuchsia-boot:///#meta/platform-bus.cm fuchsia-boot:///#meta/qemu-audio-codec.cm fuchsia-boot:///#meta/ramdisk.cm fuchsia-boot:///#meta/sysmem.cm fuchsia-boot:///#meta/virtio_block.cm fuchsia-boot:///#meta/virtio_ethernet.cm fuchsia-boot:///#meta/virtio_input.cm fuchsia-pkg://fuchsia.com/virtual_audio#meta/virtual_audio_driver.cm {{ '<strong>' }}fuchsia-pkg://bazel.pkg.component/qemu_edu#meta/qemu_edu.cm{{ '</strong>' }} fuchsia-boot:///#meta/ahci.cm
Notice that the qemu_edu driver is shown in the loaded drivers list.
View the qemu_edu component information:
tools/ffx component show qemu_edu.cm
This command prints output similar to the following:
$ tools/ffx component show qemu_edu.cm Moniker: /bootstrap/universe-pkg-drivers:root.sys.platform.platform-passthrough.PCI0.bus.00_06_0_.pci-00_06.0-fidl URL: fuchsia-pkg://bazel.pkg.component/qemu_edu#meta/qemu_edu.cm Instance ID: None Type: CML Component Component State: Resolved Incoming Capabilities: /svc/fuchsia.device.fs.Exporter /svc/fuchsia.driver.compat.Service /svc/fuchsia.logger.LogSink Exposed Capabilities: fuchsia.examples.qemuedu.Service Merkle root: 4543f40fc3f7403ad30bfe9d964a97eeeaeb8faeab6cd52b3bdc2d0e60e686a3 Execution State: Running Start reason: Instance is in a single_run collection Outgoing Capabilities: fuchsia.examples.qemuedu.Service
View the device logs of the qemu_edu driver:
tools/ffx log --filter qemu_edu dump
This command prints output similar to the following:
$ tools/ffx log --filter qemu_edu dump ... [196.250][pkg-resolver][pkg-resolver][I] resolved fuchsia-pkg://bazel.pkg.component/qemu_edu as fuchsia-pkg://bazel.pkg.component/qemu_edu to 4543f40fc3f7403ad30bfe9d964a97eeeaeb8faeab6cd52b3bdc2d0e60e686a3 with TUF [196.250][pkg-resolver][pkg-resolver][I] get_hash for fuchsia-pkg://bazel.pkg.component/qemu_edu as fuchsia-pkg://bazel.pkg.component/qemu_edu to 4543f40fc3f7403ad30bfe9d964a97eeeaeb8faeab6cd52b3bdc2d0e60e686a3 with TUF [196.257][driver_index][driver_index,driver][I] Registered driver successfully: fuchsia-pkg://bazel.pkg.component/qemu_edu#meta/qemu_edu.cm. [196.346][pkg-resolver][pkg-resolver][I] Fetching blobs for fuchsia-pkg://bazel.pkg.component/qemu_edu: [] [196.352][pkg-resolver][pkg-resolver][I] resolved fuchsia-pkg://bazel.pkg.component/qemu_edu as fuchsia-pkg://bazel.pkg.component/qemu_edu to 4543f40fc3f7403ad30bfe9d964a97eeeaeb8faeab6cd52b3bdc2d0e60e686a3 with TUF [196.361][driver_manager][driver_manager.cm][I]: [node.cc:608] Binding fuchsia-pkg://bazel.pkg.component/qemu_edu#meta/qemu_edu.cm to pci-00_06.0-fidl [196.729][universe-pkg-drivers:root.sys.platform.platform-passthrough.PCI0.bus.00_06_0_.pci-00_06.0-fidl][qemu-edu,driver][I]: [src/qemu_edu/drivers/qemu_edu.cc:77] edu device version major=1 minor=0
The qemu_edu driver sample includes tools for interacting with the qemu_edu driver running in a Fuchsia system. Developers often include binary executables in a Fuchsia package and run those executables as a component for testing and debugging drivers.
In this driver sample, an executable named eductl_tool provides two options: live and fact. The live command checks for the liveness of the qemu_edu driver in the system. The fact takes an integer as an argument. The integer is then passed to the qemu_edu driver and used as input for computing the factorial (using the resource of the edu virtual device). Once computed, the driver returns the result to eductl_tool.
The tasks include:
eductl_tool.qemu_edu driver.Do the following:
Build and run eductl_tool (and run the live command):
tools/bazel run --config=fuchsia_x64 //src/qemu_edu/tools:pkg.eductl_tool live
This command prints output similar to the following:
$ tools/bazel run --config=fuchsia_x64 //src/qemu_edu/tools:pkg.eductl_tool live INFO: Analyzed target //src/qemu_edu/tools:pkg.eductl_tool (0 packages loaded, 0 targets configured). INFO: Found 1 target... Target //src/qemu_edu/tools:pkg.eductl_tool up-to-date: bazel-bin/src/qemu_edu/tools/pkg.eductl_tool_run_driver_tool.sh INFO: Elapsed time: 0.286s, Critical Path: 0.01s INFO: 1 process: 1 internal. INFO: Build completed successfully, 1 total action INFO: Build completed successfully, 1 total action added repository bazel.pkg.eductl.tool {{ '<strong>' }}Liveness check passed!{{ '</strong>' }}
Verify that the line Liveness check passed! is printed in the end.
Run eductl_tool using fact and 12 as input:
tools/bazel run --config=fuchsia_x64 //src/qemu_edu/tools:pkg.eductl_tool fact 12
This command prints output similar to the following:
$ tools/bazel run --config=fuchsia_x64 //src/qemu_edu/tools:pkg.eductl_tool fact 12 ... INFO: Build completed successfully, 1 total action added repository bazel.pkg.eductl.tool {{ '<strong>' }}Factorial(12) = 479001600{{ '</strong>' }}
The last line shows that the driver replied 479001600 as the result of the factorial to eductl_tool, which passed 12 as input to the driver.
Use the Fuchsia debugger (zxdb) to step through the sample driver’s code as the driver is running on the emulator instance.
The tasks include:
qemu_edu driver.eductl_tool, which triggers the driver to execute its instructions.Do the following:
View the list of the running driver hosts:
tools/ffx driver list-hosts
This command prints output similar to the following:
$ tools/ffx driver list-hosts Driver Host: 5173 fuchsia-boot:///#meta/bus-pci.cm fuchsia-boot:///#meta/display.cm fuchsia-boot:///#meta/goldfish-display.cm fuchsia-boot:///#meta/goldfish.cm fuchsia-boot:///#meta/goldfish_control.cm fuchsia-boot:///#meta/goldfish_sensor.cm fuchsia-boot:///#meta/goldfish_sync.cm fuchsia-boot:///#meta/hid.cm fuchsia-boot:///#meta/intel-hda.cm fuchsia-boot:///#meta/platform-bus-x86.cm fuchsia-boot:///#meta/platform-bus.cm fuchsia-boot:///#meta/qemu-audio-codec.cm fuchsia-boot:///#meta/ramdisk.cm fuchsia-boot:///#meta/sysmem.cm fuchsia-pkg://fuchsia.com/virtual_audio#meta/virtual_audio_driver.cm Driver Host: 8256 fuchsia-boot:///#meta/intel-rtc.cm Driver Host: 8334 fuchsia-boot:///#meta/pc-ps2.cm Driver Host: 9577 fuchsia-boot:///#meta/block.core.cm fuchsia-boot:///#meta/fvm.cm fuchsia-boot:///#meta/virtio_block.cm Driver Host: 9762 fuchsia-boot:///#meta/hid-input-report.cm fuchsia-boot:///#meta/hid.cm fuchsia-boot:///#meta/virtio_input.cm Driver Host: 9911 fuchsia-boot:///#meta/goldfish_address_space.cm Driver Host: 10166 fuchsia-boot:///#meta/netdevice-migration.cm fuchsia-boot:///#meta/network-device.cm fuchsia-boot:///#meta/virtio_ethernet.cm Driver Host: 10346 fuchsia-boot:///#meta/hid-input-report.cm fuchsia-boot:///#meta/hid.cm fuchsia-boot:///#meta/virtio_input.cm Driver Host: 10352 fuchsia-boot:///#meta/ahci.cm Driver Host: 80789 fuchsia-pkg://bazel.pkg.component/qemu_edu#meta/qemu_edu.cm
Make a note of the PID of the qemu_edu driver host (80789 in the example above).
Start the Fuchsia debugger:
tools/ffx debug connect
This command prints output similar to the following:
$ tools/ffx debug connect Connecting (use "disconnect" to cancel)... Connected successfully. 👉 To get started, try "status" or "help". [zxdb]
Attach the debugger to the qemu_edu driver host:
Replace PID with the PID of the qemu_edu driver host identified in Step 1, for example:
[zxdb] attach 80789
This command prints output similar to the following:
[zxdb] attach 80789 Attached Process 1 state=Running koid=80789 name=driver_host2.cm component=driver_host2.cm Downloading symbols... Symbol downloading complete. 2 succeeded, 0 failed. [zxdb]
Set a breakpoint at the driver’s ComputeFactorial function:
This command prints output similar to the following:
Created Breakpoint 2 @ QemuEduServer::ComputeFactorial 143 void QemuEduServer::ComputeFactorial(ComputeFactorialRequestView request, {{ '<strong>' }}◉ 144 ComputeFactorialCompleter::Sync& completer) { {{ '</strong>' }} 145 auto edu_device = device_.lock(); [zxdb]
In different terminal, run eductl_tool (using fact and 12 as input) to interact with the driver:
Note: In this new terminal, make sure that you change to the same work directory (for instance, cd $HOME/drivers).
tools/bazel run --config=fuchsia_x64 //src/qemu_edu/tools:pkg.eductl_tool fact 12
After printing output similar to the following, the command now hangs:
$ tools/bazel run --config=fuchsia_x64 //src/qemu_edu/tools:pkg.eductl_tool fact 12 INFO: Analyzed target //src/qemu_edu/tools:pkg.eductl_tool (0 packages loaded, 0 targets configured). INFO: Found 1 target... Target //src/qemu_edu/tools:pkg.eductl_tool up-to-date: bazel-bin/src/qemu_edu/tools/pkg.eductl_tool_run_driver_tool.sh INFO: Elapsed time: 0.348s, Critical Path: 0.01s INFO: 1 process: 1 internal. INFO: Build completed successfully, 1 total action INFO: Build completed successfully, 1 total action added repository bazel.pkg.eductl.tool
In the zxdb terminal, verify that the debugger is stopped at the driver’s ComputeFactorial function, for example:
🛑 thread 2 on bp 2 qemu_edu::QemuEduServer::ComputeFactorial(qemu_edu::QemuEduServer*, fidl::WireServer<fuchsia_examples_qemuedu::Device>::ComputeFactorialRequestView, fidl::Completer<fidl::internal::WireCompleterBase<fuchsia_examples_qemuedu::Device::ComputeFactorial> >::Sync&) • qemu_edu.cc:144 142 // Driver Service: Compute factorial on the edu device 143 void QemuEduServer::ComputeFactorial(ComputeFactorialRequestView request, {{ '<strong>' }}▶ 144 ComputeFactorialCompleter::Sync& completer) { {{ '</strong>' }} 145 auto edu_device = device_.lock(); 146 if (!edu_device) { [zxdb]
In the zxdb terminal, view the source code around the current breakpoint:
This command prints output similar to the following:
[zxdb] list 139 // [END run_method_end] 140 141 // [START compute_factorial] 142 // Driver Service: Compute factorial on the edu device 143 void QemuEduServer::ComputeFactorial(ComputeFactorialRequestView request, {{ '<strong>' }}▶ 144 ComputeFactorialCompleter::Sync& completer) { {{ '</strong>' }} 145 auto edu_device = device_.lock(); 146 if (!edu_device) { 147 FDF_LOG(ERROR, "Unable to access device resources"); 148 return; 149 } 150 151 uint32_t input = request->input; 152 153 uint32_t factorial = edu_device->ComputeFactorial(input); 154 [zxdb]
In the zxdb terminal, step through the code using the next command until the value of factorial is read from the device (that is, until the line 155 is reached):
The last next command prints output similar to the following:
... [zxdb] next 🛑 thread 2 qemu_edu::QemuEduServer::ComputeFactorial(qemu_edu::QemuEduServer*, fidl::WireServer<fuchsia_examples_qemuedu::Device>::ComputeFactorialRequestView, fidl::Completer<fidl::internal::WireCompleterBase<fuchsia_examples_qemuedu::Device::ComputeFactorial> >::Sync&) • qemu_edu.cc:155 153 uint32_t factorial = edu_device->ComputeFactorial(input); 154 {{ '<strong>' }}▶ 155 FDF_SLOG(INFO, "Replying with", KV("factorial", factorial)); {{ '</strong>' }} 156 completer.Reply(factorial); 157 } [zxdb]
Print the factorial variable:
This command prints output similar to the following:
[zxdb] print factorial 479001600 [zxdb]
Step through the code using the next command until the Reply() method is called (that is, until the line 157 is reached):
The last next command prints output similar to the following:
... [zxdb] next 🛑 thread 2 qemu_edu::QemuEduServer::ComputeFactorial(qemu_edu::QemuEduServer*, fidl::WireServer<fuchsia_examples_qemuedu::Device>::ComputeFactorialRequestView, fidl::Completer<fidl::internal::WireCompleterBase<fuchsia_examples_qemuedu::Device::ComputeFactorial> >::Sync&) • qemu_edu.cc:156 155 FDF_SLOG(INFO, "Replying with", KV("factorial", factorial)); 156 completer.Reply(factorial); {{ '<strong>' }}▶ 157 } {{ '</strong>' }} 158 // [END compute_factorial] 159 [zxdb]
In the other terminal, verify that eductl_tool has exited after printing the factorial result:
$ tools/bazel run --config=fuchsia_x64 //src/qemu_edu/tools:pkg.eductl_tool fact 12 ... INFO: Build completed successfully, 1 total action added repository bazel.pkg.eductl.tool Factorial(12) = 479001600 $
In the zxdb terminal, type exit or press Ctrl-D to exit the debugger.
Note: For more information on usages and best practices on zxdb, see the zxdb user guide.
Update the source code of the sample driver and reload it to the emulator instance.
The tasks include:
qemu_edu driver.qemu_edu driver.eductl_tool to verify the change.Do the following:
Stop the emulator instance:
tools/ffx emu stop
This command stops the currently running emulator instance.
Start a new instance of 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.
Use a text editor to open the source code of the sample driver, for example:
nano src/qemu_edu/drivers/qemu_edu.cc
In the QemuEduServer::ComputeFactorial function, between the line uint32_t factorial = edu_device->ComputeFactorial(input) (Line 153) and the FDF_SLOG() call (Line 155), add the following line:
factorial=12345;
The function should look like below:
void QemuEduServer::ComputeFactorial(ComputeFactorialRequestView request, ComputeFactorialCompleter::Sync& completer) { auto edu_device = device_.lock(); if (!edu_device) { FDF_LOG(ERROR, "Unable to access device resources"); return; } uint32_t input = request->input; uint32_t factorial = edu_device->ComputeFactorial(input); {{ '<strong>' }}factorial = 12345;{{ '</strong>' }} FDF_SLOG(INFO, "Replying with", KV("factorial", factorial)); completer.Reply(factorial); }
The function is now updated to always return the value of 12345.
Save the file and close the text editor.
Rebuild and run the modified sample driver:
tools/bazel run --config=fuchsia_x64 //src/qemu_edu/drivers:pkg.component
Run eductl_tool using fact and 12 as input:
tools/bazel run --config=fuchsia_x64 //src/qemu_edu/tools:pkg.eductl_tool fact 12
This command now prints output similar to the following:
$ tools/bazel run --config=fuchsia_x64 //src/qemu_edu/tools:pkg.eductl_tool fact 12 ... INFO: Build completed successfully, 1 total action added repository bazel.pkg.eductl.tool Factorial(12) = 12345
The last line shows that the qemu_edu driver replied with the hardcoded value of 12345 to eductl_tool.
Congratulations! You’re now all set with the Fuchsia driver development!
Learn more about how the qemu_edu driver works in Codelab: QEMU edu driver.
If you run into a problem while following this guide and decide to start over from the beginning, consider running the commands below to clean up your development environment (that is, to clean up directories, build artifacts, downloaded files, symlinks, configuration settings, and more).
Remove the package repositories created in this guide:
tools/ffx repository remove workstation-packages
tools/ffx repository server stop
Remove all existing configurations and data of ffx:
tools/ffx daemon stop
rm -rf $HOME/.local/share/Fuchsia/ffx
When Bazel fails to build, try the commands below:
Caution: Running bazel clean or deleting the $HOME/.cache/bazel directory deletes all the artifacts downloaded by Bazel, which can be around 4 GB. This means Bazel will need to download those dependencies again the next time you run bazel build.
tools/bazel clean --expunge
tools/bazel shutdown && rm -rf $HOME/.cache/bazel
Remove the drivers directory and its artifacts:
Caution: If the SDK samples repository is cloned to a different location than $HOME/drivers, adjust the directory path in the command below. Be extremely careful with the directory path when you run the `rm -rf
rm -rf $HOME/drivers
Other clean up commands:
killall ffx
killall pm