【转】android电池（五）：电池 充电IC（PM2301）驱动分析篇

关键词：android 电池  电量计  PL2301任务初始化宏 power_supply 中断线程化

平台信息:
内核：linux2.6/linux3.0
系统：android/android4.0 
平台：samsung exynos 4210、exynos 4412 、exynos 5250

作者：xubin341719(欢迎转载，请注明作者)

欢迎指正错误，共同学习、共同进步！！

完整驱动代码&规格书下载:MAX17040_PL2301

android 电池（一）：锂电池基本原理篇

android 电池（二）：android关机充电流程、充电画面显示

android 电池（三）：android电池系统

android电池（四）：电池 电量计(MAX17040)驱动分析篇

android电池（五）：电池 充电IC（PM2301）驱动分析篇

android充电这块，有的电源管理芯片内部包含充电管理，如s5pv210上常用的AT8937。我们这次用的max77686没有充电控制这块，所以我们加入一个充电IC来控制，选用PM2301.

一、PM2301和主控、电池的逻辑

如下图所示：

1、蓝色部分：IIC控制接口，这个说得太多了，好多外围器件都是通过IIC控制的，这个一定要熟悉、熟悉、熟烂了，然后可以完成比较多的工作。

2、黄色部分：中断、使能控制脚，CHG_STATUS（IRQ）、 DC_IN_INT（WAKE_UP） 、 PM2301_LP（LPN）、CHARGER_EN(ENN)控制引脚；

IRQ：充电IC的状态，如果有动作通知主控；

WAKE_UP：如果有DC插入，产生中断通知主控；

LPN：

ENN：充电IC使能;

3、PM2301 、电池、系统电压的大致逻辑

标号1：系统电压有PM2301提供；

标号2：PM2301给电池充电；

标号3：系统电压有电池提供；

标号：1和标号：3不同时提供电压给系统，中间有一个MOS管切换；分两种情况：

（1）、不插充电器时，有电池提供电压给系统，走通道标号：3给系统供电；

（2）、插入DC后，系统侦测到DC插入，把3的通道关闭，打开1给系统供电，同时有2给电池充电；

二、PM2301硬件电路

如下所示：

Q5这个MOS管，就是控制系统供电的，没有充电时，VBATT有VBAT+提供，充电时，VBATT有SENSE_COMM提供。

控制脚对应主控的引脚：

IIC	IIC ID 为2
CHG_STATUS（IRQ）	EXYNOS4_GPX1(3)
DC_IN_INT（WAKE_UP）	EXYNOS4_GPX0(7)
PM2301_LP（LPN）	EXYNOS4_GPX1(7)
CHARGER_EN(ENN)	EXYNOS4_GPL2(0)

下图为PM2301的参考电路解法，同样看到P1控制VSYSTEM电源部分的切换控制。

下图为整个电池充电的过程控制：

Trickle mode、Constant current mode (CC mode or fast charge mode)、Constant voltage mode (CV mode) 、End of charge feature

三、PL2301驱动部分

PL2301的硬件、工作原理做简单的解释，接下来我们分析驱动程序：

驱动用到知识点：

IIC的注册；

      任务初始化宏（在上一篇我们简单提过）；

中断线程化；

1、IIC的注册

这个和上一篇所说的电量计相似；

（1）、pm2301驱动部分

static const struct i2c_device_id pm2301_id[] = {
    { "pm2301", 0 },
    { }
};
MODULE_DEVICE_TABLE(i2c, pm2301_id);

static struct i2c_driver pm2301_i2c_driver = {
    .driver    = {
        .name    = "pm2301",
    },
    .probe        = pm2301_probe,
    .remove        = __devexit_p(pm2301_remove),
    .suspend    = pm2301_suspend,
    .resume        = pm2301_resume,
    .id_table    = pm2301_id,
};

