📚 课程目录第3章 Sensor驱动初始化流程

3. Sensor驱动初始化流程

Sensor驱动初始化，说白了就是让摄像头芯片“活过来”的过程。很多刚入行的朋友觉得这步就是照着datasheet填寄存器，没什么技术含量。我刚开始也这么想，直到有一次在RK3588平台上调一个4K sensor，上电时序差了2ms，图像死活出不来……嗯，从那以后我再也不敢小看这个环节了。

这一章我们聚焦三个核心模块：上电时序与复位逻辑、PLL配置与时钟树、寄存器读写接口封装。这三块是Sensor驱动的骨架，任何一个环节出问题，后面的3A算法调得再好也没用。

核心观点：Sensor初始化不是简单的“写寄存器”，而是硬件时序、时钟频率、软件接口三者的协同。时序错了Sensor不工作，时钟错了图像花屏，接口封装不好后面调试想哭。

3.1 上电时序与复位逻辑

上电时序是Sensor初始化的第一步，也是最容易踩坑的地方。Sensor芯片内部有多个电源域：模拟电源（AVDD）、数字核心电源（DVDD）、IO电源（IOVDD）。这三个电源的上电顺序和间隔时间，datasheet里通常会给一个时序图。

我个人习惯把上电时序分成三步来理解：

先上模拟电源（AVDD）——Sensor的模拟电路先准备好，通常是2.8V或3.3V。
再上数字核心电源（DVDD）——数字逻辑部分开始工作，一般是1.2V或1.8V。
最后上IO电源（IOVDD）——IO接口供电，通常是1.8V。

为什么是这个顺序？因为模拟电路对噪声最敏感，先上电让它先稳定。数字电路上电时会产生一些毛刺，如果IO先上电，这些毛刺可能直接串到I2C总线上，导致通信异常。

我曾经踩过的坑：在RK3588上调试一款OV的Sensor，IOVDD和DVDD同时上电，结果I2C通信时好时坏。后来用示波器一抓，发现DVDD上电瞬间有一个200mV的毛刺串到了IOVDD上。把IOVDD延迟5ms上电后，问题解决。

复位逻辑相对简单，但要注意：复位释放必须在所有电源稳定之后。有些Sensor支持硬件复位（XSHUTDOWN引脚），有些只支持软件复位（写寄存器）。我建议在驱动里同时实现两种复位方式，调试时灵活切换。

电源轨	典型电压	上电顺序	稳定时间
AVDD	2.8V / 3.3V	第1位	1ms ~ 5ms
DVDD	1.2V / 1.8V	第2位	1ms ~ 3ms
IOVDD	1.8V	第3位	0.5ms ~ 2ms
复位释放	—	最后	所有电源稳定后

小技巧：上电时序可以用GPIO控制PMIC来实现。在设备树里配置好各电源轨的regulator，驱动里按顺序调用regulator_enable()。别用msleep()硬等，用usleep_range()更精确。

3.2 PLL配置与时钟树

时钟是Sensor的“心跳”。Sensor内部有一个PLL（锁相环），把外部输入的MCLK（主时钟）倍频到内部需要的各种频率。你想想看，如果PLL配置不对，像素时钟（PCLK）就偏了，图像要么花屏，要么帧率不对。

PLL配置的核心公式很简单：

VCO = MCLK × N / M
输出时钟 = VCO / (P × Q)

其中N是倍频系数，M是预分频系数，P和Q是后分频系数。不同Sensor的PLL结构略有差异，但思路是一样的：先倍频到VCO，再分频到目标频率。

我在项目中遇到过一个问题：一款Sony的Sensor，MCLK是27MHz，目标PCLK是74.25MHz（1080p@60fps的标准时钟）。按照公式算出来N=11，M=4，P=1，Q=1，VCO=74.25MHz。但实际输出总是73.8MHz，差了0.6%。

后来查datasheet才发现，这个Sensor的PLL对VCO频率有范围限制——必须在80MHz~200MHz之间。74.25MHz低于下限，PLL锁不住。解决方案是调整分频系数，让VCO跑到148.5MHz，再用2分频得到74.25MHz。

经验总结：配置PLL时，先查VCO的允许范围，再反推分频系数。不要只看目标频率，VCO范围才是硬约束。

时钟树的结构通常如下：

MCLK：外部输入，24MHz或27MHz最常见
PLL：倍频到VCO频率
VT（Video Timing）：用于像素阵列扫描的时钟
PCLK（Pixel Clock）：数据输出时钟，与MIPI速率相关
SCLK（System Clock）：内部逻辑时钟

配置时钟时，我习惯先写一个计算函数，把MCLK、目标帧率、分辨率、MIPI Lane数作为输入，自动算出PLL参数。这样换Sensor或改分辨率时，不用手动算一遍。

