一、bq24735简介
bq24735 是一款高效率同步电池充电器。
当系统供电需求暂时高于适配器最大供电水平的时候， bq24735 使用智能加速技术来允许电池向系统中释放能量，这样的话将保护适配器不被损坏。
bq24735 为满足自动系统电源选择的需要，使用 2 个充电泵来分别驱动 n-通道 MOSFET (ACFET, RBFET 和 BATFET) 。
SMBus(I2C总线) 控制的输入电流, 充电电流, 和充电电压DAC允许非常高的调节精度，此调节精度可通过系统功率管理微控制器很容易地进行编程。
bq24735 使用内部输入电流寄存器或者外部ILIM引脚来减缓PWM调制速度以减小充电电流。
二、Linux内核充电架构
要想理解bq24735驱动，必须首先理解Android供电系统框架，最重要的知识点是power supply。
1. Android供电系统框架
power supply(以下简称psy)是Linux中从供电驱动抽象出来的子系统，是Linux电源管理的重要组成部分。
psy是一个中间层，在kernel中是属于设备驱动的一部分，psy的作用主要是向用户空间汇总各类供电的状态信息。
抽象出来的各类信息称为property，比如供电设备是否连接就对应着POWER_SUPPLY_PROP_ONLINE。
2. power supply功能
power_supply的软件架构：
power supply framework功能包括：
- 抽象PSY设备的共性，向用户空间提供统一的API;
- 为底层PSY驱动的编写，提供简单、统一的方式，同时封装并实现公共逻辑。
power supply class位于drivers/power/目录中，主要由3部分组成(可参考下图的软件架构)：
- 1)power_supply_core，用于抽象核心数据结构、实现公共逻辑。位于drivers/power/power_supply_core.c中。
- 2)power_supply_sysfs，实现sysfs以及uevent功能。位于drivers/power/power_supply_sysfs.c中。
- 3)power_supply_leds，基于Linux led class，提供PSY设备状态指示的通用实现。位于drivers/power/power_suppply_leds.c中。
最后，驱动工程师可以基于power supply class，实现具体的PSY drivers，主要处理平台相关、硬件相关的逻辑。这些drivers都位于drivers/power/power_supply目录下。
3. 驱动层功能
在驱动层，主要是两大模块，与电池监控(fuelgauge)和与充放电管理(charger)相关的驱动(对应图中的battery.c和charger.c),这两大模块主要处理硬件相关的逻辑，在硬件状态发生变化时，会触发相关的中断，驱动层会调用相应的中断函数，并更新修改相应的psy节点值。
fuelgauge驱动主要是负责向上层android系统提供当前电池的电量以及健康状态信息等等，另外除了这个以外，它也向charger驱动提供电池的相关信息;charger驱动主要负责电源线的插拔检测，以及充放电的过程管理。
对于battery管理，硬件上有电量计IC和充放电IC，当然有些厂家为了成本的考虑，也会把电量计和充放电功能集成到一个IC上，更有甚者，可能会把PMU功能也集成在一块硅面上。
4. 其他问题
问：android怎么知道当前是什么供电，充电中与否?
答：uevent机制(实质是net_link方式的socket)(广泛应用于hotplug)，充电插入与断开时，内核通过发送uevent信息，告诉android。
问：android如何知道各种参数并更新的?
答：通过kobject_uevent发送通知给上层，上层读取sys相关文件属性。
以下是某平台sysfs文件目录：
root@********_arm64:/sys/class # pwd
sys/class/power_supply
root@********_arm64:/sys/class/power_supply # ls
ac
battery
bq24735@5-0009
usb
root@********_arm64:/sys/class/power_supply # cd bq24735@5-0009
cd bq24735@5-0009
root@*********_arm64:/sys/class/power_supply/bq24735@5-0009 # ls
device
online
power
status
subsystem
type
uevent
三、bq24735驱动实现
下面基于某款soc来讲解如何让我们的产品支持bq24735。
1. 硬件连接图图
下面是一个典型的bq24735电路连接图：
当没有电源供电的时候，bq24735会直接将电池传递给降压电路，给系统供电 当有电源供电的时候，bq24735会给电池充电。
2. 引脚说明
在此我们只介绍与驱动相关的引脚：
3. 寄存器
bq24735用到的寄存器如下：
- 充电选项寄存器Charge Options Register [reset = 0x12H]。
其中最重要的两个位bit[4]/bit[0] bit:[4]。
0: AC adapter不在 (ACDET < 2.4 V)
1: AC adapter存在(ACDET > 2.4 V)
bit:[0]：
0: 使能充电
1: 抑制充电
该寄存器为可读写， 如果要判断当前是否在充电，则可以读取该寄存器，通过判断bit[0]是否为0来确认 如果要判断当前是否存在，则可以读取该寄存器，通过判断bit[4]是否为1来确认
- 充电电流寄存器Charge Current Register (0x14H)
通过该寄存器可以设置充电电流。
比如我们要设置充电电流为3072mA。
该值为2048+1024，将对应的bite[10]/[11]为1，其他位为0。
1100 0000 0000
即设置该寄存器值为：0xC00。
- 充电电压寄存器Charge Voltage Register (0x15H)。
该寄存器设置方法类似于充电电流寄存器。
- 输入电流Input Current Register (0x3FH)。
该寄存器设置方法类似于充电电流寄存器。
- 0xfe,0xff 这两个寄存器分别读取MANUFACTURER_ID和DEVICE_ID。
这两个值分别为：0x0040、0x000B。。
驱动初始化时可以通过读取这两个寄存器的值来判断，驱动是否和硬件匹配。。
注意: 通常寄存器0x14、0x15、0x3F值需要询问硬件工程师。
4. 设备树
bq24735@9 {
compatible = "ti,bq24735";
reg = <0x9>;
ti,ac-detect-gpios = <&gpio 72 0x1>;
ti,charge-current =<0x600>;
ti,charge-voltage=<0x41a0>;
ti,input-current =<0x800>;
}
参数说明：
compatible ：用于和驱动的结构体i2c_driver的driver.of_match_table->compatible属性进行匹配
reg:bq24735从设备地址(I2C)
ti,ac-detect-gpios:中断使用的gpio，第三个参数是该pin默认电平
ti,charge-current ：充电电流
ti,charge-voltage ：充电电压
ti,input-current ：输入电流
5. 驱动讲解
- 驱动文件 内核代码中已经有该驱动。
drivers\power\bq24735-charger.c
但是该驱动往往需要修改以适配实际的方案。
该驱动是基于I2C总线，对应结构体变量定义如下：
static struct i2c_driver bq24735_charger_driver = {
.driver = {
.name = "bq24735-charger",
.owner = THIS_MODULE,
.of_match_table = bq24735_match_ids,
},
.probe = bq24735_charger_probe,
.remove = bq24735_charger_remove,
.id_table = bq24735_charger_id,
};
- 主要函数。
static bool bq24735_charger_is_present(struct bq24735 *charger)
判断bq24735 是否存在
其实就是读取寄存器0x12的值，判断bit[4]值是否为1
static int bq24735_charger_is_charging(struct bq24735 *charger)
判断bq24735 是否在充电
其实就是读取寄存器0x12的值，判断bit[0]值是否为0
static inline int bq24735_enable_charging(struct bq24735 *charger)
使能充电
将寄存器寄存器0x12的bit[0]置0
static inline int bq24735_disable_charging(struct bq24735 *charger)
禁止充电
将寄存器寄存器0x12的bit[0]置1
static int bq24735_config_charger(struct bq24735 *charger)
配置充电电压(寄存器0x15)、充电电流(寄存器0x14)、输入电流(寄存器0x3f)
static irqreturn_t bq24735_charger_isr(int irq, void *devid)
中断处理函数，
当bq24735充电状态发生变化的时候，会发送中断给cpu
此时可以通过I2C来读取寄存器0x12的内容来获取bq24735当前状态
static int bq24735_charger_get_property(struct power_supply *psy,
enum power_supply_property psp,
union power_supply_propval *val)
提供给power supply子系统的回调函数
该函数用于获取bq24735当前状态
状态包括
enum {
POWER_SUPPLY_STATUS_UNKNOWN = 0,
POWER_SUPPLY_STATUS_CHARGING, //正在充电
POWER_SUPPLY_STATUS_DISCHARGING,
POWER_SUPPLY_STATUS_NOT_CHARGING,//没有充电
POWER_SUPPLY_STATUS_FULL,//充满
};
- probe流程
此处检测MANUFACTURER_ID和DEVICE_ID流程稍做了修改，只有bq24735 present的时候才会check并配置。
此外还有个最重要的机构体。
supply_desc->name = name;
supply_desc->type = POWER_SUPPLY_TYPE_MAINS;
supply_desc->properties = bq24735_charger_properties;
supply_desc->num_properties = ARRAY_SIZE(bq24735_charger_properties);
supply_desc->get_property = bq24735_charger_get_property;
supply_desc->properties
提供给power supply架构可以访问的命令的集合，
这些命令需要在函数supply_desc->get_property增加对应的命令代码
supply_desc->get_property
power supply会定时通过该回调函数获取充电芯片是否在线、是否在充电等状态
- 代码架构：
这个架构是一口君根据项目中平台所画的架构，其他平台架构可能会有所不同， 需要具体问题具体分析。
四、 log
下面log是开机启动流程log， 第一步 用电池供电启动。
启动后再插入电源充电， 插入电源后，bq24735会触发中断：
然后再断开电源停止充电。
