Video4Linux框架简介(4) - v4l2_ioctl_ops

最新推荐文章于 2025-05-14 10:22:03 发布
最新推荐文章于 2025-05-14 10:22:03 发布
阅读量3.8k 收藏 6
点赞数 1
分类专栏： V4L2 Camera Linux Kernel 文章标签： V4L2 linux kernel 驱动开发
本文详细介绍了V4L2中常用的ioctl回调函数，包括输入设备枚举、设置和获取输入源、SDTV标准的获取与设置、DV定时功能、格式设置等。针对不同硬件需求，提供了具体实现示例。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

译注：本节主要会介绍一些v4l2常用的ioctl回调函数，每个驱动开发者可根据硬件需要来做具体实现或者不做实现。

1. Input ioctls

vidioc_enum_input，顾名思义就是枚举输入，对于本示例驱动来说，有标准的S-Video输入和HDMI两种。

static int skeleton_enum_input(struct file *file, void *priv,
struct v4l2_input *i)
{
if (i->index > 1)
return -EINVAL;
i->type = V4L2_INPUT_TYPE_CAMERA; //指定输入类型，有V4L2_INPUT_TYPE_CAMERA和V4L2_INPUT_TYPE_TUNER两种
if (i->index == 0) {
i->std = V4L2_STD_ALL;
strlcpy(i->name, "S-Video", sizeof(i->name));
i->capabilities = V4L2_IN_CAP_STD;
} else {
i->std = 0;
strlcpy(i->name, "HDMI", sizeof(i->name));
i->capabilities = V4L2_IN_CAP_DV_TIMINGS;
}
return 0;
}
static const struct v4l2_ioctl_ops skel_ioctl_ops = {
.vidioc_enum_input = skeleton_enum_input, //可以和之前的vidioc_query_cap放在一起，后面的也一样
};

vidioc_g_input 和 vidioc_s_input

应用会调用这两个ioctl来设置和获取当前的input。

static int skeleton_s_input(struct file *file, void *priv, unsigned int i)
{
struct skeleton *skel = video_drvdata(file);
if (i > 1)
return -EINVAL;
skel->input = i;
skel->vdev.tvnorms = i ? 0 : V4L2_STD_ALL;
skeleton_fill_pix_format(skel, &skel->format); //和硬件相关
return 0;
}
static int skeleton_g_input(struct file *file, void *priv, unsigned int *i)
{
struct skeleton *skel = video_drvdata(file);
*i = skel->input;
return 0;
}
static const struct v4l2_ioctl_ops skel_ioctl_ops = {
.vidioc_g_input = skeleton_g_input,
.vidioc_s_input = skeleton_s_input,
};

2. SDTV Standards ioctls

vidioc_g_std和vidioc_s_std

获取/设置视频标准，在streaming状态下是不能做设置的。

static int skeleton_s_std(struct file *file, void *priv, v4l2_std_id std)
{
struct skeleton *skel = video_drvdata(file);
if (skel->input)
return -ENODATA;
if (std == skel->std)
return 0;
/* TODO: handle changing std */
skel->std = std;
skeleton_fill_pix_format(skel, &skel->format);
return 0;
}
static int skeleton_g_std(struct file *file, void *priv, v4l2_std_id *std)
{
struct skeleton *skel = video_drvdata(file);
if (skel->input)
return -ENODATA;
*std = skel->std;
return 0;
}
static const struct v4l2_ioctl_ops skel_ioctl_ops = {
.vidioc_g_std = skeleton_g_std,
.vidioc_s_std = skeleton_s_std,
};

vidioc_querystd

static int skeleton_querystd(struct file *file, void *priv,
v4l2_std_id *std)
{
struct skeleton *skel = video_drvdata(file);
if (skel->input)
return -ENODATA;
/* TODO: Query currently seen standard. */
return 0;
}
static const struct v4l2_ioctl_ops skel_ioctl_ops = {
.vidioc_querystd = skeleton_querystd,
};

3. DV Timings ioctls

vidioc_dv_timings_cap

