fuchsia.driver.development

添加数量：17

协议

CompositeInfoIterator

在 fuchsia.driver.develop/iterators.fidl 中定义

用于对 CompositeList 进行分页。

GetNext

一次最多返回 100 个条目。如果没有其他组合，则返回空。

请求

<EMPTY>

响应

名称类型
composites vector<CompositeNodeInfo>

CompositeNodeSpecIterator

在 fuchsia.driver.develop/iterators.fidl 中定义

GetNext

如果没有更多的节点组，则返回空值。

请求

<EMPTY>

响应

名称类型
specs vector<fuchsia.driver.framework/CompositeInfo>

DriverInfoIterator

在 fuchsia.driver.develop/iterators.fidl 中定义

GetNext

如果不再需要更多条目，则返回空值。

请求

<EMPTY>

响应

名称类型
drivers vector<fuchsia.driver.framework/DriverInfo>

经理

在 fuchsia.driver.develop/develop.fidl 中定义

驱动程序开发管理器的接口。 此接口应仅用于开发，且在发布 build 中处于停用状态。

AddTestNode

在根节点下添加测试节点。

请求

名称类型
args TestNodeAddArgs

响应

名称类型
payload Manager_AddTestNode_Result

BindAllUnboundNodes

尝试绑定拓扑中的所有未绑定节点。返回新的成功绑定。

请求

<EMPTY>

响应

名称类型
payload Manager_BindAllUnboundNodes_Result

DisableDriver

停用具有给定驱动程序组件网址的驱动程序。 系统不会将已停用的驱动程序视为与节点进行匹配。如果提供了 |package_hash|，则只有该特定版本的驱动程序软件包将被停用。否则，这适用于具有给定网址的所有现有驱动程序版本。 如果驱动程序不受影响，则返回错误 ZX_ERR_NOT_FOUND。

请求

名称类型
driver_url fuchsia.url/Url
package_hash string[64]?

响应

名称类型
payload Manager_DisableDriver_Result

EnableDriver

启用具有给定驱动程序组件网址的驱动程序。 这只是为了还原 |DisableDriver| 操作。 如果驱动程序不受影响，则返回错误 ZX_ERR_NOT_FOUND。

请求

名称类型
driver_url fuchsia.url/Url
package_hash string[64]?

响应

名称类型
payload Manager_EnableDriver_Result

GetCompositeInfo

返回系统中的复合列表。这包括尚未组装并添加到节点拓扑中的复合组件。

请求

名称类型
iterator server_end<CompositeInfoIterator>

GetCompositeNodeSpecs

返回系统已知的所有复合节点规范的列表。 如果提供了 |name_filter|，返回的列表将仅包含 1 个规范，即具有确切名称的规范。

错误时 |iterator| 关闭，并显示以下表文：ZX_ERR_NOT_FOUND 表示没有规范；如果提供了 |name_filter|，则表示没有具有该名称的规范。

请求

名称类型
name_filter string?
iterator server_end<CompositeNodeSpecIterator>

GetDriverInfo

返回系统已知的所有驱动程序的列表。 如果提供了 |driver_filter|，则返回的列表将进行过滤，以仅包含过滤器中指定的驱动程序。

|iterator| 会在出现错误时关闭，并显示以下 epitaph：ZX_ERR_NOT_FOUND 表示在 |driver_filter| 中没有与至少一个驱动程序的指定路径匹配的驱动程序。ZX_ERR_BUFFER_TOO_SMALL 表示驱动程序的绑定程序超过指令数上限 (BIND_PROGRAM_INSTRUCTIONS_)。

请求

名称类型
driver_filter vector<string>
iterator server_end<DriverInfoIterator>

GetNodeInfo

返回系统上运行的节点列表。

如果提供了 |node_filter|，则返回的列表将进行过滤，以仅包含过滤器中指定的节点。如果 |exact_match| 为 true，则过滤器必须与节点的拓扑路径完全匹配；否则，过滤器执行子字符串匹配。如果没有与过滤条件匹配的节点，则列表将为空。

