drivers/usb/media/et61x251_sensor.h

   1 /***************************************************************************
   2  * API for image sensors connected to ET61X[12]51 PC Camera Controllers    *
   3  *                                                                         *
   4  * Copyright (C) 2006 by Luca Risolia <luca.risolia@studio.unibo.it>       *
   5  *                                                                         *
   6  * This program is free software; you can redistribute it and/or modify    *
   7  * it under the terms of the GNU General Public License as published by    *
   8  * the Free Software Foundation; either version 2 of the License, or       *
   9  * (at your option) any later version.                                     *
  10  *                                                                         *
  11  * This program is distributed in the hope that it will be useful,         *
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of          *
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           *
  14  * GNU General Public License for more details.                            *
  15  *                                                                         *
  16  * You should have received a copy of the GNU General Public License       *
  17  * along with this program; if not, write to the Free Software             *
  18  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.               *
  19  ***************************************************************************/
  20
  21 #ifndef _ET61X251_SENSOR_H_
  22 #define _ET61X251_SENSOR_H_
  23
  24 #include <linux/usb.h>
  25 #include <linux/videodev.h>
  26 #include <linux/device.h>
  27 #include <linux/stddef.h>
  28 #include <linux/errno.h>
  29 #include <asm/types.h>
  30
  31 struct et61x251_device;
  32 struct et61x251_sensor;
  33
  34 /*****************************************************************************/
  35
  36 extern int et61x251_probe_tas5130d1b(struct et61x251_device* cam);
  37
  38 #define ET61X251_SENSOR_TABLE                                                 \
  39 /* Weak detections must go at the end of the list */                          \
  40 static int (*et61x251_sensor_table[])(struct et61x251_device*) = {            \
  41         &et61x251_probe_tas5130d1b,                                           \
  42         NULL,                                                                 \
  43 };
  44
  45 extern void
  46 et61x251_attach_sensor(struct et61x251_device* cam,
  47                        struct et61x251_sensor* sensor);
  48
  49 /*****************************************************************************/
  50
  51 extern int et61x251_write_reg(struct et61x251_device*, u8 value, u16 index);
  52 extern int et61x251_read_reg(struct et61x251_device*, u16 index);
  53 extern int et61x251_i2c_write(struct et61x251_device*, u8 address, u8 value);
  54 extern int et61x251_i2c_read(struct et61x251_device*, u8 address);
  55 extern int et61x251_i2c_try_write(struct et61x251_device*,
  56                                   struct et61x251_sensor*, u8 address,
  57                                   u8 value);
  58 extern int et61x251_i2c_try_read(struct et61x251_device*,
  59                                  struct et61x251_sensor*, u8 address);
  60 extern int et61x251_i2c_raw_write(struct et61x251_device*, u8 n, u8 data1,
  61                                   u8 data2, u8 data3, u8 data4, u8 data5,
  62                                   u8 data6, u8 data7, u8 data8, u8 address);
  63
  64 /*****************************************************************************/
  65
  66 enum et61x251_i2c_sysfs_ops {
  67         ET61X251_I2C_READ = 0x01,
  68         ET61X251_I2C_WRITE = 0x02,
  69 };
  70
  71 enum et61x251_i2c_interface {
  72         ET61X251_I2C_2WIRES,
  73         ET61X251_I2C_3WIRES,
  74 };
  75
  76 /* Repeat start condition when RSTA is high */
  77 enum et61x251_i2c_rsta {
  78         ET61X251_I2C_RSTA_STOP = 0x00, /* stop then start */
  79         ET61X251_I2C_RSTA_REPEAT = 0x01, /* repeat start */
  80 };
  81
  82 #define ET61X251_MAX_CTRLS V4L2_CID_LASTP1-V4L2_CID_BASE+10
  83
  84 struct et61x251_sensor {
  85         char name[32];
  86
  87         enum et61x251_i2c_sysfs_ops sysfs_ops;
  88
  89         enum et61x251_i2c_interface interface;
  90         u8 i2c_slave_id;
  91         enum et61x251_i2c_rsta rsta;
  92         struct v4l2_rect active_pixel; /* left and top define FVSX and FVSY */
  93
  94         struct v4l2_queryctrl qctrl[ET61X251_MAX_CTRLS];
  95         struct v4l2_cropcap cropcap;
  96         struct v4l2_pix_format pix_format;
  97
  98         int (*init)(struct et61x251_device* cam);
  99         int (*get_ctrl)(struct et61x251_device* cam,
 100                         struct v4l2_control* ctrl);
 101         int (*set_ctrl)(struct et61x251_device* cam,
 102                         const struct v4l2_control* ctrl);
 103         int (*set_crop)(struct et61x251_device* cam,
 104                         const struct v4l2_rect* rect);
 105         int (*set_pix_format)(struct et61x251_device* cam,
 106                               const struct v4l2_pix_format* pix);
 107
 108         const struct usb_device* usbdev;
 109
 110         /* Private */
 111         struct v4l2_queryctrl _qctrl[ET61X251_MAX_CTRLS];
 112         struct v4l2_rect _rect;
 113 };
 114
 115 #endif /* _ET61X251_SENSOR_H_ */