4. Sensor驱动开发基础：I2C通信协议、Sensor寄存器读写、驱动框架（V4L2 subdev）

在ISP调试项目中，Sensor驱动是连接硬件与上层图像处理管线的桥梁。本章将深入讲解基于I2C总线的Sensor寄存器读写机制、V4L2子设备驱动框架，以及如何在海思3519平台上快速搭建一个可用的Sensor驱动。

4.1 I2C通信协议与Sensor控制

绝大多数图像Sensor（如Sony IMX系列、OmniVision OV系列）都通过I2C总线进行寄存器配置。I2C是一种两线制（SCL时钟线、SDA数据线）同步串行通信协议，支持多主从设备挂载。

关键参数： Sensor I2C速率通常为 100kHz（标准模式）或 400kHz（快速模式），部分Sensor支持1MHz。地址一般为7位或10位，常见Sensor地址如 0x20、0x30、0x6C。

4.1.1 I2C通信时序与寄存器读写流程

Sensor寄存器读写遵循标准的I2C写/读协议：

  1. 写操作： 主机发送起始条件 + Sensor地址(W) + 寄存器地址高字节 + 寄存器地址低字节 + 数据字节 + 停止条件。
  2. 读操作： 主机先伪写寄存器地址，然后重新发送起始条件 + Sensor地址(R)，从机返回数据字节。
实战经验： 海思3519的I2C控制器支持自动连续读写，但部分Sensor要求寄存器地址必须分两次发送（高8位+低8位），且地址长度需在驱动中明确配置为16位。
I2C Sensor寄存器读写时序 I2C Sensor寄存器读写时序 写操作 (Write Cycle) S Addr+W RegH RegL Data P 读操作 (Read Cycle) S Addr+W RegH RegL Sr Addr+R Data P S/Sr 地址 寄存器 数据 P

4.2 Sensor寄存器读写实现

在海思3519平台上，Sensor驱动通常通过内核I2C子系统提供的API进行寄存器读写。以下是一个典型的Sensor读写函数实现：

/* sensor_i2c.c - Sensor I2C读写接口 */
#include <linux/i2c.h>
#include <linux/delay.h>

#define SENSOR_I2C_RETRY_TIMES    3
#define SENSOR_I2C_ADDR_LEN       2   /* 16位寄存器地址 */

/* 写Sensor寄存器 */
int sensor_write_reg(struct i2c_client *client, u16 reg_addr, u8 val)
{
    int ret;
    u8 buf[3];
    struct i2c_msg msg;

    buf[0] = (reg_addr >> 8) & 0xFF;   /* 寄存器地址高字节 */
    buf[1] = reg_addr & 0xFF;          /* 寄存器地址低字节 */
    buf[2] = val;                      /* 写入数据 */

    msg.addr  = client->addr;
    msg.flags = 0;                     /* 写标志 */
    msg.len   = 3;
    msg.buf   = buf;

    ret = i2c_transfer(client->adapter, &msg, 1);
    if (ret < 0) {
        dev_err(&client->dev, "write reg 0x%04x failed: %d\n", reg_addr, ret);
        return ret;
    }
    return 0;
}

/* 读Sensor寄存器 */
int sensor_read_reg(struct i2c_client *client, u16 reg_addr, u8 *val)
{
    int ret;
    u8 addr_buf[2];
    struct i2c_msg msgs[2];

    addr_buf[0] = (reg_addr >> 8) & 0xFF;
    addr_buf[1] = reg_addr & 0xFF;

    /* 伪写：发送寄存器地址 */
    msgs[0].addr  = client->addr;
    msgs[0].flags = 0;
    msgs[0].len   = 2;
    msgs[0].buf   = addr_buf;

    /* 读：接收数据 */
    msgs[1].addr  = client->addr;
    msgs[1].flags = I2C_M_RD;
    msgs[1].len   = 1;
    msgs[1].buf   = val;

    ret = i2c_transfer(client->adapter, msgs, 2);
    if (ret < 0) {
        dev_err(&client->dev, "read reg 0x%04x failed: %d\n", reg_addr, ret);
        return ret;
    }
    return 0;
}
EXPORT_SYMBOL(sensor_write_reg);
EXPORT_SYMBOL(sensor_read_reg);
避坑指南： 部分Sensor（如OV5640）的寄存器地址为16位，但某些型号（如IMX290）使用8位地址。务必在驱动初始化时通过设备树或平台数据明确配置地址长度，否则会导致寄存器读写错位。

4.3 V4L2 Subdev驱动框架

Linux内核中，V4L2（Video for Linux 2）子设备（subdev）框架是管理图像Sensor的标准方式。Sensor驱动需要注册为一个V4L2 subdev，并实现必要的回调函数，以便与ISP、视频采集设备协同工作。

4.3.1 Subdev核心数据结构

数据结构 作用 关键字段/函数
struct v4l2_subdev 表示一个V4L2子设备实例 name, entity, ctrl_handler
struct v4l2_subdev_ops 子设备操作函数集 core, video, pad, sensor
struct v4l2_subdev_video_ops 视频流控制回调 s_stream, g_frame_interval, s_frame_interval
struct v4l2_subdev_pad_ops Pad（端口）操作 enum_mbus_code, set_fmt, get_fmt
struct v4l2_mbus_framefmt 媒体总线帧格式描述 width, height, code, field

4.3.2 Sensor驱动注册流程

