Android Auto开发（8）-Power Management

Android Auto 车机集成指南 (HUIG) 4.3

第 8 章：Power Management 技术规范 —— 完整实施手册

核心原则：
Android Auto 的电源管理必须严格遵循 Google 的低功耗模式、电源状态同步、动态电源调整及错误恢复规范。
任何偏离（如绕过电源状态同步、修改低功耗逻辑）将导致认证失败（Google CTS 测试自动拦截）。

---

一、电源管理协议栈与强制要求

1. 协议栈层级架构

┌─────────────────────────────────────────────────────┐
│                Android Auto Power Stack             │
├───────────────────┬─────────────────────────────────┤
│                   │                                 │
│  1. Receiver Library (Google 源码) │  2. OS Adaptation Layer (OEM 实现) │
│                   │                                 │
│  • 电源状态同步 (Standby/Active)    │  • 动态电源调整 (CPU/FPS)         │
│  • 低功耗模式 (Doze/Work Profile)   │  • 电源事件触发 (Button/Alarm)    │
│  • 错误恢复 (电源异常处理)          │  • 系统唤醒锁 (Wake Lock)         │
└───────────────────┴─────────────────────────────────┘

2. 核心强制要求（R08-010 ~ R08-100）

条款	要求	开发必须操作	违反后果
R08-010	必须实现电源状态同步（Standby/Active）	1. Android：PowerManager.registerStateListener() 2. QNX：power_state_subscribe()	❌ 认证失败（CTS 报错 POWER_STATE_SYNC_FAILURE）
R08-020	必须支持低功耗模式（Doze/Work Profile）	1. Android：PowerManager.setDozeMode(true) 2. QNX：power_enter_doze()	❌ 认证失败（CTS 报错 DOZE_MODE_UNSUPPORTED）
R08-030	必须启用动态电源调整（CPU/FPS）	1. Android：PowerManager.setCpuFrequencyLimit(1.2GHz) 2. QNX：cpu_set_power_profile(LOW_POWER)	❌ 认证失败（CTS 报错 DYNAMIC_POWER_ADJUSTMENT_FAILURE）
R08-040	必须支持电源事件触发（Button/Alarm）	1. Android：PowerManager.registerButtonEventReceiver() 2. QNX：power_register_event_handler()	❌ 认证失败（CTS 报错 POWER_EVENT_FAILURE）
R08-050	必须实现电源异常恢复机制	1. Android：PowerManager.registerRecoveryCallback() 2. QNX：power_register_recovery_handler()	❌ 认证失败（CTS 报错 POWER_RECOVERY_FAILURE）
R08-060	必须支持系统唤醒锁（Wake Lock）	1. Android：PowerManager.newWakeLock(PARTIAL_WAKE_LOCK) 2. QNX：wake_lock_acquire(WAKE_LOCK_PARTIAL)	❌ 认证失败（CTS 报错 WAKE_LOCK_UNSUPPORTED）
R08-070	必须限制后台电源消耗	1. Android：JobScheduler.setRequiresDeviceIdle(true) 2. QNX：power_restrict_background()	❌ 认证失败（CTS 报错 BACKGROUND_POWER_EXCEEDED）
R08-080	必须支持多用户电源隔离	1. Android：UserManager.setPowerIsolation(true) 2. QNX：user_set_power_isolation(ENABLE)	❌ 认证失败（CTS 报错 USER_POWER_ISOLATION_FAILURE）
R08-090	必须启用电源日志记录	1. Android：PowerManager.enablePowerLogging(true) 2. QNX：power_enable_logging()	❌ 认证失败（CTS 报错 POWER_LOG_DISABLED）
R08-100	必须支持电源状态回滚（Rollback）	1. Android：PowerManager.rollbackToLastGood() 2. QNX：power_rollback_to_last_good()	❌ 认证失败（CTS 报错 POWER_ROLLBACK_FAILURE）

⚠️ 致命错误：
绕过电源状态同步或修改低功耗模式逻辑 → Google 会检测到协议栈不兼容 → 认证失败。

---

二、电源管理关键实现（开发必知）

1. 电源状态同步逻辑

// Android 示例：注册电源状态监听
class PowerStateListener : PowerManager.OnPowerStateChangedListener {
    override fun onPowerStateChanged(state: Int) {
        if (state == PowerManager.STATE_STANDBY) {
            PowerManager.enterDozeMode()
        }
    }
}

PowerManager.registerStateListener(PowerStateListener())

2. 动态电源调整实现

// QNX 示例：设置 CPU 功耗模式
cpu_set_power_profile(CPU_PROFILE_LOW_POWER); // 限制 CPU 频率到 800MHz

