全志axp驱动框架概述

1. 前言

axp驱动是全志平台电源管理驱动，在linux在有接口框架；
的是为操作电压和电流调节器提供一个标准的内核接口；
通过该接口，用户空间可以动态控制系统调节器的输出，以节省电力，延长电池寿命。 这套接口同时包含了电压调整和电流调整的功能

2. 基本概念

• Regulator
  调节器，为其他模块提供电能，其输出电压和电流可以调节。
  输入电压 --> regulator --> 输出电压

• PMIC
  电压管理芯片。内部包含多个regulator，通常还有别的功能：温度检测、外扩GPIO（可以作为按键输入或者马达驱动）。

• Consumer
  消费者（消耗电流的设备）：Linux下对耗电设备的抽象，由Regulator提供输入；
  可以分为两类：
  静态：电流电压固定，工作过程中不需要改；只需要提供开关功能。
  动态：为满足不同工作，需要动态改变电压电流。

• Constraints
  约束条件：Regulator和Consumer都有各自的约束条件，Regulator的约束条件定义了它可以提供的最大/最小电压、最大/最小电流，Consumer的约束条件定义了它正常工作的最大/最小电压、最大/最小电流。
  在动态调整电压电流时，都会首先检查设置值是否满足约束条件。

3. 框架提供的接口

1．消费者（指实际消耗电流的设备）驱动接口
2．调节器驱动接口
为调节器驱动提供注册内核注册接口。
3．用户空间接口
通过sysfs向用户空间提供监测能力。

4. regulator框架

代码位置：drivers/regulator/core.c
regulator是作为platform设备注册到系统上，每一个regulator有一个对应的regulator_init_data数据结构进行描述：

struct regulator_init_data {
        const char *supply_regulator;        /* or NULL for system supply */

        struct regulation_constraints constraints;

        int num_consumer_supplies;
        struct regulator_consumer_supply *consumer_supplies;

        /* optional regulator machine specific init */
        int (*regulator_init)(void *driver_data);
        void *driver_data;      /* core does not touch this */
};

constraints：
约束条件，定义了该regulator可以提供的最大/最小电压、最大/最小电流，对regulator进行改变设置前都会检测是否满足该约束条件。
consumer_supplies：
供电映射关系，指示了由regulator供电的耗电设备。

（1）驱动接口

regulator为设备驱动提供了一系列的接口，驱动程序可以方便地：动态修改regulator的输出电压/电流、关闭/开启电源

regulator = regulator_get(dev, "Vcc");
驱动程序调用regulator_get，可以得到为其供电的regulator指针。其中 'Vcc" 就是regulator需要进行匹配的名字。对于regulator，这个名字是在consumer_supplies下的supply成员定义。
int regulator_enable(regulator);
开启regulator输出。
int regulator_disable(regulator);
关闭regulator输出。需要注意的是，驱动调用这个函数时，如果其他设备也由这个regulator进行供电，那么就不会关闭regulator。
int regulator_set_voltage(regulator, min_uV, max_uV);
设置regulator的输出范围。
int regulator_get_voltage(regulator);
获取regulator的当前输出。
int regulator_set_current_limit(regulator, min_uA, max_uA);
设置输出电流范围。
int regulator_get_current_limit(regulator);
获取当前的输出电流

（2）用户空间接口
通过sysfs向用户空间提供regulator的查询和设置。
当regulator的驱动注册完成，drivers/regulator/core.c中的add_regulator_attributes函数会为每一个regulator在sysfs上注册属性节点。

/sys/class/regulator/regulator.X/name
cat显示regulator的名字
/sys/class/regulator/regulator.X/max_microvolts
rw
cat 显示当前最大输出电压
echo 3300000 > /sys/class/regulator/regulator.X/max_microvolts 设置最大输出电压为3.3v

/sys/class/regulator/regulator.X/min_microvolts
最小输出电压
/sys/class/regulator/regulator.X/microvolts
当前输出电压
/sys/class/regulator/regulator.X/state
当前regulator的状态
/sys/class/regulator/regulator.X/num_users
regulator被多少个设备引用。