V4L2应用程序框架

V4L2较V4L有较大的改动,并已成为2.6的标准接口,函盖video\dvb\FM...,多数驱动都在向V4l2迁移。更好地了解V4L2先从应 用入手,然后再深入到内核中结合物理设备/接口的规范实现相应的驱动。本文先就V4L2在视频捕捉或camera方面的应用框架。

V4L2采用流水线的方式,操作更简单直观,基本遵循打开视频设备、设置格式、处理数据、关闭设备,更多的具体操作通过ioctl函数来实现。

1.打开视频设备

在V4L2中,视频设备被看做一个文件。使用open函数打开这个设备:

// 用非阻塞模式打开摄像头设备
int cameraFd;
cameraFd open("/dev/video0"O_RDWR O_NONBLOCK, 0);
// 如果用阻塞模式打开摄像头设备,上述代码变为:
//cameraFd = open("/dev/video0", O_RDWR, 0);

应用程序能够使用阻塞模式或非阻塞模式打开视频设备,如果使用非阻塞模式调用视频设备,即使尚未捕获到信息,驱动依旧会把缓存(DQBUFF)里的东西返回给应用程序。


2. 设定属性及采集方式

打开视频设备后,可以设置该视频设备的属性,例如裁剪、缩放等。这一步是可选的。在Linux编程中,一般使用ioctl函数来对设备的I/O通道进行管理:

int ioctl (int __fdunsigned long int __request, ...) ;
在进行V4L2开发中,常用的命令标志符如下(some are optional):
  • 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。

2.1检查当前视频设备支持的标准

在亚洲,一般使用PAL(720X576)制式的摄像头,而欧洲一般使用NTSC(720X480),使用VIDIOC_QUERYSTD来检测:

v4l2_std_id std;
do {
ret ioctl(fdVIDIOC_QUERYSTD, &std);
} while (ret == -1 && errno == EAGAIN);
switch (std) {
case V4L2_STD_NTSC:
//……
case V4L2_STD_PAL:
//……
}

2.2 设置视频捕获格式

当检测完视频设备支持的标准后,还需要设定视频捕获格式,结构如下:

struct  v4l2_format fmt;
memset ( &fmt, 0, sizeof(fmt) );
fmt.type V4L2_BUF_TYPE_VIDEO_CAPTURE;
fmt.fmt.pix.width 720;
fmt.fmt.pix.height 576;
fmt.fmt.pix.pixelformat V4L2_PIX_FMT_YUYV;
fmt.fmt.pix.field V4L2_FIELD_INTERLACED;
if (ioctl(fdVIDIOC_S_FMT, &fmt) == -1) {
return -1;
}

v4l2_format结构如下:
struct v4l2_format
{
enum v4l2_buf_type type// 数据流类型,必须永远是V4L2_BUF_TYPE_VIDEO_CAPTURE 
union
{
struct v4l2_pix_format pix
struct v4l2_window win
struct v4l2_vbi_format vbi
__u8 raw_data[200]; 
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
};


     The overlay window is described by a struct v4l2_window. It defines the size of   the image, its position over the graphics surface and the clipping to be applied. To get the current parameters applications set the type field of a struct v4l2_format to V4L2_BUF_TYPE_VIDEO_OVERLAYand call the VIDIOC_G_FMT ioctl. The driver fills the v4l2_window substructure named win. It is not possible to retrieve a previously programmed clipping list or bitmap.



2.3 分配内存
接下来可以为视频捕获分配内存:

struct v4l2_requestbuffers req;
if (ioctl(fdVIDIOC_REQBUFS, &req) == -1) {
return -1;
}

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[2];
};

2.4 获取并记录缓存的物理空间

使用VIDIOC_REQBUFS,我们获取了req.count个缓存,下一步通过调用VIDIOC_QUERYBUF命令来获取这些缓存的地址,然后使用mmap函数转换成应用程序中的绝对地址,最后把这段缓存放入缓存队列:

image

typedef struct VideoBuffer {
void *start;
size_t length;
} VideoBuffer;

VideoBufferbuffers callocreq.countsizeof(*buffers) );
struct v4l2_buffer buf;

