fuchsia.hardware.platform.bus

新增時間：HEAD

通訊協定

伊歐姆

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

GetBti

要求

名稱類型
iommu_index uint32
bti_id uint32

回應

名稱類型
payload Iommu_GetBti_Result

PlatformBus

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

AddCompositeNodeSpec

新增含有 |node| 的複合節點規格其中一項 複合節點的父項為了達成這個目的 這個方法會新增 |node| 指定的平台裝置節點為 月台匯流排的子項此外， fuchsia.driver.framework.ParentSpec 已新增至 |spec|符合 加入新的平台裝置節點複合繫結規則應包含 與 |node| 適當條件相符的的節拍才能接受繫結 要用於比對 CompositeNodeSpec 的規則。

要求

名稱類型
node Node
spec fuchsia.driver.framework/CompositeNodeSpec

回應

名稱類型
payload PlatformBus_AddCompositeNodeSpec_Result

GetBoardInfo

董事會駕駛可能會使用這項資訊取得 Jamboard 相關資訊，以及 區分他們支援的多個面板

要求

<空白>

回應

名稱類型
payload PlatformBus_GetBoardInfo_Result

NodeAdd

使用提供的設定，將平台裝置節點新增至匯流排 由 |node| 提供。平台裝置節點是 驅動程式庫主機。

要求

名稱類型
node Node

回應

名稱類型
payload PlatformBus_NodeAdd_Result

RegisterSysSuspendCallback

註冊平台匯流排在暫停時叫用的回呼。

新增時間：HEAD

要求

名稱類型
suspend_cb SysSuspend

回應

名稱類型
payload PlatformBus_RegisterSysSuspendCallback_Result

SetBoardInfo

衝浪板駕駛可以使用這個檔案設定 Jamboard 的相關資訊。

要求

名稱類型
info BoardInfo

回應

名稱類型
payload PlatformBus_SetBoardInfo_Result

SetBootloaderInfo

主機板驅動程式可以使用這項設定設定系統啟動載入程式的相關資訊。

新增時間：HEAD

要求

名稱類型
info BootloaderInfo

回應

名稱類型
payload PlatformBus_SetBootloaderInfo_Result

SysSuspend

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

可以向平台註冊實作這項通訊協定的伺服器 來接收回呼，瞭解平台匯流排暫停的原因。

新增時間：HEAD

Callback

平台匯流排在呼叫暫停掛鉤時叫用。

要求

名稱類型
enable_wake bool
suspend_reason uint8

回應

名稱類型
out_status zx/Status

結構

Iommu_GetBti_Response 資源

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

欄位類型說明預設
bti handle<bti> 無預設

PlatformBus_AddCompositeNodeSpec_Response

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

<空白>

PlatformBus_GetBoardInfo_Response

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

欄位類型說明預設
info TemporaryBoardInfo 無預設

PlatformBus_NodeAdd_Response

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

<空白>

PlatformBus_RegisterSysSuspendCallback_Response

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

<空白>

PlatformBus_SetBoardInfo_Response

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

<空白>

PlatformBus_SetBootloaderInfo_Response

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

<空白>

TemporaryBoardInfo

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

這原本來自 Banjo fuchsia.hardware.platform.device 程式庫 但會暫時保留在這裡，直到遷移至 FIDL 為止。

欄位類型說明預設
vid uint32

開發板的供應商 ID。

 無預設
pid uint32

開發板的產品 ID。

 無預設
board_name string[32]

開機映像檔平台 ID 記錄中的主面板名稱。 或是 x86 平台上的 BIOS。

 無預設
board_revision uint32

主面板特定修訂版本編號。

 無預設

ENUMS

ZirconInterruptMode 嚴格

類型：uint32

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

建立 Zircon 中斷的模式。與 ZX_INTERRUPTMODE* 值同步 來自 //zircon/system/public/zircon/types.h 的檔案。

名稱值說明
0
2
4
6
8
10

資料表

BoardInfo

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

由董事會驅動程式庫設定的主面板資訊。

Ordinal欄位類型說明
board_name string[32]

開機映像檔平台 ID 記錄中的主面板名稱，或 x86 平台上的 BIOS。
board_revision uint32

主面板特定修訂版本編號。

BootMetadata

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

要透過 ZBI 記錄從系統啟動載入程式傳遞的裝置中繼資料。

Ordinal欄位類型說明
zbi_type uint32

中繼資料類型 (與系統啟動載入程式中繼資料比對 zbi_header_t.type)。
zbi_extra uint32

比對 zbi_header_t.extra 與系統啟動載入程式中繼資料。 用於系統啟動載入程式提供相同類型的多個中繼資料記錄。

BootloaderInfo

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

由主機驅動程式庫設定的系統啟動載入程式資訊。

新增時間：HEAD

Ordinal欄位類型說明
vendor string[32]

Bti

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

