零基础学习MTK平台camera引脚配置

一、MTK平台的GPIO配置

1. MTK平台GPIO驱动程序提供了两个接口：

2.配置dws文件

3.配置dts文件

二、MTK平台camera模块的GPIO配置

一、MTK平台的GPIO配置

1. MTK平台GPIO驱动程序提供了两个接口：

（1）内核空间：所提供的GPIO驱动程序，驱动程序可以调用其他函数，比如mt_set_gpio_dir、mt_set_gpio_mode等；

（2）用户空间：用户空间的程序可以通过发送IOCTL给/dev/ mtgpio的操作GPIO，如open、ioctl、write、read和close等函数。

在搭载MTK平台的机器中查看本机的GPIO配置，可以使用如下命令

adb shell
cat /proc/kmsg
cat /sys/devices/platform/pinctrl/mt_gpio

（以具体的mt_gpio路径为准，可以先使用find sys/ -name "mt_gpio"进行查找）

一般来说，GPIO引脚功能复用每个GPIO引脚支持四种模式，可作为EINT、GPIO、或I2C、SPI等，通过GPIO_MODE进行选择。每个GPIO可以配置的模式可以参考这个头文件kernel-4.X/arch/arm64/boot/dts/mediatek/mtXXXX-pinfunc.h。

GPIO_DIR：GPIO模式下，可配置为控制输入输出方向，置0是input，置1是output。在MTK平台的GPIO表的mode中，会看到有B（for both，既可设为输入也可设为输出），O（for output only），I0（for input only，作为输入且为低电平），I1（作为输入且为高电平）。

GPIO_DIN：通过访问寄存器可以得知输入的是高电平还是低电平

GPIO_DOUT：在引脚被配置为output后，控制输出高低电平

GPIO_PULLEN：是否支持上下拉，GPIO作为输入模式时生效。

mtk的文档给的框图中没有标全，还有设置上下拉，SMT等属性。不过，在cat mt_gpio的时候会打印全相关配置。

PULL_SEL：GPIO_PULLEN只设置了是否使能上拉或下拉，而这个属性设置是上拉还是下拉。0=下拉；1=上拉。上拉是一个电阻接到一个电压，其实就是增强了IO的驱动能力；下拉是一个电阻接到地，保证IO口是低电平；

IES：输入使能，控制输入是否有效。

SMT：是否使能斯密特触发器

DRIVE：驱动能力,一般可取值0～7

([R1] [R0])：当前GPIO pin的上下拉并联电阻的使能状态；

1 0表示enable R1，disable R0

0 1表示disable R1，enable R0

1 1表示enable R1，enable R0

没有打印表示当前GPIO pin不支持PUPD，即只有一个上拉电阻、一个下拉电阻。

2.配置dws文件

使用vendor\mediatek\proprietary\scripts\dct中的DrvGen.exe，打开vendor\mediatek\ proprietary\bootable\bootloader\lk\target\{$project}\dct\dct下的codegen.dws进行GPIO等配置。

依次来看下GPIO的配置项：

EintMode：中断模式

Def.Mode：默认的模式，根据后面勾选的VarName1~3中选择默认模式

InPull En：是否支持上下拉

InPull Sel High：选择上拉还是下拉，勾选表示上拉

Def.Dir：input还是output

OutHigh：输出为高电平还是低电平

SMT#：SMT group

SMT：是否支持SMT（schmitt trigger）功能，波形过滤，输出方波或者脉冲波，延迟滞后具有消噪的功能，一般不用勾选。

IES：输入使能，控制输入是否有效，一般全选。

配置完成后点击保存会自动更新codegen.dws文件。

3.配置dts文件

在kernel-4.*\arch\arm64\boot\dts\mediatek目录下的dts文件中设置pinctrl。

