V4L2 soc-camera 数据结构

static LIST_HEAD(hosts)

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

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接口的方式。
  

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

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

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数目