平台裝置節點的公車交易啟動者 (bti) 定義。

Ordinal欄位類型說明
iommu_index uint32
bti_id uint32
name string[128]

可用於擷取 bti 的 fuchsia.hardware.platform.device/GetBtiByName. 您可以將其留空，但資源只能 使用 fuchsia.hardware.platform.device/GetBtiById 擷取。

Irq

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

Ordinal欄位類型說明
irq uint32
mode ZirconInterruptMode

設定中斷模式的位元旗標。
properties vector<fuchsia.driver.framework/NodeProperty>[64]

此中斷片段的屬性。僅適用於 DFv2。
name string[128]

可用來擷取 irq 中的名稱 fuchsia.hardware.platform.device/GetInterruptByName. 您可以將其留空，但資源只能 使用 fuchsia.hardware.platform.device/GetInterruptById 擷取。

中繼資料

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

代表平台裝置可用的中繼資料。

Ordinal欄位類型說明
type uint32

中繼資料類型。
data vector<uint8>

中繼資料位元組。

Mmio

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

平台裝置節點的 MMIO 資源定義。

Ordinal欄位類型說明
base uint64

MMIO 區域的實際地址。不需要對齊頁面。
length uint64

MMIO 區域的長度，以位元組為單位。不需要對齊頁面。
name string[128]

可用於擷取 Mmio 的名稱 fuchsia.hardware.platform.device/GetMmioByName. 您可以將其留空，但資源只能 使用 fuchsia.hardware.platform.device/GetMmioById 擷取。

節點

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

將平台裝置節點新增至平台匯流排的引數。

Ordinal欄位類型說明
name string[128]

節點名稱。
vid uint32

BIND_PLATFORM_DEV_VID
pid uint32

BIND_PLATFORM_DEV_PID
did uint32

BIND_PLATFORM_DEV_DID
instance_id uint32

執行個體 ID。提供給裝置名稱 (數值為零時)。 BIND_PLATFORM_DEV_INSTANCE_ID
mmio vector<Mmio>

MMIO 區域。
irq vector<Irq>

中斷。
bti vector<Bti>

BTI。
smc vector<Smc>

SMC 呼叫。
metadata vector<Metadata>

中繼資料
boot_metadata vector<BootMetadata>

啟動中繼資料 (來自 ZBI 項目)
properties vector<fuchsia.driver.framework/NodeProperty>[64]

BIND_PLATFORM_DEV_VID、BIND_PLATFORM_DEV_PID 和 BIND_PLATFORM_DEV_DID 以外的其他節點屬性。
power_config vector<fuchsia.hardware.power/PowerElementConfiguration>[32]

Smc

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

安全監控呼叫 (SMC) 的定義，能讓使用者從使用者空間呼叫。

Ordinal欄位類型說明
service_call_num_base uint32

裝置有權使用範圍介於 SMC 的電話號碼撥打 SMC 電話 service_call_num_base 到 service_call_num_base + count - 1。
count uint32
exclusive bool

裝置擁有這個 SFc 範圍的專屬存取權。
name string[128]

可用於擷取 smc 的名稱 fuchsia.hardware.platform.device/GetSmcByName. 您可以將其留空，但資源只能 使用 fuchsia.hardware.platform.device/GetSmcById 擷取。

聯合國

Iommu_GetBti_Result 嚴格 資源

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

OrdinalVariant類型說明
response Iommu_GetBti_Response
err zx/Status

PlatformBus_AddCompositeNodeSpec_Result 嚴格

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

OrdinalVariant類型說明
response PlatformBus_AddCompositeNodeSpec_Response
err zx/Status

PlatformBus_GetBoardInfo_Result 嚴格

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

OrdinalVariant類型說明
response PlatformBus_GetBoardInfo_Response
err zx/Status

PlatformBus_NodeAdd_Result 嚴格

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

OrdinalVariant類型說明
response PlatformBus_NodeAdd_Response
err zx/Status

PlatformBus_RegisterSysSuspendCallback_Result 嚴格

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

OrdinalVariant類型說明
response PlatformBus_RegisterSysSuspendCallback_Response
err zx/Status

PlatformBus_SetBoardInfo_Result 嚴格

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

OrdinalVariant類型說明
response PlatformBus_SetBoardInfo_Response
err zx/Status

PlatformBus_SetBootloaderInfo_Result 嚴格

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

OrdinalVariant類型說明
response PlatformBus_SetBootloaderInfo_Response
err zx/Status

觀測站

名稱值類型說明
MAX_INFO_STRING_LENGTH 32 uint32
MAX_POWER_CONFIGS 32 uint32

服務

服務

定義於 fuchsia.hardware.platform.bus/platform-bus.fidl

名稱類型傳輸
platform_bus fuchsia.hardware.platform.bus/PlatformBus 駕駛座
碘 fuchsia.hardware.platform.bus/Iommu 駕駛座