&device{   ......  pinctrl-names = "aaa","bbb","ccc";  pinctrl-0 = <&xxx>;  pinctrl-1 = <&yyy>;  pinctrl-2 = <&zzz>;  ......
};
&pio {  xxx: config0 {  pins_cmd_dat {  pins = <PINMUX_GPIO1__FUNC_GPIO1>;  //设置GPIO mode，在boot/dts/中mtxxxx-pinfunc.h里有定义  slew-rate = <0>;  //设置GPIO dir，0为input，1为output  bias-pull-down = <11>;  //设置pull enable,下拉,后面的11并无影响，写00也可以  input-schmitt-enable = <0>;  //设置SMT enable          };  };  yyy: config1 {  pins_cmd_dat {  pins = <PINMUX_GPIO1__FUNC_GPIO1>;  slew-rate = <1>;  bias-pull-up = <11>;  output-low;    //设置低电平输出，只有在slew-rate设为1时才有效  //output-high就是设置为高电平输出  input-schmitt-enable = <0>;           };  };  zzz: config2 {  pins_cmd_dat {  pins = <PINMUX_GPIO1__FUNC_GPIO1>;  slew-rate = <1>;  bias-disable;  //无上下拉设置，不能与bias-pull-down/up共存  output-low;  input-schmitt-enable = <0>;           };  };
};

二、MTK平台camera模块的GPIO配置

这边以在MT8766_Q0平台配置为例。在确认codegen.dws与所在平台的GPIO配置一致后，还要注意各引脚在上电文件及dtsi中的配置是否正确。下面以添加一个新的regulator电源为例，当要配置一个GPIO电源时步骤大致相同，只是忽略5、6、7这三条操作，并将添加的语句中的regulator字眼都替换为gpio。

该平台在kernel-4.*/drivers/misc/mediatek/imgsensor/src/mt6***/camera_hw/regulator/ regulator.c中默认写了三组regulator的pin

struct REGULATOR_CTRL regulator_control[REGULATOR_TYPE_MAX_NUM] = {  {"vcama"},  {"vcamd"},  {"vcamio"},
};

假设需要添加一个regulator电源，需要在以下文件中做如下工作：

1.kernel-4.*\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\gpio\gpio.c

2.kernel-4.*\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\gpio\gpio.h

3.kernel-4.*\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\imgsensor_cfg_table.c

4.kernel-4.*\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\imgsensor_cfg_table.h

5.kernel-4.*\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\regulator\regulator.c

6.kernel-4.*\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\regulator\regulator.h

7.8.kernel-4.*\arch\arm64\boot\dts\mediatek\cust_mt6XXX_camera.dtsi

要注意所有文件中添加的相对位置要保持一致

1. kernel-4.*\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\gpio\gpio.c

 struct GPIO_PINCTRL gpio_pinctrl_list_cam[  GPIO_CTRL_STATE_MAX_NUM_CAM] = {  /* Main */  {"pnd1"},  {"pnd0"},  {"rst1"},  {"rst0"},  {"ldo_vcama_1"},  {"ldo_vcama_0"},
+{"ldo_vcamio_1p8_1"},     //add
+{"ldo_vcamio_1p8_0"},     //add  {"ldo_vcamd_1"},  {"ldo_vcamd_0"},  {"ldo_vcamio_1"},  {"ldo_vcamio_0"},
};

2. kernel-4.*\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\gpio\gpio.h

enum GPIO_CTRL_STATE_CAM {  /* Main */  GPIO_CTRL_STATE_PDN_H,  GPIO_CTRL_STATE_PDN_L,  GPIO_CTRL_STATE_RST_H,  GPIO_CTRL_STATE_RST_L,  GPIO_CTRL_STATE_LDO_VCAMA_H,  GPIO_CTRL_STATE_LDO_VCAMA_L,
+ GPIO_CTRL_STATE_LDO_VCAMIO_1P8_H,     //add
+ GPIO_CTRL_STATE_LDO_VCAMIO_1P8_L,     //add  GPIO_CTRL_STATE_LDO_VCAMD_H,  GPIO_CTRL_STATE_LDO_VCAMD_L,  GPIO_CTRL_STATE_LDO_VCAMIO_H,  GPIO_CTRL_STATE_LDO_VCAMIO_L,  GPIO_CTRL_STATE_MAX_NUM_CAM,
};

3. kernel-4.*\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\imgsensor_cfg_table.c

struct IMGSENSOR_HW_CFG imgsensor_custom_config[] = {  {  IMGSENSOR_SENSOR_IDX_MAIN,  IMGSENSOR_I2C_DEV_0,  {  {IMGSENSOR_HW_PIN_MCLK, IMGSENSOR_HW_ID_MCLK},  {IMGSENSOR_HW_PIN_AVDD, IMGSENSOR_HW_ID_GPIO},
+  {IMGSENSOR_HW_PIN_DOVDD_1P8, IMGSENSOR_HW_ID_REGULATOR},     //add  {IMGSENSOR_HW_PIN_DOVDD, IMGSENSOR_HW_ID_REGULATOR},  {IMGSENSOR_HW_PIN_DVDD, IMGSENSOR_HW_ID_GPIO},  {IMGSENSOR_HW_PIN_PDN, IMGSENSOR_HW_ID_GPIO},  {IMGSENSOR_HW_PIN_RST, IMGSENSOR_HW_ID_GPIO},  {IMGSENSOR_HW_PIN_NONE, IMGSENSOR_HW_ID_NONE},  },  },  ...
};

//上电时序中
#if defined(*****_MIPI_RAW)  {  SENSOR_DRVNAME_*****_MIPI_RAW,  {  {RST, Vol_Low, 1},  {AVDD, Vol_2800, 0},  {DVDD, Vol_1200, 0},
+  {DOVDD_1P8, Vol_1800, 1},     //add  {SensorMCLK, Vol_High, 1},  {RST, Vol_High, 1}  },  },

4.kernel-4.*\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\imgsensor_cfg_table.h

enum IMGSENSOR_HW_PIN {  IMGSENSOR_HW_PIN_NONE = 0,  IMGSENSOR_HW_PIN_PDN,  IMGSENSOR_HW_PIN_RST,  IMGSENSOR_HW_PIN_AVDD,
+IMGSENSOR_HW_PIN_DOVDD_1P8,     //add  IMGSENSOR_HW_PIN_DVDD,  IMGSENSOR_HW_PIN_DOVDD,
#ifdef MIPI_SWITCH  IMGSENSOR_HW_PIN_MIPI_SWITCH_EN,  IMGSENSOR_HW_PIN_MIPI_SWITCH_SEL,
#endif  IMGSENSOR_HW_PIN_MCLK,  IMGSENSOR_HW_PIN_MAX_NUM,  IMGSENSOR_HW_PIN_UNDEF = -1
};

5. kernel-4.*\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\regulator\regulator.c

struct REGULATOR_CTRL regulator_control[REGULATOR_TYPE_MAX_NUM] = {  {"vcama"},
+{"vcamio_1p8"},     //add  {"vcamd"},  {"vcamio"},
};

若添加的位置在最后，regulator_set中，高亮位置记得做相应修改

static enum IMGSENSOR_RETURN regulator_set(

void *pinstance,

enum IMGSENSOR_SENSOR_IDX sensor_idx,

enum IMGSENSOR_HW_PIN pin,

enum IMGSENSOR_HW_PIN_STATE pin_state)

{

struct regulator *pregulator;

struct REGULATOR *preg = (struct REGULATOR *)pinstance;

int reg_type_offset;

atomic_t *enable_cnt;

if (pin > IMGSENSOR_HW_PIN_AFVDD ||

pin < IMGSENSOR_HW_PIN_AVDD ||

pin_state < IMGSENSOR_HW_PIN_STATE_LEVEL_0 ||

pin_state >= IMGSENSOR_HW_PIN_STATE_LEVEL_HIGH ||

sensor_idx < 0)

return IMGSENSOR_RETURN_ERROR;

......

6.kernel-4.**\drivers\misc\mediatek\imgsensor\src\mt6***\camera_hw\regulator\regulator.h

enum REGULATOR_TYPE {  REGULATOR_TYPE_VCAMA,
+REGULATOR_TYPE_VCAMIO_1P8,     //add  REGULATOR_TYPE_VCAMD,  REGULATOR_TYPE_VCAMIO,  REGULATOR_TYPE_MAX_NUM
};

7.kernel-4.14\arch\arm64\boot\dts\mediatek\cust_mt6XXX_camera.dtsi

 cam0_vcama-supply = <&mt_pmic_vcama_ldo_reg>;
+cam0_vcamio_1p8-supply = <&mt_pmic_vcamio_ldo_reg>;     //add  cam0_vcamd-supply = <&mt_pmic_vcamd_ldo_reg>;  cam0_vcamio-supply = <&mt_pmic_vcamio_ldo_reg>;

如果是GPIO口，这里需去掉相应代码，并在上方的pinctrl中添加相应代码。

8.同时，要确保项目所在的.dts文件中

&pio {
...
}

及&kd_camera_hw1里面没有该电源的配置。该配置中，只配置作为GPIO使用的引脚。也就是当添加一个GPIO电源时，要记得往里面添加一组配置。