Firefly-RK3288MIPI CSI接口介绍

MIPI CSI 使用

板载资源

Firefly-RK3288 开发板带有一个 MIPI 摄像头接口，图像处理能力达到 4416x3312 像素，支持 4K 视频录制。此外，开发板还支持 USB 摄像头。 本文以 OV13850 摄像头为例，讲解在该开发板上的配置过程。

相关代码目录

与摄像头相关的代码目录如下：

Android： `- hardware/rockchip/camera |- Config | `- cam_board.xml // 摄像头的参数设置 |- CameraHal // 摄像头的 HAL 源码 `- SiliconImage // ISP 库，包括所有支持模组的驱动源码 `- isi/drv/OV13850 // OV13850 模组的驱动源码 `- calib/OV13850.xml // OV13850 模组的调校参数 Kernel： |- kernel/drivers/media/video/rk_camsys // CamSys 驱动源码 `- kernel/include/media/camsys_head.h

配置原理

设置摄像头相关的引脚和时钟，即可完成配置过程。 从以下摄像头接口原理图可知，需要配置的引脚有：AF_VDD28、DOVDD18、AVDD28、DVDD12、PWDN1、RST 和 MCLK。

• AF_VDD28 可不做配置
• DOVDD18、AVDD28 DOVDD18、AVDD28 由 DVP_PWR 控制：

DVP_PWR 对应 RK3288 的 GPIO0_B3：

• DVDD12 DVDD12 由 CIF_POWER 引脚控制：

CIF_POWER 对应 RK3288 上的 GPIO7_B4 引脚：

• PWDN1、RST PWDN1、RST 对应 GPIO2_B6、GPIO2_B7 引脚：

在开发板中，除了 DVDD12 (CIF_POWER) 要在 DTS 和驱动中设置，其它引脚都是在 cam_board.xml 中设置

配置步骤

配置 Android

修改 hardware/rockchip/camera/Config/cam_board.xml 来注册摄像头：

主要修改的内容如下：

• Sensor 名称

<SensorName name="OV13850" >SensorName>

该名字必须与 Sensor 驱动的名字一致,目前提供的 Sensor 驱动格式如下： libisp_isi_drv_OV13850.so 用户可在编译 Android 完成后在目录 out/target/product/rk3288/system/lib/hw/ 下找到该摄像头驱动文件

• Sensor 软件标识

<SensorDevID IDname="CAMSYS_DEVID_SENSOR_1A">SensorDevID>

• 注册标识不一致即可,可填写以下值：
  • CAMSYS_DEVID_SENSOR_1A
  • CAMSYS_DEVID_SENSOR_1B
  • CAMSYS_DEVID_SENSOR_2

• 采集控制器名称

<SensorHostDevID busnum="CAMSYS_DEVID_MARVIN" >SensorHostDevID>

目前只支持： CAMSYS_DEVID_MARVIN

• Sensor 所连接的主控 I2C 通道号

<SensorI2cBusNum busnum="3">SensorI2cBusNum>

具体通道号请参考摄像头原理图连接主控的 I2C 通道号。

• Sensor 寄存器地址长度,单位：字节

<SensorI2cAddrByte byte="2">SensorI2cAddrByte>

• Sensor 的 I2C 频率,单位：Hz，用于设置 I2C 的频率。

<SensorI2cRate rate="100000">SensorI2cRate>

• Sensor 输入时钟频率, 单位：Hz，用于设置摄像头的时钟。

<SensorMclk mclk="24000000">SensorMclk>

• Sensor AVDD 的 PMU LDO 名称。如果不是连接到 PMU，那么只需填写 NC。

<SensorAvdd name="NC" min="0" max="0">SensorAvdd>

• Sensor DOVDD 的 PMU LDO 名称。

<SensorDovdd name="NC" min="18000000" max="18000000">SensorDovdd>

如果不是连接到 PMU，那么只需填写 NC。注意 min 以及 max 值必须填写，这决定了 Sensor 的 IO 电压。