出错时，|iterator| 会关闭，并显示以下表文：ZX_ERR_BAD_PATH 表示给定的路径无效。ZX_ERR_BUFFER_TOO_SMALL 表示指定路径过长，或节点具有的属性数量超过上限 (PROPERTIES_MAX)。

请求

名称类型
node_filter vector<string>
iterator server_end<NodeInfoIterator>
exact_match bool

RemoveTestNode

移除测试节点。系统会异步移除该节点，并且不能保证在它返回时一定会将其移除。

请求

名称类型
name string[1024]

响应

名称类型
payload Manager_RemoveTestNode_Result

RestartDriverHosts

重启所有包含由 driver_url 指定的驱动程序的驱动程序主机，并返回重启的驱动程序主机的数量。 |rematch_flags| 将用于确定现有驱动程序应针对哪些重启节点绑定，以及应针对哪些重启节点执行匹配过程。

请求

名称类型
driver_url fuchsia.url/Url
rematch_flags RestartRematchFlags

响应

名称类型
payload Manager_RestartDriverHosts_Result

NodeInfoIterator

在 fuchsia.driver.develop/iterators.fidl 中定义

GetNext

如果不再需要更多条目，则返回空值。

请求

<EMPTY>

响应

名称类型
nodes vector<NodeInfo>

结构

Manager_AddTestNode_Response

在 fuchsia.driver.develop/develop.fidl 中定义

<EMPTY>

Manager_BindAllUnboundNodes_Response

在 fuchsia.driver.develop/develop.fidl 中定义

字段类型说明默认
binding_result vector<NodeBindingInfo>[10]

因此而产生的新绑定的列表。

 无默认取景方式

Manager_DisableDriver_Response

在 fuchsia.driver.develop/develop.fidl 中定义

<EMPTY>

Manager_EnableDriver_Response

在 fuchsia.driver.develop/develop.fidl 中定义

<EMPTY>

Manager_RemoveTestNode_Response

在 fuchsia.driver.develop/develop.fidl 中定义

<EMPTY>

Manager_RestartDriverHosts_Response

在 fuchsia.driver.develop/develop.fidl 中定义

字段类型说明默认
count uint32 无默认取景方式

表

CompositeNodeInfo

在 fuchsia.driver.develop/types.fidl 中定义

包含复合节点的信息。

序数字段类型说明
parent_topological_paths vector<string>

此组合的父节点的拓扑路径，按索引排序。
topological_path string

所创建的复合节点的拓扑路径。如果未创建，则为空。
composite CompositeInfo

NodeBindingInfo

在 fuchsia.driver.develop/types.fidl 中定义

有关绑定到驱动程序或复合组件的节点的信息。

序数字段类型说明
node_name string[1024]

节点的完整拓扑名称。
driver_url fuchsia.url/Url

这是绑定到节点的驱动程序的组件网址。如果存在此属性，则不得有 |composite_parents| 和 |legacy_composite_parents|。
composite_parents vector<fuchsia.driver.framework/CompositeParent>

此节点绑定到的复合父级。 可以与 |legacy_composite_parents| 一同存在，但不能与 |driver_url| 一起存在。
legacy_composite_parents vector<fuchsia.driver.legacy/CompositeParent>

此节点绑定到的旧版复合父级。可与 |composite_parents| 一起显示，但不能与 |driver_url| 一起显示。

NodeInfo

在 fuchsia.driver.develop/types.fidl 中定义

序数字段类型说明
id uint64

用于标识节点的唯一 ID。
parent_ids vector<uint64>

代表父级的 ID 列表。如果有多个节点，则为复合节点。
child_ids vector<uint64>

代表子项的 ID 列表。
driver_host_koid zx/Koid

驱动程序所在的驱动程序主机的进程 KOID。
bound_driver_url fuchsia.url/Url

驱动程序组件清单的网址
versioned_info VersionedNodeInfo

特定于正在使用的驱动程序框架版本的信息。

已弃用：18 添加：17
moniker string[1024]

节点的相对集合名称。

