Linux 视频设备驱动V4L2最常用的控制命令

http://blog.csdn.net/shaolyh/article/details/6583226

1.控制命令表

　　Linux 视频设备驱动V4L2最常用的控制命令使用说明（1.02）

命令	功能
VIDIOC_QUERYCAP	查询设备驱动的功能
VIDIOC_ENUM_FMT	获取当前视频设备支持的视频格式
VIDIOC_S_FMT	设置视频设备的视频数据格式，例如设置视频图像数据的长、宽，图像格式(JPEG、YUYV格式);
VIDIOC_REQBUFS	请求V4L2驱动分配视频缓冲区(申请V4L2视频驱动分配内存)，V4L2是视频设备的驱动层，位于内核空间
VIDIOC_QUERYBUF	查询已经分配的V4L2的视频缓冲区的相关信息
VIDIOC_QBUF	投放一个空的视频缓冲区到视频缓冲区输入队列中
VIDIOC_DQBUF	从视频缓冲区的输出队列中取得一个已经保存有一帧视频数据的视频缓冲区
VIDIOC_STREAMON	启动视频采集命令，应用程序调用VIDIOC_STREAMON启动视频采集命令后，视频设备驱动程序开始采集视频数据， 并把采集到的视频数据保存到视频驱动的视频缓冲区中。
VIDIOC_STREAMOFF	停止视频采集命令，应用程序调用VIDIOC_ STREAMOFF停止视频采集命令后，视频设备驱动程序不在采集视频数据。
VIDIOC_QUERYSTD	在亚洲，一般使用PAL（720X576）制式的摄像头，而欧洲一般使用NTSC（720X480），使用VIDIOC_QUERYSTD来检测

　　设置视频设备属性通过ioctl来进行设置，ioctl有三个参数，分别是fd, cmd,和parameter,表示设备描述符，控制命令和控制命令参数。

2. 控制命令VIDIOC_QUERYCAP

功能

　　查询设备驱动的功能 ;

参数说明

　　参数类型为V4L2的能力描述类型struct v4l2_capability;

 struct v4l2_capability {
     __u8 driver[]; /* i.e. "bttv" */ //驱动名称,
     __u8 card[]; /* i.e. "Hauppauge WinTV" */ //
     __u8 bus_info[]; /* "PCI:" + pci_name(pci_dev) */ //PCI总线信息
     __u32 version; /* should use KERNEL_VERSION() */
     __u32 capabilities; /* Device capabilities */ //设备能力
     __u32 reserved[];
 };

返回值说明

　　执行成功时，函数返回值为 0;
　　函数执行成功后，struct v4l2_capability 结构体变量中的返回当前视频设备所支持的功能;
　　例如支持视频捕获功能V4L2_CAP_VIDEO_CAPTURE、 V4L2_CAP_STREAMING等。

使用举例

     struct v4l2_capability cap;
     iret = ioctl(fd_usbcam, VIDIOC_QUERYCAP, &cap);
     if(iret < ){
         printf("get vidieo capability error,error code: %d \n", errno);
         return ;
     }

　　执行完VIDIOC_QUERYCAP命令后，cap变量中包含了该视频设备的能力信息，程序中通过检查cap中的设备能力信息来判断设备是否支持某项功能。

3. 控制命令 VIDIOC_ENUM_FMT

功能

　　获取当前视频设备支持的视频格式 。

参数说明

　　参数类型为V4L2的视频格式描述符类型 struct v4l2_fmtdesc

 struct v4l2_fmtdesc {
 　　__u32 index; /* Format number */
 　　enum v4l2_buf_type type; /* buffer type */
     __u32 flags;
     __u8 description[]; /* Description string */
     __u32 pixelformat; /* Format fourcc */
     __u32 reserved[];
 };

返回值说明

　　执行成功时，函数返回值为 0;
　　struct v4l2_fmtdesc 结构体中的 .pixelformat和 .description 成员返回当前视频设备所支持的视频格式;

