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 | |
11 | struct file; |
12 | struct 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 | |
23 | enum 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 | |
31 | struct 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 | }; |
43 | |
44 | #define UVC_QUEUE_DISCONNECTED (1 << 0) |
45 | #define UVC_QUEUE_DROP_INCOMPLETE (1 << 1) |
46 | |
47 | struct uvc_video_queue { |
48 | struct vb2_queue queue; |
49 | |
50 | unsigned int flags; |
51 | __u32 sequence; |
52 | |
53 | unsigned int buf_used; |
54 | |
55 | bool use_sg; |
56 | |
57 | spinlock_t irqlock; /* Protects flags and irqqueue */ |
58 | struct list_head irqqueue; |
59 | }; |
60 | |
61 | static inline int uvc_queue_streaming(struct uvc_video_queue *queue) |
62 | { |
63 | return vb2_is_streaming(q: &queue->queue); |
64 | } |
65 | |
66 | int uvcg_queue_init(struct uvc_video_queue *queue, struct device *dev, enum v4l2_buf_type type, |
67 | struct mutex *lock); |
68 | |
69 | void uvcg_free_buffers(struct uvc_video_queue *queue); |
70 | |
71 | int uvcg_alloc_buffers(struct uvc_video_queue *queue, |
72 | struct v4l2_requestbuffers *rb); |
73 | |
74 | int uvcg_query_buffer(struct uvc_video_queue *queue, struct v4l2_buffer *buf); |
75 | |
76 | int uvcg_queue_buffer(struct uvc_video_queue *queue, struct v4l2_buffer *buf); |
77 | |
78 | int uvcg_dequeue_buffer(struct uvc_video_queue *queue, |
79 | struct v4l2_buffer *buf, int nonblocking); |
80 | |
81 | __poll_t uvcg_queue_poll(struct uvc_video_queue *queue, |
82 | struct file *file, poll_table *wait); |
83 | |
84 | int uvcg_queue_mmap(struct uvc_video_queue *queue, struct vm_area_struct *vma); |
85 | |
86 | #ifndef CONFIG_MMU |
87 | unsigned long uvcg_queue_get_unmapped_area(struct uvc_video_queue *queue, |
88 | unsigned long pgoff); |
89 | #endif /* CONFIG_MMU */ |
90 | |
91 | void uvcg_queue_cancel(struct uvc_video_queue *queue, int disconnect); |
92 | |
93 | int uvcg_queue_enable(struct uvc_video_queue *queue, int enable); |
94 | |
95 | void uvcg_complete_buffer(struct uvc_video_queue *queue, |
96 | struct uvc_buffer *buf); |
97 | |
98 | struct uvc_buffer *uvcg_queue_head(struct uvc_video_queue *queue); |
99 | |
100 | #endif /* _UVC_QUEUE_H_ */ |
101 | |
102 | |