for (numBufs = 0; numBufs req.countnumBufs++) {
memset( &buf, 0, sizeof(buf) );
buf.type V4L2_BUF_TYPE_VIDEO_CAPTURE;
buf.memory V4L2_MEMORY_MMAP;
buf.index numBufs;
// 读取缓存
if (ioctl(fdVIDIOC_QUERYBUF, &buf) == -1) {
return -1;
}

buffers[numBufs].length buf.length;
// 转换成相对地址
buffers[numBufs].start mmap(NULLbuf.lengthPROT_READ PROT_WRITE,
MAP_SHARED,fdbuf.m.offset);

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

// 放入缓存队列
if (ioctl(fdVIDIOC_QBUF, &buf) == -1) {
return -1;
}
}

2.5 视频采集方式

操作系统一般把系统使用的内存划分成用户空间和内核空间,分别由应用程序管理和操作系统管理。应用程序可以直接访问内存的地址,而内核空间存放的是 供内核访问的代码和数据,用户不能直接访问。v4l2捕获的数据,最初是存放在内核空间的,这意味着用户不能直接访问该段内存,必须通过某些手段来转换地 址。

一共有三种视频采集方式:使用read、write方式;内存映射方式和用户指针模式。

read、write方式,在用户空间和内核空间不断拷贝数据,占用了大量用户内存空间,效率不高。

内存映射方式:把设备里的内存映射到应用程序中的内存控件,直接处理设备内存,这是一种有效的方式。上面的mmap函数就是使用这种方式。

用户指针模式:内存片段由应用程序自己分配。这点需要在v4l2_requestbuffers里将memory字段设置成V4L2_MEMORY_USERPTR。

2.6 处理采集数据

V4L2有一个数据缓存,存放req.count数量的缓存数据。数据缓存采用FIFO的方式,当应用程序调用缓存数据时,缓存队列将最先采集到的视频数 据缓存送出,并重新采集一张视频数据。这个过程需要用到两个ioctl命令,VIDIOC_DQBUF和VIDIOC_QBUF:

struct v4l2_buffer buf;
memset(&buf,0,sizeof(buf));
buf.type=V4L2_BUF_TYPE_VIDEO_CAPTURE;
buf.memory=V4L2_MEMORY_MMAP;
buf.index=0;

//读取缓存
if (ioctl(cameraFdVIDIOC_DQBUF, &buf) == -1)
{
return -1;
}
//…………视频处理算法
//重新放入缓存队列
if (ioctl(cameraFdVIDIOC_QBUF, &buf) == -1) {

return -1;
}
 

3. 关闭视频设备

使用close函数关闭一个视频设备

close(cameraFd)

如果使用mmap,最后还需要使用munmap方法。

====EOF===============




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

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

(1)打开设备文件
                  int fd = open(Devicename,mode);
                  Devicename:/dev/video0、/dev/video1 ……
                  Mode:O_RDWR [| O_NONBLOCK]

如果使用非阻塞模式调用视频设备,则当没有可用的视频数据时,不会阻塞,而立刻返回。

(2)取得设备的capability

          struct v4l2_capability capability;
                  int ret = ioctl(fd, VIDIOC_QUERYCAP, &capability);

看看设备具有什么功能,比如是否具有视频输入特性。

(3)选择视频输入

          struct v4l2_input input;
                  ……初始化input
                  int ret = ioctl(fd, VIDIOC_QUERYCAP, &input);

一个视频设备可以有多个视频输入。如果只有一路输入,这个功能可以没有。

(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:
                                //……
                }

(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;
                  }

(6)向驱动申请帧缓存

          struct v4l2_requestbuffers req;
                   if (ioctl(fd, VIDIOC_REQBUFS, &req) == -1) {
                          return -1;
                   }

v4l2_requestbuffers结构中定义了缓存的数量,驱动会据此申请对应数量的视频缓存。多个缓存可以用于建立FIFO,来提高视频采集的效率。

(7)获取每个缓存的信息,并mmap到用户空间

          typedef struct VideoBuffer {
                          void *start;
                          size_t length;
                  } VideoBuffer;

          VideoBuffer* buffers = calloc( req.count, sizeof(*buffers) );
                  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;
                          }

