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 243