RK3399 Android11平台OV13850 MIPI摄像头驱动移植与图像调试实战

1. 硬件原理图分析与关键信号确认

拿到OV13850摄像头模组和RK3399开发板后，第一步要做的就是对照原理图确认硬件连接。我习惯用红色马克笔在打印出来的原理图上标注关键信号，这样能避免遗漏。OV13850作为13MP的MIPI摄像头，需要重点关注以下六类信号：

• MIPI数据通道：原理图显示使用了MIPI_TX1/RX1，这是RK3399的MIPI CSI-2接口。注意检查lane数配置，OV13850支持4 lane模式，原理图上应该看到D0-D3四组差分对
• 时钟信号：包括24MHz的MCLK输入和MIPI时钟线。实测中发现如果MCLK走线过长会导致图像抖动，建议控制在50mm以内
• 控制引脚：GPIO2_D2作为复位引脚(RST)，GPIO1_C7作为电源使能(PWDN)。这两个GPIO的极性要特别注意，有些模组是低电平复位
• I2C总线：连接到I2C4，地址0x10。用示波器测波形时，我看到有些板子需要加上拉电阻（通常4.7K）
• 电源轨：核心电压1.2V、IO电压1.8V、模拟电压2.8V。有个坑是AVDD和DVDD的上电时序，OV13850要求AVDD先于DVDD上电
• 物理连接：检查FPC座子是否与模组匹配。曾经遇到因为座子引脚定义反接导致烧毁模组的情况

提示：建议用万用表二极管档位检查所有电源引脚对地阻抗，避免短路情况。正常情况DVDD对地阻值约300Ω，AVDD约1KΩ。

2. 设备树配置实战详解

设备树配置是驱动移植的核心环节，我结合官方文档和实际调试经验，总结出以下关键配置步骤：

2.1 MIPI DPHY节点配置

在rk3399-android.dtsi中找到mipi_dphy_tx1rx1节点，需要修改三处关键参数：

dts复制&mipi_dphy_tx1rx1 {
    status = "okay";
    clocks = <&cru SCLK_MIPIDPHY_REF>, <&cru PCLK_MIPI_DSI1>;
    clock-names = "ref", "pclk";
    
    ports {
        port@1 {
            dphy_tx1rx1_out: endpoint@0 {
                data-lanes = <1 2 3 4>; // 启用4 lane模式
                remote-endpoint = <&isp1_mipi_in>; 
            };
        };
    };
};

2.2 ISP和V4L2子系统配置

RK3399的ISP（图像信号处理器）需要与V4L2框架配合工作，主要配置两个节点：

dts复制&isp1 {
    status = "okay";
    port {
        isp1_mipi_in: endpoint@0 {
            remote-endpoint = <&dphy_tx1rx1_out>;
        };
    };
};

&isp1_mmu {
    status = "okay"; // 必须开启IOMMU
};

2.3 OV13850传感器节点

这是最复杂的部分，需要精确匹配硬件参数。特别注意pinctrl配置要与原理图一致：

dts复制&i2c4 {
    ov13850: ov13850@10 {
        compatible = "ovti,ov13850";
        reg = <0x10>; // I2C地址
        clocks = <&cru SCLK_CIF_OUT>;
        clock-names = "xvclk";
        
        reset-gpios = <&gpio2 RK_PD2 GPIO_ACTIVE_HIGH>;
        pwdn-gpios = <&gpio1 RK_PC7 GPIO_ACTIVE_HIGH>;
        
        rockchip,camera-module-index = <1>;
        rockchip,camera-module-facing = "front";
        rockchip,camera-module-name = "CMK-CT0116";
        rockchip,camera-module-lens-name = "Largan-50013A1";
        
        port {
            ucam_out0: endpoint {
                remote-endpoint = <&mipi_in_ucam0>;
                data-lanes = <1 2 3 4>;
            };
        };
    };
};

3. 内核驱动与系统层调试

驱动加载成功后，真正的挑战才开始。以下是验证摄像头工作的完整流程：