使用举例

 struct v4l2_fmtdesc fmt;
 memset(&fmt, , sizeof(fmt));
 fmt.index = ;
 fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 while ((ret = ioctl(dev, VIDIOC_ENUM_FMT, &fmt)) == )
 {
     fmt.index++;
     printf("{ pixelformat = ''%c%c%c%c'', description = ''%s'' }\n",
     fmt.pixelformat & 0xFF, (fmt.pixelformat >> ) & 0xFF, (fmt.pixelformat >> ) & 0xFF,
     (fmt.pixelformat >> ) & 0xFF, fmt.description);
 }

4. 控制命令VIDIOC_S_FMT

功能

　　设置视频设备的视频数据格式，例如设置视频图像数据的长、宽，图像格式(JPEG、YUYV格式);

参数说明

　　参数类型为V4L2的视频数据格式类型 struct v4l2_format;

 struct v4l2_format {
     enum v4l2_buf_type type; //数据流类型，必须永远是V4L2_BUF_TYPE_VIDEO_CAPTURE
     union {
         struct v4l2_pix_format pix; /* V4L2_BUF_TYPE_VIDEO_CAPTURE */
         struct v4l2_window win; /* V4L2_BUF_TYPE_VIDEO_OVERLAY */
         struct v4l2_vbi_format vbi; /* V4L2_BUF_TYPE_VBI_CAPTURE */
         struct v4l2_sliced_vbi_format sliced; /* V4L2_BUF_TYPE_SLICED_VBI_CAPTURE */
         __u8 raw_data[]; /* user-defined */
     } fmt;
 };
 struct v4l2_pix_format {
     __u32 width; // 宽，必须是16的倍数
     __u32 height; // 高，必须是16的倍数
     __u32 pixelformat; // 视频数据存储类型，例如是YUV4：2：2还是RGB
     enum v4l2_field field;
     __u32 bytesperline;
     __u32 sizeimage;
     enum v4l2_colorspace colorspace;
     __u32 priv;
 };

返回值说明

　　执行成功时，函数返回值为 0;

使用举例

 struct v4l2_format tv4l2_format;

 tv4l2_format.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 tv4l2_format.fmt.pix.width = img_width;
 tv4l2_format.fmt.pix.height = img_height;
 tv4l2_format.fmt.pix.pixelformat = V4L2_PIX_FMT_YUYV;
 tv4l2_format.fmt.pix.field = V4L2_FIELD_INTERLACED;

 iret = ioctl(fd_usbcam, VIDIOC_S_FMT, &tv4l2_format);

　　注意：

　　　　如果该视频设备驱动不支持你所设定的图像格式，视频驱动会重新修改struct v4l2_format结构体变量的值为该视频设备所支持的图像格式，所以在程序设计中，设定完所

有的视频格式后，要获取实际的视频格式，要重新读取 struct v4l2_format结构体变量。 　　使用VIDIOC_G_FMT设置视频设备的视频数据格式，VIDIOC_TRY_FMT验证视频设备的视频数据格式。

5. 控制命令VIDIOC_REQBUFS

功能

　　请求V4L2驱动分配视频缓冲区(申请V4L2视频驱动分配内存)，V4L2是视频设备的驱动层，位于内核空间，所以通过VIDIOC_REQBUFS控制命令字申请的内存位于内核空间，应用程序不能直接访问，需要通过调用mmap内存映射函数把内核空间内存映射到用户空间后，应用程序通过访问用户空间地址来访问内核空间。

参数说明

　　参数类型为V4L2的申请缓冲区数据结构体类型struct v4l2_requestbuffers;

 struct v4l2_requestbuffers {
     u32 count; //缓存数量,也就是说在缓存队列里保持多少张照片
     enum v4l2_buf_type type; //数据流类型,必须永远是V4L2_BUF_TYPE_VIDEO_CAPTURE
     enum v4l2_memory memory; //V4L2_MEMORY_MMAP或V4L2_MEMORY_USERPTR
     u32 reserved[];
 };

返回值说明

　　执行成功时，函数返回值为 0，V4L2驱动层分配好了视频缓冲区;

使用举例

 struct v4l2_requestbuffers tV4L2_reqbuf;

 memset(&tV4L2_reqbuf, , sizeof(struct v4l2_requestbuffers ));

 tV4L2_reqbuf.count = ; //申请缓冲区的个数
 tV4L2_reqbuf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 tV4L2_reqbuf.memory = V4L2_MEMORY_MMAP; //mmap方式

 iret = ioctl(fd_usbcam, VIDIOC_REQBUFS, &tV4L2_reqbuf);

