V4L2 API数据结构

V4L2是V4L的升级版本，为linux下视频设备程序提供了一套接口规范。包括一套数据结构和底层V4L2驱动接口。

1、常用的结构体在内核目录include/linux/videodev2.h中定义

struct v4l2_requestbuffers //申请帧缓冲，对应命令VIDIOC_REQBUFS
        struct v4l2_capability      //视频设备的功能，对应命令VIDIOC_QUERYCAP
        struct v4l2_input           //视频输入信息，对应命令VIDIOC_ENUMINPUT
        struct v4l2_standard        //视频的制式，比如PAL，NTSC，对应命令VIDIOC_ENUMSTD
        struct v4l2_format          //帧的格式，对应命令VIDIOC_G_FMT、VIDIOC_S_FMT等
        struct v4l2_buffer          //驱动中的一帧图像缓存，对应命令VIDIOC_QUERYBUF
        struct v4l2_crop            //视频信号矩形边框
        v4l2_std_id                 //视频制式

2、常用的IOCTL接口命令也在include/linux/videodev2.h中定义

VIDIOC_REQBUFS             //分配内存
        VIDIOC_QUERYBUF         //把VIDIOC_REQBUFS中分配的数据缓存转换成物理地址
        VIDIOC_QUERYCAP         //查询驱动功能
        VIDIOC_ENUM_FMT         //获取当前驱动支持的视频格式
        VIDIOC_S_FMT            //设置当前驱动的频捕获格式
        VIDIOC_G_FMT            //读取当前驱动的频捕获格式
        VIDIOC_TRY_FMT          //验证当前驱动的显示格式
        VIDIOC_CROPCAP          //查询驱动的修剪能力
        VIDIOC_S_CROP           //设置视频信号的矩形边框
        VIDIOC_G_CROP           //读取视频信号的矩形边框
        VIDIOC_QBUF             //把数据从缓存中读取出来
        VIDIOC_DQBUF            //把数据放回缓存队列
        VIDIOC_STREAMON         //开始视频显示函数
        VIDIOC_STREAMOFF        //结束视频显示函数
        VIDIOC_QUERYSTD         //检查当前视频设备支持的标准，例如PAL或NTSC。

3、操作流程

V4L2提供了很多访问接口，你可以根据具体需要选择操作方法。需要注意的是，很少有驱动完全实现了所有的接口功能。所以在使用时需要参考驱动源码，或仔细阅读驱动提供者

的使用说明。

下面列举出一种操作的流程，供参考。

3.1 打开设备文件
     int fd = open(Devicename,mode);
         // Devicename：/dev/video0、/dev/video1 ……
         // Mode：O_RDWR [| O_NONBLOCK]
如果使用非阻塞模式调用视频设备，则当没有可用的视频数据时，不会阻塞，而立刻返回。

3.2 取得设备的capability
struct v4l2_capability capability；
int ret = ioctl(fd, VIDIOC_QUERYCAP, &capability);
看看设备具有什么功能，比如是否具有视频输入特性。

3.3 选择视频输入
     struct v4l2_input input;
     ……      //初始化input
     int ret = ioctl(fd, VIDIOC_QUERYCAP, &input);
一个视频设备可以有多个视频输入。如果只有一路输入，这个功能可以没有。

3.4 检测视频支持的制式
     v4l2_std_id std;
     do {
             ret = ioctl(fd, VIDIOC_QUERYSTD, &std);
        } while (ret == -1 && errno == EAGAIN);

switch (std)
     {
             case V4L2_STD_NTSC:
                        //……
             case V4L2_STD_PAL:
                        //……
     }

3.5 设置视频捕获格式
struct v4l2_format fmt;

fmt.type = V4L2_BUF_TYPE_VIDEO_OUTPUT;
     fmt.fmt.pix.pixelformat = V4L2_PIX_FMT_UYVY;
     fmt.fmt.pix.height      = height;
     fmt.fmt.pix.width       = width;
     fmt.fmt.pix.field       = V4L2_FIELD_INTERLACED;

     ret = ioctl(fd, VIDIOC_S_FMT, &fmt);
     if(ret)
     {
             perror("VIDIOC_S_FMT\n");
             close(fd);
             return -1;
     }

3.6 向驱动申请帧缓存
     struct v4l2_requestbuffers req;
     if (ioctl(fd, VIDIOC_REQBUFS, &req) == -1)
     {
             return -1;
     }
v4l2_requestbuffers结构中定义了缓存的数量，驱动会据此申请对应数量的视频缓存。多个缓存可以用于建立FIFO，来提高视频采集的效率。

3.7 获取每个缓存的信息，并mmap到用户空间
     typedef struct VideoBuffer
     {
             void *start;
             size_t length;
     } VideoBuffer;