3.1 内核日志分析

使用dmesg查看驱动加载情况，重点关注以下日志：

bash复制$ adb shell dmesg | grep -E "ov13850|mipi|v4l2"
[    5.671234] ov13850 4-0010: Detected OV13850 sensor
[    5.712345] mipi_dphy_rx1: lanes 4, freq 1008 Mbps
[    5.745678] rkisp1: Registered all subdevs

如果看到"probe succeeded"但没视频节点，可能是media controller链接问题。我遇到过因为dphy和isp的remote-endpoint不匹配导致的问题。

3.2 设备节点验证

成功加载后应该出现以下设备节点：

code复制/dev/video13   # ISP输出节点
/dev/v4l-subdev0  # 传感器子设备
/dev/media1    # media controller接口

用v4l2-ctl检查格式支持：

bash复制$ adb shell v4l2-ctl -d /dev/video13 --list-formats
ioctl: VIDIOC_ENUM_FMT
    Type: Video Capture
    [0]: 'NV12' (Y/CbCr 4:2:0)
    [1]: 'YUYV' (YUYV 4:2:2)

3.3 图像抓取测试

使用v4l2-ctl抓取测试图像：

bash复制$ adb shell v4l2-ctl -d /dev/video13 \
    --set-fmt-video=width=1280,height=720,pixelformat=NV12 \
    --stream-mmap=3 \
    --stream-to=/sdcard/test.yuv \
    --stream-count=10

抓取的YUV文件可以用YUView工具查看。如果图像颜色异常，可能是格式配置错误，OV13850默认输出的是BGGR格式的RAW数据。

4. 常见问题排查与解决

在实际项目中，我遇到过各种奇葩问题，这里分享几个典型案例：

4.1 图像方向错乱

现象：预览图像旋转了90度。检查发现是camera3_profiles_rk3399.xml中配置了错误的sensor方向：

xml复制<!-- 错误配置 -->
<sensor.orientation value="90"/>

<!-- 正确配置 -->
<sensor.orientation value="0"/>

4.2 IQ文件缺失

报错日志显示"cannot find IQ file"，这是因为没有正确拷贝ISP调优文件。解决方法是在camera_etc.mk中添加：

makefile复制PRODUCT_COPY_FILES += \
    $(call find-copy-subdir-files,*,$(CUR_PATH)/camera/rkisp1/,$(TARGET_COPY_OUT_VENDOR)/etc/camera/rkisp1/)

4.3 图像闪烁或条纹

这种情况通常是MIPI信号完整性问题，可以通过以下步骤排查：

1. 用示波器检查MIPI时钟频率是否稳定（OV13850在1280x720@30fps时约672Mbps）
2. 调整dphy的hs_settle参数，我测试发现ov13850适合设为0x20
3. 检查模组供电是否稳定，特别是AVDD要用示波器看纹波（应小于50mV）

4.4 权限问题

Android 11加强了摄像头权限管理，需要在privapp-permissions-platform.xml中添加：

xml复制<privapp-permissions package="com.android.camera2">
    <permission name="android.permission.SYSTEM_CAMERA"/>
</privapp-permissions>

5. 图像质量调优技巧

完成基本功能后，还需要对图像质量进行优化。OV13850的IQ调优主要涉及以下文件：

1. ov13850_CMK-CT0116_Largan-50013A1.xml - 包含AWB、CCM等基础参数
2. rkisp1_OV13850.xml - 3A算法参数（AF/AE/AWB）
3. rkispp_params.xml - ISP后处理参数

我常用的调优方法：

• 在暗环境下用灰度卡调整黑电平（black level）
• 用24色卡校准AWB，重点调整R/G/B增益比
• 通过MTF测试卡优化锐化参数，避免过度锐化产生halo效应
• 调试降噪参数时，建议在低照度（10lux以下）场景观察细节保留与噪点平衡

调试过程中可以用这个命令实时查看ISP统计信息：

bash复制$ adb shell cat /proc/rkisp1-vir0