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 hadStart
called.
Request
Name | Type |
---|---|
args |
RealmArgs
|
Response
Name | Type |
---|---|
payload |
Realm_Start_Result
|
STRUCTS
DriverLog
Defined in fuchsia.driver.test/realm.fidl
Field | Type | Description | Default |
---|---|---|---|
name |
DriverName
|
No default | |
log_level |
fuchsia.diagnostics/Severity
|
No default |
Expose
Defined in fuchsia.driver.test/realm.fidl
Field | Type | Description | Default |
---|---|---|---|
service_name |
string
|
No default | |
collection |
Collection
|
No default |
Offer
Defined in fuchsia.driver.test/realm.fidl
Field | Type | Description | Default |
---|---|---|---|
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
Name | Value | Description |
---|---|---|
UNKNOWN |
0 |
|
BOOT_DRIVERS |
1 |
|
PACKAGE_DRIVERS |
2 |
TABLES
RealmArgs resource
Defined in fuchsia.driver.test/realm.fidl
A list of arguments that can be used to configure DriverTestRealm.
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
boot |
fuchsia.io/Directory
|
This is what DriverManager will see as its boot directory. Default: DriverTestRealm's package directory |
2 |
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. |
3 |
use_driver_framework_v2 |
bool
|
If this is true, then DriverManager will load DFv2 drivers. Default: false |
4 |
driver_tests_enable_all |
bool
|
If this is true, then DriverManager will enable the unit tests for each driver that is loaded. Default: false |
5 |
driver_tests_enable |
vector<string>
|
If this is true, then DriverManager will enable the unit tests for each driver in this vector. Default: empty |
6 |
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 |
7 |
driver_log_level |
vector<DriverLog>
|
Set a log level for the specific driver. Default: Log levels are set to INFO |
8 |
driver_disable |
vector<string>
|
Disable specific drivers. These drivers will not be bound or loaded. Default: empty |
9 |
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 |
10 |
board_name |
string
|
Specify the board name that drivers are aware of. Default: driver-integration-test |
11 |
offers |
vector<Offer>
|
Specify additional offers from the test to a driver collection Default: empty Added: HEAD
|
12 |
exposes |
vector<Expose>
|
Specify services to expose from the test to a driver collection Default: empty Added: HEAD
|
13 |
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 Default: DriverTestRealm's package directory. Added: HEAD
|
14 |
driver_urls |
vector<string>
|
The driver URLs to be loaded from Default: empty Added: HEAD
|
UNIONS
Realm_Start_Result strict
Defined in fuchsia.driver.test/realm.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_Start_Response
|
|
2 |
err |
zx/Status
|
|
3 |
transport_err |
internal
|
ALIASES
Name | Value | Description |
---|---|---|
DriverName |
string [fidl/MAX ] |
A driver name is the name defined in ZIRCON_DRIVER_BEGIN begin macro for a specific driver. |