LXR linux/drivers/media/usb/stkwebcam/stk-webcam.h

   1/* SPDX-License-Identifier: GPL-2.0-or-later */
   2/*
   3 * stk-webcam.h : Driver for Syntek 1125 USB webcam controller
   4 *
   5 * Copyright (C) 2006 Nicolas VIVIEN
   6 * Copyright 2007-2008 Jaime Velasco Juan <jsagarribay@gmail.com>
   7 */
   8
   9#ifndef STKWEBCAM_H
  10#define STKWEBCAM_H
  11
  12#include <linux/usb.h>
  13#include <media/v4l2-device.h>
  14#include <media/v4l2-ctrls.h>
  15#include <media/v4l2-common.h>
  16
  17#define DRIVER_VERSION          "v0.0.1"
  18#define DRIVER_VERSION_NUM      0x000001
  19
  20#define MAX_ISO_BUFS            3
  21#define ISO_FRAMES_PER_DESC     16
  22#define ISO_MAX_FRAME_SIZE      3 * 1024
  23#define ISO_BUFFER_SIZE         (ISO_FRAMES_PER_DESC * ISO_MAX_FRAME_SIZE)
  24
  25struct stk_iso_buf {
  26        void *data;
  27        int length;
  28        int read;
  29        struct urb *urb;
  30};
  31
  32/* Streaming IO buffers */
  33struct stk_sio_buffer {
  34        struct v4l2_buffer v4lbuf;
  35        char *buffer;
  36        int mapcount;
  37        struct stk_camera *dev;
  38        struct list_head list;
  39};
  40
  41enum stk_mode {MODE_VGA, MODE_SXGA, MODE_CIF, MODE_QVGA, MODE_QCIF};
  42
  43struct stk_video {
  44        enum stk_mode mode;
  45        __u32 palette;
  46        int hflip;
  47        int vflip;
  48};
  49
  50enum stk_status {
  51        S_PRESENT = 1,
  52        S_INITIALISED = 2,
  53        S_MEMALLOCD = 4,
  54        S_STREAMING = 8,
  55};
  56#define is_present(dev)         ((dev)->status & S_PRESENT)
  57#define is_initialised(dev)     ((dev)->status & S_INITIALISED)
  58#define is_streaming(dev)       ((dev)->status & S_STREAMING)
  59#define is_memallocd(dev)       ((dev)->status & S_MEMALLOCD)
  60#define set_present(dev)        ((dev)->status = S_PRESENT)
  61#define unset_present(dev)      ((dev)->status &= \
  62                                        ~(S_PRESENT|S_INITIALISED|S_STREAMING))
  63#define set_initialised(dev)    ((dev)->status |= S_INITIALISED)
  64#define unset_initialised(dev)  ((dev)->status &= ~S_INITIALISED)
  65#define set_memallocd(dev)      ((dev)->status |= S_MEMALLOCD)
  66#define unset_memallocd(dev)    ((dev)->status &= ~S_MEMALLOCD)
  67#define set_streaming(dev)      ((dev)->status |= S_STREAMING)
  68#define unset_streaming(dev)    ((dev)->status &= ~S_STREAMING)
  69
  70struct regval {
  71        unsigned reg;
  72        unsigned val;
  73};
  74
  75struct stk_camera {
  76        struct v4l2_device v4l2_dev;
  77        struct v4l2_ctrl_handler hdl;
  78        struct video_device vdev;
  79        struct usb_device *udev;
  80        struct usb_interface *interface;
  81        int webcam_model;
  82        struct file *owner;
  83        struct mutex lock;
  84        int first_init;
  85
  86        u8 isoc_ep;
  87
  88        /* Not sure if this is right */
  89        atomic_t urbs_used;
  90
  91        struct stk_video vsettings;
  92
  93        enum stk_status status;
  94
  95        spinlock_t spinlock;
  96        wait_queue_head_t wait_frame;
  97
  98        struct stk_iso_buf *isobufs;
  99
 100        int frame_size;
 101        /* Streaming buffers */
 102        int reading;
 103        unsigned int n_sbufs;
 104        struct stk_sio_buffer *sio_bufs;
 105        struct list_head sio_avail;
 106        struct list_head sio_full;
 107        unsigned sequence;
 108};
 109
 110#define vdev_to_camera(d) container_of(d, struct stk_camera, vdev)
 111
 112int stk_camera_write_reg(struct stk_camera *, u16, u8);
 113int stk_camera_read_reg(struct stk_camera *, u16, u8 *);
 114
 115int stk_sensor_init(struct stk_camera *);
 116int stk_sensor_configure(struct stk_camera *);
 117int stk_sensor_sleep(struct stk_camera *dev);
 118int stk_sensor_wakeup(struct stk_camera *dev);
 119int stk_sensor_set_brightness(struct stk_camera *dev, int br);
 120
 121#endif
 122