fuchsia.driver.test

Added: 7

PROTOCOLS

Realm

Defined in fuchsia.driver.test/realm.fidl

This protocol is for the DriverTestRealm. It is an integration test framework for drivers.

Start

Start the realm. Calling this will cause DriverTestRealm to start servicing other protocols (like /dev/). args is used to configure the DriverTestRealm.

  • error ZX_ERR_ALREADY_EXISTS the realm has already had Start called.

Request

NameType
args RealmArgs

Response

NameType
payload Realm_Start_Result

STRUCTS

DriverLog

Defined in fuchsia.driver.test/realm.fidl

FieldTypeDescriptionDefault
name DriverName No default
log_level fuchsia.diagnostics/Severity No default

Expose

Defined in fuchsia.driver.test/realm.fidl

Added: HEAD

FieldTypeDescriptionDefault
service_name string No default
collection Collection No default

Offer

Defined in fuchsia.driver.test/realm.fidl

Added: HEAD

FieldTypeDescriptionDefault
protocol_name string No default
collection Collection No default

Realm_Start_Response

Defined in fuchsia.driver.test/realm.fidl

<EMPTY>

ENUMS

Collection strict

Type: uint32

Defined in fuchsia.driver.test/realm.fidl

Added: HEAD

NameValueDescription
0
1
2

TABLES

RealmArgs resource

Defined in fuchsia.driver.test/realm.fidl

A list of arguments that can be used to configure DriverTestRealm.

OrdinalFieldTypeDescription
boot fuchsia.io/Directory

This is what DriverManager will see as its boot directory. Default: DriverTestRealm's package directory
root_driver string

The URL for the driver that will be bound to root. Default: fuchsia-boot:///#meta/test-parent-sys.cm NOTE: The test parent driver is not included by default. This must be included in your package to work correctly.
use_driver_framework_v2 bool

If this is true, then DriverManager will load DFv2 drivers. Default: false
driver_tests_enable_all bool

If this is true, then DriverManager will enable the unit tests for each driver that is loaded. Default: false
driver_tests_enable vector<string>

If this is true, then DriverManager will enable the unit tests for each driver in this vector. Default: empty
driver_tests_disable vector<string>

If this is true, then DriverManager will disable the unit tests for each driver in this vector. This overrides both a specific request for enabling a test and the 'driver_tests_enable_all' parameter. Default: empty
driver_log_level vector<DriverLog>

Set a log level for the specific driver. Default: Log levels are set to INFO
driver_disable vector<string>

Disable specific drivers. These drivers will not be bound or loaded. Default: empty
driver_bind_eager vector<string>

Specify drivers to bind 'eagerly'. This turns a driver that normally binds as a fallback driver into a driver that will be bound normally. Default: empty
board_name string

Specify the board name that drivers are aware of. Default: driver-integration-test
offers vector<Offer>

Specify additional offers from the test to a driver collection Default: empty

Added: HEAD
exposes vector<Expose>

Specify services to expose from the test to a driver collection Default: empty

Added: HEAD
pkg fuchsia.io/Directory

The driver test realm can load drivers packaged with the test suite through this directory. Note that this directory must be readable and executable.

This can be used if the test suite needs to use some drivers packaged with the DriverTestRealm in addition to drivers packaged with the test suite. In that case, the user can leave RealmArgs::boot unset and use RealmArgs::pkg and RealmArgs::driver_urls.

Drivers in this directory can be registered using the driver_urls argument below.

Default: DriverTestRealm's package directory.

Added: HEAD
driver_urls vector<string>

The driver URLs to be loaded from pkg. These URLs should use the prefix fuchsia-pkg://fuchsia.com/

Default: empty

Added: HEAD

UNIONS

Realm_Start_Result strict

Defined in fuchsia.driver.test/realm.fidl

OrdinalVariantTypeDescription
response Realm_Start_Response
err zx/Status
transport_err internal

ALIASES

NameValueDescription
DriverName string[fidl/MAX]

A driver name is the name defined in ZIRCON_DRIVER_BEGIN begin macro for a specific driver.