static const struct v4l2_dv_timings_cap skel_timings_cap = {
.type = V4L2_DV_BT_656_1120,
/* keep this initialization for compatibility with GCC < 4.4.6 */
.reserved = { 0 },
V4L2_INIT_BT_TIMINGS(
720, 1920, /* min/max width */
480, 1080, /* min/max height */
27000000, 74250000, /* min/max pixelclock*/
V4L2_DV_BT_STD_CEA861, /* Supported standards */
/* capabilities */
V4L2_DV_BT_CAP_INTERLACED | V4L2_DV_BT_CAP_PROGRESSIVE
)
};
static int skeleton_dv_timings_cap(struct file *file, void *fh,
struct v4l2_dv_timings_cap *cap)
{
struct skeleton *skel = video_drvdata(file);
if (skel->input == 0)
return -ENODATA;
*cap = skel_timings_cap;
return 0;
}
static const struct v4l2_ioctl_ops skel_ioctl_ops = {
.vidioc_dv_timings_cap = skeleton_dv_timings_cap,
};


vidioc_s_dv_timings

static int skeleton_s_dv_timings(struct file *file, void *_fh,
struct v4l2_dv_timings *timings)
{
struct skeleton *skel = video_drvdata(file);
if (skel->input == 0)
return -ENODATA;
if (!v4l2_valid_dv_timings(timings, &skel_timings_cap, NULL,
NULL))
return -EINVAL;
if (!v4l2_find_dv_timings_cap(timings, &skel_timings_cap, 0, NULL,
NULL))
return -EINVAL;
if (v4l2_match_dv_timings(timings, &skel->timings, 0))
return 0;
/* TODO: Configure new timings */
skel->timings = *timings;
skeleton_fill_pix_format(skel, &skel->format);
return 0;
}
static const struct v4l2_ioctl_ops skel_ioctl_ops = {
.vidioc_s_dv_timings = skeleton_s_dv_timings,
};

vidioc_g_dv_timings & vidioc_enum_dv_timings

static int skeleton_g_dv_timings(struct file *file, void *_fh,
struct v4l2_dv_timings *timings)
{
struct skeleton *skel = video_drvdata(file);
if (skel->input == 0)
return -ENODATA;
*timings = skel->timings;
return 0;
}
static int skeleton_enum_dv_timings(struct file *file, void *_fh,
struct v4l2_enum_dv_timings *timings)
{
struct skeleton *skel = video_drvdata(file);
if (skel->input == 0)
return -ENODATA;
return v4l2_enum_dv_timings_cap(timings, &skel_timings_cap, NULL, NULL);
}
static const struct v4l2_ioctl_ops skel_ioctl_ops = {
.vidioc_g_dv_timings = skeleton_g_dv_timings,
.vidioc_enum_dv_timings = skeleton_enum_dv_timings,
};

vidioc_query_dv_timings

static int skeleton_query_dv_timings(struct file *file, void *_fh,
struct v4l2_dv_timings *timings)
{
struct skeleton *skel = video_drvdata(file);
if (skel->input == 0)
return -ENODATA;
/* TODO: Query currently seen timings. */
detect_timings();
if (no_signal)
return -ENOLINK;
if (cannot_lock_to_signal)
return -ENOLCK;
if (signal_out_of_range_of_capabilities)
return -ERANGE;
/* Useful for debugging */
if (debug)
v4l2_print_dv_timings(skel->v4l2_dev.name,
"query_dv_timings:",
timings, true);
return 0;
}
static const struct v4l2_ioctl_ops skel_ioctl_ops = {
.vidioc_query_dv_timings = skeleton_query_dv_timings,
};

4. Format ioctls 

static int skeleton_s_fmt_vid_cap(struct file *file, void *priv,
struct v4l2_format *f)
{
struct skeleton *skel = video_drvdata(file);
int ret;
ret = skeleton_try_fmt_vid_cap(file, priv, f);
if (ret)
return ret;
/* TODO: change format */
skel->format = f->fmt.pix;
return 0;
}
static int skeleton_g_fmt_vid_cap(struct file *file, void *priv,
struct v4l2_format *f)
{
struct skeleton *skel = video_drvdata(file);
f->fmt.pix = skel->format;
return 0;
}
static const struct v4l2_ioctl_ops skel_ioctl_ops = {
.vidioc_s_fmt_vid_cap = skeleton_s_fmt_vid_cap,
.vidioc_g_fmt_vid_cap = skeleton_g_fmt_vid_cap,
};


