fuchsia.driver.framework

属性键。

用于在匹配过程中评估属性值的条件。值必须为 ACCEPT 或 REJECT。

属性值的列表。不能为空。属性值必须属于同一类型。

属性键。

属性值。

具有 |node_properties| 的节点的名称。

属于名称为 |node_name| 的节点的节点属性。如果节点是复合节点，则 |properties| 为空，不包含其父节点的属性。

父级资源的绑定规则。属性键必须是唯一的。值不能为空。

用于与复合驱动程序的绑定规则进行匹配的属性。 键必须是唯一的，且基于字符串。

属性的键。

属性的值。

平台

ACPI

DEVICE_TREE

PCI

USB

GPIO

I2C

SPI

SDIO

UART

SPMI

USB_PERIPHERAL

VIRTIO

MISSING_ARGS

未提供复合节点规范的参数。

EMPTY_NODES

给定复合节点规范的 nodes 为空。

ALREADY_EXISTS

给定复合节点规范中的 name 与已创建的复合节点规范重复。

DRIVER_INDEX_FAILURE

未能将规范添加到驱动程序索引。

DUPLICATE_PARENTS

同时指定了 parents 和 parents2 字段。

未知

接受

拒绝

UNSTABLE_BETWEEN_DRIVER_RESTART

重启驱动程序后，设备地址可能会发生变化。

UNSTABLE_BETWEEN_BOOT

系统重启后，设备地址可能会发生变化。

UNSTABLE_BETWEEN_SOFTWARE_UPDATE

系统更新后，设备地址可能会发生变化。

稳健

在系统的生命周期内，总线上的设备地址保证稳定。

BOOT

BOOT 软件包位于 Zircon 启动映像中。

BASE

BASE 软件包作为静态本地软件包包含在 Fuchsia build 中。

CACHED

CACHED 软件包是 BASE 软件包，如果完整的软件包解析器可用，则可以在解析期间进行更新。

UNIVERSE

只有在由完整软件包解析器解析后，UNIVERSE 软件包才会安装到设备上。

TIMEOUT

驱动程序未在相应级别的截止时间内做出响应（调度程序卡住）。

INTERNAL_ERROR

路由检查时发生内部框架或传输错误。

NOT_SUPPORTED

不支持该驱动程序或请求的 HealthCheckRequest 级别。

INVALID_STATE

司机未处于“运行中”状态（例如，正在启动、正在停止、已暂停）。

目前无法购买

目前无法评估请求的级别：硬件已关机、已暂停、尚未初始化或暂时忙碌。使用方必须将其视为无信息，而不是不健康。PING 绝不能返回此值。

COMMUNICATION_ERROR

执行检查本身时发生总线、MMIO 或传输错误。

NOT_FOUND

没有绑定节点与请求的绰号（由 fuchsia.driver.development/Manager.RunHealthCheck 返回）匹配。

PING

仅软件活跃度：调度程序响应、锁可获取、内存中状态一致。无总线 I/O (I2C/SPI/DSI)；仅当已知块已通电且已计时时，才进行 MMIO 读取。绝不能返回 UNAVAILABLE。建议：< 1 毫秒。截止时间（由驱动程序主机强制执行）：250 毫秒。

快捷

有界限、非破坏性的硬件读取或进度窗口（等待一个帧周期以获取 TE/VSync 边缘，通过 I2C/DSI 读取状态寄存器）。不得清除“读取时清除”寄存器，也不得干扰活跃的 DMA 或扫描输出。建议：< 25 毫秒。截止日期：2 秒。

深

扩展自测 / BIST。在检查期间，可能会中断活跃的 I/O，但必须恢复之前的状态。仅在操作员明确请求（ffx / 实验室测试）时发出，绝不会在框架发起的扫描期间发出。建议：< 10 秒。截止日期：2 分钟。

确定

驱动程序和硬件在正常参数范围内运行。

DEGRADED

驱动程序正常运行，但错误率升高、资源泄露或质量下降。

运行状况不佳

驱动程序或底层硬件卡住、无响应或初始化失败。

INTERNAL

NODE_REMOVED

NAME_MISSING

NAME_INVALID

节点名称无效。具体而言，其名称中不得包含英文句点。

NAME_ALREADY_EXISTS

存在同名的同级节点。

OFFER_SOURCE_NAME_MISSING

此节点的优惠缺少来源名称。

OFFER_REF_EXISTS

此节点的优惠不应有来源或目标。

SYMBOL_NAME_MISSING

此节点的符号缺少名称。

SYMBOL_ADDRESS_MISSING

此节点的符号缺少地址。

SYMBOL_ALREADY_EXISTS

此节点还有另一个同名符号。

UNBIND_CHILDREN_IN_PROGRESS

节点正在解除与其所有子节点的绑定。

UNSUPPORTED_ARGS

节点包含不受支持的参数，例如已弃用的属性键或优惠。

DUPLICATE_PROPERTY_KEYS

节点包含多个具有相同键的属性。

