v4l2loopback 技术文档

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 的基本说明，帮助用户更好地使用和理解该项目。