Android系统中如何通过ADB命令读取电池容量？

Question

在Android系统中，如何通过ADB命令准确读取设备的电池容量信息？虽然`adb shell dumpsys battery`可获取当前电量状态，但它不直接提供电池总容量（如mAh）。开发者常误以为该命令能返回硬件级容量参数，但实际上系统并未开放标准接口读取设计容量或实际容量。部分厂商设备可通过`adb shell cat /sys/class/power_supply/battery/*`查看capacity、charge_full或charge_counter等节点，但路径因设备而异且受权限限制。此外，不同Android版本及定制ROM可能导致节点名称不一致。因此，如何跨设备兼容地通过ADB获取真实电池容量成为开发与测试中的常见难题。

Answer 1

一、Android系统中通过ADB读取电池容量信息的技术路径解析

在移动设备开发与测试过程中，准确获取Android设备的电池总容量（单位：mAh）是一项常见但极具挑战性的任务。虽然adb shell dumpsys battery命令能够提供当前电量百分比、充电状态等信息，但它并不暴露硬件层面的设计容量或实际满电容量。

1. 基础认知：dumpsys命令的局限性

执行以下命令可查看当前电池状态：

adb shell dumpsys battery

输出示例：

字段	说明
AC powered	是否通过交流电源充电
USB powered	是否通过USB供电
Wireless powered	是否无线充电
status	充电状态（如CHARGING、DISCHARGING）
health	电池健康状态
level	当前电量百分比（0-100）
scale	最大百分比基准，默认为100
voltage	当前电压（mV）
temperature	温度（0.1℃为单位）
technology	电池类型（如Li-ion）

注意：level和scale仅反映相对电量，无法推导出以mAh表示的实际容量。

2. 深入内核节点：sysfs接口探索

真实电池容量通常存储于Linux内核暴露的/sys/class/power_supply/路径下的属性文件中。不同设备可能使用不同的命名约定：

• capacity：当前剩余电量百分比
• charge_full：当前可充入的最大电荷量（单位：µAh）
• charge_full_design：设计满电容量（µAh）
• charge_counter：已用电量（µAh）
• energy_full 和 energy_full_design：用于支持能量计量（µWh）的设备

常用ADB命令读取这些值：

adb shell cat /sys/class/power_supply/battery/charge_full
adb shell cat /sys/class/power_supply/battery/charge_full_design

部分设备路径可能是bms、fuelgauge或psy-battery，例如：

adb shell ls /sys/class/power_supply/
adb shell cat /sys/class/power_supply/usb/voltage_now

3. 跨设备兼容性难题与厂商差异分析

由于缺乏统一标准，各厂商实现存在显著差异：

厂商	典型路径	关键节点	单位
Samsung	/sys/class/power_supply/battery/	charge_full, charge_full_design	µAh
Xiaomi	/sys/class/power_supply/bms/	charge_cycle, full_bat	未知
Huawei	/sys/class/power_supply/Battery/	Qmax_Life, batterySoc	µAh, %
OnePlus	/sys/class/power_supply/battery/	charge_counter, current_now	µAh, µA
Google Pixel	/sys/class/power_supply/battery/	charge_full, capacity_level	µAh
OPPO	/sys/class/power_supply/mtk-battery/	batt_num_temps, UI_SOC	-
Vivo	/sys/class/power_supply/battery/	in_recharging, is_fully_charged	flag
Motorola	/sys/class/power_supply/BAT0/	energy_now, energy_full	µWh
Lenovo	/sys/class/power_supply/BAT/	design_capacity, last_full_capacity	mAh
ASUS	/sys/class/power_supply/battery/	BatteryAverageCurrent, BatteryVoltage	µA, mV

此外，Android 10及以上版本加强了对/sys目录的访问限制，部分节点需root权限才能读取。

4. 实践方案设计：多路径探测脚本

为提升跨设备兼容性，建议编写自动化探测脚本。以下是Shell示例：

#!/system/bin/sh
BATTERY_PATHS=(
    "/sys/class/power_supply/battery"
    "/sys/class/power_supply/Battery"
    "/sys/class/power_supply/bms"
    "/sys/class/power_supply/axp_bat"
    "/sys/class/power_supply/mtk-battery"
)

for path in "${BATTERY_PATHS[@]}"; do
    if [ -f "$path/charge_full" ]; then
        echo "Found charge_full at $path:"
        cat "$path/charge_full"
        break
    fi
done

if [ -f "/sys/class/power_supply/battery/charge_full_design" ]; then
    echo "Design Capacity:"
    cat /sys/class/power_supply/battery/charge_full_design
fi

该脚本可在ADB shell环境中运行，尝试遍历多个潜在路径以定位有效数据源。

5. 数据转换与单位处理

从内核节点读取的数据常以微安时（µAh）或微瓦时（µWh）为单位，需进行换算：

• 将 µAh 转换为 mAh：除以 1000
• 若仅有能量值（µWh），需结合电压估算容量：
  mAh = (µWh / Voltage_mV) * 1000

例如：

# 已知 energy_full=15000000 µWh, voltage=3800 mV
capacity_mah=$(( (15000000 / 3800) / 1000 )) # ≈ 3.95 Ah → 3950 mAh

6. 高级替代方案与未来趋势

随着Android安全机制增强，直接访问底层节点愈发困难。可行的替代方向包括：

1. 利用Battery Historian工具分析bugreport中的电池历史数据
2. 开发特权App请求BATTERY_STATS权限获取更深层信息
3. 通过HAL层接口（如Power HAL、BatteryService）间接获取OEM扩展数据
4. 借助设备制造商提供的诊断模式（如三星的Engineering Mode）

Mermaid流程图展示多路径探测逻辑：

graph TD
    A[开始] --> B{检查/sys/class/power_supply/battery}
    B -- 存在 --> C[读取charge_full]
    B -- 不存在 --> D{检查其他路径}
    D --> E[bms?]
    D --> F[mtk-battery?]
    D --> G[axp_bat?]
    E --> H[读取对应节点]
    F --> H
    G --> H
    H --> I[转换单位为mAh]
    I --> J[输出结果]
    

此架构支持动态适配多种设备类型，提升脚本鲁棒性。