Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
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