drivers/media/usb/gspca/stv06xx/stv06xx_vv6410.h

   1 /* SPDX-License-Identifier: GPL-2.0-or-later */
   2 /*
   3  * Copyright (c) 2001 Jean-Fredric Clere, Nikolas Zimmermann, Georg Acher
   4  *                    Mark Cave-Ayland, Carlo E Prelz, Dick Streefland
   5  * Copyright (c) 2002, 2003 Tuukka Toivonen
   6  * Copyright (c) 2008 Erik Andrén
   7  *
   8  * P/N 861037:      Sensor HDCS1000        ASIC STV0600
   9  * P/N 861050-0010: Sensor HDCS1000        ASIC STV0600
  10  * P/N 861050-0020: Sensor Photobit PB100  ASIC STV0600-1 - QuickCam Express
  11  * P/N 861055:      Sensor ST VV6410       ASIC STV0610   - LEGO cam
  12  * P/N 861075-0040: Sensor HDCS1000        ASIC
  13  * P/N 961179-0700: Sensor ST VV6410       ASIC STV0602   - Dexxa WebCam USB
  14  * P/N 861040-0000: Sensor ST VV6410       ASIC STV0610   - QuickCam Web
  15  */
  16
  17 #ifndef STV06XX_VV6410_H_
  18 #define STV06XX_VV6410_H_
  19
  20 #include "stv06xx_sensor.h"
  21
  22 #define VV6410_COLS                     416
  23 #define VV6410_ROWS                     320
  24
  25 /* Status registers */
  26 /* Chip identification number including revision indicator */
  27 #define VV6410_DEVICEH                  0x00
  28 #define VV6410_DEVICEL                  0x01
  29
  30 /* User can determine whether timed I2C data
  31    has been consumed by interrogating flag states */
  32 #define VV6410_STATUS0                  0x02
  33
  34 /* Current line counter value */
  35 #define VV6410_LINECOUNTH               0x03
  36 #define VV6410_LINECOUNTL               0x04
  37
  38 /* End x coordinate of image size */
  39 #define VV6410_XENDH                    0x05
  40 #define VV6410_XENDL                    0x06
  41
  42 /* End y coordinate of image size */
  43 #define VV6410_YENDH                    0x07
  44 #define VV6410_YENDL                    0x08
  45
  46 /* This is the average pixel value returned from the
  47    dark line offset cancellation algorithm */
  48 #define VV6410_DARKAVGH                 0x09
  49 #define VV6410_DARKAVGL                 0x0a
  50
  51 /* This is the average pixel value returned from the
  52    black line offset cancellation algorithm  */
  53 #define VV6410_BLACKAVGH                0x0b
  54 #define VV6410_BLACKAVGL                0x0c
  55
  56 /* Flags to indicate whether the x or y image coordinates have been clipped */
  57 #define VV6410_STATUS1                  0x0d
  58
  59 /* Setup registers */
  60
  61 /* Low-power/sleep modes & video timing */
  62 #define VV6410_SETUP0                   0x10
  63
  64 /* Various parameters */
  65 #define VV6410_SETUP1                   0x11
  66
  67 /* Contains pixel counter reset value used by external sync */
  68 #define VV6410_SYNCVALUE                0x12
  69
  70 /* Frame grabbing modes (FST, LST and QCK) */
  71 #define VV6410_FGMODES                  0x14
  72
  73 /* FST and QCK mapping modes. */
  74 #define VV6410_PINMAPPING               0x15
  75
  76 /* Data resolution */
  77 #define VV6410_DATAFORMAT               0x16
  78
  79 /* Output coding formats */
  80 #define VV6410_OPFORMAT                 0x17
  81
  82 /* Various mode select bits */
  83 #define VV6410_MODESELECT               0x18
  84
  85 /* Exposure registers */
  86 /* Fine exposure. */
  87 #define VV6410_FINEH                    0x20
  88 #define VV6410_FINEL                    0x21
  89
  90 /* Coarse exposure */
  91 #define VV6410_COARSEH                  0x22
  92 #define VV6410_COARSEL                  0x23
  93
  94 /* Analog gain setting */
  95 #define VV6410_ANALOGGAIN               0x24
  96
  97 /* Clock division */
  98 #define VV6410_CLKDIV                   0x25
  99
 100 /* Dark line offset cancellation value */
 101 #define VV6410_DARKOFFSETH              0x2c
 102 #define VV6410_DARKOFFSETL              0x2d
 103
 104 /* Dark line offset cancellation enable */
 105 #define VV6410_DARKOFFSETSETUP          0x2e
 106
 107 /* Video timing registers */
 108 /* Line Length (Pixel Clocks) */
 109 #define VV6410_LINELENGTHH              0x52
 110 #define VV6410_LINELENGTHL              0x53
 111
 112 /* X-co-ordinate of top left corner of region of interest (x-offset) */
 113 #define VV6410_XOFFSETH                 0x57
 114 #define VV6410_XOFFSETL                 0x58
 115
 116 /* Y-coordinate of top left corner of region of interest (y-offset) */
 117 #define VV6410_YOFFSETH                 0x59
 118 #define VV6410_YOFFSETL                 0x5a
 119
 120 /* Field length (Lines) */
 121 #define VV6410_FIELDLENGTHH             0x61
 122 #define VV6410_FIELDLENGTHL             0x62
 123
 124 /* System registers */
 125 /* Black offset cancellation default value */
 126 #define VV6410_BLACKOFFSETH             0x70
 127 #define VV6410_BLACKOFFSETL             0x71
 128
 129 /* Black offset cancellation setup */
 130 #define VV6410_BLACKOFFSETSETUP         0x72
 131
 132 /* Analog Control Register 0 */
 133 #define VV6410_CR0                      0x75
 134
 135 /* Analog Control Register 1 */
 136 #define VV6410_CR1                      0x76
 137
 138 /* ADC Setup Register */
 139 #define VV6410_AS0                      0x77
 140
 141 /* Analog Test Register */
 142 #define VV6410_AT0                      0x78
 143
 144 /* Audio Amplifier Setup Register */
 145 #define VV6410_AT1                      0x79
 146
 147 #define VV6410_HFLIP                    (1 << 3)
 148 #define VV6410_VFLIP                    (1 << 4)
 149
 150 #define VV6410_LOW_POWER_MODE           (1 << 0)
 151 #define VV6410_SOFT_RESET               (1 << 2)
 152 #define VV6410_PAL_25_FPS               (0 << 3)
 153
 154 #define VV6410_CLK_DIV_2                (1 << 1)
 155
 156 #define VV6410_FINE_EXPOSURE            320
 157 #define VV6410_COARSE_EXPOSURE          192
 158 #define VV6410_DEFAULT_GAIN             5
 159
 160 #define VV6410_SUBSAMPLE                0x01
 161 #define VV6410_CROP_TO_QVGA             0x02
 162
 163 #define VV6410_CIF_LINELENGTH           415
 164
 165 static int vv6410_probe(struct sd *sd);
 166 static int vv6410_start(struct sd *sd);
 167 static int vv6410_init(struct sd *sd);
 168 static int vv6410_init_controls(struct sd *sd);
 169 static int vv6410_stop(struct sd *sd);
 170 static int vv6410_dump(struct sd *sd);
 171
 172 /* V4L2 controls supported by the driver */
 173 static int vv6410_set_hflip(struct gspca_dev *gspca_dev, __s32 val);
 174 static int vv6410_set_vflip(struct gspca_dev *gspca_dev, __s32 val);
 175 static int vv6410_set_analog_gain(struct gspca_dev *gspca_dev, __s32 val);
 176 static int vv6410_set_exposure(struct gspca_dev *gspca_dev, __s32 val);
 177
 178 const struct stv06xx_sensor stv06xx_sensor_vv6410 = {
 179         .name = "ST VV6410",
 180         .i2c_flush = 5,
 181         .i2c_addr = 0x20,
 182         .i2c_len = 1,
 183         /* FIXME (see if we can lower packet_size-s, needs testing, and also
 184            adjusting framerate when the bandwidth gets lower) */
 185         .min_packet_size = { 1023 },
 186         .max_packet_size = { 1023 },
 187         .init = vv6410_init,
 188         .init_controls = vv6410_init_controls,
 189         .probe = vv6410_probe,
 190         .start = vv6410_start,
 191         .stop = vv6410_stop,
 192         .dump = vv6410_dump,
 193 };
 194
 195 /* If NULL, only single value to write, stored in len */
 196 struct stv_init {
 197         u16 addr;
 198         u8 data;
 199 };
 200
 201 static const struct stv_init stv_bridge_init[] = {
 202         /* This reg is written twice. Some kind of reset? */
 203         {STV_RESET, 0x80},
 204         {STV_RESET, 0x00},
 205         {STV_SCAN_RATE, 0x00},
 206         {STV_I2C_FLUSH, 0x04},
 207         {STV_REG00, 0x0b},
 208         {STV_REG01, 0xa7},
 209         {STV_REG02, 0xb7},
 210         {STV_REG03, 0x00},
 211         {STV_REG04, 0x00},
 212         {0x1536, 0x02},
 213         {0x1537, 0x00},
 214         {0x1538, 0x60},
 215         {0x1539, 0x01},
 216         {0x153a, 0x20},
 217         {0x153b, 0x01},
 218 };
 219
 220 static const u8 vv6410_sensor_init[][2] = {
 221         /* Setup registers */
 222         {VV6410_SETUP0, VV6410_SOFT_RESET},
 223         {VV6410_SETUP0, VV6410_LOW_POWER_MODE},
 224         /* Use shuffled read-out mode */
 225         {VV6410_SETUP1, BIT(6)},
 226         /* All modes to 1, FST, Fast QCK, Free running QCK, Free running LST, FST will qualify visible pixels */
 227         {VV6410_FGMODES, BIT(6) | BIT(4) | BIT(2) | BIT(0)},
 228         {VV6410_PINMAPPING, 0x00},
 229         /* Pre-clock generator divide off */
 230         {VV6410_DATAFORMAT, BIT(7) | BIT(0)},
 231
 232         {VV6410_CLKDIV, VV6410_CLK_DIV_2},
 233
 234         /* System registers */
 235         /* Enable voltage doubler */
 236         {VV6410_AS0, BIT(6) | BIT(4) | BIT(3) | BIT(2) | BIT(1)},
 237         {VV6410_AT0, 0x00},
 238         /* Power up audio, differential */
 239         {VV6410_AT1, BIT(4) | BIT(0)},
 240 };
 241
 242 #endif