linux regulator之浅见

Regulator模块用于控制系统中某些设备的电压/电流供应。在嵌入式系统（尤其是手机）中，控制耗电量很重要，直接影响到电池的续航时间。所以，如果系统中某一个模块暂时不需要使用，就可以通过regulator关闭其电源供应；或者降低提供给该模块的电压、电流大小。

Regulator的文档在KERNEL/Documentation/Power/Regulator中。

2、几个重要结构：

regulator_dev

regulator_dev代表一个regulator设备。

struct regulator_dev {

           struct regulator_desc *desc;         // 描述符，包括regulator的名称、ID、regulator_ops等

           int use_count;                                        // 使用计数

           /* lists we belong to */

           struct list_head list;                     // regulator通过此结构挂到regulator_list链表中

           struct list_head slist;                   // 如果有父regulator，通过此域挂到父regulator的链表

           /* lists we own */

           struct list_head consumer_list;     // 此regulator负责供电的设备列表

           struct list_head supply_list;                      //此regulator负责供电的子regulator

           struct blocking_notifier_head notifier;      // notifier，具体的值在consumer.h中，比如REGULATOR_EVENT_FAIL

           struct mutex mutex;

           struct module *owner;

           struct device dev;                                              // device结构，属于class regulator_class

           struct regulation_constraints *constraints; // 限制，比如最大电压/电流、最小电压/电流

           struct regulator_dev *supply;                  // 父regulator的指针

           void *reg_data;              /* regulator_dev data */

};

regulator_init_data

regulator_init_data在初始化时使用，用来建立父子regulator、受电模块之间的树状结构，以及一些regulator的基本参数。

struct regulator_init_data {

           struct device *supply_regulator_dev;                    // 父regulator的指针

           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 */

};

其它结构体自己可以看看～如

struct regulator　　　            -------> 设备驱动直接操作的结构体

struct regulation_constraints　　　　　  ----->regulator限制范围，其它信息，在于

　　　　　　　　　　　　　　　　　　　　　　　struct regulator_init_data，用于初始化

struct regulator_consumer_supply　　　----->consumer信息

struct regulator_desc                           ----->这个多关注些，内有正真操作设备函数结构体～

struct regulator_map                           ----->这个为consumers与regulator对应表

通常情况下，我们要在板级文件中fill一些结构，如struct regulator_init_data，这个在regulator初始化时必调用的；还有一般情况下电源管理PMU都是I2C设备，所以struct regulator_init_data经常作为I2C的私有数据来传递；另外由于一个PMU模块控制不只一个模块的电压，通常都是多个，所以需要多个struct regulator_init_data结构，并且通常定义成struct regulator_init_data xxxx[]数组结构，并调用platform_device_add（）来注册设备（struct regulator_init_data结构作为struct platform_device中的struct devices中的platformdata）。

regulator_desc

struct regulator_described｛

const char* name;

int id;

unsigned n_voltages;

struct regulator_ops *ops;

int irq;

enum regulator_type type;

struct module *owner;

}

3、注册regulator

板级信息和regulator_desc准备好之后就要注册了。

通过regulator_register函数登记生成一个regulator_dev。

struct regulator_dev *regulator_register(struct regulator_desc *regulator_desc, struct device *dev, struct regulator_init_data *init_data，void *driver_data)

{

struct regulator_dev *rdev；

....

//fill struct regulator_dev结构；

           device_register(&rdev->dev);                  // 注册设备

           // 设置constraints，其中可能会包括供电状态的初始化（设置初始电压，enable/disable等等）

           set_machine_constraints(rdev, &init_data->constraints);

           add_regulator_attributes (rdev);

           // 设置此regulator与其负责供电的设备之间的联系

for (i = 0; i < init_data->num_consumer_supplies; i++)

                       ret = set_consumer_device_supply(rdev, init_data->consumer_supplies[i].dev,

                                   init_data->consumer_supplies[i].supply);

           // 将regulator加入一个链表，该链表包含所有regulator

list_add(&rdev->list, &regulator_list);

.......

}

set_consumer_device_supply函数用于登记regulator_dev与comsumer_dev（regulator负责供电的设备）之间的对应关系。对于每一个regulator_dev—comsumer_dev的配对，都会有一个regulator_map结构，这些结构会被加入到全局链表regulator_map_list中。

4、regulator应用

在设备驱动使用regulator对其驱动的设备供电时，需要首先保证设备与对应regulator之间的匹配关系已经被登记到regulator框架中。

设备驱动通过regulator_get函数得到regulator结构，此函数通过前文所述regulator_map_list找到对应regulator_dev，再生成regulator结构给用户使用。

通过regulator_enable / regulator_disable打开、关闭regulator，这两个函数最终都是调用struct regulator_ops里的对应成员。

除此之外，还有regualtor_set_voltage / regulator_get_voltage等等。

具体代码查看：/kernel/driver/regulator/core.c