microdia.h

   1 /**
   2  * @file microdia.h
   3  * @author Nicolas VIVIEN
   4  * @date 2008-02-01
   5  *
   6  * @brief Driver for Microdia USB video camera
   7  *
   8  * @note Copyright (C) Nicolas VIVIEN
   9  *
  10  * @par Licences
  11  *
  12  * This program is free software; you can redistribute it and/or modify
  13  * it under the terms of the GNU General Public License as published by
  14  * the Free Software Foundation; either version 2 of the License, or
  15  * any later version.
  16  *
  17  * This program is distributed in the hope that it will be useful,
  18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  20  * GNU General Public License for more details.
  21  *
  22  * You should have received a copy of the GNU General Public License
  23  * along with this program; if not, write to the Free Software
  24  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  25  */
  26
  27 #include <linux/kernel.h>
  28 #include <linux/version.h>
  29 #include <linux/usb.h>
  30 #include <media/v4l2-common.h>
  31
  32 #ifndef MICRODIA_H
  33 #define MICRODIA_H
  34
  35 #define DRIVER_NAME             "microdia"                      /**< Name of this driver */
  36 #define DRIVER_VERSION          "v2008.10"                      /**< Version of this driver */
  37 #define DRIVER_VERSION_NUM      0x000000                        /**< Version numerical of this driver */
  38 #define DRIVER_DESC             "Microdia USB 2.0 Webcam Driver"/**< Short description of this driver */
  39 #define DRIVER_AUTHOR           "Nicolas VIVIEN"                /**< Author of this driver */
  40 #define PREFIX                  DRIVER_NAME ": "                /**< Prefix use for the MICRODIA "printk" */
  41
  42 #define USB_0C45_VID            0x0c45  /**< Vendor ID of MICRODIA */
  43 #define USB_045E_VID            0x045e  /**< Vendor ID of MICROSOFT */
  44 #define USB_04F2_VID            0x04f2  /**< Vendor ID of CHICONY */
  45 #define USB_145F_VID            0x145f  /**< Vendor ID of TRUST */
  46
  47 /* SN9C201: */
  48 #define USB_6240_PID    0x6240                  /**< SN9C201 + MI1300 */
  49 #define USB_6242_PID    0x6242                  /**< SN9C201 + MI1310 */
  50 #define USB_6243_PID    0x6243                  /**< SN9C201 + S5K4AAFX */
  51 #define USB_6248_PID    0x6248                  /**< SN9C201 + OV9655 */
  52 #define USB_624B_PID    0x624b                  /**< SN9C201 + CX1332 */
  53 #define USB_624C_PID    0x624c                  /**< SN9C201 + MI1320 */
  54 #define USB_624E_PID    0x624e                  /**< SN9C201 + SOI968 */
  55 #define USB_624F_PID    0x624f                  /**< SN9C201 + OV9650 */
  56 #define USB_6253_PID    0x6253                  /**< SN9C201 + OV9650 */
  57 #define USB_6260_PID    0x6260                  /**< SN9C201 + OV7670ISP */
  58 #define USB_6262_PID    0x6262                  /**< SN9C201 + OM6802 */
  59 #define USB_6270_PID    0x6270                  /**< SN9C201 + MI0360/MT9V111 */
  60 #define USB_627A_PID    0x627a                  /**< SN9C201 + S5K53BEB */
  61 #define USB_627B_PID    0x627b                  /**< SN9C201 + OV7660 */
  62 #define USB_627C_PID    0x627c                  /**< SN9C201 + HV7131R */
  63 #define USB_627F_PID    0x627f                  /**< EEPROM */
  64 /* SN9C202:*/
  65 #define USB_6280_PID    0x6280                  /**< SN9C202 + MI1300 */
  66 #define USB_6282_PID    0x6282                  /**< SN9C202 + MI1310 */
  67 #define USB_6283_PID    0x6283                  /**< SN9C202 + S5K4AAFX */
  68 #define USB_6288_PID    0x6288                  /**< SN9C202 + OV9655 */
  69 #define USB_628A_PID    0x628a                  /**< SN9C202 + ICM107 */
  70 #define USB_628B_PID    0x628b                  /**< SN9C202 + CX1332 */
  71 #define USB_628C_PID    0x628c                  /**< SN9C202 + MI1320 */
  72 #define USB_628E_PID    0x628e                  /**< SN9C202 + SOI968 */
  73 #define USB_628F_PID    0x628f                  /**< SN9C202 + OV9650 */
  74 #define USB_62A0_PID    0x62a0                  /**< SN9C202 + OV7670ISP */
  75 #define USB_62A2_PID    0x62a2                  /**< SN9C202 + OM6802 */
  76 #define USB_62B0_PID    0x62b0                  /**< SN9C202 + MI0360/MT9V111 */
  77 #define USB_62B3_PID    0x62b3                  /**< SN9C202 + OV9655 */
  78 #define USB_62BA_PID    0x62ba                  /**< SN9C202 + S5K53BEB */
  79 #define USB_62BB_PID    0x62bb                  /**< SN9C202 + OV7660 */
  80 #define USB_62BC_PID    0x62bc                  /**< SN9C202 + HV7131R */
  81 #define USB_62BE_PID    0x62be                  /**< SN9C202 + OV7663 */
  82 /* *** "Clone"-devices ***: */
  83
  84 /* Microsoft LifeCam VX-6000: */
  85 #define USB_00F4_PID    0x00f4                  /**< => 628f (SN9C202 + OV9650) */
  86 /*  Trust WB-3600R: */
  87 #define USB_013D_PID    0x013d                  /**< => 627b (SN9C201 + OV7660) */
  88 /*  Chicony Panda 7, Trust WB-3450P: */
  89 #define USB_A128_PID    0xa128                  /**< => 62be (SN9C202 + OV7663) */
  90
  91 #define SN9C20X_BRIDGE  (1 << 16)
  92
  93 #define MICRODIA_USB_DEVICE(vend, prod, flags)                                \
  94         .match_flags = USB_DEVICE_ID_MATCH_DEVICE |                           \
  95                        USB_DEVICE_ID_MATCH_INT_CLASS,                         \
  96         .idVendor = (vend),                                                   \
  97         .idProduct = (prod),                                                  \
  98         .bInterfaceClass = 0xff,                                              \
  99         .driver_info = (flags)
 100
 101 /**
 102  * @def VID_HARDWARE_MICRODIA
 103  *
 104  * This value must be inserted into the kernel headers linux/videodev.h
 105  * It's useful only for the support of V4L v1
 106  */
 107 #define VID_HARDWARE_MICRODIA           88
 108 /* FIXME: Can the above be removed ? */
 109
 110 /**
 111  * @def MAX_URBS
 112  *   Number maximal of URBS
 113  *
 114  * @def ISO_FRAMES_PER_DESC
 115  *   Number frames per ISOC descriptor
 116  */
 117 #define MAX_URBS                                200
 118 #define ISO_FRAMES_PER_DESC                     10
 119
 120 /**
 121  * @def hb_multiplier(wMaxPacketSize)
 122  *   USB endpoint high bandwidth multiplier
 123  *
 124  * @def max_packet_sz(wMaxPacketSize)
 125  *   USB endpoint maximum packet size
 126  *
 127  * These values are both encoded within the wMaxPacketSize field of the usb_endpoint_descriptor structure.
 128  * The 11(10:0) lowest bits hold the MaxPacketSize(according to the usb specs a value over 1024 is undefined),
 129  * and the bits 12:11 will give the high bandwidth multiplier(this should be a value of 0-2).
 130  */
 131
 132 #define hb_multiplier(wMaxPacketSize) (((wMaxPacketSize >> 11) & 0x03) + 1)
 133 #define max_packet_sz(wMaxPacketSize) ((wMaxPacketSize) & 0x07ff)
 134
 135 /**
 136  * @def DRIVER_SUPPORT
 137  *
 138  * List of supported devices
 139  */
 140 #define DRIVER_SUPPORT                          "Microdia USB Camera"
 141
 142 #define MICRODIA_INFO           (1 << 0)
 143 #define MICRODIA_WARNING        (1 << 1)
 144 #define MICRODIA_ERROR          (1 << 2)
 145 #define MICRODIA_DEBUG          (1 << 3)
 146 #define MICRODIA_STREAM         (1 << 4)
 147
 148 /**
 149  * @def UDIA_INFO(str, args...)
 150  *   Print information message.
 151  *   @a Use this function like the function printf.
 152  *
 153  * @def UDIA_ERROR(str, args...)
 154  *   Print error message.
 155  *   @a Use this function like the function printf.
 156  *
 157  * @def UDIA_WARNING(str, args...)
 158  *   Print warning message.
 159  *   @a Use this function like the function printf.
 160  *
 161  * @def UDIA_DEBUG(str, args...)
 162  *   Print debug message.
 163  *   @a Use this function like the function printf.
 164  *
 165  * @def UDIA_STREAM(str, args...)
 166  *   Print stream debug message.
 167  *   @a Use this function like the function printf.
 168  */
 169 extern __u8 log_level;
 170
 171 #define UDIA_INFO(str, args...) \
 172 do { \
 173         if (log_level & MICRODIA_INFO) \
 174                 printk(KERN_INFO PREFIX str, ##args); \
 175 } while (0)
 176
 177 #define UDIA_WARNING(str, args...) \
 178 do { \
 179         if (log_level & MICRODIA_WARNING) \
 180                 printk(KERN_WARNING PREFIX str, ##args); \
 181 } while (0)
 182
 183 #define UDIA_ERROR(str, args...) \
 184 do { \
 185         if (log_level & MICRODIA_ERROR) \
 186                 printk(KERN_ERR PREFIX str, ##args); \
 187 } while (0)
 188
 189 #define UDIA_DEBUG(str, args...) \
 190 do { \
 191         if (log_level & MICRODIA_DEBUG) \
 192                 printk(KERN_DEBUG PREFIX str, ##args); \
 193 } while (0)
 194
 195 #define UDIA_STREAM(str, args...) \
 196 do { \
 197         if (log_level & MICRODIA_STREAM) \
 198                 printk(KERN_DEBUG PREFIX str, ##args); \
 199 } while (0)
 200
 201
 202 enum microdia_buffer_state {
 203         MICRODIA_BUF_STATE_IDLE       = 0,
 204         MICRODIA_BUF_STATE_QUEUED     = 1,
 205         MICRODIA_BUF_STATE_ACTIVE     = 2,
 206         MICRODIA_BUF_STATE_DONE       = 3,
 207         MICRODIA_BUF_STATE_ERROR      = 4,
 208 };
 209
 210 enum microdia_mode {
 211         MICRODIA_MODE_IDLE       = 0,
 212         MICRODIA_MODE_READ       = 1,
 213         MICRODIA_MODE_STREAM     = 2,
 214 };
 215
 216 struct microdia_buffer {
 217         unsigned long vma_use_count;
 218         struct list_head stream;
 219
 220         /* Touched by interrupt handler. */
 221         struct v4l2_buffer buf;
 222         struct list_head queue;
 223         wait_queue_head_t wait;
 224         enum microdia_buffer_state state;
 225 };
 226
 227 #define MICRODIA_QUEUE_STREAMING        (1 << 0)
 228 #define MICRODIA_QUEUE_DISCONNECTED     (1 << 1)
 229 #define MICRODIA_QUEUE_DROP_INCOMPLETE  (1 << 2)
 230
 231 struct microdia_video_queue {
 232         void *mem;
 233         unsigned int flags;
 234         __u32 sequence;
 235
 236         unsigned int count;
 237         unsigned int min_buffers;
 238         unsigned int max_buffers;
 239         unsigned int buf_size;
 240
 241         struct microdia_buffer *buffer;
 242         struct microdia_buffer *read_buffer;
 243         struct mutex mutex;     /* protects buffers and mainqueue */
 244         spinlock_t irqlock;     /* protects irqqueue */
 245
 246         struct list_head mainqueue;
 247         struct list_head irqqueue;
 248 };
 249
 250 /**
 251  * @struct microdia_urb
 252  */
 253 struct microdia_urb {
 254         void *data;
 255         struct urb *urb;
 256 };
 257
 258 /**
 259  * @struct microdia_video
 260  */
 261 struct microdia_video {
 262         struct v4l2_pix_format format;
 263         int fps;                                /**< FPS setting */
 264         int brightness;                         /**< Brightness setting */
 265         int contrast;                           /**< Contrast setting */
 266         int whiteness;                          /**< Whiteness setting */
 267         int colour;                             /**< Colour setting */
 268         int hue;                                /**< Hue setting */
 269         int hflip;                              /**< Horizontal flip */
 270         int vflip;                              /**< Vertical flip */
 271         int exposure;                           /**< Exposure */
 272         int sharpness;                          /**< Sharpness */
 273         __u8 rgb_gain[4];                       /**< RGB Gain (RGGB) */
 274         int auto_exposure;                      /**< Automatic exposure */
 275         int auto_whitebalance;                  /**< Automatic whitebalance */
 276 };
 277
 278 /**
 279  * @struct microdia_debugfs
 280  */
 281 struct microdia_debugfs {
 282         struct dentry *dent_device;
 283         struct dentry *dent_bridge_addr;
 284         struct dentry *dent_bridge_val;
 285         struct dentry *dent_bridge_dump;
 286         struct dentry *dent_sensor_addr;
 287         struct dentry *dent_sensor_val8;
 288         struct dentry *dent_sensor_val16;
 289         struct dentry *dent_sensor_val32;
 290
 291         __u16 bridge_addr; /**< Current bridge register address */
 292         __u8 sensor_addr; /**< Current sensor register address */
 293 };
 294
 295 enum microdia_endpoints {
 296         MICRODIA_VID_ISOC = 1,
 297         MICRODIA_BULK = 2,
 298         MICRODIA_INT = 3,
 299         MICRODIA_AUD_ISOC = 4
 300 };
 301
 302 enum microdia_sensors {
 303         UNKNOWN_SENSOR          = 0,
 304         OV9650_SENSOR           = 1,
 305         OV9655_SENSOR           = 2,
 306         SOI968_SENSOR           = 3,
 307         OV7660_SENSOR           = 4,
 308         OV7670_SENSOR           = 5,
 309         MT9M111_SENSOR          = 6,
 310         MT9V111_SENSOR          = 7,
 311         MT9V011_SENSOR          = 8,
 312 };
 313
 314
 315
 316 struct usb_microdia;
 317
 318 struct microdia_video_format {
 319         __u32 pix_fmt;
 320         char desc[32];
 321         __u8  depth;
 322         int (*set_format) (struct usb_microdia *dev);
 323 };
 324
 325 struct microdia_video_resolution {
 326         __u16 width;
 327         __u16 height;
 328         __u8 scale;
 329         __u16 window[4];
 330 };
 331
 332 struct sensor_info {
 333         __u8 id;
 334         __u8 *name;
 335         int (*probe) (struct usb_microdia *dev);
 336 };
 337
 338 extern struct sensor_info sensors[];
 339
 340 struct microdia_camera {
 341
 342         __u8 sensor_slave_address;
 343         __u8 sensor_flags;
 344
 345 /* supported resolutions */
 346         __u8 nmodes;
 347         struct microdia_video_resolution *modes;
 348 /* supported video formats */
 349         __u8 nfmts;
 350         struct microdia_video_format *fmts;
 351
 352 /* bridge functions */
 353         int (*initialize) (struct usb_microdia *dev);
 354         int (*enable_video) (struct usb_microdia *dev, int enable);
 355
 356 /* image quality functions */
 357
 358         int (*set_contrast) (struct usb_microdia *dev);
 359         int (*set_brightness) (struct usb_microdia *dev);
 360         int (*set_gamma) (struct usb_microdia *dev);
 361         int (*set_exposure) (struct usb_microdia *dev);
 362         int (*flip_detect) (struct usb_microdia *dev);
 363         int (*set_hvflip) (struct usb_microdia *dev);
 364         int (*set_sharpness) (struct usb_microdia *dev);
 365         int (*set_rgb_gain) (struct usb_microdia *dev);
 366         int (*set_auto_exposure) (struct usb_microdia *dev);
 367         int (*set_auto_whitebalance) (struct usb_microdia *dev);
 368 };
 369
 370 /**
 371  * @struct usb_microdia
 372  */
 373 struct usb_microdia {
 374         struct video_device *vdev;                      /**< Pointer on a V4L2 video device */
 375         struct usb_device *udev;                        /**< Pointer on a USB device */
 376         struct usb_interface *interface;        /**< Pointer on a USB interface */
 377
 378         int release;                                            /**< Release of the device (bcdDevice) */
 379
 380         struct microdia_video vsettings;                /**< Video settings (brightness, whiteness...) */
 381         struct microdia_debugfs debug; /**< debugfs information structure */
 382
 383         struct kref vopen;      /**< Video status (Opened or Closed) */
 384         struct file *owner;     /**< file handler of stream owner */
 385         enum microdia_mode mode;/**< camera mode */
 386
 387         int vframes_overflow;   /**< Buffer overflow frames */
 388         int vframes_incomplete; /**< Incomplete frames */
 389         int vframes_dropped;    /**< Dropped frames */
 390
 391         struct mutex mutex;                             /**< Mutex */
 392
 393         struct microdia_urb urbs[MAX_URBS];
 394
 395         int resolution;
 396
 397         unsigned int frozen:1;
 398         struct microdia_video_queue queue;
 399         struct microdia_camera camera;
 400 };
 401
 402 /**
 403  * @def MICRODIA_PERCENT
 404  *   Calculate a value from a percent
 405  */
 406 #define MICRODIA_PERCENT(x, y) (((int)x * (int)y) / 100)
 407
 408
 409 extern struct mutex open_lock;
 410
 411 int usb_microdia_control_write(struct usb_microdia *, __u16, __u8 *, __u16);
 412 int usb_microdia_control_read(struct usb_microdia *, __u16, __u8 *, __u16);
 413
 414 int usb_microdia_isoc_init(struct usb_microdia *,
 415         struct usb_endpoint_descriptor *);
 416 #if LINUX_VERSION_CODE < KERNEL_VERSION(2, 6, 19)
 417 void usb_microdia_completion_handler(struct urb *, struct pt_regs *);
 418 #else
 419 void usb_microdia_completion_handler(struct urb *);
 420 #endif
 421 int usb_microdia_init_urbs(struct usb_microdia *);
 422 void usb_microdia_uninit_urbs(struct usb_microdia *);
 423 void usb_microdia_delete(struct kref *);
 424
 425
 426 int dev_microdia_initialize_device(struct usb_microdia *, __u32 flags);
 427 int dev_microdia_probe_sensor(struct usb_microdia *);
 428 int dev_microdia_enable_video(struct usb_microdia *, int);
 429 int dev_microdia_camera_settings(struct usb_microdia *);
 430 int dev_microdia_camera_set_contrast(struct usb_microdia *);
 431 int dev_microdia_camera_set_brightness(struct usb_microdia *);
 432 int dev_microdia_camera_set_gamma(struct usb_microdia *);
 433 int dev_microdia_camera_set_exposure(struct usb_microdia *);
 434 int dev_microdia_camera_set_hvflip(struct usb_microdia *);
 435 int dev_microdia_camera_set_sharpness(struct usb_microdia *dev);
 436 int dev_microdia_camera_set_rgb_gain(struct usb_microdia *dev);
 437 int dev_microdia_camera_set_auto_exposure(struct usb_microdia *dev);
 438 int dev_microdia_camera_set_auto_whitebalance(struct usb_microdia *dev);
 439 /* int dev_microdia_set_camera_quality(struct usb_microdia *);*/
 440
 441 struct v4l2_pix_format *v4l2_enum_supported_formats(struct usb_microdia *,
 442         __u8);
 443 int v4l_microdia_select_video_mode(struct usb_microdia *, int);
 444 int v4l_microdia_register_video_device(struct usb_microdia *);
 445 int v4l_microdia_unregister_video_device(struct usb_microdia *);
 446
 447 int microdia_create_sysfs_files(struct video_device *);
 448 void microdia_remove_sysfs_files(struct video_device *);
 449
 450 void microdia_init_debugfs(void);
 451 void microdia_uninit_debugfs(void);
 452 int microdia_create_debugfs_files(struct usb_microdia *);
 453 int microdia_remove_debugfs_files(struct usb_microdia *);
 454
 455 void microdia_queue_init(struct microdia_video_queue *);
 456 int microdia_alloc_buffers(struct microdia_video_queue *,
 457         unsigned int, unsigned int);
 458 int microdia_free_buffers(struct microdia_video_queue *);
 459 int microdia_queue_enable(struct microdia_video_queue *, int);
 460 void microdia_queue_cancel(struct microdia_video_queue *, int);
 461 unsigned int microdia_queue_poll(struct microdia_video_queue *,
 462         struct file *, poll_table *);
 463 int microdia_query_buffer(struct microdia_video_queue *, struct v4l2_buffer *);
 464 int microdia_queue_buffer(struct microdia_video_queue *, struct v4l2_buffer *);
 465 int microdia_dequeue_buffer(struct microdia_video_queue *,
 466         struct v4l2_buffer *, int);
 467 struct microdia_buffer *microdia_queue_next_buffer(
 468         struct microdia_video_queue *, struct microdia_buffer *);
 469
 470 static inline int microdia_queue_streaming(struct microdia_video_queue *queue)
 471 {
 472         return queue->flags & MICRODIA_QUEUE_STREAMING;
 473 }
 474
 475 /* Some general sensor functions which have no other home */
 476 int ov_probe(struct usb_microdia *dev);
 477 int ov_initialize(struct usb_microdia *dev, __u8 ov_init[][2], int array_size);
 478 int mt9m111_probe(struct usb_microdia *dev);
 479
 480 #endif