static int __init pm2301_init(void)
{
    printk(KERN_INFO "pm2301_init !!
");
    return i2c_add_driver(&pm2301_i2c_driver);
}
module_init(pm2301_init);

（2）、平台驱动部分

arch/arm/mach-exynos/mach-smdk4x12.c

static struct i2c_board_info i2c_devs1[] __initdata = {

…………
#ifdef CONFIG_CHARGER_PM2301
    {
        I2C_BOARD_INFO("pm2301", 0x2c),
        .platform_data    = &pm2301_platform_data,
    },
#endif
…………
};

下图就是我们IIC驱动注册生成的文件；

/sys/bus/i2c/drivers/pm2301

2、关于：pm2301_platform_data这个结构体

static struct pm2301_platform_data pm2301_platform_data = {
    .hw_init = pm2301_hw_init,//（1）、硬件接口初始化化；
    .gpio_lpn = GPIO_PM2301_LP,//（2）、结构体初始化；
    .gpio_irq = GPIO_CHARGER_STATUS,
    .gpio_enn = GPIO_CHARGER_ENABLE,
    .gpio_wakeup = GPIO_CHARGER_ONLINE,
};

arch/arm/mach-exynos/mach-smdk4x12.c

（1）、硬件接口初始化

static int pm2301_hw_init(void)
{
    printk("pm2301_hw_init !!
");

    if (gpio_request(GPIO_CHARGER_ONLINE, "GPIO_CHARGER_ONLINE"))    {
        printk(KERN_ERR "%s :GPIO_CHARGER_ONLINE request port error!
", __func__);
        goto err_gpio_failed;
    } else {
        s3c_gpio_setpull(GPIO_CHARGER_ONLINE, S3C_GPIO_PULL_NONE);
        s3c_gpio_cfgpin(GPIO_CHARGER_ONLINE, S3C_GPIO_SFN(0));
        gpio_direction_input(GPIO_CHARGER_ONLINE);
        gpio_free(GPIO_CHARGER_ONLINE);
    }

    if (gpio_request(GPIO_CHARGER_STATUS, "GPIO_CHARGER_STATUS"))    {
        printk(KERN_ERR "%s :GPIO_CHARGER_STATUS request port error!
", __func__);
        goto err_gpio_failed;
    } else {
        s3c_gpio_setpull(GPIO_CHARGER_STATUS, S3C_GPIO_PULL_NONE);
        s3c_gpio_cfgpin(GPIO_CHARGER_STATUS, S3C_GPIO_SFN(0));
        gpio_direction_input(GPIO_CHARGER_STATUS);
        gpio_free(GPIO_CHARGER_STATUS);
    }


    if (gpio_request(GPIO_CHARGER_ENABLE, "GPIO_CHARGER_ENABLE"))    {
        printk(KERN_ERR "%s :GPIO_CHARGER_ENABLE request port error!
", __func__);
        goto err_gpio_failed;
    } else {
        s3c_gpio_setpull(GPIO_CHARGER_ENABLE, S3C_GPIO_PULL_NONE);
        s3c_gpio_cfgpin(GPIO_CHARGER_ENABLE, S3C_GPIO_SFN(1));
        gpio_direction_output(GPIO_CHARGER_ENABLE, 0);
        gpio_free(GPIO_CHARGER_ENABLE);
    }

    if (gpio_request(GPIO_PM2301_LP, "GPIO_PM2301_LP"))    {
        printk(KERN_ERR "%s :GPIO_PM2301_LP request port error!
", __func__);
        goto err_gpio_failed;
    } else {
        s3c_gpio_setpull(GPIO_PM2301_LP, S3C_GPIO_PULL_NONE);
        s3c_gpio_cfgpin(GPIO_PM2301_LP, S3C_GPIO_SFN(1));
        gpio_direction_output(GPIO_PM2301_LP, 1);
        gpio_free(GPIO_PM2301_LP);
    }

    return 1;

err_gpio_failed:
    return 0;
}

（2）、结构体初始化

Include/linux/pm2301_charger.h

#define GPIO_CHARGER_ONLINE        EXYNOS4_GPX0(7)//对应控制脚的主控接口
#define GPIO_CHARGER_STATUS        EXYNOS4_GPX1(3)
#define GPIO_CHARGER_ENABLE     EXYNOS4_GPL2(0)
#define GPIO_PM2301_LP             EXYNOS4_GPX1(7)
struct pm2301_platform_data {
    int (*hw_init)(void);
    int gpio_enn;
    int gpio_wakeup;
    int gpio_irq;
    int gpio_lpn;
};
extern int pm2301_get_online(void);
extern int pm2301_get_status(void);

3、probe函数分析

如果你是初学者，建议多看程序，你会发现，其实驱动程序的格式大多都是相同的，如这个IIC 器件的， 队列、定时器之类的东西。

static int __devinit pm2301_probe(struct i2c_client *client,
                                  const struct i2c_device_id *id)
{
    struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent);
    struct pm2301_chip *chip;
    int ret;
    printk(KERN_INFO "PM2301 probe !!
");
//（1）、前面这部分是对IIC的初始化；
    if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE))
        return -EIO;

    chip = kzalloc(sizeof(*chip), GFP_KERNEL);

    if (!chip)
        return -ENOMEM;

    g_chip = chip;
    chip->client = client;
    chip->pdata = client->dev.platform_data;
    i2c_set_clientdata(client, chip);

    /* Hardware Init for PM2301 */
    if (chip->pdata->hw_init && !(chip->pdata->hw_init())) {
        dev_err(&client->dev, "hardware initial failed.
");
        goto err_hw_failed;
    }

    mutex_init(&i2c_lock);
//（2）、初始化两个队列
    INIT_DELAYED_WORK_DEFERRABLE(&chip->work_online, pm2301_online_work);
    INIT_DELAYED_WORK_DEFERRABLE(&chip->work_status, pm2301_ststus_work);
//（3）、中断线程化
    chip->irq_online = gpio_to_irq(chip->pdata->gpio_wakeup);
    chip->irq_status = gpio_to_irq(chip->pdata->gpio_irq);
    /* Request IRQ for PM2301 */
    ret = request_threaded_irq(chip->irq_online,
                               NULL, pm2301_dcin,
                               IRQF_TRIGGER_FALLING | IRQF_TRIGGER_RISING,
                               "PM2301 DC IN", chip);

    if (ret) {
        printk(KERN_ERR "Cannot request irq %d for DC (%d)
",
               chip->irq_online, ret);
        goto err_hw_failed;
    }

#ifdef PM2301_REPORT_STATUS_BY_IRQ

    ret = request_threaded_irq(chip->irq_status,
                               NULL, pm2301_status,
                               IRQF_TRIGGER_FALLING,
                               "PM2301 STATUS", chip);

    if (ret) {
        printk(KERN_ERR "Cannot request irq %d for CHARGE STATUS (%d)
",
               chip->irq_status, ret);
        goto err_hw_failed;
    }
#endif


    charger_initial = 1;
    g_has_charged = 0;
    g_has_charging_full_or_stop = 0;

#ifdef PM2301_REPORT_STATUS_BY_IRQ
    /* Set wakeup source for online pin*/
    irq_set_irq_wake(chip->irq_status, 1);
#endif
    /* Set wakeup source for online pin*/
    irq_set_irq_wake(chip->irq_online, 1);

    /* Init default interrupt route for PM2301 */
    pm2301_reg_init(chip->client);
    /* Init online & status value */
    chip->online = pm2301_charger_online(chip);
    g_pm2301_online = chip->online;    /* Sync to global */
    pm2301_charger_enable(chip->client, chip->online);
    pm2301_charger_status(chip);

    printk(KERN_INFO "PM2301 probe success!!
");
    return 0;
err_hw_failed:
    dev_err(&client->dev, "failed: power supply register
");
    i2c_set_clientdata(client, NULL);
    kfree(chip);
    return ret;
}

(1)、前面这部分是对IIC的初始化

这部分就不再多说了，搞来搞去都是这个老样子；

(2)、任务初始化宏

    INIT_DELAYED_WORK_DEFERRABLE(&chip->work_online, pm2301_online_work);
    INIT_DELAYED_WORK_DEFERRABLE(&chip->work_status, pm2301_ststus_work);

把pm2301_online_work加入队列chip->work_online, pm2301_ststus_work加入chip->work_status队列。

(3)、中断线程化  request_threaded_irq

为什么要提出中断线程化?
在 Linux 中，中断具有最高的优先级。不论在任何时刻，只要产生中断事件，内核将立即执行相应的中断处理程序，等到所有挂起的中断和软中断处理完毕后才能执行正常的任务，因此有可能造成实时任务得不到及时的处理。中断线程化之后，中断将作为内核线程运行而且被赋予不同的实时优先级，实时任务可以有比中断线程更高的优先级。这样，具有最高优先级的实时任务就能得到优先处理，即使在严重负载下仍有实时性保证。但是,并不是所有的中断都可以被线程化，比如时钟中断，主要用来维护系统时间以及定时器等，其中定时器是操作系统的脉搏，一旦被线程化，就有可能被挂起，这样后果将不堪设想，所以不应当被线程化。 

看下我们程序中如何把中断线程化的：

    chip->irq_online = gpio_to_irq(chip->pdata->gpio_wakeup);
    chip->irq_status = gpio_to_irq(chip->pdata->gpio_irq);

看到这里是否想起：

static struct pm2301_platform_data pm2301_platform_data = {
　　　　………………
    .gpio_lpn = GPIO_PM2301_LP,
    .gpio_irq = GPIO_CHARGER_STATUS,
    .gpio_enn = GPIO_CHARGER_ENABLE,
    .gpio_wakeup = GPIO_CHARGER_ONLINE,
};

#define GPIO_CHARGER_ONLINE        EXYNOS4_GPX0(7)
#define GPIO_CHARGER_STATUS        EXYNOS4_GPX1(3)
#define GPIO_CHARGER_ENABLE         EXYNOS4_GPL2(0)
#define GPIO_PM2301_LP             EXYNOS4_GPX1(7)

感觉申请个中断脚，这样有点费劲呀；

中断线程化：

    /* Request IRQ for PM2301 */
    ret = request_threaded_irq(chip->irq_online,
                               NULL, pm2301_dcin,
                               IRQF_TRIGGER_FALLING | IRQF_TRIGGER_RISING,
                               "PM2301 DC IN", chip);

当有插入DC中断出发时调用：

static irqreturn_t pm2301_dcin(int irq, void *_data)
{
    struct pm2301_chip *chip = _data;
    schedule_delayed_work(&chip->work_online, PM2301_DELAY);
    return IRQ_HANDLED;
}

Pm2301_dcin调度队列：chip->work_online执行：pm2301_online_work函数

static void pm2301_online_work(struct work_struct *work)
{
    struct pm2301_chip *chip;
    chip = container_of(work, struct pm2301_chip, work_online.work);
    int new_online = pm2301_charger_online(chip);

    if (chip->online != new_online) {
        chip->online = new_online;
        g_pm2301_online = chip->online;    /* Sync to global */
        pm2301_charger_enable(chip->client, chip->online);//①、初始化充电IC；
#ifdef PM2301_REPORT_STATUS_BY_IRQ

        /*To avoid status pin keep low*/
        schedule_delayed_work(&chip->work_status, 1000);
#endif
#if defined(CONFIG_BATTERY_MAX17040)
        TriggerGasgaugeUpdate();//②、把DC状态更新到max17040;
#endif
    }
}

①、初始化电IC

这里面主要是写一些寄存器

static void pm2301_charger_enable(struct i2c_client *client, int online)
{
    if (online) {    /* Enabled Charging*/
        int batt_capacity = 0;
        batt_capacity = GetGasgaugeCapacity();
        /* Don't start charging if battery capacity above 95% when DC plug in*/
        if(0) {
        //if( batt_capacity >= 95 ) {
            pm2301_write_reg(client, 0x01, 0x02);
            pm2301_write_reg(client, 0x26, 0x00);   /* always keep the register to 0 */
        } else {
            pm2301_write_reg(client, 0x00, 0x01);   /* force resume of charging */
            pm2301_write_reg(client, 0x01, 0x06);    /* ChEn=1, AutoResume=1 */
            pm2301_write_reg(client, 0x05, 0x7A);     /* ChEoccurrentLevel:150mA, ChPrechcurrentLevel:100mA, ChCCcurrentLevel:1000mA/2000mA */
            pm2301_write_reg(client, 0x06, 0x0A);    /* ChVersumeVot:3.6V ChPrechVoltLevel:2.9V */
            pm2301_write_reg(client, 0x07, 0x1E);    /* ChVoltLevel:4.25V */
            pm2301_write_reg(client, 0x26, 0x00);     /* always keep the register to 0 */
        }
        g_has_charged = 1;
    } else {    /* Disable Charging*/
        pm2301_write_reg(client, 0x01, 0x02);
        pm2301_write_reg(client, 0x26, 0x00);   /* always keep the register to 0 */
        g_has_charged = 0;
    }
}

②、把DC状态更新到max17040

TriggerGasgaugeUpdate()

插入DC这部流程如下：