Camera Porting Guide

1.M camera driver code path

1.1 Config file

– kernel-3.18/arch/arm64/configs/<$PROJECT>_debug_defconfig (for Eng load)

– kernel-3.18/arch/arm64/configs/<$PROJECT>_defconfig ( for user load)

– device/mediatek/<$PROJECT>/ProjectConfig.mk

1.2 Kernel driver & build Makefile

[BY PROJECT]

kernel-3.18/drivers/misc/mediatek/mach/mt6797/<project>/imgsensor/

[BY PLATFORM]

kernel-3.18/drivers/misc/mediatek/imgsensor/src/mt6797/

PRIORITY: PROJECT > PLATFORM

1.3 Kd_sensorlist.c/kd_sensorlist.h

/kernel-3.18/drivers/misc/mediatek/imgsensor/src/<platform>/

1.4 Kd_camera_hw.c/kd_camera_hw.h

kernel-3.18/drivers/misc/mediatek/imgsensor/src/mt6755/camera_project/<project>/camera_hw

1.5 Header files

– kd_imgsensor.h
– kd_imgsensor_errcode.h
– kd_imgsensor_define.h
– kd_camera_feature_id.h
– kd_camera_feature.h
– kd_camera_feature_enum.h

FILE PATH:

1) Kernel space
kernel-3.18/drivers/misc/mediatek/imgsensor/inc/kd_imgsensor.h
2) User space
device/mediatek/common/kernel-headers/kd_imgsensor.h

NOTICE:

These files must be the same inuser and kernel space, otherwise you will encounter the io-ctrl error.Why? One rule: Android should not Access Kernel space Source and Header Files directly.

2.DTS

2.1 Power on template

ADD YOUR SENSOR TO POWERONLIST @ KD_CAMERA_HW.C

NO DEFAULT POWER ON SEQUENCE

KDCISMODULEPOWERON()

kdCISModulePowerOn()

hwpoweron()

- _hwPowerOn() for regulator( aka LDO)

- mtkcam_gpio_set() for gpio

- mt_set_gpio_mode(), mt_set_gpio_dir() and mt_set_gpio_out()

- hwPowerOn() regulator( aka LDO)

2.2 GPIO

2.2.1 USAGE

– To control the PWD/RST pin for camera power on

– To control the external LDO for camera

2.2.2KERNEL 3.18

– Kernel standard

– PINCTRL
For details, please find kernel-3.18/ Documentation/pinctrl.txt

– Need customized for each project manually

Ex.kernel-3.18/arch/arm64/boot/dts/amt6797_64_open.dts

2.3 PINCTRL

PINCTRL_STATE

FUNCTIONS

– pinctrl_lookup_state()

/* GPIO Pin control*/ struct platform_device *cam_plt_dev = NULL; struct pinctrl *camctrl = NULL; struct pinctrl_state *cam0_pnd_h = NULL;/* main cam */ struct pinctrl_state *cam0_pnd_l = NULL; struct pinctrl_state *cam0_rst_h = NULL; struct pinctrl_state *cam0_rst_l = NULL; struct pinctrl_state *cam1_pnd_h = NULL;/* sub cam */ struct pinctrl_state *cam1_pnd_l = NULL; struct pinctrl_state *cam1_rst_h = NULL; struct pinctrl_state *cam1_rst_l = NULL; struct pinctrl_state *cam2_pnd_h = NULL;/* main2 cam */ struct pinctrl_state *cam2_pnd_l = NULL; struct pinctrl_state *cam2_rst_h = NULL; struct pinctrl_state *cam2_rst_l = NULL; struct pinctrl_state *cam_ldo_vcama_h = NULL;/* for AVDD */ struct pinctrl_state *cam_ldo_vcama_l = NULL; struct pinctrl_state *cam_ldo_vcamd_h = NULL;/* for DVDD */ struct pinctrl_state *cam_ldo_vcamd_l = NULL; struct pinctrl_state *cam_ldo_vcamio_h = NULL;/* for DOVDD */ struct pinctrl_state *cam_ldo_vcamio_l = NULL; struct pinctrl_state *cam_ldo_vcamaf_h = NULL;/* for AFVDD */ struct pinctrl_state *cam_ldo_vcamaf_l = NULL; struct pinctrl_state *cam_ldo_sub_vcamd_h = NULL;/* for SUB_DVDD */ struct pinctrl_state *cam_ldo_sub_vcamd_l = NULL; struct pinctrl_state *cam_ldo_main2_vcamd_h = NULL;/* for MAIN2_DVDD */ struct pinctrl_state *cam_ldo_main2_vcamd_l = NULL;