static int skeleton_enum_fmt_vid_cap(struct file *file, void *priv,
struct v4l2_fmtdesc *f)
{
if (f->index != 0)
return -EINVAL;
strlcpy(f->description, "4:2:2, packed, UYVY", sizeof(f-
>description));
f->pixelformat = V4L2_PIX_FMT_UYVY;
f->flags = 0;
return 0;
}
static const struct v4l2_ioctl_ops skel_ioctl_ops = {
.vidioc_enum_fmt_vid_cap = skeleton_enum_fmt_vid_cap,
};


static void skeleton_fill_pix_format(struct skeleton *skel, struct v4l2_pix_format *pix)
{
pix->pixelformat = V4L2_PIX_FMT_UYVY;
if (skel->input == 0) {
pix->width = 720;
pix->height = (skel->std & V4L2_STD_525_60) ? 480 : 576;
pix->field = V4L2_FIELD_INTERLACED;
pix->colorspace = V4L2_COLORSPACE_SMPTE170M;
} else {
pix->width = skel->timings.bt.width;
pix->height = skel->timings.bt.height;
if (skel->timings.bt.interlaced)
pix->field = V4L2_FIELD_INTERLACED;
else
pix->field = V4L2_FIELD_NONE;
pix->colorspace = V4L2_COLORSPACE_REC709;
}
pix->bytesperline = pix->width * 2;
pix->sizeimage = pix->bytesperline * pix->height;
pix->priv = 0;
}
static int skeleton_try_fmt_vid_cap(struct file *file, void *priv, struct v4l2_format *f)
{
struct skeleton *skel = video_drvdata(file);
struct v4l2_pix_format *pix = &f->fmt.pix;
if (pix->pixelformat != V4L2_PIX_FMT_UYVY)
return -EINVAL;
skeleton_fill_pix_format(skel, pix);
return 0;
}
static const struct v4l2_ioctl_ops skel_ioctl_ops = {
.vidioc_try_fmt_vid_cap = skeleton_try_fmt_vid_cap,
}