OFFER_SOURCE_INSTANCE_FILTER_MISSING

节点缺少源实例过滤条件，

OFFER_RENAMED_INSTANCES_MISSING

节点缺少重命名的实例，

1

此节点所在的公交线路类型。

2

一个唯一标识符，用于描述此设备在给定总线上的身份。

3

地址的稳定性。

1

驱动程序的复合绑定规则中指定的复合名称。

2

面向驾驶员的一般信息。

1

已匹配的复合驱动程序的信息。

2

所有父级名称的列表，按索引排序。 这些名称来自驱动程序的复合绑定规则中的节点定义。

3

主节点索引。由驱动程序的复合绑定规则中的主节点标识。

1

创建此复合节点规范时所用的规范信息。

2

节点规范的信息，仅在驱动程序与此规范的父级中的属性匹配时可用。

1

复合节点规范的名称。

3

复合节点规范中的节点。不得为空。第一个节点是主节点。

4

驱动程序主机的标识符，绑定到此节点规范的驱动程序应位于其中。指定相同标识符的所有驱动程序都将并置到同一驱动程序主机中。如果驱动程序主机尚未启动，则会在节点绑定时启动。

1

有关此复合元数据作为父级的信息。

2

此父级在规范的父级中的索引。

1

资源必须符合选择器的约束条件才能被依赖。

2

为驱动程序绑定而标记到资源的其他属性

1

这是要安装在 devfs 中的连接器。 当客户端连接到文件系统中的此节点时，系统会调用 Connect()。 可选：如果未提供此参数，则 devfs 中将显示一个空节点。

2

这是用于在 devfs 中安装此节点的类名称。 该节点将放置在 /dev/class/{class_name} 中。 如果 /dev/class/ 下不存在 class_name，系统会创建它。 可选：如果未提供此参数，则系统只会通过拓扑路径添加节点。

3

这是将安装在 devfs 中的检查数据的 vmo。 可选：如果未提供此参数，则 devfs 的检查数据将为空。

4

给定 |connector| 支持的连接类型。 驱动程序框架应处理连接器不支持的连接类型。 如果未提供，则系统会假定连接器仅支持设备类型。

5

这是要安装在 devfs 中的控制器连接器。 当客户端连接到文件系统中此节点的 device_controller 连接时，系统会调用 Connect()。 可选：如果未提供此参数，则节点将以原生方式处理连接。 此选项只能由兼容性 shim 使用或在测试中使用

1

2

1

驱动程序组件的网址。

2

驱动程序的名称，取自驱动程序中 ZIRCON_DRIVER 宏的第一个字段。

3

如果此值为 true，则驱动程序应与其父级的 DriverHost 位于同一位置。

4

此驱动程序所在的软件包类型。

5

如果此值为 true，则表示该驱动程序是后备驱动程序。后备驱动程序的绑定优先级较低，因此只有在没有匹配的非后备驱动程序时，系统才会选择后备驱动程序进行绑定。

6

设备类别

7

绑定规则，用于声明要评估的一组限制条件，以确定驱动程序索引器是否应将此驱动程序绑定到设备。

8

此驱动程序使用的驱动程序框架的版本。 支持的值为 1 (DFv1) 和 2 (DFv2)。 如果未提供，则假定版本为 1。

9

司机是否已停用。如果为 true，则不会选择此驱动程序来绑定到节点。

1

驱动程序绑定到的节点。

2

为 |node| 提供给驱动程序的符号。这些符号来自添加了 |node| 的驱动程序，并经过滤，仅保留绑定程序中请求的符号。

3

包含驱动程序的软件包的网址。这纯粹是信息性的，仅用于提供数据以供检查。

4

首先，请提供驾驶员的相关信息。目前，我们支持以下条目：

1. “binary”：一个字符串，包含驱动程序二进制文件的软件包相对路径。
2. “colocate”（可选）：一个包含“true”或“false”的字符串，用于指定驱动程序是否应与添加 |node| 的驱动程序位于同一驱动程序主机中。如果未指定，驱动程序将在新的驱动程序主机中启动。
3. “default_dispatcher_opts”（可选）：一个字符串数组，用于指定创建默认调度程序的选项。字符串可以是以下任一项：
   • allow_sync_calls：允许在默认调度程序的线程上进行同步调用。
4. “default_dispatcher_scheduler_role”（可选）：为驱动程序创建的默认调度程序设置的调度程序角色。

5

提供给驱动程序的传入命名空间。

6

由驱动程序提供的传出目录。

7

传递给驱动程序的配置。

8

驱动程序绑定到的节点的名称。

10

驱动程序所绑定到的节点的节点优惠。

11

提供一个表示此节点的令牌，该令牌可与驱动程序框架交换，以辨别有关此节点的其他信息。

12

13

驱动程序映射到的根 VMAR。如果所有子映射都希望应用相同的调度器配置文件，则应将其放入此 VMAR 中。

14