一个完整的Sensor subdev驱动注册流程如下：

  1. I2C探测： 在 i2c_driver.probe 中分配 v4l2_subdev 结构体。
  2. 初始化控制句柄： 注册V4L2控制（曝光、增益、白平衡等）。
  3. 设置Subdev操作函数： 绑定 v4l2_subdev_ops，实现 s_stream、set_fmt 等回调。
  4. 注册Subdev： 调用 v4l2_i2c_subdev_init 或 v4l2_async_register_subdev。
  5. 媒体实体初始化： 设置 media_entity 的 pads 数量和类型。
V4L2 Subdev Sensor驱动框架 V4L2 Subdev Sensor驱动框架 用户空间 (Userspace) 内核空间 (Kernel Space) V4L2 Core / Video Device /dev/videoX Media Controller 媒体拓扑管理 V4L2 Subdev 子设备层 v4l2_subdev_ops | v4l2_subdev_video_ops | v4l2_subdev_pad_ops Sensor Driver s_stream / set_fmt I2C Core / Adapter i2c_transfer 硬件层：Sensor + I2C Bus

4.4 实战：在海思3519上注册Sensor Subdev

以下代码展示了如何在海思3519平台上，通过I2C探测并注册一个V4L2 subdev Sensor驱动：

/* imx327_drv.c - IMX327 Sensor驱动示例 */
#include <linux/module.h>
#include <linux/i2c.h>
#include <media/v4l2-subdev.h>
#include <media/v4l2-ctrls.h>

static int imx327_s_stream(struct v4l2_subdev *sd, int enable)
{
    if (enable) {
        /* 配置Sensor输出格式、时钟、MIPI等 */
        sensor_write_reg(client, 0x3000, 0x00); /* 软复位 */
        msleep(10);
        /* 加载初始化序列 */
        imx327_load_init_seq(client);
        dev_info(&client->dev, "Sensor stream ON\n");
    } else {
        /* 进入待机模式 */
        sensor_write_reg(client, 0x3001, 0x01);
        dev_info(&client->dev, "Sensor stream OFF\n");
    }
    return 0;
}

static const struct v4l2_subdev_video_ops imx327_video_ops = {
    .s_stream = imx327_s_stream,
};

static const struct v4l2_subdev_ops imx327_subdev_ops = {
    .video = &imx327_video_ops,
};

static int imx327_probe(struct i2c_client *client,
                        const struct i2c_device_id *id)
{
    struct v4l2_subdev *sd;

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

    v4l2_i2c_subdev_init(sd, client, &imx327_subdev_ops);
    /* 注册V4L2控制（曝光、增益等） */
    /* ... */

    dev_info(&client->dev, "IMX327 sensor probed\n");
    return 0;
}

static const struct i2c_device_id imx327_id[] = {
    { "imx327", 0 },
    { }
};
MODULE_DEVICE_TABLE(i2c, imx327_id);

static struct i2c_driver imx327_i2c_driver = {
    .driver = {
        .name = "imx327",
    },
    .probe    = imx327_probe,
    .id_table = imx327_id,
};

module_i2c_driver(imx327_i2c_driver);

MODULE_AUTHOR("ISP Debug Team");
MODULE_DESCRIPTION("IMX327 Sensor Driver for Hi3519");
MODULE_LICENSE("GPL");
调试技巧： 使用 i2cget 和 i2cset 工具可以在用户空间直接验证Sensor寄存器读写是否正确。例如：i2cget -y 0 0x30 0x3000 w 读取IMX327的芯片ID寄存器。

4.5 设备树配置与I2C适配

在海思3519平台上，Sensor的设备树节点需要指定I2C总线编号、地址、时钟频率等信息：

/* hi3519-sensor.dtsi */
&i2c0 {
    status = "okay";
    clock-frequency = <400000>;  /* 400kHz快速模式 */

    imx327: camera@30 {
        compatible = "sony,imx327";
        reg = <0x30>;           /* 7位I2C地址 */
        clocks = <&clk_mclk>;
        clock-names = "mclk";
        reset-gpios = <&gpio0 5 GPIO_ACTIVE_LOW>;
        powerdown-gpios = <&gpio0 6 GPIO_ACTIVE_HIGH>;

        port {
            imx327_ep: endpoint {
                remote-endpoint = <&csi_ep>;
                data-lanes = <1 2 3 4>;  /* 4-lane MIPI */
                clock-noncontinuous;
            };
        };
    };
};
关键检查点：
  • I2C地址必须与Sensor数据手册一致（注意7位/8位地址转换）。
  • MCLK时钟频率通常为24MHz或27MHz，需与Sensor PLL配置匹配。
  • 复位/电源管理GPIO极性需根据硬件原理图确认。

4.6 常见问题与调试方法

问题现象 可能原因 排查方法
I2C通信超时 地址错误、总线冲突、上拉电阻不足 示波器抓取SCL/SDA波形；i2cdetect 扫描地址
寄存器读写返回错误 地址长度配置错误、Sensor未上电 检查设备树reg属性；测量Sensor供电电压
Subdev注册失败 V4L2框架未初始化、media entity冲突 查看 dmesg 错误日志；检查 /sys/class/video4linux
Sensor无输出图像 MIPI时钟未锁定、初始化序列错误 检查MCLK频率；逐条验证初始化寄存器
重要提醒： 在调试初期，建议先使用 i2cget 读取Sensor的芯片ID寄存器（如IMX327的0x3000），确认I2C通信正常后再加载驱动。切勿直接加载未经验证的初始化序列，以免锁死Sensor。

通过本章的学习，你已经掌握了I2C通信协议在Sensor控制中的应用、寄存器读写函数的实现方法，以及V4L2 subdev驱动框架的注册流程。这些基础是后续进行ISP调试、图像质量优化的前提。

← 上一章 📖 返回目录 下一章 →