VideoBuffer* buffers = calloc( req.count, sizeof(*buffers) ); //申请 req.count 个内存
struct v4l2_buffer buf;

for (numBufs = 0; numBufs < req.count; numBufs++) //映射所有的缓存
     {
             memset( &buf, 0, sizeof(buf) );
             buf.type   = V4L2_BUF_TYPE_VIDEO_CAPTURE;
             buf.memory = V4L2_MEMORY_MMAP;
             buf.index = numBufs;
             if (ioctl(fd, VIDIOC_QUERYBUF, &buf) == -1)
             {       //获取到对应index的缓存信息，此处主要利用length信息及offset信息来完成后面的mmap操作。
                     return -1;
             }
             buffers[numBufs].length = buf.length;
             // 转换成相对地址
             buffers[numBufs].start = mmap(NULL, buf.length, PROT_READ | PROT_WRITE, MAP_SHARED, fd, buf.m.offset);

if (buffers[numBufs].start == MAP_FAILED)
             {
                     return -1;
             }

}

3.8 开始采集视频
int buf_type= V4L2_BUF_TYPE_VIDEO_CAPTURE；
int ret = ioctl(fd, VIDIOC_STREAMON, &buf_type);

3.9 取出FIFO缓存中已经采样的帧缓存
struct v4l2_buffer buf;

memset(&buf,0,sizeof(buf));

buf.type=V4L2_BUF_TYPE_VIDEO_CAPTURE;
buf.memory=V4L2_MEMORY_MMAP;
buf.index=0; //此值由下面的ioctl返回

if (ioctl(fd, VIDIOC_DQBUF, &buf) == -1)
     {
            return -1;
     }
根据返回的buf.index找到对应的mmap映射好的缓存，取出视频数据。

3.10 将刚刚处理完的缓冲重新入队列尾，这样可以循环采集
      if (ioctl(fd, VIDIOC_QBUF, &buf) == -1)
      {
              return -1;
      }

3.11 停止视频的采集
int ret = ioctl(fd, VIDIOC_STREAMOFF, &buf_type);

3.12 关闭视频设备
close(fd);

V4L2 API数据结构相关推荐

杰里之Linein api 数据结构【篇】
Api 中使用该数据结构进行信息存储: struct linein_opr { void *rec_dev;//录音设备的句柄 u8 volume : 7;//linein 当前模式的音量管理 u8 ...
【Qt开发】V4L2 API详解 Buffer的准备和数据读取
前面主要介绍的是:V4L2 的一些设置接口,如亮度,饱和度,曝光时间,帧数,增益,白平衡等.今天看看V4L2 得到数据的几个关键ioctl,Buffer的申请和数据的抓取. 1. 初始化 Memory ...
V4L2驱动详解 API翻译
博主按:介绍V4L2基础的东西,不知道是哪位同志翻译的,莫名的感动啊.这个必须转! 另,对未翻译的部分博主加以补充.文中以蓝色字体表示,如果有错误请高手指正.还有些图片好像不能显示,我从原文复制过来了 ...
基于V4L2的视频驱动开发（1）
编写基于V4L2视频驱动主要涉及到以下几个知识点: l 摄像头方面的知识要了解选用的摄像头的特性,包括访问控制方法.各种参数的配置方法.信号输出类型等. l Came ...
基于V4L2的视频驱动开发（2）华清远见刘洪涛
基于V4L2的视频驱动开发(2) 华清远见刘洪涛三. V4L2 API及数据结构 V4L2是V4L的升级版本,为linux下视频设备程序提供了一套接口规范.包括一套数据结构和 ...
基于V4L2的视频驱动开发
基于V4L2的视频驱动开发编写基于V4L2视频驱动主要涉及到以下几个知识点: ●摄像头方面的知识要了解选用的摄像头的特性,包括访问控制方法.各种参数的配置方法.信号输出类型等. ●Camera解码 ...
基于V4L2的视频驱动开发（2
三. V4L2 API及数据结构 V4L2是V4L的升级版本,为linux下视频设备程序提供了一套接口规范.包括一套数据结构和底层V4L2驱动接口. 1.常用的结构体在内核目录i ...
我们一起学linux之V4L2摄像头应用流程
一.概述 Video for Linuxtwo(Video4Linux2)简称V4L2,是V4L的改进版.V4L2是linux操作系统下用于采集图片.视频和音频数据的API接口,配合适当的视频采集设备 ...
linux v4l2 示例程序,Linux关于Camera使用V4L2
简介 Video for Linux two(Video4Linux2)简称V4L2,是V4L的改进版.V4L2是linux操作系统下用于采集图片.视频和音频数据的API接口. 工作流程打开设备-& ...

V4L2 API数据结构

V4L2 API数据结构相关推荐

最新文章

热门文章