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 版本中。

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 秒。Deadline: 2min.

確定

驅動程式和硬體在正常參數範圍內運作。

DEGRADED

驅動程式可正常運作，但錯誤率偏高、資源外洩或品質下降。

UNHEALTHY

驅動程式或基礎硬體卡住、沒有回應或無法初始化。

內部

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

專屬 ID，用於描述此裝置在指定匯流排上的身分。

3

位址的穩定性。

1

驅動程式庫複合繫結規則中指定的複合名稱。

2

驅動程式庫的一般資訊。

1

相符複合驅動程式庫的資訊。

2

所有父項名稱的清單，依索引排序。這些名稱來自驅動程式庫複合繫結規則中的節點定義。

3

主要節點索引。由驅動程式庫複合繫結規則中的主要節點識別。

1

建立這個複合節點規格時使用的規格資訊。

2

節點規格的資訊，只有在驅動程式庫與這個規格父項中的屬性相符時，才能使用。

1

複合節點規格的名稱。

3

複合節點規格中的節點，不得留空。第一個節點是主要節點。

4

驅動程式代管程序的 ID，繫結至這個節點規格的驅動程式庫應位於其中。指定相同 ID 的所有驅動程式，都會集中在同一個驅動程式庫代管程序中。如果驅動程式代管程序尚未啟動，則會在節點繫結時啟動。

1

此複合資料的子項複合資料相關資訊。

2

這個父項在規格父項中的索引。

1

資源必須符合選取器的限制，才能做為依附元件。

2

標記至資源的其他屬性，用於驅動程式庫繫結

1

這是要安裝在 devfs 中的連接器。當用戶端連線至檔案系統中的這個節點時，系統會呼叫 Connect()。選用：如未提供，devfs 中會顯示空白節點。

2

這是用於在 devfs 中安裝這個節點的類別名稱。節點會放在 /dev/class/{class_name} 中。如果 /dev/class/ 下沒有 class_name，系統會建立該目錄。選用：如未提供，則只會透過拓撲路徑新增節點。

3

這是檢查資料的 VMO，將安裝在 devfs 中。選用：如未提供，devfs 的檢查資料會留空。

4

指定 |connector| 支援的連線類型。驅動程式庫架構應處理連接器不支援的連線類型。如未提供，則系統只會假設連接器支援裝置類型。

5

這是要安裝在 devfs 中的控制器連接器。當用戶端連線至檔案系統中這個節點的 device_controller 連線時，系統會呼叫 Connect()。選用：如未提供，節點會以原生方式處理連線。這個選項僅限相容性填充碼或測試使用

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

這可用於透過字典，向繫結至這個節點的驅動程式庫提供額外優惠。使用者必須使用 |offers2| 欄位，為這個字典中存在的優惠指定 |dictionary_offer| 類型優惠。

10

驅動程式代管程序的 ID，繫結至這個節點的驅動程式庫應位於其中。指定相同 ID 的所有驅動程式，都會集中在同一個驅動程式代管程序。如果驅動程式代管程序尚未啟動，則會在節點繫結時啟動。只有在驅動程式庫直接繫結至這個節點時，系統才會遵循這項設定。如果複合節點繫結至這個節點，系統會忽略這個欄位，因為這個欄位應改為在複合節點規格中表示。

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 為空白時)。邊緣觸發：在驅動程式庫的整體狀態惡化時傳送 (OK->DEGRADED、DEGRADED->UNHEALTHY)，並在恢復時再次傳送空白 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| 中的供應項目。這相當於 |zircon_transport| 供應項目，適用於所有其他用途 (例如繫結屬性產生)。