Migrate from Banjo to FIDL

DFv1 drivers communicate with each other using the Banjo protocol. In DFv2 all communications occur over FIDL (Fuchsia Interface Definition Language) calls, for both drivers and non-drivers. So if your DFv1 driver being migrated to DFv2 uses the Banjo protocol, you'll need to update the driver to make only FIDL calls to complete the migration.

In short, migrating a driver from Banjo to FIDL involves the steps below:

1. Update the driver's .fidl file to create a new FIDL interface.
2. Update the driver's source code to use the new interface.
3. Build and test the driver using the new FIDL interface.

Before you start

Prior to starting migration tasks, first check out the Frequently asked questions page. This can help you identify special conditions or edge cases that may apply to your driver.

List of migration tasks

• Convert Banjo protocols to FIDL protocols: Learn how to migrate a driver from using the Banjo protocol to FIDL.

  • Update the DFv1 driver from Banjo to FIDL
  • (Optional) Update the DFv1 driver to use the driver runtime
  • (Optional) Update the DFv1 driver to use non-default dispatchers
  • (Optional) Update the DFv1 driver to use two-way communication
  • Update the DFv1 driver's unit tests to use FIDL
  • Additional resources