drivers/media/video/pwc/pwc.h

   1 /* (C) 1999-2003 Nemosoft Unv.
   2    (C) 2004-2006 Luc Saillard (luc@saillard.org)
   3
   4    NOTE: this version of pwc is an unofficial (modified) release of pwc & pcwx
   5    driver and thus may have bugs that are not present in the original version.
   6    Please send bug reports and support requests to <luc@saillard.org>.
   7    The decompression routines have been implemented by reverse-engineering the
   8    Nemosoft binary pwcx module. Caveat emptor.
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 2 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program; if not, write to the Free Software
  22    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  23 */
  24
  25 #ifndef PWC_H
  26 #define PWC_H
  27
  28 #include <linux/config.h>
  29 #include <linux/module.h>
  30 #include <linux/usb.h>
  31 #include <linux/spinlock.h>
  32 #include <linux/wait.h>
  33 #include <linux/smp_lock.h>
  34 #include <linux/version.h>
  35 #include <asm/semaphore.h>
  36 #include <asm/errno.h>
  37 #include <linux/videodev.h>
  38 #include <media/v4l2-common.h>
  39
  40 #include "pwc-uncompress.h"
  41 #include <media/pwc-ioctl.h>
  42
  43 /* Turn some debugging options on/off */
  44 #ifndef CONFIG_PWC_DEBUG
  45 #define CONFIG_PWC_DEBUG 1
  46 #endif
  47
  48 /* Version block */
  49 #define PWC_MAJOR       10
  50 #define PWC_MINOR       0
  51 #define PWC_EXTRAMINOR  12
  52 #define PWC_VERSION_CODE KERNEL_VERSION(PWC_MAJOR,PWC_MINOR,PWC_EXTRAMINOR)
  53 #define PWC_VERSION     "10.0.12"
  54 #define PWC_NAME        "pwc"
  55 #define PFX             PWC_NAME ": "
  56
  57
  58 /* Trace certain actions in the driver */
  59 #define PWC_DEBUG_LEVEL_MODULE  (1<<0)
  60 #define PWC_DEBUG_LEVEL_PROBE   (1<<1)
  61 #define PWC_DEBUG_LEVEL_OPEN    (1<<2)
  62 #define PWC_DEBUG_LEVEL_READ    (1<<3)
  63 #define PWC_DEBUG_LEVEL_MEMORY  (1<<4)
  64 #define PWC_DEBUG_LEVEL_FLOW    (1<<5)
  65 #define PWC_DEBUG_LEVEL_SIZE    (1<<6)
  66 #define PWC_DEBUG_LEVEL_IOCTL   (1<<7)
  67 #define PWC_DEBUG_LEVEL_TRACE   (1<<8)
  68
  69 #define PWC_DEBUG_MODULE(fmt, args...) PWC_DEBUG(MODULE, fmt, ##args)
  70 #define PWC_DEBUG_PROBE(fmt, args...) PWC_DEBUG(PROBE, fmt, ##args)
  71 #define PWC_DEBUG_OPEN(fmt, args...) PWC_DEBUG(OPEN, fmt, ##args)
  72 #define PWC_DEBUG_READ(fmt, args...) PWC_DEBUG(READ, fmt, ##args)
  73 #define PWC_DEBUG_MEMORY(fmt, args...) PWC_DEBUG(MEMORY, fmt, ##args)
  74 #define PWC_DEBUG_FLOW(fmt, args...) PWC_DEBUG(FLOW, fmt, ##args)
  75 #define PWC_DEBUG_SIZE(fmt, args...) PWC_DEBUG(SIZE, fmt, ##args)
  76 #define PWC_DEBUG_IOCTL(fmt, args...) PWC_DEBUG(IOCTL, fmt, ##args)
  77 #define PWC_DEBUG_TRACE(fmt, args...) PWC_DEBUG(TRACE, fmt, ##args)
  78
  79
  80 #if CONFIG_PWC_DEBUG
  81
  82 #define PWC_DEBUG_LEVEL (PWC_DEBUG_LEVEL_MODULE)
  83
  84 #define PWC_DEBUG(level, fmt, args...) do {\
  85           if ((PWC_DEBUG_LEVEL_ ##level) & pwc_trace) \
  86              printk(KERN_DEBUG PFX fmt, ##args); \
  87           } while(0)
  88
  89 #define PWC_ERROR(fmt, args...) printk(KERN_ERR PFX fmt, ##args)
  90 #define PWC_WARNING(fmt, args...) printk(KERN_WARNING PFX fmt, ##args)
  91 #define PWC_INFO(fmt, args...) printk(KERN_INFO PFX fmt, ##args)
  92 #define PWC_TRACE(fmt, args...) PWC_DEBUG(TRACE, fmt, ##args)
  93
  94 #else /* if ! CONFIG_PWC_DEBUG */
  95
  96 #define PWC_ERROR(fmt, args...) printk(KERN_ERR PFX fmt, ##args)
  97 #define PWC_WARNING(fmt, args...) printk(KERN_WARNING PFX fmt, ##args)
  98 #define PWC_INFO(fmt, args...) printk(KERN_INFO PFX fmt, ##args)
  99 #define PWC_TRACE(fmt, args...) do { } while(0)
 100 #define PWC_DEBUG(level, fmt, args...) do { } while(0)
 101
 102 #define pwc_trace 0
 103
 104 #endif
 105
 106 /* Defines for ToUCam cameras */
 107 #define TOUCAM_HEADER_SIZE              8
 108 #define TOUCAM_TRAILER_SIZE             4
 109
 110 #define FEATURE_MOTOR_PANTILT           0x0001
 111 #define FEATURE_CODEC1                  0x0002
 112 #define FEATURE_CODEC2                  0x0004
 113
 114 /* Turn certain features on/off */
 115 #define PWC_INT_PIPE 0
 116
 117 /* Ignore errors in the first N frames, to allow for startup delays */
 118 #define FRAME_LOWMARK 5
 119
 120 /* Size and number of buffers for the ISO pipe. */
 121 #define MAX_ISO_BUFS            2
 122 #define ISO_FRAMES_PER_DESC     10
 123 #define ISO_MAX_FRAME_SIZE      960
 124 #define ISO_BUFFER_SIZE         (ISO_FRAMES_PER_DESC * ISO_MAX_FRAME_SIZE)
 125
 126 /* Frame buffers: contains compressed or uncompressed video data. */
 127 #define MAX_FRAMES              5
 128 /* Maximum size after decompression is 640x480 YUV data, 1.5 * 640 * 480 */
 129 #define PWC_FRAME_SIZE          (460800 + TOUCAM_HEADER_SIZE + TOUCAM_TRAILER_SIZE)
 130
 131 /* Absolute maximum number of buffers available for mmap() */
 132 #define MAX_IMAGES              10
 133
 134 /* Some macros to quickly find the type of a webcam */
 135 #define DEVICE_USE_CODEC1(x) ((x)<675)
 136 #define DEVICE_USE_CODEC2(x) ((x)>=675 && (x)<700)
 137 #define DEVICE_USE_CODEC3(x) ((x)>=700)
 138 #define DEVICE_USE_CODEC23(x) ((x)>=675)
 139
 140
 141 #ifndef V4L2_PIX_FMT_PWC1
 142 #define V4L2_PIX_FMT_PWC1       v4l2_fourcc('P','W','C','1')
 143 #define V4L2_PIX_FMT_PWC2       v4l2_fourcc('P','W','C','2')
 144 #endif
 145
 146 /* The following structures were based on cpia.h. Why reinvent the wheel? :-) */
 147 struct pwc_iso_buf
 148 {
 149         void *data;
 150         int  length;
 151         int  read;
 152         struct urb *urb;
 153 };
 154
 155 /* intermediate buffers with raw data from the USB cam */
 156 struct pwc_frame_buf
 157 {
 158    void *data;
 159    volatile int filled;         /* number of bytes filled */
 160    struct pwc_frame_buf *next;  /* list */
 161 };
 162
 163 /* additionnal informations used when dealing image between kernel and userland */
 164 struct pwc_imgbuf
 165 {
 166         unsigned long offset;   /* offset of this buffer in the big array of image_data */
 167         int   vma_use_count;    /* count the number of time this memory is mapped */
 168 };
 169
 170 struct pwc_device
 171 {
 172    struct video_device *vdev;
 173
 174    /* Pointer to our usb_device */
 175    struct usb_device *udev;
 176
 177    int type;                    /* type of cam (645, 646, 675, 680, 690, 720, 730, 740, 750) */
 178    int release;                 /* release number */
 179    int features;                /* feature bits */
 180    char serial[30];             /* serial number (string) */
 181    int error_status;            /* set when something goes wrong with the cam (unplugged, USB errors) */
 182    int usb_init;                /* set when the cam has been initialized over USB */
 183
 184    /*** Video data ***/
 185    int vopen;                   /* flag */
 186    int vendpoint;               /* video isoc endpoint */
 187    int vcinterface;             /* video control interface */
 188    int valternate;              /* alternate interface needed */
 189    int vframes, vsize;          /* frames-per-second & size (see PSZ_*) */
 190    int vpalette;                /* palette: 420P, RAW or RGBBAYER */
 191    int vframe_count;            /* received frames */
 192    int vframes_dumped;          /* counter for dumped frames */
 193    int vframes_error;           /* frames received in error */
 194    int vmax_packet_size;        /* USB maxpacket size */
 195    int vlast_packet_size;       /* for frame synchronisation */
 196    int visoc_errors;            /* number of contiguous ISOC errors */
 197    int vcompression;            /* desired compression factor */
 198    int vbandlength;             /* compressed band length; 0 is uncompressed */
 199    char vsnapshot;              /* snapshot mode */
 200    char vsync;                  /* used by isoc handler */
 201    char vmirror;                /* for ToUCaM series */
 202
 203    int cmd_len;
 204    unsigned char cmd_buf[13];
 205
 206    /* The image acquisition requires 3 to 4 steps:
 207       1. data is gathered in short packets from the USB controller
 208       2. data is synchronized and packed into a frame buffer
 209       3a. in case data is compressed, decompress it directly into image buffer
 210       3b. in case data is uncompressed, copy into image buffer with viewport
 211       4. data is transferred to the user process
 212
 213       Note that MAX_ISO_BUFS != MAX_FRAMES != MAX_IMAGES....
 214       We have in effect a back-to-back-double-buffer system.
 215     */
 216    /* 1: isoc */
 217    struct pwc_iso_buf sbuf[MAX_ISO_BUFS];
 218    char iso_init;
 219
 220    /* 2: frame */
 221    struct pwc_frame_buf *fbuf;  /* all frames */
 222    struct pwc_frame_buf *empty_frames, *empty_frames_tail;      /* all empty frames */
 223    struct pwc_frame_buf *full_frames, *full_frames_tail;        /* all filled frames */
 224    struct pwc_frame_buf *fill_frame;    /* frame currently being filled */
 225    struct pwc_frame_buf *read_frame;    /* frame currently read by user process */
 226    int frame_header_size, frame_trailer_size;
 227    int frame_size;
 228    int frame_total_size; /* including header & trailer */
 229    int drop_frames;
 230
 231    /* 3: decompression */
 232    void *decompress_data;               /* private data for decompression engine */
 233
 234    /* 4: image */
 235    /* We have an 'image' and a 'view', where 'image' is the fixed-size image
 236       as delivered by the camera, and 'view' is the size requested by the
 237       program. The camera image is centered in this viewport, laced with
 238       a gray or black border. view_min <= image <= view <= view_max;
 239     */
 240    int image_mask;                      /* bitmask of supported sizes */
 241    struct pwc_coord view_min, view_max; /* minimum and maximum viewable sizes */
 242    struct pwc_coord abs_max;            /* maximum supported size with compression */
 243    struct pwc_coord image, view;        /* image and viewport size */
 244    struct pwc_coord offset;             /* offset within the viewport */
 245
 246    void *image_data;                    /* total buffer, which is subdivided into ... */
 247    struct pwc_imgbuf images[MAX_IMAGES];/* ...several images... */
 248    int fill_image;                      /* ...which are rotated. */
 249    int len_per_image;                   /* length per image */
 250    int image_read_pos;                  /* In case we read data in pieces, keep track of were we are in the imagebuffer */
 251    int image_used[MAX_IMAGES];          /* For MCAPTURE and SYNC */
 252
 253    struct semaphore modlock;            /* to prevent races in video_open(), etc */
 254    spinlock_t ptrlock;                  /* for manipulating the buffer pointers */
 255
 256    /*** motorized pan/tilt feature */
 257    struct pwc_mpt_range angle_range;
 258    int pan_angle;                       /* in degrees * 100 */
 259    int tilt_angle;                      /* absolute angle; 0,0 is home position */
 260    int snapshot_button_status;          /* set to 1 when the user push the button, reset to 0 when this value is read */
 261
 262    /*** Misc. data ***/
 263    wait_queue_head_t frameq;            /* When waiting for a frame to finish... */
 264 #if PWC_INT_PIPE
 265    void *usb_int_handler;               /* for the interrupt endpoint */
 266 #endif
 267 };
 268
 269 #ifdef __cplusplus
 270 extern "C" {
 271 #endif
 272
 273 /* Global variables */
 274 #if CONFIG_PWC_DEBUG
 275 extern int pwc_trace;
 276 #endif
 277 extern int pwc_preferred_compression;
 278 extern int pwc_mbufs;
 279
 280 /** functions in pwc-if.c */
 281 int pwc_try_video_mode(struct pwc_device *pdev, int width, int height, int new_fps, int new_compression, int new_snapshot);
 282 int pwc_handle_frame(struct pwc_device *pdev);
 283 void pwc_next_image(struct pwc_device *pdev);
 284 int pwc_isoc_init(struct pwc_device *pdev);
 285 void pwc_isoc_cleanup(struct pwc_device *pdev);
 286
 287 /** Functions in pwc-misc.c */
 288 /* sizes in pixels */
 289 extern const struct pwc_coord pwc_image_sizes[PSZ_MAX];
 290
 291 int pwc_decode_size(struct pwc_device *pdev, int width, int height);
 292 void pwc_construct(struct pwc_device *pdev);
 293
 294 /** Functions in pwc-ctrl.c */
 295 /* Request a certain video mode. Returns < 0 if not possible */
 296 extern int pwc_set_video_mode(struct pwc_device *pdev, int width, int height, int frames, int compression, int snapshot);
 297 /* Calculate the number of bytes per image (not frame) */
 298 extern int pwc_mpt_reset(struct pwc_device *pdev, int flags);
 299 extern int pwc_mpt_set_angle(struct pwc_device *pdev, int pan, int tilt);
 300
 301 /* Various controls; should be obvious. Value 0..65535, or < 0 on error */
 302 extern int pwc_get_brightness(struct pwc_device *pdev);
 303 extern int pwc_set_brightness(struct pwc_device *pdev, int value);
 304 extern int pwc_get_contrast(struct pwc_device *pdev);
 305 extern int pwc_set_contrast(struct pwc_device *pdev, int value);
 306 extern int pwc_get_gamma(struct pwc_device *pdev);
 307 extern int pwc_set_gamma(struct pwc_device *pdev, int value);
 308 extern int pwc_get_saturation(struct pwc_device *pdev, int *value);
 309 extern int pwc_set_saturation(struct pwc_device *pdev, int value);
 310 extern int pwc_set_leds(struct pwc_device *pdev, int on_value, int off_value);
 311 extern int pwc_get_leds(struct pwc_device *pdev, int *on_value, int *off_value);
 312 extern int pwc_get_cmos_sensor(struct pwc_device *pdev, int *sensor);
 313 extern int pwc_restore_user(struct pwc_device *pdev);
 314 extern int pwc_save_user(struct pwc_device *pdev);
 315 extern int pwc_restore_factory(struct pwc_device *pdev);
 316
 317 /* exported for use by v4l2 controls */
 318 extern int pwc_get_red_gain(struct pwc_device *pdev, int *value);
 319 extern int pwc_set_red_gain(struct pwc_device *pdev, int value);
 320 extern int pwc_get_blue_gain(struct pwc_device *pdev, int *value);
 321 extern int pwc_set_blue_gain(struct pwc_device *pdev, int value);
 322 extern int pwc_get_awb(struct pwc_device *pdev);
 323 extern int pwc_set_awb(struct pwc_device *pdev, int mode);
 324 extern int pwc_set_agc(struct pwc_device *pdev, int mode, int value);
 325 extern int pwc_get_agc(struct pwc_device *pdev, int *value);
 326 extern int pwc_set_shutter_speed(struct pwc_device *pdev, int mode, int value);
 327 extern int pwc_get_shutter_speed(struct pwc_device *pdev, int *value);
 328
 329 extern int pwc_set_colour_mode(struct pwc_device *pdev, int colour);
 330 extern int pwc_get_colour_mode(struct pwc_device *pdev, int *colour);
 331 extern int pwc_set_contour(struct pwc_device *pdev, int contour);
 332 extern int pwc_get_contour(struct pwc_device *pdev, int *contour);
 333 extern int pwc_set_backlight(struct pwc_device *pdev, int backlight);
 334 extern int pwc_get_backlight(struct pwc_device *pdev, int *backlight);
 335 extern int pwc_set_flicker(struct pwc_device *pdev, int flicker);
 336 extern int pwc_get_flicker(struct pwc_device *pdev, int *flicker);
 337 extern int pwc_set_dynamic_noise(struct pwc_device *pdev, int noise);
 338 extern int pwc_get_dynamic_noise(struct pwc_device *pdev, int *noise);
 339
 340 /* Power down or up the camera; not supported by all models */
 341 extern int pwc_camera_power(struct pwc_device *pdev, int power);
 342
 343 /* Private ioctl()s; see pwc-ioctl.h */
 344 extern int pwc_ioctl(struct pwc_device *pdev, unsigned int cmd, void *arg);
 345
 346 /** Functions in pwc-v4l.c */
 347 extern int pwc_video_do_ioctl(struct inode *inode, struct file *file,
 348                               unsigned int cmd, void *arg);
 349
 350 /** pwc-uncompress.c */
 351 /* Expand frame to image, possibly including decompression. Uses read_frame and fill_image */
 352 extern int pwc_decompress(struct pwc_device *pdev);
 353
 354 #ifdef __cplusplus
 355 }
 356 #endif
 357
 358
 359 #endif
 360 /* vim: set cino= formatoptions=croql cindent shiftwidth=8 tabstop=8: */