实施 Health 2.1

在 Android 11 中，所有 healthd 代码均已重构到 libhealthloop 和 libhealth2impl 中，然后经过修改以实现 health@2.1 HAL。这两个库通过 health@2.0-impl-2.1（Health 2.1 的直通实现）静态链接。静态链接的库使 health@2.0-impl-2.1 能够执行与 healthd 相同的工作，例如运行 healthd_mainloop 和轮询。在 init 中，health@2.1-service 向 hwservicemanager 注册接口 IHealth 的实现。当使用 Android 8.x 或 9 vendor 映像和 Android 11 框架升级设备时，vendor 映像可能不提供 health@2.1 服务。弃用时间表强制执行与旧 vendor 映像的向后兼容性。

为了确保向后兼容性

  1. healthd 尽管是一个系统守护程序，但仍向 hwservicemanager 注册 IHealth。IHealth 已添加到系统清单中，实例名称为“backup”。
  2. 框架和 storaged 通过 hwbinder 而不是 binder 与 healthd 通信。
  3. 框架和 storaged 的代码已更改为先获取实例“default”（如果可用），然后获取“backup”。
    • C++ 客户端代码使用 libhealthhalutils 中定义的逻辑。
    • Java 客户端代码使用 HealthServiceWrapper 中定义的逻辑。
  4. 在 IHealth/default 广泛可用且 Android 8.1 vendor 映像被弃用后，IHealth/backup 和 healthd 可以被弃用。有关更多详细信息，请参阅弃用 health@1.0。

healthd 的主板特定构建变量

BOARD_PERIODIC_CHORES_INTERVAL_* 是用于构建 healthd 的主板特定变量。作为 system/vendor 构建拆分的一部分，不能为系统模块定义主板特定值。这些值以前在已弃用的函数 healthd_board_init 中被覆盖。

在 health@2.1 中，供应商可以在将这两个定期任务间隔值传递给 health 实现类构造函数之前，在 healthd_config 结构中覆盖它们。health 实现类应继承自 android::hardware::health::V2_1::implementation::Health。

实现 Health 2.1 服务

有关实现 Health 2.1 服务的更多信息，请参阅 hardware/interfaces/health/2.1/README.md。

Health 客户端

health@2.x 具有以下客户端

  • 充电器。libbatterymonitor 和 healthd_common 代码的使用封装在 health@2.0-impl 中。
  • 恢复。与 libbatterymonitor 的链接封装在 health@2.0-impl 中。对 BatteryMonitor 的所有调用都替换为对 Health 实现类的调用。

  • BatteryManager。BatteryManager.queryProperty(int id) 是 IBatteryPropertiesRegistrar.getProperty 的唯一客户端。IBatteryPropertiesRegistrar.getProperty 由 healthd 提供，并直接读取 /sys/class/power_supply。

    作为一项安全考虑，应用不允许直接调用 health HAL。在 Android 9 及更高版本中，绑定器服务 IBatteryPropertiesRegistrar 由 BatteryService 而不是 healthd 提供。BatteryService 将调用委托给 health HAL 以检索请求的信息。

  • BatteryService。在 Android 9 及更高版本中，BatteryService 使用 HealthServiceWrapper 来确定是使用来自 vendor 的默认 health 服务实例，还是使用来自 healthd 的备份 health 服务实例。BatteryService 然后通过 IHealth.registerCallback 侦听 health 事件。

  • Storaged。在 Android 9 及更高版本中，storaged 使用 libhealthhalutils 来确定是使用来自 vendor 的默认 health 服务实例，还是使用来自 healthd 的备份 health 服务实例。storaged 然后通过 IHealth.registerCallback 侦听 health 事件并检索存储信息。

SELinux 更改

health@2.1 HAL 包括平台中的以下 SELinux 更改

  • 将 android.hardware.health@2.1-service 添加到 file_contexts。

对于具有自身实现的设备，可能需要进行一些 vendor SELinux 更改。例如：

# device/<manufacturer>/<device>/sepolicy/vendor/hal_health_default.te
# Add device specific permissions to hal_health_default domain, especially
# if it links to board-specific libhealthd or implements storage APIs.

内核接口

