Skip to main content

Camera Use

Introduction​

Firefly-RK3128 development board has CIF interface, which supports front/back cameras.The following CIF cameras are supported in the driver directory kernel/drivers/media/video:

  • gc0307
  • gc0308
  • gc0309
  • gc0328
  • gc0329
  • gc2015
  • gc2035
  • gt2005
  • hm2057
  • hm5065
  • mt9p111
  • nt99160
  • nt99240
  • ov2659
  • ov5640
  • sp0838
  • sp2518

This chapter mainly describes how to configure CIF.

Configuration Steps​

Add Sensor Connection​

Camera list is defined in file kernel/arch/arm/boot/dts/rk3128-cif-sensor.dtsi:

rk3128_cif_sensor: rk3128_cif_sensor{
        compatible = "rockchip,sensor";
        status = "disabled";
        CONFIG_SENSOR_POWER_IOCTL_USR 		= <1>;
        CONFIG_SENSOR_RESET_IOCTL_USR 		= <0>;
        CONFIG_SENSOR_POWERDOWN_IOCTL_USR	= <0>;
        CONFIG_SENSOR_FLASH_IOCTL_USR	  	= <0>;
        CONFIG_SENSOR_AF_IOCTL_USR	   		= <0>;
        // ... skip some modules
        gc0329&#123;
            is_front = <1>;
            rockchip,powerdown = <&gpio3 GPIO_D7 GPIO_ACTIVE_HIGH>;
            pwdn_active = <gc0329_PWRDN_ACTIVE>;
            #rockchip,power = <>;
            pwr_active = <PWR_ACTIVE_HIGH>;
            #rockchip,reset = <>;
            #rst_active = <>;
            #rockchip,flash = <>;
            #rockchip,af = <>;
            mir = <0>;
            flash_attach = <0>;
            resolution = <gc0329_FULL_RESOLUTION>;
            powerup_sequence = <gc0329_PWRSEQ>;
            orientation = <0>;
            i2c_add = <gc0329_I2C_ADDR>;
            i2c_rata = <100000>;
            i2c_chl = <0>;
            cif_chl = <0>;
            mclk_rate = <24>;
		&#125;;
        gc0329_b &#123;
            is_front = <0>;
            rockchip,powerdown = <&gpio3 GPIO_B3 GPIO_ACTIVE_HIGH>;
            pwdn_active = <gc0329_PWRDN_ACTIVE>;
            #rockchip,power = <>;
            pwr_active = <PWR_ACTIVE_HIGH>;
            #rockchip,reset = <>;
            #rst_active = <>;
            #rockchip,flash = <>;
            #rockchip,af = <>;
            mir = <0>;
            flash_attach = <0>;
            resolution = <gc0329_FULL_RESOLUTION>;
            powerup_sequence = <gc0329_PWRSEQ>;
            orientation = <0>;
            i2c_add = <gc0329_I2C_ADDR>;
            i2c_rata = <100000>;
            i2c_chl = <0>; // <0>;
            cif_chl = <0>;
            mclk_rate = <24>;
        &#125;;
&#125;;

Here, we list the configuration of gc0329 back/front cameras with description:

  • is_front: 0: back camera，1: front camera
  • rockchip,powerdown: defines the camera’s powerdown gpio
  • pwdn_active: effect voltage level of powerdown
  • mir: 0: don’t support mirror, 1: support mirror
  • resolution: maximum camera resolution
  • orientation: 0: 0 degree， 90: 90 degrees， 180: 180 degrees， 270: 270 degrees
  • i2c_add: Camera’s I2C address
  • i2c_rata: I2C frequency, with Hz unit.
  • i2c_chl: I2C channel number
  • cif_chl: cif controller info.rk312x only has cif0
  • mclk_rate: sensor clock frequency, with MHz unit.

Some of the constants are defined in kernel/arch/arm/mach-rockchip/rk_camera_sensor_info.h:

#define gc0329_FULL_RESOLUTION      0x30000            // 0.3 megapixel
#define gc0329_I2C_ADDR             0x62
#define gc0329_PWRDN_ACTIVE             0x01
#define gc0329_PWRSEQ                   sensor_PWRSEQ_DEFAULT
//Sensor power  active level define
#define PWR_ACTIVE_HIGH                  0x01
#define PWR_ACTIVE_LOW					 0x0

The resolutions are defined in function sensor_get_full_width_height in kernel/drivers/media/video/generic_sensor.h:

static inline int sensor_get_full_width_height(int full_resolution, unsigned short *w, unsigned short *h)
&#123;
    switch (full_resolution)
    &#123;
        case 0x30000:
        &#123;
            *w = 640;
            *h = 480;
            break;
        &#125;

        case 0x100000:
        &#123;
            *w = 1024;
            *h = 768;
            break;
        &#125;
        //...
    &#125;
&#125;

Enable CIF Sensor Device​

To enable CIF, add the following lines to kernel/arch/arm/boot/dts/rk3128-fireprime.dts:

&rk3128_cif_sensor &#123;
	status = "okay";
&#125;;