高通camera驱动分析

柔情只为你懂 2022-05-21 11:55 161阅读 0赞

1、Sensor slave配置

结构体msm\_camera\_sensor\_slave\_info定义在media/msm\_cam\_sensor.h中：

struct msm\_camera\_sensor\_slave\_info \{   
 char  sensor\_name\[32\];   //sensor名称  
 char  eeprom\_name\[32\];   //eeprom名称  
 char  actuator\_name\[32\];   //actuator名称  
 enum msm\_sensor\_camera\_id\_t   camera\_id;   //camera id号  
 uint16\_t   slave\_addr;   //从地址  
 enum msm\_camera\_i2c\_reg\_addr\_type addr\_type;   //camera i2c寄存器地址类型  
 struct msm\_sensor\_id\_info\_t   sensor\_id\_info;   //sensor 芯片id信息  
 struct msm\_sensor\_power\_setting\_array power\_setting\_array;   //上电序列  
 uint8\_t  is\_init\_params\_vaild; //初始化参数是否有效  
 struct msm\_sensor\_init\_params   sensor\_init\_params;   //sensor初始化参数

\};

1.1、枚举类型msm\_sensor\_camera\_id\_t的定义如下：

enum msm\_sensor\_camera\_id\_t \{   
 CAMERA\_0,  //camera id 号0  
 CAMERA\_1,  //camera id 号1  
 CAMERA\_2,  //camera id 号2  
 CAMERA\_3,  //camera id 号3  
 MAX\_CAMERAS,  //支持的最大id号

\};

1.2、枚举类型msm\_camera\_i2c\_reg\_addr\_type的定义如下：

enum msm\_camera\_i2c\_reg\_addr\_type\{   
 MSM\_CAMERA\_I2C\_BYTE\_ADDR = 1,   //1字节型  
 MSM\_CAMERA\_I2C\_WORD\_ADDR,  //2字型  
 MSM\_CAMERA\_I2C\_3B\_ADDR,  //3字节型

\};

1.3、结构体msm\_sensor\_id\_info\_t的定义如下：

struct msm\_sensor\_id\_info\_t\{   
 uint16\_t  sensor\_id\_reg\_addr;   //对应sensor id号的寄存器地址  
 uint16\_t  sensor\_id;  //sensor id号

\};

1.4、结构体 msm\_sensor\_power\_setting\_array的定义如下：

enum msm\_sensor\_power\_seq\_type\_t\{   
 SENSOR\_CLK,  
 SENSOR\_GPIO,  
 SENSOR\_VREG,  
 SENSOR\_I2C\_MUX,  
 \};  
 struct msm\_sensor\_power\_setting\{ //上电序列  
 enum msm\_sensor\_power\_seq\_type  seq\_type;  
 uint16\_t  seq\_val;  
 long  config\_val;  
 uint16\_t  delay;  
 void  \*data\[10\];  
 \};  
 struct msm\_sensor\_power\_setting\_array\{   
 struct msm\_sensor\_power\_setting  \*power\_setting;  
 uint16\_t   size;  
 struct  msm\_sensor\_power\_setting   \*power\_down\_setting;  
 uint16\_t   size\_down;

\};

1.5、结构体msm\_sensor\_init\_params的定义如下：

enum camb\_position\_t\{   
 BACK\_CAMERA\_B,  //后摄  
 FRONT\_CAMERA\_B,  //前摄  
 INVALID\_CAMERA\_B,  //非法  
 \}  
 struct msm\_sensor\_init\_params\{   
 /\* mask of modes supported: 2D, 3D \*/  
 int   modes\_supported;   //支持camera的模式  
 /\* sensor position: front, back \*/  
 enum camb\_position\_t  position;  //sensor的位置  
 /\* sensor mount angle  \*/  
 uint32\_t  sensor\_mount\_angle;  //sensor安装的角度  
 \};

举例：

以下是imx230\_lib.c中对sensor初始化参数的设置。  
  
 支持模式的值是在枚举类型camerab\_mode\_t中：  
 enum camerab\_mode\_t\{   
 CAMERA\_MODE\_2D\_B = (1<<0),  //2D  
 CAMERA\_MODE\_3D\_B = (1<<1),  //3D  
 CAMERA\_MODE\_INVALID = (1<<2),  //非法  
 \};  
  
 2D模式：平面图像模式。  
 3D模式：拍照出使裸眼观看就具有立体感的图像的模式，需要使用双摄像头。  
  
 sensor安装角度的值是宏定义,在sensor\_lib.h中：  
 /\*MOUNT ANGLE >= to this value is considered invalid in sensor lib \*/  
 \#define SENSOR\_MOUNTANGLE\_360  360   //360度  
 /\* Sensor mount angle. \*/  
 \#define SENSOR\_MOUNTANGLE\_0  0  //0度  
 \#define SENSOR\_MOUNTANGLE\_90  90  //90度  
 \#define SENSOR\_MOUNTANGLE\_180  180   //180度

