treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 157
[sfrench/cifs-2.6.git] / drivers / media / usb / gspca / stv06xx / stv06xx_pb0100.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_PB0100_H_
18 #define STV06XX_PB0100_H_
19
20 #include "stv06xx_sensor.h"
21
22 /* mode priv field flags */
23 #define PB0100_CROP_TO_VGA      0x01
24 #define PB0100_SUBSAMPLE        0x02
25
26 /* I2C Registers */
27 #define PB_IDENT                0x00    /* Chip Version */
28 #define PB_RSTART               0x01    /* Row Window Start */
29 #define PB_CSTART               0x02    /* Column Window Start */
30 #define PB_RWSIZE               0x03    /* Row Window Size */
31 #define PB_CWSIZE               0x04    /* Column  Window Size */
32 #define PB_CFILLIN              0x05    /* Column Fill-In */
33 #define PB_VBL                  0x06    /* Vertical Blank Count */
34 #define PB_CONTROL              0x07    /* Control Mode */
35 #define PB_FINTTIME             0x08    /* Integration Time/Frame Unit Count */
36 #define PB_RINTTIME             0x09    /* Integration Time/Row Unit Count */
37 #define PB_ROWSPEED             0x0a    /* Row Speed Control */
38 #define PB_ABORTFRAME           0x0b    /* Abort Frame */
39 #define PB_R12                  0x0c    /* Reserved */
40 #define PB_RESET                0x0d    /* Reset */
41 #define PB_EXPGAIN              0x0e    /* Exposure Gain Command */
42 #define PB_R15                  0x0f    /* Expose0 */
43 #define PB_R16                  0x10    /* Expose1 */
44 #define PB_R17                  0x11    /* Expose2 */
45 #define PB_R18                  0x12    /* Low0_DAC */
46 #define PB_R19                  0x13    /* Low1_DAC */
47 #define PB_R20                  0x14    /* Low2_DAC */
48 #define PB_R21                  0x15    /* Threshold11 */
49 #define PB_R22                  0x16    /* Threshold0x */
50 #define PB_UPDATEINT            0x17    /* Update Interval */
51 #define PB_R24                  0x18    /* High_DAC */
52 #define PB_R25                  0x19    /* Trans0H */
53 #define PB_R26                  0x1a    /* Trans1L */
54 #define PB_R27                  0x1b    /* Trans1H */
55 #define PB_R28                  0x1c    /* Trans2L */
56 #define PB_R29                  0x1d    /* Reserved */
57 #define PB_R30                  0x1e    /* Reserved */
58 #define PB_R31                  0x1f    /* Wait to Read */
59 #define PB_PREADCTRL            0x20    /* Pixel Read Control Mode */
60 #define PB_R33                  0x21    /* IREF_VLN */
61 #define PB_R34                  0x22    /* IREF_VLP */
62 #define PB_R35                  0x23    /* IREF_VLN_INTEG */
63 #define PB_R36                  0x24    /* IREF_MASTER */
64 #define PB_R37                  0x25    /* IDACP */
65 #define PB_R38                  0x26    /* IDACN */
66 #define PB_R39                  0x27    /* DAC_Control_Reg */
67 #define PB_R40                  0x28    /* VCL */
68 #define PB_R41                  0x29    /* IREF_VLN_ADCIN */
69 #define PB_R42                  0x2a    /* Reserved */
70 #define PB_G1GAIN               0x2b    /* Green 1 Gain */
71 #define PB_BGAIN                0x2c    /* Blue Gain */
72 #define PB_RGAIN                0x2d    /* Red Gain */
73 #define PB_G2GAIN               0x2e    /* Green 2 Gain */
74 #define PB_R47                  0x2f    /* Dark Row Address */
75 #define PB_R48                  0x30    /* Dark Row Options */
76 #define PB_R49                  0x31    /* Reserved */
77 #define PB_R50                  0x32    /* Image Test Data */
78 #define PB_ADCMAXGAIN           0x33    /* Maximum Gain */
79 #define PB_ADCMINGAIN           0x34    /* Minimum Gain */
80 #define PB_ADCGLOBALGAIN        0x35    /* Global Gain */
81 #define PB_R54                  0x36    /* Maximum Frame */
82 #define PB_R55                  0x37    /* Minimum Frame */
83 #define PB_R56                  0x38    /* Reserved */
84 #define PB_VOFFSET              0x39    /* VOFFSET */
85 #define PB_R58                  0x3a    /* Snap-Shot Sequence Trigger */
86 #define PB_ADCGAINH             0x3b    /* VREF_HI */
87 #define PB_ADCGAINL             0x3c    /* VREF_LO */
88 #define PB_R61                  0x3d    /* Reserved */
89 #define PB_R62                  0x3e    /* Reserved */
90 #define PB_R63                  0x3f    /* Reserved */
91 #define PB_R64                  0x40    /* Red/Blue Gain */
92 #define PB_R65                  0x41    /* Green 2/Green 1 Gain */
93 #define PB_R66                  0x42    /* VREF_HI/LO */
94 #define PB_R67                  0x43    /* Integration Time/Row Unit Count */
95 #define PB_R240                 0xf0    /* ADC Test */
96 #define PB_R241                 0xf1    /* Chip Enable */
97 #define PB_R242                 0xf2    /* Reserved */
98
99 static int pb0100_probe(struct sd *sd);
100 static int pb0100_start(struct sd *sd);
101 static int pb0100_init(struct sd *sd);
102 static int pb0100_init_controls(struct sd *sd);
103 static int pb0100_stop(struct sd *sd);
104 static int pb0100_dump(struct sd *sd);
105
106 /* V4L2 controls supported by the driver */
107 static int pb0100_set_gain(struct gspca_dev *gspca_dev, __s32 val);
108 static int pb0100_set_red_balance(struct gspca_dev *gspca_dev, __s32 val);
109 static int pb0100_set_blue_balance(struct gspca_dev *gspca_dev, __s32 val);
110 static int pb0100_set_exposure(struct gspca_dev *gspca_dev, __s32 val);
111 static int pb0100_set_autogain(struct gspca_dev *gspca_dev, __s32 val);
112 static int pb0100_set_autogain_target(struct gspca_dev *gspca_dev, __s32 val);
113
114 const struct stv06xx_sensor stv06xx_sensor_pb0100 = {
115         .name = "PB-0100",
116         .i2c_flush = 1,
117         .i2c_addr = 0xba,
118         .i2c_len = 2,
119
120         .min_packet_size = { 635, 847 },
121         .max_packet_size = { 847, 923 },
122
123         .init = pb0100_init,
124         .init_controls = pb0100_init_controls,
125         .probe = pb0100_probe,
126         .start = pb0100_start,
127         .stop = pb0100_stop,
128         .dump = pb0100_dump,
129 };
130
131 #endif