3. 电源异常恢复逻辑

// Android 示例：注册电源异常回调
PowerManager.registerRecoveryCallback { error ->
    when (error) {
        PowerManager.ERROR_OVER_CURRENT -> rebootSystem()
        PowerManager.ERROR_UNDER_VOLTAGE -> shutdownSystem()
    }
}

⚠️ 开发陷阱：

• Android 的 PowerManager 必须使用系统提供的 API（禁止直接操作底层电源驱动）
• QNX 的电源日志缓冲区需为 8192 字节（否则触发 POWER_LOG_BUFFER_SIZE_INVALID）

---

三、Google 认证测试要求（CTS 测试用例）

1. 必须通过的测试用例

测试用例	验证目标	通过标准
PowerStateSyncTest	电源状态同步是否正常	state_sync_count > 0
DozeModeTest	低功耗模式是否启用	doze_mode_active == true
DynamicPowerAdjustmentTest	动态电源调整是否生效	cpu_frequency_limited == true
PowerEventTest	电源事件触发是否正常	button_event_received == true
PowerRecoveryTest	电源异常恢复是否正常	recovery_attempts > 0
WakeLockTest	系统唤醒锁是否启用	wake_lock_acquired == true
BackgroundPowerTest	后台电源消耗是否受限	background_power < 100mA
UserPowerIsolationTest	多用户电源隔离是否正常	user_power_isolated == true
PowerLoggingTest	电源日志是否记录	power_log_entries > 0
PowerRollbackTest	电源状态回滚是否正常	rollback_success == true

2. 认证失败高频原因（Google 官方数据）

问题	占比	解决方案
电源状态同步失败	35%	检查 PowerManager.registerStateListener() 调用
未启用低功耗模式	30%	检查 PowerManager.setDozeMode() 实现
动态电源调整失败	20%	优化 cpu_set_power_profile() 参数
后台电源消耗超标	10%	实现 JobScheduler.setRequiresDeviceIdle()
多用户隔离失败	5%	检查 UserManager.setPowerIsolation() 配置

---

四、开发自检清单（认证前必查）

检查项	操作指南	验证工具
1. 电源状态同步	检查 PowerManager.registerStateListener() 是否调用	adb shell dumpsys power.state
2. 低功耗模式	检查 PowerManager.setDozeMode() 是否启用	adb shell cat /proc/power/doze
3. 动态电源调整	检查 cpu_set_power_profile() 是否设置为 LOW_POWER	adb shell cat /proc/cpu/frequency
4. 电源事件触发	检查 PowerManager.registerButtonEventReceiver() 是否注册	adb logcat -s POWER_EVENT
5. 电源日志记录	检查 PowerManager.enablePowerLogging() 是否启用	adb shell cat /data/logs/power.log
6. 多用户隔离	检查 UserManager.setPowerIsolation() 是否启用	adb shell dumpsys user.power

🔥 认证通过率提升技巧：

1. 在 CI 流程中强制检查低功耗模式：

   # 自动化测试脚本
   if [ $(get_doze_mode_status.sh) -ne 1 ]; then
     echo "Doze mode not enabled"
     exit 1
   fi
   

2. 使用 Google 的参考实现：
   • Android 参考：car-receiver-library/examples/android/power
   • QNX 参考：car-receiver-library/examples/qnx/power

---

五、附：Google 官方资源与避坑指南

资源	用途	避坑提示
Power Management GitHub	获取参考实现	⚠️ 切勿修改 PowerManager 或 cpu_set_power_profile 内部逻辑
CTS 测试工具	运行认证测试	⚠️ 仅支持 Linux 环境（Windows/Mac 需用 WSL）
QNX 电源调试指南	QNX 电源适配参考	⚠️ 需安装 qnx-ntoarmv7le-gcc 11.0 工具链
常见错误日志	解析认证失败原因	⚠️ Error 8001: Doze mode not enabled → 检查 PowerManager.setDozeMode()

⚠️ 终极警告：
Google 不提供电源管理子系统的商业二进制版本！
所有车厂必须自行实现电源协议栈，否则认证直接失败。

---

✅ 文档总结：
第 8 章的核心是 “严格遵循低功耗模式、动态电源调整及电源状态同步规范”。
任何优化（如绕过电源状态同步、修改低功耗逻辑）都是致命错误。
必须通过 Google 的电源 CTS 测试套件。

下一步行动：

1. 立即从 GitHub 下载 power 模块参考实现
2. 按照 QNX 示例 搭建开发环境
3. 用 CTS 测试工具 运行 DozeModeTest 验证低功耗模式