简介
因为在qcom平台上和linux原生都是用的v4l2框架作为camera的驱动框架，所以本着学习记录的笔记，做了如下文档记录。
该文档是学习《卫东山老师视频教程第三期》的个人学习笔记，非常感谢老师的资料。该记录仅供学习交流，如有侵犯到大家利益，还望海涵，请联系博主删除。
buffer队列操作
首先是填充了队列相关的4个函数：
static int myvivi_vidioc_reqbufs(struct file *file, void *priv,
struct v4l2_requestbuffers *p){
return (videobuf_reqbufs(&myvivi_vb_vidqueue, p));
}
static int myvivi_vidioc_querybuf(struct file *file, void *priv, struct v4l2_buffer *p){
return (videobuf_querybuf(&myvivi_vb_vidqueue, p));
}
static int myvivi_vidioc_qbuf(struct file *file, void *priv, struct v4l2_buffer *p){
return (videobuf_qbuf(&myvivi_vb_vidqueue, p));
}
static int myvivi_vidioc_dqbuf(struct file *file, void *priv, struct v4l2_buffer *p){
return (videobuf_dqbuf(&myvivi_vb_vidqueue, p,
file->f_flags & O_NONBLOCK));
}
static int myvivi_vidioc_streamon(struct file *file, void *priv, enum v4l2_buf_type i){
return videobuf_streamon(&myvivi_vb_vidqueue);
}
static int myvivi_vidioc_streamoff(struct file *file, void *priv, enum v4l2_buf_type i){
videobuf_streamoff(&myvivi_vb_vidqueue);
return 0;
}
static const struct v4l2_ioctl_ops myvivi_ioctl_ops = {
.................
/* 缓冲区操作: 申请/查询/放入队列/取出队列 */
.vidioc_reqbufs = myvivi_vidioc_reqbufs,
.vidioc_querybuf = myvivi_vidioc_querybuf,
.vidioc_qbuf = myvivi_vidioc_qbuf,
.vidioc_dqbuf = myvivi_vidioc_dqbuf,
// 启动/停止
.vidioc_streamon = myvivi_vidioc_streamon,
.vidioc_streamoff = myvivi_vidioc_streamoff,
}
这四个队列相关函数分别用在申请队列、查询队列、放入队列、取出队列、启动和停止的相关buffer数据操作中，都是直接使用的v4l2提供的现成函数
初始化和销毁buffer队列
前面说到了对buffer队列的操作,操作的队列为myvivi_vb_vidqueue，那么在使用它之前，肯定有初始化的操作；在使用完了之后有销毁的操作。
对应的操作函数在：
static struct videobuf_queue myvivi_vb_vidqueue;
static int myvivi_open(struct file *file){
/* 队列操作2: 初始化 */
videobuf_queue_vmalloc_init(&myvivi_vb_vidqueue, &myvivi_video_qops,
NULL, &myvivi_queue_slock, V4L2_BUF_TYPE_VIDEO_CAPTURE, V4L2_FIELD_INTERLACED,
sizeof(struct videobuf_buffer), NULL, &lock); /* 倒数第3个参数是buffer的头部大小 */
return 0;
}
static int myvivi_close(struct file *file){
videobuf_stop(&myvivi_vb_vidqueue);
videobuf_mmap_free(&myvivi_vb_vidqueue);
return 0;
}
static int myvivi_mmap(struct file *file, struct vm_area_struct *vma){
return videobuf_mmap_mapper(&myvivi_vb_vidqueue, vma);
}
static const struct v4l2_file_operations myvivi_fops = {
.owner = THIS_MODULE,
.open = myvivi_open,
.release = myvivi_close,
.mmap = myvivi_mmap,
.ioctl = video_ioctl2, /* V4L2 ioctl handler */
};
在open函数中，利用videobuf_queue_vmalloc_init对myvivi_vb_vidqueue队列进行了初始化，并且分配了队列头的空间大小，和关联了该队列的
一个相关操作函数myvivi_video_qops。
在close函数中，先停止了myvivi_vb_vidqueue队列的使用，然后释放掉它。
在myvivi_mmap函数中，为队列myvivi_vb_vidqueue分配真正的数据空间，前面的open函数只分配了数据头的空间。
关联的myvivi_video_qops
前面讲到在open函数的videobuf_queue_vmalloc_init初始化的时候关联了一个myvivi_video_qops操作函数。
对应的代码如下：
/* 参考documentations/video4linux/v4l2-framework.txt:
* drivers\media\video\videobuf-core.c
ops->buf_setup - calculates the size of the video buffers and avoid they
to waste more than some maximum limit of RAM;
ops->buf_prepare - fills the video buffer structs and calls
videobuf_iolock() to alloc and prepare mmaped memory;
ops->buf_queue - advices the driver that another buffer were
requested (by read() or by QBUF);
ops->buf_release - frees any buffer that were allocated.
*/
static struct list_head myvivi_vb_local_queue;
/* ------------------------------------------------------------------
Videobuf operations
------------------------------------------------------------------*/
/* APP调用ioctl VIDIOC_REQBUFS时会导致此函数被调用,
* 它重新调整count和size
*/
static int myvivi_buffer_setup(struct videobuf_queue *vq, unsigned int *count, unsigned int *size)
{
*size = myvivi_format.fmt.pix.sizeimage;
if (0 == *count)
*count = 32;
return 0;
}
/* APP调用ioctlVIDIOC_QBUF时导致此函数被调用,
* 它会填充video_buffer结构体并调用videobuf_iolock来分配内存(只有在V4L2_MEMORY_USERPTR，也就是在用户空间的应用中开辟时候才会
× 使用它来分配内存，这里是使用的类型为:V4L2_MEMORY_MMAP，在内核空间开辟的,所以不需要使用videobuf_iolock)
*
*/
static int myvivi_buffer_prepare(struct videobuf_queue *vq, struct videobuf_buffer *vb,
enum v4l2_field field){
vb->state = VIDEOBUF_PREPARED;
return 0;
}
/* APP调用ioctl VIDIOC_QBUF时:
* 1. 先调用buf_prepare进行一些准备工作
* 2. 把buf放入stream队列
* 3. 调用buf_queue(起通知、记录作用)
*/
static void myvivi_buffer_queue(struct videobuf_queue *vq, struct videobuf_buffer *vb)
{
vb->state = VIDEOBUF_QUEUED;
/* 把videobuf放入本地一个队列尾部
*/
list_add_tail(&vb->queue, &myvivi_vb_local_queue);
}
/* APP不再使用队列时, 用它来释放内存 */
static void myvivi_buffer_release(struct videobuf_queue *vq,
struct videobuf_buffer *vb)
{
videobuf_vmalloc_free(vb);
vb->state = VIDEOBUF_NEEDS_INIT;
}
static struct videobuf_queue_ops myvivi_video_qops = {
.buf_setup = myvivi_buffer_setup, /* 计算大小以免浪费 */
.buf_prepare = myvivi_buffer_prepare,
.buf_queue = myvivi_buffer_queue,
.buf_release = myvivi_buffer_release,
};
myvivi_buffer_setup:用来计算需要分配的数据空间大小和空间的多少，如代码所示，我们设置的数据空间大小为之前计算出来的image size的大小，
分配的空间为32个（一般来说分配空间的范围为2-32个）。
myvivi_buffer_prepare:进行一些qbuffer之前的准备操作，并将队列状态改变为VIDEOBUF_PREPARED。
myvivi_buffer_queue：将队列中的数据放入一个本地队列中，等待被取走，同时将队列状态改变为VIDEOBUF_QUEUED。
myvivi_buffer_release:释放掉队列，同时将它状态改变为初始状态：VIDEOBUF_NEEDS_INIT。
调用关系
1、应用程序首先调用了open函数，初始化了videobuf_queue队列。
2、调用请求队列操作函数：
myvivi_vidioc_reqbufs-->videobuf_reqbufs(&myvivi_vb_vidqueue, p)
在videobuf_reqbufs函数中又调用了之前在open-->videobuf_queue_vmalloc_init函数中关联的
myvivi_video_qops-->myvivi_buffer_setup
获得了需要分配的队列数据空间大小和空间块数。
3、调用请求队列操作函数：
myvivi_vidioc_querybufs-->videobuf_querybuf
在该函数中查询和返回队列相关信息。
4、调用函数：
myvivi_fops-->myvivi_mmap-->videobuf_mmap_mapper
为队列分配真正的数据空间。
5、调用操作函数：
myvivi_vidioc_qbufs-->videobuf_qbuf
在函数videobuf_qbuf中又调用到:
myvivi_video_qops-->myvivi_buffer_prepare
myvivi_video_qops-->myvivi_buffer_queue
在函数myvivi_buffer_prepare中进行一些准备工作，然后在myvivi_buffer_queue中将队列中的数据保存到本地队列myvivi_vb_local_queue中。
6、调用操作函数：
yvivi_vidioc_qbufs-->myvivi_vidioc_dqbuf
在myvivi_vidioc_dqbuf中，清除掉已经使用过了的队列数据。
7、利用select/poll机制检测，让步骤5和6不断循环，使得video数据不停的刷新。