\#define SENSOR\_MOUNTANGLE\_270 270 //270度

2.、Sensor 输出设置

2.1 、Sensor输出格式设置

输出格式：Bayer/YUV.  
 连接模式：parallel/MIPI. msm8974只支持MIPI.

Raw图格式：8/10/12 bits.

imx230分别设置为Bayer、MIPI、10bit。

结构体sensor\_output\_t 定义在sensor\_lib.h中：

typedef struct\{   
 sensor\_output\_format\_t  output\_format;  //输出格式  
 sensor\_connection\_mode\_t  connection\_mode;  //连接模式  
 sensor\_raw\_output\_t  raw\_output;  //raw图格式  
 \}sensor\_output\_t;

其中sensor\_output\_format\_t, sensor\_connection\_mode\_t, sensor\_raw\_output\_t为枚举类型，定义如下：

typedef enum\{   
 SENSOR\_BAYER,  //Bayer格式  
 SENSOR\_YCBCR  //YUV格式（Y,Cb,Cr）  
 \}sensor\_output\_format\_t;  
  
 typedef enum\{   
 SENSOR\_PARALLEL,  //并行  
 SENSOR\_MIPI\_CSI,   //MIPI CSI  
 SENSOR\_MIPI\_CSI\_1,  //CSI1  
 SENSOR\_MIPI\_CSI\_2,  //CSI2  
 \}sensor\_connection\_mode\_t;  
  
 typedef enum\{   
 SENSOR\_8\_BIT\_DIRECT,   //8-bit  
 SENSOR\_10\_BIT\_DIRECT,  //10-bit  
 SENSOR\_12\_BIT\_DIRECT,  //12-bit  
 \}sensor\_raw\_output\_t;  
  
 10-bit RAW图数据是通过数据包的格式进行传输的，打包之后的数据格式为8-bit。下表是对RAW10数据包格式限制条件的说明，每一个数据包的长度必须是表中数值的整数倍，bit位传输顺序服从CSI-2规则，LSB优先。

2.2 、Sensor像素格式信息

结构体sensor\_pix\_fmt\_info\_t定义在sensor\_lib.h中：

struct sensor\_pix\_fmt\_info\_t \{   
 uint32\_t  fourcc;  
 \};

像素格式的值V4L2\_PIX\_FMT\_SRGGB10是宏定义在linux/videodev2.h中，如下：

