首页
/ v4l2loopback 技术文档

v4l2loopback 技术文档

2024-12-14 00:05:57作者:裴麒琰

1. 安装指南

环境依赖

  • 确保您的系统具有一个正常工作的编译环境(编译器、GNU make等)。
  • 安装与当前运行内核版本相匹配的内核头文件。

编译模块

  1. 克隆或下载 v4l2loopback 模块源码。
  2. 在源码目录中执行以下命令编译模块:
    $ make
    
    这将生成一个名为 v4l2loopback.ko 的内核模块文件。

安装模块

  1. 使用以下命令安装模块(可能需要 root 权限):
    $ sudo make install
    $ sudo depmod -a
    
    如果您的系统没有 sudo,则需要切换到 root 用户进行安装。

2. 项目的使用说明

加载模块

  1. 使用以下命令作为 root 用户加载 v4l2loopback 模块:
    # modprobe v4l2loopback
    
    或者使用 sudo
    $ sudo modprobe v4l2loopback
    

查看设备

加载模块后,可以通过列出 /sys/devices/virtual/video4linux 目录的内容来查看创建的 loopback 设备。

测试

可以通过多种程序(如 GStreamer-1.0 或 Gem(>=0.93))向 v4l2loopback 设备发送数据,并由其他 V4L2 兼容应用程序接收。

3. 项目API使用文档

v4l2loopback 模块提供了几个 sysfs 属性和 V4L2 控件,可以通过这些接口改变设备的运行时行为。

属性设置与查询

可以通过 sysfs 接口设置和查询每个设备的属性,例如:

$ cat /sys/devices/virtual/video4linux/video0/keep_format
0

V4L2 控件

使用 v4l2-ctl 工具可以列出和设置 V4L2 控制项:

$ v4l2-ctl -d /dev/video0 -l

设置帧率 (FPS)

$ v4l2loopback-ctl set-fps /dev/video0 25

设置格式

$ v4l2loopback-ctl set-caps /dev/video0 "UYVY:640x480"

设置流超时

$ v4l2-ctl -d /dev/video0 -c timeout=3000

设置超时图像

$ v4l2loopback-ctl set-timeout-image -t 3000 /dev/video0 service-unavailable.png

4. 项目安装方式

动态设备管理

可以使用 v4l2loopback-ctl 工具动态地创建和删除 loopback 设备。

创建设备

$ sudo v4l2loopback-ctl add -n "loopy doopy" /dev/video7

删除设备

$ sudo v4l2loopback-ctl delete /dev/video7

以上文档提供了 v4l2loopback 的安装、使用和 API 的基本说明,帮助用户更好地使用和理解该项目。

登录后查看全文