与驱动程序的电源元素相关的句柄，这些元素位于通过 fuchsia.power.SuspendEnabled 配置功能启用挂起的产品上。 如果驱动程序的清单在其清单的程序部分中包含 suspend_enabled = "true"，则 element_server、lessor_client 和 token 会传递给驱动程序，否则句柄会由驱动程序主机保留。control_client 始终由驱动程序主机保留，绝不会传递给驱动程序。

15

日志接收器渠道。

1

针对整个驱动程序（电源模式、活动计数器、上次事件时间戳）而非单个条件的诊断键值对遥测。

2

有效故障或警告条件。当驱动程序运行状况良好 (HealthStatus.OK) 时，此字段不存在或为空。总体驱动程序状态是 conditions (UNHEALTHY > DEGRADED > OK) 中的最高严重级别，如果不存在或为空，则为 OK。

1

此条件的严重程度。使用方会将省略或无法识别的值视为 UNHEALTHY，因此请务必设置该值。

2

机器可读的简短令牌（例如“DSI_CRI_FIFO_WEDGED”“TE_INTERRUPT_STALLED”）。在响应中必须是唯一的。

3

此条件的人类可读详细信息。

4

此条件特有的诊断值。

5

首次观察到此情况的启动时间轴时刻。

6

最近一次观察到此条件的启动时间轴时刻。

7

自 first_observed 以来观察到此情况的次数。

1

2

1

节点的名称。

3

要提供给绑定到此节点的驱动程序的函数。

5

有关如何将此节点添加到 devfs 的参数。

6

要提供给绑定到此节点的驱动程序的功能。 驱动程序必须确保在添加子节点之前，将这些功能添加到其传出目录或 |offers_dictionary|（如果其中任何一个属于 |dictionary_offer| 类型）中。

7

输入到设备结构化总线拓扑中的信息。它只能由总线驱动程序指定，最好是默认包含的总线驱动程序。

8

节点的属性。

9

这可用于通过字典向绑定到此节点的驱动程序提供其他 offer。用户必须使用 |offers2| 字段为此字典中存在的优惠指定 |dictionary_offer| 类型的优惠。

10

驱动程序主机的标识符，绑定到此节点的驱动程序应位于其中。 指定相同标识符的所有驱动程序都将并置到同一驱动程序主机中。 如果驱动程序主机尚未启动，则会在节点绑定时启动。仅当驱动程序直接绑定到此节点时，系统才会遵循此属性。如果复合节点绑定到此节点，则系统会忽略此字段，因为应改为在复合节点规范中表示。

1

提供一个表示此节点的令牌，该令牌可与驱动程序框架交换，以辨别有关此节点的其他信息。

1

如果此值为 true，则节点会先与其匹配的驱动程序解除绑定，然后再尝试通过正常绑定过程进行绑定。

2

如果设置了此字段，则在绑定时只会考虑与此网址后缀匹配的驱动程序。 例如：“gpt.cm”“meta/gpt.cm”“fuchsia-boot:///#meta/gpt.cm”。

1

符号的名称。

2

符号的虚拟地址，位于驱动程序主机的进程内。

3

提供符号的模块名称。 如果符号来自主要父级，则不会提供此信息。

1

2

3

4

1

资源的名称。必填。

2

资源的属性。必填。

3

资源向依赖于它的节点提供的功能。必填。

4

输入到设备结构化总线拓扑中的信息。只有总线驱动程序（最好是默认包含的总线驱动程序）才应指定此属性。可选。

1

资源必须包含这些优惠。

2

资源必须包含这些属性。属性键必须是唯一的，选择器才会被视为有效。

3

资源不得包含这些属性。

1

2

3

1

固定的整数 ID，例如 SPI 总线地址

2

整数数组，例如 PCI BDF。

3

一个 uint32 值，可解读为 4 字符序列。

4

字符序列数组，例如 ACPI 节点路径。

5

通用字符串，例如设备树节点路径。

1

属于驱动程序已成功启动的节点的令牌。

2

节点未能找到匹配的驱动程序或复合规范。

3

绑定到节点的驱动程序未能成功启动。

1

2

3

1

2

3

1

2

3

1

驱动程序检测到内部硬件或软件故障，或从之前报告的故障中恢复（当 conditions 为空时）。 边缘触发：在驱动程序的整体状态恶化时（正常 -> 降级，降级 -> 运行状况不佳）发送，并在恢复时再次发送（conditions 为空）；绝不会在每次发生已报告的状况时发送。

2

由于上游依赖项（父级/总线/时钟/电源/寄存器提供方）无响应或无效，驱动程序无法继续运行。

3

由于下游使用方（子级/客户端）被卡住或无法排空队列/缓冲区，驱动程序无法继续运行。

1

2

3

4

5

启动时间轴时刻，例如上次中断或输入报告的时间。

1

2

3

1

2

3

1

2

3

1

2

3

1

2

3

4

1

2

3

1

2

3

1

2

3

位于 |offers_dictionary| 中的 offer。对于所有其他用途（例如绑定属性生成），这等同于 |zircon_transport| offer。