V4L2 soc-camera 数据结构

armeasy

• static LIST_HEAD(hosts)  
  

所有的host都在hosts指向的链表上

[cpp] view plaincopy

• static LIST_HEAD(devices);  
  

所有soc camera device都挂在devices指向的链表上。

系统内可能有多个soc_camera_host，每个soc_camera_host可以对应1 ~ n个soc_camera_device。每个soc_camera_device通过soc_camera_video_start函数创建设备节点/dev/videoX
soc_camera_host对应着系统camera处理模块，尽管理论上可以有多个camera host，但是大部分系统仅有一个camera host

在soc_camera_host_register中调用v4l2_device_register为这个soc_camera_host注册一个v4l2_device设备。
在soc_camera_probe中调用soc_camera_init_i2c，为soc_camera_device注册一个v4l2_subdev，我们从soc_camera_probe代码可以看出，只有i2C的设备可以使用这种方式，对于非I2C设备来说，需要soc_camera_link提供add_device来增加子设备。

soc_camera_host， soc_camera_device，v4l2_device，v4l2_subdev关系如下：

• 理论上系统内可以有多个soc_camera_host，物理上soc_camera_host就是系统的camera处理模块驱动
• 一个soc_camera_host可以对应多个soc_camera_device，物理上soc_camera_device是一个camera接口，每个soc_camera_host对应一个v4l2_dev
• 每个soc_camera_device，系统会为他们创建设备节点/dev/videoX。
• 每个soc_camera_device有多个v4l2_subdev，物理上v4l2_subdev可以是sensor，video AD芯片
• v4l2_subdev可以通过i2c挂接到v4l2_device，也可以通过soc_camera_link提供的add_device来增加，这依赖于sensor和video AD芯片挂接到MCU camera接口的方式。
  

[cpp] view plaincopy

• struct soc_camera_device {  
•     struct list_head list;  
•     struct device dev;  
•     struct device *pdev;        /* Platform device */  
•     s32 user_width;  
•     s32 user_height;  
•     enum v4l2_colorspace colorspace;  
•     unsigned char iface;        /* Host number */  
•     unsigned char devnum;       /* Device number per host */  
•     struct soc_camera_sense *sense; /* See comment in struct definition */  
•     struct soc_camera_ops *ops;  
•     struct video_device *vdev;  
•     const struct soc_camera_format_xlate *current_fmt;  
•     struct soc_camera_format_xlate *user_formats;  
•     int num_user_formats;  
•     enum v4l2_field field;      /* Preserve field over close() */  
•     void *host_priv;        /* Per-device host private data */  
•     /* soc_camera.c private count. Only accessed with .video_lock held */  
•     int use_count;  
•     struct mutex video_lock;    /* Protects device data */  
•     struct file *streamer;      /* stream owner */  
•     struct videobuf_queue vb_vidq;  
• };  
  

每一个soc_camera_device都会对应一个/dev/videoX设备节点，除非在soc_camera_probe时失败。
@list：soc_came_device通过这个成员连接到全局devices链表上

@pdev：每一个soc_camera_device，都会有一个platform device，pdev就是这个platform device结构的dev成员
@user_width, @user_height：这个camera的缺省width和height

@iface：camera bus id，也是host id，一个host可以对应多个soc_camera_device
@devnum：device number，每个soc_camera_device都会自动分配一个device number

@ops：操作集合，sensor，video AD（也许还有host）驱动要实现这个接口

@use_count：soc camera使用计数，每次打开这个设备加1，关闭则减1

soc_camera_host

[cpp] view plaincopy

• struct soc_camera_host {  
•     struct v4l2_device v4l2_dev;  
•     struct list_head list;  
•     unsigned char nr;               /* Host number */  
•     void *priv;  
•     const char *drv_name;  
•     struct soc_camera_host_ops *ops;  
• }  
  

@v4l2_dev：每个host都是一个v4l2_device
@list：soc_camera_host通过这个成员链接到全局hosts链表上

@nr：host number，每个host接口对应一个host
@priv：一般存放平台特定的camera参数，比如irq，DMA


[cpp] view plaincopy

• struct soc_camera_ops {  
•     int (*suspend)(struct soc_camera_device *, pm_message_t state);  
•     int (*resume)(struct soc_camera_device *);  
•     unsigned long (*query_bus_param)(struct soc_camera_device *);  
•     int (*set_bus_param)(struct soc_camera_device *, unsigned long);  
•     int (*enum_input)(struct soc_camera_device *, struct v4l2_input *);  
•     const struct v4l2_queryctrl *controls;  
•     int num_controls;  
• };   
  

这个是由sensor，video AD或者host实现的回调函数集。@suspend，@resume：系统休眠唤醒时的回调函数，如果不考虑电源管理，可以不实现这两个函数
@query_bus_param：获取sensor和host之间的总线信息，比如HSYNC VSYNC极性，数据总线宽度，数据线极性等

@set_bus_param：设置sensor和host之间的总线参数。
@enum_input：枚举给定的input number，上层通过@v4l2_input->index指定要查看哪个input，一般可以不实现。
@controls：controls
@num_controls：@controls数目