MTK Linux Charger驱动分析（十二）- mtk_battery.c

原创

已于 2025-09-17 14:09:47 修改 · 937 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#Charger

于 2025-09-17 14:06:36 首次发布

一、代码分析

两个代码文件（"mtk_battery.h" 和 "mtk_battery.c"）的详细分析。这些文件是MediaTek（MTK）电池管理系统的一部分，用于管理Android/Linux内核中的电池相关功能，包括电池状态监控、充电控制、温度管理、关机条件判断等。代码基于GPL-2.0许可，作者为Wy Chuang（MediaTek Inc.）。

我将分步进行：

文件整体分析：总结文件结构和内容。
函数作用说明：列出主要函数（重点关注mtk_battery.c中的实现函数，以及mtk_battery.h中的声明函数），并描述其作用。函数众多，我会优先列出核心函数；次要函数（如宏定义或辅助函数）会简要提及。

1. 文件整体分析

mtk_battery.h（头文件）

目的：定义电池管理系统的接口、数据结构、枚举和宏。用于与内核守护进程（FG daemon）、电源供应子系统（power_supply）和Gauge（电池计量芯片）交互。
关键内容：
- 宏定义：日志级别（e.g., BMLOG_ERROR_LEVEL）、超时常量（e.g., PROP_BATTERY_EXIST_TIMEOUT）、sysfs字段宏（e.g., BAT_SYSFS_FIELD_RW）。
- 枚举：
  - battery_property：电池属性（如温度、UISOC）。
  - property_control_data：属性控制数据（如电池存在、电流）。
  - fg_daemon_cmds：守护进程命令（如获取温度、重置FG）。
  - Fg_kernel_cmds：内核命令（如日志转储、算法数据请求）。
  - shutdown_factor：关机原因（如过热、SOC为0）。
  - gauge_event：Gauge事件（如充电满、ZCV中断）。
  - charge_sel：充电选择（如正常、R1~R4电阻）。
  - Fg_interrupt_flags：中断标志（如定时器更新、电池循环）。
- 结构：
  - property_control：属性控制（值、更新时间、阈值）。
  - battery_data：电池数据（电源供应描述、状态、健康等）。
  - VersionControl：版本控制（Android版本、守护进程命令）。
  - fuelgauge_profile_struct：燃料表配置文件（mAh、电压、电阻）。
  - fuel_gauge_table：燃料表（温度、Qmax、伪值）。
  - fuel_gauge_custom_data：自定义燃料表数据。
  - fuel_gauge_custom_data：自定义电池数据（Qmax、阈值、模式选择等）。
  - gauge_consumer：Gauge消费者（名称、设备、回调）。
  - mtk_coulomb_service：库仑服务（GM、列表、锁等）。
  - battery_temperature_table：温度表（类型、电阻）。
  - mtk_battery_algo：算法数据（温度、SOC、UISOC等）。
  - simulator_log：模拟日志（电池满中断等）。
  - shutdown_condition：关机条件（过热、SOC零等）。
  - shutdown_controller：关机控制器（闹钟、等待队列、平均VBAT）。
  - BAT_EC_Struct：电池EC结构（调试参数）。
  - zcv_log/filter：ZCV日志/过滤器。
  - ag_center_data_st：AG中心数据。
  - mtk_battery：主电池结构（电源供应、算法、标志、中断等）。
  - mtk_battery_sysfs_field_info：sysfs字段信息。
  - fgd_cmd_param_t_custom：自定义FGD参数。
  - fg_temp：FG温度。
- 函数声明：包括库仑服务初始化、Gauge IRQ启用/禁用、电池属性获取/设置、算法唤醒等。
特点：强调日志（bm_err, bm_warn等宏）、自定义表（燃料表、温度表）、中断处理和关机逻辑。文件末尾有弱函数声明（attribute ((weak))），允许覆盖。