协议
设备
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
GetBoardInfo
返回有关设备连接到的开发板的信息。
请求
<EMPTY>
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetBoardInfo_Result
|
GetBtiById
返回指定 |index| 的总线事务发起程序 (bti) 句柄。
- 如果 |index| 等于或大于 btis 的数量，则会发生
ZX_ERR_OUT_OF_RANGE错误。 - 如果检索到的 bti 无效，则会出现错误
ZX_ERR_INTERNAL。
请求
| 名称 | 类型 |
|---|---|
index |
uint32
|
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetBtiById_Result
|
GetBtiByName
返回给定 |name| 的总线事务发起程序 (bti) 句柄。
- 如果 |name| 为空字符串，则会发生
ZX_ERR_INVALID_ARGS错误。 - 如果未找到 |name|，则会发生
ZX_ERR_OUT_OF_RANGE错误。 - 如果检索到的 bti 无效，则会出现错误
ZX_ERR_INTERNAL。
请求
| 名称 | 类型 |
|---|---|
name |
string[128]
|
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetBtiByName_Result
|
GetInterruptById
返回给定 |index| 的中断句柄。|flags| 将作为 |options| 参数转发到 zx_interrupt_create。
- 如果 |index| 等于或大于中断次数，则会返回
ZX_ERR_OUT_OF_RANGE错误。 - 如果检索到的中断无效，则会发生
ZX_ERR_INTERNAL错误。
请求
| 名称 | 类型 |
|---|---|
index |
uint32
|
flags |
uint32
|
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetInterruptById_Result
|
GetInterruptByName
返回给定 |name| 的中断句柄。|flags| 将作为 |options| 参数转发到 zx_interrupt_create。
- 如果 |name| 为空字符串，则会发生
ZX_ERR_INVALID_ARGS错误。 - 如果未找到 |name|，则会发生
ZX_ERR_OUT_OF_RANGE错误。 - 如果检索到的中断无效，则会发生
ZX_ERR_INTERNAL错误。
请求
| 名称 | 类型 |
|---|---|
name |
string[128]
|
flags |
uint32
|
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetInterruptByName_Result
|
GetMetadata
返回与设备和 |type| 关联的元数据。如果元数据不存在，则返回 ZX_ERR_NOT_FOUND。
请求
| 名称 | 类型 |
|---|---|
type |
uint32
|
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetMetadata_Result
|
GetMmioById
返回指定 |index| 的内存映射 IO (MMIO) 资源。
- 如果 |index| 等于或大于 mmios 数量，则会发生
ZX_ERR_OUT_OF_RANGE错误。 - 如果检索到的 mmio 无效，则会发生
ZX_ERR_INTERNAL错误。 - 如果检索到的 mmio 的基地址为 NULL，则会显示错误
ZX_ERR_NOT_FOUND。
请求
| 名称 | 类型 |
|---|---|
index |
uint32
|
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetMmioById_Result
|
GetMmioByName
返回指定 |name| 的内存映射 IO (MMIO) 资源。
- 如果 |name| 为空字符串，则会发生
ZX_ERR_INVALID_ARGS错误。 - 如果未找到 |name|，则会发生
ZX_ERR_OUT_OF_RANGE错误。 - 如果检索到的 mmio 无效，则会发生
ZX_ERR_INTERNAL错误。 - 如果检索到的 mmio 基地址为 NULL，则返回错误
ZX_ERR_NOT_FOUND。
请求
| 名称 | 类型 |
|---|---|
name |
string[128]
|
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetMmioByName_Result
|
GetNodeDeviceInfo
返回与驱动程序已绑定的节点对应的设备的相关信息。
请求
<EMPTY>
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetNodeDeviceInfo_Result
|
GetPowerConfiguration
返回驱动程序绑定到的设备的电源配置。
请求
<EMPTY>
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetPowerConfiguration_Result
|
GetSmcById
返回指定 |index| 的安全监控调用 (smc) 句柄。
- 如果 |index| 等于或大于 smcs 数量，则会显示
ZX_ERR_OUT_OF_RANGE错误。 - 如果检索到的 smc 无效，则会发生
ZX_ERR_INTERNAL错误。
请求
| 名称 | 类型 |
|---|---|
index |
uint32
|
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetSmcById_Result
|
GetSmcByName
返回给定 |name| 的安全监视器调用 (smc) 句柄。
- 如果 |name| 为空字符串，则会发生
ZX_ERR_INVALID_ARGS错误。 - 如果未找到 |name|，则会发生
ZX_ERR_OUT_OF_RANGE错误。 - 如果检索到的 smc 无效，则会发生
ZX_ERR_INTERNAL错误。
请求
| 名称 | 类型 |
|---|---|
name |
string[128]
|
响应
| 名称 | 类型 |
|---|---|
payload |
Device_GetSmcByName_Result
|
结构体
Device_GetBtiById_Response 资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
bti |
handle<bti>
|
无默认设置 |
Device_GetBtiByName_Response 资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
bti |
handle<bti>
|
无默认设置 |
Device_GetInterruptById_Response 资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
irq |
handle<interrupt>
|
无默认设置 |
Device_GetInterruptByName_Response 资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
irq |
handle<interrupt>
|
无默认设置 |
Device_GetMetadata_Response
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
metadata |
vector<uint8>
|
无默认设置 |
Device_GetPowerConfiguration_Response
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
config |
vector<fuchsia.hardware.power/PowerElementConfiguration>[32]
|
无默认设置 |
Device_GetSmcById_Response 资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
smc |
handle<resource>
|
无默认设置 |
Device_GetSmcByName_Response 资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
smc |
handle<resource>
|
无默认设置 |
表
BoardInfo
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
vid |
uint32
|
开发板的供应商 ID。 |
2 |
pid |
uint32
|
开发板的产品 ID。 |
3 |
board_name |
string[32]
|
启动映像平台 ID 记录（或 x86 平台上的 BIOS）中的板级名称。 |
4 |
board_revision |
uint32
|
板级修订版本号。 |
Mmio 资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
offset |
zx/Off
|
从 VMO（mmio 区域开始）的起始偏移量。 |
2 |
size |
uint64
|
mmio 区域的大小。 |
3 |
vmo |
handle<vmo>
|
应映射到驱动程序地址空间的虚拟内存对象。 |
NodeDeviceInfo
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
vid |
uint32
|
供应商 ID，在 //zircon/system/ulib/ddk-platform-defs/include/lib/ddk/platform-defs.h 中指定 |
2 |
pid |
uint32
|
平台 ID，在 //zircon/system/ulib/ddk-platform-defs/include/lib/ddk/platform-defs.h 中指定 |
3 |
did |
uint32
|
设备 ID，在 //zircon/system/ulib/ddk-platform-defs/include/lib/ddk/platform-defs.h 中指定 |
4 |
mmio_count |
uint32
|
提供给此设备的 MMIO 区域的数量。 |
5 |
irq_count |
uint32
|
向此设备提供的中断次数。 |
6 |
bti_count |
uint32
|
提供给此设备的总线事务发起者的数量。 |
7 |
smc_count |
uint32
|
向此设备提供的安全监控调用资源的数量。 |
8 |
metadata_count |
uint32
|
为此设备提供的关联的元数据 blob 的数量。 |
9 |
name |
string[32]
|
板驱动程序为此设备提供的名称。 |
联合体
Device_GetBoardInfo_Result 严格
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
BoardInfo
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
Device_GetBtiById_Result 严格 资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
Device_GetBtiById_Response
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
Device_GetBtiByName_Result 严格资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
Device_GetBtiByName_Response
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
Device_GetInterruptById_Result 严格 资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
Device_GetInterruptById_Response
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
Device_GetInterruptByName_Result 严格 资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
Device_GetInterruptByName_Response
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
Device_GetMetadata_Result 严格
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
Device_GetMetadata_Response
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
Device_GetMmioById_Result 严格资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
Mmio
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
Device_GetMmioByName_Result 严格资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
Mmio
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
Device_GetNodeDeviceInfo_Result strict
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
NodeDeviceInfo
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
Device_GetPowerConfiguration_Result 严格
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
Device_GetPowerConfiguration_Response
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
Device_GetSmcById_Result 严格资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
Device_GetSmcById_Response
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
Device_GetSmcByName_Result 严格资源
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 序数 | 变体 | 类型 | 说明 |
|---|---|---|---|
1 |
response |
Device_GetSmcByName_Response
|
|
2 |
err |
zx/Status
|
|
3 |
framework_err |
internal
|
服务
服务
在 fuchsia.hardware.platform.device/platform-device.fidl 中定义
| 名称 | 类型 | 传输 |
|---|---|---|
| 设备 |
fuchsia.hardware.platform.device/Device
|
频道 |