　　注意：VIDIOC_REQBUFS会修改tV4L2_reqbuf的count值，tV4L2_reqbuf的count值返回实际申请成功的视频缓冲区数目;

6. 控制命令VIDIOC_QUERYBUF

功能

　　查询已经分配的V4L2的视频缓冲区的相关信息，包括视频缓冲区的使用状态、在内核空间的偏移地址、缓冲区长度等。在应用程序设计中通过调 VIDIOC_QUERYBUF来获取内
核空间的视频缓冲区信息，然后调用函数mmap把内核空间地址映射到用户空间，这样应用程序才能够访问位于内核空间的视频缓冲区。

参数说明

　　参数类型为V4L2缓冲区数据结构类型 struct v4l2_buffer;

 struct v4l2_buffer {
     __u32 index;
     enum v4l2_buf_type type;
     __u32 bytesused;
     __u32 flags;
     enum v4l2_field field;
     struct timeval timestamp;
     struct v4l2_timecode timecode;
     __u32 sequence;
     /* memory location */
     enum v4l2_memory memory;
     union {
         __u32 offset;
         unsigned long userptr;
     } m;
     __u32 length;
     __u32 input;
     __u32 reserved;
 };        

返回值说明

　　执行成功时，函数返回值为 0;
struct v4l2_buffer结构体变量中保存了指令的缓冲区的相关信息;一般情况下，应用程序中调用VIDIOC_QUERYBUF取得了内核缓冲区信息后，紧接着调用mmap函数把内核空间地址映射到用户空间,方便用户空间应用程序的访问。

使用举例

 struct v4l2_buffer tV4L2buf;

 memset(&tV4L2buf, , sizeof(struct v4l2_buffer));
 tV4L2buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 tV4L2buf.memory = V4L2_MEMORY_MMAP;
 tV4L2buf.index = i; // 要获取内核视频缓冲区的信息编号

 iret = ioctl(fd_usbcam, VIDIOC_QUERYBUF, &tV4L2buf);

　　// 把内核空间缓冲区映射到用户空间缓冲区

 AppBufLength = tV4L2buf.length;
 AppBufStartAddr = mmap( NULL, /* start anywhere */
 tV4L2buf.length,
 PROT_READ | PROT_WRITE, /* access privilege */
 MAP_SHARED, /* recommended */
 fd_usbcam,
 tV4L2buf.m.offset);

　　上述代码在通过调用VIDIOC_QUERYBUF取得内核空间的缓冲区信息后，接着调用mmap函数把内核空间缓冲区映射到用户空间;

7. 控制命令VIDIOC_QBUF

功能：

　　投放一个空的视频缓冲区到视频缓冲区输入队列中 ;
参数说明：

　　参数类型为V4L2缓冲区数据结构类型 struct v4l2_buffer;
返回值说明：

　　执行成功时，函数返回值为 0;
　　函数执行成功后，指令(指定)的视频缓冲区进入视频输入队列，在启动视频设备拍摄图像时，相应的视频数据被保存到视频输入队列相应的视频缓冲区中。
使用举例：

 struct v4l2_buffer tV4L2buf;

 memset(&tV4L2buf, , sizeof(struct v4l2_buffer));

 tV4L2buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 tV4L2buf.memory = V4L2_MEMORY_MMAP;
 tV4L2buf.index = i; //指令(指定)要投放到视频输入队列中的内核空间视频缓冲区的编号;

 iret = ioctl(fd_usbcam, VIDIOC_QBUF, &tV4L2buf);

8. 控制命令VIDIOC_DQBUF

功能：

　　从视频缓冲区的输出队列中取得一个已经保存有一帧视频数据的视频缓冲区;
参数说明：

　　参数类型为V4L2缓冲区数据结构类型 struct v4l2_buffer;
返回值说明：

