26  * Video buffers queue management.
32  * the videobuf2 queue operations by serializing calls to videobuf2 and a
33  * spinlock to protect the IRQ queue that holds the buffers to be processed by
38  * videobuf2 queue operations
45 	struct uvc_video_queue *queue = vb2_get_drv_priv(vq);  in uvc_queue_setup()  local
46 	struct uvc_video *video = container_of(queue, struct uvc_video, queue);  in uvc_queue_setup()
130 				    struct uvc_video_queue *queue)  in uvc_buffer_mem_prepare()  argument
132 	struct uvc_video *video = container_of(queue, struct uvc_video, queue);  in uvc_buffer_mem_prepare()
150 	struct uvc_video_queue *queue = vb2_get_drv_priv(vb->vb2_queue);  in uvc_buffer_prepare()  local
160 	if (unlikely(queue->flags & UVC_QUEUE_DISCONNECTED))  in uvc_buffer_prepare()
165 	buf->mem = uvc_buffer_mem_prepare(vb, queue);  in uvc_buffer_prepare()
182 	struct uvc_video_queue *queue = vb2_get_drv_priv(vb->vb2_queue);  in uvc_buffer_queue()  local
187 	spin_lock_irqsave(&queue->irqlock, flags);  in uvc_buffer_queue()
189 	if (likely(!(queue->flags & UVC_QUEUE_DISCONNECTED))) {  in uvc_buffer_queue()
190 		list_add_tail(&buf->queue, &queue->irqqueue);  in uvc_buffer_queue()
199 	spin_unlock_irqrestore(&queue->irqlock, flags);  in uvc_buffer_queue()
210 int uvcg_queue_init(struct uvc_video_queue *queue, enum v4l2_buf_type type,  in uvcg_queue_init()  argument
215 	queue->queue.type = type;  in uvcg_queue_init()
216 	queue->queue.io_modes = VB2_MMAP | VB2_USERPTR | VB2_DMABUF;  in uvcg_queue_init()
217 	queue->queue.drv_priv = queue;  in uvcg_queue_init()
218 	queue->queue.buf_struct_size = sizeof(struct uvc_buffer);  in uvcg_queue_init()
219 	queue->queue.ops = &uvc_queue_qops;  in uvcg_queue_init()
220 	queue->queue.lock = lock;  in uvcg_queue_init()
221 	queue->queue.mem_ops = &vb2_vmalloc_memops;  in uvcg_queue_init()
222 	queue->queue.timestamp_flags = V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC  in uvcg_queue_init()
230 	queue->queue.allow_zero_bytesused = 1;  in uvcg_queue_init()
232 	ret = vb2_queue_init(&queue->queue);  in uvcg_queue_init()
236 	spin_lock_init(&queue->irqlock);  in uvcg_queue_init()
237 	INIT_LIST_HEAD(&queue->irqqueue);  in uvcg_queue_init()
238 	queue->flags = 0;  in uvcg_queue_init()
246 void uvcg_free_buffers(struct uvc_video_queue *queue)  in uvcg_free_buffers()  argument
248 	vb2_queue_release(&queue->queue);  in uvcg_free_buffers()
254 int uvcg_alloc_buffers(struct uvc_video_queue *queue,  in uvcg_alloc_buffers()  argument
259 	ret = vb2_reqbufs(&queue->queue, rb);  in uvcg_alloc_buffers()
264 int uvcg_query_buffer(struct uvc_video_queue *queue, struct v4l2_buffer *buf)  in uvcg_query_buffer()  argument
266 	return vb2_querybuf(&queue->queue, buf);  in uvcg_query_buffer()
269 int uvcg_queue_buffer(struct uvc_video_queue *queue, struct v4l2_buffer *buf)  in uvcg_queue_buffer()  argument
271 	return vb2_qbuf(&queue->queue, NULL, buf);  in uvcg_queue_buffer()
278 int uvcg_dequeue_buffer(struct uvc_video_queue *queue, struct v4l2_buffer *buf,  in uvcg_dequeue_buffer()  argument
281 	return vb2_dqbuf(&queue->queue, buf, nonblocking);  in uvcg_dequeue_buffer()
285  * Poll the video queue.
287  * This function implements video queue polling and is intended to be used by
290 __poll_t uvcg_queue_poll(struct uvc_video_queue *queue, struct file *file,  in uvcg_queue_poll()  argument
293 	return vb2_poll(&queue->queue, file, wait);  in uvcg_queue_poll()
296 int uvcg_queue_mmap(struct uvc_video_queue *queue, struct vm_area_struct *vma)  in uvcg_queue_mmap()  argument
298 	return vb2_mmap(&queue->queue, vma);  in uvcg_queue_mmap()
307 unsigned long uvcg_queue_get_unmapped_area(struct uvc_video_queue *queue,  in uvcg_queue_get_unmapped_area()  argument
310 	return vb2_get_unmapped_area(&queue->queue, 0, 0, pgoff, 0);  in uvcg_queue_get_unmapped_area()
315  * Cancel the video buffers queue.
317  * Cancelling the queue marks all buffers on the irq queue as erroneous,
318  * wakes them up and removes them from the queue.
326 void uvcg_queue_cancel(struct uvc_video_queue *queue, int disconnect)  in uvcg_queue_cancel()  argument
331 	spin_lock_irqsave(&queue->irqlock, flags);  in uvcg_queue_cancel()
332 	while (!list_empty(&queue->irqqueue)) {  in uvcg_queue_cancel()
333 		buf = list_first_entry(&queue->irqqueue, struct uvc_buffer,  in uvcg_queue_cancel()
334 				       queue);  in uvcg_queue_cancel()
335 		list_del(&buf->queue);  in uvcg_queue_cancel()
339 	queue->buf_used = 0;  in uvcg_queue_cancel()
345 	 * state outside the queue code.  in uvcg_queue_cancel()
348 		queue->flags |= UVC_QUEUE_DISCONNECTED;  in uvcg_queue_cancel()
349 	spin_unlock_irqrestore(&queue->irqlock, flags);  in uvcg_queue_cancel()
353  * Enable or disable the video buffers queue.
355  * The queue must be enabled before starting video acquisition and must be
356  * disabled after stopping it. This ensures that the video buffers queue
360  * Enabling the video queue initializes parameters (such as sequence number,
361  * sync pattern, ...). If the queue is already enabled, return -EBUSY.
363  * Disabling the video queue cancels the queue and removes all buffers from
364  * the main queue.
369 int uvcg_queue_enable(struct uvc_video_queue *queue, int enable)  in uvcg_queue_enable()  argument
375 		ret = vb2_streamon(&queue->queue, queue->queue.type);  in uvcg_queue_enable()
379 		queue->sequence = 0;  in uvcg_queue_enable()
380 		queue->buf_used = 0;  in uvcg_queue_enable()
382 		ret = vb2_streamoff(&queue->queue, queue->queue.type);  in uvcg_queue_enable()
386 		spin_lock_irqsave(&queue->irqlock, flags);  in uvcg_queue_enable()
387 		INIT_LIST_HEAD(&queue->irqqueue);  in uvcg_queue_enable()
391 		 * applications will be able to queue buffers for the next  in uvcg_queue_enable()
395 		queue->flags &= ~UVC_QUEUE_DISCONNECTED;  in uvcg_queue_enable()
396 		spin_unlock_irqrestore(&queue->irqlock, flags);  in uvcg_queue_enable()
403 struct uvc_buffer *uvcg_queue_next_buffer(struct uvc_video_queue *queue,  in uvcg_queue_next_buffer()  argument
408 	if ((queue->flags & UVC_QUEUE_DROP_INCOMPLETE) &&  in uvcg_queue_next_buffer()
415 	list_del(&buf->queue);  in uvcg_queue_next_buffer()
416 	if (!list_empty(&queue->irqqueue))  in uvcg_queue_next_buffer()
417 		nextbuf = list_first_entry(&queue->irqqueue, struct uvc_buffer,  in uvcg_queue_next_buffer()
418 					   queue);  in uvcg_queue_next_buffer()
423 	buf->buf.sequence = queue->sequence++;  in uvcg_queue_next_buffer()
432 struct uvc_buffer *uvcg_queue_head(struct uvc_video_queue *queue)  in uvcg_queue_head()  argument
436 	if (!list_empty(&queue->irqqueue))  in uvcg_queue_head()
437 		buf = list_first_entry(&queue->irqqueue, struct uvc_buffer,  in uvcg_queue_head()
438 				       queue);  in uvcg_queue_head()