一文读懂V4L2（Video for Linux 2）框架
小灰灰的博客
11-26 3846
V4L2（Video for Linux 2）是Linux操作系统中用于支持摄像头和视频设备的框架。它提供了一组API和驱动程序接口，用于在Linux系统中进行视频采集、视频流处理和视频播放等操作。设备抽象层：V4L2框架提供了一个设备抽象层，使得应用程序可以与各种不同类型的视频设备进行通信，包括摄像头、视频采集卡等。统一的控制接口：V4L2定义了一套统一的控制接口，可以通过这些接口来配置和调整视频设备的各种参数，比如亮度、对比度、饱和度等。
Android Camera - v4l2编程接口ioctl调用流程
weixin_49303682的博客
05-27 1160
1.概念 octl 是设备驱动程序中设备控制接口函数，一个字符设备驱动通常会实现设备打开、关闭、读、写 等功能，在一些需要细分的情境下，如果需要扩展新的功能，通常以增设 ioctl() 命令的方式实现。 在文件 I/O 中，ioctl 扮演着重要角色，本文将以驱动开发为侧重点，从用户空间到内核空间纵向分 析 ioctl 函数。 2.用户空间 ioctl #include <sys/ioctl.h> int ioctl(int fd, int cmd, ...) ; 参数
linux V4L2子系统——v4l2的结构体（4）之ioctl， my write
小硕算法工程师
07-31 1130
在应用程序获取视频数据的流程中，都是通过 ioctl 命令与驱动程序进行交互，结合实际需求，实现struct v4l2_ioctl_ops相关的成员即可。//源码：include/media/v4l2-ioctl.h/*** output* capture*//**/
视频驱动V4L2子系统驱动架构 - ioctl
多媒体开发者
07-23 8370
文章系列 视频驱动V4L2子系统驱动架构 - 驱动框架 视频驱动V4L2子系统驱动架构 - ioctl 基于linux4.6.3,最后会附上一张ioctl调用总图，分析代码还是要用图来说明，这样更清晰一点，我就是这么分析的，不过平时分析的图很随便，而且很大，所以就不能在这里呈现，我在这里会贴出一个简略图 ioctl详解进入ioctl都是从cdev->ops->ioctl进入的，一般的驱动cde
「Linux C开发」--- V4L2
最新发布
m0_60616918的博客
05-14 638
一个字符设备驱动通常会实现设备打开、关闭、读、写等功能，在一些需要细分的情境下，如果需要扩展新的功能，通常以增设 ioctl() 命令的方式实现。由于之前申请buf的时候，确定了申请几块buf，所以这里新建buf的时候，可以指定其index，然后直接把这个新建的buf入队，实际上就是把之前已经分配好的编号为index的buf入队，之后的出队也是同理。），当指定了index时，驱动就知道要操纵哪个对应的mmap的缓冲区，就会把这个缓冲区入队。本身的数据，而是将 摄像头硬件的物理内存 映射到用户空间。
基于linux视频架构V4L2分析-----video for linux（一）
laoylhuli
12-06 3022
在linux内核版本中，2.6.38可谓是一个分水岭，在这之前linux视频架构采用v4l的架构，在2.6.38内核中去除了v4l采用全新的v4l2，v4l2架构不再兼容v4l。全新的API接口使用起来相当的方便。linux视频架构再次体现了linux驱动分层思想的优越性。         废话不讲，直接进入主题.         在linux中视频设备被当作一个文件设备来对待，视频设备存放在
V4L2源代码之旅八：ioctl
嵌入式开发专栏
11-10 1062
转自：http://www.cnblogs.com/ronnydm/p/5796821.html 我们从代码的角度看看，如何调用到我们设定的ioctl。 1. 我们在驱动程序中，分配了结构体struct video_device，并做了设定，然后调用video_register_device进行注册。在video_device的设置中，存在ioctl的设置。 /* kerne
linux V4L2子系统——v4l2的结构体（3）之v4l2_subdev-my write
小硕算法工程师
07-31 687
子设备，负责实现具体的功能。可将其抽象为具体的某一摄像头传感器，如OV7740、OV7251、OV5640等。每一个子设备驱动都必须有一个结构体，这个结构体可以作为独立的简单子设备存在，也可以嵌入到更大的结构体（自定义的子设备结构体）里面。通常会有一个由内核设置的低层次结构体（i2c_client，也就是上面说的 i2c 设备），它包含了一些设备数据，要调用来设置子设备私有数据指针指向它，这样的话就可以很方便的从 subdev 找到相关的 I2C 设备数据（这个要编程实现的时候才能够了解它的用意）。
v4l2_1.zip_v4l2_升级linux应用
09-23
V4L2（Video for Linux Two）是Linux内核中用于处理视频输入和输出的一组API，它在V4L（Video for Linux）的基础上进行了重大改进和扩展，以适应更广泛的硬件兼容性和功能需求。V4L2不仅适用于摄像头和其他视频捕获...
Linux V4L2子系统-videobuf2框架分析（三）_v4l2 memory dma
2401_86023761的博客
08-26 423
【代码】Linux V4L2子系统-videobuf2框架分析（三）_v4l2 memory dma。
基于linux视频架构V4L2分析-----video for linux（二）
laoylhuli
12-06 1945
V4L2跟V4L有较大的改动，已经称为3.0的接口标准，涵盖了大多数的视频或其它dvd和FM等驱动，都向V4L2靠拢。V4L2采用流水线的操作方式，基本遵循了打开视频设备文件、设置视频格式、处理视频数据、关闭视频设备，其中用到的函数寥寥无几，open，read，write，ioctl等来实现。         1、打开视频设备文件          在linux系统中所有的设备都被看成是一个文
Video4Linux框架简介(1)
htjacky的专栏
02-08 2175
原作者：Hans Verkuil 特性与架构   特性 ●视频捕获/输出和调谐（/ dev /videoX，流和控制） ●视频捕获和输出覆盖（/ dev / videoX，控制） ●内存到内存（也称为编解码器）设备（/ dev / videoX，streaming和控制） ●原始和切分VBI捕获和输出（/ dev /vbiX，streaming和控制） ●无线电
Video4Linux框架简介(6) - 控制框架
htjacky的专栏
02-10 1346
V4L2 PCI驱动实例控制框架 译注：在图像传输开始后，会有各种各样的控制参数需要下发给硬件，譬如brightness, contrast等。 首先，要增加如下的控制处理回调函数，一些芯片厂商把kernel驱动做小，很多就依赖event机制在userspace侧处理。 #include #include struct skeleton { ... struct v4l2
Linux V4L2子系统-videobuf2框架分析
嵌入式Linux
08-21 1659
一、概述：Video设备产生的数据较多，传统的缓冲机制已不能满足需求。为此，Linux内核抽象出了videobuf2机制，用于管理存放视频图像的帧缓冲。videobuf2抽象层像一座桥梁，将用户空间和V4L2 driver连接起来。videobuf2抽象层向用户空间提供了标准POSIX I/O系统调用，包括read、poll及mmap等，同时还提供了大量与流式I/O相关的V4L2 ioctl调用，...
linux V4L2子系统——v4l2的结构体（4）之ioctl
枫潇潇
03-19 2514
在应用程序获取视频数据的流程中，都是通过 ioctl 命令与驱动程序进行交互，结合实际需求，实现struct v4l2_ioctl_ops相关的成员即可。
V4L2 调试之(四)
tugouxp的专栏
07-09 1812
1.V4l2 架构 结束
v4l2 ioctl框架分析
win9
08-24 2317
v4l2的ioctl框架由drivers/media/v4l2-ioctl.c实现 涉及到的结构体： struct v4l2_ioctl_ops { /* ioctl callbacks */ /* VIDIOC_QUERYCAP handler */ int (*vidioc_querycap)(struct file *file, void *fh, struct v4l2_cap
v4l2 ioctl 学习总结
lzj_lzj2014的博客
12-11 1672
你可能观察到用户空间对V4L2设备的操作基本都是ioctl来实现的，V4L2设备都有大量可操作的功能(配置寄存器)，所以V4L2的ioctl也是十分庞大的。它是一个怎样的框架，是怎么实现的呢？          Ioctl框架是由v4l2_ioctl.c文件实现，文件中定义结构体数组v4l2_ioctls，可以看做是ioctl指令和回调函数的关系表。用户空间调用系统调用ioctl，传递下来i
v4l2_ioctl_ops
04-12
v4l2_ioctl_ops是一个结构体，用于定义V4L2设备驱动程序中的ioctl操作。它包含了一组函数指针，每个函数指针对应一个ioctl操作的处理函数。这些函数指针定义了V4L2设备驱动程序对不同ioctl操作的支持。 以下是v4l2_ioctl_ops结构体的定义[^1]： ```c struct v4l2_ioctl_ops { int (*vidioc_querycap)(struct file *file, void *fh, struct v4l2_capability *cap); int (*vidioc_enum_fmt_vid_cap)(struct file *file, void *fh, struct v4l2_fmtdesc *f); int (*vidioc_g_fmt_vid_cap)(struct file *file, void *fh, struct v4l2_format *f); int (*vidioc_try_fmt_vid_cap)(struct file *file, void *fh, struct v4l2_format *f); int (*vidioc_s_fmt_vid_cap)(struct file *file, void *fh, struct v4l2_format *f); // 其他函数指针... }; ``` 这些函数指针对应了一些常见的ioctl操作，例如查询设备能力、枚举视频格式、获取和设置视频格式等。每个函数指针都有相应的参数，用于传递文件句柄、设备句柄和操作所需的数据结构。 通过使用v4l2_ioctl_ops结构体，V4L2设备驱动程序可以根据不同的ioctl操作调用相应的处理函数，从而实现对V4L2设备的控制和配置。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值