drivers/media/video/zc0301/zc0301_sensor.h

   1 /***************************************************************************
   2  * API for image sensors connected to the ZC0301[P] Image Processor and    *
   3  * Control Chip                                                            *
   4  *                                                                         *
   5  * Copyright (C) 2006-2007 by Luca Risolia <luca.risolia@studio.unibo.it>  *
   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  * (at your option) 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  * You should have received a copy of the GNU General Public License       *
  18  * along with this program; if not, write to the Free Software             *
  19  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.               *
  20  ***************************************************************************/
  21
  22 #ifndef _ZC0301_SENSOR_H_
  23 #define _ZC0301_SENSOR_H_
  24
  25 #include <linux/usb.h>
  26 #include <linux/videodev2.h>
  27 #include <linux/device.h>
  28 #include <linux/stddef.h>
  29 #include <linux/errno.h>
  30 #include <asm/types.h>
  31
  32 struct zc0301_device;
  33 struct zc0301_sensor;
  34
  35 /*****************************************************************************/
  36
  37 extern int zc0301_probe_pas202bcb(struct zc0301_device* cam);
  38 extern int zc0301_probe_pb0330(struct zc0301_device* cam);
  39
  40 #define ZC0301_SENSOR_TABLE                                                   \
  41 /* Weak detections must go at the end of the list */                          \
  42 static int (*zc0301_sensor_table[])(struct zc0301_device*) = {                \
  43         &zc0301_probe_pas202bcb,                                              \
  44         &zc0301_probe_pb0330,                                                 \
  45         NULL,                                                                 \
  46 };
  47
  48 extern struct zc0301_device*
  49 zc0301_match_id(struct zc0301_device* cam, const struct usb_device_id *id);
  50
  51 extern void
  52 zc0301_attach_sensor(struct zc0301_device* cam, struct zc0301_sensor* sensor);
  53
  54 #define ZC0301_USB_DEVICE(vend, prod, intclass)                               \
  55         .match_flags = USB_DEVICE_ID_MATCH_DEVICE |                           \
  56                        USB_DEVICE_ID_MATCH_INT_CLASS,                         \
  57         .idVendor = (vend),                                                   \
  58         .idProduct = (prod),                                                  \
  59         .bInterfaceClass = (intclass)
  60
  61 #define ZC0301_ID_TABLE                                                       \
  62 static const struct usb_device_id zc0301_id_table[] =  {                      \
  63         { ZC0301_USB_DEVICE(0x046d, 0x08ae, 0xff), }, /* PAS202 */            \
  64         { ZC0301_USB_DEVICE(0x0ac8, 0x303b, 0xff), }, /* PB-0330 */           \
  65         { }                                                                   \
  66 };
  67
  68 /*****************************************************************************/
  69
  70 extern int zc0301_write_reg(struct zc0301_device*, u16 index, u16 value);
  71 extern int zc0301_read_reg(struct zc0301_device*, u16 index);
  72 extern int zc0301_i2c_write(struct zc0301_device*, u16 address, u16 value);
  73 extern int zc0301_i2c_read(struct zc0301_device*, u16 address, u8 length);
  74
  75 /*****************************************************************************/
  76
  77 #define ZC0301_MAX_CTRLS (V4L2_CID_LASTP1 - V4L2_CID_BASE + 10)
  78 #define ZC0301_V4L2_CID_DAC_MAGNITUDE (V4L2_CID_PRIVATE_BASE + 0)
  79 #define ZC0301_V4L2_CID_GREEN_BALANCE (V4L2_CID_PRIVATE_BASE + 1)
  80
  81 struct zc0301_sensor {
  82         char name[32];
  83
  84         struct v4l2_queryctrl qctrl[ZC0301_MAX_CTRLS];
  85         struct v4l2_cropcap cropcap;
  86         struct v4l2_pix_format pix_format;
  87
  88         int (*init)(struct zc0301_device*);
  89         int (*get_ctrl)(struct zc0301_device*, struct v4l2_control* ctrl);
  90         int (*set_ctrl)(struct zc0301_device*,
  91                         const struct v4l2_control* ctrl);
  92         int (*set_crop)(struct zc0301_device*, const struct v4l2_rect* rect);
  93
  94         /* Private */
  95         struct v4l2_queryctrl _qctrl[ZC0301_MAX_CTRLS];
  96         struct v4l2_rect _rect;
  97 };
  98
  99 #endif /* _ZC0301_SENSOR_H_ */