1/* SPDX-License-Identifier: GPL-2.0 */
 2#ifndef _UVC_QUEUE_H_
 3#define _UVC_QUEUE_H_
 4
 5#include <linux/list.h>
 6#include <linux/poll.h>
 7#include <linux/spinlock.h>
 8
 9#include <media/videobuf2-v4l2.h>
10
11struct file;
12struct mutex;
13
14/* Maximum frame size in bytes, for sanity checking. */
15#define UVC_MAX_FRAME_SIZE	(16*1024*1024)
16/* Maximum number of video buffers. */
17#define UVC_MAX_VIDEO_BUFFERS	32
18
19/* ------------------------------------------------------------------------
20 * Structures.
21 */
22
23enum uvc_buffer_state {
24	UVC_BUF_STATE_IDLE	= 0,
25	UVC_BUF_STATE_QUEUED	= 1,
26	UVC_BUF_STATE_ACTIVE	= 2,
27	UVC_BUF_STATE_DONE	= 3,
28	UVC_BUF_STATE_ERROR	= 4,
29};
30
31struct uvc_buffer {
32	struct vb2_v4l2_buffer buf;
33	struct list_head queue;
34
35	enum uvc_buffer_state state;
36	void *mem;
 
 
 
37	unsigned int length;
38	unsigned int bytesused;
 
 
39};
40
41#define UVC_QUEUE_DISCONNECTED		(1 << 0)
42#define UVC_QUEUE_DROP_INCOMPLETE	(1 << 1)
43#define UVC_QUEUE_PAUSED		(1 << 2)
44
45struct uvc_video_queue {
46	struct vb2_queue queue;
47
48	unsigned int flags;
49	__u32 sequence;
50
51	unsigned int buf_used;
52
 
 
53	spinlock_t irqlock;	/* Protects flags and irqqueue */
54	struct list_head irqqueue;
55};
56
57static inline int uvc_queue_streaming(struct uvc_video_queue *queue)
58{
59	return vb2_is_streaming(&queue->queue);
60}
61
62int uvcg_queue_init(struct uvc_video_queue *queue, enum v4l2_buf_type type,
63		    struct mutex *lock);
64
65void uvcg_free_buffers(struct uvc_video_queue *queue);
66
67int uvcg_alloc_buffers(struct uvc_video_queue *queue,
68		       struct v4l2_requestbuffers *rb);
69
70int uvcg_query_buffer(struct uvc_video_queue *queue, struct v4l2_buffer *buf);
71
72int uvcg_queue_buffer(struct uvc_video_queue *queue, struct v4l2_buffer *buf);
73
74int uvcg_dequeue_buffer(struct uvc_video_queue *queue,
75			struct v4l2_buffer *buf, int nonblocking);
76
77__poll_t uvcg_queue_poll(struct uvc_video_queue *queue,
78			     struct file *file, poll_table *wait);
79
80int uvcg_queue_mmap(struct uvc_video_queue *queue, struct vm_area_struct *vma);
81
82#ifndef CONFIG_MMU
83unsigned long uvcg_queue_get_unmapped_area(struct uvc_video_queue *queue,
84					   unsigned long pgoff);
85#endif /* CONFIG_MMU */
86
87void uvcg_queue_cancel(struct uvc_video_queue *queue, int disconnect);
88
89int uvcg_queue_enable(struct uvc_video_queue *queue, int enable);
90
91struct uvc_buffer *uvcg_queue_next_buffer(struct uvc_video_queue *queue,
92					  struct uvc_buffer *buf);
93
94struct uvc_buffer *uvcg_queue_head(struct uvc_video_queue *queue);
95
96#endif /* _UVC_QUEUE_H_ */
97

  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef _UVC_QUEUE_H_
  3#define _UVC_QUEUE_H_
  4
  5#include <linux/list.h>
  6#include <linux/poll.h>
  7#include <linux/spinlock.h>
  8
  9#include <media/videobuf2-v4l2.h>
 10
 11struct file;
 12struct mutex;
 13
 14/* Maximum frame size in bytes, for sanity checking. */
 15#define UVC_MAX_FRAME_SIZE	(16*1024*1024)
 16/* Maximum number of video buffers. */
 17#define UVC_MAX_VIDEO_BUFFERS	32
 18
 19/* ------------------------------------------------------------------------
 20 * Structures.
 21 */
 22
 23enum uvc_buffer_state {
 24	UVC_BUF_STATE_IDLE	= 0,
 25	UVC_BUF_STATE_QUEUED	= 1,
 26	UVC_BUF_STATE_ACTIVE	= 2,
 27	UVC_BUF_STATE_DONE	= 3,
 28	UVC_BUF_STATE_ERROR	= 4,
 29};
 30
 31struct uvc_buffer {
 32	struct vb2_v4l2_buffer buf;
 33	struct list_head queue;
 34
 35	enum uvc_buffer_state state;
 36	void *mem;
 37	struct sg_table *sgt;
 38	struct scatterlist *sg;
 39	unsigned int offset;
 40	unsigned int length;
 41	unsigned int bytesused;
 42	/* req_payload_size: only used with isoc */
 43	unsigned int req_payload_size;
 44};
 45
 46#define UVC_QUEUE_DISCONNECTED		(1 << 0)
 47#define UVC_QUEUE_DROP_INCOMPLETE	(1 << 1)
 
 48
 49struct uvc_video_queue {
 50	struct vb2_queue queue;
 51
 52	unsigned int flags;
 53	__u32 sequence;
 54
 55	unsigned int buf_used;
 56
 57	bool use_sg;
 58
 59	spinlock_t irqlock;	/* Protects flags and irqqueue */
 60	struct list_head irqqueue;
 61};
 62
 63static inline int uvc_queue_streaming(struct uvc_video_queue *queue)
 64{
 65	return vb2_is_streaming(&queue->queue);
 66}
 67
 68int uvcg_queue_init(struct uvc_video_queue *queue, struct device *dev, enum v4l2_buf_type type,
 69		    struct mutex *lock);
 70
 71void uvcg_free_buffers(struct uvc_video_queue *queue);
 72
 73int uvcg_alloc_buffers(struct uvc_video_queue *queue,
 74		       struct v4l2_requestbuffers *rb);
 75
 76int uvcg_query_buffer(struct uvc_video_queue *queue, struct v4l2_buffer *buf);
 77
 78int uvcg_queue_buffer(struct uvc_video_queue *queue, struct v4l2_buffer *buf);
 79
 80int uvcg_dequeue_buffer(struct uvc_video_queue *queue,
 81			struct v4l2_buffer *buf, int nonblocking);
 82
 83__poll_t uvcg_queue_poll(struct uvc_video_queue *queue,
 84			     struct file *file, poll_table *wait);
 85
 86int uvcg_queue_mmap(struct uvc_video_queue *queue, struct vm_area_struct *vma);
 87
 88#ifndef CONFIG_MMU
 89unsigned long uvcg_queue_get_unmapped_area(struct uvc_video_queue *queue,
 90					   unsigned long pgoff);
 91#endif /* CONFIG_MMU */
 92
 93void uvcg_queue_cancel(struct uvc_video_queue *queue, int disconnect);
 94
 95int uvcg_queue_enable(struct uvc_video_queue *queue, int enable);
 96
 97void uvcg_complete_buffer(struct uvc_video_queue *queue,
 98					  struct uvc_buffer *buf);
 99
100struct uvc_buffer *uvcg_queue_head(struct uvc_video_queue *queue);
101
102#endif /* _UVC_QUEUE_H_ */
103