LXR linux/drivers/usb/gadget/function/uvc

   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
  21enum 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
  29struct 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
  43struct 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
  55static inline int uvc_queue_streaming(struct uvc_video_queue *queue)
  56{
  57        return vb2_is_streaming(&queue->queue);
  58}
  59
  60int uvcg_queue_init(struct uvc_video_queue *queue, enum v4l2_buf_type type,
  61                    struct mutex *lock);
  62
  63void uvcg_free_buffers(struct uvc_video_queue *queue);
  64
  65int uvcg_alloc_buffers(struct uvc_video_queue *queue,
  66                       struct v4l2_requestbuffers *rb);
  67
  68int uvcg_query_buffer(struct uvc_video_queue *queue, struct v4l2_buffer *buf);
  69
  70int uvcg_queue_buffer(struct uvc_video_queue *queue, struct v4l2_buffer *buf);
  71
  72int 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
  78int uvcg_queue_mmap(struct uvc_video_queue *queue, struct vm_area_struct *vma);
  79
  80#ifndef CONFIG_MMU
  81unsigned long uvcg_queue_get_unmapped_area(struct uvc_video_queue *queue,
  82                                           unsigned long pgoff);
  83#endif /* CONFIG_MMU */
  84
  85void uvcg_queue_cancel(struct uvc_video_queue *queue, int disconnect);
  86
  87int uvcg_queue_enable(struct uvc_video_queue *queue, int enable);
  88
  89struct uvc_buffer *uvcg_queue_next_buffer(struct uvc_video_queue *queue,
  90                                          struct uvc_buffer *buf);
  91
  92struct uvc_buffer *uvcg_queue_head(struct uvc_video_queue *queue);
  93
  94#endif /* __KERNEL__ */
  95
  96#endif /* _UVC_QUEUE_H_ */
  97
  98