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