4. Power HAL 接口详解：power_hidl.h、IPower.hal、关键函数

Power HAL（硬件抽象层）是 Android 系统中连接上层 PowerManagerService 与底层 Kernel/Driver 的关键桥梁。在功耗调试场景下，理解 Power HAL 的接口定义、参数传递路径以及核心函数的调用时机，是定位异常功耗行为（如屏幕关闭后 CPU 未降频、无线充电锁频等）的基础。

本章将深入剖析 Power HAL 的三个核心层面：HIDL 接口定义文件（IPower.hal）、C++ 头文件（power_hidl.h）以及关键函数（setInteractive、setFeature）的实现逻辑与参数配置方法。

4.1 Power HAL 架构分层与数据流

Power HAL 位于 Android 框架的 HIDL（HAL Interface Definition Language） 层，其调用链路如下：

下图展示了 Power HAL 在 Android 系统架构中的位置及其与 CTS 测试的关系：

4.2 IPower.hal 接口定义详解

IPower.hal 是 Power HAL 的 HIDL 接口定义文件，位于 hardware/interfaces/power/ 目录下。它定义了所有上层可调用的 Power HAL 方法。以下是核心接口的详细说明：

以下是一个典型的 IPower.hal 接口定义片段：

// hardware/interfaces/power/1.0/IPower.hal
package android.hardware.power@1.0;

interface IPower {
    /**
     * 设置设备交互状态。
     * @param on true 表示设备处于交互状态（屏幕亮），false 表示非交互状态（屏幕灭）。
     * @return Status 表示操作结果。
     */
    setInteractive(bool on) generates (Status status);

    /**
     * 设置特定硬件特性。
     * @param feature 要控制的特性。
     * @param state true 表示启用，false 表示禁用。
     * @return Status 表示操作结果。
     */
    setFeature(Feature feature, bool state) generates (Status status);

    // 其他接口...
};

4.3 power_hidl.h 头文件与 Vendor 实现

power_hidl.h 是 Power HAL 的 C++ 头文件，定义了 HAL 实现类 Power 的接口。Vendor 厂商需要继承该类并实现所有纯虚函数。该头文件通常位于 hardware/interfaces/power/1.0/default/ 目录下。

以下是 power_hidl.h 的核心结构：

// hardware/interfaces/power/1.0/default/power_hidl.h
#include <android/hardware/power/1.0/IPower.h>
#include <hidl/MQDescriptor.h>
#include <hidl/Status.h>

namespace android {
namespace hardware {
namespace power {
namespace V1_0 {
namespace implementation {

using ::android::hardware::power::V1_0::IPower;
using ::android::hardware::power::V1_0::Feature;
using ::android::hardware::power::V1_0::Status;
using ::android::hardware::Return;

struct Power : public IPower {
    // 实现 setInteractive
    Return<Status> setInteractive(bool on) override;

    // 实现 setFeature
    Return<Status> setFeature(Feature feature, bool state) override;

    // 其他接口实现...
};

}  // namespace implementation
}  // namespace V1_0
}  // namespace power
}  // namespace hardware
}  // namespace android

Vendor 厂商在 power.cpp 中实现这些函数时，通常会通过 sysfs 节点或 ioctl 与 Kernel 交互。以下是一个典型的 setInteractive 实现示例：

// vendor/xxx/power/power.cpp
Return<Status> Power::setInteractive(bool on) {
    if (on) {
        // 屏幕亮：恢复高性能
        write_to_sysfs("/sys/devices/system/cpu/cpu0/cpufreq/scaling_min_freq", "1512000");
        write_to_sysfs("/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor", "performance");
    } else {
        // 屏幕灭：进入省电模式
        write_to_sysfs("/sys/devices/system/cpu/cpu0/cpufreq/scaling_min_freq", "300000");
        write_to_sysfs("/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor", "powersave");
    }
    return Status::SUCCESS;
}

4.4 关键函数详解：setInteractive

setInteractive(bool on) 是 Power HAL 中最核心的函数之一，直接影响设备的功耗表现。其调用时机与系统状态密切相关：

• 屏幕点亮（on=true）： 当用户按下电源键、收到通知唤醒或通过 ADB 唤醒时，PowerManagerService 调用 setInteractive(true)，HAL 应提升 CPU/GPU 频率、切换到交互式调度器，确保界面流畅。
• 屏幕熄灭（on=false）： 当屏幕超时关闭或用户按下电源键锁屏时，调用 setInteractive(false)，HAL 应降低频率、切换到省电调度器，减少功耗。

下表展示了不同场景下 setInteractive 的典型参数配置：

4.5 关键函数详解：setFeature

setFeature(Feature feature, bool state) 用于控制特定的硬件特性，这些特性通常与功耗密切相关。Feature 枚举定义在 types.hal 中，不同 Android 版本支持的 Feature 有所不同。

以下是 Android 10/11 中常见的 Feature 枚举：

以下是一个 setFeature 的典型实现示例，展示了如何控制无线充电加速特性：

// vendor/xxx/power/power.cpp
Return<Status> Power::setFeature(Feature feature, bool state) {
    switch (feature) {
        case Feature::POWER_FEATURE_WIRELESS_CHARGER:
            // 通过 sysfs 控制无线充电 IC 的输入电流限制
            if (state) {
                // 启用加速：设置输入电流为 10W
                write_to_sysfs("/sys/class/power_supply/wireless/current_max", "2000000");
            } else {
                // 禁用加速：恢复默认 5W
                write_to_sysfs("/sys/class/power_supply/wireless/current_max", "1000000");
            }
            break;
        case Feature::POWER_FEATURE_DOUBLE_TAP_TO_WAKE:
            // 控制触控 IC 的双击唤醒功能
            write_to_sysfs("/sys/devices/virtual/touch/touch_dev/double_tap", state ? "1" : "0");
            break;
        default:
            return Status::UNSUPPORTED;
    }
    return Status::SUCCESS;
}

4.6 CTS 用例定位与调试方法

与 Power HAL 相关的 CTS 测试用例主要集中在 android.os.cts.PowerManagerTest 中。以下是针对 setInteractive 和 setFeature 的用例定位方法：

1. 查找测试用例：

   # 在 CTS 源码中查找 PowerManagerTest
   find cts/tests/tests/os/ -name "PowerManagerTest.java"
   # 查看测试方法列表
   grep -n "testSetInteractive\|testSetFeature\|testDoubleTapToWake" cts/tests/tests/os/src/android/os/cts/PowerManagerTest.java

2. 运行单个测试用例：

   # 运行 testSetInteractive
   adb shell am instrument -w -r -e class android.os.cts.PowerManagerTest#testSetInteractive android.os.cts/.PowerManagerTestRunner

3. 分析测试日志：

   # 抓取 Power HAL 相关日志
   adb logcat -b all | grep -E "PowerHAL|power_hal|setInteractive|setFeature"

下表总结了常见 CTS 失败场景与对应的 HAL 调试方向：

4.7 本章小结

本章详细介绍了 Power HAL 的核心接口 IPower.hal、power_hidl.h 以及关键函数 setInteractive 和 setFeature。理解这些接口的定义、参数含义和实现方式，是进行功耗调试和 CTS 用例定位的基础。在实际调试中，应重点关注：

• 调用链路： 确认上层是否正确调用了 HAL 接口。
• 参数传递： 检查 HAL 实现中 sysfs 节点的读写是否正确。
• CTS 覆盖： 确保 HAL 实现与 CTS 测试用例的预期行为一致。