3.5 cam_data结构体详解

typedef struct _cam_data { 
	struct video_device *video_dev; 
	int device_type; 

	/* semaphore guard against SMP multithreading */ 
	struct semaphore busy_lock;    //针对SMP的信号量

	int open_count;  //open函数的引用计数，调用一次open函数，这个引用计数加1

	/* params lock for this camera */ 
	struct semaphore param_lock;  //针对camera的信号量

	/* Encoder */ 
	struct list_head ready_q; //三个工作队列之一，这个是应用程序 VIDIOC_QBUF调用后，buffer所处的队列
	struct list_head done_q; //三个工作队列之一，这个是应用程序调用mxc_streamon函数后，buffer所处的队列
	struct list_head working_q; //三个工作队列之一，这个是应用程序VIDIOC_DQBUF调用时，buffer所处的队列
	int ping_pong_csi; //这个值一般取0或者1,在CPMEM中buffer地址的更新过程中使用
	spinlock_t queue_int_lock; 
	spinlock_t dqueue_int_lock; 
	struct mxc_v4l_frame frame[FRAME_NUM]; /* 这个数组是buffer的核心，应用程序申请的frame的信息都							   * 保存在这个数组中*/
	struct mxc_v4l_frame dummy_frame; //虚假的frame，在CPMEM初始化时用这个frame的地址来填充
	wait_queue_head_t enc_queue;  //译码buffer队列，一般在camera_callback函数中唤醒，在VIDIOC_DQBUF中进行等待，与下面的enc_counter一起使用
	int enc_counter;  //执行完译码任务的buffer计数，译码队列的唤醒条件
	dma_addr_t rot_enc_bufs[2];  //rot中需要使用两个buffer，其中buffer的物理地址存放在这个数组中
	void *rot_enc_bufs_vaddr[2];  //虚拟地址存放在这个数组中 
	int rot_enc_buf_size[2];  //这两个buffer的大小分别存放在这个数组中
	enum v4l2_buf_type type; //buffer的类型

	/* still image capture */  /* 静态图片的一些信息 */
	wait_queue_head_t still_queue;  //静态图片任务队列
	int still_counter;  //静态图片任务计数
	dma_addr_t still_buf[2];   //静态图片任务需要使用的两个buffer的地址存放在这个数组中
	void *still_buf_vaddr; 

	/* overlay */  /* overlay的一些信息 */
	struct v4l2_window win; 
	struct v4l2_framebuffer v4l2_fb; 
	dma_addr_t vf_bufs[2]; 
	void *vf_bufs_vaddr[2]; 
	int vf_bufs_size[2]; 
	dma_addr_t rot_vf_bufs[2]; 
	void *rot_vf_bufs_vaddr[2]; 
	int rot_vf_buf_size[2]; 
	bool overlay_active; 
	int output; 
	struct fb_info *overlay_fb; 
	int fb_origin_std; 
	struct work_struct csi_work_struct; 

	/* v4l2 format */  /* v4l2的一些格式信息 */
	struct v4l2_format v2f;  //这个结构体保存的是v4l2的格式信息，这些信息都应用程序中通过VIDIOC_S_FMT宏最后设置好保存在里面的，包括width,height,bytesperline,sizeimage等参数。
	struct v4l2_format input_fmt;	/* camera in */  /* 摄像头输入的格式 */
	bool bswapenable; 
	int rotation;	/* for IPUv1 and IPUv3, this means encoder rotation */ 
	int vf_rotation; /* viewfinder rotation only for IPUv1 and IPUv3 */ 
	struct v4l2_mxc_offset offset; 

	/* V4l2 control bit */  /* 一些控制信息 */
	int bright;  //亮度
	int hue; 
	int contrast;  //对比度
	int saturation; 
	int red; 
	int green; 
	int blue; 
	int ae_mode; 

	/* standard */ 
	struct v4l2_streamparm streamparm; 
	struct v4l2_standard standard; 
	bool standard_autodetect; 
 
	/* crop */  /* crop的一些信息 */
	struct v4l2_rect crop_bounds;  //crop边界信息
	struct v4l2_rect crop_defrect;  //crop默认矩形的信息
	struct v4l2_rect crop_current;  //当前crop的信息

	/* 以下这几个函数指针分为三种 */
	/* encoding相关的函数指针 */
	int (*enc_update_eba) (void *private, dma_addr_t eba);   //更新cpmem中buffer地址的函数指针
	int (*enc_enable) (void *private);   //使能enc函数指针
	int (*enc_disable) (void *private);  //关闭enc函数指针
	int (*enc_enable_csi) (void *private);   //使能csi设备函数指针
	int (*enc_disable_csi) (void *private);  //关闭csi设备函数指针
	void (*enc_callback) (u32 mask, void *dev);  //中断处理函数指针
	/* viewfinder相关的函数指针，这几个函数都在mxc_v4l2_capture.c中的start_preview函数指定 */
	int (*vf_start_adc) (void *private); 
	int (*vf_stop_adc) (void *private); 
	int (*vf_start_sdc) (void *private); 
	int (*vf_stop_sdc) (void *private); 
	int (*vf_enable_csi) (void *private); 
	int (*vf_disable_csi) (void *private); 
	/* csi相关的函数指针 */
	int (*csi_start) (void *private); 
	int (*csi_stop) (void *private); 

	/* misc status flag */  /* 一些标记位 */
	bool overlay_on;  //是否打开overlay的标记位
	bool capture_on;  //是否打开capture的标记位，在streamon函数中置位
	int overlay_pid; 
	int capture_pid; 
	bool low_power;   //用于标记这个设备是否处于低电平状态，在 resume函数中设置为false，在suspend函数中设置为true，这个标记位与cam->power_queue队列一起使用。
	wait_queue_head_t power_queue;  //在resume函数中根据low_power 标志位来唤醒
	unsigned int ipu_id;   //ipu ID
	unsigned int csi;  //每个ipu可以拥有两个csi设备，用于区别哪一个csi设备，0或者1
	u8 mclk_source; 
	bool mclk_on[2];	/* two mclk sources at most now */ 
	int current_input; //当前输入，在mxc_v4l2_capture.c中有一个mxc_capture_inputs []数组，驱动程序会根据这个 current_input这个数字作为下标从这个数组中索引。

	int local_buf_num; 

	/* camera sensor interface */  /* CSI相关的信息 */
	struct camera_sensor *cam_sensor;	/* old version */ 
	struct v4l2_int_device *all_sensors[MXC_SENSOR_NUM]; 
	struct v4l2_int_device *sensor;  //有关摄像头的信息都保存在这个结构体中，它为一个slave子设备
	struct v4l2_int_device *self;  //将cam->self结构体作为一个master主设备，cam->self->priv指向这个cam_data结构体
	int sensor_index; 
	void *ipu; 
	void *csi_soc; 
	enum imx_v4l2_devtype devtype; 

	/* v4l2 buf elements related to PxP DMA */ 
	struct completion pxp_tx_cmpl; 
	struct pxp_channel *pxp_chan; 
	struct pxp_config_data pxp_conf; 
	struct dma_async_tx_descriptor *txd; 
	dma_cookie_t cookie; 
	struct scatterlist sg[2]; 
} cam_data