mt9vx11.h

   1 /**
   2  * @file mt9vx11.h
   3  * @author Comer352l
   4  * @date 2008-04-25
   5  *
   6  * @brief Common functions and data for the Micron MT9Vx11 sensors.
   7  *
   8  * @note Copyright (C) Comer352l
   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 #ifndef MT9VX11_H
  28 #define MT9VX11_H
  29
  30
  31 #define MT9V111_I2C_SLAVE_ADDRESS       0x5c
  32 #define MT9V011_I2C_SLAVE_ADDRESS       0x5d
  33
  34
  35 /* Registers: */
  36 #define MT9V111_IFPREG_OPMODECTL                0x06    /* Operating mode control */
  37
  38 #define MT9V111_IFPREG_AE_HWINBOUNDARY          0x26    /* Horizontal boundaries of AE measurement window */
  39 #define MT9V111_IFPREG_AE_VWINBOUNDARY          0x27    /* Vertical boundaries of AE measurement window */
  40 #define MT9V111_IFPREG_AE_HWINBOUNDARY_BLC      0x2b    /* H. bound. of AE meas. win. for back light compensation */
  41 #define MT9V111_IFPREG_AE_VWINBOUNDARY_BLC      0x2c    /* V. bound. of AE meas. win. for back light compensation */
  42 #define MT9V111_IFPREG_AE_TARGETLUMCTL          0x2e    /* AE target luminance and tracking accuracy control */
  43 #define MT9V111_IFPREG_AE_SPEEDSENSCTL          0x2f    /* AE speed and sensitivity control */
  44 #define MT9V111_IFPREG_AE_DGAINSLIMITS          0x67    /* AE digital gains limits */
  45
  46 #define MT9V111_IFPREG_AWB_TINT                 0x21    /* AWB tint */
  47 #define MT9V111_IFPREG_AWB_SPEEDCOLORSATCTL     0x25    /* AWB speed and color saturation control */
  48 #define MT9V111_IFPREG_AWB_WINBOUNDARY          0x2d    /* Boundaries of AWB measurement window */
  49
  50
  51 /* Values: */
  52 #define MT9V111_ADDRESSSPACE_IFP                        0x01                    /* IFP-register address space */
  53 #define MT9V111_ADDRESSSPACE_SENSOR                     0x04                    /* sensor-(core-)register address space */
  54
  55 #define MT9V111_IFP_OPMODE_AUTOEXPOSURE                 0x4000                  /* enable auto exposure */
  56 #define MT9V111_IFP_OPMODE_AUTOWHITEBALANCE             0x0002                  /* enable auto exposure */
  57 #define MT9V111_IFP_OPMODE_BYPASSCOLORCORR              0x0010                  /* bypass color correction matrix */
  58 #define MT9V111_IFP_OPMODE_APERTURECORR                 0x1000                  /* enable aperture knee correction */
  59 #define MT9V111_IFP_OPMODE_ONTHEFLYDEFECTCORR           0x2000                  /* enable on-the-fly color correction */
  60
  61 #define MT9V111_IFP_AE_TARGETLUMINANCE(x)               (x & 0xff)              /* AE target luminace */
  62 #define MT9V111_IFP_AE_TRACKINGACCURACY(x)              ((x & 0xff) << 8)       /* AE tracking accuracy */
  63 #define MT9V111_IFP_AE_DELAY(x)                         (x & 0x7)               /* AE reaction delay */
  64 #define MT9V111_IFP_AE_SPEED(x)                         ((x & 0x7) << 3)        /* AE speed */
  65 #define MT9V111_IFP_AE_STEPSIZE_MEDIUMDOWNSLOWUP        0x0000                  /* AE step size: medium speed when going down, slow when going up */
  66 #define MT9V111_IFP_AE_STEPSIZE_MEDIUM                  0x0040                  /* AE step size: medium speed */
  67 #define MT9V111_IFP_AE_STEPSIZE_FAST                    0x0080                  /* AE step size: fast speed*/
  68 #define MT9V111_IFP_AE_STEPSIZE_FASTDOWNMEDIUMUP        0x00c0                  /* AE step size: fast when going down, medium when going up */
  69 #define MT9V111_IFP_AE_WINBOUNDARY_LEFT(x)              ((x/4) & 0xff)          /* left boundary of AE meas. window */
  70 #define MT9V111_IFP_AE_WINBOUNDARY_RIGHT(x)             (((x/4) & 0xff) << 8)   /* right boundary of AE meas. window */
  71 #define MT9V111_IFP_AE_WINBOUNDARY_TOP(x)               ((x/2) & 0xff)          /* top boundary of AE meas. window */
  72 #define MT9V111_IFP_AE_WINBOUNDARY_BOTTOM(x)            (((x/2) & 0xff) << 8)   /* bottom boundary of AE meas. window */
  73 #define MT9V111_IFP_AE_WINBOUNDARY_LEFT_BLC(x)          ((x/4) & 0xff)          /* left boundary of AE meas. window (backlight compensation) */
  74 #define MT9V111_IFP_AE_WINBOUNDARY_RIGHT_BLC(x)         (((x/4) & 0xff) << 8)   /* right boundary of AE meas. window (backlight compensation)*/
  75 #define MT9V111_IFP_AE_WINBOUNDARY_TOP_BLC(x)           ((x/2) & 0xff)          /* top boundary of AE meas. window (backlight compensation)*/
  76 #define MT9V111_IFP_AE_WINBOUNDARY_BOTTOM_BLC(x)        (((x/2) & 0xff) << 8)   /* bottom boundary of AE meas. window (backlight compensation)*/
  77 #define MT9V111_IFP_AE_WIN_LARGE                        0x0000                  /* large AE measurement window */
  78 #define MT9V111_IFP_AE_WIN_MEDIUM                       0x0004                  /* medium AE measurement window (backlight compensation) */
  79 #define MT9V111_IFP_AE_WIN_COMBINED                     0x0008                  /* combined AE meas. win: (large win + (2 * medium win))/3 */
  80 #define MT9V111_IFP_AE_MAXGAIN_PRELS(x)                 (x & 0xff)              /* max. digital gain applied before lens shading correction */
  81 #define MT9V111_IFP_AE_MAXGAIN_POSTLS(x)                ((x & 0xff) << 8)       /* max. digital gain applied during lens shading correction */
  82
  83 #define MT9V111_IFP_AWB_AUTOSATLOWLIGHT_ENABLE          0x4000                  /* enable automatic color saturation control in low light */
  84 #define MT9V111_IFP_AWB_ADDON_BLUE(x)                   (x & 0xff)              /* AWB blue channel add-on */
  85 #define MT9V111_IFP_AWB_ADDON_RED(x)                    ((x & 0xff) << 8)       /* AWB red channel add-on */
  86 #define MT9V111_IFP_AWB_DELAY(x)                        (x & 0x7)               /* AWB reaction delay */
  87 #define MT9V111_IFP_AWB_SPEED(x)                        ((x & 0x7) << 3)        /* AWB speed */
  88 #define MT9V111_IFP_AWB_SATURATION_BLACKWHITE           0x3000                  /* black and white */
  89 #define MT9V111_IFP_AWB_SATURATION_25                   0x2000                  /* 25% of full saturation */
  90 #define MT9V111_IFP_AWB_SATURATION_37p5                 0x1800                  /* 37.5% of full saturation */
  91 #define MT9V111_IFP_AWB_SATURATION_50                   0x1000                  /* 50% of full saturation */
  92 #define MT9V111_IFP_AWB_SATURATION_75                   0x0800                  /* 75% of full saturation */
  93 #define MT9V111_IFP_AWB_SATURATION_FULL                 0x0000                  /* full color saturation */
  94 #define MT9V111_IFP_AWB_SATURATION_150                  0x2800                  /* 150% of full saturation */
  95 #define MT9V111_IFP_AWB_WINBOUNDARY_LEFT(x)             ((x/64) & 0xf)          /* left boundary of AWB meas. window */
  96 #define MT9V111_IFP_AWB_WINBOUNDARY_RIGHT(x)            (((x/64) & 0xf) << 4)   /* right boundary of AWB meas. window */
  97 #define MT9V111_IFP_AWB_WINBOUNDARY_TOP(x)              (((x/32) & 0xf) << 8)   /* top boundary of AWB meas. window */
  98 #define MT9V111_IFP_AWB_WINBOUNDARY_BOTTOM(x)           (((x/32) & 0xf) << 12)  /* bottom boundary of AWB meas. window */
  99
 100
 101 int mt9v111_select_address_space(struct usb_microdia *dev, __u8 address_space);
 102
 103 int mt9vx11_sensor_probe(struct usb_microdia *dev);
 104
 105 int mt9v111_setup_autoexposure(struct usb_microdia *dev);
 106
 107 int mt9v111_setup_autowhitebalance(struct usb_microdia *dev);
 108
 109 int mt9vx11_set_exposure(struct usb_microdia *dev);
 110
 111 int mt9vx11_set_hvflip(struct usb_microdia *dev);
 112
 113 int mt9v111_set_autoexposure(struct usb_microdia *dev);
 114
 115 int mt9v111_set_autowhitebalance(struct usb_microdia *dev);
 116
 117 int mt9v111_set_autocorrections(struct usb_microdia *dev, int enable);
 118
 119
 120 #endif