　　执行成功时，函数返回值为 0;函数执行成功后，相应的内核视频缓冲区中保存有当前拍摄到的视频数据，应用程序可以通过访问用户空间来读取该视频数据。(前面
已经通过调用函数 mmap做了用户空间和内核空间的内存映射).
使用举例：

 struct v4l2_buffer tV4L2buf;

 memset(&tV4L2buf, , sizeof(struct v4l2_buffer));

 tV4L2buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 tV4L2buf.memory = V4L2_MEMORY_MMAP;

 iret = ioctl(fd_usbcam, VIDIOC_DQBUF, &tV4L2buf);

说明: VIDIOC_DQBUF命令结果, 使从队列删除的缓冲帧信息传给了此tVL2buf。
V4L2_buffer结构体的作用就相当于申请的缓冲帧的代理，找缓冲帧的都要先问问它，通过它来联系缓冲帧，起了中间桥梁的作用。

8. 控制命令VIDIOC_STREAMON

功能：

　　启动视频采集命令，应用程序调用VIDIOC_STREAMON启动视频采集命令后，视频设备驱动程序开始采集视频数据，并把采集到的视频数据保存到视频驱动的视频缓冲区中。
参数说明：

　　参数类型为V4L2的视频缓冲区类型 enum v4l2_buf_type ;

 enum v4l2_buf_type {
 V4L2_BUF_TYPE_VIDEO_CAPTURE = ,
 V4L2_BUF_TYPE_VIDEO_OUTPUT = ,
 V4L2_BUF_TYPE_VIDEO_OVERLAY = ,
 V4L2_BUF_TYPE_VBI_CAPTURE = ,
 V4L2_BUF_TYPE_VBI_OUTPUT = ,
 V4L2_BUF_TYPE_SLICED_VBI_CAPTURE = ,
 V4L2_BUF_TYPE_SLICED_VBI_OUTPUT = ,
 #if 1
 /* Experimental */
 V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY = ,
 #endif
 V4L2_BUF_TYPE_PRIVATE = 0x80,
 };

返回值说明：

　　执行成功时，函数返回值为 0;函数执行成功后，视频设备驱动程序开始采集视频数据，此时应用程序一般通过调用select函数来判断一帧视频数据是否采集完成，
当视频设备驱动完成一帧视频数据采集并保存到视频缓冲区中时，select函数返回，应用程序接着可以读取视频数据;否则select函数阻塞直到视频数据采集完成。 Select函数的
使用请读者参考相关资料。
使用举例：

 enum v4l2_buf_type v4l2type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 fd_set fds ;
 struct timeval tv;
 iret = ioctl(fd_usbcam, VIDIOC_STREAMON, &v4l2type);

 FD_ZERO(&fds);
 FD_SET(fd_usbcam, &fds);
 tv.tv_sec = ; /* Timeout. */
 tv.tv_usec = ;
 iret = select(fd_usbcam+ , &fds, NULL, NULL, &tv);

10. 控制命令VIDIOC_STREAMOFF

功能：

　　停止视频采集命令，应用程序调用VIDIOC_ STREAMOFF停止视频采集命令后，视频设备驱动程序不在采集视频数据。
参数说明：

　　参数类型为V4L2的视频缓冲区类型 enum v4l2_buf_type;
返回值说明：

　　执行成功时，函数返回值为 0;函数执行成功后，视频设备停止采集视频数据。
使用举例：

enum v4l2_buf_type v4l2type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
iret = ioctl(fd_usbcam, VIDIOC_STREAMOFF, &v4l2type);

11. 控制命令VIDIOC_QUERYSTD

功能：

　　在亚洲，一般使用PAL（720X576）制式的摄像头，而欧洲一般使用NTSC（720X480），使用VIDIOC_QUERYSTD来检测：
参数说明：
返回值说明：
　　typedef __u64 v4l2_std_id;
使用举例：

 v4l2_std_id std;
 do{
     ret= ioctl(fd, VIDIOC_QUERYSTD, &std);
 } while(ret== - && errno== EAGAIN);
 switch(std) {
     caseV4L2_STD_NTSC:
     //……
     caseV4L2_STD_PAL:
     //……
 }

　　

　　以上就是Linux 视频设备驱动V4L2最常用的控制命令使用说明，通过使用以上控制命令，可以完成一幅视频数据的采集过程。
V4L2更多的控制命令使用说明请参考：http://v4l2spec.bytesex.org/spec/book1.htm