fuchsia.thermal

新增：7

协议

ClientStateConnector

在 fuchsia.thermal/client_state.fidl 中定义

允许客户端将 ClientStateWatcher 连接到给定 ClientType 的热状态。

关联

将 ClientStateWatcher 连接到指定 ClientType 的热状态。

客户端可以调用此方法，并立即开始使用 ClientStateWatcher 客户端端点。

如果 client_type 与中央散热配置中找到的客户端条目不完全匹配（区分大小写），则请求将失败。如果失败，watcher 服务器端点以及当前的 ClientStateConnector 连接都将终止。

  • client_type 指定 watcher 应连接到的客户端特定热状态。仅当该值与中央散热配置中找到的客户端条目匹配时，该值才有效。

  • watcher 是 ClientStateWatcher 通道的服务器端点，该通道将连接到 client_type 的热状态。

请求

名称类型
client_type ClientType
watcher server_end:ClientStateWatcher

ClientStateWatcher

在 fuchsia.thermal/client_state.fidl 中定义

允许客户端监控其热状态的变化。

此协议无法直接连接到服务。相反，ClientStateWatcher 通道的服务器端点必须使用 [ClientStateConnector.Connect'] method. The client endpoint of a ClientStateWatcher` 通道连接到所需客户端类型的热状态，只有通过这种方式连接后，该通道才有用。

观看

监视客户端的热状态变化。

客户端的热状态根据其特定类型的中央热配置确定。如需了解详情，请参阅 README.md。

在给定连接上，第一次调用将立即返回客户端的当前热状态。只有在客户端的热状态发生变化时，后续 Watch 请求才会返回新的 state。这遵循挂起获取模式。

  • state 是一个无符号整数，表示客户端的热状态。

请求

<EMPTY>

响应

名称类型
state uint64

SensorManager

在 fuchsia.thermal/sensor_manager.fidl 中定义

管理热传感器交互和工作状态的接口。

添加：HEAD

ClearTemperatureOverride

清除由 SetTemperatureOverride 设置的温度覆盖。 如果未设置温度替换值，此互动不会执行任何操作。

如果未找到具有给定 name 的传感器，则返回 ClearTemperatureOverrideError.SENSOR_NOT_FOUND。

请求

名称类型
name fuchsia.hardware.temperature/SensorName

响应

名称类型
payload SensorManager_ClearTemperatureOverride_Result

关联

连接到具有给定 name 的热传感器。

如果未提供任何必需参数，则返回 ConnectError.INVALID_ARGUMENTS。

如果未找到具有给定 name 的传感器，则返回 ConnectError.SENSOR_NOT_FOUND。

请求

名称类型
payload SensorManagerConnectRequest

响应

名称类型
payload SensorManager_Connect_Result

ListSensors

列出可由客户端控制和连接的传感器。

请求

<EMPTY>

响应

名称类型
payload SensorManager_ListSensors_Result

SetTemperatureOverride

使用 name 为传感器设置替换温度。

设置替换温度后，内部热政策将使用替换温度。从 Connect 提供的传感器连接中检索到的温度值也会收到替换温度。

此互动不会影响热传感器本身。 直接连接到传感器而不使用 Connect 的客户端将收到实际传感器值。

如果未找到具有给定 name 的传感器，则返回 SetTemperatureOverrideError.SENSOR_NOT_FOUND。

请求

名称类型
name fuchsia.hardware.temperature/SensorName
override_temperature float32

响应

名称类型
payload SensorManager_SetTemperatureOverride_Result

STRUCTS

SensorManager_ClearTemperatureOverride_Response

在 fuchsia.thermal/sensor_manager.fidl 中定义

<EMPTY>

SensorManager_Connect_Response

在 fuchsia.thermal/sensor_manager.fidl 中定义

<EMPTY>

SensorManager_ListSensors_Response

在 fuchsia.thermal/sensor_manager.fidl 中定义

字段类型说明默认
sensors vector<SensorInfo> 无默认应用

SensorManager_SetTemperatureOverride_Response

在 fuchsia.thermal/sensor_manager.fidl 中定义

<EMPTY>

枚举

ClearTemperatureOverrideError 灵活

类型：uint32

在 fuchsia.thermal/sensor_manager.fidl 中定义

调用 SensorManager.ClearTemperatureOverrideError 时返回的错误。

添加：HEAD

名称值说明
1
2

ConnectError flexible

类型：uint32

在 fuchsia.thermal/sensor_manager.fidl 中定义

调用 SensorManager.ConnectError 时返回的错误。

添加：HEAD

名称值说明
1
2
3

SetTemperatureOverrideError flexible

类型：uint32

在 fuchsia.thermal/sensor_manager.fidl 中定义

调用 SensorManager.SetTemperatureOverride 时返回的错误。

添加：HEAD

名称值说明
1
2

TABLES

SensorInfo

在 fuchsia.thermal/sensor_manager.fidl 中定义

传感器的相关信息。

添加：HEAD

序数字段类型说明
name fuchsia.hardware.temperature/SensorName

唯一的板级传感器名称/类型标识符（例如，由客户端热配置匹配，并在 Starnix 中公开为 thermal_zone<N>/type）。

SensorManagerConnectRequest 资源

在 fuchsia.thermal/sensor_manager.fidl 中定义

序数字段类型说明
name fuchsia.hardware.temperature/SensorName

必填。
server_end SensorServer

必填。 选择要在传感器上连接的协议接口（temperature 或 trippoint）。

UNIONS

SensorManager_ClearTemperatureOverride_Result strict

在 fuchsia.thermal/sensor_manager.fidl 中定义

序数变体类型说明
response SensorManager_ClearTemperatureOverride_Response
err ClearTemperatureOverrideError
framework_err internal

SensorManager_Connect_Result strict

在 fuchsia.thermal/sensor_manager.fidl 中定义

序数变体类型说明
response SensorManager_Connect_Response
err ConnectError
framework_err internal

SensorManager_ListSensors_Result strict

在 fuchsia.thermal/sensor_manager.fidl 中定义

序数变体类型说明
response SensorManager_ListSensors_Response
framework_err internal

SensorManager_SetTemperatureOverride_Result strict

在 fuchsia.thermal/sensor_manager.fidl 中定义

序数变体类型说明
response SensorManager_SetTemperatureOverride_Response
err SetTemperatureOverrideError
framework_err internal

灵活 资源 SensorServer

在 fuchsia.thermal/sensor_manager.fidl 中定义

热传感器连接的服务器端。

添加：HEAD
序数变体类型说明
temperature server_end:fuchsia.hardware.temperature/Device

连接到传感器的 fuchsia.hardware.temperature.Device 协议。
trippoint server_end:fuchsia.hardware.trippoint/TripPoint

连接到传感器的 fuchsia.hardware.trippoint.TripPoint 协议。

行程点配置（SetTripPoints、GetTripPointDescriptors 和 WaitForAnyTripPoint）在连接到同一传感器的所有客户端之间共享。

常量

名称值类型说明
MAX_THERMAL_LOAD 100 uint32

归一化热负荷的最大值。此值用于限制从 0 开始的归一化热限制范围的宽度（以及精度）。行程点必须在此范围内指定。

别名

名称值说明
ClientType string[8]

表示使用协议的客户端类型的字符串。

ClientType 用作 ClientStateConnector.Connect 的参数，用于将 ClientStateWatcher 连接到所需客户端类型的热状态。

ClientType 值应描述客户端所代表的子系统类型，并且必须与中央散热配置中找到的客户端条目完全匹配（区分大小写）。典型示例包括“音频”“WLAN”等。