Linux-2.6.12-rc2
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / drivers / usb / media / ov511.c
blob0fd7ffed3a980155c3514cd1da68246995e298fd
1 /*
2 * OmniVision OV511 Camera-to-USB Bridge Driver
4 * Copyright (c) 1999-2003 Mark W. McClelland
5 * Original decompression code Copyright 1998-2000 OmniVision Technologies
6 * Many improvements by Bret Wallach <bwallac1@san.rr.com>
7 * Color fixes by by Orion Sky Lawlor <olawlor@acm.org> (2/26/2000)
8 * Snapshot code by Kevin Moore
9 * OV7620 fixes by Charl P. Botha <cpbotha@ieee.org>
10 * Changes by Claudio Matsuoka <claudio@conectiva.com>
11 * Original SAA7111A code by Dave Perks <dperks@ibm.net>
12 * URB error messages from pwc driver by Nemosoft
13 * generic_ioctl() code from videodev.c by Gerd Knorr and Alan Cox
14 * Memory management (rvmalloc) code from bttv driver, by Gerd Knorr and others
16 * Based on the Linux CPiA driver written by Peter Pregler,
17 * Scott J. Bertin and Johannes Erdfelt.
19 * Please see the file: Documentation/usb/ov511.txt
20 * and the website at: http://alpha.dyndns.org/ov511
21 * for more info.
23 * This program is free software; you can redistribute it and/or modify it
24 * under the terms of the GNU General Public License as published by the
25 * Free Software Foundation; either version 2 of the License, or (at your
26 * option) any later version.
28 * This program is distributed in the hope that it will be useful, but
29 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
30 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
31 * for more details.
33 * You should have received a copy of the GNU General Public License
34 * along with this program; if not, write to the Free Software Foundation,
35 * Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
38 #include <linux/config.h>
39 #include <linux/module.h>
40 #include <linux/init.h>
41 #include <linux/vmalloc.h>
42 #include <linux/slab.h>
43 #include <linux/ctype.h>
44 #include <linux/pagemap.h>
45 #include <asm/semaphore.h>
46 #include <asm/processor.h>
47 #include <linux/mm.h>
48 #include <linux/device.h>
50 #if defined (__i386__)
51 #include <asm/cpufeature.h>
52 #endif
54 #include "ov511.h"
57 * Version Information
59 #define DRIVER_VERSION "v1.64 for Linux 2.5"
60 #define EMAIL "mark@alpha.dyndns.org"
61 #define DRIVER_AUTHOR "Mark McClelland <mark@alpha.dyndns.org> & Bret Wallach \
62 & Orion Sky Lawlor <olawlor@acm.org> & Kevin Moore & Charl P. Botha \
63 <cpbotha@ieee.org> & Claudio Matsuoka <claudio@conectiva.com>"
64 #define DRIVER_DESC "ov511 USB Camera Driver"
66 #define OV511_I2C_RETRIES 3
67 #define ENABLE_Y_QUANTABLE 1
68 #define ENABLE_UV_QUANTABLE 1
70 #define OV511_MAX_UNIT_VIDEO 16
72 /* Pixel count * bytes per YUV420 pixel (1.5) */
73 #define MAX_FRAME_SIZE(w, h) ((w) * (h) * 3 / 2)
75 #define MAX_DATA_SIZE(w, h) (MAX_FRAME_SIZE(w, h) + sizeof(struct timeval))
77 /* Max size * bytes per YUV420 pixel (1.5) + one extra isoc frame for safety */
78 #define MAX_RAW_DATA_SIZE(w, h) ((w) * (h) * 3 / 2 + 1024)
80 #define FATAL_ERROR(rc) ((rc) < 0 && (rc) != -EPERM)
82 /**********************************************************************
83 * Module Parameters
84 * (See ov511.txt for detailed descriptions of these)
85 **********************************************************************/
87 /* These variables (and all static globals) default to zero */
88 static int autobright = 1;
89 static int autogain = 1;
90 static int autoexp = 1;
91 static int debug;
92 static int snapshot;
93 static int cams = 1;
94 static int compress;
95 static int testpat;
96 static int dumppix;
97 static int led = 1;
98 static int dump_bridge;
99 static int dump_sensor;
100 static int printph;
101 static int phy = 0x1f;
102 static int phuv = 0x05;
103 static int pvy = 0x06;
104 static int pvuv = 0x06;
105 static int qhy = 0x14;
106 static int qhuv = 0x03;
107 static int qvy = 0x04;
108 static int qvuv = 0x04;
109 static int lightfreq;
110 static int bandingfilter;
111 static int clockdiv = -1;
112 static int packetsize = -1;
113 static int framedrop = -1;
114 static int fastset;
115 static int force_palette;
116 static int backlight;
117 static int unit_video[OV511_MAX_UNIT_VIDEO];
118 static int remove_zeros;
119 static int mirror;
120 static int ov518_color;
122 module_param(autobright, int, 0);
123 MODULE_PARM_DESC(autobright, "Sensor automatically changes brightness");
124 module_param(autogain, int, 0);
125 MODULE_PARM_DESC(autogain, "Sensor automatically changes gain");
126 module_param(autoexp, int, 0);
127 MODULE_PARM_DESC(autoexp, "Sensor automatically changes exposure");
128 module_param(debug, int, 0);
129 MODULE_PARM_DESC(debug,
130 "Debug level: 0=none, 1=inits, 2=warning, 3=config, 4=functions, 5=max");
131 module_param(snapshot, int, 0);
132 MODULE_PARM_DESC(snapshot, "Enable snapshot mode");
133 module_param(cams, int, 0);
134 MODULE_PARM_DESC(cams, "Number of simultaneous cameras");
135 module_param(compress, int, 0);
136 MODULE_PARM_DESC(compress, "Turn on compression");
137 module_param(testpat, int, 0);
138 MODULE_PARM_DESC(testpat,
139 "Replace image with vertical bar testpattern (only partially working)");
140 module_param(dumppix, int, 0);
141 MODULE_PARM_DESC(dumppix, "Dump raw pixel data");
142 module_param(led, int, 0);
143 MODULE_PARM_DESC(led,
144 "LED policy (OV511+ or later). 0=off, 1=on (default), 2=auto (on when open)");
145 module_param(dump_bridge, int, 0);
146 MODULE_PARM_DESC(dump_bridge, "Dump the bridge registers");
147 module_param(dump_sensor, int, 0);
148 MODULE_PARM_DESC(dump_sensor, "Dump the sensor registers");
149 module_param(printph, int, 0);
150 MODULE_PARM_DESC(printph, "Print frame start/end headers");
151 module_param(phy, int, 0);
152 MODULE_PARM_DESC(phy, "Prediction range (horiz. Y)");
153 module_param(phuv, int, 0);
154 MODULE_PARM_DESC(phuv, "Prediction range (horiz. UV)");
155 module_param(pvy, int, 0);
156 MODULE_PARM_DESC(pvy, "Prediction range (vert. Y)");
157 module_param(pvuv, int, 0);
158 MODULE_PARM_DESC(pvuv, "Prediction range (vert. UV)");
159 module_param(qhy, int, 0);
160 MODULE_PARM_DESC(qhy, "Quantization threshold (horiz. Y)");
161 module_param(qhuv, int, 0);
162 MODULE_PARM_DESC(qhuv, "Quantization threshold (horiz. UV)");
163 module_param(qvy, int, 0);
164 MODULE_PARM_DESC(qvy, "Quantization threshold (vert. Y)");
165 module_param(qvuv, int, 0);
166 MODULE_PARM_DESC(qvuv, "Quantization threshold (vert. UV)");
167 module_param(lightfreq, int, 0);
168 MODULE_PARM_DESC(lightfreq,
169 "Light frequency. Set to 50 or 60 Hz, or zero for default settings");
170 module_param(bandingfilter, int, 0);
171 MODULE_PARM_DESC(bandingfilter,
172 "Enable banding filter (to reduce effects of fluorescent lighting)");
173 module_param(clockdiv, int, 0);
174 MODULE_PARM_DESC(clockdiv, "Force pixel clock divisor to a specific value");
175 module_param(packetsize, int, 0);
176 MODULE_PARM_DESC(packetsize, "Force a specific isoc packet size");
177 module_param(framedrop, int, 0);
178 MODULE_PARM_DESC(framedrop, "Force a specific frame drop register setting");
179 module_param(fastset, int, 0);
180 MODULE_PARM_DESC(fastset, "Allows picture settings to take effect immediately");
181 module_param(force_palette, int, 0);
182 MODULE_PARM_DESC(force_palette, "Force the palette to a specific value");
183 module_param(backlight, int, 0);
184 MODULE_PARM_DESC(backlight, "For objects that are lit from behind");
185 static int num_uv;
186 module_param_array(unit_video, int, &num_uv, 0);
187 MODULE_PARM_DESC(unit_video,
188 "Force use of specific minor number(s). 0 is not allowed.");
189 module_param(remove_zeros, int, 0);
190 MODULE_PARM_DESC(remove_zeros,
191 "Remove zero-padding from uncompressed incoming data");
192 module_param(mirror, int, 0);
193 MODULE_PARM_DESC(mirror, "Reverse image horizontally");
194 module_param(ov518_color, int, 0);
195 MODULE_PARM_DESC(ov518_color, "Enable OV518 color (experimental)");
197 MODULE_AUTHOR(DRIVER_AUTHOR);
198 MODULE_DESCRIPTION(DRIVER_DESC);
199 MODULE_LICENSE("GPL");
201 /**********************************************************************
202 * Miscellaneous Globals
203 **********************************************************************/
205 static struct usb_driver ov511_driver;
207 static struct ov51x_decomp_ops *ov511_decomp_ops;
208 static struct ov51x_decomp_ops *ov511_mmx_decomp_ops;
209 static struct ov51x_decomp_ops *ov518_decomp_ops;
210 static struct ov51x_decomp_ops *ov518_mmx_decomp_ops;
212 /* Number of times to retry a failed I2C transaction. Increase this if you
213 * are getting "Failed to read sensor ID..." */
214 static int i2c_detect_tries = 5;
216 /* MMX support is present in kernel and CPU. Checked upon decomp module load. */
217 #if defined(__i386__) || defined(__x86_64__)
218 #define ov51x_mmx_available (cpu_has_mmx)
219 #else
220 #define ov51x_mmx_available (0)
221 #endif
223 static struct usb_device_id device_table [] = {
224 { USB_DEVICE(VEND_OMNIVISION, PROD_OV511) },
225 { USB_DEVICE(VEND_OMNIVISION, PROD_OV511PLUS) },
226 { USB_DEVICE(VEND_OMNIVISION, PROD_OV518) },
227 { USB_DEVICE(VEND_OMNIVISION, PROD_OV518PLUS) },
228 { USB_DEVICE(VEND_MATTEL, PROD_ME2CAM) },
229 { } /* Terminating entry */
232 MODULE_DEVICE_TABLE (usb, device_table);
234 static unsigned char yQuanTable511[] = OV511_YQUANTABLE;
235 static unsigned char uvQuanTable511[] = OV511_UVQUANTABLE;
236 static unsigned char yQuanTable518[] = OV518_YQUANTABLE;
237 static unsigned char uvQuanTable518[] = OV518_UVQUANTABLE;
239 /**********************************************************************
240 * Symbolic Names
241 **********************************************************************/
243 /* Known OV511-based cameras */
244 static struct symbolic_list camlist[] = {
245 { 0, "Generic Camera (no ID)" },
246 { 1, "Mustek WCam 3X" },
247 { 3, "D-Link DSB-C300" },
248 { 4, "Generic OV511/OV7610" },
249 { 5, "Puretek PT-6007" },
250 { 6, "Lifeview USB Life TV (NTSC)" },
251 { 21, "Creative Labs WebCam 3" },
252 { 22, "Lifeview USB Life TV (PAL D/K+B/G)" },
253 { 36, "Koala-Cam" },
254 { 38, "Lifeview USB Life TV (PAL)" },
255 { 41, "Samsung Anycam MPC-M10" },
256 { 43, "Mtekvision Zeca MV402" },
257 { 46, "Suma eON" },
258 { 70, "Lifeview USB Life TV (PAL/SECAM)" },
259 { 100, "Lifeview RoboCam" },
260 { 102, "AverMedia InterCam Elite" },
261 { 112, "MediaForte MV300" }, /* or OV7110 evaluation kit */
262 { 134, "Ezonics EZCam II" },
263 { 192, "Webeye 2000B" },
264 { 253, "Alpha Vision Tech. AlphaCam SE" },
265 { -1, NULL }
268 /* Video4Linux1 Palettes */
269 static struct symbolic_list v4l1_plist[] = {
270 { VIDEO_PALETTE_GREY, "GREY" },
271 { VIDEO_PALETTE_HI240, "HI240" },
272 { VIDEO_PALETTE_RGB565, "RGB565" },
273 { VIDEO_PALETTE_RGB24, "RGB24" },
274 { VIDEO_PALETTE_RGB32, "RGB32" },
275 { VIDEO_PALETTE_RGB555, "RGB555" },
276 { VIDEO_PALETTE_YUV422, "YUV422" },
277 { VIDEO_PALETTE_YUYV, "YUYV" },
278 { VIDEO_PALETTE_UYVY, "UYVY" },
279 { VIDEO_PALETTE_YUV420, "YUV420" },
280 { VIDEO_PALETTE_YUV411, "YUV411" },
281 { VIDEO_PALETTE_RAW, "RAW" },
282 { VIDEO_PALETTE_YUV422P,"YUV422P" },
283 { VIDEO_PALETTE_YUV411P,"YUV411P" },
284 { VIDEO_PALETTE_YUV420P,"YUV420P" },
285 { VIDEO_PALETTE_YUV410P,"YUV410P" },
286 { -1, NULL }
289 static struct symbolic_list brglist[] = {
290 { BRG_OV511, "OV511" },
291 { BRG_OV511PLUS, "OV511+" },
292 { BRG_OV518, "OV518" },
293 { BRG_OV518PLUS, "OV518+" },
294 { -1, NULL }
297 static struct symbolic_list senlist[] = {
298 { SEN_OV76BE, "OV76BE" },
299 { SEN_OV7610, "OV7610" },
300 { SEN_OV7620, "OV7620" },
301 { SEN_OV7620AE, "OV7620AE" },
302 { SEN_OV6620, "OV6620" },
303 { SEN_OV6630, "OV6630" },
304 { SEN_OV6630AE, "OV6630AE" },
305 { SEN_OV6630AF, "OV6630AF" },
306 { SEN_OV8600, "OV8600" },
307 { SEN_KS0127, "KS0127" },
308 { SEN_KS0127B, "KS0127B" },
309 { SEN_SAA7111A, "SAA7111A" },
310 { -1, NULL }
313 /* URB error codes: */
314 static struct symbolic_list urb_errlist[] = {
315 { -ENOSR, "Buffer error (overrun)" },
316 { -EPIPE, "Stalled (device not responding)" },
317 { -EOVERFLOW, "Babble (bad cable?)" },
318 { -EPROTO, "Bit-stuff error (bad cable?)" },
319 { -EILSEQ, "CRC/Timeout" },
320 { -ETIMEDOUT, "NAK (device does not respond)" },
321 { -1, NULL }
324 /**********************************************************************
325 * Memory management
326 **********************************************************************/
327 static void *
328 rvmalloc(unsigned long size)
330 void *mem;
331 unsigned long adr;
333 size = PAGE_ALIGN(size);
334 mem = vmalloc_32(size);
335 if (!mem)
336 return NULL;
338 memset(mem, 0, size); /* Clear the ram out, no junk to the user */
339 adr = (unsigned long) mem;
340 while (size > 0) {
341 SetPageReserved(vmalloc_to_page((void *)adr));
342 adr += PAGE_SIZE;
343 size -= PAGE_SIZE;
346 return mem;
349 static void
350 rvfree(void *mem, unsigned long size)
352 unsigned long adr;
354 if (!mem)
355 return;
357 adr = (unsigned long) mem;
358 while ((long) size > 0) {
359 ClearPageReserved(vmalloc_to_page((void *)adr));
360 adr += PAGE_SIZE;
361 size -= PAGE_SIZE;
363 vfree(mem);
366 /**********************************************************************
368 * Register I/O
370 **********************************************************************/
372 /* Write an OV51x register */
373 static int
374 reg_w(struct usb_ov511 *ov, unsigned char reg, unsigned char value)
376 int rc;
378 PDEBUG(5, "0x%02X:0x%02X", reg, value);
380 down(&ov->cbuf_lock);
381 ov->cbuf[0] = value;
382 rc = usb_control_msg(ov->dev,
383 usb_sndctrlpipe(ov->dev, 0),
384 (ov->bclass == BCL_OV518)?1:2 /* REG_IO */,
385 USB_TYPE_VENDOR | USB_RECIP_DEVICE,
386 0, (__u16)reg, &ov->cbuf[0], 1, 1000);
387 up(&ov->cbuf_lock);
389 if (rc < 0)
390 err("reg write: error %d: %s", rc, symbolic(urb_errlist, rc));
392 return rc;
395 /* Read from an OV51x register */
396 /* returns: negative is error, pos or zero is data */
397 static int
398 reg_r(struct usb_ov511 *ov, unsigned char reg)
400 int rc;
402 down(&ov->cbuf_lock);
403 rc = usb_control_msg(ov->dev,
404 usb_rcvctrlpipe(ov->dev, 0),
405 (ov->bclass == BCL_OV518)?1:3 /* REG_IO */,
406 USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
407 0, (__u16)reg, &ov->cbuf[0], 1, 1000);
409 if (rc < 0) {
410 err("reg read: error %d: %s", rc, symbolic(urb_errlist, rc));
411 } else {
412 rc = ov->cbuf[0];
413 PDEBUG(5, "0x%02X:0x%02X", reg, ov->cbuf[0]);
416 up(&ov->cbuf_lock);
418 return rc;
422 * Writes bits at positions specified by mask to an OV51x reg. Bits that are in
423 * the same position as 1's in "mask" are cleared and set to "value". Bits
424 * that are in the same position as 0's in "mask" are preserved, regardless
425 * of their respective state in "value".
427 static int
428 reg_w_mask(struct usb_ov511 *ov,
429 unsigned char reg,
430 unsigned char value,
431 unsigned char mask)
433 int ret;
434 unsigned char oldval, newval;
436 ret = reg_r(ov, reg);
437 if (ret < 0)
438 return ret;
440 oldval = (unsigned char) ret;
441 oldval &= (~mask); /* Clear the masked bits */
442 value &= mask; /* Enforce mask on value */
443 newval = oldval | value; /* Set the desired bits */
445 return (reg_w(ov, reg, newval));
449 * Writes multiple (n) byte value to a single register. Only valid with certain
450 * registers (0x30 and 0xc4 - 0xce).
452 static int
453 ov518_reg_w32(struct usb_ov511 *ov, unsigned char reg, u32 val, int n)
455 int rc;
457 PDEBUG(5, "0x%02X:%7d, n=%d", reg, val, n);
459 down(&ov->cbuf_lock);
461 *((__le32 *)ov->cbuf) = __cpu_to_le32(val);
463 rc = usb_control_msg(ov->dev,
464 usb_sndctrlpipe(ov->dev, 0),
465 1 /* REG_IO */,
466 USB_TYPE_VENDOR | USB_RECIP_DEVICE,
467 0, (__u16)reg, ov->cbuf, n, 1000);
468 up(&ov->cbuf_lock);
470 if (rc < 0)
471 err("reg write multiple: error %d: %s", rc,
472 symbolic(urb_errlist, rc));
474 return rc;
477 static int
478 ov511_upload_quan_tables(struct usb_ov511 *ov)
480 unsigned char *pYTable = yQuanTable511;
481 unsigned char *pUVTable = uvQuanTable511;
482 unsigned char val0, val1;
483 int i, rc, reg = R511_COMP_LUT_BEGIN;
485 PDEBUG(4, "Uploading quantization tables");
487 for (i = 0; i < OV511_QUANTABLESIZE / 2; i++) {
488 if (ENABLE_Y_QUANTABLE) {
489 val0 = *pYTable++;
490 val1 = *pYTable++;
491 val0 &= 0x0f;
492 val1 &= 0x0f;
493 val0 |= val1 << 4;
494 rc = reg_w(ov, reg, val0);
495 if (rc < 0)
496 return rc;
499 if (ENABLE_UV_QUANTABLE) {
500 val0 = *pUVTable++;
501 val1 = *pUVTable++;
502 val0 &= 0x0f;
503 val1 &= 0x0f;
504 val0 |= val1 << 4;
505 rc = reg_w(ov, reg + OV511_QUANTABLESIZE/2, val0);
506 if (rc < 0)
507 return rc;
510 reg++;
513 return 0;
516 /* OV518 quantization tables are 8x4 (instead of 8x8) */
517 static int
518 ov518_upload_quan_tables(struct usb_ov511 *ov)
520 unsigned char *pYTable = yQuanTable518;
521 unsigned char *pUVTable = uvQuanTable518;
522 unsigned char val0, val1;
523 int i, rc, reg = R511_COMP_LUT_BEGIN;
525 PDEBUG(4, "Uploading quantization tables");
527 for (i = 0; i < OV518_QUANTABLESIZE / 2; i++) {
528 if (ENABLE_Y_QUANTABLE) {
529 val0 = *pYTable++;
530 val1 = *pYTable++;
531 val0 &= 0x0f;
532 val1 &= 0x0f;
533 val0 |= val1 << 4;
534 rc = reg_w(ov, reg, val0);
535 if (rc < 0)
536 return rc;
539 if (ENABLE_UV_QUANTABLE) {
540 val0 = *pUVTable++;
541 val1 = *pUVTable++;
542 val0 &= 0x0f;
543 val1 &= 0x0f;
544 val0 |= val1 << 4;
545 rc = reg_w(ov, reg + OV518_QUANTABLESIZE/2, val0);
546 if (rc < 0)
547 return rc;
550 reg++;
553 return 0;
556 static int
557 ov51x_reset(struct usb_ov511 *ov, unsigned char reset_type)
559 int rc;
561 /* Setting bit 0 not allowed on 518/518Plus */
562 if (ov->bclass == BCL_OV518)
563 reset_type &= 0xfe;
565 PDEBUG(4, "Reset: type=0x%02X", reset_type);
567 rc = reg_w(ov, R51x_SYS_RESET, reset_type);
568 rc = reg_w(ov, R51x_SYS_RESET, 0);
570 if (rc < 0)
571 err("reset: command failed");
573 return rc;
576 /**********************************************************************
578 * Low-level I2C I/O functions
580 **********************************************************************/
582 /* NOTE: Do not call this function directly!
583 * The OV518 I2C I/O procedure is different, hence, this function.
584 * This is normally only called from i2c_w(). Note that this function
585 * always succeeds regardless of whether the sensor is present and working.
587 static int
588 ov518_i2c_write_internal(struct usb_ov511 *ov,
589 unsigned char reg,
590 unsigned char value)
592 int rc;
594 PDEBUG(5, "0x%02X:0x%02X", reg, value);
596 /* Select camera register */
597 rc = reg_w(ov, R51x_I2C_SADDR_3, reg);
598 if (rc < 0)
599 return rc;
601 /* Write "value" to I2C data port of OV511 */
602 rc = reg_w(ov, R51x_I2C_DATA, value);
603 if (rc < 0)
604 return rc;
606 /* Initiate 3-byte write cycle */
607 rc = reg_w(ov, R518_I2C_CTL, 0x01);
608 if (rc < 0)
609 return rc;
611 return 0;
614 /* NOTE: Do not call this function directly! */
615 static int
616 ov511_i2c_write_internal(struct usb_ov511 *ov,
617 unsigned char reg,
618 unsigned char value)
620 int rc, retries;
622 PDEBUG(5, "0x%02X:0x%02X", reg, value);
624 /* Three byte write cycle */
625 for (retries = OV511_I2C_RETRIES; ; ) {
626 /* Select camera register */
627 rc = reg_w(ov, R51x_I2C_SADDR_3, reg);
628 if (rc < 0)
629 break;
631 /* Write "value" to I2C data port of OV511 */
632 rc = reg_w(ov, R51x_I2C_DATA, value);
633 if (rc < 0)
634 break;
636 /* Initiate 3-byte write cycle */
637 rc = reg_w(ov, R511_I2C_CTL, 0x01);
638 if (rc < 0)
639 break;
641 /* Retry until idle */
643 rc = reg_r(ov, R511_I2C_CTL);
644 while (rc > 0 && ((rc&1) == 0));
645 if (rc < 0)
646 break;
648 /* Ack? */
649 if ((rc&2) == 0) {
650 rc = 0;
651 break;
653 #if 0
654 /* I2C abort */
655 reg_w(ov, R511_I2C_CTL, 0x10);
656 #endif
657 if (--retries < 0) {
658 err("i2c write retries exhausted");
659 rc = -1;
660 break;
664 return rc;
667 /* NOTE: Do not call this function directly!
668 * The OV518 I2C I/O procedure is different, hence, this function.
669 * This is normally only called from i2c_r(). Note that this function
670 * always succeeds regardless of whether the sensor is present and working.
672 static int
673 ov518_i2c_read_internal(struct usb_ov511 *ov, unsigned char reg)
675 int rc, value;
677 /* Select camera register */
678 rc = reg_w(ov, R51x_I2C_SADDR_2, reg);
679 if (rc < 0)
680 return rc;
682 /* Initiate 2-byte write cycle */
683 rc = reg_w(ov, R518_I2C_CTL, 0x03);
684 if (rc < 0)
685 return rc;
687 /* Initiate 2-byte read cycle */
688 rc = reg_w(ov, R518_I2C_CTL, 0x05);
689 if (rc < 0)
690 return rc;
692 value = reg_r(ov, R51x_I2C_DATA);
694 PDEBUG(5, "0x%02X:0x%02X", reg, value);
696 return value;
699 /* NOTE: Do not call this function directly!
700 * returns: negative is error, pos or zero is data */
701 static int
702 ov511_i2c_read_internal(struct usb_ov511 *ov, unsigned char reg)
704 int rc, value, retries;
706 /* Two byte write cycle */
707 for (retries = OV511_I2C_RETRIES; ; ) {
708 /* Select camera register */
709 rc = reg_w(ov, R51x_I2C_SADDR_2, reg);
710 if (rc < 0)
711 return rc;
713 /* Initiate 2-byte write cycle */
714 rc = reg_w(ov, R511_I2C_CTL, 0x03);
715 if (rc < 0)
716 return rc;
718 /* Retry until idle */
720 rc = reg_r(ov, R511_I2C_CTL);
721 while (rc > 0 && ((rc&1) == 0));
722 if (rc < 0)
723 return rc;
725 if ((rc&2) == 0) /* Ack? */
726 break;
728 /* I2C abort */
729 reg_w(ov, R511_I2C_CTL, 0x10);
731 if (--retries < 0) {
732 err("i2c write retries exhausted");
733 return -1;
737 /* Two byte read cycle */
738 for (retries = OV511_I2C_RETRIES; ; ) {
739 /* Initiate 2-byte read cycle */
740 rc = reg_w(ov, R511_I2C_CTL, 0x05);
741 if (rc < 0)
742 return rc;
744 /* Retry until idle */
746 rc = reg_r(ov, R511_I2C_CTL);
747 while (rc > 0 && ((rc&1) == 0));
748 if (rc < 0)
749 return rc;
751 if ((rc&2) == 0) /* Ack? */
752 break;
754 /* I2C abort */
755 rc = reg_w(ov, R511_I2C_CTL, 0x10);
756 if (rc < 0)
757 return rc;
759 if (--retries < 0) {
760 err("i2c read retries exhausted");
761 return -1;
765 value = reg_r(ov, R51x_I2C_DATA);
767 PDEBUG(5, "0x%02X:0x%02X", reg, value);
769 /* This is needed to make i2c_w() work */
770 rc = reg_w(ov, R511_I2C_CTL, 0x05);
771 if (rc < 0)
772 return rc;
774 return value;
777 /* returns: negative is error, pos or zero is data */
778 static int
779 i2c_r(struct usb_ov511 *ov, unsigned char reg)
781 int rc;
783 down(&ov->i2c_lock);
785 if (ov->bclass == BCL_OV518)
786 rc = ov518_i2c_read_internal(ov, reg);
787 else
788 rc = ov511_i2c_read_internal(ov, reg);
790 up(&ov->i2c_lock);
792 return rc;
795 static int
796 i2c_w(struct usb_ov511 *ov, unsigned char reg, unsigned char value)
798 int rc;
800 down(&ov->i2c_lock);
802 if (ov->bclass == BCL_OV518)
803 rc = ov518_i2c_write_internal(ov, reg, value);
804 else
805 rc = ov511_i2c_write_internal(ov, reg, value);
807 up(&ov->i2c_lock);
809 return rc;
812 /* Do not call this function directly! */
813 static int
814 ov51x_i2c_write_mask_internal(struct usb_ov511 *ov,
815 unsigned char reg,
816 unsigned char value,
817 unsigned char mask)
819 int rc;
820 unsigned char oldval, newval;
822 if (mask == 0xff) {
823 newval = value;
824 } else {
825 if (ov->bclass == BCL_OV518)
826 rc = ov518_i2c_read_internal(ov, reg);
827 else
828 rc = ov511_i2c_read_internal(ov, reg);
829 if (rc < 0)
830 return rc;
832 oldval = (unsigned char) rc;
833 oldval &= (~mask); /* Clear the masked bits */
834 value &= mask; /* Enforce mask on value */
835 newval = oldval | value; /* Set the desired bits */
838 if (ov->bclass == BCL_OV518)
839 return (ov518_i2c_write_internal(ov, reg, newval));
840 else
841 return (ov511_i2c_write_internal(ov, reg, newval));
844 /* Writes bits at positions specified by mask to an I2C reg. Bits that are in
845 * the same position as 1's in "mask" are cleared and set to "value". Bits
846 * that are in the same position as 0's in "mask" are preserved, regardless
847 * of their respective state in "value".
849 static int
850 i2c_w_mask(struct usb_ov511 *ov,
851 unsigned char reg,
852 unsigned char value,
853 unsigned char mask)
855 int rc;
857 down(&ov->i2c_lock);
858 rc = ov51x_i2c_write_mask_internal(ov, reg, value, mask);
859 up(&ov->i2c_lock);
861 return rc;
864 /* Set the read and write slave IDs. The "slave" argument is the write slave,
865 * and the read slave will be set to (slave + 1). ov->i2c_lock should be held
866 * when calling this. This should not be called from outside the i2c I/O
867 * functions.
869 static int
870 i2c_set_slave_internal(struct usb_ov511 *ov, unsigned char slave)
872 int rc;
874 rc = reg_w(ov, R51x_I2C_W_SID, slave);
875 if (rc < 0)
876 return rc;
878 rc = reg_w(ov, R51x_I2C_R_SID, slave + 1);
879 if (rc < 0)
880 return rc;
882 return 0;
885 /* Write to a specific I2C slave ID and register, using the specified mask */
886 static int
887 i2c_w_slave(struct usb_ov511 *ov,
888 unsigned char slave,
889 unsigned char reg,
890 unsigned char value,
891 unsigned char mask)
893 int rc = 0;
895 down(&ov->i2c_lock);
897 /* Set new slave IDs */
898 rc = i2c_set_slave_internal(ov, slave);
899 if (rc < 0)
900 goto out;
902 rc = ov51x_i2c_write_mask_internal(ov, reg, value, mask);
904 out:
905 /* Restore primary IDs */
906 if (i2c_set_slave_internal(ov, ov->primary_i2c_slave) < 0)
907 err("Couldn't restore primary I2C slave");
909 up(&ov->i2c_lock);
910 return rc;
913 /* Read from a specific I2C slave ID and register */
914 static int
915 i2c_r_slave(struct usb_ov511 *ov,
916 unsigned char slave,
917 unsigned char reg)
919 int rc;
921 down(&ov->i2c_lock);
923 /* Set new slave IDs */
924 rc = i2c_set_slave_internal(ov, slave);
925 if (rc < 0)
926 goto out;
928 if (ov->bclass == BCL_OV518)
929 rc = ov518_i2c_read_internal(ov, reg);
930 else
931 rc = ov511_i2c_read_internal(ov, reg);
933 out:
934 /* Restore primary IDs */
935 if (i2c_set_slave_internal(ov, ov->primary_i2c_slave) < 0)
936 err("Couldn't restore primary I2C slave");
938 up(&ov->i2c_lock);
939 return rc;
942 /* Sets I2C read and write slave IDs. Returns <0 for error */
943 static int
944 ov51x_set_slave_ids(struct usb_ov511 *ov, unsigned char sid)
946 int rc;
948 down(&ov->i2c_lock);
950 rc = i2c_set_slave_internal(ov, sid);
951 if (rc < 0)
952 goto out;
954 // FIXME: Is this actually necessary?
955 rc = ov51x_reset(ov, OV511_RESET_NOREGS);
956 out:
957 up(&ov->i2c_lock);
958 return rc;
961 static int
962 write_regvals(struct usb_ov511 *ov, struct ov511_regvals * pRegvals)
964 int rc;
966 while (pRegvals->bus != OV511_DONE_BUS) {
967 if (pRegvals->bus == OV511_REG_BUS) {
968 if ((rc = reg_w(ov, pRegvals->reg, pRegvals->val)) < 0)
969 return rc;
970 } else if (pRegvals->bus == OV511_I2C_BUS) {
971 if ((rc = i2c_w(ov, pRegvals->reg, pRegvals->val)) < 0)
972 return rc;
973 } else {
974 err("Bad regval array");
975 return -1;
977 pRegvals++;
979 return 0;
982 #ifdef OV511_DEBUG
983 static void
984 dump_i2c_range(struct usb_ov511 *ov, int reg1, int regn)
986 int i, rc;
988 for (i = reg1; i <= regn; i++) {
989 rc = i2c_r(ov, i);
990 info("Sensor[0x%02X] = 0x%02X", i, rc);
994 static void
995 dump_i2c_regs(struct usb_ov511 *ov)
997 info("I2C REGS");
998 dump_i2c_range(ov, 0x00, 0x7C);
1001 static void
1002 dump_reg_range(struct usb_ov511 *ov, int reg1, int regn)
1004 int i, rc;
1006 for (i = reg1; i <= regn; i++) {
1007 rc = reg_r(ov, i);
1008 info("OV511[0x%02X] = 0x%02X", i, rc);
1012 static void
1013 ov511_dump_regs(struct usb_ov511 *ov)
1015 info("CAMERA INTERFACE REGS");
1016 dump_reg_range(ov, 0x10, 0x1f);
1017 info("DRAM INTERFACE REGS");
1018 dump_reg_range(ov, 0x20, 0x23);
1019 info("ISO FIFO REGS");
1020 dump_reg_range(ov, 0x30, 0x31);
1021 info("PIO REGS");
1022 dump_reg_range(ov, 0x38, 0x39);
1023 dump_reg_range(ov, 0x3e, 0x3e);
1024 info("I2C REGS");
1025 dump_reg_range(ov, 0x40, 0x49);
1026 info("SYSTEM CONTROL REGS");
1027 dump_reg_range(ov, 0x50, 0x55);
1028 dump_reg_range(ov, 0x5e, 0x5f);
1029 info("OmniCE REGS");
1030 dump_reg_range(ov, 0x70, 0x79);
1031 /* NOTE: Quantization tables are not readable. You will get the value
1032 * in reg. 0x79 for every table register */
1033 dump_reg_range(ov, 0x80, 0x9f);
1034 dump_reg_range(ov, 0xa0, 0xbf);
1038 static void
1039 ov518_dump_regs(struct usb_ov511 *ov)
1041 info("VIDEO MODE REGS");
1042 dump_reg_range(ov, 0x20, 0x2f);
1043 info("DATA PUMP AND SNAPSHOT REGS");
1044 dump_reg_range(ov, 0x30, 0x3f);
1045 info("I2C REGS");
1046 dump_reg_range(ov, 0x40, 0x4f);
1047 info("SYSTEM CONTROL AND VENDOR REGS");
1048 dump_reg_range(ov, 0x50, 0x5f);
1049 info("60 - 6F");
1050 dump_reg_range(ov, 0x60, 0x6f);
1051 info("70 - 7F");
1052 dump_reg_range(ov, 0x70, 0x7f);
1053 info("Y QUANTIZATION TABLE");
1054 dump_reg_range(ov, 0x80, 0x8f);
1055 info("UV QUANTIZATION TABLE");
1056 dump_reg_range(ov, 0x90, 0x9f);
1057 info("A0 - BF");
1058 dump_reg_range(ov, 0xa0, 0xbf);
1059 info("CBR");
1060 dump_reg_range(ov, 0xc0, 0xcf);
1062 #endif
1064 /*****************************************************************************/
1066 /* Temporarily stops OV511 from functioning. Must do this before changing
1067 * registers while the camera is streaming */
1068 static inline int
1069 ov51x_stop(struct usb_ov511 *ov)
1071 PDEBUG(4, "stopping");
1072 ov->stopped = 1;
1073 if (ov->bclass == BCL_OV518)
1074 return (reg_w_mask(ov, R51x_SYS_RESET, 0x3a, 0x3a));
1075 else
1076 return (reg_w(ov, R51x_SYS_RESET, 0x3d));
1079 /* Restarts OV511 after ov511_stop() is called. Has no effect if it is not
1080 * actually stopped (for performance). */
1081 static inline int
1082 ov51x_restart(struct usb_ov511 *ov)
1084 if (ov->stopped) {
1085 PDEBUG(4, "restarting");
1086 ov->stopped = 0;
1088 /* Reinitialize the stream */
1089 if (ov->bclass == BCL_OV518)
1090 reg_w(ov, 0x2f, 0x80);
1092 return (reg_w(ov, R51x_SYS_RESET, 0x00));
1095 return 0;
1098 /* Sleeps until no frames are active. Returns !0 if got signal */
1099 static int
1100 ov51x_wait_frames_inactive(struct usb_ov511 *ov)
1102 return wait_event_interruptible(ov->wq, ov->curframe < 0);
1105 /* Resets the hardware snapshot button */
1106 static void
1107 ov51x_clear_snapshot(struct usb_ov511 *ov)
1109 if (ov->bclass == BCL_OV511) {
1110 reg_w(ov, R51x_SYS_SNAP, 0x00);
1111 reg_w(ov, R51x_SYS_SNAP, 0x02);
1112 reg_w(ov, R51x_SYS_SNAP, 0x00);
1113 } else if (ov->bclass == BCL_OV518) {
1114 warn("snapshot reset not supported yet on OV518(+)");
1115 } else {
1116 err("clear snap: invalid bridge type");
1120 #if 0
1121 /* Checks the status of the snapshot button. Returns 1 if it was pressed since
1122 * it was last cleared, and zero in all other cases (including errors) */
1123 static int
1124 ov51x_check_snapshot(struct usb_ov511 *ov)
1126 int ret, status = 0;
1128 if (ov->bclass == BCL_OV511) {
1129 ret = reg_r(ov, R51x_SYS_SNAP);
1130 if (ret < 0) {
1131 err("Error checking snspshot status (%d)", ret);
1132 } else if (ret & 0x08) {
1133 status = 1;
1135 } else if (ov->bclass == BCL_OV518) {
1136 warn("snapshot check not supported yet on OV518(+)");
1137 } else {
1138 err("check snap: invalid bridge type");
1141 return status;
1143 #endif
1145 /* This does an initial reset of an OmniVision sensor and ensures that I2C
1146 * is synchronized. Returns <0 for failure.
1148 static int
1149 init_ov_sensor(struct usb_ov511 *ov)
1151 int i, success;
1153 /* Reset the sensor */
1154 if (i2c_w(ov, 0x12, 0x80) < 0)
1155 return -EIO;
1157 /* Wait for it to initialize */
1158 msleep(150);
1160 for (i = 0, success = 0; i < i2c_detect_tries && !success; i++) {
1161 if ((i2c_r(ov, OV7610_REG_ID_HIGH) == 0x7F) &&
1162 (i2c_r(ov, OV7610_REG_ID_LOW) == 0xA2)) {
1163 success = 1;
1164 continue;
1167 /* Reset the sensor */
1168 if (i2c_w(ov, 0x12, 0x80) < 0)
1169 return -EIO;
1170 /* Wait for it to initialize */
1171 msleep(150);
1172 /* Dummy read to sync I2C */
1173 if (i2c_r(ov, 0x00) < 0)
1174 return -EIO;
1177 if (!success)
1178 return -EIO;
1180 PDEBUG(1, "I2C synced in %d attempt(s)", i);
1182 return 0;
1185 static int
1186 ov511_set_packet_size(struct usb_ov511 *ov, int size)
1188 int alt, mult;
1190 if (ov51x_stop(ov) < 0)
1191 return -EIO;
1193 mult = size >> 5;
1195 if (ov->bridge == BRG_OV511) {
1196 if (size == 0)
1197 alt = OV511_ALT_SIZE_0;
1198 else if (size == 257)
1199 alt = OV511_ALT_SIZE_257;
1200 else if (size == 513)
1201 alt = OV511_ALT_SIZE_513;
1202 else if (size == 769)
1203 alt = OV511_ALT_SIZE_769;
1204 else if (size == 993)
1205 alt = OV511_ALT_SIZE_993;
1206 else {
1207 err("Set packet size: invalid size (%d)", size);
1208 return -EINVAL;
1210 } else if (ov->bridge == BRG_OV511PLUS) {
1211 if (size == 0)
1212 alt = OV511PLUS_ALT_SIZE_0;
1213 else if (size == 33)
1214 alt = OV511PLUS_ALT_SIZE_33;
1215 else if (size == 129)
1216 alt = OV511PLUS_ALT_SIZE_129;
1217 else if (size == 257)
1218 alt = OV511PLUS_ALT_SIZE_257;
1219 else if (size == 385)
1220 alt = OV511PLUS_ALT_SIZE_385;
1221 else if (size == 513)
1222 alt = OV511PLUS_ALT_SIZE_513;
1223 else if (size == 769)
1224 alt = OV511PLUS_ALT_SIZE_769;
1225 else if (size == 961)
1226 alt = OV511PLUS_ALT_SIZE_961;
1227 else {
1228 err("Set packet size: invalid size (%d)", size);
1229 return -EINVAL;
1231 } else {
1232 err("Set packet size: Invalid bridge type");
1233 return -EINVAL;
1236 PDEBUG(3, "%d, mult=%d, alt=%d", size, mult, alt);
1238 if (reg_w(ov, R51x_FIFO_PSIZE, mult) < 0)
1239 return -EIO;
1241 if (usb_set_interface(ov->dev, ov->iface, alt) < 0) {
1242 err("Set packet size: set interface error");
1243 return -EBUSY;
1246 if (ov51x_reset(ov, OV511_RESET_NOREGS) < 0)
1247 return -EIO;
1249 ov->packet_size = size;
1251 if (ov51x_restart(ov) < 0)
1252 return -EIO;
1254 return 0;
1257 /* Note: Unlike the OV511/OV511+, the size argument does NOT include the
1258 * optional packet number byte. The actual size *is* stored in ov->packet_size,
1259 * though. */
1260 static int
1261 ov518_set_packet_size(struct usb_ov511 *ov, int size)
1263 int alt;
1265 if (ov51x_stop(ov) < 0)
1266 return -EIO;
1268 if (ov->bclass == BCL_OV518) {
1269 if (size == 0)
1270 alt = OV518_ALT_SIZE_0;
1271 else if (size == 128)
1272 alt = OV518_ALT_SIZE_128;
1273 else if (size == 256)
1274 alt = OV518_ALT_SIZE_256;
1275 else if (size == 384)
1276 alt = OV518_ALT_SIZE_384;
1277 else if (size == 512)
1278 alt = OV518_ALT_SIZE_512;
1279 else if (size == 640)
1280 alt = OV518_ALT_SIZE_640;
1281 else if (size == 768)
1282 alt = OV518_ALT_SIZE_768;
1283 else if (size == 896)
1284 alt = OV518_ALT_SIZE_896;
1285 else {
1286 err("Set packet size: invalid size (%d)", size);
1287 return -EINVAL;
1289 } else {
1290 err("Set packet size: Invalid bridge type");
1291 return -EINVAL;
1294 PDEBUG(3, "%d, alt=%d", size, alt);
1296 ov->packet_size = size;
1297 if (size > 0) {
1298 /* Program ISO FIFO size reg (packet number isn't included) */
1299 ov518_reg_w32(ov, 0x30, size, 2);
1301 if (ov->packet_numbering)
1302 ++ov->packet_size;
1305 if (usb_set_interface(ov->dev, ov->iface, alt) < 0) {
1306 err("Set packet size: set interface error");
1307 return -EBUSY;
1310 /* Initialize the stream */
1311 if (reg_w(ov, 0x2f, 0x80) < 0)
1312 return -EIO;
1314 if (ov51x_restart(ov) < 0)
1315 return -EIO;
1317 if (ov51x_reset(ov, OV511_RESET_NOREGS) < 0)
1318 return -EIO;
1320 return 0;
1323 /* Upload compression params and quantization tables. Returns 0 for success. */
1324 static int
1325 ov511_init_compression(struct usb_ov511 *ov)
1327 int rc = 0;
1329 if (!ov->compress_inited) {
1330 reg_w(ov, 0x70, phy);
1331 reg_w(ov, 0x71, phuv);
1332 reg_w(ov, 0x72, pvy);
1333 reg_w(ov, 0x73, pvuv);
1334 reg_w(ov, 0x74, qhy);
1335 reg_w(ov, 0x75, qhuv);
1336 reg_w(ov, 0x76, qvy);
1337 reg_w(ov, 0x77, qvuv);
1339 if (ov511_upload_quan_tables(ov) < 0) {
1340 err("Error uploading quantization tables");
1341 rc = -EIO;
1342 goto out;
1346 ov->compress_inited = 1;
1347 out:
1348 return rc;
1351 /* Upload compression params and quantization tables. Returns 0 for success. */
1352 static int
1353 ov518_init_compression(struct usb_ov511 *ov)
1355 int rc = 0;
1357 if (!ov->compress_inited) {
1358 if (ov518_upload_quan_tables(ov) < 0) {
1359 err("Error uploading quantization tables");
1360 rc = -EIO;
1361 goto out;
1365 ov->compress_inited = 1;
1366 out:
1367 return rc;
1370 /* -------------------------------------------------------------------------- */
1372 /* Sets sensor's contrast setting to "val" */
1373 static int
1374 sensor_set_contrast(struct usb_ov511 *ov, unsigned short val)
1376 int rc;
1378 PDEBUG(3, "%d", val);
1380 if (ov->stop_during_set)
1381 if (ov51x_stop(ov) < 0)
1382 return -EIO;
1384 switch (ov->sensor) {
1385 case SEN_OV7610:
1386 case SEN_OV6620:
1388 rc = i2c_w(ov, OV7610_REG_CNT, val >> 8);
1389 if (rc < 0)
1390 goto out;
1391 break;
1393 case SEN_OV6630:
1395 rc = i2c_w_mask(ov, OV7610_REG_CNT, val >> 12, 0x0f);
1396 if (rc < 0)
1397 goto out;
1398 break;
1400 case SEN_OV7620:
1402 unsigned char ctab[] = {
1403 0x01, 0x05, 0x09, 0x11, 0x15, 0x35, 0x37, 0x57,
1404 0x5b, 0xa5, 0xa7, 0xc7, 0xc9, 0xcf, 0xef, 0xff
1407 /* Use Y gamma control instead. Bit 0 enables it. */
1408 rc = i2c_w(ov, 0x64, ctab[val>>12]);
1409 if (rc < 0)
1410 goto out;
1411 break;
1413 case SEN_SAA7111A:
1415 rc = i2c_w(ov, 0x0b, val >> 9);
1416 if (rc < 0)
1417 goto out;
1418 break;
1420 default:
1422 PDEBUG(3, "Unsupported with this sensor");
1423 rc = -EPERM;
1424 goto out;
1428 rc = 0; /* Success */
1429 ov->contrast = val;
1430 out:
1431 if (ov51x_restart(ov) < 0)
1432 return -EIO;
1434 return rc;
1437 /* Gets sensor's contrast setting */
1438 static int
1439 sensor_get_contrast(struct usb_ov511 *ov, unsigned short *val)
1441 int rc;
1443 switch (ov->sensor) {
1444 case SEN_OV7610:
1445 case SEN_OV6620:
1446 rc = i2c_r(ov, OV7610_REG_CNT);
1447 if (rc < 0)
1448 return rc;
1449 else
1450 *val = rc << 8;
1451 break;
1452 case SEN_OV6630:
1453 rc = i2c_r(ov, OV7610_REG_CNT);
1454 if (rc < 0)
1455 return rc;
1456 else
1457 *val = rc << 12;
1458 break;
1459 case SEN_OV7620:
1460 /* Use Y gamma reg instead. Bit 0 is the enable bit. */
1461 rc = i2c_r(ov, 0x64);
1462 if (rc < 0)
1463 return rc;
1464 else
1465 *val = (rc & 0xfe) << 8;
1466 break;
1467 case SEN_SAA7111A:
1468 *val = ov->contrast;
1469 break;
1470 default:
1471 PDEBUG(3, "Unsupported with this sensor");
1472 return -EPERM;
1475 PDEBUG(3, "%d", *val);
1476 ov->contrast = *val;
1478 return 0;
1481 /* -------------------------------------------------------------------------- */
1483 /* Sets sensor's brightness setting to "val" */
1484 static int
1485 sensor_set_brightness(struct usb_ov511 *ov, unsigned short val)
1487 int rc;
1489 PDEBUG(4, "%d", val);
1491 if (ov->stop_during_set)
1492 if (ov51x_stop(ov) < 0)
1493 return -EIO;
1495 switch (ov->sensor) {
1496 case SEN_OV7610:
1497 case SEN_OV76BE:
1498 case SEN_OV6620:
1499 case SEN_OV6630:
1500 rc = i2c_w(ov, OV7610_REG_BRT, val >> 8);
1501 if (rc < 0)
1502 goto out;
1503 break;
1504 case SEN_OV7620:
1505 /* 7620 doesn't like manual changes when in auto mode */
1506 if (!ov->auto_brt) {
1507 rc = i2c_w(ov, OV7610_REG_BRT, val >> 8);
1508 if (rc < 0)
1509 goto out;
1511 break;
1512 case SEN_SAA7111A:
1513 rc = i2c_w(ov, 0x0a, val >> 8);
1514 if (rc < 0)
1515 goto out;
1516 break;
1517 default:
1518 PDEBUG(3, "Unsupported with this sensor");
1519 rc = -EPERM;
1520 goto out;
1523 rc = 0; /* Success */
1524 ov->brightness = val;
1525 out:
1526 if (ov51x_restart(ov) < 0)
1527 return -EIO;
1529 return rc;
1532 /* Gets sensor's brightness setting */
1533 static int
1534 sensor_get_brightness(struct usb_ov511 *ov, unsigned short *val)
1536 int rc;
1538 switch (ov->sensor) {
1539 case SEN_OV7610:
1540 case SEN_OV76BE:
1541 case SEN_OV7620:
1542 case SEN_OV6620:
1543 case SEN_OV6630:
1544 rc = i2c_r(ov, OV7610_REG_BRT);
1545 if (rc < 0)
1546 return rc;
1547 else
1548 *val = rc << 8;
1549 break;
1550 case SEN_SAA7111A:
1551 *val = ov->brightness;
1552 break;
1553 default:
1554 PDEBUG(3, "Unsupported with this sensor");
1555 return -EPERM;
1558 PDEBUG(3, "%d", *val);
1559 ov->brightness = *val;
1561 return 0;
1564 /* -------------------------------------------------------------------------- */
1566 /* Sets sensor's saturation (color intensity) setting to "val" */
1567 static int
1568 sensor_set_saturation(struct usb_ov511 *ov, unsigned short val)
1570 int rc;
1572 PDEBUG(3, "%d", val);
1574 if (ov->stop_during_set)
1575 if (ov51x_stop(ov) < 0)
1576 return -EIO;
1578 switch (ov->sensor) {
1579 case SEN_OV7610:
1580 case SEN_OV76BE:
1581 case SEN_OV6620:
1582 case SEN_OV6630:
1583 rc = i2c_w(ov, OV7610_REG_SAT, val >> 8);
1584 if (rc < 0)
1585 goto out;
1586 break;
1587 case SEN_OV7620:
1588 // /* Use UV gamma control instead. Bits 0 & 7 are reserved. */
1589 // rc = ov_i2c_write(ov->dev, 0x62, (val >> 9) & 0x7e);
1590 // if (rc < 0)
1591 // goto out;
1592 rc = i2c_w(ov, OV7610_REG_SAT, val >> 8);
1593 if (rc < 0)
1594 goto out;
1595 break;
1596 case SEN_SAA7111A:
1597 rc = i2c_w(ov, 0x0c, val >> 9);
1598 if (rc < 0)
1599 goto out;
1600 break;
1601 default:
1602 PDEBUG(3, "Unsupported with this sensor");
1603 rc = -EPERM;
1604 goto out;
1607 rc = 0; /* Success */
1608 ov->colour = val;
1609 out:
1610 if (ov51x_restart(ov) < 0)
1611 return -EIO;
1613 return rc;
1616 /* Gets sensor's saturation (color intensity) setting */
1617 static int
1618 sensor_get_saturation(struct usb_ov511 *ov, unsigned short *val)
1620 int rc;
1622 switch (ov->sensor) {
1623 case SEN_OV7610:
1624 case SEN_OV76BE:
1625 case SEN_OV6620:
1626 case SEN_OV6630:
1627 rc = i2c_r(ov, OV7610_REG_SAT);
1628 if (rc < 0)
1629 return rc;
1630 else
1631 *val = rc << 8;
1632 break;
1633 case SEN_OV7620:
1634 // /* Use UV gamma reg instead. Bits 0 & 7 are reserved. */
1635 // rc = i2c_r(ov, 0x62);
1636 // if (rc < 0)
1637 // return rc;
1638 // else
1639 // *val = (rc & 0x7e) << 9;
1640 rc = i2c_r(ov, OV7610_REG_SAT);
1641 if (rc < 0)
1642 return rc;
1643 else
1644 *val = rc << 8;
1645 break;
1646 case SEN_SAA7111A:
1647 *val = ov->colour;
1648 break;
1649 default:
1650 PDEBUG(3, "Unsupported with this sensor");
1651 return -EPERM;
1654 PDEBUG(3, "%d", *val);
1655 ov->colour = *val;
1657 return 0;
1660 /* -------------------------------------------------------------------------- */
1662 /* Sets sensor's hue (red/blue balance) setting to "val" */
1663 static int
1664 sensor_set_hue(struct usb_ov511 *ov, unsigned short val)
1666 int rc;
1668 PDEBUG(3, "%d", val);
1670 if (ov->stop_during_set)
1671 if (ov51x_stop(ov) < 0)
1672 return -EIO;
1674 switch (ov->sensor) {
1675 case SEN_OV7610:
1676 case SEN_OV6620:
1677 case SEN_OV6630:
1678 rc = i2c_w(ov, OV7610_REG_RED, 0xFF - (val >> 8));
1679 if (rc < 0)
1680 goto out;
1682 rc = i2c_w(ov, OV7610_REG_BLUE, val >> 8);
1683 if (rc < 0)
1684 goto out;
1685 break;
1686 case SEN_OV7620:
1687 // Hue control is causing problems. I will enable it once it's fixed.
1688 #if 0
1689 rc = i2c_w(ov, 0x7a, (unsigned char)(val >> 8) + 0xb);
1690 if (rc < 0)
1691 goto out;
1693 rc = i2c_w(ov, 0x79, (unsigned char)(val >> 8) + 0xb);
1694 if (rc < 0)
1695 goto out;
1696 #endif
1697 break;
1698 case SEN_SAA7111A:
1699 rc = i2c_w(ov, 0x0d, (val + 32768) >> 8);
1700 if (rc < 0)
1701 goto out;
1702 break;
1703 default:
1704 PDEBUG(3, "Unsupported with this sensor");
1705 rc = -EPERM;
1706 goto out;
1709 rc = 0; /* Success */
1710 ov->hue = val;
1711 out:
1712 if (ov51x_restart(ov) < 0)
1713 return -EIO;
1715 return rc;
1718 /* Gets sensor's hue (red/blue balance) setting */
1719 static int
1720 sensor_get_hue(struct usb_ov511 *ov, unsigned short *val)
1722 int rc;
1724 switch (ov->sensor) {
1725 case SEN_OV7610:
1726 case SEN_OV6620:
1727 case SEN_OV6630:
1728 rc = i2c_r(ov, OV7610_REG_BLUE);
1729 if (rc < 0)
1730 return rc;
1731 else
1732 *val = rc << 8;
1733 break;
1734 case SEN_OV7620:
1735 rc = i2c_r(ov, 0x7a);
1736 if (rc < 0)
1737 return rc;
1738 else
1739 *val = rc << 8;
1740 break;
1741 case SEN_SAA7111A:
1742 *val = ov->hue;
1743 break;
1744 default:
1745 PDEBUG(3, "Unsupported with this sensor");
1746 return -EPERM;
1749 PDEBUG(3, "%d", *val);
1750 ov->hue = *val;
1752 return 0;
1755 /* -------------------------------------------------------------------------- */
1757 static int
1758 sensor_set_picture(struct usb_ov511 *ov, struct video_picture *p)
1760 int rc;
1762 PDEBUG(4, "sensor_set_picture");
1764 ov->whiteness = p->whiteness;
1766 /* Don't return error if a setting is unsupported, or rest of settings
1767 * will not be performed */
1769 rc = sensor_set_contrast(ov, p->contrast);
1770 if (FATAL_ERROR(rc))
1771 return rc;
1773 rc = sensor_set_brightness(ov, p->brightness);
1774 if (FATAL_ERROR(rc))
1775 return rc;
1777 rc = sensor_set_saturation(ov, p->colour);
1778 if (FATAL_ERROR(rc))
1779 return rc;
1781 rc = sensor_set_hue(ov, p->hue);
1782 if (FATAL_ERROR(rc))
1783 return rc;
1785 return 0;
1788 static int
1789 sensor_get_picture(struct usb_ov511 *ov, struct video_picture *p)
1791 int rc;
1793 PDEBUG(4, "sensor_get_picture");
1795 /* Don't return error if a setting is unsupported, or rest of settings
1796 * will not be performed */
1798 rc = sensor_get_contrast(ov, &(p->contrast));
1799 if (FATAL_ERROR(rc))
1800 return rc;
1802 rc = sensor_get_brightness(ov, &(p->brightness));
1803 if (FATAL_ERROR(rc))
1804 return rc;
1806 rc = sensor_get_saturation(ov, &(p->colour));
1807 if (FATAL_ERROR(rc))
1808 return rc;
1810 rc = sensor_get_hue(ov, &(p->hue));
1811 if (FATAL_ERROR(rc))
1812 return rc;
1814 p->whiteness = 105 << 8;
1816 return 0;
1819 #if 0
1820 // FIXME: Exposure range is only 0x00-0x7f in interlace mode
1821 /* Sets current exposure for sensor. This only has an effect if auto-exposure
1822 * is off */
1823 static inline int
1824 sensor_set_exposure(struct usb_ov511 *ov, unsigned char val)
1826 int rc;
1828 PDEBUG(3, "%d", val);
1830 if (ov->stop_during_set)
1831 if (ov51x_stop(ov) < 0)
1832 return -EIO;
1834 switch (ov->sensor) {
1835 case SEN_OV6620:
1836 case SEN_OV6630:
1837 case SEN_OV7610:
1838 case SEN_OV7620:
1839 case SEN_OV76BE:
1840 case SEN_OV8600:
1841 rc = i2c_w(ov, 0x10, val);
1842 if (rc < 0)
1843 goto out;
1845 break;
1846 case SEN_KS0127:
1847 case SEN_KS0127B:
1848 case SEN_SAA7111A:
1849 PDEBUG(3, "Unsupported with this sensor");
1850 return -EPERM;
1851 default:
1852 err("Sensor not supported for set_exposure");
1853 return -EINVAL;
1856 rc = 0; /* Success */
1857 ov->exposure = val;
1858 out:
1859 if (ov51x_restart(ov) < 0)
1860 return -EIO;
1862 return rc;
1864 #endif
1866 /* Gets current exposure level from sensor, regardless of whether it is under
1867 * manual control. */
1868 static int
1869 sensor_get_exposure(struct usb_ov511 *ov, unsigned char *val)
1871 int rc;
1873 switch (ov->sensor) {
1874 case SEN_OV7610:
1875 case SEN_OV6620:
1876 case SEN_OV6630:
1877 case SEN_OV7620:
1878 case SEN_OV76BE:
1879 case SEN_OV8600:
1880 rc = i2c_r(ov, 0x10);
1881 if (rc < 0)
1882 return rc;
1883 else
1884 *val = rc;
1885 break;
1886 case SEN_KS0127:
1887 case SEN_KS0127B:
1888 case SEN_SAA7111A:
1889 val = NULL;
1890 PDEBUG(3, "Unsupported with this sensor");
1891 return -EPERM;
1892 default:
1893 err("Sensor not supported for get_exposure");
1894 return -EINVAL;
1897 PDEBUG(3, "%d", *val);
1898 ov->exposure = *val;
1900 return 0;
1903 /* Turns on or off the LED. Only has an effect with OV511+/OV518(+) */
1904 static void
1905 ov51x_led_control(struct usb_ov511 *ov, int enable)
1907 PDEBUG(4, " (%s)", enable ? "turn on" : "turn off");
1909 if (ov->bridge == BRG_OV511PLUS)
1910 reg_w(ov, R511_SYS_LED_CTL, enable ? 1 : 0);
1911 else if (ov->bclass == BCL_OV518)
1912 reg_w_mask(ov, R518_GPIO_OUT, enable ? 0x02 : 0x00, 0x02);
1914 return;
1917 /* Matches the sensor's internal frame rate to the lighting frequency.
1918 * Valid frequencies are:
1919 * 50 - 50Hz, for European and Asian lighting
1920 * 60 - 60Hz, for American lighting
1922 * Tested with: OV7610, OV7620, OV76BE, OV6620
1923 * Unsupported: KS0127, KS0127B, SAA7111A
1924 * Returns: 0 for success
1926 static int
1927 sensor_set_light_freq(struct usb_ov511 *ov, int freq)
1929 int sixty;
1931 PDEBUG(4, "%d Hz", freq);
1933 if (freq == 60)
1934 sixty = 1;
1935 else if (freq == 50)
1936 sixty = 0;
1937 else {
1938 err("Invalid light freq (%d Hz)", freq);
1939 return -EINVAL;
1942 switch (ov->sensor) {
1943 case SEN_OV7610:
1944 i2c_w_mask(ov, 0x2a, sixty?0x00:0x80, 0x80);
1945 i2c_w(ov, 0x2b, sixty?0x00:0xac);
1946 i2c_w_mask(ov, 0x13, 0x10, 0x10);
1947 i2c_w_mask(ov, 0x13, 0x00, 0x10);
1948 break;
1949 case SEN_OV7620:
1950 case SEN_OV76BE:
1951 case SEN_OV8600:
1952 i2c_w_mask(ov, 0x2a, sixty?0x00:0x80, 0x80);
1953 i2c_w(ov, 0x2b, sixty?0x00:0xac);
1954 i2c_w_mask(ov, 0x76, 0x01, 0x01);
1955 break;
1956 case SEN_OV6620:
1957 case SEN_OV6630:
1958 i2c_w(ov, 0x2b, sixty?0xa8:0x28);
1959 i2c_w(ov, 0x2a, sixty?0x84:0xa4);
1960 break;
1961 case SEN_KS0127:
1962 case SEN_KS0127B:
1963 case SEN_SAA7111A:
1964 PDEBUG(5, "Unsupported with this sensor");
1965 return -EPERM;
1966 default:
1967 err("Sensor not supported for set_light_freq");
1968 return -EINVAL;
1971 ov->lightfreq = freq;
1973 return 0;
1976 /* If enable is true, turn on the sensor's banding filter, otherwise turn it
1977 * off. This filter tries to reduce the pattern of horizontal light/dark bands
1978 * caused by some (usually fluorescent) lighting. The light frequency must be
1979 * set either before or after enabling it with ov51x_set_light_freq().
1981 * Tested with: OV7610, OV7620, OV76BE, OV6620.
1982 * Unsupported: KS0127, KS0127B, SAA7111A
1983 * Returns: 0 for success
1985 static int
1986 sensor_set_banding_filter(struct usb_ov511 *ov, int enable)
1988 int rc;
1990 PDEBUG(4, " (%s)", enable ? "turn on" : "turn off");
1992 if (ov->sensor == SEN_KS0127 || ov->sensor == SEN_KS0127B
1993 || ov->sensor == SEN_SAA7111A) {
1994 PDEBUG(5, "Unsupported with this sensor");
1995 return -EPERM;
1998 rc = i2c_w_mask(ov, 0x2d, enable?0x04:0x00, 0x04);
1999 if (rc < 0)
2000 return rc;
2002 ov->bandfilt = enable;
2004 return 0;
2007 /* If enable is true, turn on the sensor's auto brightness control, otherwise
2008 * turn it off.
2010 * Unsupported: KS0127, KS0127B, SAA7111A
2011 * Returns: 0 for success
2013 static int
2014 sensor_set_auto_brightness(struct usb_ov511 *ov, int enable)
2016 int rc;
2018 PDEBUG(4, " (%s)", enable ? "turn on" : "turn off");
2020 if (ov->sensor == SEN_KS0127 || ov->sensor == SEN_KS0127B
2021 || ov->sensor == SEN_SAA7111A) {
2022 PDEBUG(5, "Unsupported with this sensor");
2023 return -EPERM;
2026 rc = i2c_w_mask(ov, 0x2d, enable?0x10:0x00, 0x10);
2027 if (rc < 0)
2028 return rc;
2030 ov->auto_brt = enable;
2032 return 0;
2035 /* If enable is true, turn on the sensor's auto exposure control, otherwise
2036 * turn it off.
2038 * Unsupported: KS0127, KS0127B, SAA7111A
2039 * Returns: 0 for success
2041 static int
2042 sensor_set_auto_exposure(struct usb_ov511 *ov, int enable)
2044 PDEBUG(4, " (%s)", enable ? "turn on" : "turn off");
2046 switch (ov->sensor) {
2047 case SEN_OV7610:
2048 i2c_w_mask(ov, 0x29, enable?0x00:0x80, 0x80);
2049 break;
2050 case SEN_OV6620:
2051 case SEN_OV7620:
2052 case SEN_OV76BE:
2053 case SEN_OV8600:
2054 i2c_w_mask(ov, 0x13, enable?0x01:0x00, 0x01);
2055 break;
2056 case SEN_OV6630:
2057 i2c_w_mask(ov, 0x28, enable?0x00:0x10, 0x10);
2058 break;
2059 case SEN_KS0127:
2060 case SEN_KS0127B:
2061 case SEN_SAA7111A:
2062 PDEBUG(5, "Unsupported with this sensor");
2063 return -EPERM;
2064 default:
2065 err("Sensor not supported for set_auto_exposure");
2066 return -EINVAL;
2069 ov->auto_exp = enable;
2071 return 0;
2074 /* Modifies the sensor's exposure algorithm to allow proper exposure of objects
2075 * that are illuminated from behind.
2077 * Tested with: OV6620, OV7620
2078 * Unsupported: OV7610, OV76BE, KS0127, KS0127B, SAA7111A
2079 * Returns: 0 for success
2081 static int
2082 sensor_set_backlight(struct usb_ov511 *ov, int enable)
2084 PDEBUG(4, " (%s)", enable ? "turn on" : "turn off");
2086 switch (ov->sensor) {
2087 case SEN_OV7620:
2088 case SEN_OV8600:
2089 i2c_w_mask(ov, 0x68, enable?0xe0:0xc0, 0xe0);
2090 i2c_w_mask(ov, 0x29, enable?0x08:0x00, 0x08);
2091 i2c_w_mask(ov, 0x28, enable?0x02:0x00, 0x02);
2092 break;
2093 case SEN_OV6620:
2094 i2c_w_mask(ov, 0x4e, enable?0xe0:0xc0, 0xe0);
2095 i2c_w_mask(ov, 0x29, enable?0x08:0x00, 0x08);
2096 i2c_w_mask(ov, 0x0e, enable?0x80:0x00, 0x80);
2097 break;
2098 case SEN_OV6630:
2099 i2c_w_mask(ov, 0x4e, enable?0x80:0x60, 0xe0);
2100 i2c_w_mask(ov, 0x29, enable?0x08:0x00, 0x08);
2101 i2c_w_mask(ov, 0x28, enable?0x02:0x00, 0x02);
2102 break;
2103 case SEN_OV7610:
2104 case SEN_OV76BE:
2105 case SEN_KS0127:
2106 case SEN_KS0127B:
2107 case SEN_SAA7111A:
2108 PDEBUG(5, "Unsupported with this sensor");
2109 return -EPERM;
2110 default:
2111 err("Sensor not supported for set_backlight");
2112 return -EINVAL;
2115 ov->backlight = enable;
2117 return 0;
2120 static int
2121 sensor_set_mirror(struct usb_ov511 *ov, int enable)
2123 PDEBUG(4, " (%s)", enable ? "turn on" : "turn off");
2125 switch (ov->sensor) {
2126 case SEN_OV6620:
2127 case SEN_OV6630:
2128 case SEN_OV7610:
2129 case SEN_OV7620:
2130 case SEN_OV76BE:
2131 case SEN_OV8600:
2132 i2c_w_mask(ov, 0x12, enable?0x40:0x00, 0x40);
2133 break;
2134 case SEN_KS0127:
2135 case SEN_KS0127B:
2136 case SEN_SAA7111A:
2137 PDEBUG(5, "Unsupported with this sensor");
2138 return -EPERM;
2139 default:
2140 err("Sensor not supported for set_mirror");
2141 return -EINVAL;
2144 ov->mirror = enable;
2146 return 0;
2149 /* Returns number of bits per pixel (regardless of where they are located;
2150 * planar or not), or zero for unsupported format.
2152 static inline int
2153 get_depth(int palette)
2155 switch (palette) {
2156 case VIDEO_PALETTE_GREY: return 8;
2157 case VIDEO_PALETTE_YUV420: return 12;
2158 case VIDEO_PALETTE_YUV420P: return 12; /* Planar */
2159 default: return 0; /* Invalid format */
2163 /* Bytes per frame. Used by read(). Return of 0 indicates error */
2164 static inline long int
2165 get_frame_length(struct ov511_frame *frame)
2167 if (!frame)
2168 return 0;
2169 else
2170 return ((frame->width * frame->height
2171 * get_depth(frame->format)) >> 3);
2174 static int
2175 mode_init_ov_sensor_regs(struct usb_ov511 *ov, int width, int height,
2176 int mode, int sub_flag, int qvga)
2178 int clock;
2180 /******** Mode (VGA/QVGA) and sensor specific regs ********/
2182 switch (ov->sensor) {
2183 case SEN_OV7610:
2184 i2c_w(ov, 0x14, qvga?0x24:0x04);
2185 // FIXME: Does this improve the image quality or frame rate?
2186 #if 0
2187 i2c_w_mask(ov, 0x28, qvga?0x00:0x20, 0x20);
2188 i2c_w(ov, 0x24, 0x10);
2189 i2c_w(ov, 0x25, qvga?0x40:0x8a);
2190 i2c_w(ov, 0x2f, qvga?0x30:0xb0);
2191 i2c_w(ov, 0x35, qvga?0x1c:0x9c);
2192 #endif
2193 break;
2194 case SEN_OV7620:
2195 // i2c_w(ov, 0x2b, 0x00);
2196 i2c_w(ov, 0x14, qvga?0xa4:0x84);
2197 i2c_w_mask(ov, 0x28, qvga?0x00:0x20, 0x20);
2198 i2c_w(ov, 0x24, qvga?0x20:0x3a);
2199 i2c_w(ov, 0x25, qvga?0x30:0x60);
2200 i2c_w_mask(ov, 0x2d, qvga?0x40:0x00, 0x40);
2201 i2c_w_mask(ov, 0x67, qvga?0xf0:0x90, 0xf0);
2202 i2c_w_mask(ov, 0x74, qvga?0x20:0x00, 0x20);
2203 break;
2204 case SEN_OV76BE:
2205 // i2c_w(ov, 0x2b, 0x00);
2206 i2c_w(ov, 0x14, qvga?0xa4:0x84);
2207 // FIXME: Enable this once 7620AE uses 7620 initial settings
2208 #if 0
2209 i2c_w_mask(ov, 0x28, qvga?0x00:0x20, 0x20);
2210 i2c_w(ov, 0x24, qvga?0x20:0x3a);
2211 i2c_w(ov, 0x25, qvga?0x30:0x60);
2212 i2c_w_mask(ov, 0x2d, qvga?0x40:0x00, 0x40);
2213 i2c_w_mask(ov, 0x67, qvga?0xb0:0x90, 0xf0);
2214 i2c_w_mask(ov, 0x74, qvga?0x20:0x00, 0x20);
2215 #endif
2216 break;
2217 case SEN_OV6620:
2218 i2c_w(ov, 0x14, qvga?0x24:0x04);
2219 break;
2220 case SEN_OV6630:
2221 i2c_w(ov, 0x14, qvga?0xa0:0x80);
2222 break;
2223 default:
2224 err("Invalid sensor");
2225 return -EINVAL;
2228 /******** Palette-specific regs ********/
2230 if (mode == VIDEO_PALETTE_GREY) {
2231 if (ov->sensor == SEN_OV7610 || ov->sensor == SEN_OV76BE) {
2232 /* these aren't valid on the OV6620/OV7620/6630? */
2233 i2c_w_mask(ov, 0x0e, 0x40, 0x40);
2236 if (ov->sensor == SEN_OV6630 && ov->bridge == BRG_OV518
2237 && ov518_color) {
2238 i2c_w_mask(ov, 0x12, 0x00, 0x10);
2239 i2c_w_mask(ov, 0x13, 0x00, 0x20);
2240 } else {
2241 i2c_w_mask(ov, 0x13, 0x20, 0x20);
2243 } else {
2244 if (ov->sensor == SEN_OV7610 || ov->sensor == SEN_OV76BE) {
2245 /* not valid on the OV6620/OV7620/6630? */
2246 i2c_w_mask(ov, 0x0e, 0x00, 0x40);
2249 /* The OV518 needs special treatment. Although both the OV518
2250 * and the OV6630 support a 16-bit video bus, only the 8 bit Y
2251 * bus is actually used. The UV bus is tied to ground.
2252 * Therefore, the OV6630 needs to be in 8-bit multiplexed
2253 * output mode */
2255 if (ov->sensor == SEN_OV6630 && ov->bridge == BRG_OV518
2256 && ov518_color) {
2257 i2c_w_mask(ov, 0x12, 0x10, 0x10);
2258 i2c_w_mask(ov, 0x13, 0x20, 0x20);
2259 } else {
2260 i2c_w_mask(ov, 0x13, 0x00, 0x20);
2264 /******** Clock programming ********/
2266 /* The OV6620 needs special handling. This prevents the
2267 * severe banding that normally occurs */
2268 if (ov->sensor == SEN_OV6620 || ov->sensor == SEN_OV6630)
2270 /* Clock down */
2272 i2c_w(ov, 0x2a, 0x04);
2274 if (ov->compress) {
2275 // clock = 0; /* This ensures the highest frame rate */
2276 clock = 3;
2277 } else if (clockdiv == -1) { /* If user didn't override it */
2278 clock = 3; /* Gives better exposure time */
2279 } else {
2280 clock = clockdiv;
2283 PDEBUG(4, "Setting clock divisor to %d", clock);
2285 i2c_w(ov, 0x11, clock);
2287 i2c_w(ov, 0x2a, 0x84);
2288 /* This next setting is critical. It seems to improve
2289 * the gain or the contrast. The "reserved" bits seem
2290 * to have some effect in this case. */
2291 i2c_w(ov, 0x2d, 0x85);
2293 else
2295 if (ov->compress) {
2296 clock = 1; /* This ensures the highest frame rate */
2297 } else if (clockdiv == -1) { /* If user didn't override it */
2298 /* Calculate and set the clock divisor */
2299 clock = ((sub_flag ? ov->subw * ov->subh
2300 : width * height)
2301 * (mode == VIDEO_PALETTE_GREY ? 2 : 3) / 2)
2302 / 66000;
2303 } else {
2304 clock = clockdiv;
2307 PDEBUG(4, "Setting clock divisor to %d", clock);
2309 i2c_w(ov, 0x11, clock);
2312 /******** Special Features ********/
2314 if (framedrop >= 0)
2315 i2c_w(ov, 0x16, framedrop);
2317 /* Test Pattern */
2318 i2c_w_mask(ov, 0x12, (testpat?0x02:0x00), 0x02);
2320 /* Enable auto white balance */
2321 i2c_w_mask(ov, 0x12, 0x04, 0x04);
2323 // This will go away as soon as ov51x_mode_init_sensor_regs()
2324 // is fully tested.
2325 /* 7620/6620/6630? don't have register 0x35, so play it safe */
2326 if (ov->sensor == SEN_OV7610 || ov->sensor == SEN_OV76BE) {
2327 if (width == 640 && height == 480)
2328 i2c_w(ov, 0x35, 0x9e);
2329 else
2330 i2c_w(ov, 0x35, 0x1e);
2333 return 0;
2336 static int
2337 set_ov_sensor_window(struct usb_ov511 *ov, int width, int height, int mode,
2338 int sub_flag)
2340 int ret;
2341 int hwsbase, hwebase, vwsbase, vwebase, hwsize, vwsize;
2342 int hoffset, voffset, hwscale = 0, vwscale = 0;
2344 /* The different sensor ICs handle setting up of window differently.
2345 * IF YOU SET IT WRONG, YOU WILL GET ALL ZERO ISOC DATA FROM OV51x!!! */
2346 switch (ov->sensor) {
2347 case SEN_OV7610:
2348 case SEN_OV76BE:
2349 hwsbase = 0x38;
2350 hwebase = 0x3a;
2351 vwsbase = vwebase = 0x05;
2352 break;
2353 case SEN_OV6620:
2354 case SEN_OV6630:
2355 hwsbase = 0x38;
2356 hwebase = 0x3a;
2357 vwsbase = 0x05;
2358 vwebase = 0x06;
2359 break;
2360 case SEN_OV7620:
2361 hwsbase = 0x2f; /* From 7620.SET (spec is wrong) */
2362 hwebase = 0x2f;
2363 vwsbase = vwebase = 0x05;
2364 break;
2365 default:
2366 err("Invalid sensor");
2367 return -EINVAL;
2370 if (ov->sensor == SEN_OV6620 || ov->sensor == SEN_OV6630) {
2371 /* Note: OV518(+) does downsample on its own) */
2372 if ((width > 176 && height > 144)
2373 || ov->bclass == BCL_OV518) { /* CIF */
2374 ret = mode_init_ov_sensor_regs(ov, width, height,
2375 mode, sub_flag, 0);
2376 if (ret < 0)
2377 return ret;
2378 hwscale = 1;
2379 vwscale = 1; /* The datasheet says 0; it's wrong */
2380 hwsize = 352;
2381 vwsize = 288;
2382 } else if (width > 176 || height > 144) {
2383 err("Illegal dimensions");
2384 return -EINVAL;
2385 } else { /* QCIF */
2386 ret = mode_init_ov_sensor_regs(ov, width, height,
2387 mode, sub_flag, 1);
2388 if (ret < 0)
2389 return ret;
2390 hwsize = 176;
2391 vwsize = 144;
2393 } else {
2394 if (width > 320 && height > 240) { /* VGA */
2395 ret = mode_init_ov_sensor_regs(ov, width, height,
2396 mode, sub_flag, 0);
2397 if (ret < 0)
2398 return ret;
2399 hwscale = 2;
2400 vwscale = 1;
2401 hwsize = 640;
2402 vwsize = 480;
2403 } else if (width > 320 || height > 240) {
2404 err("Illegal dimensions");
2405 return -EINVAL;
2406 } else { /* QVGA */
2407 ret = mode_init_ov_sensor_regs(ov, width, height,
2408 mode, sub_flag, 1);
2409 if (ret < 0)
2410 return ret;
2411 hwscale = 1;
2412 hwsize = 320;
2413 vwsize = 240;
2417 /* Center the window */
2418 hoffset = ((hwsize - width) / 2) >> hwscale;
2419 voffset = ((vwsize - height) / 2) >> vwscale;
2421 /* FIXME! - This needs to be changed to support 160x120 and 6620!!! */
2422 if (sub_flag) {
2423 i2c_w(ov, 0x17, hwsbase+(ov->subx>>hwscale));
2424 i2c_w(ov, 0x18, hwebase+((ov->subx+ov->subw)>>hwscale));
2425 i2c_w(ov, 0x19, vwsbase+(ov->suby>>vwscale));
2426 i2c_w(ov, 0x1a, vwebase+((ov->suby+ov->subh)>>vwscale));
2427 } else {
2428 i2c_w(ov, 0x17, hwsbase + hoffset);
2429 i2c_w(ov, 0x18, hwebase + hoffset + (hwsize>>hwscale));
2430 i2c_w(ov, 0x19, vwsbase + voffset);
2431 i2c_w(ov, 0x1a, vwebase + voffset + (vwsize>>vwscale));
2434 #ifdef OV511_DEBUG
2435 if (dump_sensor)
2436 dump_i2c_regs(ov);
2437 #endif
2439 return 0;
2442 /* Set up the OV511/OV511+ with the given image parameters.
2444 * Do not put any sensor-specific code in here (including I2C I/O functions)
2446 static int
2447 ov511_mode_init_regs(struct usb_ov511 *ov,
2448 int width, int height, int mode, int sub_flag)
2450 int hsegs, vsegs;
2452 if (sub_flag) {
2453 width = ov->subw;
2454 height = ov->subh;
2457 PDEBUG(3, "width:%d, height:%d, mode:%d, sub:%d",
2458 width, height, mode, sub_flag);
2460 // FIXME: This should be moved to a 7111a-specific function once
2461 // subcapture is dealt with properly
2462 if (ov->sensor == SEN_SAA7111A) {
2463 if (width == 320 && height == 240) {
2464 /* No need to do anything special */
2465 } else if (width == 640 && height == 480) {
2466 /* Set the OV511 up as 320x480, but keep the
2467 * V4L resolution as 640x480 */
2468 width = 320;
2469 } else {
2470 err("SAA7111A only allows 320x240 or 640x480");
2471 return -EINVAL;
2475 /* Make sure width and height are a multiple of 8 */
2476 if (width % 8 || height % 8) {
2477 err("Invalid size (%d, %d) (mode = %d)", width, height, mode);
2478 return -EINVAL;
2481 if (width < ov->minwidth || height < ov->minheight) {
2482 err("Requested dimensions are too small");
2483 return -EINVAL;
2486 if (ov51x_stop(ov) < 0)
2487 return -EIO;
2489 if (mode == VIDEO_PALETTE_GREY) {
2490 reg_w(ov, R511_CAM_UV_EN, 0x00);
2491 reg_w(ov, R511_SNAP_UV_EN, 0x00);
2492 reg_w(ov, R511_SNAP_OPTS, 0x01);
2493 } else {
2494 reg_w(ov, R511_CAM_UV_EN, 0x01);
2495 reg_w(ov, R511_SNAP_UV_EN, 0x01);
2496 reg_w(ov, R511_SNAP_OPTS, 0x03);
2499 /* Here I'm assuming that snapshot size == image size.
2500 * I hope that's always true. --claudio
2502 hsegs = (width >> 3) - 1;
2503 vsegs = (height >> 3) - 1;
2505 reg_w(ov, R511_CAM_PXCNT, hsegs);
2506 reg_w(ov, R511_CAM_LNCNT, vsegs);
2507 reg_w(ov, R511_CAM_PXDIV, 0x00);
2508 reg_w(ov, R511_CAM_LNDIV, 0x00);
2510 /* YUV420, low pass filter on */
2511 reg_w(ov, R511_CAM_OPTS, 0x03);
2513 /* Snapshot additions */
2514 reg_w(ov, R511_SNAP_PXCNT, hsegs);
2515 reg_w(ov, R511_SNAP_LNCNT, vsegs);
2516 reg_w(ov, R511_SNAP_PXDIV, 0x00);
2517 reg_w(ov, R511_SNAP_LNDIV, 0x00);
2519 if (ov->compress) {
2520 /* Enable Y and UV quantization and compression */
2521 reg_w(ov, R511_COMP_EN, 0x07);
2522 reg_w(ov, R511_COMP_LUT_EN, 0x03);
2523 ov51x_reset(ov, OV511_RESET_OMNICE);
2526 if (ov51x_restart(ov) < 0)
2527 return -EIO;
2529 return 0;
2532 /* Sets up the OV518/OV518+ with the given image parameters
2534 * OV518 needs a completely different approach, until we can figure out what
2535 * the individual registers do. Also, only 15 FPS is supported now.
2537 * Do not put any sensor-specific code in here (including I2C I/O functions)
2539 static int
2540 ov518_mode_init_regs(struct usb_ov511 *ov,
2541 int width, int height, int mode, int sub_flag)
2543 int hsegs, vsegs, hi_res;
2545 if (sub_flag) {
2546 width = ov->subw;
2547 height = ov->subh;
2550 PDEBUG(3, "width:%d, height:%d, mode:%d, sub:%d",
2551 width, height, mode, sub_flag);
2553 if (width % 16 || height % 8) {
2554 err("Invalid size (%d, %d)", width, height);
2555 return -EINVAL;
2558 if (width < ov->minwidth || height < ov->minheight) {
2559 err("Requested dimensions are too small");
2560 return -EINVAL;
2563 if (width >= 320 && height >= 240) {
2564 hi_res = 1;
2565 } else if (width >= 320 || height >= 240) {
2566 err("Invalid width/height combination (%d, %d)", width, height);
2567 return -EINVAL;
2568 } else {
2569 hi_res = 0;
2572 if (ov51x_stop(ov) < 0)
2573 return -EIO;
2575 /******** Set the mode ********/
2577 reg_w(ov, 0x2b, 0);
2578 reg_w(ov, 0x2c, 0);
2579 reg_w(ov, 0x2d, 0);
2580 reg_w(ov, 0x2e, 0);
2581 reg_w(ov, 0x3b, 0);
2582 reg_w(ov, 0x3c, 0);
2583 reg_w(ov, 0x3d, 0);
2584 reg_w(ov, 0x3e, 0);
2586 if (ov->bridge == BRG_OV518 && ov518_color) {
2587 /* OV518 needs U and V swapped */
2588 i2c_w_mask(ov, 0x15, 0x00, 0x01);
2590 if (mode == VIDEO_PALETTE_GREY) {
2591 /* Set 16-bit input format (UV data are ignored) */
2592 reg_w_mask(ov, 0x20, 0x00, 0x08);
2594 /* Set 8-bit (4:0:0) output format */
2595 reg_w_mask(ov, 0x28, 0x00, 0xf0);
2596 reg_w_mask(ov, 0x38, 0x00, 0xf0);
2597 } else {
2598 /* Set 8-bit (YVYU) input format */
2599 reg_w_mask(ov, 0x20, 0x08, 0x08);
2601 /* Set 12-bit (4:2:0) output format */
2602 reg_w_mask(ov, 0x28, 0x80, 0xf0);
2603 reg_w_mask(ov, 0x38, 0x80, 0xf0);
2605 } else {
2606 reg_w(ov, 0x28, (mode == VIDEO_PALETTE_GREY) ? 0x00:0x80);
2607 reg_w(ov, 0x38, (mode == VIDEO_PALETTE_GREY) ? 0x00:0x80);
2610 hsegs = width / 16;
2611 vsegs = height / 4;
2613 reg_w(ov, 0x29, hsegs);
2614 reg_w(ov, 0x2a, vsegs);
2616 reg_w(ov, 0x39, hsegs);
2617 reg_w(ov, 0x3a, vsegs);
2619 /* Windows driver does this here; who knows why */
2620 reg_w(ov, 0x2f, 0x80);
2622 /******** Set the framerate (to 15 FPS) ********/
2624 /* Mode independent, but framerate dependent, regs */
2625 reg_w(ov, 0x51, 0x02); /* Clock divider; lower==faster */
2626 reg_w(ov, 0x22, 0x18);
2627 reg_w(ov, 0x23, 0xff);
2629 if (ov->bridge == BRG_OV518PLUS)
2630 reg_w(ov, 0x21, 0x19);
2631 else
2632 reg_w(ov, 0x71, 0x19); /* Compression-related? */
2634 // FIXME: Sensor-specific
2635 /* Bit 5 is what matters here. Of course, it is "reserved" */
2636 i2c_w(ov, 0x54, 0x23);
2638 reg_w(ov, 0x2f, 0x80);
2640 if (ov->bridge == BRG_OV518PLUS) {
2641 reg_w(ov, 0x24, 0x94);
2642 reg_w(ov, 0x25, 0x90);
2643 ov518_reg_w32(ov, 0xc4, 400, 2); /* 190h */
2644 ov518_reg_w32(ov, 0xc6, 540, 2); /* 21ch */
2645 ov518_reg_w32(ov, 0xc7, 540, 2); /* 21ch */
2646 ov518_reg_w32(ov, 0xc8, 108, 2); /* 6ch */
2647 ov518_reg_w32(ov, 0xca, 131098, 3); /* 2001ah */
2648 ov518_reg_w32(ov, 0xcb, 532, 2); /* 214h */
2649 ov518_reg_w32(ov, 0xcc, 2400, 2); /* 960h */
2650 ov518_reg_w32(ov, 0xcd, 32, 2); /* 20h */
2651 ov518_reg_w32(ov, 0xce, 608, 2); /* 260h */
2652 } else {
2653 reg_w(ov, 0x24, 0x9f);
2654 reg_w(ov, 0x25, 0x90);
2655 ov518_reg_w32(ov, 0xc4, 400, 2); /* 190h */
2656 ov518_reg_w32(ov, 0xc6, 500, 2); /* 1f4h */
2657 ov518_reg_w32(ov, 0xc7, 500, 2); /* 1f4h */
2658 ov518_reg_w32(ov, 0xc8, 142, 2); /* 8eh */
2659 ov518_reg_w32(ov, 0xca, 131098, 3); /* 2001ah */
2660 ov518_reg_w32(ov, 0xcb, 532, 2); /* 214h */
2661 ov518_reg_w32(ov, 0xcc, 2000, 2); /* 7d0h */
2662 ov518_reg_w32(ov, 0xcd, 32, 2); /* 20h */
2663 ov518_reg_w32(ov, 0xce, 608, 2); /* 260h */
2666 reg_w(ov, 0x2f, 0x80);
2668 if (ov51x_restart(ov) < 0)
2669 return -EIO;
2671 /* Reset it just for good measure */
2672 if (ov51x_reset(ov, OV511_RESET_NOREGS) < 0)
2673 return -EIO;
2675 return 0;
2678 /* This is a wrapper around the OV511, OV518, and sensor specific functions */
2679 static int
2680 mode_init_regs(struct usb_ov511 *ov,
2681 int width, int height, int mode, int sub_flag)
2683 int rc = 0;
2685 if (!ov || !ov->dev)
2686 return -EFAULT;
2688 if (ov->bclass == BCL_OV518) {
2689 rc = ov518_mode_init_regs(ov, width, height, mode, sub_flag);
2690 } else {
2691 rc = ov511_mode_init_regs(ov, width, height, mode, sub_flag);
2694 if (FATAL_ERROR(rc))
2695 return rc;
2697 switch (ov->sensor) {
2698 case SEN_OV7610:
2699 case SEN_OV7620:
2700 case SEN_OV76BE:
2701 case SEN_OV8600:
2702 case SEN_OV6620:
2703 case SEN_OV6630:
2704 rc = set_ov_sensor_window(ov, width, height, mode, sub_flag);
2705 break;
2706 case SEN_KS0127:
2707 case SEN_KS0127B:
2708 err("KS0127-series decoders not supported yet");
2709 rc = -EINVAL;
2710 break;
2711 case SEN_SAA7111A:
2712 // rc = mode_init_saa_sensor_regs(ov, width, height, mode,
2713 // sub_flag);
2715 PDEBUG(1, "SAA status = 0x%02X", i2c_r(ov, 0x1f));
2716 break;
2717 default:
2718 err("Unknown sensor");
2719 rc = -EINVAL;
2722 if (FATAL_ERROR(rc))
2723 return rc;
2725 /* Sensor-independent settings */
2726 rc = sensor_set_auto_brightness(ov, ov->auto_brt);
2727 if (FATAL_ERROR(rc))
2728 return rc;
2730 rc = sensor_set_auto_exposure(ov, ov->auto_exp);
2731 if (FATAL_ERROR(rc))
2732 return rc;
2734 rc = sensor_set_banding_filter(ov, bandingfilter);
2735 if (FATAL_ERROR(rc))
2736 return rc;
2738 if (ov->lightfreq) {
2739 rc = sensor_set_light_freq(ov, lightfreq);
2740 if (FATAL_ERROR(rc))
2741 return rc;
2744 rc = sensor_set_backlight(ov, ov->backlight);
2745 if (FATAL_ERROR(rc))
2746 return rc;
2748 rc = sensor_set_mirror(ov, ov->mirror);
2749 if (FATAL_ERROR(rc))
2750 return rc;
2752 return 0;
2755 /* This sets the default image parameters. This is useful for apps that use
2756 * read() and do not set these.
2758 static int
2759 ov51x_set_default_params(struct usb_ov511 *ov)
2761 int i;
2763 /* Set default sizes in case IOCTL (VIDIOCMCAPTURE) is not used
2764 * (using read() instead). */
2765 for (i = 0; i < OV511_NUMFRAMES; i++) {
2766 ov->frame[i].width = ov->maxwidth;
2767 ov->frame[i].height = ov->maxheight;
2768 ov->frame[i].bytes_read = 0;
2769 if (force_palette)
2770 ov->frame[i].format = force_palette;
2771 else
2772 ov->frame[i].format = VIDEO_PALETTE_YUV420;
2774 ov->frame[i].depth = get_depth(ov->frame[i].format);
2777 PDEBUG(3, "%dx%d, %s", ov->maxwidth, ov->maxheight,
2778 symbolic(v4l1_plist, ov->frame[0].format));
2780 /* Initialize to max width/height, YUV420 or RGB24 (if supported) */
2781 if (mode_init_regs(ov, ov->maxwidth, ov->maxheight,
2782 ov->frame[0].format, 0) < 0)
2783 return -EINVAL;
2785 return 0;
2788 /**********************************************************************
2790 * Video decoder stuff
2792 **********************************************************************/
2794 /* Set analog input port of decoder */
2795 static int
2796 decoder_set_input(struct usb_ov511 *ov, int input)
2798 PDEBUG(4, "port %d", input);
2800 switch (ov->sensor) {
2801 case SEN_SAA7111A:
2803 /* Select mode */
2804 i2c_w_mask(ov, 0x02, input, 0x07);
2805 /* Bypass chrominance trap for modes 4..7 */
2806 i2c_w_mask(ov, 0x09, (input > 3) ? 0x80:0x00, 0x80);
2807 break;
2809 default:
2810 return -EINVAL;
2813 return 0;
2816 /* Get ASCII name of video input */
2817 static int
2818 decoder_get_input_name(struct usb_ov511 *ov, int input, char *name)
2820 switch (ov->sensor) {
2821 case SEN_SAA7111A:
2823 if (input < 0 || input > 7)
2824 return -EINVAL;
2825 else if (input < 4)
2826 sprintf(name, "CVBS-%d", input);
2827 else // if (input < 8)
2828 sprintf(name, "S-Video-%d", input - 4);
2829 break;
2831 default:
2832 sprintf(name, "%s", "Camera");
2835 return 0;
2838 /* Set norm (NTSC, PAL, SECAM, AUTO) */
2839 static int
2840 decoder_set_norm(struct usb_ov511 *ov, int norm)
2842 PDEBUG(4, "%d", norm);
2844 switch (ov->sensor) {
2845 case SEN_SAA7111A:
2847 int reg_8, reg_e;
2849 if (norm == VIDEO_MODE_NTSC) {
2850 reg_8 = 0x40; /* 60 Hz */
2851 reg_e = 0x00; /* NTSC M / PAL BGHI */
2852 } else if (norm == VIDEO_MODE_PAL) {
2853 reg_8 = 0x00; /* 50 Hz */
2854 reg_e = 0x00; /* NTSC M / PAL BGHI */
2855 } else if (norm == VIDEO_MODE_AUTO) {
2856 reg_8 = 0x80; /* Auto field detect */
2857 reg_e = 0x00; /* NTSC M / PAL BGHI */
2858 } else if (norm == VIDEO_MODE_SECAM) {
2859 reg_8 = 0x00; /* 50 Hz */
2860 reg_e = 0x50; /* SECAM / PAL 4.43 */
2861 } else {
2862 return -EINVAL;
2865 i2c_w_mask(ov, 0x08, reg_8, 0xc0);
2866 i2c_w_mask(ov, 0x0e, reg_e, 0x70);
2867 break;
2869 default:
2870 return -EINVAL;
2873 return 0;
2876 /**********************************************************************
2878 * Raw data parsing
2880 **********************************************************************/
2882 /* Copies a 64-byte segment at pIn to an 8x8 block at pOut. The width of the
2883 * image at pOut is specified by w.
2885 static inline void
2886 make_8x8(unsigned char *pIn, unsigned char *pOut, int w)
2888 unsigned char *pOut1 = pOut;
2889 int x, y;
2891 for (y = 0; y < 8; y++) {
2892 pOut1 = pOut;
2893 for (x = 0; x < 8; x++) {
2894 *pOut1++ = *pIn++;
2896 pOut += w;
2901 * For RAW BW (YUV 4:0:0) images, data show up in 256 byte segments.
2902 * The segments represent 4 squares of 8x8 pixels as follows:
2904 * 0 1 ... 7 64 65 ... 71 ... 192 193 ... 199
2905 * 8 9 ... 15 72 73 ... 79 200 201 ... 207
2906 * ... ... ...
2907 * 56 57 ... 63 120 121 ... 127 248 249 ... 255
2910 static void
2911 yuv400raw_to_yuv400p(struct ov511_frame *frame,
2912 unsigned char *pIn0, unsigned char *pOut0)
2914 int x, y;
2915 unsigned char *pIn, *pOut, *pOutLine;
2917 /* Copy Y */
2918 pIn = pIn0;
2919 pOutLine = pOut0;
2920 for (y = 0; y < frame->rawheight - 1; y += 8) {
2921 pOut = pOutLine;
2922 for (x = 0; x < frame->rawwidth - 1; x += 8) {
2923 make_8x8(pIn, pOut, frame->rawwidth);
2924 pIn += 64;
2925 pOut += 8;
2927 pOutLine += 8 * frame->rawwidth;
2932 * For YUV 4:2:0 images, the data show up in 384 byte segments.
2933 * The first 64 bytes of each segment are U, the next 64 are V. The U and
2934 * V are arranged as follows:
2936 * 0 1 ... 7
2937 * 8 9 ... 15
2938 * ...
2939 * 56 57 ... 63
2941 * U and V are shipped at half resolution (1 U,V sample -> one 2x2 block).
2943 * The next 256 bytes are full resolution Y data and represent 4 squares
2944 * of 8x8 pixels as follows:
2946 * 0 1 ... 7 64 65 ... 71 ... 192 193 ... 199
2947 * 8 9 ... 15 72 73 ... 79 200 201 ... 207
2948 * ... ... ...
2949 * 56 57 ... 63 120 121 ... 127 ... 248 249 ... 255
2951 * Note that the U and V data in one segment represent a 16 x 16 pixel
2952 * area, but the Y data represent a 32 x 8 pixel area. If the width is not an
2953 * even multiple of 32, the extra 8x8 blocks within a 32x8 block belong to the
2954 * next horizontal stripe.
2956 * If dumppix module param is set, _parse_data just dumps the incoming segments,
2957 * verbatim, in order, into the frame. When used with vidcat -f ppm -s 640x480
2958 * this puts the data on the standard output and can be analyzed with the
2959 * parseppm.c utility I wrote. That's a much faster way for figuring out how
2960 * these data are scrambled.
2963 /* Converts from raw, uncompressed segments at pIn0 to a YUV420P frame at pOut0.
2965 * FIXME: Currently only handles width and height that are multiples of 16
2967 static void
2968 yuv420raw_to_yuv420p(struct ov511_frame *frame,
2969 unsigned char *pIn0, unsigned char *pOut0)
2971 int k, x, y;
2972 unsigned char *pIn, *pOut, *pOutLine;
2973 const unsigned int a = frame->rawwidth * frame->rawheight;
2974 const unsigned int w = frame->rawwidth / 2;
2976 /* Copy U and V */
2977 pIn = pIn0;
2978 pOutLine = pOut0 + a;
2979 for (y = 0; y < frame->rawheight - 1; y += 16) {
2980 pOut = pOutLine;
2981 for (x = 0; x < frame->rawwidth - 1; x += 16) {
2982 make_8x8(pIn, pOut, w);
2983 make_8x8(pIn + 64, pOut + a/4, w);
2984 pIn += 384;
2985 pOut += 8;
2987 pOutLine += 8 * w;
2990 /* Copy Y */
2991 pIn = pIn0 + 128;
2992 pOutLine = pOut0;
2993 k = 0;
2994 for (y = 0; y < frame->rawheight - 1; y += 8) {
2995 pOut = pOutLine;
2996 for (x = 0; x < frame->rawwidth - 1; x += 8) {
2997 make_8x8(pIn, pOut, frame->rawwidth);
2998 pIn += 64;
2999 pOut += 8;
3000 if ((++k) > 3) {
3001 k = 0;
3002 pIn += 128;
3005 pOutLine += 8 * frame->rawwidth;
3009 /**********************************************************************
3011 * Decompression
3013 **********************************************************************/
3015 /* Chooses a decompression module, locks it, and sets ov->decomp_ops
3016 * accordingly. Returns -ENXIO if decompressor is not available, otherwise
3017 * returns 0 if no other error.
3019 static int
3020 request_decompressor(struct usb_ov511 *ov)
3022 if (!ov)
3023 return -ENODEV;
3025 if (ov->decomp_ops) {
3026 err("ERROR: Decompressor already requested!");
3027 return -EINVAL;
3030 lock_kernel();
3032 /* Try to get MMX, and fall back on no-MMX if necessary */
3033 if (ov->bclass == BCL_OV511) {
3034 if (ov511_mmx_decomp_ops) {
3035 PDEBUG(3, "Using OV511 MMX decompressor");
3036 ov->decomp_ops = ov511_mmx_decomp_ops;
3037 } else if (ov511_decomp_ops) {
3038 PDEBUG(3, "Using OV511 decompressor");
3039 ov->decomp_ops = ov511_decomp_ops;
3040 } else {
3041 err("No decompressor available");
3043 } else if (ov->bclass == BCL_OV518) {
3044 if (ov518_mmx_decomp_ops) {
3045 PDEBUG(3, "Using OV518 MMX decompressor");
3046 ov->decomp_ops = ov518_mmx_decomp_ops;
3047 } else if (ov518_decomp_ops) {
3048 PDEBUG(3, "Using OV518 decompressor");
3049 ov->decomp_ops = ov518_decomp_ops;
3050 } else {
3051 err("No decompressor available");
3053 } else {
3054 err("Unknown bridge");
3057 if (!ov->decomp_ops)
3058 goto nosys;
3060 if (!ov->decomp_ops->owner) {
3061 ov->decomp_ops = NULL;
3062 goto nosys;
3065 if (!try_module_get(ov->decomp_ops->owner))
3066 goto nosys;
3068 unlock_kernel();
3069 return 0;
3071 nosys:
3072 unlock_kernel();
3073 return -ENOSYS;
3076 /* Unlocks decompression module and nulls ov->decomp_ops. Safe to call even
3077 * if ov->decomp_ops is NULL.
3079 static void
3080 release_decompressor(struct usb_ov511 *ov)
3082 int released = 0; /* Did we actually do anything? */
3084 if (!ov)
3085 return;
3087 lock_kernel();
3089 if (ov->decomp_ops) {
3090 module_put(ov->decomp_ops->owner);
3091 released = 1;
3094 ov->decomp_ops = NULL;
3096 unlock_kernel();
3098 if (released)
3099 PDEBUG(3, "Decompressor released");
3102 static void
3103 decompress(struct usb_ov511 *ov, struct ov511_frame *frame,
3104 unsigned char *pIn0, unsigned char *pOut0)
3106 if (!ov->decomp_ops)
3107 if (request_decompressor(ov))
3108 return;
3110 PDEBUG(4, "Decompressing %d bytes", frame->bytes_recvd);
3112 if (frame->format == VIDEO_PALETTE_GREY
3113 && ov->decomp_ops->decomp_400) {
3114 int ret = ov->decomp_ops->decomp_400(
3115 pIn0,
3116 pOut0,
3117 frame->compbuf,
3118 frame->rawwidth,
3119 frame->rawheight,
3120 frame->bytes_recvd);
3121 PDEBUG(4, "DEBUG: decomp_400 returned %d", ret);
3122 } else if (frame->format != VIDEO_PALETTE_GREY
3123 && ov->decomp_ops->decomp_420) {
3124 int ret = ov->decomp_ops->decomp_420(
3125 pIn0,
3126 pOut0,
3127 frame->compbuf,
3128 frame->rawwidth,
3129 frame->rawheight,
3130 frame->bytes_recvd);
3131 PDEBUG(4, "DEBUG: decomp_420 returned %d", ret);
3132 } else {
3133 err("Decompressor does not support this format");
3137 /**********************************************************************
3139 * Format conversion
3141 **********************************************************************/
3143 /* Fuses even and odd fields together, and doubles width.
3144 * INPUT: an odd field followed by an even field at pIn0, in YUV planar format
3145 * OUTPUT: a normal YUV planar image, with correct aspect ratio
3147 static void
3148 deinterlace(struct ov511_frame *frame, int rawformat,
3149 unsigned char *pIn0, unsigned char *pOut0)
3151 const int fieldheight = frame->rawheight / 2;
3152 const int fieldpix = fieldheight * frame->rawwidth;
3153 const int w = frame->width;
3154 int x, y;
3155 unsigned char *pInEven, *pInOdd, *pOut;
3157 PDEBUG(5, "fieldheight=%d", fieldheight);
3159 if (frame->rawheight != frame->height) {
3160 err("invalid height");
3161 return;
3164 if ((frame->rawwidth * 2) != frame->width) {
3165 err("invalid width");
3166 return;
3169 /* Y */
3170 pInOdd = pIn0;
3171 pInEven = pInOdd + fieldpix;
3172 pOut = pOut0;
3173 for (y = 0; y < fieldheight; y++) {
3174 for (x = 0; x < frame->rawwidth; x++) {
3175 *pOut = *pInEven;
3176 *(pOut+1) = *pInEven++;
3177 *(pOut+w) = *pInOdd;
3178 *(pOut+w+1) = *pInOdd++;
3179 pOut += 2;
3181 pOut += w;
3184 if (rawformat == RAWFMT_YUV420) {
3185 /* U */
3186 pInOdd = pIn0 + fieldpix * 2;
3187 pInEven = pInOdd + fieldpix / 4;
3188 for (y = 0; y < fieldheight / 2; y++) {
3189 for (x = 0; x < frame->rawwidth / 2; x++) {
3190 *pOut = *pInEven;
3191 *(pOut+1) = *pInEven++;
3192 *(pOut+w/2) = *pInOdd;
3193 *(pOut+w/2+1) = *pInOdd++;
3194 pOut += 2;
3196 pOut += w/2;
3198 /* V */
3199 pInOdd = pIn0 + fieldpix * 2 + fieldpix / 2;
3200 pInEven = pInOdd + fieldpix / 4;
3201 for (y = 0; y < fieldheight / 2; y++) {
3202 for (x = 0; x < frame->rawwidth / 2; x++) {
3203 *pOut = *pInEven;
3204 *(pOut+1) = *pInEven++;
3205 *(pOut+w/2) = *pInOdd;
3206 *(pOut+w/2+1) = *pInOdd++;
3207 pOut += 2;
3209 pOut += w/2;
3214 static void
3215 ov51x_postprocess_grey(struct usb_ov511 *ov, struct ov511_frame *frame)
3217 /* Deinterlace frame, if necessary */
3218 if (ov->sensor == SEN_SAA7111A && frame->rawheight >= 480) {
3219 if (frame->compressed)
3220 decompress(ov, frame, frame->rawdata,
3221 frame->tempdata);
3222 else
3223 yuv400raw_to_yuv400p(frame, frame->rawdata,
3224 frame->tempdata);
3226 deinterlace(frame, RAWFMT_YUV400, frame->tempdata,
3227 frame->data);
3228 } else {
3229 if (frame->compressed)
3230 decompress(ov, frame, frame->rawdata,
3231 frame->data);
3232 else
3233 yuv400raw_to_yuv400p(frame, frame->rawdata,
3234 frame->data);
3238 /* Process raw YUV420 data into standard YUV420P */
3239 static void
3240 ov51x_postprocess_yuv420(struct usb_ov511 *ov, struct ov511_frame *frame)
3242 /* Deinterlace frame, if necessary */
3243 if (ov->sensor == SEN_SAA7111A && frame->rawheight >= 480) {
3244 if (frame->compressed)
3245 decompress(ov, frame, frame->rawdata, frame->tempdata);
3246 else
3247 yuv420raw_to_yuv420p(frame, frame->rawdata,
3248 frame->tempdata);
3250 deinterlace(frame, RAWFMT_YUV420, frame->tempdata,
3251 frame->data);
3252 } else {
3253 if (frame->compressed)
3254 decompress(ov, frame, frame->rawdata, frame->data);
3255 else
3256 yuv420raw_to_yuv420p(frame, frame->rawdata,
3257 frame->data);
3261 /* Post-processes the specified frame. This consists of:
3262 * 1. Decompress frame, if necessary
3263 * 2. Deinterlace frame and scale to proper size, if necessary
3264 * 3. Convert from YUV planar to destination format, if necessary
3265 * 4. Fix the RGB offset, if necessary
3267 static void
3268 ov51x_postprocess(struct usb_ov511 *ov, struct ov511_frame *frame)
3270 if (dumppix) {
3271 memset(frame->data, 0,
3272 MAX_DATA_SIZE(ov->maxwidth, ov->maxheight));
3273 PDEBUG(4, "Dumping %d bytes", frame->bytes_recvd);
3274 memcpy(frame->data, frame->rawdata, frame->bytes_recvd);
3275 } else {
3276 switch (frame->format) {
3277 case VIDEO_PALETTE_GREY:
3278 ov51x_postprocess_grey(ov, frame);
3279 break;
3280 case VIDEO_PALETTE_YUV420:
3281 case VIDEO_PALETTE_YUV420P:
3282 ov51x_postprocess_yuv420(ov, frame);
3283 break;
3284 default:
3285 err("Cannot convert data to %s",
3286 symbolic(v4l1_plist, frame->format));
3291 /**********************************************************************
3293 * OV51x data transfer, IRQ handler
3295 **********************************************************************/
3297 static inline void
3298 ov511_move_data(struct usb_ov511 *ov, unsigned char *in, int n)
3300 int num, offset;
3301 int pnum = in[ov->packet_size - 1]; /* Get packet number */
3302 int max_raw = MAX_RAW_DATA_SIZE(ov->maxwidth, ov->maxheight);
3303 struct ov511_frame *frame = &ov->frame[ov->curframe];
3304 struct timeval *ts;
3306 /* SOF/EOF packets have 1st to 8th bytes zeroed and the 9th
3307 * byte non-zero. The EOF packet has image width/height in the
3308 * 10th and 11th bytes. The 9th byte is given as follows:
3310 * bit 7: EOF
3311 * 6: compression enabled
3312 * 5: 422/420/400 modes
3313 * 4: 422/420/400 modes
3314 * 3: 1
3315 * 2: snapshot button on
3316 * 1: snapshot frame
3317 * 0: even/odd field
3320 if (printph) {
3321 info("ph(%3d): %2x %2x %2x %2x %2x %2x %2x %2x %2x %2x %2x %2x",
3322 pnum, in[0], in[1], in[2], in[3], in[4], in[5], in[6],
3323 in[7], in[8], in[9], in[10], in[11]);
3326 /* Check for SOF/EOF packet */
3327 if ((in[0] | in[1] | in[2] | in[3] | in[4] | in[5] | in[6] | in[7]) ||
3328 (~in[8] & 0x08))
3329 goto check_middle;
3331 /* Frame end */
3332 if (in[8] & 0x80) {
3333 ts = (struct timeval *)(frame->data
3334 + MAX_FRAME_SIZE(ov->maxwidth, ov->maxheight));
3335 do_gettimeofday(ts);
3337 /* Get the actual frame size from the EOF header */
3338 frame->rawwidth = ((int)(in[9]) + 1) * 8;
3339 frame->rawheight = ((int)(in[10]) + 1) * 8;
3341 PDEBUG(4, "Frame end, frame=%d, pnum=%d, w=%d, h=%d, recvd=%d",
3342 ov->curframe, pnum, frame->rawwidth, frame->rawheight,
3343 frame->bytes_recvd);
3345 /* Validate the header data */
3346 RESTRICT_TO_RANGE(frame->rawwidth, ov->minwidth, ov->maxwidth);
3347 RESTRICT_TO_RANGE(frame->rawheight, ov->minheight,
3348 ov->maxheight);
3350 /* Don't allow byte count to exceed buffer size */
3351 RESTRICT_TO_RANGE(frame->bytes_recvd, 8, max_raw);
3353 if (frame->scanstate == STATE_LINES) {
3354 int nextf;
3356 frame->grabstate = FRAME_DONE;
3357 wake_up_interruptible(&frame->wq);
3359 /* If next frame is ready or grabbing,
3360 * point to it */
3361 nextf = (ov->curframe + 1) % OV511_NUMFRAMES;
3362 if (ov->frame[nextf].grabstate == FRAME_READY
3363 || ov->frame[nextf].grabstate == FRAME_GRABBING) {
3364 ov->curframe = nextf;
3365 ov->frame[nextf].scanstate = STATE_SCANNING;
3366 } else {
3367 if (frame->grabstate == FRAME_DONE) {
3368 PDEBUG(4, "** Frame done **");
3369 } else {
3370 PDEBUG(4, "Frame not ready? state = %d",
3371 ov->frame[nextf].grabstate);
3374 ov->curframe = -1;
3376 } else {
3377 PDEBUG(5, "Frame done, but not scanning");
3379 /* Image corruption caused by misplaced frame->segment = 0
3380 * fixed by carlosf@conectiva.com.br
3382 } else {
3383 /* Frame start */
3384 PDEBUG(4, "Frame start, framenum = %d", ov->curframe);
3386 /* Check to see if it's a snapshot frame */
3387 /* FIXME?? Should the snapshot reset go here? Performance? */
3388 if (in[8] & 0x02) {
3389 frame->snapshot = 1;
3390 PDEBUG(3, "snapshot detected");
3393 frame->scanstate = STATE_LINES;
3394 frame->bytes_recvd = 0;
3395 frame->compressed = in[8] & 0x40;
3398 check_middle:
3399 /* Are we in a frame? */
3400 if (frame->scanstate != STATE_LINES) {
3401 PDEBUG(5, "Not in a frame; packet skipped");
3402 return;
3405 /* If frame start, skip header */
3406 if (frame->bytes_recvd == 0)
3407 offset = 9;
3408 else
3409 offset = 0;
3411 num = n - offset - 1;
3413 /* Dump all data exactly as received */
3414 if (dumppix == 2) {
3415 frame->bytes_recvd += n - 1;
3416 if (frame->bytes_recvd <= max_raw)
3417 memcpy(frame->rawdata + frame->bytes_recvd - (n - 1),
3418 in, n - 1);
3419 else
3420 PDEBUG(3, "Raw data buffer overrun!! (%d)",
3421 frame->bytes_recvd - max_raw);
3422 } else if (!frame->compressed && !remove_zeros) {
3423 frame->bytes_recvd += num;
3424 if (frame->bytes_recvd <= max_raw)
3425 memcpy(frame->rawdata + frame->bytes_recvd - num,
3426 in + offset, num);
3427 else
3428 PDEBUG(3, "Raw data buffer overrun!! (%d)",
3429 frame->bytes_recvd - max_raw);
3430 } else { /* Remove all-zero FIFO lines (aligned 32-byte blocks) */
3431 int b, read = 0, allzero, copied = 0;
3432 if (offset) {
3433 frame->bytes_recvd += 32 - offset; // Bytes out
3434 memcpy(frame->rawdata, in + offset, 32 - offset);
3435 read += 32;
3438 while (read < n - 1) {
3439 allzero = 1;
3440 for (b = 0; b < 32; b++) {
3441 if (in[read + b]) {
3442 allzero = 0;
3443 break;
3447 if (allzero) {
3448 /* Don't copy it */
3449 } else {
3450 if (frame->bytes_recvd + copied + 32 <= max_raw)
3452 memcpy(frame->rawdata
3453 + frame->bytes_recvd + copied,
3454 in + read, 32);
3455 copied += 32;
3456 } else {
3457 PDEBUG(3, "Raw data buffer overrun!!");
3460 read += 32;
3463 frame->bytes_recvd += copied;
3467 static inline void
3468 ov518_move_data(struct usb_ov511 *ov, unsigned char *in, int n)
3470 int max_raw = MAX_RAW_DATA_SIZE(ov->maxwidth, ov->maxheight);
3471 struct ov511_frame *frame = &ov->frame[ov->curframe];
3472 struct timeval *ts;
3474 /* Don't copy the packet number byte */
3475 if (ov->packet_numbering)
3476 --n;
3478 /* A false positive here is likely, until OVT gives me
3479 * the definitive SOF/EOF format */
3480 if ((!(in[0] | in[1] | in[2] | in[3] | in[5])) && in[6]) {
3481 if (printph) {
3482 info("ph: %2x %2x %2x %2x %2x %2x %2x %2x", in[0],
3483 in[1], in[2], in[3], in[4], in[5], in[6], in[7]);
3486 if (frame->scanstate == STATE_LINES) {
3487 PDEBUG(4, "Detected frame end/start");
3488 goto eof;
3489 } else { //scanstate == STATE_SCANNING
3490 /* Frame start */
3491 PDEBUG(4, "Frame start, framenum = %d", ov->curframe);
3492 goto sof;
3494 } else {
3495 goto check_middle;
3498 eof:
3499 ts = (struct timeval *)(frame->data
3500 + MAX_FRAME_SIZE(ov->maxwidth, ov->maxheight));
3501 do_gettimeofday(ts);
3503 PDEBUG(4, "Frame end, curframe = %d, hw=%d, vw=%d, recvd=%d",
3504 ov->curframe,
3505 (int)(in[9]), (int)(in[10]), frame->bytes_recvd);
3507 // FIXME: Since we don't know the header formats yet,
3508 // there is no way to know what the actual image size is
3509 frame->rawwidth = frame->width;
3510 frame->rawheight = frame->height;
3512 /* Validate the header data */
3513 RESTRICT_TO_RANGE(frame->rawwidth, ov->minwidth, ov->maxwidth);
3514 RESTRICT_TO_RANGE(frame->rawheight, ov->minheight, ov->maxheight);
3516 /* Don't allow byte count to exceed buffer size */
3517 RESTRICT_TO_RANGE(frame->bytes_recvd, 8, max_raw);
3519 if (frame->scanstate == STATE_LINES) {
3520 int nextf;
3522 frame->grabstate = FRAME_DONE;
3523 wake_up_interruptible(&frame->wq);
3525 /* If next frame is ready or grabbing,
3526 * point to it */
3527 nextf = (ov->curframe + 1) % OV511_NUMFRAMES;
3528 if (ov->frame[nextf].grabstate == FRAME_READY
3529 || ov->frame[nextf].grabstate == FRAME_GRABBING) {
3530 ov->curframe = nextf;
3531 ov->frame[nextf].scanstate = STATE_SCANNING;
3532 frame = &ov->frame[nextf];
3533 } else {
3534 if (frame->grabstate == FRAME_DONE) {
3535 PDEBUG(4, "** Frame done **");
3536 } else {
3537 PDEBUG(4, "Frame not ready? state = %d",
3538 ov->frame[nextf].grabstate);
3541 ov->curframe = -1;
3542 PDEBUG(4, "SOF dropped (no active frame)");
3543 return; /* Nowhere to store this frame */
3546 sof:
3547 PDEBUG(4, "Starting capture on frame %d", frame->framenum);
3549 // Snapshot not reverse-engineered yet.
3550 #if 0
3551 /* Check to see if it's a snapshot frame */
3552 /* FIXME?? Should the snapshot reset go here? Performance? */
3553 if (in[8] & 0x02) {
3554 frame->snapshot = 1;
3555 PDEBUG(3, "snapshot detected");
3557 #endif
3558 frame->scanstate = STATE_LINES;
3559 frame->bytes_recvd = 0;
3560 frame->compressed = 1;
3562 check_middle:
3563 /* Are we in a frame? */
3564 if (frame->scanstate != STATE_LINES) {
3565 PDEBUG(4, "scanstate: no SOF yet");
3566 return;
3569 /* Dump all data exactly as received */
3570 if (dumppix == 2) {
3571 frame->bytes_recvd += n;
3572 if (frame->bytes_recvd <= max_raw)
3573 memcpy(frame->rawdata + frame->bytes_recvd - n, in, n);
3574 else
3575 PDEBUG(3, "Raw data buffer overrun!! (%d)",
3576 frame->bytes_recvd - max_raw);
3577 } else {
3578 /* All incoming data are divided into 8-byte segments. If the
3579 * segment contains all zero bytes, it must be skipped. These
3580 * zero-segments allow the OV518 to mainain a constant data rate
3581 * regardless of the effectiveness of the compression. Segments
3582 * are aligned relative to the beginning of each isochronous
3583 * packet. The first segment in each image is a header (the
3584 * decompressor skips it later).
3587 int b, read = 0, allzero, copied = 0;
3589 while (read < n) {
3590 allzero = 1;
3591 for (b = 0; b < 8; b++) {
3592 if (in[read + b]) {
3593 allzero = 0;
3594 break;
3598 if (allzero) {
3599 /* Don't copy it */
3600 } else {
3601 if (frame->bytes_recvd + copied + 8 <= max_raw)
3603 memcpy(frame->rawdata
3604 + frame->bytes_recvd + copied,
3605 in + read, 8);
3606 copied += 8;
3607 } else {
3608 PDEBUG(3, "Raw data buffer overrun!!");
3611 read += 8;
3613 frame->bytes_recvd += copied;
3617 static void
3618 ov51x_isoc_irq(struct urb *urb, struct pt_regs *regs)
3620 int i;
3621 struct usb_ov511 *ov;
3622 struct ov511_sbuf *sbuf;
3624 if (!urb->context) {
3625 PDEBUG(4, "no context");
3626 return;
3629 sbuf = urb->context;
3630 ov = sbuf->ov;
3632 if (!ov || !ov->dev || !ov->user) {
3633 PDEBUG(4, "no device, or not open");
3634 return;
3637 if (!ov->streaming) {
3638 PDEBUG(4, "hmmm... not streaming, but got interrupt");
3639 return;
3642 if (urb->status == -ENOENT || urb->status == -ECONNRESET) {
3643 PDEBUG(4, "URB unlinked");
3644 return;
3647 if (urb->status != -EINPROGRESS && urb->status != 0) {
3648 err("ERROR: urb->status=%d: %s", urb->status,
3649 symbolic(urb_errlist, urb->status));
3652 /* Copy the data received into our frame buffer */
3653 PDEBUG(5, "sbuf[%d]: Moving %d packets", sbuf->n,
3654 urb->number_of_packets);
3655 for (i = 0; i < urb->number_of_packets; i++) {
3656 /* Warning: Don't call *_move_data() if no frame active! */
3657 if (ov->curframe >= 0) {
3658 int n = urb->iso_frame_desc[i].actual_length;
3659 int st = urb->iso_frame_desc[i].status;
3660 unsigned char *cdata;
3662 urb->iso_frame_desc[i].actual_length = 0;
3663 urb->iso_frame_desc[i].status = 0;
3665 cdata = urb->transfer_buffer
3666 + urb->iso_frame_desc[i].offset;
3668 if (!n) {
3669 PDEBUG(4, "Zero-length packet");
3670 continue;
3673 if (st)
3674 PDEBUG(2, "data error: [%d] len=%d, status=%d",
3675 i, n, st);
3677 if (ov->bclass == BCL_OV511)
3678 ov511_move_data(ov, cdata, n);
3679 else if (ov->bclass == BCL_OV518)
3680 ov518_move_data(ov, cdata, n);
3681 else
3682 err("Unknown bridge device (%d)", ov->bridge);
3684 } else if (waitqueue_active(&ov->wq)) {
3685 wake_up_interruptible(&ov->wq);
3689 /* Resubmit this URB */
3690 urb->dev = ov->dev;
3691 if ((i = usb_submit_urb(urb, GFP_ATOMIC)) != 0)
3692 err("usb_submit_urb() ret %d", i);
3694 return;
3697 /****************************************************************************
3699 * Stream initialization and termination
3701 ***************************************************************************/
3703 static int
3704 ov51x_init_isoc(struct usb_ov511 *ov)
3706 struct urb *urb;
3707 int fx, err, n, size;
3709 PDEBUG(3, "*** Initializing capture ***");
3711 ov->curframe = -1;
3713 if (ov->bridge == BRG_OV511) {
3714 if (cams == 1)
3715 size = 993;
3716 else if (cams == 2)
3717 size = 513;
3718 else if (cams == 3 || cams == 4)
3719 size = 257;
3720 else {
3721 err("\"cams\" parameter too high!");
3722 return -1;
3724 } else if (ov->bridge == BRG_OV511PLUS) {
3725 if (cams == 1)
3726 size = 961;
3727 else if (cams == 2)
3728 size = 513;
3729 else if (cams == 3 || cams == 4)
3730 size = 257;
3731 else if (cams >= 5 && cams <= 8)
3732 size = 129;
3733 else if (cams >= 9 && cams <= 31)
3734 size = 33;
3735 else {
3736 err("\"cams\" parameter too high!");
3737 return -1;
3739 } else if (ov->bclass == BCL_OV518) {
3740 if (cams == 1)
3741 size = 896;
3742 else if (cams == 2)
3743 size = 512;
3744 else if (cams == 3 || cams == 4)
3745 size = 256;
3746 else if (cams >= 5 && cams <= 8)
3747 size = 128;
3748 else {
3749 err("\"cams\" parameter too high!");
3750 return -1;
3752 } else {
3753 err("invalid bridge type");
3754 return -1;
3757 // FIXME: OV518 is hardcoded to 15 FPS (alternate 5) for now
3758 if (ov->bclass == BCL_OV518) {
3759 if (packetsize == -1) {
3760 ov518_set_packet_size(ov, 640);
3761 } else {
3762 info("Forcing packet size to %d", packetsize);
3763 ov518_set_packet_size(ov, packetsize);
3765 } else {
3766 if (packetsize == -1) {
3767 ov511_set_packet_size(ov, size);
3768 } else {
3769 info("Forcing packet size to %d", packetsize);
3770 ov511_set_packet_size(ov, packetsize);
3774 for (n = 0; n < OV511_NUMSBUF; n++) {
3775 urb = usb_alloc_urb(FRAMES_PER_DESC, GFP_KERNEL);
3776 if (!urb) {
3777 err("init isoc: usb_alloc_urb ret. NULL");
3778 return -ENOMEM;
3780 ov->sbuf[n].urb = urb;
3781 urb->dev = ov->dev;
3782 urb->context = &ov->sbuf[n];
3783 urb->pipe = usb_rcvisocpipe(ov->dev, OV511_ENDPOINT_ADDRESS);
3784 urb->transfer_flags = URB_ISO_ASAP;
3785 urb->transfer_buffer = ov->sbuf[n].data;
3786 urb->complete = ov51x_isoc_irq;
3787 urb->number_of_packets = FRAMES_PER_DESC;
3788 urb->transfer_buffer_length = ov->packet_size * FRAMES_PER_DESC;
3789 urb->interval = 1;
3790 for (fx = 0; fx < FRAMES_PER_DESC; fx++) {
3791 urb->iso_frame_desc[fx].offset = ov->packet_size * fx;
3792 urb->iso_frame_desc[fx].length = ov->packet_size;
3796 ov->streaming = 1;
3798 for (n = 0; n < OV511_NUMSBUF; n++) {
3799 ov->sbuf[n].urb->dev = ov->dev;
3800 err = usb_submit_urb(ov->sbuf[n].urb, GFP_KERNEL);
3801 if (err) {
3802 err("init isoc: usb_submit_urb(%d) ret %d", n, err);
3803 return err;
3807 return 0;
3810 static void
3811 ov51x_unlink_isoc(struct usb_ov511 *ov)
3813 int n;
3815 /* Unschedule all of the iso td's */
3816 for (n = OV511_NUMSBUF - 1; n >= 0; n--) {
3817 if (ov->sbuf[n].urb) {
3818 usb_kill_urb(ov->sbuf[n].urb);
3819 usb_free_urb(ov->sbuf[n].urb);
3820 ov->sbuf[n].urb = NULL;
3825 static void
3826 ov51x_stop_isoc(struct usb_ov511 *ov)
3828 if (!ov->streaming || !ov->dev)
3829 return;
3831 PDEBUG(3, "*** Stopping capture ***");
3833 if (ov->bclass == BCL_OV518)
3834 ov518_set_packet_size(ov, 0);
3835 else
3836 ov511_set_packet_size(ov, 0);
3838 ov->streaming = 0;
3840 ov51x_unlink_isoc(ov);
3843 static int
3844 ov51x_new_frame(struct usb_ov511 *ov, int framenum)
3846 struct ov511_frame *frame;
3847 int newnum;
3849 PDEBUG(4, "ov->curframe = %d, framenum = %d", ov->curframe, framenum);
3851 if (!ov->dev)
3852 return -1;
3854 /* If we're not grabbing a frame right now and the other frame is */
3855 /* ready to be grabbed into, then use it instead */
3856 if (ov->curframe == -1) {
3857 newnum = (framenum - 1 + OV511_NUMFRAMES) % OV511_NUMFRAMES;
3858 if (ov->frame[newnum].grabstate == FRAME_READY)
3859 framenum = newnum;
3860 } else
3861 return 0;
3863 frame = &ov->frame[framenum];
3865 PDEBUG(4, "framenum = %d, width = %d, height = %d", framenum,
3866 frame->width, frame->height);
3868 frame->grabstate = FRAME_GRABBING;
3869 frame->scanstate = STATE_SCANNING;
3870 frame->snapshot = 0;
3872 ov->curframe = framenum;
3874 /* Make sure it's not too big */
3875 if (frame->width > ov->maxwidth)
3876 frame->width = ov->maxwidth;
3878 frame->width &= ~7L; /* Multiple of 8 */
3880 if (frame->height > ov->maxheight)
3881 frame->height = ov->maxheight;
3883 frame->height &= ~3L; /* Multiple of 4 */
3885 return 0;
3888 /****************************************************************************
3890 * Buffer management
3892 ***************************************************************************/
3895 * - You must acquire buf_lock before entering this function.
3896 * - Because this code will free any non-null pointer, you must be sure to null
3897 * them if you explicitly free them somewhere else!
3899 static void
3900 ov51x_do_dealloc(struct usb_ov511 *ov)
3902 int i;
3903 PDEBUG(4, "entered");
3905 if (ov->fbuf) {
3906 rvfree(ov->fbuf, OV511_NUMFRAMES
3907 * MAX_DATA_SIZE(ov->maxwidth, ov->maxheight));
3908 ov->fbuf = NULL;
3911 vfree(ov->rawfbuf);
3912 ov->rawfbuf = NULL;
3914 vfree(ov->tempfbuf);
3915 ov->tempfbuf = NULL;
3917 for (i = 0; i < OV511_NUMSBUF; i++) {
3918 if (ov->sbuf[i].data) {
3919 kfree(ov->sbuf[i].data);
3920 ov->sbuf[i].data = NULL;
3924 for (i = 0; i < OV511_NUMFRAMES; i++) {
3925 ov->frame[i].data = NULL;
3926 ov->frame[i].rawdata = NULL;
3927 ov->frame[i].tempdata = NULL;
3928 if (ov->frame[i].compbuf) {
3929 free_page((unsigned long) ov->frame[i].compbuf);
3930 ov->frame[i].compbuf = NULL;
3934 PDEBUG(4, "buffer memory deallocated");
3935 ov->buf_state = BUF_NOT_ALLOCATED;
3936 PDEBUG(4, "leaving");
3939 static int
3940 ov51x_alloc(struct usb_ov511 *ov)
3942 int i;
3943 const int w = ov->maxwidth;
3944 const int h = ov->maxheight;
3945 const int data_bufsize = OV511_NUMFRAMES * MAX_DATA_SIZE(w, h);
3946 const int raw_bufsize = OV511_NUMFRAMES * MAX_RAW_DATA_SIZE(w, h);
3948 PDEBUG(4, "entered");
3949 down(&ov->buf_lock);
3951 if (ov->buf_state == BUF_ALLOCATED)
3952 goto out;
3954 ov->fbuf = rvmalloc(data_bufsize);
3955 if (!ov->fbuf)
3956 goto error;
3958 ov->rawfbuf = vmalloc(raw_bufsize);
3959 if (!ov->rawfbuf)
3960 goto error;
3962 memset(ov->rawfbuf, 0, raw_bufsize);
3964 ov->tempfbuf = vmalloc(raw_bufsize);
3965 if (!ov->tempfbuf)
3966 goto error;
3968 memset(ov->tempfbuf, 0, raw_bufsize);
3970 for (i = 0; i < OV511_NUMSBUF; i++) {
3971 ov->sbuf[i].data = kmalloc(FRAMES_PER_DESC *
3972 MAX_FRAME_SIZE_PER_DESC, GFP_KERNEL);
3973 if (!ov->sbuf[i].data)
3974 goto error;
3976 PDEBUG(4, "sbuf[%d] @ %p", i, ov->sbuf[i].data);
3979 for (i = 0; i < OV511_NUMFRAMES; i++) {
3980 ov->frame[i].data = ov->fbuf + i * MAX_DATA_SIZE(w, h);
3981 ov->frame[i].rawdata = ov->rawfbuf
3982 + i * MAX_RAW_DATA_SIZE(w, h);
3983 ov->frame[i].tempdata = ov->tempfbuf
3984 + i * MAX_RAW_DATA_SIZE(w, h);
3986 ov->frame[i].compbuf =
3987 (unsigned char *) __get_free_page(GFP_KERNEL);
3988 if (!ov->frame[i].compbuf)
3989 goto error;
3991 PDEBUG(4, "frame[%d] @ %p", i, ov->frame[i].data);
3994 ov->buf_state = BUF_ALLOCATED;
3995 out:
3996 up(&ov->buf_lock);
3997 PDEBUG(4, "leaving");
3998 return 0;
3999 error:
4000 ov51x_do_dealloc(ov);
4001 up(&ov->buf_lock);
4002 PDEBUG(4, "errored");
4003 return -ENOMEM;
4006 static void
4007 ov51x_dealloc(struct usb_ov511 *ov)
4009 PDEBUG(4, "entered");
4010 down(&ov->buf_lock);
4011 ov51x_do_dealloc(ov);
4012 up(&ov->buf_lock);
4013 PDEBUG(4, "leaving");
4016 /****************************************************************************
4018 * V4L 1 API
4020 ***************************************************************************/
4022 static int
4023 ov51x_v4l1_open(struct inode *inode, struct file *file)
4025 struct video_device *vdev = video_devdata(file);
4026 struct usb_ov511 *ov = video_get_drvdata(vdev);
4027 int err, i;
4029 PDEBUG(4, "opening");
4031 down(&ov->lock);
4033 err = -EBUSY;
4034 if (ov->user)
4035 goto out;
4037 ov->sub_flag = 0;
4039 /* In case app doesn't set them... */
4040 err = ov51x_set_default_params(ov);
4041 if (err < 0)
4042 goto out;
4044 /* Make sure frames are reset */
4045 for (i = 0; i < OV511_NUMFRAMES; i++) {
4046 ov->frame[i].grabstate = FRAME_UNUSED;
4047 ov->frame[i].bytes_read = 0;
4050 /* If compression is on, make sure now that a
4051 * decompressor can be loaded */
4052 if (ov->compress && !ov->decomp_ops) {
4053 err = request_decompressor(ov);
4054 if (err && !dumppix)
4055 goto out;
4058 err = ov51x_alloc(ov);
4059 if (err < 0)
4060 goto out;
4062 err = ov51x_init_isoc(ov);
4063 if (err) {
4064 ov51x_dealloc(ov);
4065 goto out;
4068 ov->user++;
4069 file->private_data = vdev;
4071 if (ov->led_policy == LED_AUTO)
4072 ov51x_led_control(ov, 1);
4074 out:
4075 up(&ov->lock);
4076 return err;
4079 static int
4080 ov51x_v4l1_close(struct inode *inode, struct file *file)
4082 struct video_device *vdev = file->private_data;
4083 struct usb_ov511 *ov = video_get_drvdata(vdev);
4085 PDEBUG(4, "ov511_close");
4087 down(&ov->lock);
4089 ov->user--;
4090 ov51x_stop_isoc(ov);
4092 release_decompressor(ov);
4094 if (ov->led_policy == LED_AUTO)
4095 ov51x_led_control(ov, 0);
4097 if (ov->dev)
4098 ov51x_dealloc(ov);
4100 up(&ov->lock);
4102 /* Device unplugged while open. Only a minimum of unregistration is done
4103 * here; the disconnect callback already did the rest. */
4104 if (!ov->dev) {
4105 down(&ov->cbuf_lock);
4106 kfree(ov->cbuf);
4107 ov->cbuf = NULL;
4108 up(&ov->cbuf_lock);
4110 ov51x_dealloc(ov);
4111 kfree(ov);
4112 ov = NULL;
4115 file->private_data = NULL;
4116 return 0;
4119 /* Do not call this function directly! */
4120 static int
4121 ov51x_v4l1_ioctl_internal(struct inode *inode, struct file *file,
4122 unsigned int cmd, void *arg)
4124 struct video_device *vdev = file->private_data;
4125 struct usb_ov511 *ov = video_get_drvdata(vdev);
4126 PDEBUG(5, "IOCtl: 0x%X", cmd);
4128 if (!ov->dev)
4129 return -EIO;
4131 switch (cmd) {
4132 case VIDIOCGCAP:
4134 struct video_capability *b = arg;
4136 PDEBUG(4, "VIDIOCGCAP");
4138 memset(b, 0, sizeof(struct video_capability));
4139 sprintf(b->name, "%s USB Camera",
4140 symbolic(brglist, ov->bridge));
4141 b->type = VID_TYPE_CAPTURE | VID_TYPE_SUBCAPTURE;
4142 b->channels = ov->num_inputs;
4143 b->audios = 0;
4144 b->maxwidth = ov->maxwidth;
4145 b->maxheight = ov->maxheight;
4146 b->minwidth = ov->minwidth;
4147 b->minheight = ov->minheight;
4149 return 0;
4151 case VIDIOCGCHAN:
4153 struct video_channel *v = arg;
4155 PDEBUG(4, "VIDIOCGCHAN");
4157 if ((unsigned)(v->channel) >= ov->num_inputs) {
4158 err("Invalid channel (%d)", v->channel);
4159 return -EINVAL;
4162 v->norm = ov->norm;
4163 v->type = VIDEO_TYPE_CAMERA;
4164 v->flags = 0;
4165 // v->flags |= (ov->has_decoder) ? VIDEO_VC_NORM : 0;
4166 v->tuners = 0;
4167 decoder_get_input_name(ov, v->channel, v->name);
4169 return 0;
4171 case VIDIOCSCHAN:
4173 struct video_channel *v = arg;
4174 int err;
4176 PDEBUG(4, "VIDIOCSCHAN");
4178 /* Make sure it's not a camera */
4179 if (!ov->has_decoder) {
4180 if (v->channel == 0)
4181 return 0;
4182 else
4183 return -EINVAL;
4186 if (v->norm != VIDEO_MODE_PAL &&
4187 v->norm != VIDEO_MODE_NTSC &&
4188 v->norm != VIDEO_MODE_SECAM &&
4189 v->norm != VIDEO_MODE_AUTO) {
4190 err("Invalid norm (%d)", v->norm);
4191 return -EINVAL;
4194 if ((unsigned)(v->channel) >= ov->num_inputs) {
4195 err("Invalid channel (%d)", v->channel);
4196 return -EINVAL;
4199 err = decoder_set_input(ov, v->channel);
4200 if (err)
4201 return err;
4203 err = decoder_set_norm(ov, v->norm);
4204 if (err)
4205 return err;
4207 return 0;
4209 case VIDIOCGPICT:
4211 struct video_picture *p = arg;
4213 PDEBUG(4, "VIDIOCGPICT");
4215 memset(p, 0, sizeof(struct video_picture));
4216 if (sensor_get_picture(ov, p))
4217 return -EIO;
4219 /* Can we get these from frame[0]? -claudio? */
4220 p->depth = ov->frame[0].depth;
4221 p->palette = ov->frame[0].format;
4223 return 0;
4225 case VIDIOCSPICT:
4227 struct video_picture *p = arg;
4228 int i, rc;
4230 PDEBUG(4, "VIDIOCSPICT");
4232 if (!get_depth(p->palette))
4233 return -EINVAL;
4235 if (sensor_set_picture(ov, p))
4236 return -EIO;
4238 if (force_palette && p->palette != force_palette) {
4239 info("Palette rejected (%s)",
4240 symbolic(v4l1_plist, p->palette));
4241 return -EINVAL;
4244 // FIXME: Format should be independent of frames
4245 if (p->palette != ov->frame[0].format) {
4246 PDEBUG(4, "Detected format change");
4248 rc = ov51x_wait_frames_inactive(ov);
4249 if (rc)
4250 return rc;
4252 mode_init_regs(ov, ov->frame[0].width,
4253 ov->frame[0].height, p->palette, ov->sub_flag);
4256 PDEBUG(4, "Setting depth=%d, palette=%s",
4257 p->depth, symbolic(v4l1_plist, p->palette));
4259 for (i = 0; i < OV511_NUMFRAMES; i++) {
4260 ov->frame[i].depth = p->depth;
4261 ov->frame[i].format = p->palette;
4264 return 0;
4266 case VIDIOCGCAPTURE:
4268 int *vf = arg;
4270 PDEBUG(4, "VIDIOCGCAPTURE");
4272 ov->sub_flag = *vf;
4273 return 0;
4275 case VIDIOCSCAPTURE:
4277 struct video_capture *vc = arg;
4279 PDEBUG(4, "VIDIOCSCAPTURE");
4281 if (vc->flags)
4282 return -EINVAL;
4283 if (vc->decimation)
4284 return -EINVAL;
4286 vc->x &= ~3L;
4287 vc->y &= ~1L;
4288 vc->y &= ~31L;
4290 if (vc->width == 0)
4291 vc->width = 32;
4293 vc->height /= 16;
4294 vc->height *= 16;
4295 if (vc->height == 0)
4296 vc->height = 16;
4298 ov->subx = vc->x;
4299 ov->suby = vc->y;
4300 ov->subw = vc->width;
4301 ov->subh = vc->height;
4303 return 0;
4305 case VIDIOCSWIN:
4307 struct video_window *vw = arg;
4308 int i, rc;
4310 PDEBUG(4, "VIDIOCSWIN: %dx%d", vw->width, vw->height);
4312 #if 0
4313 if (vw->flags)
4314 return -EINVAL;
4315 if (vw->clipcount)
4316 return -EINVAL;
4317 if (vw->height != ov->maxheight)
4318 return -EINVAL;
4319 if (vw->width != ov->maxwidth)
4320 return -EINVAL;
4321 #endif
4323 rc = ov51x_wait_frames_inactive(ov);
4324 if (rc)
4325 return rc;
4327 rc = mode_init_regs(ov, vw->width, vw->height,
4328 ov->frame[0].format, ov->sub_flag);
4329 if (rc < 0)
4330 return rc;
4332 for (i = 0; i < OV511_NUMFRAMES; i++) {
4333 ov->frame[i].width = vw->width;
4334 ov->frame[i].height = vw->height;
4337 return 0;
4339 case VIDIOCGWIN:
4341 struct video_window *vw = arg;
4343 memset(vw, 0, sizeof(struct video_window));
4344 vw->x = 0; /* FIXME */
4345 vw->y = 0;
4346 vw->width = ov->frame[0].width;
4347 vw->height = ov->frame[0].height;
4348 vw->flags = 30;
4350 PDEBUG(4, "VIDIOCGWIN: %dx%d", vw->width, vw->height);
4352 return 0;
4354 case VIDIOCGMBUF:
4356 struct video_mbuf *vm = arg;
4357 int i;
4359 PDEBUG(4, "VIDIOCGMBUF");
4361 memset(vm, 0, sizeof(struct video_mbuf));
4362 vm->size = OV511_NUMFRAMES
4363 * MAX_DATA_SIZE(ov->maxwidth, ov->maxheight);
4364 vm->frames = OV511_NUMFRAMES;
4366 vm->offsets[0] = 0;
4367 for (i = 1; i < OV511_NUMFRAMES; i++) {
4368 vm->offsets[i] = vm->offsets[i-1]
4369 + MAX_DATA_SIZE(ov->maxwidth, ov->maxheight);
4372 return 0;
4374 case VIDIOCMCAPTURE:
4376 struct video_mmap *vm = arg;
4377 int rc, depth;
4378 unsigned int f = vm->frame;
4380 PDEBUG(4, "VIDIOCMCAPTURE: frame: %d, %dx%d, %s", f, vm->width,
4381 vm->height, symbolic(v4l1_plist, vm->format));
4383 depth = get_depth(vm->format);
4384 if (!depth) {
4385 PDEBUG(2, "VIDIOCMCAPTURE: invalid format (%s)",
4386 symbolic(v4l1_plist, vm->format));
4387 return -EINVAL;
4390 if (f >= OV511_NUMFRAMES) {
4391 err("VIDIOCMCAPTURE: invalid frame (%d)", f);
4392 return -EINVAL;
4395 if (vm->width > ov->maxwidth
4396 || vm->height > ov->maxheight) {
4397 err("VIDIOCMCAPTURE: requested dimensions too big");
4398 return -EINVAL;
4401 if (ov->frame[f].grabstate == FRAME_GRABBING) {
4402 PDEBUG(4, "VIDIOCMCAPTURE: already grabbing");
4403 return -EBUSY;
4406 if (force_palette && (vm->format != force_palette)) {
4407 PDEBUG(2, "palette rejected (%s)",
4408 symbolic(v4l1_plist, vm->format));
4409 return -EINVAL;
4412 if ((ov->frame[f].width != vm->width) ||
4413 (ov->frame[f].height != vm->height) ||
4414 (ov->frame[f].format != vm->format) ||
4415 (ov->frame[f].sub_flag != ov->sub_flag) ||
4416 (ov->frame[f].depth != depth)) {
4417 PDEBUG(4, "VIDIOCMCAPTURE: change in image parameters");
4419 rc = ov51x_wait_frames_inactive(ov);
4420 if (rc)
4421 return rc;
4423 rc = mode_init_regs(ov, vm->width, vm->height,
4424 vm->format, ov->sub_flag);
4425 #if 0
4426 if (rc < 0) {
4427 PDEBUG(1, "Got error while initializing regs ");
4428 return ret;
4430 #endif
4431 ov->frame[f].width = vm->width;
4432 ov->frame[f].height = vm->height;
4433 ov->frame[f].format = vm->format;
4434 ov->frame[f].sub_flag = ov->sub_flag;
4435 ov->frame[f].depth = depth;
4438 /* Mark it as ready */
4439 ov->frame[f].grabstate = FRAME_READY;
4441 PDEBUG(4, "VIDIOCMCAPTURE: renewing frame %d", f);
4443 return ov51x_new_frame(ov, f);
4445 case VIDIOCSYNC:
4447 unsigned int fnum = *((unsigned int *) arg);
4448 struct ov511_frame *frame;
4449 int rc;
4451 if (fnum >= OV511_NUMFRAMES) {
4452 err("VIDIOCSYNC: invalid frame (%d)", fnum);
4453 return -EINVAL;
4456 frame = &ov->frame[fnum];
4458 PDEBUG(4, "syncing to frame %d, grabstate = %d", fnum,
4459 frame->grabstate);
4461 switch (frame->grabstate) {
4462 case FRAME_UNUSED:
4463 return -EINVAL;
4464 case FRAME_READY:
4465 case FRAME_GRABBING:
4466 case FRAME_ERROR:
4467 redo:
4468 if (!ov->dev)
4469 return -EIO;
4471 rc = wait_event_interruptible(frame->wq,
4472 (frame->grabstate == FRAME_DONE)
4473 || (frame->grabstate == FRAME_ERROR));
4475 if (rc)
4476 return rc;
4478 if (frame->grabstate == FRAME_ERROR) {
4479 if ((rc = ov51x_new_frame(ov, fnum)) < 0)
4480 return rc;
4481 goto redo;
4483 /* Fall through */
4484 case FRAME_DONE:
4485 if (ov->snap_enabled && !frame->snapshot) {
4486 if ((rc = ov51x_new_frame(ov, fnum)) < 0)
4487 return rc;
4488 goto redo;
4491 frame->grabstate = FRAME_UNUSED;
4493 /* Reset the hardware snapshot button */
4494 /* FIXME - Is this the best place for this? */
4495 if ((ov->snap_enabled) && (frame->snapshot)) {
4496 frame->snapshot = 0;
4497 ov51x_clear_snapshot(ov);
4500 /* Decompression, format conversion, etc... */
4501 ov51x_postprocess(ov, frame);
4503 break;
4504 } /* end switch */
4506 return 0;
4508 case VIDIOCGFBUF:
4510 struct video_buffer *vb = arg;
4512 PDEBUG(4, "VIDIOCGFBUF");
4514 memset(vb, 0, sizeof(struct video_buffer));
4516 return 0;
4518 case VIDIOCGUNIT:
4520 struct video_unit *vu = arg;
4522 PDEBUG(4, "VIDIOCGUNIT");
4524 memset(vu, 0, sizeof(struct video_unit));
4526 vu->video = ov->vdev->minor;
4527 vu->vbi = VIDEO_NO_UNIT;
4528 vu->radio = VIDEO_NO_UNIT;
4529 vu->audio = VIDEO_NO_UNIT;
4530 vu->teletext = VIDEO_NO_UNIT;
4532 return 0;
4534 case OV511IOC_WI2C:
4536 struct ov511_i2c_struct *w = arg;
4538 return i2c_w_slave(ov, w->slave, w->reg, w->value, w->mask);
4540 case OV511IOC_RI2C:
4542 struct ov511_i2c_struct *r = arg;
4543 int rc;
4545 rc = i2c_r_slave(ov, r->slave, r->reg);
4546 if (rc < 0)
4547 return rc;
4549 r->value = rc;
4550 return 0;
4552 default:
4553 PDEBUG(3, "Unsupported IOCtl: 0x%X", cmd);
4554 return -ENOIOCTLCMD;
4555 } /* end switch */
4557 return 0;
4560 static int
4561 ov51x_v4l1_ioctl(struct inode *inode, struct file *file,
4562 unsigned int cmd, unsigned long arg)
4564 struct video_device *vdev = file->private_data;
4565 struct usb_ov511 *ov = video_get_drvdata(vdev);
4566 int rc;
4568 if (down_interruptible(&ov->lock))
4569 return -EINTR;
4571 rc = video_usercopy(inode, file, cmd, arg, ov51x_v4l1_ioctl_internal);
4573 up(&ov->lock);
4574 return rc;
4577 static ssize_t
4578 ov51x_v4l1_read(struct file *file, char __user *buf, size_t cnt, loff_t *ppos)
4580 struct video_device *vdev = file->private_data;
4581 int noblock = file->f_flags&O_NONBLOCK;
4582 unsigned long count = cnt;
4583 struct usb_ov511 *ov = video_get_drvdata(vdev);
4584 int i, rc = 0, frmx = -1;
4585 struct ov511_frame *frame;
4587 if (down_interruptible(&ov->lock))
4588 return -EINTR;
4590 PDEBUG(4, "%ld bytes, noblock=%d", count, noblock);
4592 if (!vdev || !buf) {
4593 rc = -EFAULT;
4594 goto error;
4597 if (!ov->dev) {
4598 rc = -EIO;
4599 goto error;
4602 // FIXME: Only supports two frames
4603 /* See if a frame is completed, then use it. */
4604 if (ov->frame[0].grabstate >= FRAME_DONE) /* _DONE or _ERROR */
4605 frmx = 0;
4606 else if (ov->frame[1].grabstate >= FRAME_DONE)/* _DONE or _ERROR */
4607 frmx = 1;
4609 /* If nonblocking we return immediately */
4610 if (noblock && (frmx == -1)) {
4611 rc = -EAGAIN;
4612 goto error;
4615 /* If no FRAME_DONE, look for a FRAME_GRABBING state. */
4616 /* See if a frame is in process (grabbing), then use it. */
4617 if (frmx == -1) {
4618 if (ov->frame[0].grabstate == FRAME_GRABBING)
4619 frmx = 0;
4620 else if (ov->frame[1].grabstate == FRAME_GRABBING)
4621 frmx = 1;
4624 /* If no frame is active, start one. */
4625 if (frmx == -1) {
4626 if ((rc = ov51x_new_frame(ov, frmx = 0))) {
4627 err("read: ov51x_new_frame error");
4628 goto error;
4632 frame = &ov->frame[frmx];
4634 restart:
4635 if (!ov->dev) {
4636 rc = -EIO;
4637 goto error;
4640 /* Wait while we're grabbing the image */
4641 PDEBUG(4, "Waiting image grabbing");
4642 rc = wait_event_interruptible(frame->wq,
4643 (frame->grabstate == FRAME_DONE)
4644 || (frame->grabstate == FRAME_ERROR));
4646 if (rc)
4647 goto error;
4649 PDEBUG(4, "Got image, frame->grabstate = %d", frame->grabstate);
4650 PDEBUG(4, "bytes_recvd = %d", frame->bytes_recvd);
4652 if (frame->grabstate == FRAME_ERROR) {
4653 frame->bytes_read = 0;
4654 err("** ick! ** Errored frame %d", ov->curframe);
4655 if (ov51x_new_frame(ov, frmx)) {
4656 err("read: ov51x_new_frame error");
4657 goto error;
4659 goto restart;
4663 /* Repeat until we get a snapshot frame */
4664 if (ov->snap_enabled)
4665 PDEBUG(4, "Waiting snapshot frame");
4666 if (ov->snap_enabled && !frame->snapshot) {
4667 frame->bytes_read = 0;
4668 if ((rc = ov51x_new_frame(ov, frmx))) {
4669 err("read: ov51x_new_frame error");
4670 goto error;
4672 goto restart;
4675 /* Clear the snapshot */
4676 if (ov->snap_enabled && frame->snapshot) {
4677 frame->snapshot = 0;
4678 ov51x_clear_snapshot(ov);
4681 /* Decompression, format conversion, etc... */
4682 ov51x_postprocess(ov, frame);
4684 PDEBUG(4, "frmx=%d, bytes_read=%ld, length=%ld", frmx,
4685 frame->bytes_read,
4686 get_frame_length(frame));
4688 /* copy bytes to user space; we allow for partials reads */
4689 // if ((count + frame->bytes_read)
4690 // > get_frame_length((struct ov511_frame *)frame))
4691 // count = frame->scanlength - frame->bytes_read;
4693 /* FIXME - count hardwired to be one frame... */
4694 count = get_frame_length(frame);
4696 PDEBUG(4, "Copy to user space: %ld bytes", count);
4697 if ((i = copy_to_user(buf, frame->data + frame->bytes_read, count))) {
4698 PDEBUG(4, "Copy failed! %d bytes not copied", i);
4699 rc = -EFAULT;
4700 goto error;
4703 frame->bytes_read += count;
4704 PDEBUG(4, "{copy} count used=%ld, new bytes_read=%ld",
4705 count, frame->bytes_read);
4707 /* If all data have been read... */
4708 if (frame->bytes_read
4709 >= get_frame_length(frame)) {
4710 frame->bytes_read = 0;
4712 // FIXME: Only supports two frames
4713 /* Mark it as available to be used again. */
4714 ov->frame[frmx].grabstate = FRAME_UNUSED;
4715 if ((rc = ov51x_new_frame(ov, !frmx))) {
4716 err("ov51x_new_frame returned error");
4717 goto error;
4721 PDEBUG(4, "read finished, returning %ld (sweet)", count);
4723 up(&ov->lock);
4724 return count;
4726 error:
4727 up(&ov->lock);
4728 return rc;
4731 static int
4732 ov51x_v4l1_mmap(struct file *file, struct vm_area_struct *vma)
4734 struct video_device *vdev = file->private_data;
4735 unsigned long start = vma->vm_start;
4736 unsigned long size = vma->vm_end - vma->vm_start;
4737 struct usb_ov511 *ov = video_get_drvdata(vdev);
4738 unsigned long page, pos;
4740 if (ov->dev == NULL)
4741 return -EIO;
4743 PDEBUG(4, "mmap: %ld (%lX) bytes", size, size);
4745 if (size > (((OV511_NUMFRAMES
4746 * MAX_DATA_SIZE(ov->maxwidth, ov->maxheight)
4747 + PAGE_SIZE - 1) & ~(PAGE_SIZE - 1))))
4748 return -EINVAL;
4750 if (down_interruptible(&ov->lock))
4751 return -EINTR;
4753 pos = (unsigned long)ov->fbuf;
4754 while (size > 0) {
4755 page = vmalloc_to_pfn((void *)pos);
4756 if (remap_pfn_range(vma, start, page, PAGE_SIZE, PAGE_SHARED)) {
4757 up(&ov->lock);
4758 return -EAGAIN;
4760 start += PAGE_SIZE;
4761 pos += PAGE_SIZE;
4762 if (size > PAGE_SIZE)
4763 size -= PAGE_SIZE;
4764 else
4765 size = 0;
4768 up(&ov->lock);
4769 return 0;
4772 static struct file_operations ov511_fops = {
4773 .owner = THIS_MODULE,
4774 .open = ov51x_v4l1_open,
4775 .release = ov51x_v4l1_close,
4776 .read = ov51x_v4l1_read,
4777 .mmap = ov51x_v4l1_mmap,
4778 .ioctl = ov51x_v4l1_ioctl,
4779 .llseek = no_llseek,
4782 static struct video_device vdev_template = {
4783 .owner = THIS_MODULE,
4784 .name = "OV511 USB Camera",
4785 .type = VID_TYPE_CAPTURE,
4786 .hardware = VID_HARDWARE_OV511,
4787 .fops = &ov511_fops,
4788 .release = video_device_release,
4789 .minor = -1,
4792 /****************************************************************************
4794 * OV511 and sensor configuration
4796 ***************************************************************************/
4798 /* This initializes the OV7610, OV7620, or OV76BE sensor. The OV76BE uses
4799 * the same register settings as the OV7610, since they are very similar.
4801 static int
4802 ov7xx0_configure(struct usb_ov511 *ov)
4804 int i, success;
4805 int rc;
4807 /* Lawrence Glaister <lg@jfm.bc.ca> reports:
4809 * Register 0x0f in the 7610 has the following effects:
4811 * 0x85 (AEC method 1): Best overall, good contrast range
4812 * 0x45 (AEC method 2): Very overexposed
4813 * 0xa5 (spec sheet default): Ok, but the black level is
4814 * shifted resulting in loss of contrast
4815 * 0x05 (old driver setting): very overexposed, too much
4816 * contrast
4818 static struct ov511_regvals aRegvalsNorm7610[] = {
4819 { OV511_I2C_BUS, 0x10, 0xff },
4820 { OV511_I2C_BUS, 0x16, 0x06 },
4821 { OV511_I2C_BUS, 0x28, 0x24 },
4822 { OV511_I2C_BUS, 0x2b, 0xac },
4823 { OV511_I2C_BUS, 0x12, 0x00 },
4824 { OV511_I2C_BUS, 0x38, 0x81 },
4825 { OV511_I2C_BUS, 0x28, 0x24 }, /* 0c */
4826 { OV511_I2C_BUS, 0x0f, 0x85 }, /* lg's setting */
4827 { OV511_I2C_BUS, 0x15, 0x01 },
4828 { OV511_I2C_BUS, 0x20, 0x1c },
4829 { OV511_I2C_BUS, 0x23, 0x2a },
4830 { OV511_I2C_BUS, 0x24, 0x10 },
4831 { OV511_I2C_BUS, 0x25, 0x8a },
4832 { OV511_I2C_BUS, 0x26, 0xa2 },
4833 { OV511_I2C_BUS, 0x27, 0xc2 },
4834 { OV511_I2C_BUS, 0x2a, 0x04 },
4835 { OV511_I2C_BUS, 0x2c, 0xfe },
4836 { OV511_I2C_BUS, 0x2d, 0x93 },
4837 { OV511_I2C_BUS, 0x30, 0x71 },
4838 { OV511_I2C_BUS, 0x31, 0x60 },
4839 { OV511_I2C_BUS, 0x32, 0x26 },
4840 { OV511_I2C_BUS, 0x33, 0x20 },
4841 { OV511_I2C_BUS, 0x34, 0x48 },
4842 { OV511_I2C_BUS, 0x12, 0x24 },
4843 { OV511_I2C_BUS, 0x11, 0x01 },
4844 { OV511_I2C_BUS, 0x0c, 0x24 },
4845 { OV511_I2C_BUS, 0x0d, 0x24 },
4846 { OV511_DONE_BUS, 0x0, 0x00 },
4849 static struct ov511_regvals aRegvalsNorm7620[] = {
4850 { OV511_I2C_BUS, 0x00, 0x00 },
4851 { OV511_I2C_BUS, 0x01, 0x80 },
4852 { OV511_I2C_BUS, 0x02, 0x80 },
4853 { OV511_I2C_BUS, 0x03, 0xc0 },
4854 { OV511_I2C_BUS, 0x06, 0x60 },
4855 { OV511_I2C_BUS, 0x07, 0x00 },
4856 { OV511_I2C_BUS, 0x0c, 0x24 },
4857 { OV511_I2C_BUS, 0x0c, 0x24 },
4858 { OV511_I2C_BUS, 0x0d, 0x24 },
4859 { OV511_I2C_BUS, 0x11, 0x01 },
4860 { OV511_I2C_BUS, 0x12, 0x24 },
4861 { OV511_I2C_BUS, 0x13, 0x01 },
4862 { OV511_I2C_BUS, 0x14, 0x84 },
4863 { OV511_I2C_BUS, 0x15, 0x01 },
4864 { OV511_I2C_BUS, 0x16, 0x03 },
4865 { OV511_I2C_BUS, 0x17, 0x2f },
4866 { OV511_I2C_BUS, 0x18, 0xcf },
4867 { OV511_I2C_BUS, 0x19, 0x06 },
4868 { OV511_I2C_BUS, 0x1a, 0xf5 },
4869 { OV511_I2C_BUS, 0x1b, 0x00 },
4870 { OV511_I2C_BUS, 0x20, 0x18 },
4871 { OV511_I2C_BUS, 0x21, 0x80 },
4872 { OV511_I2C_BUS, 0x22, 0x80 },
4873 { OV511_I2C_BUS, 0x23, 0x00 },
4874 { OV511_I2C_BUS, 0x26, 0xa2 },
4875 { OV511_I2C_BUS, 0x27, 0xea },
4876 { OV511_I2C_BUS, 0x28, 0x20 },
4877 { OV511_I2C_BUS, 0x29, 0x00 },
4878 { OV511_I2C_BUS, 0x2a, 0x10 },
4879 { OV511_I2C_BUS, 0x2b, 0x00 },
4880 { OV511_I2C_BUS, 0x2c, 0x88 },
4881 { OV511_I2C_BUS, 0x2d, 0x91 },
4882 { OV511_I2C_BUS, 0x2e, 0x80 },
4883 { OV511_I2C_BUS, 0x2f, 0x44 },
4884 { OV511_I2C_BUS, 0x60, 0x27 },
4885 { OV511_I2C_BUS, 0x61, 0x02 },
4886 { OV511_I2C_BUS, 0x62, 0x5f },
4887 { OV511_I2C_BUS, 0x63, 0xd5 },
4888 { OV511_I2C_BUS, 0x64, 0x57 },
4889 { OV511_I2C_BUS, 0x65, 0x83 },
4890 { OV511_I2C_BUS, 0x66, 0x55 },
4891 { OV511_I2C_BUS, 0x67, 0x92 },
4892 { OV511_I2C_BUS, 0x68, 0xcf },
4893 { OV511_I2C_BUS, 0x69, 0x76 },
4894 { OV511_I2C_BUS, 0x6a, 0x22 },
4895 { OV511_I2C_BUS, 0x6b, 0x00 },
4896 { OV511_I2C_BUS, 0x6c, 0x02 },
4897 { OV511_I2C_BUS, 0x6d, 0x44 },
4898 { OV511_I2C_BUS, 0x6e, 0x80 },
4899 { OV511_I2C_BUS, 0x6f, 0x1d },
4900 { OV511_I2C_BUS, 0x70, 0x8b },
4901 { OV511_I2C_BUS, 0x71, 0x00 },
4902 { OV511_I2C_BUS, 0x72, 0x14 },
4903 { OV511_I2C_BUS, 0x73, 0x54 },
4904 { OV511_I2C_BUS, 0x74, 0x00 },
4905 { OV511_I2C_BUS, 0x75, 0x8e },
4906 { OV511_I2C_BUS, 0x76, 0x00 },
4907 { OV511_I2C_BUS, 0x77, 0xff },
4908 { OV511_I2C_BUS, 0x78, 0x80 },
4909 { OV511_I2C_BUS, 0x79, 0x80 },
4910 { OV511_I2C_BUS, 0x7a, 0x80 },
4911 { OV511_I2C_BUS, 0x7b, 0xe2 },
4912 { OV511_I2C_BUS, 0x7c, 0x00 },
4913 { OV511_DONE_BUS, 0x0, 0x00 },
4916 PDEBUG(4, "starting configuration");
4918 /* This looks redundant, but is necessary for WebCam 3 */
4919 ov->primary_i2c_slave = OV7xx0_SID;
4920 if (ov51x_set_slave_ids(ov, OV7xx0_SID) < 0)
4921 return -1;
4923 if (init_ov_sensor(ov) >= 0) {
4924 PDEBUG(1, "OV7xx0 sensor initalized (method 1)");
4925 } else {
4926 /* Reset the 76xx */
4927 if (i2c_w(ov, 0x12, 0x80) < 0)
4928 return -1;
4930 /* Wait for it to initialize */
4931 msleep(150);
4933 i = 0;
4934 success = 0;
4935 while (i <= i2c_detect_tries) {
4936 if ((i2c_r(ov, OV7610_REG_ID_HIGH) == 0x7F) &&
4937 (i2c_r(ov, OV7610_REG_ID_LOW) == 0xA2)) {
4938 success = 1;
4939 break;
4940 } else {
4941 i++;
4945 // Was (i == i2c_detect_tries) previously. This obviously used to always report
4946 // success. Whether anyone actually depended on that bug is unknown
4947 if ((i >= i2c_detect_tries) && (success == 0)) {
4948 err("Failed to read sensor ID. You might not have an");
4949 err("OV7610/20, or it may be not responding. Report");
4950 err("this to " EMAIL);
4951 err("This is only a warning. You can attempt to use");
4952 err("your camera anyway");
4953 // Only issue a warning for now
4954 // return -1;
4955 } else {
4956 PDEBUG(1, "OV7xx0 initialized (method 2, %dx)", i+1);
4960 /* Detect sensor (sub)type */
4961 rc = i2c_r(ov, OV7610_REG_COM_I);
4963 if (rc < 0) {
4964 err("Error detecting sensor type");
4965 return -1;
4966 } else if ((rc & 3) == 3) {
4967 info("Sensor is an OV7610");
4968 ov->sensor = SEN_OV7610;
4969 } else if ((rc & 3) == 1) {
4970 /* I don't know what's different about the 76BE yet. */
4971 if (i2c_r(ov, 0x15) & 1)
4972 info("Sensor is an OV7620AE");
4973 else
4974 info("Sensor is an OV76BE");
4976 /* OV511+ will return all zero isoc data unless we
4977 * configure the sensor as a 7620. Someone needs to
4978 * find the exact reg. setting that causes this. */
4979 if (ov->bridge == BRG_OV511PLUS) {
4980 info("Enabling 511+/7620AE workaround");
4981 ov->sensor = SEN_OV7620;
4982 } else {
4983 ov->sensor = SEN_OV76BE;
4985 } else if ((rc & 3) == 0) {
4986 info("Sensor is an OV7620");
4987 ov->sensor = SEN_OV7620;
4988 } else {
4989 err("Unknown image sensor version: %d", rc & 3);
4990 return -1;
4993 if (ov->sensor == SEN_OV7620) {
4994 PDEBUG(4, "Writing 7620 registers");
4995 if (write_regvals(ov, aRegvalsNorm7620))
4996 return -1;
4997 } else {
4998 PDEBUG(4, "Writing 7610 registers");
4999 if (write_regvals(ov, aRegvalsNorm7610))
5000 return -1;
5003 /* Set sensor-specific vars */
5004 ov->maxwidth = 640;
5005 ov->maxheight = 480;
5006 ov->minwidth = 64;
5007 ov->minheight = 48;
5009 // FIXME: These do not match the actual settings yet
5010 ov->brightness = 0x80 << 8;
5011 ov->contrast = 0x80 << 8;
5012 ov->colour = 0x80 << 8;
5013 ov->hue = 0x80 << 8;
5015 return 0;
5018 /* This initializes the OV6620, OV6630, OV6630AE, or OV6630AF sensor. */
5019 static int
5020 ov6xx0_configure(struct usb_ov511 *ov)
5022 int rc;
5024 static struct ov511_regvals aRegvalsNorm6x20[] = {
5025 { OV511_I2C_BUS, 0x12, 0x80 }, /* reset */
5026 { OV511_I2C_BUS, 0x11, 0x01 },
5027 { OV511_I2C_BUS, 0x03, 0x60 },
5028 { OV511_I2C_BUS, 0x05, 0x7f }, /* For when autoadjust is off */
5029 { OV511_I2C_BUS, 0x07, 0xa8 },
5030 /* The ratio of 0x0c and 0x0d controls the white point */
5031 { OV511_I2C_BUS, 0x0c, 0x24 },
5032 { OV511_I2C_BUS, 0x0d, 0x24 },
5033 { OV511_I2C_BUS, 0x0f, 0x15 }, /* COMS */
5034 { OV511_I2C_BUS, 0x10, 0x75 }, /* AEC Exposure time */
5035 { OV511_I2C_BUS, 0x12, 0x24 }, /* Enable AGC */
5036 { OV511_I2C_BUS, 0x14, 0x04 },
5037 /* 0x16: 0x06 helps frame stability with moving objects */
5038 { OV511_I2C_BUS, 0x16, 0x06 },
5039 // { OV511_I2C_BUS, 0x20, 0x30 }, /* Aperture correction enable */
5040 { OV511_I2C_BUS, 0x26, 0xb2 }, /* BLC enable */
5041 /* 0x28: 0x05 Selects RGB format if RGB on */
5042 { OV511_I2C_BUS, 0x28, 0x05 },
5043 { OV511_I2C_BUS, 0x2a, 0x04 }, /* Disable framerate adjust */
5044 // { OV511_I2C_BUS, 0x2b, 0xac }, /* Framerate; Set 2a[7] first */
5045 { OV511_I2C_BUS, 0x2d, 0x99 },
5046 { OV511_I2C_BUS, 0x33, 0xa0 }, /* Color Procesing Parameter */
5047 { OV511_I2C_BUS, 0x34, 0xd2 }, /* Max A/D range */
5048 { OV511_I2C_BUS, 0x38, 0x8b },
5049 { OV511_I2C_BUS, 0x39, 0x40 },
5051 { OV511_I2C_BUS, 0x3c, 0x39 }, /* Enable AEC mode changing */
5052 { OV511_I2C_BUS, 0x3c, 0x3c }, /* Change AEC mode */
5053 { OV511_I2C_BUS, 0x3c, 0x24 }, /* Disable AEC mode changing */
5055 { OV511_I2C_BUS, 0x3d, 0x80 },
5056 /* These next two registers (0x4a, 0x4b) are undocumented. They
5057 * control the color balance */
5058 { OV511_I2C_BUS, 0x4a, 0x80 },
5059 { OV511_I2C_BUS, 0x4b, 0x80 },
5060 { OV511_I2C_BUS, 0x4d, 0xd2 }, /* This reduces noise a bit */
5061 { OV511_I2C_BUS, 0x4e, 0xc1 },
5062 { OV511_I2C_BUS, 0x4f, 0x04 },
5063 // Do 50-53 have any effect?
5064 // Toggle 0x12[2] off and on here?
5065 { OV511_DONE_BUS, 0x0, 0x00 }, /* END MARKER */
5068 static struct ov511_regvals aRegvalsNorm6x30[] = {
5069 /*OK*/ { OV511_I2C_BUS, 0x12, 0x80 }, /* reset */
5070 { OV511_I2C_BUS, 0x11, 0x00 },
5071 /*OK*/ { OV511_I2C_BUS, 0x03, 0x60 },
5072 /*0A?*/ { OV511_I2C_BUS, 0x05, 0x7f }, /* For when autoadjust is off */
5073 { OV511_I2C_BUS, 0x07, 0xa8 },
5074 /* The ratio of 0x0c and 0x0d controls the white point */
5075 /*OK*/ { OV511_I2C_BUS, 0x0c, 0x24 },
5076 /*OK*/ { OV511_I2C_BUS, 0x0d, 0x24 },
5077 /*A*/ { OV511_I2C_BUS, 0x0e, 0x20 },
5078 // /*04?*/ { OV511_I2C_BUS, 0x14, 0x80 },
5079 { OV511_I2C_BUS, 0x16, 0x03 },
5080 // /*OK*/ { OV511_I2C_BUS, 0x20, 0x30 }, /* Aperture correction enable */
5081 // 21 & 22? The suggested values look wrong. Go with default
5082 /*A*/ { OV511_I2C_BUS, 0x23, 0xc0 },
5083 /*A*/ { OV511_I2C_BUS, 0x25, 0x9a }, // Check this against default
5084 // /*OK*/ { OV511_I2C_BUS, 0x26, 0xb2 }, /* BLC enable */
5086 /* 0x28: 0x05 Selects RGB format if RGB on */
5087 // /*04?*/ { OV511_I2C_BUS, 0x28, 0x05 },
5088 // /*04?*/ { OV511_I2C_BUS, 0x28, 0x45 }, // DEBUG: Tristate UV bus
5090 /*OK*/ { OV511_I2C_BUS, 0x2a, 0x04 }, /* Disable framerate adjust */
5091 // /*OK*/ { OV511_I2C_BUS, 0x2b, 0xac }, /* Framerate; Set 2a[7] first */
5092 { OV511_I2C_BUS, 0x2d, 0x99 },
5093 // /*A*/ { OV511_I2C_BUS, 0x33, 0x26 }, // Reserved bits on 6620
5094 // /*d2?*/ { OV511_I2C_BUS, 0x34, 0x03 }, /* Max A/D range */
5095 // /*8b?*/ { OV511_I2C_BUS, 0x38, 0x83 },
5096 // /*40?*/ { OV511_I2C_BUS, 0x39, 0xc0 }, // 6630 adds bit 7
5097 // { OV511_I2C_BUS, 0x3c, 0x39 }, /* Enable AEC mode changing */
5098 // { OV511_I2C_BUS, 0x3c, 0x3c }, /* Change AEC mode */
5099 // { OV511_I2C_BUS, 0x3c, 0x24 }, /* Disable AEC mode changing */
5100 { OV511_I2C_BUS, 0x3d, 0x80 },
5101 // /*A*/ { OV511_I2C_BUS, 0x3f, 0x0e },
5103 /* These next two registers (0x4a, 0x4b) are undocumented. They
5104 * control the color balance */
5105 // /*OK?*/ { OV511_I2C_BUS, 0x4a, 0x80 }, // Check these
5106 // /*OK?*/ { OV511_I2C_BUS, 0x4b, 0x80 },
5107 { OV511_I2C_BUS, 0x4d, 0x10 }, /* U = 0.563u, V = 0.714v */
5108 /*c1?*/ { OV511_I2C_BUS, 0x4e, 0x40 },
5110 /* UV average mode, color killer: strongest */
5111 { OV511_I2C_BUS, 0x4f, 0x07 },
5113 { OV511_I2C_BUS, 0x54, 0x23 }, /* Max AGC gain: 18dB */
5114 { OV511_I2C_BUS, 0x57, 0x81 }, /* (default) */
5115 { OV511_I2C_BUS, 0x59, 0x01 }, /* AGC dark current comp: +1 */
5116 { OV511_I2C_BUS, 0x5a, 0x2c }, /* (undocumented) */
5117 { OV511_I2C_BUS, 0x5b, 0x0f }, /* AWB chrominance levels */
5118 // { OV511_I2C_BUS, 0x5c, 0x10 },
5119 { OV511_DONE_BUS, 0x0, 0x00 }, /* END MARKER */
5122 PDEBUG(4, "starting sensor configuration");
5124 if (init_ov_sensor(ov) < 0) {
5125 err("Failed to read sensor ID. You might not have an OV6xx0,");
5126 err("or it may be not responding. Report this to " EMAIL);
5127 return -1;
5128 } else {
5129 PDEBUG(1, "OV6xx0 sensor detected");
5132 /* Detect sensor (sub)type */
5133 rc = i2c_r(ov, OV7610_REG_COM_I);
5135 if (rc < 0) {
5136 err("Error detecting sensor type");
5137 return -1;
5140 if ((rc & 3) == 0) {
5141 ov->sensor = SEN_OV6630;
5142 info("Sensor is an OV6630");
5143 } else if ((rc & 3) == 1) {
5144 ov->sensor = SEN_OV6620;
5145 info("Sensor is an OV6620");
5146 } else if ((rc & 3) == 2) {
5147 ov->sensor = SEN_OV6630;
5148 info("Sensor is an OV6630AE");
5149 } else if ((rc & 3) == 3) {
5150 ov->sensor = SEN_OV6630;
5151 info("Sensor is an OV6630AF");
5154 /* Set sensor-specific vars */
5155 ov->maxwidth = 352;
5156 ov->maxheight = 288;
5157 ov->minwidth = 64;
5158 ov->minheight = 48;
5160 // FIXME: These do not match the actual settings yet
5161 ov->brightness = 0x80 << 8;
5162 ov->contrast = 0x80 << 8;
5163 ov->colour = 0x80 << 8;
5164 ov->hue = 0x80 << 8;
5166 if (ov->sensor == SEN_OV6620) {
5167 PDEBUG(4, "Writing 6x20 registers");
5168 if (write_regvals(ov, aRegvalsNorm6x20))
5169 return -1;
5170 } else {
5171 PDEBUG(4, "Writing 6x30 registers");
5172 if (write_regvals(ov, aRegvalsNorm6x30))
5173 return -1;
5176 return 0;
5179 /* This initializes the KS0127 and KS0127B video decoders. */
5180 static int
5181 ks0127_configure(struct usb_ov511 *ov)
5183 int rc;
5185 // FIXME: I don't know how to sync or reset it yet
5186 #if 0
5187 if (ov51x_init_ks_sensor(ov) < 0) {
5188 err("Failed to initialize the KS0127");
5189 return -1;
5190 } else {
5191 PDEBUG(1, "KS012x(B) sensor detected");
5193 #endif
5195 /* Detect decoder subtype */
5196 rc = i2c_r(ov, 0x00);
5197 if (rc < 0) {
5198 err("Error detecting sensor type");
5199 return -1;
5200 } else if (rc & 0x08) {
5201 rc = i2c_r(ov, 0x3d);
5202 if (rc < 0) {
5203 err("Error detecting sensor type");
5204 return -1;
5205 } else if ((rc & 0x0f) == 0) {
5206 info("Sensor is a KS0127");
5207 ov->sensor = SEN_KS0127;
5208 } else if ((rc & 0x0f) == 9) {
5209 info("Sensor is a KS0127B Rev. A");
5210 ov->sensor = SEN_KS0127B;
5212 } else {
5213 err("Error: Sensor is an unsupported KS0122");
5214 return -1;
5217 /* Set sensor-specific vars */
5218 ov->maxwidth = 640;
5219 ov->maxheight = 480;
5220 ov->minwidth = 64;
5221 ov->minheight = 48;
5223 // FIXME: These do not match the actual settings yet
5224 ov->brightness = 0x80 << 8;
5225 ov->contrast = 0x80 << 8;
5226 ov->colour = 0x80 << 8;
5227 ov->hue = 0x80 << 8;
5229 /* This device is not supported yet. Bail out now... */
5230 err("This sensor is not supported yet.");
5231 return -1;
5233 return 0;
5236 /* This initializes the SAA7111A video decoder. */
5237 static int
5238 saa7111a_configure(struct usb_ov511 *ov)
5240 int rc;
5242 /* Since there is no register reset command, all registers must be
5243 * written, otherwise gives erratic results */
5244 static struct ov511_regvals aRegvalsNormSAA7111A[] = {
5245 { OV511_I2C_BUS, 0x06, 0xce },
5246 { OV511_I2C_BUS, 0x07, 0x00 },
5247 { OV511_I2C_BUS, 0x10, 0x44 }, /* YUV422, 240/286 lines */
5248 { OV511_I2C_BUS, 0x0e, 0x01 }, /* NTSC M or PAL BGHI */
5249 { OV511_I2C_BUS, 0x00, 0x00 },
5250 { OV511_I2C_BUS, 0x01, 0x00 },
5251 { OV511_I2C_BUS, 0x03, 0x23 },
5252 { OV511_I2C_BUS, 0x04, 0x00 },
5253 { OV511_I2C_BUS, 0x05, 0x00 },
5254 { OV511_I2C_BUS, 0x08, 0xc8 }, /* Auto field freq */
5255 { OV511_I2C_BUS, 0x09, 0x01 }, /* Chrom. trap off, APER=0.25 */
5256 { OV511_I2C_BUS, 0x0a, 0x80 }, /* BRIG=128 */
5257 { OV511_I2C_BUS, 0x0b, 0x40 }, /* CONT=1.0 */
5258 { OV511_I2C_BUS, 0x0c, 0x40 }, /* SATN=1.0 */
5259 { OV511_I2C_BUS, 0x0d, 0x00 }, /* HUE=0 */
5260 { OV511_I2C_BUS, 0x0f, 0x00 },
5261 { OV511_I2C_BUS, 0x11, 0x0c },
5262 { OV511_I2C_BUS, 0x12, 0x00 },
5263 { OV511_I2C_BUS, 0x13, 0x00 },
5264 { OV511_I2C_BUS, 0x14, 0x00 },
5265 { OV511_I2C_BUS, 0x15, 0x00 },
5266 { OV511_I2C_BUS, 0x16, 0x00 },
5267 { OV511_I2C_BUS, 0x17, 0x00 },
5268 { OV511_I2C_BUS, 0x02, 0xc0 }, /* Composite input 0 */
5269 { OV511_DONE_BUS, 0x0, 0x00 },
5272 // FIXME: I don't know how to sync or reset it yet
5273 #if 0
5274 if (ov51x_init_saa_sensor(ov) < 0) {
5275 err("Failed to initialize the SAA7111A");
5276 return -1;
5277 } else {
5278 PDEBUG(1, "SAA7111A sensor detected");
5280 #endif
5282 /* 640x480 not supported with PAL */
5283 if (ov->pal) {
5284 ov->maxwidth = 320;
5285 ov->maxheight = 240; /* Even field only */
5286 } else {
5287 ov->maxwidth = 640;
5288 ov->maxheight = 480; /* Even/Odd fields */
5291 ov->minwidth = 320;
5292 ov->minheight = 240; /* Even field only */
5294 ov->has_decoder = 1;
5295 ov->num_inputs = 8;
5296 ov->norm = VIDEO_MODE_AUTO;
5297 ov->stop_during_set = 0; /* Decoder guarantees stable image */
5299 /* Decoder doesn't change these values, so we use these instead of
5300 * acutally reading the registers (which doesn't work) */
5301 ov->brightness = 0x80 << 8;
5302 ov->contrast = 0x40 << 9;
5303 ov->colour = 0x40 << 9;
5304 ov->hue = 32768;
5306 PDEBUG(4, "Writing SAA7111A registers");
5307 if (write_regvals(ov, aRegvalsNormSAA7111A))
5308 return -1;
5310 /* Detect version of decoder. This must be done after writing the
5311 * initial regs or the decoder will lock up. */
5312 rc = i2c_r(ov, 0x00);
5314 if (rc < 0) {
5315 err("Error detecting sensor version");
5316 return -1;
5317 } else {
5318 info("Sensor is an SAA7111A (version 0x%x)", rc);
5319 ov->sensor = SEN_SAA7111A;
5322 // FIXME: Fix this for OV518(+)
5323 /* Latch to negative edge of clock. Otherwise, we get incorrect
5324 * colors and jitter in the digital signal. */
5325 if (ov->bclass == BCL_OV511)
5326 reg_w(ov, 0x11, 0x00);
5327 else
5328 warn("SAA7111A not yet supported with OV518/OV518+");
5330 return 0;
5333 /* This initializes the OV511/OV511+ and the sensor */
5334 static int
5335 ov511_configure(struct usb_ov511 *ov)
5337 static struct ov511_regvals aRegvalsInit511[] = {
5338 { OV511_REG_BUS, R51x_SYS_RESET, 0x7f },
5339 { OV511_REG_BUS, R51x_SYS_INIT, 0x01 },
5340 { OV511_REG_BUS, R51x_SYS_RESET, 0x7f },
5341 { OV511_REG_BUS, R51x_SYS_INIT, 0x01 },
5342 { OV511_REG_BUS, R51x_SYS_RESET, 0x3f },
5343 { OV511_REG_BUS, R51x_SYS_INIT, 0x01 },
5344 { OV511_REG_BUS, R51x_SYS_RESET, 0x3d },
5345 { OV511_DONE_BUS, 0x0, 0x00},
5348 static struct ov511_regvals aRegvalsNorm511[] = {
5349 { OV511_REG_BUS, R511_DRAM_FLOW_CTL, 0x01 },
5350 { OV511_REG_BUS, R51x_SYS_SNAP, 0x00 },
5351 { OV511_REG_BUS, R51x_SYS_SNAP, 0x02 },
5352 { OV511_REG_BUS, R51x_SYS_SNAP, 0x00 },
5353 { OV511_REG_BUS, R511_FIFO_OPTS, 0x1f },
5354 { OV511_REG_BUS, R511_COMP_EN, 0x00 },
5355 { OV511_REG_BUS, R511_COMP_LUT_EN, 0x03 },
5356 { OV511_DONE_BUS, 0x0, 0x00 },
5359 static struct ov511_regvals aRegvalsNorm511Plus[] = {
5360 { OV511_REG_BUS, R511_DRAM_FLOW_CTL, 0xff },
5361 { OV511_REG_BUS, R51x_SYS_SNAP, 0x00 },
5362 { OV511_REG_BUS, R51x_SYS_SNAP, 0x02 },
5363 { OV511_REG_BUS, R51x_SYS_SNAP, 0x00 },
5364 { OV511_REG_BUS, R511_FIFO_OPTS, 0xff },
5365 { OV511_REG_BUS, R511_COMP_EN, 0x00 },
5366 { OV511_REG_BUS, R511_COMP_LUT_EN, 0x03 },
5367 { OV511_DONE_BUS, 0x0, 0x00 },
5370 PDEBUG(4, "");
5372 ov->customid = reg_r(ov, R511_SYS_CUST_ID);
5373 if (ov->customid < 0) {
5374 err("Unable to read camera bridge registers");
5375 goto error;
5378 PDEBUG (1, "CustomID = %d", ov->customid);
5379 ov->desc = symbolic(camlist, ov->customid);
5380 info("model: %s", ov->desc);
5382 if (0 == strcmp(ov->desc, NOT_DEFINED_STR)) {
5383 err("Camera type (%d) not recognized", ov->customid);
5384 err("Please notify " EMAIL " of the name,");
5385 err("manufacturer, model, and this number of your camera.");
5386 err("Also include the output of the detection process.");
5389 if (ov->customid == 70) /* USB Life TV (PAL/SECAM) */
5390 ov->pal = 1;
5392 if (write_regvals(ov, aRegvalsInit511))
5393 goto error;
5395 if (ov->led_policy == LED_OFF || ov->led_policy == LED_AUTO)
5396 ov51x_led_control(ov, 0);
5398 /* The OV511+ has undocumented bits in the flow control register.
5399 * Setting it to 0xff fixes the corruption with moving objects. */
5400 if (ov->bridge == BRG_OV511) {
5401 if (write_regvals(ov, aRegvalsNorm511))
5402 goto error;
5403 } else if (ov->bridge == BRG_OV511PLUS) {
5404 if (write_regvals(ov, aRegvalsNorm511Plus))
5405 goto error;
5406 } else {
5407 err("Invalid bridge");
5410 if (ov511_init_compression(ov))
5411 goto error;
5413 ov->packet_numbering = 1;
5414 ov511_set_packet_size(ov, 0);
5416 ov->snap_enabled = snapshot;
5418 /* Test for 7xx0 */
5419 PDEBUG(3, "Testing for 0V7xx0");
5420 ov->primary_i2c_slave = OV7xx0_SID;
5421 if (ov51x_set_slave_ids(ov, OV7xx0_SID) < 0)
5422 goto error;
5424 if (i2c_w(ov, 0x12, 0x80) < 0) {
5425 /* Test for 6xx0 */
5426 PDEBUG(3, "Testing for 0V6xx0");
5427 ov->primary_i2c_slave = OV6xx0_SID;
5428 if (ov51x_set_slave_ids(ov, OV6xx0_SID) < 0)
5429 goto error;
5431 if (i2c_w(ov, 0x12, 0x80) < 0) {
5432 /* Test for 8xx0 */
5433 PDEBUG(3, "Testing for 0V8xx0");
5434 ov->primary_i2c_slave = OV8xx0_SID;
5435 if (ov51x_set_slave_ids(ov, OV8xx0_SID) < 0)
5436 goto error;
5438 if (i2c_w(ov, 0x12, 0x80) < 0) {
5439 /* Test for SAA7111A */
5440 PDEBUG(3, "Testing for SAA7111A");
5441 ov->primary_i2c_slave = SAA7111A_SID;
5442 if (ov51x_set_slave_ids(ov, SAA7111A_SID) < 0)
5443 goto error;
5445 if (i2c_w(ov, 0x0d, 0x00) < 0) {
5446 /* Test for KS0127 */
5447 PDEBUG(3, "Testing for KS0127");
5448 ov->primary_i2c_slave = KS0127_SID;
5449 if (ov51x_set_slave_ids(ov, KS0127_SID) < 0)
5450 goto error;
5452 if (i2c_w(ov, 0x10, 0x00) < 0) {
5453 err("Can't determine sensor slave IDs");
5454 goto error;
5455 } else {
5456 if (ks0127_configure(ov) < 0) {
5457 err("Failed to configure KS0127");
5458 goto error;
5461 } else {
5462 if (saa7111a_configure(ov) < 0) {
5463 err("Failed to configure SAA7111A");
5464 goto error;
5467 } else {
5468 err("Detected unsupported OV8xx0 sensor");
5469 goto error;
5471 } else {
5472 if (ov6xx0_configure(ov) < 0) {
5473 err("Failed to configure OV6xx0");
5474 goto error;
5477 } else {
5478 if (ov7xx0_configure(ov) < 0) {
5479 err("Failed to configure OV7xx0");
5480 goto error;
5484 return 0;
5486 error:
5487 err("OV511 Config failed");
5489 return -EBUSY;
5492 /* This initializes the OV518/OV518+ and the sensor */
5493 static int
5494 ov518_configure(struct usb_ov511 *ov)
5496 /* For 518 and 518+ */
5497 static struct ov511_regvals aRegvalsInit518[] = {
5498 { OV511_REG_BUS, R51x_SYS_RESET, 0x40 },
5499 { OV511_REG_BUS, R51x_SYS_INIT, 0xe1 },
5500 { OV511_REG_BUS, R51x_SYS_RESET, 0x3e },
5501 { OV511_REG_BUS, R51x_SYS_INIT, 0xe1 },
5502 { OV511_REG_BUS, R51x_SYS_RESET, 0x00 },
5503 { OV511_REG_BUS, R51x_SYS_INIT, 0xe1 },
5504 { OV511_REG_BUS, 0x46, 0x00 },
5505 { OV511_REG_BUS, 0x5d, 0x03 },
5506 { OV511_DONE_BUS, 0x0, 0x00},
5509 static struct ov511_regvals aRegvalsNorm518[] = {
5510 { OV511_REG_BUS, R51x_SYS_SNAP, 0x02 }, /* Reset */
5511 { OV511_REG_BUS, R51x_SYS_SNAP, 0x01 }, /* Enable */
5512 { OV511_REG_BUS, 0x31, 0x0f },
5513 { OV511_REG_BUS, 0x5d, 0x03 },
5514 { OV511_REG_BUS, 0x24, 0x9f },
5515 { OV511_REG_BUS, 0x25, 0x90 },
5516 { OV511_REG_BUS, 0x20, 0x00 },
5517 { OV511_REG_BUS, 0x51, 0x04 },
5518 { OV511_REG_BUS, 0x71, 0x19 },
5519 { OV511_DONE_BUS, 0x0, 0x00 },
5522 static struct ov511_regvals aRegvalsNorm518Plus[] = {
5523 { OV511_REG_BUS, R51x_SYS_SNAP, 0x02 }, /* Reset */
5524 { OV511_REG_BUS, R51x_SYS_SNAP, 0x01 }, /* Enable */
5525 { OV511_REG_BUS, 0x31, 0x0f },
5526 { OV511_REG_BUS, 0x5d, 0x03 },
5527 { OV511_REG_BUS, 0x24, 0x9f },
5528 { OV511_REG_BUS, 0x25, 0x90 },
5529 { OV511_REG_BUS, 0x20, 0x60 },
5530 { OV511_REG_BUS, 0x51, 0x02 },
5531 { OV511_REG_BUS, 0x71, 0x19 },
5532 { OV511_REG_BUS, 0x40, 0xff },
5533 { OV511_REG_BUS, 0x41, 0x42 },
5534 { OV511_REG_BUS, 0x46, 0x00 },
5535 { OV511_REG_BUS, 0x33, 0x04 },
5536 { OV511_REG_BUS, 0x21, 0x19 },
5537 { OV511_REG_BUS, 0x3f, 0x10 },
5538 { OV511_DONE_BUS, 0x0, 0x00 },
5541 PDEBUG(4, "");
5543 /* First 5 bits of custom ID reg are a revision ID on OV518 */
5544 info("Device revision %d", 0x1F & reg_r(ov, R511_SYS_CUST_ID));
5546 /* Give it the default description */
5547 ov->desc = symbolic(camlist, 0);
5549 if (write_regvals(ov, aRegvalsInit518))
5550 goto error;
5552 /* Set LED GPIO pin to output mode */
5553 if (reg_w_mask(ov, 0x57, 0x00, 0x02) < 0)
5554 goto error;
5556 /* LED is off by default with OV518; have to explicitly turn it on */
5557 if (ov->led_policy == LED_OFF || ov->led_policy == LED_AUTO)
5558 ov51x_led_control(ov, 0);
5559 else
5560 ov51x_led_control(ov, 1);
5562 /* Don't require compression if dumppix is enabled; otherwise it's
5563 * required. OV518 has no uncompressed mode, to save RAM. */
5564 if (!dumppix && !ov->compress) {
5565 ov->compress = 1;
5566 warn("Compression required with OV518...enabling");
5569 if (ov->bridge == BRG_OV518) {
5570 if (write_regvals(ov, aRegvalsNorm518))
5571 goto error;
5572 } else if (ov->bridge == BRG_OV518PLUS) {
5573 if (write_regvals(ov, aRegvalsNorm518Plus))
5574 goto error;
5575 } else {
5576 err("Invalid bridge");
5579 if (reg_w(ov, 0x2f, 0x80) < 0)
5580 goto error;
5582 if (ov518_init_compression(ov))
5583 goto error;
5585 if (ov->bridge == BRG_OV518)
5587 struct usb_interface *ifp;
5588 struct usb_host_interface *alt;
5589 __u16 mxps = 0;
5591 ifp = usb_ifnum_to_if(ov->dev, 0);
5592 if (ifp) {
5593 alt = usb_altnum_to_altsetting(ifp, 7);
5594 if (alt)
5595 mxps = le16_to_cpu(alt->endpoint[0].desc.wMaxPacketSize);
5598 /* Some OV518s have packet numbering by default, some don't */
5599 if (mxps == 897)
5600 ov->packet_numbering = 1;
5601 else
5602 ov->packet_numbering = 0;
5603 } else {
5604 /* OV518+ has packet numbering turned on by default */
5605 ov->packet_numbering = 1;
5608 ov518_set_packet_size(ov, 0);
5610 ov->snap_enabled = snapshot;
5612 /* Test for 76xx */
5613 ov->primary_i2c_slave = OV7xx0_SID;
5614 if (ov51x_set_slave_ids(ov, OV7xx0_SID) < 0)
5615 goto error;
5617 /* The OV518 must be more aggressive about sensor detection since
5618 * I2C write will never fail if the sensor is not present. We have
5619 * to try to initialize the sensor to detect its presence */
5621 if (init_ov_sensor(ov) < 0) {
5622 /* Test for 6xx0 */
5623 ov->primary_i2c_slave = OV6xx0_SID;
5624 if (ov51x_set_slave_ids(ov, OV6xx0_SID) < 0)
5625 goto error;
5627 if (init_ov_sensor(ov) < 0) {
5628 /* Test for 8xx0 */
5629 ov->primary_i2c_slave = OV8xx0_SID;
5630 if (ov51x_set_slave_ids(ov, OV8xx0_SID) < 0)
5631 goto error;
5633 if (init_ov_sensor(ov) < 0) {
5634 err("Can't determine sensor slave IDs");
5635 goto error;
5636 } else {
5637 err("Detected unsupported OV8xx0 sensor");
5638 goto error;
5640 } else {
5641 if (ov6xx0_configure(ov) < 0) {
5642 err("Failed to configure OV6xx0");
5643 goto error;
5646 } else {
5647 if (ov7xx0_configure(ov) < 0) {
5648 err("Failed to configure OV7xx0");
5649 goto error;
5653 ov->maxwidth = 352;
5654 ov->maxheight = 288;
5656 // The OV518 cannot go as low as the sensor can
5657 ov->minwidth = 160;
5658 ov->minheight = 120;
5660 return 0;
5662 error:
5663 err("OV518 Config failed");
5665 return -EBUSY;
5668 /****************************************************************************
5669 * sysfs
5670 ***************************************************************************/
5672 static inline struct usb_ov511 *cd_to_ov(struct class_device *cd)
5674 struct video_device *vdev = to_video_device(cd);
5675 return video_get_drvdata(vdev);
5678 static ssize_t show_custom_id(struct class_device *cd, char *buf)
5680 struct usb_ov511 *ov = cd_to_ov(cd);
5681 return sprintf(buf, "%d\n", ov->customid);
5683 static CLASS_DEVICE_ATTR(custom_id, S_IRUGO, show_custom_id, NULL);
5685 static ssize_t show_model(struct class_device *cd, char *buf)
5687 struct usb_ov511 *ov = cd_to_ov(cd);
5688 return sprintf(buf, "%s\n", ov->desc);
5690 static CLASS_DEVICE_ATTR(model, S_IRUGO, show_model, NULL);
5692 static ssize_t show_bridge(struct class_device *cd, char *buf)
5694 struct usb_ov511 *ov = cd_to_ov(cd);
5695 return sprintf(buf, "%s\n", symbolic(brglist, ov->bridge));
5697 static CLASS_DEVICE_ATTR(bridge, S_IRUGO, show_bridge, NULL);
5699 static ssize_t show_sensor(struct class_device *cd, char *buf)
5701 struct usb_ov511 *ov = cd_to_ov(cd);
5702 return sprintf(buf, "%s\n", symbolic(senlist, ov->sensor));
5704 static CLASS_DEVICE_ATTR(sensor, S_IRUGO, show_sensor, NULL);
5706 static ssize_t show_brightness(struct class_device *cd, char *buf)
5708 struct usb_ov511 *ov = cd_to_ov(cd);
5709 unsigned short x;
5711 if (!ov->dev)
5712 return -ENODEV;
5713 sensor_get_brightness(ov, &x);
5714 return sprintf(buf, "%d\n", x >> 8);
5716 static CLASS_DEVICE_ATTR(brightness, S_IRUGO, show_brightness, NULL);
5718 static ssize_t show_saturation(struct class_device *cd, char *buf)
5720 struct usb_ov511 *ov = cd_to_ov(cd);
5721 unsigned short x;
5723 if (!ov->dev)
5724 return -ENODEV;
5725 sensor_get_saturation(ov, &x);
5726 return sprintf(buf, "%d\n", x >> 8);
5728 static CLASS_DEVICE_ATTR(saturation, S_IRUGO, show_saturation, NULL);
5730 static ssize_t show_contrast(struct class_device *cd, char *buf)
5732 struct usb_ov511 *ov = cd_to_ov(cd);
5733 unsigned short x;
5735 if (!ov->dev)
5736 return -ENODEV;
5737 sensor_get_contrast(ov, &x);
5738 return sprintf(buf, "%d\n", x >> 8);
5740 static CLASS_DEVICE_ATTR(contrast, S_IRUGO, show_contrast, NULL);
5742 static ssize_t show_hue(struct class_device *cd, char *buf)
5744 struct usb_ov511 *ov = cd_to_ov(cd);
5745 unsigned short x;
5747 if (!ov->dev)
5748 return -ENODEV;
5749 sensor_get_hue(ov, &x);
5750 return sprintf(buf, "%d\n", x >> 8);
5752 static CLASS_DEVICE_ATTR(hue, S_IRUGO, show_hue, NULL);
5754 static ssize_t show_exposure(struct class_device *cd, char *buf)
5756 struct usb_ov511 *ov = cd_to_ov(cd);
5757 unsigned char exp;
5759 if (!ov->dev)
5760 return -ENODEV;
5761 sensor_get_exposure(ov, &exp);
5762 return sprintf(buf, "%d\n", exp >> 8);
5764 static CLASS_DEVICE_ATTR(exposure, S_IRUGO, show_exposure, NULL);
5766 static void ov_create_sysfs(struct video_device *vdev)
5768 video_device_create_file(vdev, &class_device_attr_custom_id);
5769 video_device_create_file(vdev, &class_device_attr_model);
5770 video_device_create_file(vdev, &class_device_attr_bridge);
5771 video_device_create_file(vdev, &class_device_attr_sensor);
5772 video_device_create_file(vdev, &class_device_attr_brightness);
5773 video_device_create_file(vdev, &class_device_attr_saturation);
5774 video_device_create_file(vdev, &class_device_attr_contrast);
5775 video_device_create_file(vdev, &class_device_attr_hue);
5776 video_device_create_file(vdev, &class_device_attr_exposure);
5779 /****************************************************************************
5780 * USB routines
5781 ***************************************************************************/
5783 static int
5784 ov51x_probe(struct usb_interface *intf, const struct usb_device_id *id)
5786 struct usb_device *dev = interface_to_usbdev(intf);
5787 struct usb_interface_descriptor *idesc;
5788 struct usb_ov511 *ov;
5789 int i;
5791 PDEBUG(1, "probing for device...");
5793 /* We don't handle multi-config cameras */
5794 if (dev->descriptor.bNumConfigurations != 1)
5795 return -ENODEV;
5797 idesc = &intf->cur_altsetting->desc;
5799 if (idesc->bInterfaceClass != 0xFF)
5800 return -ENODEV;
5801 if (idesc->bInterfaceSubClass != 0x00)
5802 return -ENODEV;
5804 if ((ov = kmalloc(sizeof(*ov), GFP_KERNEL)) == NULL) {
5805 err("couldn't kmalloc ov struct");
5806 goto error_out;
5809 memset(ov, 0, sizeof(*ov));
5811 ov->dev = dev;
5812 ov->iface = idesc->bInterfaceNumber;
5813 ov->led_policy = led;
5814 ov->compress = compress;
5815 ov->lightfreq = lightfreq;
5816 ov->num_inputs = 1; /* Video decoder init functs. change this */
5817 ov->stop_during_set = !fastset;
5818 ov->backlight = backlight;
5819 ov->mirror = mirror;
5820 ov->auto_brt = autobright;
5821 ov->auto_gain = autogain;
5822 ov->auto_exp = autoexp;
5824 switch (le16_to_cpu(dev->descriptor.idProduct)) {
5825 case PROD_OV511:
5826 ov->bridge = BRG_OV511;
5827 ov->bclass = BCL_OV511;
5828 break;
5829 case PROD_OV511PLUS:
5830 ov->bridge = BRG_OV511PLUS;
5831 ov->bclass = BCL_OV511;
5832 break;
5833 case PROD_OV518:
5834 ov->bridge = BRG_OV518;
5835 ov->bclass = BCL_OV518;
5836 break;
5837 case PROD_OV518PLUS:
5838 ov->bridge = BRG_OV518PLUS;
5839 ov->bclass = BCL_OV518;
5840 break;
5841 case PROD_ME2CAM:
5842 if (le16_to_cpu(dev->descriptor.idVendor) != VEND_MATTEL)
5843 goto error;
5844 ov->bridge = BRG_OV511PLUS;
5845 ov->bclass = BCL_OV511;
5846 break;
5847 default:
5848 err("Unknown product ID 0x%04x", le16_to_cpu(dev->descriptor.idProduct));
5849 goto error;
5852 info("USB %s video device found", symbolic(brglist, ov->bridge));
5854 init_waitqueue_head(&ov->wq);
5856 init_MUTEX(&ov->lock); /* to 1 == available */
5857 init_MUTEX(&ov->buf_lock);
5858 init_MUTEX(&ov->param_lock);
5859 init_MUTEX(&ov->i2c_lock);
5860 init_MUTEX(&ov->cbuf_lock);
5862 ov->buf_state = BUF_NOT_ALLOCATED;
5864 if (usb_make_path(dev, ov->usb_path, OV511_USB_PATH_LEN) < 0) {
5865 err("usb_make_path error");
5866 goto error;
5869 /* Allocate control transfer buffer. */
5870 /* Must be kmalloc()'ed, for DMA compatibility */
5871 ov->cbuf = kmalloc(OV511_CBUF_SIZE, GFP_KERNEL);
5872 if (!ov->cbuf)
5873 goto error;
5875 if (ov->bclass == BCL_OV518) {
5876 if (ov518_configure(ov) < 0)
5877 goto error;
5878 } else {
5879 if (ov511_configure(ov) < 0)
5880 goto error;
5883 for (i = 0; i < OV511_NUMFRAMES; i++) {
5884 ov->frame[i].framenum = i;
5885 init_waitqueue_head(&ov->frame[i].wq);
5888 for (i = 0; i < OV511_NUMSBUF; i++) {
5889 ov->sbuf[i].ov = ov;
5890 spin_lock_init(&ov->sbuf[i].lock);
5891 ov->sbuf[i].n = i;
5894 /* Unnecessary? (This is done on open(). Need to make sure variables
5895 * are properly initialized without this before removing it, though). */
5896 if (ov51x_set_default_params(ov) < 0)
5897 goto error;
5899 #ifdef OV511_DEBUG
5900 if (dump_bridge) {
5901 if (ov->bclass == BCL_OV511)
5902 ov511_dump_regs(ov);
5903 else
5904 ov518_dump_regs(ov);
5906 #endif
5908 ov->vdev = video_device_alloc();
5909 if (!ov->vdev)
5910 goto error;
5912 memcpy(ov->vdev, &vdev_template, sizeof(*ov->vdev));
5913 ov->vdev->dev = &dev->dev;
5914 video_set_drvdata(ov->vdev, ov);
5916 for (i = 0; i < OV511_MAX_UNIT_VIDEO; i++) {
5917 /* Minor 0 cannot be specified; assume user wants autodetect */
5918 if (unit_video[i] == 0)
5919 break;
5921 if (video_register_device(ov->vdev, VFL_TYPE_GRABBER,
5922 unit_video[i]) >= 0) {
5923 break;
5927 /* Use the next available one */
5928 if ((ov->vdev->minor == -1) &&
5929 video_register_device(ov->vdev, VFL_TYPE_GRABBER, -1) < 0) {
5930 err("video_register_device failed");
5931 goto error;
5934 info("Device at %s registered to minor %d", ov->usb_path,
5935 ov->vdev->minor);
5937 usb_set_intfdata(intf, ov);
5938 ov_create_sysfs(ov->vdev);
5939 return 0;
5941 error:
5942 if (ov->vdev) {
5943 if (-1 == ov->vdev->minor)
5944 video_device_release(ov->vdev);
5945 else
5946 video_unregister_device(ov->vdev);
5947 ov->vdev = NULL;
5950 if (ov->cbuf) {
5951 down(&ov->cbuf_lock);
5952 kfree(ov->cbuf);
5953 ov->cbuf = NULL;
5954 up(&ov->cbuf_lock);
5957 if (ov) {
5958 kfree(ov);
5959 ov = NULL;
5962 error_out:
5963 err("Camera initialization failed");
5964 return -EIO;
5967 static void
5968 ov51x_disconnect(struct usb_interface *intf)
5970 struct usb_ov511 *ov = usb_get_intfdata(intf);
5971 int n;
5973 PDEBUG(3, "");
5975 usb_set_intfdata (intf, NULL);
5977 if (!ov)
5978 return;
5980 if (ov->vdev)
5981 video_unregister_device(ov->vdev);
5983 for (n = 0; n < OV511_NUMFRAMES; n++)
5984 ov->frame[n].grabstate = FRAME_ERROR;
5986 ov->curframe = -1;
5988 /* This will cause the process to request another frame */
5989 for (n = 0; n < OV511_NUMFRAMES; n++)
5990 wake_up_interruptible(&ov->frame[n].wq);
5992 wake_up_interruptible(&ov->wq);
5994 ov->streaming = 0;
5995 ov51x_unlink_isoc(ov);
5997 ov->dev = NULL;
5999 /* Free the memory */
6000 if (ov && !ov->user) {
6001 down(&ov->cbuf_lock);
6002 kfree(ov->cbuf);
6003 ov->cbuf = NULL;
6004 up(&ov->cbuf_lock);
6006 ov51x_dealloc(ov);
6007 kfree(ov);
6008 ov = NULL;
6011 PDEBUG(3, "Disconnect complete");
6014 static struct usb_driver ov511_driver = {
6015 .owner = THIS_MODULE,
6016 .name = "ov511",
6017 .id_table = device_table,
6018 .probe = ov51x_probe,
6019 .disconnect = ov51x_disconnect
6022 /****************************************************************************
6024 * Module routines
6026 ***************************************************************************/
6028 /* Returns 0 for success */
6030 ov511_register_decomp_module(int ver, struct ov51x_decomp_ops *ops, int ov518,
6031 int mmx)
6033 if (ver != DECOMP_INTERFACE_VER) {
6034 err("Decompression module has incompatible");
6035 err("interface version %d", ver);
6036 err("Interface version %d is required", DECOMP_INTERFACE_VER);
6037 return -EINVAL;
6040 if (!ops)
6041 return -EFAULT;
6043 if (mmx && !ov51x_mmx_available) {
6044 err("MMX not available on this system or kernel");
6045 return -EINVAL;
6048 lock_kernel();
6050 if (ov518) {
6051 if (mmx) {
6052 if (ov518_mmx_decomp_ops)
6053 goto err_in_use;
6054 else
6055 ov518_mmx_decomp_ops = ops;
6056 } else {
6057 if (ov518_decomp_ops)
6058 goto err_in_use;
6059 else
6060 ov518_decomp_ops = ops;
6062 } else {
6063 if (mmx) {
6064 if (ov511_mmx_decomp_ops)
6065 goto err_in_use;
6066 else
6067 ov511_mmx_decomp_ops = ops;
6068 } else {
6069 if (ov511_decomp_ops)
6070 goto err_in_use;
6071 else
6072 ov511_decomp_ops = ops;
6076 unlock_kernel();
6077 return 0;
6079 err_in_use:
6080 unlock_kernel();
6081 return -EBUSY;
6084 void
6085 ov511_deregister_decomp_module(int ov518, int mmx)
6087 lock_kernel();
6089 if (ov518) {
6090 if (mmx)
6091 ov518_mmx_decomp_ops = NULL;
6092 else
6093 ov518_decomp_ops = NULL;
6094 } else {
6095 if (mmx)
6096 ov511_mmx_decomp_ops = NULL;
6097 else
6098 ov511_decomp_ops = NULL;
6101 unlock_kernel();
6104 static int __init
6105 usb_ov511_init(void)
6107 int retval;
6109 retval = usb_register(&ov511_driver);
6110 if (retval)
6111 goto out;
6113 info(DRIVER_VERSION " : " DRIVER_DESC);
6115 out:
6116 return retval;
6119 static void __exit
6120 usb_ov511_exit(void)
6122 usb_deregister(&ov511_driver);
6123 info("driver deregistered");
6127 module_init(usb_ov511_init);
6128 module_exit(usb_ov511_exit);
6130 EXPORT_SYMBOL(ov511_register_decomp_module);
6131 EXPORT_SYMBOL(ov511_deregister_decomp_module);