]> www.pilppa.org Git - linux-2.6-omap-h63xx.git/blob - drivers/media/video/stv680.c
b21a8d6827c4e417d231e1c65c76336f4f2bcef6
[linux-2.6-omap-h63xx.git] / drivers / media / video / stv680.c
1 /*
2  *  STV0680 USB Camera Driver, by Kevin Sisson (kjsisson@bellsouth.net)
3  *
4  * Thanks to STMicroelectronics for information on the usb commands, and
5  * to Steve Miller at STM for his help and encouragement while I was
6  * writing this driver.
7  *
8  * This driver is based heavily on the
9  * Endpoints (formerly known as AOX) se401 USB Camera Driver
10  * Copyright (c) 2000 Jeroen B. Vreeken (pe1rxq@amsat.org)
11  *
12  * Still somewhat based on the Linux ov511 driver.
13  *
14  * This program is free software; you can redistribute it and/or modify it
15  * under the terms of the GNU General Public License as published by the
16  * Free Software Foundation; either version 2 of the License, or (at your
17  * option) any later version.
18  *
19  * This program is distributed in the hope that it will be useful, but
20  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
21  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
22  * for more details.
23  *
24  * You should have received a copy of the GNU General Public License
25  * along with this program; if not, write to the Free Software Foundation,
26  * Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
27  *
28  * History:
29  * ver 0.1 October, 2001. Initial attempt.
30  *
31  * ver 0.2 November, 2001. Fixed asbility to resize, added brightness
32  *                         function, made more stable (?)
33  *
34  * ver 0.21 Nov, 2001.     Added gamma correction and white balance,
35  *                         due to Alexander Schwartz. Still trying to
36  *                         improve stablility. Moved stuff into stv680.h
37  *
38  * ver 0.22 Nov, 2001.     Added sharpen function (by Michael Sweet,
39  *                         mike@easysw.com) from GIMP, also used in pencam.
40  *                         Simple, fast, good integer math routine.
41  *
42  * ver 0.23 Dec, 2001 (gkh)
43  *                         Took out sharpen function, ran code through
44  *                         Lindent, and did other minor tweaks to get
45  *                         things to work properly with 2.5.1
46  *
47  * ver 0.24 Jan, 2002 (kjs)
48  *                         Fixed the problem with webcam crashing after
49  *                         two pictures. Changed the way pic is halved to
50  *                         improve quality. Got rid of green line around
51  *                         frame. Fix brightness reset when changing size
52  *                         bug. Adjusted gamma filters slightly.
53  *
54  * ver 0.25 Jan, 2002 (kjs)
55  *                         Fixed a bug in which the driver sometimes attempted
56  *                         to set to a non-supported size. This allowed
57  *                         gnomemeeting to work.
58  *                         Fixed proc entry removal bug.
59  */
60
61 #include <linux/module.h>
62 #include <linux/init.h>
63 #include <linux/vmalloc.h>
64 #include <linux/slab.h>
65 #include <linux/pagemap.h>
66 #include <linux/errno.h>
67 #include <linux/videodev.h>
68 #include <media/v4l2-common.h>
69 #include <media/v4l2-ioctl.h>
70 #include <linux/usb.h>
71 #include <linux/mutex.h>
72
73 #include "stv680.h"
74
75 static int video_nr = -1;
76
77 static int swapRGB;     /* 0 = default for auto select */
78
79 /* 0 = default to allow auto select; -1 = swap never, +1 = swap always */
80 static int swapRGB_on;
81
82 static unsigned int debug;
83
84 #define PDEBUG(level, fmt, args...) \
85         do { \
86         if (debug >= level)     \
87                 info("[%s:%d] " fmt, __func__, __LINE__ , ## args);     \
88         } while (0)
89
90
91 /*
92  * Version Information
93  */
94 #define DRIVER_VERSION "v0.25"
95 #define DRIVER_AUTHOR "Kevin Sisson <kjsisson@bellsouth.net>"
96 #define DRIVER_DESC "STV0680 USB Camera Driver"
97
98 MODULE_AUTHOR (DRIVER_AUTHOR);
99 MODULE_DESCRIPTION (DRIVER_DESC);
100 MODULE_LICENSE ("GPL");
101 module_param(debug, int, S_IRUGO | S_IWUSR);
102 MODULE_PARM_DESC (debug, "Debug enabled or not");
103 module_param(swapRGB_on, int, 0);
104 MODULE_PARM_DESC (swapRGB_on, "Red/blue swap: 1=always, 0=auto, -1=never");
105 module_param(video_nr, int, 0);
106
107 /********************************************************************
108  *
109  * Memory management
110  *
111  * This is a shameless copy from the USB-cpia driver (linux kernel
112  * version 2.3.29 or so, I have no idea what this code actually does ;).
113  * Actually it seems to be a copy of a shameless copy of the bttv-driver.
114  * Or that is a copy of a shameless copy of ... (To the powers: is there
115  * no generic kernel-function to do this sort of stuff?)
116  *
117  * Yes, it was a shameless copy from the bttv-driver. IIRC, Alan says
118  * there will be one, but apparentely not yet -jerdfelt
119  *
120  * So I copied it again for the ov511 driver -claudio
121  *
122  * Same for the se401 driver -Jeroen
123  *
124  * And the STV0680 driver - Kevin
125  ********************************************************************/
126 static void *rvmalloc (unsigned long size)
127 {
128         void *mem;
129         unsigned long adr;
130
131         size = PAGE_ALIGN(size);
132         mem = vmalloc_32 (size);
133         if (!mem)
134                 return NULL;
135
136         memset (mem, 0, size);  /* Clear the ram out, no junk to the user */
137         adr = (unsigned long) mem;
138         while (size > 0) {
139                 SetPageReserved(vmalloc_to_page((void *)adr));
140                 adr += PAGE_SIZE;
141                 size -= PAGE_SIZE;
142         }
143         return mem;
144 }
145
146 static void rvfree (void *mem, unsigned long size)
147 {
148         unsigned long adr;
149
150         if (!mem)
151                 return;
152
153         adr = (unsigned long) mem;
154         while ((long) size > 0) {
155                 ClearPageReserved(vmalloc_to_page((void *)adr));
156                 adr += PAGE_SIZE;
157                 size -= PAGE_SIZE;
158         }
159         vfree (mem);
160 }
161
162
163 /*********************************************************************
164  * pencam read/write functions
165  ********************************************************************/
166
167 static int stv_sndctrl (int set, struct usb_stv *stv680, unsigned short req, unsigned short value, unsigned char *buffer, int size)
168 {
169         int ret = -1;
170
171         switch (set) {
172         case 0:         /*  0xc1  */
173                 ret = usb_control_msg (stv680->udev,
174                                        usb_rcvctrlpipe (stv680->udev, 0),
175                                        req,
176                                        (USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_ENDPOINT),
177                                        value, 0, buffer, size, PENCAM_TIMEOUT);
178                 break;
179
180         case 1:         /*  0x41  */
181                 ret = usb_control_msg (stv680->udev,
182                                        usb_sndctrlpipe (stv680->udev, 0),
183                                        req,
184                                        (USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_ENDPOINT),
185                                        value, 0, buffer, size, PENCAM_TIMEOUT);
186                 break;
187
188         case 2:         /*  0x80  */
189                 ret = usb_control_msg (stv680->udev,
190                                        usb_rcvctrlpipe (stv680->udev, 0),
191                                        req,
192                                        (USB_DIR_IN | USB_RECIP_DEVICE),
193                                        value, 0, buffer, size, PENCAM_TIMEOUT);
194                 break;
195
196         case 3:         /*  0x40  */
197                 ret = usb_control_msg (stv680->udev,
198                                        usb_sndctrlpipe (stv680->udev, 0),
199                                        req,
200                                        (USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE),
201                                        value, 0, buffer, size, PENCAM_TIMEOUT);
202                 break;
203
204         }
205         if ((ret < 0) && (req != 0x0a)) {
206                 PDEBUG (1, "STV(e): usb_control_msg error %i, request = 0x%x, error = %i", set, req, ret);
207         }
208         return ret;
209 }
210
211 static int stv_set_config (struct usb_stv *dev, int configuration, int interface, int alternate)
212 {
213
214         if (configuration != dev->udev->actconfig->desc.bConfigurationValue
215                         || usb_reset_configuration (dev->udev) < 0) {
216                 PDEBUG (1, "STV(e): FAILED to reset configuration %i", configuration);
217                 return -1;
218         }
219         if (usb_set_interface (dev->udev, interface, alternate) < 0) {
220                 PDEBUG (1, "STV(e): FAILED to set alternate interface %i", alternate);
221                 return -1;
222         }
223         return 0;
224 }
225
226 static int stv_stop_video (struct usb_stv *dev)
227 {
228         int i;
229         unsigned char *buf;
230
231         buf = kmalloc (40, GFP_KERNEL);
232         if (buf == NULL) {
233                 PDEBUG (0, "STV(e): Out of (small buf) memory");
234                 return -1;
235         }
236
237         /* this is a high priority command; it stops all lower order commands */
238         if ((i = stv_sndctrl (1, dev, 0x04, 0x0000, buf, 0x0)) < 0) {
239                 i = stv_sndctrl (0, dev, 0x80, 0, buf, 0x02);   /* Get Last Error; 2 = busy */
240                 PDEBUG (1, "STV(i): last error: %i,  command = 0x%x", buf[0], buf[1]);
241         } else {
242                 PDEBUG (1, "STV(i): Camera reset to idle mode.");
243         }
244
245         if ((i = stv_set_config (dev, 1, 0, 0)) < 0)
246                 PDEBUG (1, "STV(e): Reset config during exit failed");
247
248         /*  get current mode  */
249         buf[0] = 0xf0;
250         if ((i = stv_sndctrl (0, dev, 0x87, 0, buf, 0x08)) != 0x08)     /* get mode */
251                 PDEBUG (0, "STV(e): Stop_video: problem setting original mode");
252         if (dev->origMode != buf[0]) {
253                 memset (buf, 0, 8);
254                 buf[0] = (unsigned char) dev->origMode;
255                 if ((i = stv_sndctrl (3, dev, 0x07, 0x0100, buf, 0x08)) != 0x08) {
256                         PDEBUG (0, "STV(e): Stop_video: Set_Camera_Mode failed");
257                         i = -1;
258                 }
259                 buf[0] = 0xf0;
260                 i = stv_sndctrl (0, dev, 0x87, 0, buf, 0x08);
261                 if ((i != 0x08) || (buf[0] != dev->origMode)) {
262                         PDEBUG (0, "STV(e): camera NOT set to original resolution.");
263                         i = -1;
264                 } else
265                         PDEBUG (0, "STV(i): Camera set to original resolution");
266         }
267         /* origMode */
268         kfree(buf);
269         return i;
270 }
271
272 static int stv_set_video_mode (struct usb_stv *dev)
273 {
274         int i, stop_video = 1;
275         unsigned char *buf;
276
277         buf = kmalloc (40, GFP_KERNEL);
278         if (buf == NULL) {
279                 PDEBUG (0, "STV(e): Out of (small buf) memory");
280                 return -1;
281         }
282
283         if ((i = stv_set_config (dev, 1, 0, 0)) < 0) {
284                 kfree(buf);
285                 return i;
286         }
287
288         i = stv_sndctrl (2, dev, 0x06, 0x0100, buf, 0x12);
289         if (!(i > 0) && (buf[8] == 0x53) && (buf[9] == 0x05)) {
290                 PDEBUG (1, "STV(e): Could not get descriptor 0100.");
291                 goto error;
292         }
293
294         /*  set alternate interface 1 */
295         if ((i = stv_set_config (dev, 1, 0, 1)) < 0)
296                 goto error;
297
298         if ((i = stv_sndctrl (0, dev, 0x85, 0, buf, 0x10)) != 0x10)
299                 goto error;
300         PDEBUG (1, "STV(i): Setting video mode.");
301         /*  Switch to Video mode: 0x0100 = VGA (640x480), 0x0000 = CIF (352x288) 0x0300 = QVGA (320x240)  */
302         if ((i = stv_sndctrl (1, dev, 0x09, dev->VideoMode, buf, 0x0)) < 0) {
303                 stop_video = 0;
304                 goto error;
305         }
306         goto exit;
307
308 error:
309         kfree(buf);
310         if (stop_video == 1)
311                 stv_stop_video (dev);
312         return -1;
313
314 exit:
315         kfree(buf);
316         return 0;
317 }
318
319 static int stv_init (struct usb_stv *stv680)
320 {
321         int i = 0;
322         unsigned char *buffer;
323         unsigned long int bufsize;
324
325         buffer = kzalloc (40, GFP_KERNEL);
326         if (buffer == NULL) {
327                 PDEBUG (0, "STV(e): Out of (small buf) memory");
328                 return -1;
329         }
330         udelay (100);
331
332         /* set config 1, interface 0, alternate 0 */
333         if ((i = stv_set_config (stv680, 1, 0, 0)) < 0) {
334                 kfree(buffer);
335                 PDEBUG (0, "STV(e): set config 1,0,0 failed");
336                 return -1;
337         }
338         /* ping camera to be sure STV0680 is present */
339         if ((i = stv_sndctrl (0, stv680, 0x88, 0x5678, buffer, 0x02)) != 0x02)
340                 goto error;
341         if ((buffer[0] != 0x56) || (buffer[1] != 0x78)) {
342                 PDEBUG (1, "STV(e): camera ping failed!!");
343                 goto error;
344         }
345
346         /* get camera descriptor */
347         if ((i = stv_sndctrl (2, stv680, 0x06, 0x0200, buffer, 0x09)) != 0x09)
348                 goto error;
349         i = stv_sndctrl (2, stv680, 0x06, 0x0200, buffer, 0x22);
350         if (!(i >= 0) && (buffer[7] == 0xa0) && (buffer[8] == 0x23)) {
351                 PDEBUG (1, "STV(e): Could not get descriptor 0200.");
352                 goto error;
353         }
354         if ((i = stv_sndctrl (0, stv680, 0x8a, 0, buffer, 0x02)) != 0x02)
355                 goto error;
356         if ((i = stv_sndctrl (0, stv680, 0x8b, 0, buffer, 0x24)) != 0x24)
357                 goto error;
358         if ((i = stv_sndctrl (0, stv680, 0x85, 0, buffer, 0x10)) != 0x10)
359                 goto error;
360
361         stv680->SupportedModes = buffer[7];
362         i = stv680->SupportedModes;
363         stv680->CIF = 0;
364         stv680->VGA = 0;
365         stv680->QVGA = 0;
366         if (i & 1)
367                 stv680->CIF = 1;
368         if (i & 2)
369                 stv680->VGA = 1;
370         if (i & 8)
371                 stv680->QVGA = 1;
372         if (stv680->SupportedModes == 0) {
373                 PDEBUG (0, "STV(e): There are NO supported STV680 modes!!");
374                 i = -1;
375                 goto error;
376         } else {
377                 if (stv680->CIF)
378                         PDEBUG (0, "STV(i): CIF is supported");
379                 if (stv680->QVGA)
380                         PDEBUG (0, "STV(i): QVGA is supported");
381         }
382         /* FW rev, ASIC rev, sensor ID  */
383         PDEBUG (1, "STV(i): Firmware rev is %i.%i", buffer[0], buffer[1]);
384         PDEBUG (1, "STV(i): ASIC rev is %i.%i", buffer[2], buffer[3]);
385         PDEBUG (1, "STV(i): Sensor ID is %i", (buffer[4]*16) + (buffer[5]>>4));
386
387         /*  set alternate interface 1 */
388         if ((i = stv_set_config (stv680, 1, 0, 1)) < 0)
389                 goto error;
390
391         if ((i = stv_sndctrl (0, stv680, 0x85, 0, buffer, 0x10)) != 0x10)
392                 goto error;
393         if ((i = stv_sndctrl (0, stv680, 0x8d, 0, buffer, 0x08)) != 0x08)
394                 goto error;
395         i = buffer[3];
396         PDEBUG (0, "STV(i): Camera has %i pictures.", i);
397
398         /*  get current mode */
399         if ((i = stv_sndctrl (0, stv680, 0x87, 0, buffer, 0x08)) != 0x08)
400                 goto error;
401         stv680->origMode = buffer[0];   /* 01 = VGA, 03 = QVGA, 00 = CIF */
402
403         /* This will attemp CIF mode, if supported. If not, set to QVGA  */
404         memset (buffer, 0, 8);
405         if (stv680->CIF)
406                 buffer[0] = 0x00;
407         else if (stv680->QVGA)
408                 buffer[0] = 0x03;
409         if ((i = stv_sndctrl (3, stv680, 0x07, 0x0100, buffer, 0x08)) != 0x08) {
410                 PDEBUG (0, "STV(i): Set_Camera_Mode failed");
411                 i = -1;
412                 goto error;
413         }
414         buffer[0] = 0xf0;
415         stv_sndctrl (0, stv680, 0x87, 0, buffer, 0x08);
416         if (((stv680->CIF == 1) && (buffer[0] != 0x00)) || ((stv680->QVGA == 1) && (buffer[0] != 0x03))) {
417                 PDEBUG (0, "STV(e): Error setting camera video mode!");
418                 i = -1;
419                 goto error;
420         } else {
421                 if (buffer[0] == 0) {
422                         stv680->VideoMode = 0x0000;
423                         PDEBUG (0, "STV(i): Video Mode set to CIF");
424                 }
425                 if (buffer[0] == 0x03) {
426                         stv680->VideoMode = 0x0300;
427                         PDEBUG (0, "STV(i): Video Mode set to QVGA");
428                 }
429         }
430         if ((i = stv_sndctrl (0, stv680, 0x8f, 0, buffer, 0x10)) != 0x10)
431                 goto error;
432         bufsize = (buffer[0] << 24) | (buffer[1] << 16) | (buffer[2] << 8) | (buffer[3]);
433         stv680->cwidth = (buffer[4] << 8) | (buffer[5]);        /* ->camera = 322, 356, 644  */
434         stv680->cheight = (buffer[6] << 8) | (buffer[7]);       /* ->camera = 242, 292, 484  */
435         stv680->origGain = buffer[12];
436
437         goto exit;
438
439 error:
440         i = stv_sndctrl (0, stv680, 0x80, 0, buffer, 0x02);     /* Get Last Error */
441         PDEBUG (1, "STV(i): last error: %i,  command = 0x%x", buffer[0], buffer[1]);
442         kfree(buffer);
443         return -1;
444
445 exit:
446         kfree(buffer);
447
448         /* video = 320x240, 352x288 */
449         if (stv680->CIF == 1) {
450                 stv680->maxwidth = 352;
451                 stv680->maxheight = 288;
452                 stv680->vwidth = 352;
453                 stv680->vheight = 288;
454         }
455         if (stv680->QVGA == 1) {
456                 stv680->maxwidth = 320;
457                 stv680->maxheight = 240;
458                 stv680->vwidth = 320;
459                 stv680->vheight = 240;
460         }
461
462         stv680->rawbufsize = bufsize;   /* must be ./. by 8 */
463         stv680->maxframesize = bufsize * 3;     /* RGB size */
464         PDEBUG (2, "STV(i): cwidth = %i, cheight = %i", stv680->cwidth, stv680->cheight);
465         PDEBUG (1, "STV(i): width = %i, height = %i, rawbufsize = %li", stv680->vwidth, stv680->vheight, stv680->rawbufsize);
466
467         /* some default values */
468         stv680->bulk_in_endpointAddr = 0x82;
469         stv680->dropped = 0;
470         stv680->error = 0;
471         stv680->framecount = 0;
472         stv680->readcount = 0;
473         stv680->streaming = 0;
474         /* bright, white, colour, hue, contrast are set by software, not in stv0680 */
475         stv680->brightness = 32767;
476         stv680->chgbright = 0;
477         stv680->whiteness = 0;  /* only for greyscale */
478         stv680->colour = 32767;
479         stv680->contrast = 32767;
480         stv680->hue = 32767;
481         stv680->palette = STV_VIDEO_PALETTE;
482         stv680->depth = 24;     /* rgb24 bits */
483         if ((swapRGB_on == 0) && (swapRGB == 0))
484                 PDEBUG (1, "STV(i): swapRGB is (auto) OFF");
485         else if ((swapRGB_on == 0) && (swapRGB == 1))
486                 PDEBUG (1, "STV(i): swapRGB is (auto) ON");
487         else if (swapRGB_on == 1)
488                 PDEBUG (1, "STV(i): swapRGB is (forced) ON");
489         else if (swapRGB_on == -1)
490                 PDEBUG (1, "STV(i): swapRGB is (forced) OFF");
491
492         if (stv_set_video_mode (stv680) < 0) {
493                 PDEBUG (0, "STV(e): Could not set video mode in stv_init");
494                 return -1;
495         }
496
497         return 0;
498 }
499
500 /***************** last of pencam  routines  *******************/
501
502 /****************************************************************************
503  *  sysfs
504  ***************************************************************************/
505 #define stv680_file(name, variable, field)                              \
506 static ssize_t show_##name(struct device *class_dev,                    \
507                            struct device_attribute *attr, char *buf)    \
508 {                                                                       \
509         struct video_device *vdev = to_video_device(class_dev);         \
510         struct usb_stv *stv = video_get_drvdata(vdev);                  \
511         return sprintf(buf, field, stv->variable);                      \
512 }                                                                       \
513 static DEVICE_ATTR(name, S_IRUGO, show_##name, NULL);
514
515 stv680_file(model, camera_name, "%s\n");
516 stv680_file(in_use, user, "%d\n");
517 stv680_file(streaming, streaming, "%d\n");
518 stv680_file(palette, palette, "%i\n");
519 stv680_file(frames_total, readcount, "%d\n");
520 stv680_file(frames_read, framecount, "%d\n");
521 stv680_file(packets_dropped, dropped, "%d\n");
522 stv680_file(decoding_errors, error, "%d\n");
523
524 static int stv680_create_sysfs_files(struct video_device *vdev)
525 {
526         int rc;
527
528         rc = device_create_file(&vdev->dev, &dev_attr_model);
529         if (rc) goto err;
530         rc = device_create_file(&vdev->dev, &dev_attr_in_use);
531         if (rc) goto err_model;
532         rc = device_create_file(&vdev->dev, &dev_attr_streaming);
533         if (rc) goto err_inuse;
534         rc = device_create_file(&vdev->dev, &dev_attr_palette);
535         if (rc) goto err_stream;
536         rc = device_create_file(&vdev->dev, &dev_attr_frames_total);
537         if (rc) goto err_pal;
538         rc = device_create_file(&vdev->dev, &dev_attr_frames_read);
539         if (rc) goto err_framtot;
540         rc = device_create_file(&vdev->dev, &dev_attr_packets_dropped);
541         if (rc) goto err_framread;
542         rc = device_create_file(&vdev->dev, &dev_attr_decoding_errors);
543         if (rc) goto err_dropped;
544
545         return 0;
546
547 err_dropped:
548         device_remove_file(&vdev->dev, &dev_attr_packets_dropped);
549 err_framread:
550         device_remove_file(&vdev->dev, &dev_attr_frames_read);
551 err_framtot:
552         device_remove_file(&vdev->dev, &dev_attr_frames_total);
553 err_pal:
554         device_remove_file(&vdev->dev, &dev_attr_palette);
555 err_stream:
556         device_remove_file(&vdev->dev, &dev_attr_streaming);
557 err_inuse:
558         device_remove_file(&vdev->dev, &dev_attr_in_use);
559 err_model:
560         device_remove_file(&vdev->dev, &dev_attr_model);
561 err:
562         PDEBUG(0, "STV(e): Could not create sysfs files");
563         return rc;
564 }
565
566 static void stv680_remove_sysfs_files(struct video_device *vdev)
567 {
568         device_remove_file(&vdev->dev, &dev_attr_model);
569         device_remove_file(&vdev->dev, &dev_attr_in_use);
570         device_remove_file(&vdev->dev, &dev_attr_streaming);
571         device_remove_file(&vdev->dev, &dev_attr_palette);
572         device_remove_file(&vdev->dev, &dev_attr_frames_total);
573         device_remove_file(&vdev->dev, &dev_attr_frames_read);
574         device_remove_file(&vdev->dev, &dev_attr_packets_dropped);
575         device_remove_file(&vdev->dev, &dev_attr_decoding_errors);
576 }
577
578 /********************************************************************
579  * Camera control
580  *******************************************************************/
581
582 static int stv680_get_pict (struct usb_stv *stv680, struct video_picture *p)
583 {
584         /* This sets values for v4l interface. max/min = 65535/0  */
585
586         p->brightness = stv680->brightness;
587         p->whiteness = stv680->whiteness;       /* greyscale */
588         p->colour = stv680->colour;
589         p->contrast = stv680->contrast;
590         p->hue = stv680->hue;
591         p->palette = stv680->palette;
592         p->depth = stv680->depth;
593         return 0;
594 }
595
596 static int stv680_set_pict (struct usb_stv *stv680, struct video_picture *p)
597 {
598         /* See above stv680_get_pict  */
599
600         if (p->palette != STV_VIDEO_PALETTE) {
601                 PDEBUG (2, "STV(e): Palette set error in _set_pic");
602                 return 1;
603         }
604
605         if (stv680->brightness != p->brightness) {
606                 stv680->chgbright = 1;
607                 stv680->brightness = p->brightness;
608         }
609
610         stv680->whiteness = p->whiteness;       /* greyscale */
611         stv680->colour = p->colour;
612         stv680->contrast = p->contrast;
613         stv680->hue = p->hue;
614         stv680->palette = p->palette;
615         stv680->depth = p->depth;
616
617         return 0;
618 }
619
620 static void stv680_video_irq (struct urb *urb)
621 {
622         struct usb_stv *stv680 = urb->context;
623         int length = urb->actual_length;
624
625         if (length < stv680->rawbufsize)
626                 PDEBUG (2, "STV(i): Lost data in transfer: exp %li, got %i", stv680->rawbufsize, length);
627
628         /* ohoh... */
629         if (!stv680->streaming)
630                 return;
631
632         if (!stv680->udev) {
633                 PDEBUG (0, "STV(e): device vapourished in video_irq");
634                 return;
635         }
636
637         /* 0 sized packets happen if we are to fast, but sometimes the camera
638            keeps sending them forever...
639          */
640         if (length && !urb->status) {
641                 stv680->nullpackets = 0;
642                 switch (stv680->scratch[stv680->scratch_next].state) {
643                 case BUFFER_READY:
644                 case BUFFER_BUSY:
645                         stv680->dropped++;
646                         break;
647
648                 case BUFFER_UNUSED:
649                         memcpy (stv680->scratch[stv680->scratch_next].data,
650                                 (unsigned char *) urb->transfer_buffer, length);
651                         stv680->scratch[stv680->scratch_next].state = BUFFER_READY;
652                         stv680->scratch[stv680->scratch_next].length = length;
653                         if (waitqueue_active (&stv680->wq)) {
654                                 wake_up_interruptible (&stv680->wq);
655                         }
656                         stv680->scratch_overflow = 0;
657                         stv680->scratch_next++;
658                         if (stv680->scratch_next >= STV680_NUMSCRATCH)
659                                 stv680->scratch_next = 0;
660                         break;
661                 }               /* switch  */
662         } else {
663                 stv680->nullpackets++;
664                 if (stv680->nullpackets > STV680_MAX_NULLPACKETS) {
665                         if (waitqueue_active (&stv680->wq)) {
666                                 wake_up_interruptible (&stv680->wq);
667                         }
668                 }
669         }                       /*  if - else */
670
671         /* Resubmit urb for new data */
672         urb->status = 0;
673         urb->dev = stv680->udev;
674         if (usb_submit_urb (urb, GFP_ATOMIC))
675                 PDEBUG (0, "STV(e): urb burned down in video irq");
676         return;
677 }                               /*  _video_irq  */
678
679 static int stv680_start_stream (struct usb_stv *stv680)
680 {
681         struct urb *urb;
682         int err = 0, i;
683
684         stv680->streaming = 1;
685
686         /* Do some memory allocation */
687         for (i = 0; i < STV680_NUMFRAMES; i++) {
688                 stv680->frame[i].data = stv680->fbuf + i * stv680->maxframesize;
689                 stv680->frame[i].curpix = 0;
690         }
691         /* packet size = 4096  */
692         for (i = 0; i < STV680_NUMSBUF; i++) {
693                 stv680->sbuf[i].data = kmalloc (stv680->rawbufsize, GFP_KERNEL);
694                 if (stv680->sbuf[i].data == NULL) {
695                         PDEBUG (0, "STV(e): Could not kmalloc raw data buffer %i", i);
696                         goto nomem_err;
697                 }
698         }
699
700         stv680->scratch_next = 0;
701         stv680->scratch_use = 0;
702         stv680->scratch_overflow = 0;
703         for (i = 0; i < STV680_NUMSCRATCH; i++) {
704                 stv680->scratch[i].data = kmalloc (stv680->rawbufsize, GFP_KERNEL);
705                 if (stv680->scratch[i].data == NULL) {
706                         PDEBUG (0, "STV(e): Could not kmalloc raw scratch buffer %i", i);
707                         goto nomem_err;
708                 }
709                 stv680->scratch[i].state = BUFFER_UNUSED;
710         }
711
712         for (i = 0; i < STV680_NUMSBUF; i++) {
713                 urb = usb_alloc_urb (0, GFP_KERNEL);
714                 if (!urb)
715                         goto nomem_err;
716
717                 /* sbuf is urb->transfer_buffer, later gets memcpyed to scratch */
718                 usb_fill_bulk_urb (urb, stv680->udev,
719                                    usb_rcvbulkpipe (stv680->udev, stv680->bulk_in_endpointAddr),
720                                    stv680->sbuf[i].data, stv680->rawbufsize,
721                                    stv680_video_irq, stv680);
722                 stv680->urb[i] = urb;
723                 err = usb_submit_urb (stv680->urb[i], GFP_KERNEL);
724                 if (err) {
725                         PDEBUG (0, "STV(e): urb burned down with err "
726                                    "%d in start stream %d", err, i);
727                         goto nomem_err;
728                 }
729         }                       /* i STV680_NUMSBUF */
730
731         stv680->framecount = 0;
732         return 0;
733
734  nomem_err:
735         for (i = 0; i < STV680_NUMSCRATCH; i++) {
736                 kfree(stv680->scratch[i].data);
737                 stv680->scratch[i].data = NULL;
738         }
739         for (i = 0; i < STV680_NUMSBUF; i++) {
740                 usb_kill_urb(stv680->urb[i]);
741                 usb_free_urb(stv680->urb[i]);
742                 stv680->urb[i] = NULL;
743                 kfree(stv680->sbuf[i].data);
744                 stv680->sbuf[i].data = NULL;
745         }
746         return -ENOMEM;
747
748 }
749
750 static int stv680_stop_stream (struct usb_stv *stv680)
751 {
752         int i;
753
754         if (!stv680->streaming || !stv680->udev)
755                 return 1;
756
757         stv680->streaming = 0;
758
759         for (i = 0; i < STV680_NUMSBUF; i++)
760                 if (stv680->urb[i]) {
761                         usb_kill_urb (stv680->urb[i]);
762                         usb_free_urb (stv680->urb[i]);
763                         stv680->urb[i] = NULL;
764                         kfree(stv680->sbuf[i].data);
765                 }
766         for (i = 0; i < STV680_NUMSCRATCH; i++) {
767                 kfree(stv680->scratch[i].data);
768                 stv680->scratch[i].data = NULL;
769         }
770
771         return 0;
772 }
773
774 static int stv680_set_size (struct usb_stv *stv680, int width, int height)
775 {
776         int wasstreaming = stv680->streaming;
777
778         /* Check to see if we need to change */
779         if ((stv680->vwidth == width) && (stv680->vheight == height))
780                 return 0;
781
782         PDEBUG (1, "STV(i): size request for %i x %i", width, height);
783         /* Check for a valid mode */
784         if ((!width || !height) || ((width & 1) || (height & 1))) {
785                 PDEBUG (1, "STV(e): set_size error: request: v.width = %i, v.height = %i  actual: stv.width = %i, stv.height = %i", width, height, stv680->vwidth, stv680->vheight);
786                 return 1;
787         }
788
789         if ((width < (stv680->maxwidth / 2)) || (height < (stv680->maxheight / 2))) {
790                 width = stv680->maxwidth / 2;
791                 height = stv680->maxheight / 2;
792         } else if ((width >= 158) && (width <= 166) && (stv680->QVGA == 1)) {
793                 width = 160;
794                 height = 120;
795         } else if ((width >= 172) && (width <= 180) && (stv680->CIF == 1)) {
796                 width = 176;
797                 height = 144;
798         } else if ((width >= 318) && (width <= 350) && (stv680->QVGA == 1)) {
799                 width = 320;
800                 height = 240;
801         } else if ((width >= 350) && (width <= 358) && (stv680->CIF == 1)) {
802                 width = 352;
803                 height = 288;
804         } else {
805                 PDEBUG (1, "STV(e): request for non-supported size: request: v.width = %i, v.height = %i  actual: stv.width = %i, stv.height = %i", width, height, stv680->vwidth, stv680->vheight);
806                 return 1;
807         }
808
809         /* Stop a current stream and start it again at the new size */
810         if (wasstreaming)
811                 stv680_stop_stream (stv680);
812         stv680->vwidth = width;
813         stv680->vheight = height;
814         PDEBUG (1, "STV(i): size set to %i x %i", stv680->vwidth, stv680->vheight);
815         if (wasstreaming)
816                 stv680_start_stream (stv680);
817
818         return 0;
819 }
820
821 /**********************************************************************
822  * Video Decoding
823  **********************************************************************/
824
825 /*******  routines from the pencam program; hey, they work!  ********/
826
827 /*
828  * STV0680 Vision Camera Chipset Driver
829  * Copyright (C) 2000 Adam Harrison <adam@antispin.org>
830 */
831
832 #define RED 0
833 #define GREEN 1
834 #define BLUE 2
835 #define AD(x, y, w) (((y)*(w)+(x))*3)
836
837 static void bayer_unshuffle (struct usb_stv *stv680, struct stv680_scratch *buffer)
838 {
839         int x, y, i;
840         int w = stv680->cwidth;
841         int vw = stv680->cwidth, vh = stv680->cheight;
842         unsigned int p = 0;
843         int colour = 0, bayer = 0;
844         unsigned char *raw = buffer->data;
845         struct stv680_frame *frame = &stv680->frame[stv680->curframe];
846         unsigned char *output = frame->data;
847         unsigned char *temp = frame->data;
848         int offset = buffer->offset;
849
850         if (frame->curpix == 0) {
851                 if (frame->grabstate == FRAME_READY) {
852                         frame->grabstate = FRAME_GRABBING;
853                 }
854         }
855         if (offset != frame->curpix) {  /* Regard frame as lost :( */
856                 frame->curpix = 0;
857                 stv680->error++;
858                 return;
859         }
860
861         if ((stv680->vwidth == 320) || (stv680->vwidth == 160)) {
862                 vw = 320;
863                 vh = 240;
864         }
865         if ((stv680->vwidth == 352) || (stv680->vwidth == 176)) {
866                 vw = 352;
867                 vh = 288;
868         }
869
870         memset (output, 0, 3 * vw * vh);        /* clear output matrix. */
871
872         for (y = 0; y < vh; y++) {
873                 for (x = 0; x < vw; x++) {
874                         if (x & 1)
875                                 p = *(raw + y * w + (x >> 1));
876                         else
877                                 p = *(raw + y * w + (x >> 1) + (w >> 1));
878
879                         if (y & 1)
880                                 bayer = 2;
881                         else
882                                 bayer = 0;
883                         if (x & 1)
884                                 bayer++;
885
886                         switch (bayer) {
887                         case 0:
888                         case 3:
889                                 colour = 1;
890                                 break;
891                         case 1:
892                                 colour = 0;
893                                 break;
894                         case 2:
895                                 colour = 2;
896                                 break;
897                         }
898                         i = (y * vw + x) * 3;
899                         *(output + i + colour) = (unsigned char) p;
900                 }               /* for x */
901
902         }                       /* for y */
903
904         /****** gamma correction plus hardcoded white balance */
905         /* Thanks to Alexander Schwartx <alexander.schwartx@gmx.net> for this code.
906            Correction values red[], green[], blue[], are generated by
907            (pow(i/256.0, GAMMA)*255.0)*white balanceRGB where GAMMA=0.55, 1<i<255.
908            White balance (RGB)= 1.0, 1.17, 1.48. Values are calculated as double float and
909            converted to unsigned char. Values are in stv680.h  */
910
911         for (y = 0; y < vh; y++) {
912                 for (x = 0; x < vw; x++) {
913                         i = (y * vw + x) * 3;
914                         *(output + i) = red[*(output + i)];
915                         *(output + i + 1) = green[*(output + i + 1)];
916                         *(output + i + 2) = blue[*(output + i + 2)];
917                 }
918         }
919
920         /******  bayer demosaic  ******/
921         for (y = 1; y < (vh - 1); y++) {
922                 for (x = 1; x < (vw - 1); x++) {        /* work out pixel type */
923                         if (y & 1)
924                                 bayer = 0;
925                         else
926                                 bayer = 2;
927                         if (!(x & 1))
928                                 bayer++;
929
930                         switch (bayer) {
931                         case 0: /* green. blue lr, red tb */
932                                 *(output + AD (x, y, vw) + BLUE) = ((int) *(output + AD (x - 1, y, vw) + BLUE) + (int) *(output + AD (x + 1, y, vw) + BLUE)) >> 1;
933                                 *(output + AD (x, y, vw) + RED) = ((int) *(output + AD (x, y - 1, vw) + RED) + (int) *(output + AD (x, y + 1, vw) + RED)) >> 1;
934                                 break;
935
936                         case 1: /* blue. green lrtb, red diagonals */
937                                 *(output + AD (x, y, vw) + GREEN) = ((int) *(output + AD (x - 1, y, vw) + GREEN) + (int) *(output + AD (x + 1, y, vw) + GREEN) + (int) *(output + AD (x, y - 1, vw) + GREEN) + (int) *(output + AD (x, y + 1, vw) + GREEN)) >> 2;
938                                 *(output + AD (x, y, vw) + RED) = ((int) *(output + AD (x - 1, y - 1, vw) + RED) + (int) *(output + AD (x - 1, y + 1, vw) + RED) + (int) *(output + AD (x + 1, y - 1, vw) + RED) + (int) *(output + AD (x + 1, y + 1, vw) + RED)) >> 2;
939                                 break;
940
941                         case 2: /* red. green lrtb, blue diagonals */
942                                 *(output + AD (x, y, vw) + GREEN) = ((int) *(output + AD (x - 1, y, vw) + GREEN) + (int) *(output + AD (x + 1, y, vw) + GREEN) + (int) *(output + AD (x, y - 1, vw) + GREEN) + (int) *(output + AD (x, y + 1, vw) + GREEN)) >> 2;
943                                 *(output + AD (x, y, vw) + BLUE) = ((int) *(output + AD (x - 1, y - 1, vw) + BLUE) + (int) *(output + AD (x + 1, y - 1, vw) + BLUE) + (int) *(output + AD (x - 1, y + 1, vw) + BLUE) + (int) *(output + AD (x + 1, y + 1, vw) + BLUE)) >> 2;
944                                 break;
945
946                         case 3: /* green. red lr, blue tb */
947                                 *(output + AD (x, y, vw) + RED) = ((int) *(output + AD (x - 1, y, vw) + RED) + (int) *(output + AD (x + 1, y, vw) + RED)) >> 1;
948                                 *(output + AD (x, y, vw) + BLUE) = ((int) *(output + AD (x, y - 1, vw) + BLUE) + (int) *(output + AD (x, y + 1, vw) + BLUE)) >> 1;
949                                 break;
950                         }       /* switch */
951                 }               /* for x */
952         }                       /* for y  - end demosaic  */
953
954         /* fix top and bottom row, left and right side */
955         i = vw * 3;
956         memcpy (output, (output + i), i);
957         memcpy ((output + (vh * i)), (output + ((vh - 1) * i)), i);
958         for (y = 0; y < vh; y++) {
959                 i = y * vw * 3;
960                 memcpy ((output + i), (output + i + 3), 3);
961                 memcpy ((output + i + (vw * 3)), (output + i + (vw - 1) * 3), 3);
962         }
963
964         /*  process all raw data, then trim to size if necessary */
965         if ((stv680->vwidth == 160) || (stv680->vwidth == 176))  {
966                 i = 0;
967                 for (y = 0; y < vh; y++) {
968                         if (!(y & 1)) {
969                                 for (x = 0; x < vw; x++) {
970                                         p = (y * vw + x) * 3;
971                                         if (!(x & 1)) {
972                                                 *(output + i) = *(output + p);
973                                                 *(output + i + 1) = *(output + p + 1);
974                                                 *(output + i + 2) = *(output + p + 2);
975                                                 i += 3;
976                                         }
977                                 }  /* for x */
978                         }
979                 }  /* for y */
980         }
981         /* reset to proper width */
982         if ((stv680->vwidth == 160)) {
983                 vw = 160;
984                 vh = 120;
985         }
986         if ((stv680->vwidth == 176)) {
987                 vw = 176;
988                 vh = 144;
989         }
990
991         /* output is RGB; some programs want BGR  */
992         /* swapRGB_on=0 -> program decides;  swapRGB_on=1, always swap */
993         /* swapRGB_on=-1, never swap */
994         if (((swapRGB == 1) && (swapRGB_on != -1)) || (swapRGB_on == 1)) {
995                 for (y = 0; y < vh; y++) {
996                         for (x = 0; x < vw; x++) {
997                                 i = (y * vw + x) * 3;
998                                 *(temp) = *(output + i);
999                                 *(output + i) = *(output + i + 2);
1000                                 *(output + i + 2) = *(temp);
1001                         }
1002                 }
1003         }
1004         /* brightness */
1005         if (stv680->chgbright == 1) {
1006                 if (stv680->brightness >= 32767) {
1007                         p = (stv680->brightness - 32767) / 256;
1008                         for (x = 0; x < (vw * vh * 3); x++) {
1009                                 if ((*(output + x) + (unsigned char) p) > 255)
1010                                         *(output + x) = 255;
1011                                 else
1012                                         *(output + x) += (unsigned char) p;
1013                         }       /* for */
1014                 } else {
1015                         p = (32767 - stv680->brightness) / 256;
1016                         for (x = 0; x < (vw * vh * 3); x++) {
1017                                 if ((unsigned char) p > *(output + x))
1018                                         *(output + x) = 0;
1019                                 else
1020                                         *(output + x) -= (unsigned char) p;
1021                         }       /* for */
1022                 }               /* else */
1023         }
1024         /* if */
1025         frame->curpix = 0;
1026         frame->curlinepix = 0;
1027         frame->grabstate = FRAME_DONE;
1028         stv680->framecount++;
1029         stv680->readcount++;
1030         if (stv680->frame[(stv680->curframe + 1) & (STV680_NUMFRAMES - 1)].grabstate == FRAME_READY) {
1031                 stv680->curframe = (stv680->curframe + 1) & (STV680_NUMFRAMES - 1);
1032         }
1033
1034 }                               /* bayer_unshuffle */
1035
1036 /*******  end routines from the pencam program  *********/
1037
1038 static int stv680_newframe (struct usb_stv *stv680, int framenr)
1039 {
1040         int errors = 0;
1041
1042         while (stv680->streaming && (stv680->frame[framenr].grabstate == FRAME_READY || stv680->frame[framenr].grabstate == FRAME_GRABBING)) {
1043                 if (!stv680->frame[framenr].curpix) {
1044                         errors++;
1045                 }
1046                 wait_event_interruptible (stv680->wq, (stv680->scratch[stv680->scratch_use].state == BUFFER_READY));
1047
1048                 if (stv680->nullpackets > STV680_MAX_NULLPACKETS) {
1049                         stv680->nullpackets = 0;
1050                         PDEBUG (2, "STV(i): too many null length packets, restarting capture");
1051                         stv680_stop_stream (stv680);
1052                         stv680_start_stream (stv680);
1053                 } else {
1054                         if (stv680->scratch[stv680->scratch_use].state != BUFFER_READY) {
1055                                 stv680->frame[framenr].grabstate = FRAME_ERROR;
1056                                 PDEBUG (2, "STV(e): FRAME_ERROR in _newframe");
1057                                 return -EIO;
1058                         }
1059                         stv680->scratch[stv680->scratch_use].state = BUFFER_BUSY;
1060
1061                         bayer_unshuffle (stv680, &stv680->scratch[stv680->scratch_use]);
1062
1063                         stv680->scratch[stv680->scratch_use].state = BUFFER_UNUSED;
1064                         stv680->scratch_use++;
1065                         if (stv680->scratch_use >= STV680_NUMSCRATCH)
1066                                 stv680->scratch_use = 0;
1067                         if (errors > STV680_MAX_ERRORS) {
1068                                 errors = 0;
1069                                 PDEBUG (2, "STV(i): too many errors, restarting capture");
1070                                 stv680_stop_stream (stv680);
1071                                 stv680_start_stream (stv680);
1072                         }
1073                 }               /* else */
1074         }                       /* while */
1075         return 0;
1076 }
1077
1078 /*********************************************************************
1079  * Video4Linux
1080  *********************************************************************/
1081
1082 static int stv_open (struct inode *inode, struct file *file)
1083 {
1084         struct video_device *dev = video_devdata(file);
1085         struct usb_stv *stv680 = video_get_drvdata(dev);
1086         int err = 0;
1087
1088         /* we are called with the BKL held */
1089         lock_kernel();
1090         stv680->user = 1;
1091         err = stv_init (stv680);        /* main initialization routine for camera */
1092
1093         if (err >= 0) {
1094                 stv680->fbuf = rvmalloc (stv680->maxframesize * STV680_NUMFRAMES);
1095                 if (!stv680->fbuf) {
1096                         PDEBUG (0, "STV(e): Could not rvmalloc frame bufer");
1097                         err = -ENOMEM;
1098                 }
1099                 file->private_data = dev;
1100         }
1101         if (err)
1102                 stv680->user = 0;
1103         unlock_kernel();
1104
1105         return err;
1106 }
1107
1108 static int stv_close (struct inode *inode, struct file *file)
1109 {
1110         struct video_device *dev = file->private_data;
1111         struct usb_stv *stv680 = video_get_drvdata(dev);
1112         int i;
1113
1114         for (i = 0; i < STV680_NUMFRAMES; i++)
1115                 stv680->frame[i].grabstate = FRAME_UNUSED;
1116         if (stv680->streaming)
1117                 stv680_stop_stream (stv680);
1118
1119         if ((i = stv_stop_video (stv680)) < 0)
1120                 PDEBUG (1, "STV(e): stop_video failed in stv_close");
1121
1122         rvfree (stv680->fbuf, stv680->maxframesize * STV680_NUMFRAMES);
1123         stv680->user = 0;
1124
1125         if (stv680->removed) {
1126                 kfree(stv680);
1127                 stv680 = NULL;
1128                 PDEBUG (0, "STV(i): device unregistered");
1129         }
1130         file->private_data = NULL;
1131         return 0;
1132 }
1133
1134 static int stv680_do_ioctl (struct inode *inode, struct file *file,
1135                             unsigned int cmd, void *arg)
1136 {
1137         struct video_device *vdev = file->private_data;
1138         struct usb_stv *stv680 = video_get_drvdata(vdev);
1139
1140         if (!stv680->udev)
1141                 return -EIO;
1142
1143         switch (cmd) {
1144         case VIDIOCGCAP:{
1145                         struct video_capability *b = arg;
1146
1147                         strcpy (b->name, stv680->camera_name);
1148                         b->type = VID_TYPE_CAPTURE;
1149                         b->channels = 1;
1150                         b->audios = 0;
1151                         b->maxwidth = stv680->maxwidth;
1152                         b->maxheight = stv680->maxheight;
1153                         b->minwidth = stv680->maxwidth / 2;
1154                         b->minheight = stv680->maxheight / 2;
1155                         return 0;
1156                 }
1157         case VIDIOCGCHAN:{
1158                         struct video_channel *v = arg;
1159
1160                         if (v->channel != 0)
1161                                 return -EINVAL;
1162                         v->flags = 0;
1163                         v->tuners = 0;
1164                         v->type = VIDEO_TYPE_CAMERA;
1165                         strcpy (v->name, "STV Camera");
1166                         return 0;
1167                 }
1168         case VIDIOCSCHAN:{
1169                         struct video_channel *v = arg;
1170                         if (v->channel != 0)
1171                                 return -EINVAL;
1172                         return 0;
1173                 }
1174         case VIDIOCGPICT:{
1175                         struct video_picture *p = arg;
1176
1177                         stv680_get_pict (stv680, p);
1178                         return 0;
1179                 }
1180         case VIDIOCSPICT:{
1181                         struct video_picture *p = arg;
1182
1183                         if (stv680_set_pict (stv680, p))
1184                                 return -EINVAL;
1185                         return 0;
1186                 }
1187         case VIDIOCSWIN:{
1188                         struct video_window *vw = arg;
1189
1190                         if (vw->flags)
1191                                 return -EINVAL;
1192                         if (vw->clipcount)
1193                                 return -EINVAL;
1194                         if (vw->width != stv680->vwidth) {
1195                                 if (stv680_set_size (stv680, vw->width, vw->height)) {
1196                                         PDEBUG (2, "STV(e): failed (from user) set size in VIDIOCSWIN");
1197                                         return -EINVAL;
1198                                 }
1199                         }
1200                         return 0;
1201                 }
1202         case VIDIOCGWIN:{
1203                         struct video_window *vw = arg;
1204
1205                         vw->x = 0;      /* FIXME */
1206                         vw->y = 0;
1207                         vw->chromakey = 0;
1208                         vw->flags = 0;
1209                         vw->clipcount = 0;
1210                         vw->width = stv680->vwidth;
1211                         vw->height = stv680->vheight;
1212                         return 0;
1213                 }
1214         case VIDIOCGMBUF:{
1215                         struct video_mbuf *vm = arg;
1216                         int i;
1217
1218                         memset (vm, 0, sizeof (*vm));
1219                         vm->size = STV680_NUMFRAMES * stv680->maxframesize;
1220                         vm->frames = STV680_NUMFRAMES;
1221                         for (i = 0; i < STV680_NUMFRAMES; i++)
1222                                 vm->offsets[i] = stv680->maxframesize * i;
1223                         return 0;
1224                 }
1225         case VIDIOCMCAPTURE:{
1226                         struct video_mmap *vm = arg;
1227
1228                         if (vm->format != STV_VIDEO_PALETTE) {
1229                                 PDEBUG (2, "STV(i): VIDIOCMCAPTURE vm.format (%i) != VIDEO_PALETTE (%i)",
1230                                         vm->format, STV_VIDEO_PALETTE);
1231                                 if ((vm->format == 3) && (swapRGB_on == 0))  {
1232                                         PDEBUG (2, "STV(i): VIDIOCMCAPTURE swapRGB is (auto) ON");
1233                                         /* this may fix those apps (e.g., xawtv) that want BGR */
1234                                         swapRGB = 1;
1235                                 }
1236                                 return -EINVAL;
1237                         }
1238                         if (vm->frame >= STV680_NUMFRAMES) {
1239                                 PDEBUG (2, "STV(e): VIDIOCMCAPTURE vm.frame > NUMFRAMES");
1240                                 return -EINVAL;
1241                         }
1242                         if ((stv680->frame[vm->frame].grabstate == FRAME_ERROR)
1243                             || (stv680->frame[vm->frame].grabstate == FRAME_GRABBING)) {
1244                                 PDEBUG (2, "STV(e): VIDIOCMCAPTURE grabstate (%i) error",
1245                                         stv680->frame[vm->frame].grabstate);
1246                                 return -EBUSY;
1247                         }
1248                         /* Is this according to the v4l spec??? */
1249                         if (stv680->vwidth != vm->width) {
1250                                 if (stv680_set_size (stv680, vm->width, vm->height)) {
1251                                         PDEBUG (2, "STV(e): VIDIOCMCAPTURE set_size failed");
1252                                         return -EINVAL;
1253                                 }
1254                         }
1255                         stv680->frame[vm->frame].grabstate = FRAME_READY;
1256
1257                         if (!stv680->streaming)
1258                                 stv680_start_stream (stv680);
1259
1260                         return 0;
1261                 }
1262         case VIDIOCSYNC:{
1263                         int *frame = arg;
1264                         int ret = 0;
1265
1266                         if (*frame < 0 || *frame >= STV680_NUMFRAMES) {
1267                                 PDEBUG (2, "STV(e): Bad frame # in VIDIOCSYNC");
1268                                 return -EINVAL;
1269                         }
1270                         ret = stv680_newframe (stv680, *frame);
1271                         stv680->frame[*frame].grabstate = FRAME_UNUSED;
1272                         return ret;
1273                 }
1274         case VIDIOCGFBUF:{
1275                         struct video_buffer *vb = arg;
1276
1277                         memset (vb, 0, sizeof (*vb));
1278                         return 0;
1279                 }
1280         case VIDIOCKEY:
1281                 return 0;
1282         case VIDIOCCAPTURE:
1283                 {
1284                         PDEBUG (2, "STV(e): VIDIOCCAPTURE failed");
1285                         return -EINVAL;
1286                 }
1287         case VIDIOCSFBUF:
1288         case VIDIOCGTUNER:
1289         case VIDIOCSTUNER:
1290         case VIDIOCGFREQ:
1291         case VIDIOCSFREQ:
1292         case VIDIOCGAUDIO:
1293         case VIDIOCSAUDIO:
1294                 return -EINVAL;
1295         default:
1296                 return -ENOIOCTLCMD;
1297         }                       /* end switch */
1298
1299         return 0;
1300 }
1301
1302 static int stv680_ioctl(struct inode *inode, struct file *file,
1303                         unsigned int cmd, unsigned long arg)
1304 {
1305         return video_usercopy(inode, file, cmd, arg, stv680_do_ioctl);
1306 }
1307
1308 static int stv680_mmap (struct file *file, struct vm_area_struct *vma)
1309 {
1310         struct video_device *dev = file->private_data;
1311         struct usb_stv *stv680 = video_get_drvdata(dev);
1312         unsigned long start = vma->vm_start;
1313         unsigned long size  = vma->vm_end-vma->vm_start;
1314         unsigned long page, pos;
1315
1316         mutex_lock(&stv680->lock);
1317
1318         if (stv680->udev == NULL) {
1319                 mutex_unlock(&stv680->lock);
1320                 return -EIO;
1321         }
1322         if (size > (((STV680_NUMFRAMES * stv680->maxframesize) + PAGE_SIZE - 1)
1323                     & ~(PAGE_SIZE - 1))) {
1324                 mutex_unlock(&stv680->lock);
1325                 return -EINVAL;
1326         }
1327         pos = (unsigned long) stv680->fbuf;
1328         while (size > 0) {
1329                 page = vmalloc_to_pfn((void *)pos);
1330                 if (remap_pfn_range(vma, start, page, PAGE_SIZE, PAGE_SHARED)) {
1331                         mutex_unlock(&stv680->lock);
1332                         return -EAGAIN;
1333                 }
1334                 start += PAGE_SIZE;
1335                 pos += PAGE_SIZE;
1336                 if (size > PAGE_SIZE)
1337                         size -= PAGE_SIZE;
1338                 else
1339                         size = 0;
1340         }
1341         mutex_unlock(&stv680->lock);
1342
1343         return 0;
1344 }
1345
1346 static ssize_t stv680_read (struct file *file, char __user *buf,
1347                         size_t count, loff_t *ppos)
1348 {
1349         struct video_device *dev = file->private_data;
1350         unsigned long int realcount = count;
1351         int ret = 0;
1352         struct usb_stv *stv680 = video_get_drvdata(dev);
1353         unsigned long int i;
1354
1355         if (STV680_NUMFRAMES != 2) {
1356                 PDEBUG (0, "STV(e): STV680_NUMFRAMES needs to be 2!");
1357                 return -1;
1358         }
1359         if (stv680->udev == NULL)
1360                 return -EIO;
1361         if (realcount > (stv680->vwidth * stv680->vheight * 3))
1362                 realcount = stv680->vwidth * stv680->vheight * 3;
1363
1364         /* Shouldn't happen: */
1365         if (stv680->frame[0].grabstate == FRAME_GRABBING) {
1366                 PDEBUG (2, "STV(e): FRAME_GRABBING in stv680_read");
1367                 return -EBUSY;
1368         }
1369         stv680->frame[0].grabstate = FRAME_READY;
1370         stv680->frame[1].grabstate = FRAME_UNUSED;
1371         stv680->curframe = 0;
1372
1373         if (!stv680->streaming)
1374                 stv680_start_stream (stv680);
1375
1376         if (!stv680->streaming) {
1377                 ret = stv680_newframe (stv680, 0);      /* ret should = 0 */
1378         }
1379
1380         ret = stv680_newframe (stv680, 0);
1381
1382         if (!ret) {
1383                 if ((i = copy_to_user (buf, stv680->frame[0].data, realcount)) != 0) {
1384                         PDEBUG (2, "STV(e): copy_to_user frame 0 failed, ret count = %li", i);
1385                         return -EFAULT;
1386                 }
1387         } else {
1388                 realcount = ret;
1389         }
1390         stv680->frame[0].grabstate = FRAME_UNUSED;
1391         return realcount;
1392 }                               /* stv680_read */
1393
1394 static const struct file_operations stv680_fops = {
1395         .owner =        THIS_MODULE,
1396         .open =         stv_open,
1397         .release =      stv_close,
1398         .read =         stv680_read,
1399         .mmap =         stv680_mmap,
1400         .ioctl =        stv680_ioctl,
1401 #ifdef CONFIG_COMPAT
1402         .compat_ioctl = v4l_compat_ioctl32,
1403 #endif
1404         .llseek =       no_llseek,
1405 };
1406 static struct video_device stv680_template = {
1407         .name =         "STV0680 USB camera",
1408         .fops =         &stv680_fops,
1409         .release =      video_device_release,
1410         .minor =        -1,
1411 };
1412
1413 static int stv680_probe (struct usb_interface *intf, const struct usb_device_id *id)
1414 {
1415         struct usb_device *dev = interface_to_usbdev(intf);
1416         struct usb_host_interface *interface;
1417         struct usb_stv *stv680 = NULL;
1418         char *camera_name = NULL;
1419         int retval = 0;
1420
1421         /* We don't handle multi-config cameras */
1422         if (dev->descriptor.bNumConfigurations != 1) {
1423                 PDEBUG (0, "STV(e): Number of Configurations != 1");
1424                 return -ENODEV;
1425         }
1426
1427         interface = &intf->altsetting[0];
1428         /* Is it a STV680? */
1429         if ((le16_to_cpu(dev->descriptor.idVendor) == USB_PENCAM_VENDOR_ID) &&
1430             (le16_to_cpu(dev->descriptor.idProduct) == USB_PENCAM_PRODUCT_ID)) {
1431                 camera_name = "STV0680";
1432                 PDEBUG (0, "STV(i): STV0680 camera found.");
1433         } else if ((le16_to_cpu(dev->descriptor.idVendor) == USB_CREATIVEGOMINI_VENDOR_ID) &&
1434                    (le16_to_cpu(dev->descriptor.idProduct) == USB_CREATIVEGOMINI_PRODUCT_ID)) {
1435                 camera_name = "Creative WebCam Go Mini";
1436                 PDEBUG (0, "STV(i): Creative WebCam Go Mini found.");
1437         } else {
1438                 PDEBUG (0, "STV(e): Vendor/Product ID do not match STV0680 or Creative WebCam Go Mini values.");
1439                 PDEBUG (0, "STV(e): Check that the STV0680 or Creative WebCam Go Mini camera is connected to the computer.");
1440                 retval = -ENODEV;
1441                 goto error;
1442         }
1443         /* We found one */
1444         if ((stv680 = kzalloc (sizeof (*stv680), GFP_KERNEL)) == NULL) {
1445                 PDEBUG (0, "STV(e): couldn't kmalloc stv680 struct.");
1446                 retval = -ENOMEM;
1447                 goto error;
1448         }
1449
1450         stv680->udev = dev;
1451         stv680->camera_name = camera_name;
1452
1453         stv680->vdev = video_device_alloc();
1454         if (!stv680->vdev) {
1455                 retval = -ENOMEM;
1456                 goto error;
1457         }
1458         memcpy(stv680->vdev, &stv680_template, sizeof(stv680_template));
1459         stv680->vdev->parent = &intf->dev;
1460         video_set_drvdata(stv680->vdev, stv680);
1461
1462         memcpy (stv680->vdev->name, stv680->camera_name, strlen (stv680->camera_name));
1463         init_waitqueue_head (&stv680->wq);
1464         mutex_init (&stv680->lock);
1465         wmb ();
1466
1467         if (video_register_device(stv680->vdev, VFL_TYPE_GRABBER, video_nr) < 0) {
1468                 PDEBUG (0, "STV(e): video_register_device failed");
1469                 retval = -EIO;
1470                 goto error_vdev;
1471         }
1472         PDEBUG (0, "STV(i): registered new video device: video%d", stv680->vdev->minor);
1473
1474         usb_set_intfdata (intf, stv680);
1475         retval = stv680_create_sysfs_files(stv680->vdev);
1476         if (retval)
1477                 goto error_unreg;
1478         return 0;
1479
1480 error_unreg:
1481         video_unregister_device(stv680->vdev);
1482 error_vdev:
1483         video_device_release(stv680->vdev);
1484 error:
1485         kfree(stv680);
1486         return retval;
1487 }
1488
1489 static inline void usb_stv680_remove_disconnected (struct usb_stv *stv680)
1490 {
1491         int i;
1492
1493         stv680->udev = NULL;
1494         stv680->frame[0].grabstate = FRAME_ERROR;
1495         stv680->frame[1].grabstate = FRAME_ERROR;
1496         stv680->streaming = 0;
1497
1498         wake_up_interruptible (&stv680->wq);
1499
1500         for (i = 0; i < STV680_NUMSBUF; i++)
1501                 if (stv680->urb[i]) {
1502                         usb_kill_urb (stv680->urb[i]);
1503                         usb_free_urb (stv680->urb[i]);
1504                         stv680->urb[i] = NULL;
1505                         kfree(stv680->sbuf[i].data);
1506                 }
1507         for (i = 0; i < STV680_NUMSCRATCH; i++)
1508                 kfree(stv680->scratch[i].data);
1509         PDEBUG (0, "STV(i): %s disconnected", stv680->camera_name);
1510
1511         /* Free the memory */
1512         kfree(stv680);
1513 }
1514
1515 static void stv680_disconnect (struct usb_interface *intf)
1516 {
1517         struct usb_stv *stv680 = usb_get_intfdata (intf);
1518
1519         usb_set_intfdata (intf, NULL);
1520
1521         if (stv680) {
1522                 /* We don't want people trying to open up the device */
1523                 if (stv680->vdev) {
1524                         stv680_remove_sysfs_files(stv680->vdev);
1525                         video_unregister_device(stv680->vdev);
1526                         stv680->vdev = NULL;
1527                 }
1528                 if (!stv680->user) {
1529                         usb_stv680_remove_disconnected (stv680);
1530                 } else {
1531                         stv680->removed = 1;
1532                 }
1533         }
1534 }
1535
1536 static struct usb_driver stv680_driver = {
1537         .name =         "stv680",
1538         .probe =        stv680_probe,
1539         .disconnect =   stv680_disconnect,
1540         .id_table =     device_table
1541 };
1542
1543 /********************************************************************
1544  *  Module routines
1545  ********************************************************************/
1546
1547 static int __init usb_stv680_init (void)
1548 {
1549         if (usb_register (&stv680_driver) < 0) {
1550                 PDEBUG (0, "STV(e): Could not setup STV0680 driver");
1551                 return -1;
1552         }
1553         PDEBUG (0, "STV(i): usb camera driver version %s registering", DRIVER_VERSION);
1554
1555         info(DRIVER_DESC " " DRIVER_VERSION);
1556         return 0;
1557 }
1558
1559 static void __exit usb_stv680_exit (void)
1560 {
1561         usb_deregister (&stv680_driver);
1562         PDEBUG (0, "STV(i): driver deregistered");
1563 }
1564
1565 module_init (usb_stv680_init);
1566 module_exit (usb_stv680_exit);