V4L2 soc-camera 数据结构

[cpp] view
plaincopy

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