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 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 __poll_t 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