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

Linux v4l2架构学习总链接

gitee源码

VIDIOC_QUERYBUF(查询缓存信息)

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

static int __verify_planes_array(struct vb2_buffer *vb, const struct v4l2_buffer *b)
{
	/* 非NPLANE这里直接返回 */
	if (!V4L2_TYPE_IS_MULTIPLANAR(b->type))
		return 0;

	/* 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);
	    }
	}