📚 课程目录第3章 Regulator子系统简介

3. Regulator 子系统简介：Regulator 概念、Consumer 与 Provider、电压调节器在摄像头供电中的作用

在摄像头驱动开发中，为摄像头模组提供稳定、精确的电压是保证图像质量与设备安全的前提。Linux 内核的 Regulator 子系统 正是为此而生，它提供了一套统一的框架来管理各类电压/电流调节器。本章将深入剖析 Regulator 的核心概念、Consumer/Provider 架构，并阐明其在摄像头供电中的关键作用。

3.1 Regulator 核心概念

Regulator（调节器）在 Linux 内核中抽象为一种能够提供稳定电压或电流输出的硬件设备。它可以是专用的 PMIC（电源管理集成电路）芯片，也可以是 SoC 内部集成的 LDO（低压差线性稳压器）或 DC-DC 转换器。

概念	描述	摄像头场景示例
Regulator	提供受控电源输出的硬件或软件抽象	PMIC 输出的 2.8V LDO，专供摄像头 AVDD
Consumer	使用 Regulator 供电的设备或驱动模块	摄像头传感器驱动，通过 API 请求开启/关闭电源
Provider	实现 Regulator 功能的硬件驱动	PMIC 驱动，负责配置寄存器以输出指定电压
Constraints	对 Regulator 输出范围、模式、状态的限制	摄像头 DVDD 必须限制在 1.1V ~ 1.3V 之间
Voltage	调节器输出的电压值，单位为微伏 (µV)	AVDD = 2800000 µV (2.8V)
Current	调节器能提供的最大负载电流	摄像头模组最大消耗 150 mA

关键理解： Regulator 子系统将电源管理的复杂性封装起来，驱动开发者无需关心底层硬件如何调节电压，只需通过标准 API 请求“我需要 2.8V”即可。这种抽象极大地提高了代码的可移植性和复用性。

3.2 Consumer 与 Provider 架构

Regulator 子系统采用经典的 Consumer-Provider 设计模式。Provider 负责实现具体的硬件操作，Consumer 通过内核提供的通用接口与 Provider 交互。两者通过 regulator_map 结构体建立连接，该映射通常在设备树中描述。

3.3 电压调节器在摄像头供电中的作用

摄像头模组通常需要多路不同的电压才能正常工作。以一款典型的 500 万像素 CMOS 传感器为例，其供电需求如下：

电源轨	典型电压	用途	Regulator 作用
AVDD	2.8V	模拟电路供电（像素阵列、ADC）	提供低噪声、高 PSRR 的稳定电压，直接影响图像信噪比
DVDD	1.2V	数字核心供电（ISP、逻辑电路）	精确输出 1.2V，过高会损坏芯片，过低导致逻辑错误
IOVDD	1.8V	I/O 接口供电（MIPI、I2C、GPIO）	必须与主控 SoC 的 I/O 电压匹配，否则通信失败

上电时序关键点： 摄像头对电源上电顺序有严格要求。例如，必须先建立 AVDD，再建立 DVDD，最后建立 IOVDD，且各电源之间通常需要 0.1ms ~ 1ms 的延迟。Regulator 子系统通过 regulator_enable() 和 regulator_set_voltage() 配合 GPIO 或延时函数，可以精确控制这一时序。

3.4 摄像头驱动中的 Regulator 操作流程

在摄像头驱动中，典型的 Regulator 操作流程如下：

获取 Regulator 句柄： 在 probe 函数中，通过设备树属性获取对应的 regulator。
设置电压： 调用 regulator_set_voltage() 设定目标电压。
使能 Regulator： 调用 regulator_enable() 开启电源输出。
检查状态： 通过 regulator_is_enabled() 确认电源已稳定。
关闭 Regulator： 在 suspend 或 remove 时，调用 regulator_disable() 关闭电源以节省功耗。

3.5 代码示例：摄像头驱动中的 Regulator 配置

以下代码展示了在摄像头驱动 probe 函数中如何获取并配置三路 regulator：

#include <linux/regulator/consumer.h>

struct cam_device {
    struct regulator *avdd;
    struct regulator *dvdd;
    struct regulator *iovdd;
};

static int cam_probe(struct platform_device *pdev)
{
    struct cam_device *cam;
    int ret;

    cam = devm_kzalloc(&pdev->dev, sizeof(*cam), GFP_KERNEL);
    if (!cam)
        return -ENOMEM;

    /* 1. 获取三路 regulator */
    cam->avdd = devm_regulator_get(&pdev->dev, "avdd");
    if (IS_ERR(cam->avdd))
        return PTR_ERR(cam->avdd);

    cam->dvdd = devm_regulator_get(&pdev->dev, "dvdd");
    if (IS_ERR(cam->dvdd))
        return PTR_ERR(cam->dvdd);

    cam->iovdd = devm_regulator_get(&pdev->dev, "iovdd");
    if (IS_ERR(cam->iovdd))
        return PTR_ERR(cam->iovdd);

    /* 2. 设置电压 (单位: µV) */
    regulator_set_voltage(cam->avdd, 2800000, 2800000);
    regulator_set_voltage(cam->dvdd, 1200000, 1200000);
    regulator_set_voltage(cam->iovdd, 1800000, 1800000);

    /* 3. 按序使能：先 AVDD，再 DVDD，最后 IOVDD */
    ret = regulator_enable(cam->avdd);
    if (ret)
        return ret;
    udelay(100);  /* 等待 100µs */

    ret = regulator_enable(cam->dvdd);
    if (ret)
        goto err_disable_avdd;
    udelay(100);

    ret = regulator_enable(cam->iovdd);
    if (ret)
        goto err_disable_dvdd;

    /* 摄像头初始化代码... */
    return 0;

err_disable_dvdd:
    regulator_disable(cam->dvdd);
err_disable_avdd:
    regulator_disable(cam->avdd);
    return ret;
}

注意事项：

使用 devm_regulator_get() 可以自动管理 regulator 的生命周期，避免资源泄漏。
电压设置应使用微伏 (µV) 为单位，1V = 1000000 µV。
上电时序延迟必须根据传感器数据手册精确设置，过短可能导致初始化失败，过长则影响开机速度。
在错误处理路径中，务必按照使能的逆序关闭 regulator，避免损坏硬件。

3.6 小结

Regulator 子系统为摄像头驱动提供了标准化的电源管理接口。通过 Consumer-Provider 架构，驱动开发者可以专注于业务逻辑，而将电压调节的硬件细节交由 Provider 驱动处理。在摄像头供电中，Regulator 不仅负责提供精确的电压，还通过时序控制保证了传感器在上电瞬间不会因电压不稳而损坏。掌握 Regulator 子系统的使用，是编写健壮摄像头驱动的基础。