V4L2相关的视频开发

V4L2开发应用流程的各类超实用VIDIOC命令及其结构体集锦_Mark_minGE的博客-CSDN博客

V4L2常用命令详解_Linuxxulin的博客-CSDN博客

一、摄像头设备的打开和关闭

1.打开设备
  open()函数
  函数原型： int fd=open(const char *pathname, int flags);
      or int fd=open(const char *pathname, int flags, mode_t mode);
   ps: 基本上用第一个函数原型

  函数参数：
  1. pathname：打开文件的路径名 ，如 “/dev/video0” ,也可以是预定义字符串的宏，或char*类型的字符串指针。
  2. flags：用来控制打开文件的模式。
  3. mode：用来设置创建文件的权限(rwx). 当flags使用 O_CREAT时才有效。

  返回值：
  1.调用失败： 返回-1，并修改errno
  2. 调用成功： 返回一个int类型的文件描述符fd

  应用于V4L2的实例，打开设备节点： /dev/video0，则int fd = open("/dev/video0", O_RDWR);。

2.关闭设备
  头文件：#include <unistd.h>
  原型： int close(int fd);
  实例： close(fd);

二. 查询、设置、获取设备属性（QUERY，ENUM， SET， GET）

2.1 查询VIDIOC_QUERYCAP  硬件信息

函数原型：int ioctl(int fd, int request, struct v4l2_capability *argp);

ps： 此处request 即 VIDIOC_QUERYCAP，即控制命令

 /*相关结构体：*/
struct v4l2_capability
{
  __u8  driver[16];        // 驱动名字
  __u8  card[32];          // 设备名字
  __u8  bus_info[32];      // 设备在系统中的位置
  __u32 version;           // 驱动版本号
  __u32 capabilities;      // 设备支持的操作
  __u32 reserved[4];       // 保留字段
};

其中capabilities在摄像头中设置值为 V4L2_CAP_VIDEO_CAPTURE

//例程：
int querycap_camera(int fd)
{
  //获取驱动信息，VIDIOC_QUERCAP
  struct v4l2_capability cap;
  int ret = 0;
  memset(&cap,0, sizeof（cap）);
  ret = ioctl(fd, VIDIOC_QUERYCAP, &cap);
  if(ret < 0)
  {
    printf("VIDIOC_QUERYCAP failed(%d)\n", ret);
    return -1;
  }
  else
  {
    /*输出 caoability 信息*/
    printf("Capability Informations:\n");
    printf(" driver: %s\n", cap.driver);
    printf(" card: %s\n", cap.card);
    printf(" bus_info: %s\n", cap.bus_info);
    printf(" version: %08X\n", cap.version);
    printf(" capabilities: %08X\n", cap.capabilities);
  }
  printf("--------------------\n");        //可作为分割线。
  return ret;                
}

2.2 查询支持的格式等信息   VIDIOC_ENUM_FMT (显示所有支持的格式)

//相关的结构体：    
struct v4l2_fmtdesc
{
  __u32  index;                  // 要查询的格式序号，应用程序设置
  enum   v4l2_buf_type type;   // 帧类型，应用程序设置
  __u32  flags;                   // 是否为压缩格式
  __u8   description[32];      // 格式名称
  __u32  pixelformat;           // 格式
  __u32     reserved[4];           // 保留，不使用设置为0
};

参数分析：
  1. index ：是用来确定格式的一个简单整型数。与其他V4L2所使用的索引一样，这个也是从0开始递增，至最大允许值为止。应用可以通过一直递增索引值知道返回-EINVAL的方式枚举所有支持的格式。
  2. type：是描述数据流类型的字段。对于视频捕获设备（摄像头或调谐器）来说，就是V4L2_BUF_TYPE_VIDEO_CAPTURE。
  3. flags: 只定义了一个值，即V4L2_FMT_FLAG_COMPRESSED，表示这是一个压缩的视频格式。
  4. description: 是对这个格式的一种简短的字符串描述。
  5. pixelformat: 应是描述视频表现方式的四字符码
  ps: 其中第3、4、5项为就index所支持的某个图像格式，V4L2驱动会自动填写的结构体成员信息。

//fun: display all supported formats
void enum_camera_format(int fd)
{
  struct v4l2_fmtdesc fmtdesc;
  memset(&fmtdesc, 0, sizeof(fmtdesc));
  fmtdesc.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
  printf("Supported format:\n");
  while(ioctl(fd, VIDIOC_ENUM_FMT, &fmtdesc) != -1)
  {
    printf("\t%d.%s\n",fmtdesc.index+1, fmtdesc.description);	
    fmtdesc.index++;
  }
}

2.3 设置视频捕获格式 VIDIOC_S_FMT

Fun：设置视频捕获格式
函数原型： int ioctl(int fd, int request, struct v4l2_format* argp);

//相关的结构体    
struct v4l2_format 
{  
  enum v4l2_buf_type type;  
  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[200];                   /* user-defined */  
  } fmt;  
};

PS: 此处type 用于视频捕获设备来说也就是V4L2_BUF_TYPE_VIDEO_CAPTURE，对应fmt共用体中的pix,即pix是重点。

//其中：
enum v4l2_buf_type 
{  
    V4L2_BUF_TYPE_VIDEO_CAPTURE        = 1,  
    V4L2_BUF_TYPE_VIDEO_OUTPUT         = 2,  
    V4L2_BUF_TYPE_VIDEO_OVERLAY        = 3,  
    ...  
    V4L2_BUF_TYPE_PRIVATE              = 0x80,  
};  

struct v4l2_pix_format 
{  
  __u32                 width;         // 宽，必须是16的倍数
  __u32                 height;        // 高，必须是16的倍数
  __u32                 pixelformat;   // 视频数据存储类型，例如是//YUV4：2：2
  enum v4l2_field       field;  
  __u32                 bytesperline;  // 一行图像占用的字节数   
  __u32                 sizeimage;  
  enum v4l2_colorspace  colorspace;  
  __u32                 priv;    /* private data, depends on pixelformat */  
};

描述：
  可用v4l2_format 结构体用来设置摄像头的视频制式、帧格式等，在设置这个参数时应先填好
v4l2_format 的各个域，如 type（传输流类型），fmt.pix.width(宽)fmt.pix.heigth(高)，
fmt.pix.field(采样区域，如隔行采样)，fmt.pix.pixelformat(采样类型，如 YUV4:2:2)，
然后通过 VIDIO_S_FMT 操作命令设置视频捕捉格式。
 

//例程：
int set_camera_fmt_c(int fd, struct v4l2_format *fmt)
{
  //设置视频格式，格式先在fmt结构体里设置好，再调用VIDIOC_S_FMT,
  int ret = 0;
  memset(fmt, 0, sizeof(*fmt));
  fmt->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
  fmt->fmt.pix.width = 1920；
  fmt->fmt.pix.height =1080；  //获取1080P的视频帧
  fmt->fmt.pix.pixelformat =V4L2_PIX_FMT_YUYV;   //格式设置为YUV格式
  fmt->fmt.pix.field = V4L2_FIELD_ALTERNATE;			
  ret = ioctl(fd, VIDIOC_S_FMT, fmt);
  if(ret < 0)
  {
    printf("VIDIOC_S_FMT failed(%d)\n", ret);
    return -1;
  }
  else
  {
    printf("VIDIOC_S_FMT succeed(%d)\n", ret);
  }
  return 0;
}