– get specified pinctrl_state descripted in xxx.dts

am0_pnd_hGPIO state for PDN of main cam @ high,

cam0_pnd_l→GPIO state for PDN of main cam @ low

– pinctrl_select_state()

pinctrl_select_state(camctrl, cam0_pnd_l); →set PDN of main cam to low

3.How to customized xxx.dts for each project

3.1 kernel-3.18/arch/arm64/boot/dts/amt6797_64_open.dts

3.2 For camera

– &pio→define states of GPIOs

camera_pins_cam0_pnd0

camera_pins_cam0_pnd1

… all the gpio of camera are listed

– kd_camera_hw1→pinctrl mapping

PATH ：KERNEL-3.18/ARCH/ARM64/BOOT/DTS/AMT6797_64_OPEN.DTS

&kd_camera_hw1 { pinctrl-names = "default", "cam0_rst0", "cam0_rst1", "cam0_pnd0", "cam0_pnd1", "cam1_rst0", "cam1_rst1", "cam1_pnd0", "cam1_pnd1", "cam2_rst0", "cam2_rst1", "cam2_pnd0", "cam2_pnd1", "cam_ldo_vcama_0", "cam_ldo_vcama_1", "cam_ldo_vcamd_0", "cam_ldo_vcamd_1", "cam_ldo_vcamd2_0", "cam_ldo_vcamd2_1"; pinctrl-0 = <&camera_pins_default>; pinctrl-1 = <&camera_pins_cam0_rst0>; pinctrl-2 = <&camera_pins_cam0_rst1>; pinctrl-3 = <&camera_pins_cam0_pnd0>; pinctrl-4 = <&camera_pins_cam0_pnd1>; pinctrl-5 = <&camera_pins_cam1_rst0>; pinctrl-6 = <&camera_pins_cam1_rst1>; pinctrl-7 = <&camera_pins_cam1_pnd0>; pinctrl-8 = <&camera_pins_cam1_pnd1>; /* for main2 */ pinctrl-9 = <&camera_pins_cam2_rst0>; pinctrl-10 = <&camera_pins_cam2_rst1>; pinctrl-11 = <&camera_pins_cam2_pnd0>; pinctrl-12 = <&camera_pins_cam2_pnd1>; /* for ldo control by gpio */ pinctrl-13 = <&camera_pins_cam_ldo_vcama_0>; pinctrl-14 = <&camera_pins_cam_ldo_vcama_1>; pinctrl-15 = <&camera_pins_cam_ldo_vcamd_0>; pinctrl-16 = <&camera_pins_cam_ldo_vcamd_1>; pinctrl-17 = <&camera_pins_cam_ldo_e2_vcamd_0>; pinctrl-18 = <&camera_pins_cam_ldo_e2_vcamd_1>; status = "okay"; };

&pio { camera_pins_cam0_rst0: cam0@0 { pins_cmd_dat { pins = <PINMUX_GPIO32__FUNC_GPIO32>; slew-rate = <1>; /*direction 0:in, 1:out*/ output-low;/*direction out used only. output_low or high*/ }; }; camera_pins_cam0_rst1: cam0@1 { pins_cmd_dat { pins = <PINMUX_GPIO32__FUNC_GPIO32>; slew-rate = <1>; output-high; }; }; camera_pins_cam0_pnd0: cam0@2 { pins_cmd_dat { pins = <PINMUX_GPIO28__FUNC_GPIO28>; slew-rate = <1>; output-low; }; }; camera_pins_cam0_pnd1: cam0@3 { pins_cmd_dat { pins = <PINMUX_GPIO28__FUNC_GPIO28>; slew-rate = <1>; output-high; }; };

PATH ：\KERNEL-3.18\DRIVERS\MISC\MEDIATEK\IMGSENSOR\SRC\MT6797\CAMERA_HW

/*Cam0 Power/Rst Ping initialization */ cam0_pnd_h = pinctrl_lookup_state(camctrl, "cam0_pnd1"); if (IS_ERR(cam0_pnd_h)) { ret = PTR_ERR(cam0_pnd_h); PK_ERR("%s : pinctrl err, cam0_pnd_h\n", __func__); }

`cam0_pnd_l = pinctrl_lookup_state(camctrl, "cam0_pnd0");
if (IS_ERR(cam0_pnd_l)) {
	ret = PTR_ERR(cam0_pnd_l);
	PK_ERR("%s : pinctrl err, cam0_pnd_l\n", __func__);
}`
 
 
`cam0_rst_h = pinctrl_lookup_state(camctrl, "cam0_rst1");
if (IS_ERR(cam0_rst_h)) {
	ret = PTR_ERR(cam0_rst_h);
	PK_ERR("%s : pinctrl err, cam0_rst_h\n", __func__);
}`
 
`cam0_rst_l = pinctrl_lookup_state(camctrl, "cam0_rst0");
if (IS_ERR(cam0_rst_l)) {
	ret = PTR_ERR(cam0_rst_l);
	PK_ERR("%s : pinctrl err, cam0_rst_l\n", __func__);
}`

4.For external LDO control mt6797

PATH ：KERNEL-3.18/ARCH/ARM64/BOOT/DTS/AMT6797_64_OPEN.DTS

camera_pins_cam_ldo_vcamd_0: cam0@vcamd0 { pins_cmd_dat { pins = <PINMUX_GPIO63__FUNC_GPIO63>; slew-rate = <1>; output-low; }; };
camera_pins_cam_ldo_vcamd_1: cam1@vcamd1 { pins_cmd_dat { pins = <PINMUX_GPIO63__FUNC_GPIO63>; slew-rate = <1>; output-high; }; };

PATH ：\KERNEL-3.18\DRIVERS\MISC\MEDIATEK\IMGSENSOR\SRC\MT6797\CAMERA_HW

cam_ldo_vcamd_l = pinctrl_lookup_state(camctrl, "cam_ldo_vcamd_0");

if (pinSetIdx == 2) { if (PowerCustList.PowerCustInfo[CUST_MAIN2_AVDD].Gpio_Pin == GPIO_UNSUPPORTED) { if (TRUE != _hwPowerOn(pwInfo.PowerType, pwInfo.Voltage)) { PK_ERR("[CAMERA SENSOR] Fail to enable digital power\n"); return FALSE; } } else { if (mtkcam_gpio_set(pinSetIdx, MAIN2_AVDD, PowerCustList.PowerCustInfo[CUST_MAIN2_AVDD].Voltage)) { PK_INFO("[CAMERA CUST_AVDD] set gpio failed!!\n"); } } }

case AVDD:
case MAIN2_AVDD:
/*Main & Main2 use same cotrol GPIO */
PK_DBG("mAVDD_usercounter(%d)\n",mAVDD_usercounter);
if (Val == 0 && !IS_ERR(cam_ldo_vcama_l)){ mAVDD_usercounter --; if(mAVDD_usercounter <= 0) { if(mAVDD_usercounter < 0) PK_ERR("Please check AVDD pin control\n");

			mAVDD_usercounter = 0;
			pinctrl_select_state(camctrl, cam_ldo_vcama_l);
		}
		
	}
	else if (Val == 1 && !IS_ERR(cam_ldo_vcama_h)){
		mAVDD_usercounter ++;
		pinctrl_select_state(camctrl, cam_ldo_vcama_h);
	}
	break;

PowerUp PowerOnList = { { {SENSOR_DRVNAME_OV23850_MIPI_RAW, { {SensorMCLK, Vol_High, 0}, {DOVDD, Vol_1800, 0}, {AVDD, Vol_2800, 0}, {DVDD, Vol_1200, 0}, {AFVDD, Vol_2800, 2}, {PDN, Vol_Low, 0}, {PDN, Vol_High, 0}, {RST, Vol_Low, 0}, {RST, Vol_High, 5}, }, },

4.1 PMIC

4.1.1 USE DCT TOOLS FOR CUSTOMIZED

4.1.2 CUST.DTSI WAS GENERATED DURING

Compiling out/target/product/amt6797_64_open/obj/KERNEL_OBJ/arch/arm64/boot/dts/cust.dtsi

4.1.3 KERNEL STANDARD

– Regulator

regulator_get()

– Get instance of regulator

– Called @ probe in kd_sensorlist.c

regulator_set_voltage() & regulator_enable()

– Set voltage and enable among different regulator

– Called @_hwPowerOn() in kd_sensorlist.c

regulator_disable()

– Turn off regulator

– Called @_hwPowerDown() in kd_sensorlist.c

PATH：OUT/TARGET/PRODUCT/AMT6797_64_OPEN/OBJ/KERNEL_OBJ/ARCH/ARM64/BOOT/DTS/CUST.DTSI

&kd_camera_hw1 { vcama-supply = <&mt_pmic_vcama_ldo_reg>; vcama_main2-supply = <&mt_pmic_vcama_ldo_reg>; vcama_sub-supply = <&mt_pmic_vcama_ldo_reg>;

`vcamaf-supply = <&mt_pmic_vldo28_ldo_reg>;
vcamaf_main2-supply = <&mt_pmic_vldo28_ldo_reg>;
vcamaf_sub-supply = <&mt_pmic_vldo28_ldo_reg>;`
 
`vcamd-supply = <&mt_pmic_vcamd_ldo_reg>;
vcamd_main2-supply = <&mt_pmic_vcamd_ldo_reg>;
vcamd_sub-supply = <&mt_pmic_vcamd_ldo_reg>;`
 
`vcamio-supply = <&mt_pmic_vcamio_ldo_reg>;
vcamio_main2-supply = <&mt_pmic_vcamio_ldo_reg>;
vcamio_sub-supply = <&mt_pmic_vcamio_ldo_reg>;`
 
status = "okay";

};

5.I2C BUS

5.1 Also use dct tools for customized and located at cust.dtsi

5.2 &i2cX

– &I2C1 FOR BUS1, &I2C2 FOR BUS AND SO ON…

Path：out/target/product/amt6797_64_open/obj/KERNEL_OBJ/arch/arm64/boot/dts/cust.dtsi

&i2c2 { #address-cells = <1>; #size-cells = <0>; clock-frequency = <400000>; mediatek,use-open-drain; camera_main@36 { compatible = "mediatek,camera_main"; reg = <0x36>; status = "okay"; }; camera_main_af@72 { compatible = "mediatek,camera_main_af"; reg = <0x72>; status = "okay"; }; };

6.ADD A NEW CAMERA FLOW

6.1 Configure camera sensor hal driver in ProjectConfig.mk

file path device\mediatek\$project\ProjectConfig.mk

EXAMPLE:

CUSTOM_HAL_IMGSENSOR = ov23850_mipi_raw

CUSTOM_HAL_MAIN_IMGSENSOR = ov23850_mipi_raw

6.2 Add camera sensor kernel driver project config (<project>_defconfig)

file path : alps<kernel>\arch\arm64\configs<project>_debug_defconfig

EXAMPLE:

–CONFIG_CUSTOM_KERNEL_IMGSENSOR=” ov23850_mipi_raw s5k3m2_mipi_raw s5k5e2ya_mipi_raw imx258_mipi_raw imx377_mipi_raw s5k2x8_mipi_raw CUSTOM_HAL_MAIN_IMGSENSOR = ov23850_mipi“

use menuconfig with console to modify xxx_defconfig

6.3. Add camera sensor kernel driver code to the corresponding path

[BY PROJECT]

kernel-3.18/drivers/misc/mediatek/mach/mt6755/<project>/ imgsensor/

[BY PLATFORM]

kernel-3.18/drivers/misc/mediatek/imgsensor/src/<platform>/

Must modify the corresponding makefile

6.3.1 Add image sensor kernel driver folder

[BY PROJECT]

kernel-3.18/drivers/misc/mediatek/mach/mt6797/<project>/ imgsensor/Makefile (if it exsit)

EXAMPLE:

Add the following items

obj-y += imgsensor/ov23850_mipi_raw/

[BY PLATFORM]

If the image sensor driver doesn’t exist in the ,Project- directory , build system will proceed to search the driver in {platform} directory. Do not need to modify the makefile.

kernel-3.18\drivers\misc\mediatek\imgsensor\src<platform>\Makefile .

6.3.2 Add camera sensor kernel driver code to the corresponding path

[BY PROJECT]

kernel-3.18/drivers/misc/mediatek/mach/mt6797/<project>/ imgsensor/

[By Platform]

If the image sensor driver doesn’t exist in the ,Project- directory , build system will proceed to search the driver in {platform} directory. Do not need to modify the makefile.

kernel-3.18\drivers\misc\mediatek\imgsensor\src<platform>\Makefile .

6.3.2 Add camera sensor kernel driver code to the corresponding path

[BY PROJECT]

kernel-3.18/drivers/misc/mediatek/mach/mt6797/<project>/ imgsensor/

[BY PLATFORM]

kernel-3.18/drivers/misc/mediatek/imgsensor/src/<platform>/

Must modify the corresponding makefile

link you image sensor compiled object

Example: obj-y += ov23850_mipi_raw.o

[BY PROJECT]

alps/kernel-3.18/drivers/misc/mediatek/mach/mt6755/<project>/ imgsensor/xxxx/Makefile (if it exsit)

[BY PLATFORM]

alps<kernel>\drivers\misc\mediatek\imgsensor\src<platform>\Makefile

6.3.3 Modify other related files

1 .Makefile

– ProjectConfig.mk xxx_defconfig

– Kernel xxx_defconfig

2 .imgsensor

– CUSTOM_HAL_IMGSENSOR = xxxxxx_xxx

– CUSTOM_KERNEL_IMGSENSOR = xxxxxx_xxx

– CUSTOM_HAL_SUB_IMGSENSOR = xxxxxx_xxx

– CUSTOM_HAL_MAIN_IMGSENSOR = xxxxxx_xxx

– CUSTOM_KERNEL_MAIN_IMGSENSOR = xxxxxx_xxx=

– CUSTOM_KERNEL_SUB_IMGSENSOR = xxxxxx_xxx

CUSTOM_HAL_IMGSENSOR& CUSTOM_KERNEL_IMGSENSOR mainsub sensor

CUSTOM_HAL_MAIN_IMGSENSOR& CUSTOM_KERNEL_MAIN_IMGSENSOR main sensor

CUSTOM_HAL_SUB_IMGSENSOR& CUSTOM_KERNEL_SUB_IMGSENSOR sub sensor

3 .camera

– # lens port sensor dummy AF sensormain or sub module AF IC

– CUSTOM_HAL_LENS = dummy_lens

– CUSTOM_KERNEL_LENS = dummy_lens

– CUSTOM_HAL_MAIN_LENS = dummy_lens

– CUSTOM_HAL_SUB_LENS =

– CUSTOM_KERNEL_MAIN_LENS = dummy_lens

– CUSTOM_KERNEL_SUB_LENS =

– #Flashlight port sensor dummy constant_flashlight

– CUSTOM_KERNEL_FLASHLIGHT=dummy_flashlight

– CUSTOM_HAL_FLASHLIGHT=dummy_flashlight

– #OTPRAW sensorport sensor dummy, OTP driver

– CUSTOM_KERNEL_CAM_CAL=dummy_eeprom

– CUSTOM_HAL_CAM_CAL=dummy_eeprom

– CUSTOM_KERNEL_EEPROM=dummy_eeprom

– CUSTOM_HAL_EEPROM=dummy_eeprom

4.Image Sensor

– kd_imgsensor.h

sensor ID
#define XXXXXX_SENSOR_ID 0xFFFF
#define SENSOR_DRVNAME_XXXXXX_RAW “xxxxxxxxx“ //RAW sensor

– kd_sensorlist.h

RAW sensor
UINT32 XXXXXX_RAW_SensorInit(PSENSOR_FUNCTION_STRUCT *pfFunc);
kdSensorList[]
-#if defined(XXXXXX_RAW)
-{XXXXXX_SENSOR_ID, SENSOR_DRVNAME_XXXXXX_RAW, XXXXXX_RAW_SensorInit},
-#endif
YUV sensor
UINT32 XXXXXX_YUV_SensorInit(PSENSOR_FUNCTION_STRUCT *pfFunc);
kdSensorList[]
– #if defined(XXXXXX_YUV)
– {XXXXXX_SENSOR_ID, SENSOR_DRVNAME_XXXXXX_YUV, XXXXXX_YUV_SensorInit},
– #endif
– sensorlist.cpp
SensorList[]
– #if defined(XXXXXX_RAW)
– RAW_INFO(XXXXXX_SENSOR_ID, SENSOR_DRVNAME_XXXXXX_RAW, NULL),
– #endif
– #if defined(XXXXXX_YUV)
– YUV_INFO(XXXXXX_SENSOR_ID, SENSOR_DRVNAME_XXXXXX_YUV, NULL),
– #endif
– sensorkdSensorList[]SensorList[]resolution

回复引用

‹›×

Working

请登陆或者注册