(8)开始采集视频

          int buf_type= V4L2_BUF_TYPE_VIDEO_CAPTURE;
                  int ret = ioctl(fd, VIDIOC_STREAMON, &buf_type);

(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映射好的缓存,取出视频数据。

(10)将刚刚处理完的缓冲重新入队列尾,这样可以循环采集

          if (ioctl(fd, VIDIOC_QBUF, &buf) == -1) {
                          return -1;
                  }

(11)停止视频的采集

          int ret = ioctl(fd, VIDIOC_STREAMOFF, &buf_type);

(12)关闭视频设备

          close(fd);

四、 V4L2驱动框架

上述流程的各个操作都需要有底层V4L2驱动的支持。内核中有一些非常完善的例子。

比如:linux-2.6.26内核目录/drivers/media/video//zc301/zc301_core.c 中的ZC301视频驱动代码。上面的V4L2操作流程涉及的功能在其中都有实现。

1、V4L2驱动注册、注销函数

Video核心层(drivers/media/video/videodev.c)提供了注册函数
              int video_register_device(struct video_device *vfd, int type, int nr)
                    video_device: 要构建的核心数据结构
                    Type: 表示设备类型,此设备号的基地址受此变量的影响
                    Nr: 如果end-base>nr>0 :次设备号=base(基准值,受type影响)+nr;
                    否则:系统自动分配合适的次设备号

具体驱动只需要构建video_device结构,然后调用注册函数既可。

如:zc301_core.c中的
                    err = video_register_device(cam->v4ldev, VFL_TYPE_GRABBER,
                              video_nr[dev_nr]);
          Video核心层(drivers/media/video/videodev.c)提供了注销函数
                    void video_unregister_device(struct video_device *vfd)

2、struct video_device 的构建

      video_device结构包含了视频设备的属性和操作方法。参见zc301_core.c

      strcpy(cam->v4ldev->name, "ZC0301[P] PC Camera");
              cam->v4ldev->owner = THIS_MODULE;
              cam->v4ldev->type = VID_TYPE_CAPTURE | VID_TYPE_SCALES;
              cam->v4ldev->fops = &zc0301_fops;
              cam->v4ldev->minor = video_nr[dev_nr];
              cam->v4ldev->release = video_device_release;
              video_set_drvdata(cam->v4ldev, cam);

大家发现在这个zc301的驱动中并没有实现struct video_device中的很多操作函数,如:vidioc_querycap、vidioc_g_fmt_cap等。主要原因是struct file_operations zc0301_fops中的zc0301_ioctl实现了前面的所有ioctl操作。所以就不需要在struct video_device再实现struct video_device中的那些操作了。

另一种实现方法如下:

static struct video_device camif_dev =
        {
                .name = "s3c2440 camif",
                .type = VID_TYPE_CAPTURE|VID_TYPE_SCALES|VID_TYPE_SUBCAPTURE,
                .fops = &camif_fops,
                .minor = -1,
                .release = camif_dev_release,
                .vidioc_querycap = vidioc_querycap,
                .vidioc_enum_fmt_cap = vidioc_enum_fmt_cap,
                .vidioc_g_fmt_cap = vidioc_g_fmt_cap,
                .vidioc_s_fmt_cap = vidioc_s_fmt_cap,
                .vidioc_queryctrl = vidioc_queryctrl,
                .vidioc_g_ctrl = vidioc_g_ctrl,
                .vidioc_s_ctrl = vidioc_s_ctrl,
        };
        static struct file_operations camif_fops =
        {
                .owner = THIS_MODULE,
                .open = camif_open,
                .release = camif_release,
                .read = camif_read,
                .poll = camif_poll,
                .ioctl = video_ioctl2,
                .mmap = camif_mmap,
                .llseek = no_llseek,
        };

注意:video_ioctl2是videodev.c中是实现的。video_ioctl2中会根据ioctl不同的cmd来调用video_device中的操作方法。

3、Video核心层的实现

参见内核/drivers/media/videodev.c

(1)注册256个视频设备

static int __init videodev_init(void)
        {
                int ret;
                if (register_chrdev(VIDEO_MAJOR, VIDEO_NAME, &video_fops)) {
                        return -EIO;
                }
                ret = class_register(&video_class);
                ……
        }

上面的代码注册了256个视频设备,并注册了video_class类。video_fops为这256个设备共同的操作方法。

(2)V4L2驱动注册函数的实现

int video_register_device(struct video_device *vfd, int type, int nr)
        {
                int i=0;
                int base;
                int end;
                int ret;
                char *name_base;

        switch(type) //根据不同的type确定设备名称、次设备号
                {
                        case VFL_TYPE_GRABBER:
                                base=MINOR_VFL_TYPE_GRABBER_MIN;
                                end=MINOR_VFL_TYPE_GRABBER_MAX+1;
                                name_base = "video";

                                break;
                        case VFL_TYPE_VTX:
                                base=MINOR_VFL_TYPE_VTX_MIN;
                                end=MINOR_VFL_TYPE_VTX_MAX+1;
                                name_base = "vtx";
                                break;
                        case VFL_TYPE_VBI:
                                base=MINOR_VFL_TYPE_VBI_MIN;
                                end=MINOR_VFL_TYPE_VBI_MAX+1;
                                name_base = "vbi";
                                break;
                        case VFL_TYPE_RADIO:
                                base=MINOR_VFL_TYPE_RADIO_MIN;
                                end=MINOR_VFL_TYPE_RADIO_MAX+1;
                                name_base = "radio";
                                break;
                        default:
                                printk(KERN_ERR "%s called with unknown type: %d\n",
                                        __func__, type);
                                return -1;
                }

        
                mutex_lock(&videodev_lock);
                if (nr >= 0 && nr < end-base) {
                        
                        i = base+nr;
                        if (NULL != video_device[i]) {
                                mutex_unlock(&videodev_lock);
                                return -ENFILE;
                        }
                } else {
                        
                        for(i=base;i<end;i++)
                                if (NULL == video_device[i])
                                        break;
                        if (i == end) {
                                mutex_unlock(&videodev_lock);
                                return -ENFILE;
                        }
                }
                video_device[i]=vfd; //保存video_device结构指针到系统的结构数组中,最终的次设备号和i相关。
                vfd->minor=i;
                mutex_unlock(&videodev_lock);
                mutex_init(&vfd->lock);

        
                memset(&vfd->class_dev, 0x00, sizeof(vfd->class_dev));
                if (vfd->dev)
                        vfd->class_dev.parent = vfd->dev;
                vfd->class_dev.class = &video_class;
                vfd->class_dev.devt = MKDEV(VIDEO_MAJOR, vfd->minor);
                sprintf(vfd->class_dev.bus_id, "%s%d", name_base, i - base);//最后在/dev目录下的名称
                ret = device_register(&vfd->class_dev);//结合udev或mdev可以实现自动在/dev下创建设备节点

                ……
        }

从上面的注册函数中可以看出V4L2驱动的注册事实上只是完成了设备节点的创建,如:/dev/video0。和video_device结构指针的保存。

(3)视频驱动的打开过程

当用户空间调用open打开对应的视频文件时,如:

int fd = open(/dev/video0, O_RDWR);

对应/dev/video0的文件操作结构是/drivers/media/videodev.c中定义的video_fops。

static const struct file_operations video_fops=
        {
                .owner = THIS_MODULE,
                .llseek = no_llseek,
                .open = video_open,
        };

奇怪吧,这里只实现了open操作。那么后面的其它操作呢?还是先看看video_open吧。

static int video_open(struct inode *inode, struct file *file)
        {
                unsigned int minor = iminor(inode);
                int err = 0;
                struct video_device *vfl;
                const struct file_operations *old_fops;

        if(minor>=VIDEO_NUM_DEVICES)
                        return -ENODEV;
                mutex_lock(&videodev_lock);
                vfl=video_device[minor];
                if(vfl==NULL) {
                        mutex_unlock(&videodev_lock);
                        request_module("char-major-%d-%d", VIDEO_MAJOR, minor);
                        mutex_lock(&videodev_lock);
                        vfl=video_device[minor]; //根据次设备号取出video_device结构
                        if (vfl==NULL) {
                                mutex_unlock(&videodev_lock);
                                return -ENODEV;
                        }
                }
                old_fops = file->f_op;
                file->f_op = fops_get(vfl->fops);//替换此打开文件的file_operation结构。后面的其它针对此文件的操作都由新的结构来负责 了。也就是由每个具体的video_device的fops负责。

                if(file->f_op->open)
                        err = file->f_op->open(inode,file);
                if (err) {
                        fops_put(file->f_op);
                        file->f_op = fops_get(old_fops);
                }
                ……
        }

以上是我对V4L2的一些理解,希望能对大家了解V4L2有一些帮助!





Linux系统中,视频设备被当作一个设备文件来看待,设备文件存放在 /dev目录下,完整路径的设备文件名为:/dev/video0 .

 

视频采集基本步骤流程如下: 打开视频设备,设置视频设备属性及采集方式、视频数据处理,关闭视频设备,如下图所示:

 

 

一、打开视频设备

打开视频设备非常简单,在V4L2中,视频设备被看做一个文件。使用open函数打开这个设备:

1.     用非阻塞模式打开摄像头设备
int cameraFd;
cameraFd = open("/dev/video0", O_RDWR | O_NONBLOCK);
 

2.     如果用阻塞模式打开摄像头设备,上述代码变为:
cameraFd = open("/dev/video0", O_RDWR);

 

关于阻塞模式和非阻塞模式

应用程序能够使用阻塞模式或非阻塞模式打开视频设备,如果使用非阻塞模式调用视频设备,即使尚未捕获到信息,驱动依旧会把缓存(DQBUFF)里的东西返回给应用程序。

 

二、Linux视频设备驱动常用控制命令使用说明

 

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

 

Linux 视频设备驱动接口V4L2支持的常用控制命令如下:

 

1. 控制命令 VIDIOC_ENUM_FMT

功能: 获取当前视频设备支持的视频格式 

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

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

使用举例:

-------------------------------------------------------------------------------------------------

struct v4l2_fmtdesc fmt;

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

       fmt.index = 0;

       fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

       while ((ret = ioctl(dev, VIDIOC_ENUM_FMT, &fmt)) == 0) {

              fmt.index++;

              printf("{ pixelformat = ''%c%c%c%c'', description = ''%s'' }\n",

                            fmt.pixelformat & 0xFF, (fmt.pixelformat >> 8) & 0xFF,

                            (fmt.pixelformat >> 16) & 0xFF, (fmt.pixelformat >> 24) & 0xFF,

                            fmt.description);

       }

---------------------------------------------------------------------------------------------------------------

 

2. 控制命令VIDIOC_QUERYCAP

功能: 查询视频设备的功能 

参数说明:参数类型为V4L2的能力描述类型struct v4l2_capability 

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

使用举例:

-----------------------------------------------------------------------------------------------------------

struct v4l2_capability cap; 

iret = ioctl(fd_usbcam, VIDIOC_QUERYCAP, ∩);

if(iret < 0)

{

              printf("get vidieo capability error,error code: %d \n", errno);

              return ;

}

----------------------------------------------------------------------------------------------------------

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

 

3. 控制命令VIDIOC_S_FMT

功能: 设置视频设备的视频数据格式,例如设置视频图像数据的长、宽,图像格式(JPEGYUYV格式);

参数说明:参数类型为V4L2的视频数据格式类型 struct v4l2_format  

返回值说明: 执行成功时,函数返回值为 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_YUV420; 

     tv4l2_format.fmt.pix.field = V4L2_FIELD_INTERLACED; 

 

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

-----------------------------------------------------------------------------------------------------------

注意:如果该视频设备驱动不支持你所设定的图像格式,视频驱动会重新修改struct v4l2_format结构体变量的值为该视频设备所支持的图像格式,所以在程序设计中,设定完所有的视频格式后,要获取实际的视频格式,要重新读取struct v4l2_format结构体变量。

 

4. 控制命令VIDIOC_REQBUFS

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

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

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

使用举例:

-----------------------------------------------------------------------------------------------------------

struct v4l2_requestbuffers  tV4L2_reqbuf;

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

 

tV4L2_reqbuf.count = 1;    //申请缓冲区的个数

tV4L2_reqbuf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE; 

tV4L2_reqbuf.memory = V4L2_MEMORY_MMAP;

 

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

--------------------------------------------------------------------------------------------------------------

注意:VIDIOC_REQBUFS会修改tV4L2_reqbufcount值,tV4L2_reqbufcount值返回实际申请成功的视频缓冲区数目;

 

5. 控制命令VIDIOC_QUERYBUF

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

参数说明:参数类型为V4L2缓冲区数据结构类型 struct v4l2_buffer  

返回值说明: 执行成功时,函数返回值为 0struct v4l2_buffer结构体变量中保存了指令的缓冲区的相关信息;

一般情况下,应用程序中调用VIDIOC_QUERYBUF取得了内核缓冲区信息后,紧接着调用mmap函数把内核空间地址映射到用户空间,方便用户空间应用程序的访问。

使用举例:

----------------------------------------------------------------------------------------------------------------

struct v4l2_buffer tV4L2buf; 

memset(&tV4L2buf, 0, 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 , 

                       tV4L2buf.length, 

                       PROT_READ | PROT_WRITE , 

                       MAP_SHARED , 

                       fd_usbcam, tV4L2buf.m.offset); 

------------------------------------------------------------------------------------------------------------------

上述代码在通过调用VIDIOC_QUERYBUF取得内核空间的缓冲区信息后,接着调用mmap函数把内核空间缓冲区映射到用户空间;关于mmap函数的用法,请读者查询相关资料;

 

6. 控制命令VIDIOC_QBUF

功能: 投放一个空的视频缓冲区到视频缓冲区输入队列中 

参数说明:参数类型为V4L2缓冲区数据结构类型 struct v4l2_buffer 

返回值说明: 执行成功时,函数返回值为 0;函数执行成功后,指令的视频缓冲区进入视频输入队列,在启动视频设备拍摄图像时,相应的视频数据被保存到视频输入队列相应的视频缓冲区中。

使用举例:

-------------------------------------------------------------------------------------------------------------

struct v4l2_buffer tV4L2buf; 

memset(&tV4L2buf, 0, 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);

----------------------------------------------------------------------------------------------------------

 

7. 控制命令VIDIOC_STREAMON

功能: 启动视频采集命令,应用程序调用VIDIOC_STREAMON启动视频采集命令后,视频设备驱动程序开始采集视频数据,并把采集到的视频数据保存到视频驱动的视频缓冲区中。

参数说明:参数类型为V4L2的视频缓冲区类型 enum v4l2_buf_type 

返回值说明: 执行成功时,函数返回值为 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 = 2;        

tv.tv_usec = 0; 

 

iret = select(fd_usbcam+ 1, &fds, NULL, NULL, &tv); 

----------------------------------------------------------------------------------------------------------

 

8. 控制命令VIDIOC_DQBUF

功能: 从视频缓冲区的输出队列中取得一个已经保存有一帧视频数据的视频缓冲区;

参数说明:参数类型为V4L2缓冲区数据结构类型 struct v4l2_buffer 

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

使用举例:

----------------------------------------------------------------------------------------------------------

struct v4l2_buffer tV4L2buf; 

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

 

tV4L2buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE; 

tV4L2buf.memory = V4L2_MEMORY_MMAP; 

 

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

----------------------------------------------------------------------------------------------------------

 

9. 控制命令VIDIOC_STREAMOFF

功能: 停止视频采集命令,应用程序调用VIDIOC_ STREAMOFF停止视频采集命令后,视频设备驱动程序不在采集视频数据。

参数说明:参数类型为V4L2的视频缓冲区类型 enum v4l2_buf_type 

返回值说明: 执行成功时,函数返回值为 0;函数执行成功后,视频设备停止采集视频数据。

使用举例:

----------------------------------------------------------------------------------------------------------

enum v4l2_buf_type  v4l2type; 

v4l2type = V4L2_BUF_TYPE_VIDEO_CAPTURE;  

iret = ioctl(fd_usbcam, VIDIOC_STREAMOFF, &v4l2type);

-----------------------------------------------------------------------------------------------------------

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

 

希望本文对大家理解linux下的视频驱动编程有所帮助。


  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值