4. 驱动初始化流程：probe函数解析、电源上电时序、时钟配置、复位时序控制

在瑞芯微RK平台Camera Sensor驱动开发中，probe函数是驱动与内核设备模型交互的入口点，负责完成从硬件识别到设备注册的全过程。本章将深入解析probe函数的执行流程，重点剖析电源上电时序、时钟配置与复位时序控制这三个直接影响Sensor初始化成败的关键环节。

4.1 probe函数执行流程解析

probe函数在设备与驱动匹配成功时被内核调用，其典型执行流程如下：

1. 设备树解析：读取设备树节点中的电源、时钟、GPIO等资源信息。
2. 电源上电时序控制：按照Sensor数据手册要求的顺序与延时，依次使能各电源域。
3. 时钟配置：配置MCLK主时钟频率，并等待时钟稳定。
4. 复位时序控制：通过GPIO控制Sensor复位引脚，完成硬件复位。
5. I2C通信验证：读取Sensor的芯片ID，确认通信正常。
6. 初始化序列下发：通过I2C写入Sensor寄存器配置序列。
7. V4L2子设备注册：将Sensor注册为V4L2子设备，完成驱动加载。

4.2 电源上电时序控制

Camera Sensor通常需要多路电源供电，包括模拟电压（AVDD）、数字电压（DVDD）和IO电压（IOVDD）。电源上电时序必须严格遵循Sensor数据手册的要求，否则可能导致Sensor内部电路闩锁或损坏。

4.2.1 典型电源域与电压范围

4.2.2 上电时序代码实现

在RK平台驱动中，通常使用regulator框架控制电源，配合gpiod控制电源使能引脚。以下为典型上电时序代码：

static int sensor_power_on(struct device *dev)
{
    struct sensor_dev *sensor = dev_get_drvdata(dev);
    int ret;

    /* 1. 使能AVDD（2.8V） */
    ret = regulator_enable(sensor->avdd_reg);
    if (ret)
        goto err_avdd;
    usleep_range(2000, 3000);  /* 等待2ms */

    /* 2. 使能DVDD（1.2V） */
    ret = regulator_enable(sensor->dvdd_reg);
    if (ret)
        goto err_dvdd;
    usleep_range(1000, 2000);  /* 等待1ms */

    /* 3. 使能IOVDD（1.8V） */
    ret = regulator_enable(sensor->iovdd_reg);
    if (ret)
        goto err_iovdd;
    usleep_range(1000, 2000);  /* 等待1ms */

    /* 4. 等待所有电源稳定 */
    msleep(10);

    return 0;

err_iovdd:
    regulator_disable(sensor->dvdd_reg);
err_dvdd:
    regulator_disable(sensor->avdd_reg);
err_avdd:
    dev_err(dev, "power on failed\n");
    return ret;
}

4.3 时钟配置

Sensor需要外部提供主时钟（MCLK）作为内部PLL的参考源。时钟频率的精度和稳定性直接影响Sensor的输出帧率和图像质量。

4.3.1 MCLK频率选择

4.3.2 RK平台时钟配置实现

在RK平台中，MCLK通常由SoC的CLK_OUT或MIPI_REF时钟源提供，通过clk_set_rate配置频率：

static int sensor_clk_config(struct device *dev)
{
    struct sensor_dev *sensor = dev_get_drvdata(dev);
    int ret;

    /* 获取时钟句柄 */
    sensor->mclk = devm_clk_get(dev, "xvclk");
    if (IS_ERR(sensor->mclk)) {
        dev_err(dev, "failed to get xvclk\n");
        return PTR_ERR(sensor->mclk);
    }

    /* 设置MCLK频率为24MHz */
    ret = clk_set_rate(sensor->mclk, 24000000);
    if (ret) {
        dev_err(dev, "failed to set mclk rate\n");
        return ret;
    }

    /* 使能时钟 */
    ret = clk_prepare_enable(sensor->mclk);
    if (ret) {
        dev_err(dev, "failed to enable mclk\n");
        return ret;
    }

    /* 等待时钟稳定 */
    usleep_range(1000, 2000);

    return 0;
}

4.4 复位时序控制

复位操作是Sensor初始化的最后一道硬件准备工序。复位时序控制包括复位引脚的拉低/拉高顺序、复位脉冲宽度以及复位后的等待时间。

4.4.1 复位类型与要求

4.4.2 硬件复位代码实现

static int sensor_hardware_reset(struct device *dev)
{
    struct sensor_dev *sensor = dev_get_drvdata(dev);

    /* 确保复位引脚为输出 */
    gpiod_direction_output(sensor->reset_gpio, 0);

    /* 拉低复位引脚，进入复位状态 */
    gpiod_set_value(sensor->reset_gpio, 0);
    usleep_range(2000, 3000);  /* 保持复位至少2ms */

    /* 拉高复位引脚，释放复位 */
    gpiod_set_value(sensor->reset_gpio, 1);
    usleep_range(5000, 6000);  /* 等待Sensor内部初始化完成 */

    dev_dbg(dev, "hardware reset completed\n");

    return 0;
}

4.5 完整probe函数示例

以下为整合了电源、时钟、复位流程的完整probe函数框架：

static int sensor_probe(struct i2c_client *client,
                        const struct i2c_device_id *id)
{
    struct device *dev = &client->dev;
    struct sensor_dev *sensor;
    int ret;

    /* 1. 分配设备结构体 */
    sensor = devm_kzalloc(dev, sizeof(*sensor), GFP_KERNEL);
    if (!sensor)
        return -ENOMEM;

    /* 2. 解析设备树 */
    ret = sensor_parse_dt(dev, sensor);
    if (ret)
        return ret;

    /* 3. 电源上电 */
    ret = sensor_power_on(dev);
    if (ret)
        return ret;

    /* 4. 时钟配置 */
    ret = sensor_clk_config(dev);
    if (ret)
        goto err_clk;

    /* 5. 硬件复位 */
    ret = sensor_hardware_reset(dev);
    if (ret)
        goto err_reset;

    /* 6. I2C通信验证：读取芯片ID */
    ret = sensor_check_chip_id(sensor);
    if (ret) {
        dev_err(dev, "chip id mismatch\n");
        goto err_id;
    }

    /* 7. 初始化序列下发 */
    ret = sensor_init_sequence(sensor);
    if (ret)
        goto err_init;

    /* 8. 注册V4L2子设备 */
    ret = sensor_v4l2_register(sensor);
    if (ret)
        goto err_v4l2;

    dev_info(dev, "sensor probe successfully\n");
    return 0;

err_v4l2:
err_init:
err_id:
err_reset:
    clk_disable_unprepare(sensor->mclk);
err_clk:
    sensor_power_off(dev);
    return ret;
}

4.6 常见问题与排查方法