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  * Copyright (c) 2008 Chia-I Wu
8  *
9  * P/N 861037:      Sensor HDCS1000        ASIC STV0600
10  * P/N 861050-0010: Sensor HDCS1000        ASIC STV0600
11  * P/N 861050-0020: Sensor Photobit PB100  ASIC STV0600-1 - QuickCam Express
12  * P/N 861055:      Sensor ST VV6410       ASIC STV0610   - LEGO cam
13  * P/N 861075-0040: Sensor HDCS1000        ASIC
14  * P/N 961179-0700: Sensor ST VV6410       ASIC STV0602   - Dexxa WebCam USB
15  * P/N 861040-0000: Sensor ST VV6410       ASIC STV0610   - QuickCam Web
16  */
17 
18 #ifndef STV06XX_HDCS_H_
19 #define STV06XX_HDCS_H_
20 
21 #include "stv06xx_sensor.h"
22 
23 #define HDCS_REG_CONFIG(sd)	(IS_1020(sd) ? HDCS20_CONFIG : HDCS00_CONFIG)
24 #define HDCS_REG_CONTROL(sd)	(IS_1020(sd) ? HDCS20_CONTROL : HDCS00_CONTROL)
25 
26 #define HDCS_1X00_DEF_WIDTH	360
27 #define HDCS_1X00_DEF_HEIGHT	296
28 
29 #define HDCS_1020_DEF_WIDTH	352
30 #define HDCS_1020_DEF_HEIGHT	292
31 
32 #define HDCS_1020_BOTTOM_Y_SKIP	4
33 
34 #define HDCS_CLK_FREQ_MHZ	25
35 
36 #define HDCS_ADC_START_SIG_DUR	3
37 
38 /* LSB bit of I2C or register address signifies write (0) or read (1) */
39 /* I2C Registers common for both HDCS-1000/1100 and HDCS-1020 */
40 /* Identifications Register */
41 #define HDCS_IDENT		(0x00 << 1)
42 /* Status Register */
43 #define HDCS_STATUS		(0x01 << 1)
44 /* Interrupt Mask Register */
45 #define HDCS_IMASK		(0x02 << 1)
46 /* Pad Control Register */
47 #define HDCS_PCTRL		(0x03 << 1)
48 /* Pad Drive Control Register */
49 #define HDCS_PDRV		(0x04 << 1)
50 /* Interface Control Register */
51 #define HDCS_ICTRL		(0x05 << 1)
52 /* Interface Timing Register */
53 #define HDCS_ITMG		(0x06 << 1)
54 /* Baud Fraction Register */
55 #define HDCS_BFRAC		(0x07 << 1)
56 /* Baud Rate Register */
57 #define HDCS_BRATE		(0x08 << 1)
58 /* ADC Control Register */
59 #define HDCS_ADCCTRL		(0x09 << 1)
60 /* First Window Row Register */
61 #define HDCS_FWROW		(0x0a << 1)
62 /* First Window Column Register */
63 #define HDCS_FWCOL		(0x0b << 1)
64 /* Last Window Row Register */
65 #define HDCS_LWROW		(0x0c << 1)
66 /* Last Window Column Register */
67 #define HDCS_LWCOL		(0x0d << 1)
68 /* Timing Control Register */
69 #define HDCS_TCTRL		(0x0e << 1)
70 /* PGA Gain Register: Even Row, Even Column */
71 #define HDCS_ERECPGA		(0x0f << 1)
72 /* PGA Gain Register: Even Row, Odd Column */
73 #define HDCS_EROCPGA		(0x10 << 1)
74 /* PGA Gain Register: Odd Row, Even Column */
75 #define HDCS_ORECPGA		(0x11 << 1)
76 /* PGA Gain Register: Odd Row, Odd Column */
77 #define HDCS_OROCPGA		(0x12 << 1)
78 /* Row Exposure Low Register */
79 #define HDCS_ROWEXPL		(0x13 << 1)
80 /* Row Exposure High Register */
81 #define HDCS_ROWEXPH		(0x14 << 1)
82 
83 /* I2C Registers only for HDCS-1000/1100 */
84 /* Sub-Row Exposure Low Register */
85 #define HDCS00_SROWEXPL		(0x15 << 1)
86 /* Sub-Row Exposure High Register */
87 #define HDCS00_SROWEXPH		(0x16 << 1)
88 /* Configuration Register */
89 #define HDCS00_CONFIG		(0x17 << 1)
90 /* Control Register */
91 #define HDCS00_CONTROL		(0x18 << 1)
92 
93 /* I2C Registers only for HDCS-1020 */
94 /* Sub-Row Exposure Register */
95 #define HDCS20_SROWEXP		(0x15 << 1)
96 /* Error Control Register */
97 #define HDCS20_ERROR		(0x16 << 1)
98 /* Interface Timing 2 Register */
99 #define HDCS20_ITMG2		(0x17 << 1)
100 /* Interface Control 2 Register	*/
101 #define HDCS20_ICTRL2		(0x18 << 1)
102 /* Horizontal Blank Register */
103 #define HDCS20_HBLANK		(0x19 << 1)
104 /* Vertical Blank Register */
105 #define HDCS20_VBLANK		(0x1a << 1)
106 /* Configuration Register */
107 #define HDCS20_CONFIG		(0x1b << 1)
108 /* Control Register */
109 #define HDCS20_CONTROL		(0x1c << 1)
110 
111 #define HDCS_RUN_ENABLE		(1 << 2)
112 #define HDCS_SLEEP_MODE		(1 << 1)
113 
114 #define HDCS_DEFAULT_EXPOSURE	48
115 #define HDCS_DEFAULT_GAIN	50
116 
117 static int hdcs_probe_1x00(struct sd *sd);
118 static int hdcs_probe_1020(struct sd *sd);
119 static int hdcs_start(struct sd *sd);
120 static int hdcs_init(struct sd *sd);
121 static int hdcs_init_controls(struct sd *sd);
122 static int hdcs_stop(struct sd *sd);
123 static int hdcs_dump(struct sd *sd);
124 
125 static int hdcs_set_exposure(struct gspca_dev *gspca_dev, __s32 val);
126 static int hdcs_set_gain(struct gspca_dev *gspca_dev, __s32 val);
127 
128 const struct stv06xx_sensor stv06xx_sensor_hdcs1x00 = {
129 	.name = "HP HDCS-1000/1100",
130 	.i2c_flush = 0,
131 	.i2c_addr = (0x55 << 1),
132 	.i2c_len = 1,
133 
134 	/* FIXME (see if we can lower min_packet_size, needs testing, and also
135 	   adjusting framerate when the bandwidth gets lower) */
136 	.min_packet_size = { 847 },
137 	.max_packet_size = { 847 },
138 
139 	.init = hdcs_init,
140 	.init_controls = hdcs_init_controls,
141 	.probe = hdcs_probe_1x00,
142 	.start = hdcs_start,
143 	.stop = hdcs_stop,
144 	.dump = hdcs_dump,
145 };
146 
147 const struct stv06xx_sensor stv06xx_sensor_hdcs1020 = {
148 	.name = "HDCS-1020",
149 	.i2c_flush = 0,
150 	.i2c_addr = (0x55 << 1),
151 	.i2c_len = 1,
152 
153 	/* FIXME (see if we can lower min_packet_size, needs testing, and also
154 	   adjusting framerate when the bandwidthm gets lower) */
155 	.min_packet_size = { 847 },
156 	.max_packet_size = { 847 },
157 
158 	.init = hdcs_init,
159 	.init_controls = hdcs_init_controls,
160 	.probe = hdcs_probe_1020,
161 	.start = hdcs_start,
162 	.stop = hdcs_stop,
163 	.dump = hdcs_dump,
164 };
165 
166 static const u16 stv_bridge_init[][2] = {
167 	{STV_ISO_ENABLE, 0},
168 	{STV_REG23, 0},
169 	{STV_REG00, 0x1d},
170 	{STV_REG01, 0xb5},
171 	{STV_REG02, 0xa8},
172 	{STV_REG03, 0x95},
173 	{STV_REG04, 0x07},
174 
175 	{STV_SCAN_RATE, 0x20},
176 	{STV_Y_CTRL, 0x01},
177 	{STV_X_CTRL, 0x0a}
178 };
179 
180 static const u8 stv_sensor_init[][2] = {
181 	/* Clear status (writing 1 will clear the corresponding status bit) */
182 	{HDCS_STATUS, BIT(6) | BIT(5) | BIT(4) | BIT(3) | BIT(2) | BIT(1)},
183 	/* Disable all interrupts */
184 	{HDCS_IMASK, 0x00},
185 	{HDCS_PCTRL, BIT(6) | BIT(5) | BIT(1) | BIT(0)},
186 	{HDCS_PDRV,  0x00},
187 	{HDCS_ICTRL, BIT(5)},
188 	{HDCS_ITMG,  BIT(4) | BIT(1)},
189 	/* ADC output resolution to 10 bits */
190 	{HDCS_ADCCTRL, 10}
191 };
192 
193 #endif
194