/* PLL参数计算示例 */
static int sensor_calc_pll_params(struct sensor_pll *pll, 
                                   int mclk, int target_pclk)
{
    int n, m, p, q;
    int vco_min = 80000000;  /* 80MHz */
    int vco_max = 200000000; /* 200MHz */
    int vco_target;

    /* 先确定VCO在允许范围内 */
    vco_target = target_pclk;
    while (vco_target < vco_min)
        vco_target *= 2;
    while (vco_target > vco_max)
        vco_target /= 2;

    /* 反推分频系数 */
    p = vco_target / target_pclk;
    n = vco_target / mclk;
    m = 1;
    q = 1;

    pll->n = n;
    pll->m = m;
    pll->p = p;
    pll->q = q;
    pll->vco = vco_target;

    return 0;
}

调试建议：PLL配置完成后，读回PLL锁定状态寄存器。如果锁定位没置1，说明PLL没锁住，检查MCLK是否稳定、分频系数是否合理。别急着往下走，PLL没锁住写再多寄存器也没用。

3.3 寄存器读写接口封装

Sensor的寄存器读写通常通过I2C或SPI接口完成。这部分看似简单，但封装得好不好，直接影响后续调试效率。

我见过很多驱动把I2C读写函数直接暴露给上层，结果每个模块都要自己处理I2C地址、寄存器长度、数据长度。代码重复不说，出问题时排查起来特别痛苦。

我的做法是封装三层接口：

层级	函数名	功能
底层	sensor_i2c_read/sensor_i2c_write	直接操作I2C总线，处理地址和长度
中间层	sensor_reg_read/sensor_reg_write	封装寄存器地址解析，支持8/16/32位
上层	sensor_reg_update	读-改-写操作，用于只修改某几位

底层接口直接调用I2C核心层的API，中间层处理寄存器地址的字节序和长度，上层提供便捷的位操作。这样分层后，换I2C控制器或改寄存器地址长度时，只需要改底层，上层代码完全不用动。

/* 中间层封装示例 */
int sensor_reg_read(struct i2c_client *client, 
                    u16 reg, u32 *val, int len)
{
    struct i2c_msg msg[2];
    u8 reg_buf[2];
    u8 data_buf[4];
    int ret;

    /* 寄存器地址按大端序打包 */
    reg_buf[0] = (reg >> 8) & 0xff;
    reg_buf[1] = reg & 0xff;

    msg[0].addr = client->addr;
    msg[0].flags = 0;
    msg[0].len = 2;
    msg[0].buf = reg_buf;

    msg[1].addr = client->addr;
    msg[1].flags = I2C_M_RD;
    msg[1].len = len;
    msg[1].buf = data_buf;

    ret = i2c_transfer(client->adapter, msg, 2);
    if (ret != 2)
        return -EIO;

    /* 按长度解析数据 */
    if (len == 1)
        *val = data_buf[0];
    else if (len == 2)
        *val = (data_buf[0] << 8) | data_buf[1];
    else if (len == 4)
        *val = (data_buf[0] << 24) | (data_buf[1] << 16) |
               (data_buf[2] << 8) | data_buf[3];

    return 0;
}

注意：不同Sensor的寄存器地址长度不一样，有8位、16位、甚至32位。封装时一定要把地址长度作为参数传进去，不要写死。我曾经接手过一个驱动，地址长度写死在宏定义里，换Sensor时改得想哭。

上层接口sensor_reg_update()特别实用。很多Sensor的寄存器是多个功能位共用一个地址，比如bit[3:0]控制增益，bit[7:4]控制曝光。如果直接写整个寄存器，会覆盖其他位的值。用读-改-写操作，只修改目标位，其他位保持不变。

/* 读-改-写操作示例 */
int sensor_reg_update(struct i2c_client *client, 
                      u16 reg, u8 mask, u8 val)
{
    u32 old_val, new_val;
    int ret;

    ret = sensor_reg_read(client, reg, &old_val, 1);
    if (ret)
        return ret;

    new_val = (old_val & ~mask) | (val & mask);
    if (new_val != old_val) {
        ret = sensor_reg_write(client, reg, new_val, 1);
        if (ret)
            return ret;
    }

    return 0;
}

个人习惯：在读写接口里加调试打印，用dev_dbg()输出每次读写的寄存器地址和值。开发阶段打开调试，量产时关掉。这样出问题时，打开调试就能看到完整的寄存器操作日志，定位问题快很多。

嗯，到这里Sensor驱动初始化的三个核心模块就讲完了。上电时序是硬件基础，PLL配置是时钟核心，寄存器接口是软件骨架。这三块做好了，Sensor就能稳定工作，后面的3A算法调优才有意义。