添加日期：18
node_property_list vector<fuchsia.driver.framework/NodeProperty>[64]

节点的属性。

添加日期：18
offer_list vector<fuchsia.component.decl/Offer>

组件向节点提供内容。

添加日期：18

TestNodeAddArgs

在 fuchsia.driver.develop/types.fidl 中定义

序数字段类型说明
name string[1024]

节点名称。
properties vector<fuchsia.driver.framework/NodeProperty>[64]

节点的属性。

V1DeviceInfo

在 fuchsia.driver.develop/types.fidl 中定义

已弃用：18 添加：17

序数字段类型说明
topological_path string[1024]

驱动程序的拓扑路径。
bound_driver_libname string[1024]

驱动程序共享库的路径。
property_list fuchsia.driver.legacy/DevicePropertyList

设备的属性。
flags fuchsia.driver.legacy/DeviceFlags

跟踪设备的状态。
protocol_id uint32

Banjo 协议 ID
protocol_name string

Banjo 协议名称

V2NodeInfo

在 fuchsia.driver.develop/types.fidl 中定义

序数字段类型说明
moniker string[1024]

节点的相对集合名称。
node_property_list vector<fuchsia.driver.framework/NodeProperty>[64]

节点的属性。
offer_list vector<fuchsia.component.decl/Offer>

组件向节点提供内容。

联合

CompositeInfo 严格

在 fuchsia.driver.develop/types.fidl 中定义

包含复合或旧版复合的信息。

序数变体类型说明
legacy_composite fuchsia.driver.legacy/CompositeInfo
composite fuchsia.driver.framework/CompositeInfo

Manager_AddTestNode_Result 严格

在 fuchsia.driver.develop/develop.fidl 中定义

序数变体类型说明
response Manager_AddTestNode_Response
err fuchsia.driver.framework/NodeError
framework_err internal

Manager_BindAllUnboundNodes_Result 严格

在 fuchsia.driver.develop/develop.fidl 中定义

序数变体类型说明
response Manager_BindAllUnboundNodes_Response
err zx/Status
framework_err internal

Manager_DisableDriver_Result 严格

在 fuchsia.driver.develop/develop.fidl 中定义

序数变体类型说明
response Manager_DisableDriver_Response
err zx/Status
framework_err internal

Manager_EnableDriver_Result 严格

在 fuchsia.driver.develop/develop.fidl 中定义

序数变体类型说明
response Manager_EnableDriver_Response
err zx/Status
framework_err internal

Manager_RemoveTestNode_Result 严格

在 fuchsia.driver.develop/develop.fidl 中定义

序数变体类型说明
response Manager_RemoveTestNode_Response
err zx/Status
framework_err internal

Manager_RestartDriverHosts_Result 严格

在 fuchsia.driver.develop/develop.fidl 中定义

序数变体类型说明
response Manager_RestartDriverHosts_Response
err zx/Status
framework_err internal

VersionedNodeInfo 灵活

在 fuchsia.driver.develop/types.fidl 中定义

已弃用：18 添加：17
序数变体类型说明
v1 V1DeviceInfo
v2 V2NodeInfo

BITS

RestartRematchFlags灵活

类型：uint32

在 fuchsia.driver.develop/types.fidl 中定义

这些标志用于指示何时应该为正在重启的节点调用 |fuchsia.driver.index.DriverIndex::MatchDriver| 调用以查找新驱动程序，而不是重复使用先前绑定到该节点的驱动程序。

名称值说明
1

重新匹配当前绑定到所请求驱动程序的节点。所请求的驱动程序是启动重启操作的驱动程序网址。
2

重新匹配当前绑定到除所请求驱动程序以外的驱动程序的节点。这些节点是受所请求驱动程序重启影响的节点，例如，当它是共置父项时。
4

重新匹配旧版复合节点。
8

重新匹配作为已完成复合规范的一部分创建的节点。

常量

名称值类型说明
BINDING_RESULT_MAX 10 uint8
HASH_LENGTH 64 uint8
NODE_MONIKER_MAX 1024 uint32