healthd 守护程序和默认实现 android.hardware.health@2.0-impl-2.1 访问以下内核接口以检索电池信息

  • /sys/class/power_supply/*/capacity_level（在 Health 2.1 中添加）
  • /sys/class/power_supply/*/capacity
  • /sys/class/power_supply/*/charge_counter
  • /sys/class/power_supply/*/charge_full
  • /sys/class/power_supply/*/charge_full_design（在 Health 2.1 中添加）
  • /sys/class/power_supply/*/current_avg
  • /sys/class/power_supply/*/current_max
  • /sys/class/power_supply/*/current_now
  • /sys/class/power_supply/*/cycle_count
  • /sys/class/power_supply/*/health
  • /sys/class/power_supply/*/online
  • /sys/class/power_supply/*/present
  • /sys/class/power_supply/*/status
  • /sys/class/power_supply/*/technology
  • /sys/class/power_supply/*/temp
  • /sys/class/power_supply/*/time_to_full_now（在 Health 2.1 中添加）
  • /sys/class/power_supply/*/type
  • /sys/class/power_supply/*/voltage_max
  • /sys/class/power_supply/*/voltage_now

任何使用 libbatterymonitor 的设备特定 health HAL 实现默认都会访问这些内核接口，除非在 health 实现类构造函数中被覆盖。

如果这些文件丢失或无法从 healthd 或默认服务访问（例如，该文件是指向 vendor 特定文件夹的符号链接，由于 SELinux 策略配置错误而拒绝访问），则它们可能无法正常工作。因此，即使使用默认实现，也可能需要额外的 vendor 特定 SELinux 更改。

Health 2.1 中使用的一些内核接口（例如 /sys/class/power_supply/*/capacity_level 和 /sys/class/power_supply/*/time_to_full_now）可能是可选的。但是，为了防止由于缺少内核接口而导致框架行为不正确，建议在构建 Health HAL 2.1 服务之前，先 cherry-pick CL 1398913。

测试

Android 11 包含专门为 health@2.1 HAL 编写的新的 VTS 测试。如果设备在设备清单中声明了 health@2.1 HAL，则必须通过相应的 VTS 测试。测试是为默认实例（以确保设备正确实现 HAL）和备份实例（以确保 healthd 在移除之前继续正常运行）编写的。

电池信息要求

Health 2.0 HAL 声明了一组关于 HAL 接口的要求，但相应的 VTS 测试在强制执行这些要求方面相对宽松。在 Android 11 中，添加了新的 VTS 测试，以强制执行在搭载 Android 11 及更高版本启动的设备上的以下要求

  • 瞬时和平均电池电流的单位必须是微安 (μA)。
  • 瞬时和平均电池电流的符号必须正确。具体而言：
    • 当电池状态为 UNKNOWN 时，电流 == 0
    • 当电池状态为 CHARGING 时，电流 > 0
    • 当电池状态为 NOT_CHARGING 时，电流 <= 0
    • 当电池状态为 DISCHARGING 时，电流 < 0
    • 当电池状态为 FULL 时，不强制执行
  • 电池状态必须根据电源是否已连接而正确。具体而言：
    • 当且仅当电源已连接时，电池状态必须是 CHARGING、NOT_CHARGING 或 FULL 之一；
    • 当且仅当电源已断开连接时，电池状态必须为 DISCHARGING。

如果您在实现中使用 libbatterymonitor 并传递来自内核接口的值，请确保 sysfs 节点报告正确的值

  • 确保电池电流以正确的符号和单位报告。这包括以下 sysfs 节点：
    • /sys/class/power_supply/*/current_avg
    • /sys/class/power_supply/*/current_max
    • /sys/class/power_supply/*/current_now
    • 正值表示流入电池的电流。
    • 值应以微安 (μA) 为单位。
  • 确保电池电压以微伏 (μV) 为单位报告。这包括以下 sysfs 节点：
    • /sys/class/power_supply/*/voltage_max
    • /sys/class/power_supply/*/voltage_now
    • 请注意，默认 HAL 实现将 voltage_now 除以 1000，并以毫伏 (mV) 为单位报告值。请参阅 @1.0::HealthInfo。

有关详细信息，请参阅 Linux 电源类。