Android 11(R) Power HAL AIDL将分三篇文章来介绍:
Android 11(R) Power HAL AIDL简析 -- 基本接口
Android 11(R) Power HAL AIDL简析 -- Service功能实现
Android 11(R) Power HAL AIDL简析 -- 应用实例
1 前言
Android 11 引入了在 Android 中使用 AIDL 实现 HAL 的功能。这样就可以在不使用 HIDL 的情况下实现 Android 的部分代码。Power HAL模块即可以采用AIDL方式来实现。在Android 11中已经引入这个Power AIDL Interface,源码位于:
/hardware/interfaces/power/aidl/
在学习这部分之前,推荐阅读AIDL的相关知识,特别是Android 10之后引入的对稳定的 Android 接口定义语言 (AIDL) 的支持(stable AIDL),这里放上几篇官网链接:
- AIDL 概览(AIDL Overview)
- AIDL 后端 (AIDL Backends)
- 稳定的 AIDL(Stable AIDL)
- 适用于 HAL 的 AIDL(AIDL for HALs)
- 动态运行 AIDL 服务(Running AIDL Services Dynamically)
- 以 AIDL 编写的注释 (Annotations in AIDL)
- 快速消息队列与 AIDL (Fast Message Queue with AIDL)
2 Power HAL AIDL接口介绍
2.1 接口定义源码的目录结构
1. 在Androi源码目录/hardware/interfaces/power/aidl/android/hardware/power/下定义了三个aidl文件,分别为:
2. aidl_api目录:对于Stable AIDL,从 Android 11 开始,versions
冻结在 aidl_api/
下,和AIDL接口版本相关。
3. default目录:功能实现的一个示例代码,实现了一个android.hardware.power-service.example 这个aidl service
4. vts目录:vts测试用例
2.2 IPower接口介绍
先看看IPower源码是如何定义的,interface IPower的源码定义如下:
从源码中可以看到,IPower的定义还是比较简单的,只提供了4个接口,从源码注释也很容易理解其作用,下面我们简单总结一下:
2.3 Power Mode介绍
先看一下AIDL文件中的定义
简单介绍各个Mode:
- DOUBLE_TAP_TO_WAKE : 此模式表示设备允许在屏幕被点击两次时被唤醒
- LOW_POWER:此模式表示低电量模式是否被激活。这种模式以牺牲性能为代价来节省电量消耗
- SUSTAINED_PERFORMANCE:持续性能模式旨在在较长时间内提供一致的性能水平。
- FIXED_PERFORMANCE:将设备设置为一个固定的性能水平,该水平可在正常室内条件下持续至少10分钟。此模式于SUSTAINED_PERFORMANCE模式,不同之处在于:SUSTAINED_PERFORMANCE为了长期稳定性对性能设置了上限;FIXED_PERFORMANCE模式对性能同时设置了上限和下限,以便在FIXED_PERFORMANCE模式下运行的任何工作负载都应在可重复的时间内完成。
- VR:VR 模式旨在在设备可以维持的时间内为性能提供最低限度的保证。
- LAUNCH:此模式表示已启动应用程序
- EXPENSIVE_RENDERING:此模式表示设备即将进入昂贵的渲染周期。
- INTERACTIVE:此模式表示设备即将进入/离开 交互状态或非交互状态。 非交互状态可以在不活动时间段之后进入,以便在这样的不活动时间段期间节省电池电量。典型的操作是打开或关闭设备并调整 cpufreq 参数。该函数还可以调用适当的接口,允许内核在进入非交互状态时将系统挂起到低功耗休眠状态,并在系统处于交互状态时禁止低功耗挂起。 当允许低功耗挂起状态时,内核可以在没有唤醒锁保持时挂起系统。
- DEVICE_IDLE:此模式表示设备处于设备空闲状态,详细信息可参考: 针对低电耗模式和应用待机模式进行优化
- DISPLAY_INACTIVE:此模式表示显示器关闭或仍然打开,但已针对低功耗进行了优化。
以下提示选项目前未在加入 Android 框架,但 OEM 可能会选择实施电源/性能优化。
- AUDIO_STREAMING_LOW_LATENCY:此模式表示低延迟音频处于激活状态
- CAMERA_STREAMING_SECURE:此模式表示正在启动相机 安全流
- CAMERA_STREAMING_LOW:此模式表示正在启动相机 低 分辨率流。
- CAMERA_STREAMING_MID:此模式表示正在启动相机 中 分辨率流。
- CAMERA_STREAMING_HIGH:此模式表示正在启动相机 高 分辨率流
2.4 Boost type介绍
首先看一下AIDL的源码:
几个枚举常量的大概解释如下:
- INTERACTION:这种boost是在用户与设备交互时设置的,例如,触摸屏事件传入。 CPU 和 GPU 负载可能很快就会出现,可能适当提高 CPU、内存总线等的速度。 注意,这与 INTERACTIVE 模式不同,交互模式仅表示这种交互*可能*发生,而不是主动发生 .
- DISPLAY_UPDATE_IMMINENT:这种boost表明框架可能很快会提供一个新的显示帧。这意味着设备应确保显示处理路径已通电并准备好接收该更新。
- ML_ACC:此boost表明设备正在与 ML 加速器交互
- AUDIO_LAUNCH:此boost表示设备正在设置音频流。
- CAMERA_LAUNCH:此boost表示Camera正在被启动
- CAMERA_SHOT:此boost表示Camera正在拍摄
3 结语
通过上面的介绍,应该对power hal aidl有了一个直观的认识,清楚了有哪些接口/哪些模式,下一篇中我们会在此基础上通过一个示例讲解如何实现这个aidl serivice功能。