保姆级教程：在Firefly RK3399开发板上点亮OV13850 MIPI摄像头（Android 11）

从零实战：Firefly RK3399开发板OV13850 MIPI摄像头全流程适配指南（Android 11）

在嵌入式开发领域，摄像头模块的适配一直是硬件集成的重要环节。本文将手把手带你完成Firefly RK3399开发板与OV13850 MIPI摄像头的完整适配流程，涵盖从硬件引脚分析到Android HAL层配置的全套实战操作。无论你是刚接触Rockchip平台的开发者，还是需要快速验证摄像头功能的工程师，这份指南都能帮你避开常见陷阱，高效完成任务。

1. 硬件准备与原理图解析

1.1 硬件连接检查清单

在开始软件配置前，确保以下硬件连接正确：

• MIPI接口：使用TX1/RX1通道（对应开发板MIPI CSI接口）
• I2C总线：连接至I2C4（地址0x10）
• 控制引脚：
  • 复位引脚RST：GPIO2_D2
  • 电源使能PWDN：GPIO1_C7
  • 主时钟MCLK：GPIO3_B7
• 电源供应：确认摄像头模组3.3V供电正常

提示：使用万用表测量各电源引脚电压，避免因供电不足导致初始化失败。

1.2 关键信号测量

通过示波器验证以下信号波形：

# 查看MCLK时钟信号（应显示24MHz方波） $ cat /sys/kernel/debug/clk/clk_summary | grep cif_out

2. 设备树配置深度解析

2.1 摄像头节点配置

在rk3399-sapphire.dtsi中添加OV13850节点：

ov13850: ov13850@10 { compatible = "ovti,ov13850"; reg = <0x10>; 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"; port { ucam_out0: endpoint { remote-endpoint = <&mipi_in_ucam0>; >&mipi_dphy_tx1rx1 { status = "okay"; ports { port@1 { dphy_tx1rx1_out: endpoint@0 { remote-endpoint = <&isp1_mipi_in>; }; }; }; };

2.3 ISP相关配置

确保ISP和V4L2子系统正常工作：

&isp1_mmu { status = "okay"; }; &rkisp1_1 { status = "okay"; port { isp1_mipi_in: endpoint@0 { remote-endpoint = <&dphy_tx1rx1_out>; }; }; };

3. 内核驱动调试技巧

3.1 关键日志过滤方法

使用dmesg观察驱动加载情况：

# 过滤摄像头相关日志 $ dmesg | grep -E "ov13850|mipi|v4l2"

预期成功日志示例：

[ 5.231445] ov13850 4-0010: Detected OV13850 sensor [ 5.236778] rkisp1: Registered sensor subdev ov13850 on i2c4

3.2 设备节点验证

检查生成的设备节点：

$ ls -l /dev/video* $ ls -l /dev/media*

正常情况应看到类似输出：

crw-rw---- 1 root video 81, 0 Jan 1 00:00 /dev/video0 crw-rw---- 1 root video 81, 1 Jan 1 00:00 /dev/video1

4. Android HAL层适配

4.1 Camera Profiles配置

修改camera3_profiles_rk3399.xml关键参数：

<Profiles cameraId="0" name="ov13850" moduleId="m01"> <sensor.orientation value="0"/> <lens.facing value="FRONT"/> <scalar.availableStreamConfigurations> <!-- 添加支持的分辨率配置 --> <item>640x480/RAW_OPAQUE</item> <item>1280x720/YUV_420_888</item> </scalar.availableStreamConfigurations> </Profiles>

4.2 权限配置

在privapp-permissions-platform.xml中添加相机权限：

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

4.3 IQ文件部署

确保图像质量配置文件正确拷贝：

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

5. 功能验证与问题排查

5.1 基础功能测试

通过v4l2-utils进行快速验证：

# 查看支持格式 $ v4l2-ctl -d /dev/video0 --list-formats # 捕获测试图像 $ v4l2-ctl -d /dev/video0 --set-fmt-video=width=1280,height=720,pixelformat=NV12 \ --stream-mmap=3 --stream-to=/sdcard/test.yuv --stream-count=1

5.2 常见问题解决方案

5.3 高级调试技巧

使用media-ctl分析管道拓扑：

$ media-ctl -p -d /dev/media0

典型输出示例：

- entity 1: ov13850 4-0010 (1 pad, 1 link) type V4L2 subdev subtype Sensor device node name /dev/v4l-subdev0 pad0: Source [fmt:SBGGR10_1X10/2104x1560] -> "rockchip-mipi-dphy-rx":0 [ENABLED]

完成所有配置后，建议进行72小时稳定性测试，重点关注长时间运行时的图像传输稳定性。在实际项目中，我们发现适当降低MIPI时钟频率（通过修改dphy时序参数）可以有效提升高低温环境下的可靠性。