全志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被多少个设备引用。