• Sensor DVDD 的 PMU LDO 名称

<SensorDvdd name="NC" min="0" max="0">SensorDvdd>

如果不是连接到 PMU，那么只需填写 NC。

• Sensor PowerDown 引脚。

<SensorGpioPwdn ioname="RK30_PIN2_PB6" active="0">SensorGpioPwdn>

直接填写名称即可，active 填写休眠的有效电平。

• Sensor Reset 引脚。

<SensorGpioRst ioname="RK30_PIN2_PB7" active="0">SensorGpioRst>

直接填写名称即可，active 填写复位的有效电平。

• Sensor Power 引脚。

<SensorGpioPwen ioname="RK30_PIN0_PB3" active="1">SensorGpioPwen>

直接填写名称即可, active 填写电源有效电平。

• 选择 Sensor 作为前置还是后置。

<SensorFacing facing="front">SensorFacing>

可填写 “front” 或 “back”。

• Sensor 的接口方式

<SensorInterface mode="MIPI">SensorInterface>

可填写如下值：

CCIR601 CCIR656 MIPI SMIA

• Sensor 的镜像方式

<SensorMirrorFlip mirror="0">SensorMirrorFlip>

目前暂不支持。

• Sensor 的角度信息

<SensorOrientation orientation="0">SensorOrientation>

• 物理接口设置

<SensorPhy phyMode="CamSys_Phy_Mipi" lane="2" phyIndex="1" sensorFmt="CamSys_Fmt_Raw_10b">SensorPhy>

hyMode：Sensor 接口硬件连接方式，对 MIPI Sensor 来说，该值取 "CamSys_Phy_Mipi" Lane：Sensor mipi 接口数据通道数 Phyindex：Sensor mipi 连接的主控 mipi phy 编号 sensorFmt：Sensor 输出数据格式,目前仅支持 CamSys_Fmt_Raw_10b

配置内核

在配置原理中提到，GPIO7_B4 需要在 DTS 和驱动中配置。其配置方法如下： 1.DTS 文件添加 GPIO7_B4 配置属性 在 kernel/arch/arm/boot/dts/rk3288.dtsi 文件中添加 gpios-cifpower 属性，如下所示： *

isp： isp@ff910000{ compatible = "firefly,isp"; ... gpios-cifpower = ; ... status = "okay"; };

2.驱动中配置 CIF_POWER 在 kernel/drivers/media/video/rk_camsys/camsys_drv.c 中读取 gpios-cifpower ，并设置该引脚，使能 CIF_POWER，在probe函数camsys_platform_probe()中添加如下所示：

enum of_gpio_flags flags; int cifpower_io; int io_ret; cifpower_io = of_get_named_gpio_flags(dev->of_node, "gpios-cifpower", 0, &flags); camsys_trace(1, "1-gpios-cifpower： gpio=%d", cifpower_io); if(gpio_is_valid(cifpower_io)){ cifpower_io = of_get_named_gpio_flags(dev->of_node, "gpios-cifpower", 0, &flags); camsys_trace(1, "gpios-cifpower： gpio_request"); io_ret = gpio_request(cifpower_io,"cifpower"); camsys_trace(1, "1-gpios-cifpower： gpio_request=%d", io_ret); if(io_ret < 0){ camsys_err("Request %s(%d) failed","cifpower", cifpower_io); }else{ gpio_direction_output(cifpower_io, 1); gpio_set_value(cifpower_io, 1); camsys_trace(1, "gpios-cifpower： %d high", cifpower_io); } }

3.编译内核 需将 drivers\media\video\rk_camsys 驱动源码编进内核，其配置方法如下： 在内核源码目录下执行命令：

make menuconfig 然后将以下配置项打开： Device Drivers ---> Multimedia support ---> camsys driver RockChip camera system driver ---> camsys driver for marvin isp camsys driver for cif 最后执行： make firefly-rk3288.img

即可完成内核的编译。