一、用V4L2获取摄像头视频的核心流程 #

V4L2是Linux原生的视频设备操作接口，全程靠文件IO和ioctl系统调用和硬件交互，我给你梳理下最核心的步骤：

• 打开视频设备：用open()函数打开/dev/videoX（X是设备序号，你可以用v4l2-ctl --list-devices查看自己的摄像头对应哪个编号），记得加上O_RDWR读写权限。
• 验证设备能力：通过VIDIOC_QUERYCAP这个ioctl命令，填充struct v4l2_capability结构体，确认设备支持V4L2_CAP_VIDEO_CAPTURE（视频捕获）和V4L2_CAP_STREAMING（流模式）这两个能力。
• 配置视频格式：构造struct v4l2_format结构体，设置像素格式（比如常用的V4L2_PIX_FMT_YUYV或V4L2_PIX_FMT_MJPEG）、分辨率（比如640x480），然后用VIDIOC_S_FMT命令把配置推给设备。
• 申请并映射缓冲区：用VIDIOC_REQBUFS请求内核分配若干个缓冲区（一般3-4个足够），然后通过mmap()把每个内核缓冲区映射到用户空间，这样就能直接读写数据，不用额外拷贝，效率更高。
• 启动视频流：调用VIDIOC_STREAMON命令开始捕获视频数据。
• 循环读取帧数据：用VIDIOC_DQBUF取出已经被设备填充好数据的缓冲区，处理完帧数据（比如解码、显示）后，再用VIDIOC_QBUF把缓冲区放回队列，重复这个循环。
• 停止并清理资源：捕获结束时，用VIDIOC_STREAMOFF停止流，然后依次munmap()释放每个映射的缓冲区，最后close()关闭设备文件。

二、V4L2示例代码编译问题排查 #

编译V4L2代码时踩的坑基本都是依赖缺失或者编译参数不对，按这个顺序排查准没错：

1. 安装必要的依赖包
   • V4L2的核心头文件linux/videodev2.h和链接库一般在libv4l-dev包（Debian/Ubuntu系）或者v4l-utils-devel包（RHEL/CentOS系）里，直接用包管理器安装：

     # Debian/Ubuntu
     sudo apt install libv4l-dev v4l2-utils
     # CentOS/RHEL
     sudo dnf install v4l-utils-devel
     

   • v4l2-utils还能帮你调试设备，比如用v4l2-ctl --list-formats-ext查看摄像头支持的格式和分辨率。
2. 添加正确的编译参数
   • 编译时必须链接V4L2的库，也就是加上-lv4l2参数，如果代码里用到了数学运算（比如图像转换），还要加-lm；如果用到多线程，得加-pthread。举个编译单文件的例子：

     gcc v4l2_capture.c -o v4l2_capture -lv4l2 -lm
     

   • 如果你的代码依赖其他库（比如用SDL显示视频），还要加上对应的链接参数，比如-lSDL2。
3. 头文件引用问题
   • 如果编译时报fatal error: linux/videodev2.h: No such file or directory，除了安装依赖，还要确认头文件路径是否在编译器的搜索路径里，要是在非标准目录，用-I参数指定，比如-I/usr/local/include。
   • 注意别用旧版的videodev.h头文件了，现在V4L2统一用linux/videodev2.h，代码里的引用要改过来。
4. 预编译宏的问题
   • 有些代码需要定义_GNU_SOURCE宏才能使用V4L2的全部功能，编译时可以加上-D_GNU_SOURCE参数，比如：

     gcc v4l2_capture.c -o v4l2_capture -D_GNU_SOURCE -lv4l2 -lm
     

内容的提问来源于stack exchange，提问作者ajayramesh