mplane方式v4l2应用分析 -- VIDIOC_QUERYBUF(查询缓存信息)

Linux v4l2架构学习总链接

gitee源码

VIDIOC_QUERYBUF(查询缓存信息)

同样的还是先看从应用调用vivi驱动分析v4l2 – 查询（VIDIOC_QUERYBUF）缓存信息
在vb2_querybuf中，之前没有分析__verify_planes_array

/* Is memory for copying plane information present? */
/* 注意：
 * b->m.planes是用户空间传入的，用于保存mplane的信息
 */
if (b->m.planes == NULL) {
	dprintk(1, "multi-planar buffer passed but planes array not provided\n");
	return -EINVAL;
}

/* 对于length
 * NO-MPLANE的时候 单平面缓冲区的缓冲区大小（不是其有效载荷，有效值和总大小不一定相等）
 * MPLANE的时候：多平面缓冲区的平面数组中的元素数（应该就是num_planes的值） 
 */
if (b->length < vb->num_planes || b->length > VB2_MAX_PLANES) {
	dprintk(1, "incorrect planes array length, expected %d, got %d\n",
		vb->num_planes, b->length);
	return -EINVAL;
}

return 0;

}
所以说，对于MPLANE，这里加了一个判断，接着看__fill_v4l2_buffer
static void __fill_v4l2_buffer(struct vb2_buffer *vb, void *pb)
{
struct v4l2_buffer *b = pb;
struct vb2_v4l2_buffer *vbuf = to_vb2_v4l2_buffer(vb);
struct vb2_queue *q = vb->vb2_queue;
unsigned int plane;

/* Copy back data such as timestamp, flags, etc. */
b->index = vb->index;
b->type = vb->type;
b->memory = vb->memory;
b->bytesused = 0;

b->flags = vbuf->flags;
b->field = vbuf->field;
b->timestamp = ns_to_timeval(vb->timestamp);
b->timecode = vbuf->timecode;
b->sequence = vbuf->sequence;
b->reserved2 = 0;
b->reserved = 0;

/* 重点看这里 */
if (q->is_multiplanar) {
	/*
	 * Fill in plane-related data if userspace provided an array
	 * for it. The caller has already verified memory and size.
	 */
	/* 对于length，这里直接被赋值 num_planes
	 * 所以说应用传入的时候要大于等于num_planes
	 */
	b->length = vb->num_planes;
	/* 应用代码中要根据planes的数量，合理申请m.planes的空间大小 */
	for (plane = 0; plane < vb->num_planes; ++plane) {
		/* pdst是用户空间传入的 */
		struct v4l2_plane *pdst = &b->m.planes[plane];
		/* psrc是内核空间已经申请的 */
		struct vb2_plane *psrc = &vb->planes[plane];

		pdst->bytesused = psrc->bytesused;
		pdst->length = psrc->length;
		if (q->memory == VB2_MEMORY_MMAP)
			/* 可以看到 offset是放在m.mem_offset中返回用户空间的 */
			pdst->m.mem_offset = psrc->m.offset;
		else if (q->memory == VB2_MEMORY_USERPTR)
			pdst->m.userptr = psrc->m.userptr;
		else if (q->memory == VB2_MEMORY_DMABUF)
			pdst->m.fd = psrc->m.fd;
		/* 对于data_offset, 没有看到相关的操作 
		 * 对于这个变量，注释如下
		 * @data_offset:	offset in the plane to the start of data; usually 0,
		 * unless there is a header in front of the data
		 */
		pdst->data_offset = psrc->data_offset;
		memset(pdst->reserved, 0, sizeof(pdst->reserved));
	}
} else {
	... ...
}

编写对应的应用代码
struct v4l2_plane* planes_buffer;
num_planes = fmt.fmt.pix_mp.num_planes;

/* planes_buffer 的大小要根据plane地个数*/
planes_buffer = calloc(num_planes, sizeof(*planes_buffer));

for(i = 0; i < req.count; i++) {
    memset(&buf, 0, sizeof(buf));
    memset(planes_buffer, 0, sizeof(*planes_buffer));
    buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE;
    buf.memory = V4L2_MEMORY_MMAP;
    buf.m.planes = planes_buffer;
    /* 网上很多代码，直接将length置为1，这是不对的
     * 虽然很多sensor plane个数为1
     */
    buf.length = num_planes;
    buf.index = i;
    if (-1 == ioctl (fd, VIDIOC_QUERYBUF, &buf)) {
        printf("Querybuf fail\n");
        goto err;
    }

		/* 打印每个plane的信息 */
		/* 之前也分析过，offset的作用其实就是找到对应的buffer，mplane的话就是找到对应的plane */
    for(j = 0; j < num_planes; j++) {
        printf("plane[%d]: length = %d\n", j, (planes_buffer + j)->length);
        printf("plane[%d]: offset = %d\n", j, (planes_buffer + j)->m.mem_offset);
    }
}