MIPI CSI 使用
板载资源
Firefly-RK3288 开发板有 MIPI 摄像头接口,摄像头图像处理能力达到
4416x3312 像素,支持 4K 视频录制。此外,开发板还支持 USB 摄像头。
本文以 OV13850 摄像头为例,讲解 MIPI 摄像头在该开发板上的配置过程。
相关代码目录
与摄像头相关的代码目录如下:
   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 名称
   
该名字必须与 Sensor 驱动的名字一致,目前提供的 Sensor 驱动格式如下:
   libisp_isi_drv_OV13850.so
用户可在编译 Android 完成后在目录
"out/target/product/rk3288_aio_3288j_box/system/lib/hw/" 下找到该摄像
头驱动文件。
Sensor 软件标识
   
注册标识不一致即可,可填写以下值:
   CAMSYS_DEVID_SENSOR_1A
   CAMSYS_DEVID_SENSOR_1B
   CAMSYS_DEVID_SENSOR_2
采集控制器名称
   
目前只支持:
   CAMSYS_DEVID_MARVIN
Sensor 所连接的主控 I2C 通道号
     
具体通道号请参考摄像头原理图连接主控的 I2C 通道号。
Sensor 寄存器地址长度,单位:字节
   
Sensor 的 I2C 频率,单位:Hz,用于设置 I2C 的频率。
   
Sensor 输入时钟频率, 单位:Hz,用于设置摄像头的时钟。
   
Sensor AVDD 的 PMU LDO 名称。如果不是连接到 PMU,那么只需填写 NC。
   
Sensor DOVDD 的 PMU LDO 名称。
   
如果不是连接到 PMU,那么只需填写 NC。注意 min 以及 max 值必须填写,这
决定了 Sensor 的 IO 电压。
Sensor DVDD 的 PMU LDO 名称。
   
如果不是连接到 PMU,那么只需填写 NC。
Sensor PowerDown 引脚。
   
直接填写名称即可,active 填写休眠的有效电平。
Sensor Reset 引脚。
   
直接填写名称即可,active 填写复位的有效电平。
Sensor Power 引脚。
   
直接填写名称即可, active 填写电源有效电平。
选择 Sensor 作为前置还是后置。
   
可填写 "front" 或 "back"。
Sensor 的接口方式
   
可填写如下值:
   CCIR601
   CCIR656
   MIPI
   SMIA
Sensor 的镜像方式
   
目前暂不支持。
Sensor 的角度信息
   
物理接口设置  MIPI
   
phyMode: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
即可完成内核的编译。