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{
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>;
};
gc0329_b {
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>;
};
};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 0x0The 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)
{
switch (full_resolution)
{
case 0x30000:
{
*w = 640;
*h = 480;
break;
}
case 0x100000:
{
*w = 1024;
*h = 768;
break;
}
//...
}
}Enable CIF Sensor Device
To enable CIF, add the following lines to kernel/arch/arm/boot/dts/rk3128-fireprime.dts:
&rk3128_cif_sensor {
status = "okay";
};