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

   1 /*
   2  * stk-webcam.h : Driver for Syntek 1125 USB webcam controller
   3  *
   4  * Copyright (C) 2006 Nicolas VIVIEN
   5  * Copyright 2007-2008 Jaime Velasco Juan <jsagarribay@gmail.com>
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15  * GNU General Public License for more details.
  16  */
  17
  18 #ifndef STKWEBCAM_H
  19 #define STKWEBCAM_H
  20
  21 #include <linux/usb.h>
  22 #include <media/v4l2-device.h>
  23 #include <media/v4l2-ctrls.h>
  24 #include <media/v4l2-common.h>
  25
  26 #define DRIVER_VERSION          "v0.0.1"
  27 #define DRIVER_VERSION_NUM      0x000001
  28
  29 #define MAX_ISO_BUFS            3
  30 #define ISO_FRAMES_PER_DESC     16
  31 #define ISO_MAX_FRAME_SIZE      3 * 1024
  32 #define ISO_BUFFER_SIZE         (ISO_FRAMES_PER_DESC * ISO_MAX_FRAME_SIZE)
  33
  34
  35 #define PREFIX                          "stkwebcam: "
  36 #define STK_INFO(str, args...)          printk(KERN_INFO PREFIX str, ##args)
  37 #define STK_ERROR(str, args...)         printk(KERN_ERR PREFIX str, ##args)
  38 #define STK_WARNING(str, args...)       printk(KERN_WARNING PREFIX str, ##args)
  39
  40 struct stk_iso_buf {
  41         void *data;
  42         int length;
  43         int read;
  44         struct urb *urb;
  45 };
  46
  47 /* Streaming IO buffers */
  48 struct stk_sio_buffer {
  49         struct v4l2_buffer v4lbuf;
  50         char *buffer;
  51         int mapcount;
  52         struct stk_camera *dev;
  53         struct list_head list;
  54 };
  55
  56 enum stk_mode {MODE_VGA, MODE_SXGA, MODE_CIF, MODE_QVGA, MODE_QCIF};
  57
  58 struct stk_video {
  59         enum stk_mode mode;
  60         __u32 palette;
  61         int hflip;
  62         int vflip;
  63 };
  64
  65 enum stk_status {
  66         S_PRESENT = 1,
  67         S_INITIALISED = 2,
  68         S_MEMALLOCD = 4,
  69         S_STREAMING = 8,
  70 };
  71 #define is_present(dev)         ((dev)->status & S_PRESENT)
  72 #define is_initialised(dev)     ((dev)->status & S_INITIALISED)
  73 #define is_streaming(dev)       ((dev)->status & S_STREAMING)
  74 #define is_memallocd(dev)       ((dev)->status & S_MEMALLOCD)
  75 #define set_present(dev)        ((dev)->status = S_PRESENT)
  76 #define unset_present(dev)      ((dev)->status &= \
  77                                         ~(S_PRESENT|S_INITIALISED|S_STREAMING))
  78 #define set_initialised(dev)    ((dev)->status |= S_INITIALISED)
  79 #define unset_initialised(dev)  ((dev)->status &= ~S_INITIALISED)
  80 #define set_memallocd(dev)      ((dev)->status |= S_MEMALLOCD)
  81 #define unset_memallocd(dev)    ((dev)->status &= ~S_MEMALLOCD)
  82 #define set_streaming(dev)      ((dev)->status |= S_STREAMING)
  83 #define unset_streaming(dev)    ((dev)->status &= ~S_STREAMING)
  84
  85 struct regval {
  86         unsigned reg;
  87         unsigned val;
  88 };
  89
  90 struct stk_camera {
  91         struct v4l2_device v4l2_dev;
  92         struct v4l2_ctrl_handler hdl;
  93         struct video_device vdev;
  94         struct usb_device *udev;
  95         struct usb_interface *interface;
  96         int webcam_model;
  97         struct file *owner;
  98         struct mutex lock;
  99         int first_init;
 100
 101         u8 isoc_ep;
 102
 103         /* Not sure if this is right */
 104         atomic_t urbs_used;
 105
 106         struct stk_video vsettings;
 107
 108         enum stk_status status;
 109
 110         spinlock_t spinlock;
 111         wait_queue_head_t wait_frame;
 112
 113         struct stk_iso_buf *isobufs;
 114
 115         int frame_size;
 116         /* Streaming buffers */
 117         int reading;
 118         unsigned int n_sbufs;
 119         struct stk_sio_buffer *sio_bufs;
 120         struct list_head sio_avail;
 121         struct list_head sio_full;
 122         unsigned sequence;
 123 };
 124
 125 #define vdev_to_camera(d) container_of(d, struct stk_camera, vdev)
 126
 127 int stk_camera_write_reg(struct stk_camera *, u16, u8);
 128 int stk_camera_read_reg(struct stk_camera *, u16, u8 *);
 129
 130 int stk_sensor_init(struct stk_camera *);
 131 int stk_sensor_configure(struct stk_camera *);
 132 int stk_sensor_sleep(struct stk_camera *dev);
 133 int stk_sensor_wakeup(struct stk_camera *dev);
 134 int stk_sensor_set_brightness(struct stk_camera *dev, int br);
 135
 136 #endif