V4L2


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->v4l


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM