1 /*
2 * Quickcam cameras initialization data
3 *
4 * V4L2 by Jean-Francois Moine <http://moinejf.free.fr>
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 *
20 */
21 #define MODULE_NAME "tv8532"
22
23 #include "gspca.h"
24
25 MODULE_AUTHOR("Michel Xhaard <mxhaard@users.sourceforge.net>");
26 MODULE_DESCRIPTION("TV8532 USB Camera Driver");
27 MODULE_LICENSE("GPL");
28
29 /* specific webcam descriptor */
30 struct sd {
31 struct gspca_dev gspca_dev; /* !! must be the first item */
32
33 __u16 exposure;
34 __u16 gain;
35
36 __u8 packet;
37 };
38
39 /* V4L2 controls supported by the driver */
40 static int sd_setexposure(struct gspca_dev *gspca_dev, __s32 val);
41 static int sd_getexposure(struct gspca_dev *gspca_dev, __s32 *val);
42 static int sd_setgain(struct gspca_dev *gspca_dev, __s32 val);
43 static int sd_getgain(struct gspca_dev *gspca_dev, __s32 *val);
44
45 static const struct ctrl sd_ctrls[] = {
46 {
47 {
48 .id = V4L2_CID_EXPOSURE,
49 .type = V4L2_CTRL_TYPE_INTEGER,
50 .name = "Exposure",
51 .minimum = 1,
52 .maximum = 0x18f,
53 .step = 1,
54 #define EXPOSURE_DEF 0x18f
55 .default_value = EXPOSURE_DEF,
56 },
57 .set = sd_setexposure,
58 .get = sd_getexposure,
59 },
60 {
61 {
62 .id = V4L2_CID_GAIN,
63 .type = V4L2_CTRL_TYPE_INTEGER,
64 .name = "Gain",
65 .minimum = 0,
66 .maximum = 0x7ff,
67 .step = 1,
68 #define GAIN_DEF 0x100
69 .default_value = GAIN_DEF,
70 },
71 .set = sd_setgain,
72 .get = sd_getgain,
73 },
74 };
75
76 static const struct v4l2_pix_format sif_mode[] = {
77 {176, 144, V4L2_PIX_FMT_SBGGR8, V4L2_FIELD_NONE,
78 .bytesperline = 176,
79 .sizeimage = 176 * 144,
80 .colorspace = V4L2_COLORSPACE_SRGB,
81 .priv = 1},
82 {352, 288, V4L2_PIX_FMT_SBGGR8, V4L2_FIELD_NONE,
83 .bytesperline = 352,
84 .sizeimage = 352 * 288,
85 .colorspace = V4L2_COLORSPACE_SRGB,
86 .priv = 0},
87 };
88
89 /* TV-8532A (ICM532A) registers (LE) */
90 #define R00_PART_CONTROL 0x00
91 #define LATENT_CHANGE 0x80
92 #define EXPO_CHANGE 0x04
93 #define R01_TIMING_CONTROL_LOW 0x01
94 #define CMD_EEprom_Open 0x30
95 #define CMD_EEprom_Close 0x29
96 #define R03_TABLE_ADDR 0x03
97 #define R04_WTRAM_DATA_L 0x04
98 #define R05_WTRAM_DATA_M 0x05
99 #define R06_WTRAM_DATA_H 0x06
100 #define R07_TABLE_LEN 0x07
101 #define R08_RAM_WRITE_ACTION 0x08
102 #define R0C_AD_WIDTHL 0x0c
103 #define R0D_AD_WIDTHH 0x0d
104 #define R0E_AD_HEIGHTL 0x0e
105 #define R0F_AD_HEIGHTH 0x0f
106 #define R10_AD_COL_BEGINL 0x10
107 #define R11_AD_COL_BEGINH 0x11
108 #define MIRROR 0x04 /* [10] */
109 #define R14_AD_ROW_BEGINL 0x14
110 #define R15_AD_ROWBEGINH 0x15
111 #define R1C_AD_EXPOSE_TIMEL 0x1c
112 #define R20_GAIN_G1L 0x20
113 #define R21_GAIN_G1H 0x21
114 #define R22_GAIN_RL 0x22
115 #define R23_GAIN_RH 0x23
116 #define R24_GAIN_BL 0x24
117 #define R25_GAIN_BH 0x25
118 #define R26_GAIN_G2L 0x26
119 #define R27_GAIN_G2H 0x27
120 #define R28_QUANT 0x28
121 #define R29_LINE 0x29
122 #define R2C_POLARITY 0x2c
123 #define R2D_POINT 0x2d
124 #define R2E_POINTH 0x2e
125 #define R2F_POINTB 0x2f
126 #define R30_POINTBH 0x30
127 #define R31_UPD 0x31
128 #define R2A_HIGH_BUDGET 0x2a
129 #define R2B_LOW_BUDGET 0x2b
130 #define R34_VID 0x34
131 #define R35_VIDH 0x35
132 #define R36_PID 0x36
133 #define R37_PIDH 0x37
134 #define R39_Test1 0x39 /* GPIO */
135 #define R3B_Test3 0x3b /* GPIO */
136 #define R83_AD_IDH 0x83
137 #define R91_AD_SLOPEREG 0x91
138 #define R94_AD_BITCONTROL 0x94
139
140 static const u8 eeprom_data[][3] = {
141 /* dataH dataM dataL */
142 {0x01, 0x00, 0x01},
143 {0x01, 0x80, 0x11},
144 {0x05, 0x00, 0x14},
145 {0x05, 0x00, 0x1c},
146 {0x0d, 0x00, 0x1e},
147 {0x05, 0x00, 0x1f},
148 {0x05, 0x05, 0x19},
149 {0x05, 0x01, 0x1b},
150 {0x05, 0x09, 0x1e},
151 {0x0d, 0x89, 0x2e},
152 {0x05, 0x89, 0x2f},
153 {0x05, 0x0d, 0xd9},
154 {0x05, 0x09, 0xf1},
155 };
156
157
158 /* write 1 byte */
reg_w1(struct gspca_dev * gspca_dev,__u16 index,__u8 value)159 static void reg_w1(struct gspca_dev *gspca_dev,
160 __u16 index, __u8 value)
161 {
162 gspca_dev->usb_buf[0] = value;
163 usb_control_msg(gspca_dev->dev,
164 usb_sndctrlpipe(gspca_dev->dev, 0),
165 0x02,
166 USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
167 0, /* value */
168 index, gspca_dev->usb_buf, 1, 500);
169 }
170
171 /* write 2 bytes */
reg_w2(struct gspca_dev * gspca_dev,u16 index,u16 value)172 static void reg_w2(struct gspca_dev *gspca_dev,
173 u16 index, u16 value)
174 {
175 gspca_dev->usb_buf[0] = value;
176 gspca_dev->usb_buf[1] = value >> 8;
177 usb_control_msg(gspca_dev->dev,
178 usb_sndctrlpipe(gspca_dev->dev, 0),
179 0x02,
180 USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
181 0, /* value */
182 index, gspca_dev->usb_buf, 2, 500);
183 }
184
tv_8532WriteEEprom(struct gspca_dev * gspca_dev)185 static void tv_8532WriteEEprom(struct gspca_dev *gspca_dev)
186 {
187 int i;
188
189 reg_w1(gspca_dev, R01_TIMING_CONTROL_LOW, CMD_EEprom_Open);
190 for (i = 0; i < ARRAY_SIZE(eeprom_data); i++) {
191 reg_w1(gspca_dev, R03_TABLE_ADDR, i);
192 reg_w1(gspca_dev, R04_WTRAM_DATA_L, eeprom_data[i][2]);
193 reg_w1(gspca_dev, R05_WTRAM_DATA_M, eeprom_data[i][1]);
194 reg_w1(gspca_dev, R06_WTRAM_DATA_H, eeprom_data[i][0]);
195 reg_w1(gspca_dev, R08_RAM_WRITE_ACTION, 0);
196 }
197 reg_w1(gspca_dev, R07_TABLE_LEN, i);
198 reg_w1(gspca_dev, R01_TIMING_CONTROL_LOW, CMD_EEprom_Close);
199 }
200
201 /* this function is called at probe time */
sd_config(struct gspca_dev * gspca_dev,const struct usb_device_id * id)202 static int sd_config(struct gspca_dev *gspca_dev,
203 const struct usb_device_id *id)
204 {
205 struct sd *sd = (struct sd *) gspca_dev;
206 struct cam *cam;
207
208 cam = &gspca_dev->cam;
209 cam->cam_mode = sif_mode;
210 cam->nmodes = ARRAY_SIZE(sif_mode);
211
212 sd->exposure = EXPOSURE_DEF;
213 sd->gain = GAIN_DEF;
214 return 0;
215 }
216
tv_8532_setReg(struct gspca_dev * gspca_dev)217 static void tv_8532_setReg(struct gspca_dev *gspca_dev)
218 {
219 reg_w1(gspca_dev, R3B_Test3, 0x0a); /* Test0Sel = 10 */
220 /******************************************************/
221 reg_w1(gspca_dev, R0E_AD_HEIGHTL, 0x90);
222 reg_w1(gspca_dev, R0F_AD_HEIGHTH, 0x01);
223 reg_w2(gspca_dev, R1C_AD_EXPOSE_TIMEL, 0x018f);
224 reg_w1(gspca_dev, R10_AD_COL_BEGINL, 0x44);
225 /* begin active line */
226 reg_w1(gspca_dev, R11_AD_COL_BEGINH, 0x00);
227 /* mirror and digital gain */
228 reg_w1(gspca_dev, R14_AD_ROW_BEGINL, 0x0a);
229
230 reg_w1(gspca_dev, R94_AD_BITCONTROL, 0x02);
231 reg_w1(gspca_dev, R91_AD_SLOPEREG, 0x00);
232 reg_w1(gspca_dev, R00_PART_CONTROL, LATENT_CHANGE | EXPO_CHANGE);
233 /* = 0x84 */
234 }
235
236 /* this function is called at probe and resume time */
sd_init(struct gspca_dev * gspca_dev)237 static int sd_init(struct gspca_dev *gspca_dev)
238 {
239 tv_8532WriteEEprom(gspca_dev);
240
241 return 0;
242 }
243
setexposure(struct gspca_dev * gspca_dev)244 static void setexposure(struct gspca_dev *gspca_dev)
245 {
246 struct sd *sd = (struct sd *) gspca_dev;
247
248 reg_w2(gspca_dev, R1C_AD_EXPOSE_TIMEL, sd->exposure);
249 reg_w1(gspca_dev, R00_PART_CONTROL, LATENT_CHANGE | EXPO_CHANGE);
250 /* 0x84 */
251 }
252
setgain(struct gspca_dev * gspca_dev)253 static void setgain(struct gspca_dev *gspca_dev)
254 {
255 struct sd *sd = (struct sd *) gspca_dev;
256
257 reg_w2(gspca_dev, R20_GAIN_G1L, sd->gain);
258 reg_w2(gspca_dev, R22_GAIN_RL, sd->gain);
259 reg_w2(gspca_dev, R24_GAIN_BL, sd->gain);
260 reg_w2(gspca_dev, R26_GAIN_G2L, sd->gain);
261 }
262
263 /* -- start the camera -- */
sd_start(struct gspca_dev * gspca_dev)264 static int sd_start(struct gspca_dev *gspca_dev)
265 {
266 struct sd *sd = (struct sd *) gspca_dev;
267
268 reg_w1(gspca_dev, R0C_AD_WIDTHL, 0xe8); /* 0x20; 0x0c */
269 reg_w1(gspca_dev, R0D_AD_WIDTHH, 0x03);
270
271 /************************************************/
272 reg_w1(gspca_dev, R28_QUANT, 0x90);
273 /* 0x72 compressed mode 0x28 */
274 if (gspca_dev->cam.cam_mode[(int) gspca_dev->curr_mode].priv) {
275 /* 176x144 */
276 reg_w1(gspca_dev, R29_LINE, 0x41);
277 /* CIF - 2 lines/packet */
278 } else {
279 /* 352x288 */
280 reg_w1(gspca_dev, R29_LINE, 0x81);
281 /* CIF - 2 lines/packet */
282 }
283 /************************************************/
284 reg_w1(gspca_dev, R2C_POLARITY, 0x10); /* slow clock */
285 reg_w1(gspca_dev, R2D_POINT, 0x14);
286 reg_w1(gspca_dev, R2E_POINTH, 0x01);
287 reg_w1(gspca_dev, R2F_POINTB, 0x12);
288 reg_w1(gspca_dev, R30_POINTBH, 0x01);
289
290 tv_8532_setReg(gspca_dev);
291
292 setexposure(gspca_dev);
293 setgain(gspca_dev);
294
295 /************************************************/
296 reg_w1(gspca_dev, R31_UPD, 0x01); /* update registers */
297 msleep(200);
298 reg_w1(gspca_dev, R31_UPD, 0x00); /* end update */
299
300 gspca_dev->empty_packet = 0; /* check the empty packets */
301 sd->packet = 0; /* ignore the first packets */
302
303 return 0;
304 }
305
sd_stopN(struct gspca_dev * gspca_dev)306 static void sd_stopN(struct gspca_dev *gspca_dev)
307 {
308 reg_w1(gspca_dev, R3B_Test3, 0x0b); /* Test0Sel = 11 = GPIO */
309 }
310
sd_pkt_scan(struct gspca_dev * gspca_dev,u8 * data,int len)311 static void sd_pkt_scan(struct gspca_dev *gspca_dev,
312 u8 *data, /* isoc packet */
313 int len) /* iso packet length */
314 {
315 struct sd *sd = (struct sd *) gspca_dev;
316 int packet_type0, packet_type1;
317
318 packet_type0 = packet_type1 = INTER_PACKET;
319 if (gspca_dev->empty_packet) {
320 gspca_dev->empty_packet = 0;
321 sd->packet = gspca_dev->height / 2;
322 packet_type0 = FIRST_PACKET;
323 } else if (sd->packet == 0)
324 return; /* 2 more lines in 352x288 ! */
325 sd->packet--;
326 if (sd->packet == 0)
327 packet_type1 = LAST_PACKET;
328
329 /* each packet contains:
330 * - header 2 bytes
331 * - RGRG line
332 * - 4 bytes
333 * - GBGB line
334 * - 4 bytes
335 */
336 gspca_frame_add(gspca_dev, packet_type0,
337 data + 2, gspca_dev->width);
338 gspca_frame_add(gspca_dev, packet_type1,
339 data + gspca_dev->width + 5, gspca_dev->width);
340 }
341
sd_setexposure(struct gspca_dev * gspca_dev,__s32 val)342 static int sd_setexposure(struct gspca_dev *gspca_dev, __s32 val)
343 {
344 struct sd *sd = (struct sd *) gspca_dev;
345
346 sd->exposure = val;
347 if (gspca_dev->streaming)
348 setexposure(gspca_dev);
349 return 0;
350 }
351
sd_getexposure(struct gspca_dev * gspca_dev,__s32 * val)352 static int sd_getexposure(struct gspca_dev *gspca_dev, __s32 *val)
353 {
354 struct sd *sd = (struct sd *) gspca_dev;
355
356 *val = sd->exposure;
357 return 0;
358 }
359
sd_setgain(struct gspca_dev * gspca_dev,__s32 val)360 static int sd_setgain(struct gspca_dev *gspca_dev, __s32 val)
361 {
362 struct sd *sd = (struct sd *) gspca_dev;
363
364 sd->gain = val;
365 if (gspca_dev->streaming)
366 setgain(gspca_dev);
367 return 0;
368 }
369
sd_getgain(struct gspca_dev * gspca_dev,__s32 * val)370 static int sd_getgain(struct gspca_dev *gspca_dev, __s32 *val)
371 {
372 struct sd *sd = (struct sd *) gspca_dev;
373
374 *val = sd->gain;
375 return 0;
376 }
377
378 /* sub-driver description */
379 static const struct sd_desc sd_desc = {
380 .name = MODULE_NAME,
381 .ctrls = sd_ctrls,
382 .nctrls = ARRAY_SIZE(sd_ctrls),
383 .config = sd_config,
384 .init = sd_init,
385 .start = sd_start,
386 .stopN = sd_stopN,
387 .pkt_scan = sd_pkt_scan,
388 };
389
390 /* -- module initialisation -- */
391 static const struct usb_device_id device_table[] = {
392 {USB_DEVICE(0x046d, 0x0920)},
393 {USB_DEVICE(0x046d, 0x0921)},
394 {USB_DEVICE(0x0545, 0x808b)},
395 {USB_DEVICE(0x0545, 0x8333)},
396 {USB_DEVICE(0x0923, 0x010f)},
397 {}
398 };
399
400 MODULE_DEVICE_TABLE(usb, device_table);
401
402 /* -- device connect -- */
sd_probe(struct usb_interface * intf,const struct usb_device_id * id)403 static int sd_probe(struct usb_interface *intf,
404 const struct usb_device_id *id)
405 {
406 return gspca_dev_probe(intf, id, &sd_desc, sizeof(struct sd),
407 THIS_MODULE);
408 }
409
410 static struct usb_driver sd_driver = {
411 .name = MODULE_NAME,
412 .id_table = device_table,
413 .probe = sd_probe,
414 .disconnect = gspca_disconnect,
415 #ifdef CONFIG_PM
416 .suspend = gspca_suspend,
417 .resume = gspca_resume,
418 #endif
419 };
420
421 module_usb_driver(sd_driver);
422