保姆级教程：在Linux V4L2框架下移植调试LT6911C HDMI转MIPI驱动

1. 环境准备与基础概念

在开始LT6911C驱动移植前，需要明确几个关键概念。V4L2（Video4Linux2）是Linux内核中处理视频设备的通用框架，而MIPI CSI-2则是移动设备中广泛使用的摄像头接口标准。LT6911C作为HDMI到MIPI CSI-2的桥接芯片，其驱动开发需要同时理解这两种技术规范。

必备工具清单：

• 目标平台（如RK3588）的Linux内核源码树
• LT6911C数据手册和调试指南（通常由厂商提供）
• I2C工具（i2c-tools包）
• 逻辑分析仪或示波器（用于信号调试）
• 串口调试终端

芯片的寄存器访问采用bank机制，0xFF寄存器用于bank选择。例如访问0xA123寄存器时：

1. 先向0xFF写入0xA1选择bank
2. 再访问0x23偏移地址

注意：不同bank的寄存器功能各异，视频时序相关寄存器通常分布在特定bank中。

2. 驱动框架搭建

2.1 V4L2子设备注册

首先创建驱动的基本骨架，注册为V4L2子设备：

c复制static const struct v4l2_subdev_ops lt6911c_subdev_ops = {
    .core = &lt6911c_core_ops,
    .video = &lt6911c_video_ops,
};

static int lt6911c_probe(struct i2c_client *client)
{
    struct v4l2_subdev *sd;
    sd = devm_kzalloc(&client->dev, sizeof(*sd), GFP_KERNEL);
    v4l2_i2c_subdev_init(sd, client, &lt6911c_subdev_ops);
    return 0;
}

2.2 I2C通信封装

LT6911C的所有功能都通过I2C接口控制，需要实现安全的读写函数：

c复制static int lt6911c_i2c_read(struct v4l2_subdev *sd, u16 reg, u8 *val)
{
    struct i2c_client *client = v4l2_get_subdevdata(sd);
    u8 bank = reg >> 8;
    u8 offset = reg & 0xFF;
    
    // 先设置bank
    i2c_smbus_write_byte_data(client, 0xFF, bank);
    // 读取目标寄存器
    *val = i2c_smbus_read_byte_data(client, offset);
    return 0;
}

典型问题排查：

• 若I2C通信失败，首先用i2cdetect工具确认设备地址
• 检查硬件上拉电阻是否合适（通常需要4.7kΩ）
• 确认时钟速率是否在芯片支持范围内（LT6911C最高支持400kHz）

3. 关键功能实现

3.1 视频时序检测

v4l2_dv_timings结构体需要填充以下关键参数：

实现代码示例：

c复制static int lt6911c_get_timings(struct v4l2_subdev *sd,
                              struct v4l2_dv_timings *timings)
{
    u8 clk_h, clk_m, clk_l;
    lt6911c_i2c_read(sd, 0xB8B1, &clk_h);
    lt6911c_i2c_read(sd, 0xB8B2, &clk_m);
    lt6911c_i2c_read(sd, 0xB8B3, &clk_l);
    
    timings->bt.pixelclock = (((clk_h & 0xF) << 16) | 
                             (clk_m << 8) | clk_l) * 1000;
    // HDMI 2.0特殊处理
    if (hdmi_version == HDMI_2_0)
        timings->bt.pixelclock *= 2;
}

3.2 中断处理机制

LT6911C通过中断通知分辨率变化等事件，典型配置流程：

1. 使能中断引脚GPIO
2. 配置中断触发类型（通常为边沿触发）
3. 实现中断服务例程(ISR)：

c复制static irqreturn_t lt6911c_irq_handler(int irq, void *dev_id)
{
    struct lt6911c_state *state = dev_id;
    u8 int_status;
    
    lt6911c_i2c_read(state->sd, 0xA000, &int_status);
    if (int_status & RES_CHANGE_INT) {
        v4l2_subdev_notify(state->sd, RESOLUTION_CHANGE, NULL);
    }
    return IRQ_HANDLED;
}

4. 设备树配置与调试技巧

4.1 DTS节点规范

dts复制lt6911c: lt6911c@2b {
    compatible = "lontium,lt6911c";
    reg = <0x2b>;  /* 注意：实际I2C地址0x56右移1位 */
    pinctrl-names = "default";
    pinctrl-0 = <&lt6911c_pins>;
    interrupt-parent = <&gpio3>;
    interrupts = <RK_PA4 IRQ_TYPE_EDGE_RISING>;
    reset-gpios = <&gpio3 RK_PB1 GPIO_ACTIVE_LOW>;
    power-gpios = <&gpio3 RK_PB0 GPIO_ACTIVE_HIGH>;
};

常见配置错误：

• 寄存器地址未右移（示波器看到的0x56对应DTS中的0x2b）
• 中断极性配置错误（用示波器确认实际信号）
• 电源时序不符合要求（见芯片手册的Power On Sequence章节）

4.2 调试方法进阶

分辨率不匹配问题排查步骤：

1. 检查原始HDMI信号参数（可用EDID读取工具）
2. 对比驱动获取的v4l2_dv_timings值
3. 确认MIPI CSI-2接收端配置（如data lane数量、速率）
4. 检查HSYNC/VSYNC极性设置

性能优化技巧：

• 对频繁访问的寄存器实现缓存机制
• 使用延迟工作队列处理非实时任务
• 实现动态时钟调整策略节省功耗

5. 平台适配与兼容性处理

不同Linux平台（如Rockchip、NXP i.MX等）可能需要特殊处理：

Rockchip平台注意事项：

c复制static const struct rkmodule_csi_dphy_param rk3588_dphy_cfg = {
    .lp_clk_settle_cnt = 0x14,
    .lp_hs_settle_cnt = 0x14,
};

static int lt6911c_get_module_info(struct v4l2_subdev *sd, 
                                  struct rkmodule_inf *inf)
{
    strscpy(inf->base.sensor, "LT6911C", sizeof(inf->base.sensor));
    inf->base.module = "Lontium";
    inf->csi2.dphy = rk3588_dphy_cfg;
    return 0;
}

跨平台兼容方案：

1. 使用Kconfig定义平台相关宏
2. 通过设备树匹配不同配置
3. 实现平台操作回调结构体

在完成基本功能后，建议增加以下高级特性：

• 热插拔检测(HPD)处理
• HDCP状态监控
• 低功耗模式支持
• EDID读写功能