/\* \_\_u32为unsigned int 型 \*/  
 \#define v4l2\_fourcc(a,b,c,d) \\  
 ((\_\_u32)(a) | ((\_\_u32)(b) << 8) | ((\_\_u32)(c) << 16) | ((\_\_u32)(d) << 24)  //为什么这么做？  
  
 /\* www.siliconimaging.com/RGB%20Bayer.htm \*/  
 \#define V4L2\_PIX\_FMT\_SBGGR8  v4l2\_fourcc('B','A','8','1')  //BGGR 8bit  
 \#define V4L2\_PIX\_FMT\_SGBRG8  v4l2\_fourcc('G','B','R','G')  //GBRG 8bit  
 \#define V4L2\_PIX\_FMT\_SGRBG8  v4l2\_fourcc('G','R','B','G')  //GRBG 8bit  
 \#define V4L2\_PIX\_FMT\_SRGGB8  v4l2\_fourcc('R','G','G','B')  //RGGB 8bit  
 \#define V4L2\_PIX\_FMT\_SBGGR10  v4l2\_fourcc('B','G','1','0')  //BGGR 10bit  
 \#define V4L2\_PIX\_FMT\_SGBRG10  v4l2\_fourcc('G','B','1','0')  //GBRG 10bit  
 \#define V4L2\_PIX\_FMT\_SGRBG10  v4l2\_fourcc('B','A','1','0')  //GRBG 10bit  
 \#define V4L2\_PIX\_FMT\_SRGGB10  v4l2\_fourcc('R','G','1','0')  //RGGB 10bit  
 \#define V4L2\_PIX\_FMT\_SBGGR12  v4l2\_fourcc('B','G','1','2')  //BGGR 12bit  
 \#define V4L2\_PIX\_FMT\_SGBRG12  v4l2\_fourcc('G','B','1','2')  //GBRG 12bit  
 \#define V4L2\_PIX\_FMT\_SGRBG12  v4l2\_fourcc('B','A','1','2')  //GRBG 12bit  
 \#define V4L2\_PIX\_FMT\_SRGGB12  v4l2\_fourcc('R','G','1','2')  //RGGB 12bit  
  
 像素格式的值MSM\_V4L2\_PIX\_FMT\_META是宏定义在media/msm\_cam\_sensor.h中：  
  
 \#define MSM\_V4L2\_PIX\_FMT\_META  v4l2\_fourcc('M','E','T','A')

2.3 、Sensor输出尺寸设置

结构体sensor\_lib\_out\_info\_t用于保存sensor所支持的不同分辨率的信息。imx230\_lib.c中使用结构体sensor\_lib\_out\_info\_t定义了一个sensor\_out\_info\[\]。sensor\_out\_info\[0\]保存最大分辨率信息，sensor\_out\_info\[1\]保存1/4最大分辨率的信息。

2.3.1、 各参数含义解释

结构体sensor\_lib\_out\_info\_t的定义如下：  
 struct sensor\_lib\_out\_info\_t \{   
 uint16\_t  x\_output;  //sensor 输出宽度（pixels）  
 uint16\_t  y\_output;  //sensor输出高度（pixels）  
 uint16\_t  line\_lenth\_pclk;  //每一帧每一行多少个pixels  
 uint16\_t  frame\_length\_lines;  //每一帧多少行  
 uint32\_t  vt\_pixel\_clk;   //sensor 扫描速率（pixels per sec）  
 uint32\_t  op\_pixel\_clk;   //sensor实际输出速率（pixels per sec）  
 uint16\_t  bining\_factor;  /\*?: 1 if average is taken, >1 if sum is   taken(applies only for if this resolution has binnig) \*/  
 float  min\_fps;  //sensor支持的最小帧率  
 float  max\_fps;  //sensor支持的最大帧率  
 uint32\_t  mode;  //分辨率所对应的模式  
 \};  
  
 使用Chromatix软件进行tuning设置Image Width和Image Height的值时分别参考此处x\_output和y\_output。  
  
 line\_length\_pckl 和frame\_length\_lines 是指包含blanking的宽度值和高度值。  
 line\_lenth\_pclk和frame\_length\_lines决定帧的大小。

什么是blanking？

每一帧图像的每一行输出是遵循CSI2的通用帧格式。每一行的行尾（Packet Footer，PF）到下一行行头（Packet Header，PH）的期间称为“line blanking”。同样的，每一帧的帧尾（Frame End，FE）到下一帧帧头（Frame Start，FS）的期间称为“frame blanking”。  
  
 vt\_pixel\_clk时钟用于内部图像处理，计算曝光时间和帧率等。  
 曝光时间计算见4.1。  
 帧率：frame rate = vt\_pixel\_clk / (line\_lenth\_pclk \* frame\_length\_lines).

op\_pixel\_clk = (sensor 输出实际比特率)/bits-per-pixel.

比如,如果 MIPI DDR 时钟值 (sensor MIPI 的时钟 lane 频率) 为 300Mhz, 同时 sensor 使用4 个 lane 传输数据, 每一个 lane 的数据率是 300\*2 = 600Mhz. 因此, 总数据率为 600\*4= 2400Mhz. 对于 10bit 的 bayer sensor, op\_pixel\_clk 值可设置为 2400/10 = 240Mhz.这些值可以从 sensor 的寄存器设置中计算出来。  
  
 其中的mode的值是宏定义的，如下：  
 /\* HFR模式不用于常规的camera，camcorder \*/  
 \#define SENSOR\_DEFAULT\_MODE (1 << 0)  //默认模式  
 \#define SENSOR\_HFR\_MODE (1 << 1)   //高帧率模式，用于捕捉慢动作视频  
 \#define SENSOR\_HDR\_MODE (1 << 2)  //高动态范围图像模式   
  
 结构体sensor\_lib\_out\_info\_array的定义如下：  
 struct sensor\_lib\_out\_info\_array \{   
 struct sensor\_lib\_out\_info\_t  \*out\_info;  //指向sensor\_lib\_out\_info\_t结构体的指针  
 uint16\_t   size;   //sensor\_lib\_out\_info\_t结构体数组长度  
 \}；  
  
 ARRAY\_SIZE的宏定义如下：  
 \#define ARRAY\_SIZE(x) (sizeof(x) / sizeof((x)\[0\]))  //获取数组长度。

2.3.2 、x\_output & y\_output参数设置

x\_output和y\_output是sensor输出图像的重要参数，分别代表了图像的宽度和高度，单位是pixel。上层camera app最终就是从这里获取的sensor输出图像的宽度和高度信息，然后根据此信息裁剪出各种尺寸的图片。

Camera app照相所支持的图片尺寸在mct\_pipeline.c（路径：vendor/qcom/proprietary/mm-camera/mm-camera2/media-controller/mct/pipeline）中定义，如下图：  
  
 因此imx230的x\_output和y\_output参数设置是不能小于上图中的最大尺寸，同时要与实际sensor输出图像的尺寸一致。  
  
 Imx230中控制sensor输出图像尺寸的寄存器关系如下图：  
  
 由关系图可以看出，最终控制sensor图像输出尺寸的是寄存器X\_OUT\_SIZE和Y\_OUT\_SIZE，所以x\_output和y\_output的值要与这两个寄存器的值一致。  
  
 一般sensor提供商所提供的这些寄存器的设置，都是由寄存器X\_ADD\_STA ,Y\_ADD\_STA, X\_ADD\_END和Y\_ADD\_END所确定的尺寸就是sensor最后输出的尺寸，这样后面的bining、sub-sampling、digtal crop、scaling 处理都可以省去以节约拍照时间。  
  
2.4 、Sensor输出寄存器地址设置  
  
 结构体 msm\_sensor\_output\_reg\_addr\_t的定义如下：  
 struct msm\_sensor\_output\_reg\_addr\_t \{   
 uint16\_t  x\_output;  //寄存器X\_OUT\_SIZE地址  
 uint16\_t  y\_output;  //寄存器Y\_OUT\_SIZE地址  
 uint16\_t  line\_length\_pclk;   //寄存器LIN\_LENGTH\_PCK地址  
 uint16\_t  frame\_length\_lines;  //寄存器FRM\_LENGTH\_LINES地址  
 \};

2.5、 图像裁剪设置

图像裁剪设置主要用到的结构体为sensor\_crop\_parms\_t和sensor\_crop\_params\_arry, sensor\_crop\_params\_t用于保存裁剪的位置信息。定义在sensor\_lib.h中：  
  
 struct sensor\_crop\_parms\_t \{   
  uint16\_t  top\_crop;  //距离顶部的距离  
  uint16\_t  bottom\_crop;  //距离底部的距离  
  uint16\_t  left\_crop;  //距离左侧的距离  
  uint16\_t  right\_crop; //距离右侧的距离  
 \} ;  
  
 struct sensor\_lib\_crop\_params\_array\{   
  struct sensor\_crop\_parms\_t   \*crop\_params;  //结构体指针  
  uint16\_t  size;  //结构数组长度  
 \};  
  
imx230对于2种分辨率的图像不裁剪。

2.6 、分辨率切换设置

imx230使用2种分辨率，枚举类型sensor\_res\_cfg\_type\_t说明了进行分辨率切换时所需要进行的操作，在sensor\_lib.h中定义如下：

typedef enum \{   
  SENSOR\_SET\_STOP\_STREAM,  //停止数据传输  
  SENSOR\_SET\_START\_STREAM,  //开始数据传输  
  SENSOR\_SET\_NEW\_RESOLUTION,  //设置新的分辨率  
  SENSOR\_SEND\_EVENT,  //发送事件  
  SENSOR\_SET\_CSIPHY\_CFG,  //CSIPHY参数设置  
  SENSOR\_SET\_CSID\_CFG,  //CSID参数设置  
  SENSOR\_LOAD\_CHROMATIX,  //加载chromatix参数  
 \} sensor\_res\_cfg\_type\_t;  
  
 imx230\_res\_cfg\[\]数组序列对应着切换分辨率的操作顺序：  
  
 停止数据传输 ----> 设置新的分辨率 ----> CSIPHY参数设置 ----> CSID参数设置

\----> 加载chromatix参数 ----> 发送事件 ----> 开始数据传输.

3、Camera I2C寄存器设置

I2C寄存器的设置都会用到这两种结构体：msm\_camera\_i2c\_reg\_array 和msm\_camera\_i2c\_reg\_setting。其定义在media/msm\_camera.h中：

struct msm\_camera\_i2c\_reg\_array \{   
 uint16\_t  reg\_addr;  //寄存器地址  
 uint16\_t  reg\_data;  //寄存器数据  
 \};  
  
 struct msm\_camera\_i2c\_reg\_setting \{   
 struct msm\_camera\_i2c\_reg\_array   \*reg\_setting;   //结构体指针  
 uint16\_t  size;  //结构数组长度  
 enum msm\_camera\_i2c\_reg\_addr\_type  addr\_type;  //地址类型  
 enum msm\_camera\_i2c\_data\_type  data\_type;  //数据类型  
 uint16\_t  dalay;  //延时  
 \};  
  
 其中枚举类型msm\_camera\_i2c\_reg\_addr\_type在1.2中已经作过介绍了。 msm\_camera\_i2c\_data\_type的定义如下：  
  
  
 enum msm\_camera\_i2c\_data\_type \{   
 MSM\_CAMERA\_I2C\_BYTE\_DATA = 1,   
 MSM\_CAMERA\_I2C\_WORD\_DATA,   
 MSM\_CAMERA\_I2C\_SET\_BYTE\_MASK,   
 MSM\_CAMERA\_I2C\_UNSET\_BYTE\_MASK,   
 MSM\_CAMERA\_I2C\_SET\_WORD\_MASK,   
 MSM\_CAMERA\_I2C\_UNSET\_WORD\_MASK,   
 MSM\_CAMERA\_I2C\_SET\_BYTE\_WRITE\_MASK\_DATA,   
 \};

3.1、寄存器初始化设置

表现为在相机启动时一组一次性写入的寄存器。init\_reg\_array\[\],res0\_reg\_array\[\]和res1\_reg\_arry\[\]定义在头文imx230\_lib.h中。分别对应excel表RegisterSetting中的全局设置和不同分辨率设置的数据。  
  
 寄存器初始化流程为：  
  
 上电 —> 外部时钟输入 —> XCLR关闭—> 外部时钟寄存器设置 —> 全局寄存器设置 —> Load Setting  
  
 之后寄存器设置根据不同分辨率具有不同的设置。  
  
 Load Setting —> 模式设置 —> 输出格式设置 —> 时钟设置 —> Data rate设置 —> 曝光时间设置 —> Gain值设置 —> HDR设置 —> DPC2D设置 —> LSC设？ —> Stats 设置

3.2 、Grouphold on设置

sensor工作时更新曝光设定需要操作许多寄存器（曝光时间，每帧行数，增益），这些必须在同一帧完成更新。这些寄存器都有双buffer，并具有按组更新的功能。表现为所有相关寄存器一起完成更新。  
  
 地址0x0104就是寄存器GRP\_PARAM\_HOLD的地址，当其寄存器的值设为1时，写入的寄存器数据被暂存的buffer寄存器中。

3.3 、Grouphold off设置

当寄存器GRP\_PARAM\_HOLD的值为0时，所需要寄存器的值会被同时更新，参数的变化会在同一帧生效。

3.4、 启动输出设置

MIPI数据包必须以在SoT(Start of Transmission)和EoT(End of Transmission)之间发送。根据参考手册7.1，在正确的时间设定寄存器MODE\_SEL（地址0x0100）为1时，开始进行数据输出。  
  
 启动数据输出流程分为两种情况：  
 情况1：在上电之后  
 (1)准备上电序列时序  
 (2)PLL锁相环参数设置  
 (3)初始化设置  
 (4)设置读取模式(起始/结束位置，大小，曝光时间，gain值)  
 (5)设置MIPI接口参数  
 (6)设置寄存器MODE\_SEL的值为1，准备数据输出  
 在经过MIPI唤醒时间和初始化时间之后，开始输出第一帧图像数据。  
  
 情况2：在经过一次数据输出之后  
 (1)设置寄存器MODE\_SEL的值为0，进入待命状态  
 (2)等待MIPI的FE package  
 (3)设置下一次数据输出模式  
 (4)设置寄存器MODE\_SEL的值为1，准备数据输出  
 在经过MIPI唤醒时间和初始化时间之后，开始输出第一帧图像数据。

3.5、停止输出配置

在正确的时间设定MODE\_SEL为0时，结束数据传输。

4、曝光设置

4.1 、曝光寄存器地址  
  
 结构体msm\_sensor\_exp\_gain\_info\_t定义在sensor\_lib.c中：  
 struct msm\_sensor\_exp\_gain\_info\_t \{   
 uint16\_t  coarse\_int\_time\_addr;  //粗曝光时间寄存器地址  
 uint16\_t  global\_gain\_addr;  //模拟增益寄存器地址  
 uint16\_t  vert\_offset;  //曝光行偏置  
 \};  
  
 粗曝光时间单位为lines，用于计算曝光时间，计算关系如下：  
  
 Tsh = Tline \* (COARSE\_INTEG\_TIME + FINE\_INTEG\_TIME / LINE\_LENGTH\_PCK)  
  
 其中细曝光时间单位为pixels，是定值，其寄存器为只读寄存器。Tline为行曝光时间，为时间单位。计算如下：  
  
 Tline = LINE\_LENGTH\_PCK \* VTPXCK\_period  
  
  
 曝光行偏置用于设定以下关系：  
  
 COARSE\_INTEG\_TIME ≤ frame\_length\_lines – vert\_offset  
  
  
4.2、 AEC参数设置  
  
 结构体sensor\_aec\_data\_t定义在sensor\_lib.h中：  
 typedef enum \{   
  SENSOR\_MODE\_SNAPSHOT,  //快照模式  
  SENSOR\_MODE\_RAW\_SNAPSHOT,  //raw图快照模式  
  SENSOR\_MODE\_PREVIEW,  //预览模式  
  SENSOR\_MODE\_VIDEO,  //视频录像模式  
  SENSOR\_MODE\_VIDEO\_HD,  //高清视频录像模式  
  SENSOR\_MODE\_HFR\_60FPS,  //60帧率HFR模式  
  SENSOR\_MODE\_HFR\_90FPS,  //90帧率 HFR模式  
  SENSOR\_MODE\_HFR\_120FPS,  //120帧率HFR模式  
  SENSOR\_MODE\_HFR\_150FPS,  //150帧率HFR模式  
  SENSOR\_MODE\_ZSL,  //零秒快拍  
  SENSOR\_MODE\_INVALID,  //非法  
 \} sensor\_mode\_t;  
  
  
 typedef struct \{   
  sensor\_mode\_t   op\_mode;  //sensor 模式  
  uint32\_t   pixels\_per\_line;  //每一帧每一行多少个pixels  
  uint32\_t   lines\_per\_frame;   //每一帧多少行  
  uint32\_t   pclk;  //vt\_pixel\_clk  
  uint32\_t   max\_fps;  //最大帧率  
  float   digital\_gain;  //数字增益  
  float   stored\_digital\_gain;   
  float   max\_gain;  //最大数字增益  
  uint32\_t   max\_linecount;  //最大曝光行数

\} sensor\_aec\_data\_t;

4.3 、曝光增益gain值设置

AEC算法中模拟增益gain用于曝光计算，实际上必须把gain转换成寄存器gain去设置sensor。以下是imx230的gain转换函数：  
  
 模拟增益real\_gain值的范围是1至8， 对应到reg\_gain的范围为0到448。real\_gain与reg\_gain的关系为：  
 real\_gain = 512 / (512 - reg\_gain)  
  
结构体sensor\_exposure\_info\_t定义在sensor\_lib.h中：  
 typedef struct \{   
 uint16\_t  reg\_gain;  //寄存器gain值  
 uint16\_t  line\_count;  //曝光行数  
 float  digital\_gain;   
 float  sensor\_real\_gain;  //sensor的模拟gain值  
 float  sensor\_digital\_gain;   //sensor的数字gain值  
 \} sensor\_exposure\_info\_t;  
  
5、镜头参数设置  
  
 结构体sensor\_lens\_info\_t定义在sensor\_lib.c中：  
 typedef struct \{   
 float  focal\_length;  //焦距  
 float  pix\_size;  //像素大小  
 float  f\_number;   //光圈  
 float   total\_f\_dist;   
 float  hor\_view\_angle;  //水平视角  
 float  ver\_view\_angle;  //垂直视角  
 \} sensor\_lens\_info\_t;

6、Chromatix参数

每一种分辨率都必须有对应的chromatix库文件。这里对应2种分辨率，设置的是相应的库文件名称。  
  
 结构体sensor\_lib\_chromatix\_t定义在sensor\_lib.h中：  
 struct sensor\_lib\_chromatix\_t \{   
 char   \*common\_chromatix;  
  char   \*camera\_preview\_chromatix;  
  char   \*camera\_snapshot\_chromatix;  
  char   \*camcorder\_chromatix;  
  char   \*liveshot\_chromatix;  
 \};  
 其数据成员都是字符型指针，用来记录不同分辨率下不同模式的库文件名称。

7. MIPI接收器配置

7.1 、CSI lane参数配置  
  
 结构体 csi\_lane\_params\_t定义在media/msm\_camera.h中：  
  
 struct csi\_lane\_params\_t \{   
 uint16\_t  csi\_lane\_assign;   //端口映射设置  
 uint8\_t   csi\_lane\_mask;  //标识哪一个lane被使用  
 uint8\_t   csi\_if;  //未使用  
 uint8\_t   csid\_core\[2\];   //csid硬件选择  
 uint8\_t   csi\_phy\_sel;   //csi-phy设备选择  
 \};  
 csi\_lane\_assign —— 有时候用户的MIPI lanes可能使用不同与MSM参考设置的端口映射。比如，sensor的lane0连接到MSM的数据lane4等。对于这种情况，csi\_lane\_assign参数能设置正确的端口映射。csi\_lane\_assign是一个16bit的值，每位的含义参见下表。lane1用于MIPI时钟，客户不可用它来映射到任何数据lane。  
  
 csi\_lane\_mask —— 用于表示哪些lane被使用，这是一个8位值，每一位含义如下：  
  
Bit position  Represents  
7:5  保留  
4  数据lane4是否使用：  
\- 0 ：不  
\- 1 ：是  
3  数据lane3是否使用：  
\- 0 ：不  
\- 1 ：是  
2  数据lane2是否使用：  
\- 0 ：不  
\- 1 ：是  
1  数据lane1是否使用：  
\- 0 ：不  
\- 1 ：是  
注意：该位必须设置为1  
0  数据lane0是否使用：  
\- 0 ：不  
\- 1 ：是  
  
 比如0x1F表示4条数据lane和时钟都被使用。  
  
 csi\_if —— 暂不使用。  
 csid\_core —— 设置哪个CSID硬件被该sensor使用。两个并发的sensor不能使用同一个CSID硬件。  
 csi\_phy\_sel —— 设置哪个CSI-PHY硬件被该sensor使用。对于每一个sensor来说必须是独一无二的，除非有额外的MIPI桥连接两个sensor到同一个PHY接口上。  
  
7.2 、虚拟通道设置  
  
 CSI2传输的数据包包头部分的起始1byte为数据标志符（Data Identifier, DI），由VC\[7:6\]（Virtual Channel）和DT\[5;0\]（Data Type）组成。通过不同的VC和DT值来标志不同的数据流，占2个bit位的虚拟通道VC允许最多4个数据流交叉传输，其取值范围为0~3.  
  
 下表表示不同的TD的取值及对应的数据格式。  
  
 结构体 msm\_camera\_csid\_vc\_cfg用于保存虚拟通道的设置信息，在media/msm\_camera.h中定义：  
  
  
 struct msm\_camera\_csid\_vc\_cfg \{   
 uint8\_t  cid;  //通道号  
 uint8\_t  dt;  //数据类型  
 uint8\_t  decode\_format;  //解码格式  
 \};  
  
  
 imx230的设置如下：  
  
  
 其数据类型和解码格式的值是宏定义的，其中数据类型的宏定义是根据上述DT表得来的。如下：  
  
  
 \#define CSI\_EMBED\_DATA  0x12  
 \#define CSI\_RESERVED\_DATA\_0  0x13  
 \#define CSI\_YUV422\_8  0x1E  
 \#define CSI\_RAW8  0x2A  
 \#define CSI\_RAW10  0x2B  
 \#define CSI\_RAW12  0x2C  
  
  
 \#define CSI\_DECODE\_6BIT  0  
 \#define CSI\_DECODE\_8BIT  1  
 \#define CSI\_DECODE\_10BIT  2  
 \#define CSI\_DECODE\_DPCM\_10\_8\_10  5

7.3 、数据流设置

typedef struct \_sensor\_stream\_info\_t \{   
  uint16\_t   vc\_cfg\_size;   
  struct msm\_camera\_csid\_vc\_cfg   \*vc\_cfg;   //虚拟通道设置  
  struct sensor\_pix\_fmt\_info\_t   \*pix\_fmt\_fourcc;//像素格式  
 \} sensor\_stream\_info\_t;  
  
  
 typedef struct \_sensor\_stream\_info\_array\_t \{   
  sensor\_stream\_info\_t   \*sensor\_stream\_info;  
  uint16\_t   size;   
 \} sensor\_stream\_info\_array\_t;  
  
7.4、 CSID和CSI-PHY参数设置  
  
 struct msm\_camera\_csid\_lut\_params \{   
 uint8\_t   num\_cid;  //虚拟通道个数  
 struct msm\_camera\_csid\_vc\_cfg   \*vc\_cfg;    //虚拟通道参数  
 \};  
 struct msm\_camera\_csid\_params \{   
 uint8\_t  lane\_cnt;  //使用lane的数目  
 uint16\_t   lane\_assign;  
 uint8\_t   phy\_sel;  
 struct msm\_camera\_csid\_lut\_params lut\_params;  
 \};  
 struct msm\_camera\_csiphy\_params \{   
 uint8\_t   lane\_cnt;  
 uint8\_t   settle\_cnt;  
 uint16\_t   lane\_mask;  
 uint8\_t   combo\_mode;  
 uint8\_t   csid\_core;  
 \};  
  
 struct msm\_camera\_csi2\_params \{   
 struct msm\_camera\_csid\_params   csid\_params;  //CSID参数  
 struct msm\_camera\_csiphy\_params   csiphy\_params;   //CSI-PHY参数  
 \};  
  
 lane\_cnt ——有多少数据 lane 用于数据传输. 该值必须在 sensor 最大能力范围内,而且sensor 寄存器设置必须与该 lane 数匹配.  
  
 settle\_cnt ——该值须和 sensor 的特性匹配, 保证 sensor 的 MIPI 传输和 MSM 的 MIPI 接收能同步.  
  
 客户可以对不同的分辨率模式使用不同CSI 参数设置。imx230采用两种分辨率，但是使用相同的CSI设置。

8、imx230\_ofilm\_open\_lib

在imx230\_lib.c中，最后将所有的参数设置都放入sensor\_lib\_t类型的结构体sensor\_lib\_ptr中，定义函数imx230\_ofilm\_open\_lib()来返回sensor\_lib\_ptr的地址，供外界调用。  
  
结构体sensor\_lib\_t涵盖了关于camera设置的几乎全部信息。如下：  
typedef struct \{   
 /\* sensor slave info \*/  
 struct msm\_camera\_sensor\_slave\_info \*sensor\_slave\_info;  
 /\* sensor info \*/  
 struct msm\_sensor\_init\_params \*sensor\_init\_params;  
 /\* name of the AF actuator (if any)\*/  
 char\* actuator\_name;  
 /\* name of the eeprom (if any)\*/  
 char\* eeprom\_name;  
 /\* sensor output settings \*/  
 sensor\_output\_t \*sensor\_output;  
 /\* sensor output register address \*/  
 struct msm\_sensor\_output\_reg\_addr\_t \*output\_reg\_addr;  
 /\* sensor exposure gain register address \*/  
 struct msm\_sensor\_exp\_gain\_info\_t \*exp\_gain\_info;  
 /\* sensor aec info \*/  
 sensor\_aec\_data\_t \*aec\_info;  
 /\* sensor snapshot exposure wait frames info \*/  
 uint16\_t snapshot\_exp\_wait\_frames;  
 /\* number of frames to skip after start stream info \*/  
 uint16\_t sensor\_num\_frame\_skip;  
 /\* number of frames to skip after start HDR stream info \*/  
 uint16\_t sensor\_num\_HDR\_frame\_skip;  
 /\* sensor pipeline delay \*/  
 uint32\_t sensor\_max\_pipeline\_frame\_delay;  
 /\* sensor exposure table size \*/  
 uint16\_t exposure\_table\_size;  
 /\* sensor lens info \*/  
 sensor\_lens\_info\_t \*default\_lens\_info;  
 /\* csi lane params \*/  
 struct csi\_lane\_params\_t \*csi\_lane\_params;  
 /\* csi cid params \*/  
 struct msm\_camera\_csid\_vc\_cfg \*csi\_cid\_params;  
 /\* sensor port info that consists of cid mask and fourcc mapaping \*/  
 sensor\_stream\_info\_array\_t \*sensor\_stream\_info\_array;  
 /\* csi cid params size \*/  
 uint16\_t csi\_cid\_params\_size;  
 /\* init settings \*/  
 struct sensor\_lib\_reg\_settings\_array \*init\_settings\_array;  
 /\* start settings \*/  
 struct msm\_camera\_i2c\_reg\_setting \*start\_settings;  
 /\* stop settings \*/  
 struct msm\_camera\_i2c\_reg\_setting \*stop\_settings;  
 /\* group on settings \*/  
 struct msm\_camera\_i2c\_reg\_setting \*groupon\_settings;  
 /\* group off settings \*/  
 struct msm\_camera\_i2c\_reg\_setting \*groupoff\_settings;  
 /\* resolution config table \*/  
 struct sensor\_res\_cfg\_table\_t \*sensor\_res\_cfg\_table;  
 /\* resolution settings \*/  
 struct sensor\_lib\_reg\_settings\_array \*res\_settings\_array;  
 struct sensor\_lib\_out\_info\_array \*out\_info\_array;  
 struct sensor\_lib\_csi\_params\_array \*csi\_params\_array;  
 struct sensor\_lib\_crop\_params\_array \*crop\_params\_array;  
 struct sensor\_lib\_chromatix\_array \*chromatix\_array;  
 /\* video\_hdr mode info\*/  
 struct sensor\_lib\_meta\_data\_info\_array \*meta\_data\_out\_info\_array;  
 /\* exposure funtion table \*/  
 sensor\_exposure\_table\_t \*exposure\_func\_table;  
 /\* exposure info \*/  
 sensor\_exposure\_info\_t exposure\_info;  
 /\* flag to sync exp and gain \*/  
 uint8\_t sync\_exp\_gain;  
 /\* video hdr func table \*/  
 sensor\_video\_hdr\_table\_t \*video\_hdr\_awb\_lsc\_func\_table;  
 /\* scale size tbl count\*/  
 uint8\_t scale\_tbl\_cnt;  
 /\* function to get scale size tbl\*/  
 int32\_t (\*get\_scale\_tbl)(msm\_sensor\_dimension\_t \*);  
 /\* supported Scene mode \*/  
 uint32\_t \*sensor\_supported\_scene\_mode;  
 /\* supported effect mode \*/  
 uint32\_t \*sensor\_supported\_effect\_mode;  
 /\* sensor pipeline immediate delay \*/  
 uint32\_t sensor\_max\_immediate\_frame\_delay;  
 /\* library specific data \*/  
 void \*data;  
\} sensor\_lib\_t;