本人作为初入音视频领域的新人,观摩了各位大佬关于V4L2详细开发流程的满满干货,特意为这两周的学习做个总结,希望后来者能顺利完成关于V4L2的第一个demo。这期内容主要内容为V4L2的各类实用VIDIOC命令调用,各命令顺序总体上呈现的一个V4L2开发流程。
读前必看:
1. 在函数原型中出现的 int request , 其中request 参数即所属的VIDIOC命令。
2. 在例程中出现的函数形参 int fd , fd 是open()函数返回的文件描述符。
3. 各类VIDIOC命令相关的ioctl接口函数返回值 ret,若小于零,则表示函数调用失败,若等于零,表示成功执行。
4. 各类VIDIOC命令相关的ioctl接口函数最好有执行失败检测,方便后续调试找问题。
5. 常用的ioctl接口命令也在include/linux/videodev2.h中定义,则V4L2 必备的头文件:#include <linux/videodev2.h>。
6. 挖掘头文件的时候,也看看 “/include/media/v4l2-dev.h”,它定义了很多V4L2 ioctl()
将要用到的结构体。
常用的VIDIOC命令:
1. VIDIOC_QUERYCAP (查询设备属性)
2. VIDIOC_ENUM_FMT (显示所有支持的格式)
3. VIDIOC_S_FMT (设置视频捕获格式)
4. VIDIOC_G_FMT (获取硬件现在的视频捕获格式)
5. VIDIOC_TRY_FMT (检查是否支持某种帧格式)
6. VIDIOC_ENUM_FRAMESIZES (枚举设备支持的分辨率信息)
7. VIDIOC_ENUM_FRAMEINTERVALS (获取设备支持的帧间隔)
8. VIDIOC_S_PARM && VIDIOC_G_PARM (设置和获取流参数)
9. VIDIOC_QUERYCAP (查询驱动的修剪能力)
10. VIDIOC_S_CROP (设置视频信号的边框)
11. VIDIOC_G_CROP (读取设备信号的边框)
12. VIDIOC_REQBUFS (向设备申请缓存区)
13. VIDIOC_QUERYBUF (获取缓存帧的地址、长度)
14. VIDIOC_QBUF (把帧放入队列)
15. VIDIOC_DQBUF (从队列中取出帧)
16. VIDIOC_STREAMON && VIDIOC_STREAMOFF (启动/停止视频数据流)
一. 视频捕获设备的打开和关闭
1.打开设备
open()
头文件:
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
函数原型: 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时才有效。
flags参数详解:
1. O_READONLY: 只读模式
2. O_WRONLY :只写模式
3. O_RDWR: 可读可写模式
返回值:
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
Fun:查询设备属性,即查询你是谁,你能干什么?
函数原型: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 图像格式四剑客:
1. VIDIOC_ENUM_FMT (显示所有支持的格式)
2. VIDIOC_S_FMT(设置视频捕获格式)
3. VIDIOC_G_FMT(获取硬件现在的视频捕获格式)
4. VIDIOC_TRY_FMT(检查是否支持某种帧格式)
1. VIDIOC_ENUM_FMT
Fun:显示所有支持的格式,即允许应用查询所支持的格式,属于格式协商的部分
函数原型: int ioctl(int fd, int request, struct v4l2_fmtdesc *argp);
此处 request 即 VIDIOC_ENUM_FMT,后续request 都由前文标注的VIDIOC 命令代替。
//相关的结构体:
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. 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