[media] gspca: Use current logging styles
[pohmelfs.git] / drivers / media / video / gspca / gspca.c
bloba3c2d36da0c860ab5c705a1f89e83425c75bbf56
1 /*
2 * Main USB camera driver
4 * Copyright (C) 2008-2011 Jean-François Moine <http://moinejf.free.fr>
6 * Camera button input handling by Márton Németh
7 * Copyright (C) 2009-2010 Márton Németh <nm127@freemail.hu>
9 * This program is free software; you can redistribute it and/or modify it
10 * under the terms of the GNU General Public License as published by the
11 * Free Software Foundation; either version 2 of the License, or (at your
12 * option) any later version.
14 * This program is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
16 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17 * for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software Foundation,
21 * Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
26 #define MODULE_NAME "gspca"
28 #include <linux/init.h>
29 #include <linux/fs.h>
30 #include <linux/vmalloc.h>
31 #include <linux/sched.h>
32 #include <linux/slab.h>
33 #include <linux/mm.h>
34 #include <linux/string.h>
35 #include <linux/pagemap.h>
36 #include <linux/io.h>
37 #include <asm/page.h>
38 #include <linux/uaccess.h>
39 #include <linux/ktime.h>
40 #include <media/v4l2-ioctl.h>
42 #include "gspca.h"
44 #if defined(CONFIG_INPUT) || defined(CONFIG_INPUT_MODULE)
45 #include <linux/input.h>
46 #include <linux/usb/input.h>
47 #endif
49 /* global values */
50 #define DEF_NURBS 3 /* default number of URBs */
51 #if DEF_NURBS > MAX_NURBS
52 #error "DEF_NURBS too big"
53 #endif
55 #define DRIVER_VERSION_NUMBER "2.13.0"
57 MODULE_AUTHOR("Jean-François Moine <http://moinejf.free.fr>");
58 MODULE_DESCRIPTION("GSPCA USB Camera Driver");
59 MODULE_LICENSE("GPL");
60 MODULE_VERSION(DRIVER_VERSION_NUMBER);
62 #ifdef GSPCA_DEBUG
63 int gspca_debug = D_ERR | D_PROBE;
64 EXPORT_SYMBOL(gspca_debug);
66 static void PDEBUG_MODE(char *txt, __u32 pixfmt, int w, int h)
68 if ((pixfmt >> 24) >= '0' && (pixfmt >> 24) <= 'z') {
69 PDEBUG(D_CONF|D_STREAM, "%s %c%c%c%c %dx%d",
70 txt,
71 pixfmt & 0xff,
72 (pixfmt >> 8) & 0xff,
73 (pixfmt >> 16) & 0xff,
74 pixfmt >> 24,
75 w, h);
76 } else {
77 PDEBUG(D_CONF|D_STREAM, "%s 0x%08x %dx%d",
78 txt,
79 pixfmt,
80 w, h);
83 #else
84 #define PDEBUG_MODE(txt, pixfmt, w, h)
85 #endif
87 /* specific memory types - !! should be different from V4L2_MEMORY_xxx */
88 #define GSPCA_MEMORY_NO 0 /* V4L2_MEMORY_xxx starts from 1 */
89 #define GSPCA_MEMORY_READ 7
91 #define BUF_ALL_FLAGS (V4L2_BUF_FLAG_QUEUED | V4L2_BUF_FLAG_DONE)
94 * VMA operations.
96 static void gspca_vm_open(struct vm_area_struct *vma)
98 struct gspca_frame *frame = vma->vm_private_data;
100 frame->vma_use_count++;
101 frame->v4l2_buf.flags |= V4L2_BUF_FLAG_MAPPED;
104 static void gspca_vm_close(struct vm_area_struct *vma)
106 struct gspca_frame *frame = vma->vm_private_data;
108 if (--frame->vma_use_count <= 0)
109 frame->v4l2_buf.flags &= ~V4L2_BUF_FLAG_MAPPED;
112 static const struct vm_operations_struct gspca_vm_ops = {
113 .open = gspca_vm_open,
114 .close = gspca_vm_close,
118 * Input and interrupt endpoint handling functions
120 #if defined(CONFIG_INPUT) || defined(CONFIG_INPUT_MODULE)
121 static void int_irq(struct urb *urb)
123 struct gspca_dev *gspca_dev = (struct gspca_dev *) urb->context;
124 int ret;
126 ret = urb->status;
127 switch (ret) {
128 case 0:
129 if (gspca_dev->sd_desc->int_pkt_scan(gspca_dev,
130 urb->transfer_buffer, urb->actual_length) < 0) {
131 PDEBUG(D_ERR, "Unknown packet received");
133 break;
135 case -ENOENT:
136 case -ECONNRESET:
137 case -ENODEV:
138 case -ESHUTDOWN:
139 /* Stop is requested either by software or hardware is gone,
140 * keep the ret value non-zero and don't resubmit later.
142 break;
144 default:
145 PDEBUG(D_ERR, "URB error %i, resubmitting", urb->status);
146 urb->status = 0;
147 ret = 0;
150 if (ret == 0) {
151 ret = usb_submit_urb(urb, GFP_ATOMIC);
152 if (ret < 0)
153 pr_err("Resubmit URB failed with error %i\n", ret);
157 static int gspca_input_connect(struct gspca_dev *dev)
159 struct input_dev *input_dev;
160 int err = 0;
162 dev->input_dev = NULL;
163 if (dev->sd_desc->int_pkt_scan || dev->sd_desc->other_input) {
164 input_dev = input_allocate_device();
165 if (!input_dev)
166 return -ENOMEM;
168 usb_make_path(dev->dev, dev->phys, sizeof(dev->phys));
169 strlcat(dev->phys, "/input0", sizeof(dev->phys));
171 input_dev->name = dev->sd_desc->name;
172 input_dev->phys = dev->phys;
174 usb_to_input_id(dev->dev, &input_dev->id);
176 input_dev->evbit[0] = BIT_MASK(EV_KEY);
177 input_dev->keybit[BIT_WORD(KEY_CAMERA)] = BIT_MASK(KEY_CAMERA);
178 input_dev->dev.parent = &dev->dev->dev;
180 err = input_register_device(input_dev);
181 if (err) {
182 pr_err("Input device registration failed with error %i\n",
183 err);
184 input_dev->dev.parent = NULL;
185 input_free_device(input_dev);
186 } else {
187 dev->input_dev = input_dev;
191 return err;
194 static int alloc_and_submit_int_urb(struct gspca_dev *gspca_dev,
195 struct usb_endpoint_descriptor *ep)
197 unsigned int buffer_len;
198 int interval;
199 struct urb *urb;
200 struct usb_device *dev;
201 void *buffer = NULL;
202 int ret = -EINVAL;
204 buffer_len = le16_to_cpu(ep->wMaxPacketSize);
205 interval = ep->bInterval;
206 PDEBUG(D_CONF, "found int in endpoint: 0x%x, "
207 "buffer_len=%u, interval=%u",
208 ep->bEndpointAddress, buffer_len, interval);
210 dev = gspca_dev->dev;
212 urb = usb_alloc_urb(0, GFP_KERNEL);
213 if (!urb) {
214 ret = -ENOMEM;
215 goto error;
218 buffer = usb_alloc_coherent(dev, buffer_len,
219 GFP_KERNEL, &urb->transfer_dma);
220 if (!buffer) {
221 ret = -ENOMEM;
222 goto error_buffer;
224 usb_fill_int_urb(urb, dev,
225 usb_rcvintpipe(dev, ep->bEndpointAddress),
226 buffer, buffer_len,
227 int_irq, (void *)gspca_dev, interval);
228 urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
229 ret = usb_submit_urb(urb, GFP_KERNEL);
230 if (ret < 0) {
231 PDEBUG(D_ERR, "submit int URB failed with error %i", ret);
232 goto error_submit;
234 gspca_dev->int_urb = urb;
235 return ret;
237 error_submit:
238 usb_free_coherent(dev,
239 urb->transfer_buffer_length,
240 urb->transfer_buffer,
241 urb->transfer_dma);
242 error_buffer:
243 usb_free_urb(urb);
244 error:
245 return ret;
248 static void gspca_input_create_urb(struct gspca_dev *gspca_dev)
250 struct usb_interface *intf;
251 struct usb_host_interface *intf_desc;
252 struct usb_endpoint_descriptor *ep;
253 int i;
255 if (gspca_dev->sd_desc->int_pkt_scan) {
256 intf = usb_ifnum_to_if(gspca_dev->dev, gspca_dev->iface);
257 intf_desc = intf->cur_altsetting;
258 for (i = 0; i < intf_desc->desc.bNumEndpoints; i++) {
259 ep = &intf_desc->endpoint[i].desc;
260 if (usb_endpoint_dir_in(ep) &&
261 usb_endpoint_xfer_int(ep)) {
263 alloc_and_submit_int_urb(gspca_dev, ep);
264 break;
270 static void gspca_input_destroy_urb(struct gspca_dev *gspca_dev)
272 struct urb *urb;
274 urb = gspca_dev->int_urb;
275 if (urb) {
276 gspca_dev->int_urb = NULL;
277 usb_kill_urb(urb);
278 usb_free_coherent(gspca_dev->dev,
279 urb->transfer_buffer_length,
280 urb->transfer_buffer,
281 urb->transfer_dma);
282 usb_free_urb(urb);
285 #else
286 static inline void gspca_input_destroy_urb(struct gspca_dev *gspca_dev)
290 static inline void gspca_input_create_urb(struct gspca_dev *gspca_dev)
294 static inline int gspca_input_connect(struct gspca_dev *dev)
296 return 0;
298 #endif
301 * fill a video frame from an URB and resubmit
303 static void fill_frame(struct gspca_dev *gspca_dev,
304 struct urb *urb)
306 u8 *data; /* address of data in the iso message */
307 int i, len, st;
308 cam_pkt_op pkt_scan;
310 if (urb->status != 0) {
311 if (urb->status == -ESHUTDOWN)
312 return; /* disconnection */
313 #ifdef CONFIG_PM
314 if (gspca_dev->frozen)
315 return;
316 #endif
317 PDEBUG(D_ERR|D_PACK, "urb status: %d", urb->status);
318 urb->status = 0;
319 goto resubmit;
321 pkt_scan = gspca_dev->sd_desc->pkt_scan;
322 for (i = 0; i < urb->number_of_packets; i++) {
323 len = urb->iso_frame_desc[i].actual_length;
325 /* check the packet status and length */
326 st = urb->iso_frame_desc[i].status;
327 if (st) {
328 pr_err("ISOC data error: [%d] len=%d, status=%d\n",
329 i, len, st);
330 gspca_dev->last_packet_type = DISCARD_PACKET;
331 continue;
333 if (len == 0) {
334 if (gspca_dev->empty_packet == 0)
335 gspca_dev->empty_packet = 1;
336 continue;
339 /* let the packet be analyzed by the subdriver */
340 PDEBUG(D_PACK, "packet [%d] o:%d l:%d",
341 i, urb->iso_frame_desc[i].offset, len);
342 data = (u8 *) urb->transfer_buffer
343 + urb->iso_frame_desc[i].offset;
344 pkt_scan(gspca_dev, data, len);
347 resubmit:
348 /* resubmit the URB */
349 st = usb_submit_urb(urb, GFP_ATOMIC);
350 if (st < 0)
351 pr_err("usb_submit_urb() ret %d\n", st);
355 * ISOC message interrupt from the USB device
357 * Analyse each packet and call the subdriver for copy to the frame buffer.
359 static void isoc_irq(struct urb *urb)
361 struct gspca_dev *gspca_dev = (struct gspca_dev *) urb->context;
363 PDEBUG(D_PACK, "isoc irq");
364 if (!gspca_dev->streaming)
365 return;
366 fill_frame(gspca_dev, urb);
370 * bulk message interrupt from the USB device
372 static void bulk_irq(struct urb *urb)
374 struct gspca_dev *gspca_dev = (struct gspca_dev *) urb->context;
375 int st;
377 PDEBUG(D_PACK, "bulk irq");
378 if (!gspca_dev->streaming)
379 return;
380 switch (urb->status) {
381 case 0:
382 break;
383 case -ESHUTDOWN:
384 return; /* disconnection */
385 default:
386 #ifdef CONFIG_PM
387 if (gspca_dev->frozen)
388 return;
389 #endif
390 PDEBUG(D_ERR|D_PACK, "urb status: %d", urb->status);
391 urb->status = 0;
392 goto resubmit;
395 PDEBUG(D_PACK, "packet l:%d", urb->actual_length);
396 gspca_dev->sd_desc->pkt_scan(gspca_dev,
397 urb->transfer_buffer,
398 urb->actual_length);
400 resubmit:
401 /* resubmit the URB */
402 if (gspca_dev->cam.bulk_nurbs != 0) {
403 st = usb_submit_urb(urb, GFP_ATOMIC);
404 if (st < 0)
405 pr_err("usb_submit_urb() ret %d\n", st);
410 * add data to the current frame
412 * This function is called by the subdrivers at interrupt level.
414 * To build a frame, these ones must add
415 * - one FIRST_PACKET
416 * - 0 or many INTER_PACKETs
417 * - one LAST_PACKET
418 * DISCARD_PACKET invalidates the whole frame.
420 void gspca_frame_add(struct gspca_dev *gspca_dev,
421 enum gspca_packet_type packet_type,
422 const u8 *data,
423 int len)
425 struct gspca_frame *frame;
426 int i, j;
428 PDEBUG(D_PACK, "add t:%d l:%d", packet_type, len);
430 if (packet_type == FIRST_PACKET) {
431 i = atomic_read(&gspca_dev->fr_i);
433 /* if there are no queued buffer, discard the whole frame */
434 if (i == atomic_read(&gspca_dev->fr_q)) {
435 gspca_dev->last_packet_type = DISCARD_PACKET;
436 gspca_dev->sequence++;
437 return;
439 j = gspca_dev->fr_queue[i];
440 frame = &gspca_dev->frame[j];
441 frame->v4l2_buf.timestamp = ktime_to_timeval(ktime_get());
442 frame->v4l2_buf.sequence = gspca_dev->sequence++;
443 gspca_dev->image = frame->data;
444 gspca_dev->image_len = 0;
445 } else {
446 switch (gspca_dev->last_packet_type) {
447 case DISCARD_PACKET:
448 if (packet_type == LAST_PACKET) {
449 gspca_dev->last_packet_type = packet_type;
450 gspca_dev->image = NULL;
451 gspca_dev->image_len = 0;
453 return;
454 case LAST_PACKET:
455 return;
459 /* append the packet to the frame buffer */
460 if (len > 0) {
461 if (gspca_dev->image_len + len > gspca_dev->frsz) {
462 PDEBUG(D_ERR|D_PACK, "frame overflow %d > %d",
463 gspca_dev->image_len + len,
464 gspca_dev->frsz);
465 packet_type = DISCARD_PACKET;
466 } else {
467 /* !! image is NULL only when last pkt is LAST or DISCARD
468 if (gspca_dev->image == NULL) {
469 pr_err("gspca_frame_add() image == NULL\n");
470 return;
473 memcpy(gspca_dev->image + gspca_dev->image_len,
474 data, len);
475 gspca_dev->image_len += len;
478 gspca_dev->last_packet_type = packet_type;
480 /* if last packet, invalidate packet concatenation until
481 * next first packet, wake up the application and advance
482 * in the queue */
483 if (packet_type == LAST_PACKET) {
484 i = atomic_read(&gspca_dev->fr_i);
485 j = gspca_dev->fr_queue[i];
486 frame = &gspca_dev->frame[j];
487 frame->v4l2_buf.bytesused = gspca_dev->image_len;
488 frame->v4l2_buf.flags = (frame->v4l2_buf.flags
489 | V4L2_BUF_FLAG_DONE)
490 & ~V4L2_BUF_FLAG_QUEUED;
491 i = (i + 1) % GSPCA_MAX_FRAMES;
492 atomic_set(&gspca_dev->fr_i, i);
493 wake_up_interruptible(&gspca_dev->wq); /* event = new frame */
494 PDEBUG(D_FRAM, "frame complete len:%d",
495 frame->v4l2_buf.bytesused);
496 gspca_dev->image = NULL;
497 gspca_dev->image_len = 0;
500 EXPORT_SYMBOL(gspca_frame_add);
502 static int gspca_is_compressed(__u32 format)
504 switch (format) {
505 case V4L2_PIX_FMT_MJPEG:
506 case V4L2_PIX_FMT_JPEG:
507 case V4L2_PIX_FMT_SPCA561:
508 case V4L2_PIX_FMT_PAC207:
509 case V4L2_PIX_FMT_MR97310A:
510 return 1;
512 return 0;
515 static int frame_alloc(struct gspca_dev *gspca_dev, struct file *file,
516 enum v4l2_memory memory, unsigned int count)
518 struct gspca_frame *frame;
519 unsigned int frsz;
520 int i;
522 i = gspca_dev->curr_mode;
523 frsz = gspca_dev->cam.cam_mode[i].sizeimage;
524 PDEBUG(D_STREAM, "frame alloc frsz: %d", frsz);
525 frsz = PAGE_ALIGN(frsz);
526 if (count >= GSPCA_MAX_FRAMES)
527 count = GSPCA_MAX_FRAMES - 1;
528 gspca_dev->frbuf = vmalloc_32(frsz * count);
529 if (!gspca_dev->frbuf) {
530 pr_err("frame alloc failed\n");
531 return -ENOMEM;
533 gspca_dev->capt_file = file;
534 gspca_dev->memory = memory;
535 gspca_dev->frsz = frsz;
536 gspca_dev->nframes = count;
537 for (i = 0; i < count; i++) {
538 frame = &gspca_dev->frame[i];
539 frame->v4l2_buf.index = i;
540 frame->v4l2_buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
541 frame->v4l2_buf.flags = 0;
542 frame->v4l2_buf.field = V4L2_FIELD_NONE;
543 frame->v4l2_buf.length = frsz;
544 frame->v4l2_buf.memory = memory;
545 frame->v4l2_buf.sequence = 0;
546 frame->data = gspca_dev->frbuf + i * frsz;
547 frame->v4l2_buf.m.offset = i * frsz;
549 atomic_set(&gspca_dev->fr_q, 0);
550 atomic_set(&gspca_dev->fr_i, 0);
551 gspca_dev->fr_o = 0;
552 return 0;
555 static void frame_free(struct gspca_dev *gspca_dev)
557 int i;
559 PDEBUG(D_STREAM, "frame free");
560 if (gspca_dev->frbuf != NULL) {
561 vfree(gspca_dev->frbuf);
562 gspca_dev->frbuf = NULL;
563 for (i = 0; i < gspca_dev->nframes; i++)
564 gspca_dev->frame[i].data = NULL;
566 gspca_dev->nframes = 0;
567 gspca_dev->frsz = 0;
568 gspca_dev->capt_file = NULL;
569 gspca_dev->memory = GSPCA_MEMORY_NO;
572 static void destroy_urbs(struct gspca_dev *gspca_dev)
574 struct urb *urb;
575 unsigned int i;
577 PDEBUG(D_STREAM, "kill transfer");
578 for (i = 0; i < MAX_NURBS; i++) {
579 urb = gspca_dev->urb[i];
580 if (urb == NULL)
581 break;
583 gspca_dev->urb[i] = NULL;
584 usb_kill_urb(urb);
585 if (urb->transfer_buffer != NULL)
586 usb_free_coherent(gspca_dev->dev,
587 urb->transfer_buffer_length,
588 urb->transfer_buffer,
589 urb->transfer_dma);
590 usb_free_urb(urb);
594 static int gspca_set_alt0(struct gspca_dev *gspca_dev)
596 int ret;
598 if (gspca_dev->alt == 0)
599 return 0;
600 ret = usb_set_interface(gspca_dev->dev, gspca_dev->iface, 0);
601 if (ret < 0)
602 pr_err("set alt 0 err %d\n", ret);
603 return ret;
606 /* Note: both the queue and the usb locks should be held when calling this */
607 static void gspca_stream_off(struct gspca_dev *gspca_dev)
609 gspca_dev->streaming = 0;
610 if (gspca_dev->present) {
611 if (gspca_dev->sd_desc->stopN)
612 gspca_dev->sd_desc->stopN(gspca_dev);
613 destroy_urbs(gspca_dev);
614 gspca_input_destroy_urb(gspca_dev);
615 gspca_set_alt0(gspca_dev);
616 gspca_input_create_urb(gspca_dev);
619 /* always call stop0 to free the subdriver's resources */
620 if (gspca_dev->sd_desc->stop0)
621 gspca_dev->sd_desc->stop0(gspca_dev);
622 PDEBUG(D_STREAM, "stream off OK");
626 * look for an input transfer endpoint in an alternate setting
628 static struct usb_host_endpoint *alt_xfer(struct usb_host_interface *alt,
629 int xfer)
631 struct usb_host_endpoint *ep;
632 int i, attr;
634 for (i = 0; i < alt->desc.bNumEndpoints; i++) {
635 ep = &alt->endpoint[i];
636 attr = ep->desc.bmAttributes & USB_ENDPOINT_XFERTYPE_MASK;
637 if (attr == xfer
638 && ep->desc.wMaxPacketSize != 0
639 && usb_endpoint_dir_in(&ep->desc))
640 return ep;
642 return NULL;
646 * look for an input (isoc or bulk) endpoint
648 * The endpoint is defined by the subdriver.
649 * Use only the first isoc (some Zoran - 0x0572:0x0001 - have two such ep).
650 * This routine may be called many times when the bandwidth is too small
651 * (the bandwidth is checked on urb submit).
653 static struct usb_host_endpoint *get_ep(struct gspca_dev *gspca_dev)
655 struct usb_interface *intf;
656 struct usb_host_endpoint *ep;
657 int xfer, i, ret;
659 intf = usb_ifnum_to_if(gspca_dev->dev, gspca_dev->iface);
660 ep = NULL;
661 xfer = gspca_dev->cam.bulk ? USB_ENDPOINT_XFER_BULK
662 : USB_ENDPOINT_XFER_ISOC;
663 i = gspca_dev->alt; /* previous alt setting */
664 if (gspca_dev->cam.reverse_alts) {
665 while (++i < gspca_dev->nbalt) {
666 ep = alt_xfer(&intf->altsetting[i], xfer);
667 if (ep)
668 break;
670 } else {
671 while (--i >= 0) {
672 ep = alt_xfer(&intf->altsetting[i], xfer);
673 if (ep)
674 break;
677 if (ep == NULL) {
678 pr_err("no transfer endpoint found\n");
679 return NULL;
681 PDEBUG(D_STREAM, "use alt %d ep 0x%02x",
682 i, ep->desc.bEndpointAddress);
683 gspca_dev->alt = i; /* memorize the current alt setting */
684 if (gspca_dev->nbalt > 1) {
685 ret = usb_set_interface(gspca_dev->dev, gspca_dev->iface, i);
686 if (ret < 0) {
687 pr_err("set alt %d err %d\n", i, ret);
688 ep = NULL;
691 return ep;
695 * create the URBs for image transfer
697 static int create_urbs(struct gspca_dev *gspca_dev,
698 struct usb_host_endpoint *ep)
700 struct urb *urb;
701 int n, nurbs, i, psize, npkt, bsize;
703 /* calculate the packet size and the number of packets */
704 psize = le16_to_cpu(ep->desc.wMaxPacketSize);
706 if (!gspca_dev->cam.bulk) { /* isoc */
708 /* See paragraph 5.9 / table 5-11 of the usb 2.0 spec. */
709 if (gspca_dev->pkt_size == 0)
710 psize = (psize & 0x07ff) * (1 + ((psize >> 11) & 3));
711 else
712 psize = gspca_dev->pkt_size;
713 npkt = gspca_dev->cam.npkt;
714 if (npkt == 0)
715 npkt = 32; /* default value */
716 bsize = psize * npkt;
717 PDEBUG(D_STREAM,
718 "isoc %d pkts size %d = bsize:%d",
719 npkt, psize, bsize);
720 nurbs = DEF_NURBS;
721 } else { /* bulk */
722 npkt = 0;
723 bsize = gspca_dev->cam.bulk_size;
724 if (bsize == 0)
725 bsize = psize;
726 PDEBUG(D_STREAM, "bulk bsize:%d", bsize);
727 if (gspca_dev->cam.bulk_nurbs != 0)
728 nurbs = gspca_dev->cam.bulk_nurbs;
729 else
730 nurbs = 1;
733 for (n = 0; n < nurbs; n++) {
734 urb = usb_alloc_urb(npkt, GFP_KERNEL);
735 if (!urb) {
736 pr_err("usb_alloc_urb failed\n");
737 return -ENOMEM;
739 gspca_dev->urb[n] = urb;
740 urb->transfer_buffer = usb_alloc_coherent(gspca_dev->dev,
741 bsize,
742 GFP_KERNEL,
743 &urb->transfer_dma);
745 if (urb->transfer_buffer == NULL) {
746 pr_err("usb_alloc_coherent failed\n");
747 return -ENOMEM;
749 urb->dev = gspca_dev->dev;
750 urb->context = gspca_dev;
751 urb->transfer_buffer_length = bsize;
752 if (npkt != 0) { /* ISOC */
753 urb->pipe = usb_rcvisocpipe(gspca_dev->dev,
754 ep->desc.bEndpointAddress);
755 urb->transfer_flags = URB_ISO_ASAP
756 | URB_NO_TRANSFER_DMA_MAP;
757 urb->interval = ep->desc.bInterval;
758 urb->complete = isoc_irq;
759 urb->number_of_packets = npkt;
760 for (i = 0; i < npkt; i++) {
761 urb->iso_frame_desc[i].length = psize;
762 urb->iso_frame_desc[i].offset = psize * i;
764 } else { /* bulk */
765 urb->pipe = usb_rcvbulkpipe(gspca_dev->dev,
766 ep->desc.bEndpointAddress);
767 urb->transfer_flags = URB_NO_TRANSFER_DMA_MAP;
768 urb->complete = bulk_irq;
771 return 0;
775 * start the USB transfer
777 static int gspca_init_transfer(struct gspca_dev *gspca_dev)
779 struct usb_host_endpoint *ep;
780 struct urb *urb;
781 int n, ret;
783 if (mutex_lock_interruptible(&gspca_dev->usb_lock))
784 return -ERESTARTSYS;
786 if (!gspca_dev->present) {
787 ret = -ENODEV;
788 goto unlock;
791 /* reset the streaming variables */
792 gspca_dev->image = NULL;
793 gspca_dev->image_len = 0;
794 gspca_dev->last_packet_type = DISCARD_PACKET;
795 gspca_dev->sequence = 0;
797 gspca_dev->usb_err = 0;
799 /* set the higher alternate setting and
800 * loop until urb submit succeeds */
801 if (gspca_dev->cam.reverse_alts)
802 gspca_dev->alt = 0;
803 else
804 gspca_dev->alt = gspca_dev->nbalt;
806 if (gspca_dev->sd_desc->isoc_init) {
807 ret = gspca_dev->sd_desc->isoc_init(gspca_dev);
808 if (ret < 0)
809 goto unlock;
812 gspca_input_destroy_urb(gspca_dev);
813 ep = get_ep(gspca_dev);
814 if (ep == NULL) {
815 ret = -EIO;
816 goto out;
818 for (;;) {
819 if (!gspca_dev->cam.no_urb_create) {
820 PDEBUG(D_STREAM, "init transfer alt %d",
821 gspca_dev->alt);
822 ret = create_urbs(gspca_dev, ep);
823 if (ret < 0) {
824 destroy_urbs(gspca_dev);
825 goto out;
829 /* clear the bulk endpoint */
830 if (gspca_dev->cam.bulk)
831 usb_clear_halt(gspca_dev->dev,
832 gspca_dev->urb[0]->pipe);
834 /* start the cam */
835 ret = gspca_dev->sd_desc->start(gspca_dev);
836 if (ret < 0) {
837 destroy_urbs(gspca_dev);
838 goto out;
840 gspca_dev->streaming = 1;
842 /* some bulk transfers are started by the subdriver */
843 if (gspca_dev->cam.bulk && gspca_dev->cam.bulk_nurbs == 0)
844 break;
846 /* submit the URBs */
847 for (n = 0; n < MAX_NURBS; n++) {
848 urb = gspca_dev->urb[n];
849 if (urb == NULL)
850 break;
851 ret = usb_submit_urb(urb, GFP_KERNEL);
852 if (ret < 0)
853 break;
855 if (ret >= 0)
856 break;
857 gspca_stream_off(gspca_dev);
858 if (ret != -ENOSPC) {
859 pr_err("usb_submit_urb alt %d err %d\n",
860 gspca_dev->alt, ret);
861 goto out;
864 /* the bandwidth is not wide enough
865 * negotiate or try a lower alternate setting */
866 PDEBUG(D_ERR|D_STREAM,
867 "bandwidth not wide enough - trying again");
868 msleep(20); /* wait for kill complete */
869 if (gspca_dev->sd_desc->isoc_nego) {
870 ret = gspca_dev->sd_desc->isoc_nego(gspca_dev);
871 if (ret < 0)
872 goto out;
873 } else {
874 ep = get_ep(gspca_dev);
875 if (ep == NULL) {
876 ret = -EIO;
877 goto out;
881 out:
882 gspca_input_create_urb(gspca_dev);
883 unlock:
884 mutex_unlock(&gspca_dev->usb_lock);
885 return ret;
888 static void gspca_set_default_mode(struct gspca_dev *gspca_dev)
890 struct gspca_ctrl *ctrl;
891 int i;
893 i = gspca_dev->cam.nmodes - 1; /* take the highest mode */
894 gspca_dev->curr_mode = i;
895 gspca_dev->width = gspca_dev->cam.cam_mode[i].width;
896 gspca_dev->height = gspca_dev->cam.cam_mode[i].height;
897 gspca_dev->pixfmt = gspca_dev->cam.cam_mode[i].pixelformat;
899 /* set the current control values to their default values
900 * which may have changed in sd_init() */
901 ctrl = gspca_dev->cam.ctrls;
902 if (ctrl != NULL) {
903 for (i = 0;
904 i < gspca_dev->sd_desc->nctrls;
905 i++, ctrl++)
906 ctrl->val = ctrl->def;
910 static int wxh_to_mode(struct gspca_dev *gspca_dev,
911 int width, int height)
913 int i;
915 for (i = gspca_dev->cam.nmodes; --i > 0; ) {
916 if (width >= gspca_dev->cam.cam_mode[i].width
917 && height >= gspca_dev->cam.cam_mode[i].height)
918 break;
920 return i;
924 * search a mode with the right pixel format
926 static int gspca_get_mode(struct gspca_dev *gspca_dev,
927 int mode,
928 int pixfmt)
930 int modeU, modeD;
932 modeU = modeD = mode;
933 while ((modeU < gspca_dev->cam.nmodes) || modeD >= 0) {
934 if (--modeD >= 0) {
935 if (gspca_dev->cam.cam_mode[modeD].pixelformat
936 == pixfmt)
937 return modeD;
939 if (++modeU < gspca_dev->cam.nmodes) {
940 if (gspca_dev->cam.cam_mode[modeU].pixelformat
941 == pixfmt)
942 return modeU;
945 return -EINVAL;
948 #ifdef CONFIG_VIDEO_ADV_DEBUG
949 static int vidioc_g_register(struct file *file, void *priv,
950 struct v4l2_dbg_register *reg)
952 int ret;
953 struct gspca_dev *gspca_dev = priv;
955 if (!gspca_dev->sd_desc->get_chip_ident)
956 return -EINVAL;
958 if (!gspca_dev->sd_desc->get_register)
959 return -EINVAL;
961 if (mutex_lock_interruptible(&gspca_dev->usb_lock))
962 return -ERESTARTSYS;
963 gspca_dev->usb_err = 0;
964 if (gspca_dev->present)
965 ret = gspca_dev->sd_desc->get_register(gspca_dev, reg);
966 else
967 ret = -ENODEV;
968 mutex_unlock(&gspca_dev->usb_lock);
970 return ret;
973 static int vidioc_s_register(struct file *file, void *priv,
974 struct v4l2_dbg_register *reg)
976 int ret;
977 struct gspca_dev *gspca_dev = priv;
979 if (!gspca_dev->sd_desc->get_chip_ident)
980 return -EINVAL;
982 if (!gspca_dev->sd_desc->set_register)
983 return -EINVAL;
985 if (mutex_lock_interruptible(&gspca_dev->usb_lock))
986 return -ERESTARTSYS;
987 gspca_dev->usb_err = 0;
988 if (gspca_dev->present)
989 ret = gspca_dev->sd_desc->set_register(gspca_dev, reg);
990 else
991 ret = -ENODEV;
992 mutex_unlock(&gspca_dev->usb_lock);
994 return ret;
996 #endif
998 static int vidioc_g_chip_ident(struct file *file, void *priv,
999 struct v4l2_dbg_chip_ident *chip)
1001 int ret;
1002 struct gspca_dev *gspca_dev = priv;
1004 if (!gspca_dev->sd_desc->get_chip_ident)
1005 return -EINVAL;
1007 if (mutex_lock_interruptible(&gspca_dev->usb_lock))
1008 return -ERESTARTSYS;
1009 gspca_dev->usb_err = 0;
1010 if (gspca_dev->present)
1011 ret = gspca_dev->sd_desc->get_chip_ident(gspca_dev, chip);
1012 else
1013 ret = -ENODEV;
1014 mutex_unlock(&gspca_dev->usb_lock);
1016 return ret;
1019 static int vidioc_enum_fmt_vid_cap(struct file *file, void *priv,
1020 struct v4l2_fmtdesc *fmtdesc)
1022 struct gspca_dev *gspca_dev = priv;
1023 int i, j, index;
1024 __u32 fmt_tb[8];
1026 /* give an index to each format */
1027 index = 0;
1028 j = 0;
1029 for (i = gspca_dev->cam.nmodes; --i >= 0; ) {
1030 fmt_tb[index] = gspca_dev->cam.cam_mode[i].pixelformat;
1031 j = 0;
1032 for (;;) {
1033 if (fmt_tb[j] == fmt_tb[index])
1034 break;
1035 j++;
1037 if (j == index) {
1038 if (fmtdesc->index == index)
1039 break; /* new format */
1040 index++;
1041 if (index >= ARRAY_SIZE(fmt_tb))
1042 return -EINVAL;
1045 if (i < 0)
1046 return -EINVAL; /* no more format */
1048 fmtdesc->pixelformat = fmt_tb[index];
1049 if (gspca_is_compressed(fmt_tb[index]))
1050 fmtdesc->flags = V4L2_FMT_FLAG_COMPRESSED;
1051 fmtdesc->description[0] = fmtdesc->pixelformat & 0xff;
1052 fmtdesc->description[1] = (fmtdesc->pixelformat >> 8) & 0xff;
1053 fmtdesc->description[2] = (fmtdesc->pixelformat >> 16) & 0xff;
1054 fmtdesc->description[3] = fmtdesc->pixelformat >> 24;
1055 fmtdesc->description[4] = '\0';
1056 return 0;
1059 static int vidioc_g_fmt_vid_cap(struct file *file, void *priv,
1060 struct v4l2_format *fmt)
1062 struct gspca_dev *gspca_dev = priv;
1063 int mode;
1065 mode = gspca_dev->curr_mode;
1066 memcpy(&fmt->fmt.pix, &gspca_dev->cam.cam_mode[mode],
1067 sizeof fmt->fmt.pix);
1068 return 0;
1071 static int try_fmt_vid_cap(struct gspca_dev *gspca_dev,
1072 struct v4l2_format *fmt)
1074 int w, h, mode, mode2;
1076 w = fmt->fmt.pix.width;
1077 h = fmt->fmt.pix.height;
1079 #ifdef GSPCA_DEBUG
1080 if (gspca_debug & D_CONF)
1081 PDEBUG_MODE("try fmt cap", fmt->fmt.pix.pixelformat, w, h);
1082 #endif
1083 /* search the closest mode for width and height */
1084 mode = wxh_to_mode(gspca_dev, w, h);
1086 /* OK if right palette */
1087 if (gspca_dev->cam.cam_mode[mode].pixelformat
1088 != fmt->fmt.pix.pixelformat) {
1090 /* else, search the closest mode with the same pixel format */
1091 mode2 = gspca_get_mode(gspca_dev, mode,
1092 fmt->fmt.pix.pixelformat);
1093 if (mode2 >= 0)
1094 mode = mode2;
1095 /* else
1096 ; * no chance, return this mode */
1098 memcpy(&fmt->fmt.pix, &gspca_dev->cam.cam_mode[mode],
1099 sizeof fmt->fmt.pix);
1100 return mode; /* used when s_fmt */
1103 static int vidioc_try_fmt_vid_cap(struct file *file,
1104 void *priv,
1105 struct v4l2_format *fmt)
1107 struct gspca_dev *gspca_dev = priv;
1108 int ret;
1110 ret = try_fmt_vid_cap(gspca_dev, fmt);
1111 if (ret < 0)
1112 return ret;
1113 return 0;
1116 static int vidioc_s_fmt_vid_cap(struct file *file, void *priv,
1117 struct v4l2_format *fmt)
1119 struct gspca_dev *gspca_dev = priv;
1120 int ret;
1122 if (mutex_lock_interruptible(&gspca_dev->queue_lock))
1123 return -ERESTARTSYS;
1125 ret = try_fmt_vid_cap(gspca_dev, fmt);
1126 if (ret < 0)
1127 goto out;
1129 if (gspca_dev->nframes != 0
1130 && fmt->fmt.pix.sizeimage > gspca_dev->frsz) {
1131 ret = -EINVAL;
1132 goto out;
1135 if (ret == gspca_dev->curr_mode) {
1136 ret = 0;
1137 goto out; /* same mode */
1140 if (gspca_dev->streaming) {
1141 ret = -EBUSY;
1142 goto out;
1144 gspca_dev->width = fmt->fmt.pix.width;
1145 gspca_dev->height = fmt->fmt.pix.height;
1146 gspca_dev->pixfmt = fmt->fmt.pix.pixelformat;
1147 gspca_dev->curr_mode = ret;
1149 ret = 0;
1150 out:
1151 mutex_unlock(&gspca_dev->queue_lock);
1152 return ret;
1155 static int vidioc_enum_framesizes(struct file *file, void *priv,
1156 struct v4l2_frmsizeenum *fsize)
1158 struct gspca_dev *gspca_dev = priv;
1159 int i;
1160 __u32 index = 0;
1162 for (i = 0; i < gspca_dev->cam.nmodes; i++) {
1163 if (fsize->pixel_format !=
1164 gspca_dev->cam.cam_mode[i].pixelformat)
1165 continue;
1167 if (fsize->index == index) {
1168 fsize->type = V4L2_FRMSIZE_TYPE_DISCRETE;
1169 fsize->discrete.width =
1170 gspca_dev->cam.cam_mode[i].width;
1171 fsize->discrete.height =
1172 gspca_dev->cam.cam_mode[i].height;
1173 return 0;
1175 index++;
1178 return -EINVAL;
1181 static int vidioc_enum_frameintervals(struct file *filp, void *priv,
1182 struct v4l2_frmivalenum *fival)
1184 struct gspca_dev *gspca_dev = priv;
1185 int mode = wxh_to_mode(gspca_dev, fival->width, fival->height);
1186 __u32 i;
1188 if (gspca_dev->cam.mode_framerates == NULL ||
1189 gspca_dev->cam.mode_framerates[mode].nrates == 0)
1190 return -EINVAL;
1192 if (fival->pixel_format !=
1193 gspca_dev->cam.cam_mode[mode].pixelformat)
1194 return -EINVAL;
1196 for (i = 0; i < gspca_dev->cam.mode_framerates[mode].nrates; i++) {
1197 if (fival->index == i) {
1198 fival->type = V4L2_FRMSIZE_TYPE_DISCRETE;
1199 fival->discrete.numerator = 1;
1200 fival->discrete.denominator =
1201 gspca_dev->cam.mode_framerates[mode].rates[i];
1202 return 0;
1206 return -EINVAL;
1209 static void gspca_release(struct video_device *vfd)
1211 struct gspca_dev *gspca_dev = container_of(vfd, struct gspca_dev, vdev);
1213 PDEBUG(D_PROBE, "%s released",
1214 video_device_node_name(&gspca_dev->vdev));
1216 kfree(gspca_dev->usb_buf);
1217 kfree(gspca_dev);
1220 static int dev_open(struct file *file)
1222 struct gspca_dev *gspca_dev;
1224 PDEBUG(D_STREAM, "[%s] open", current->comm);
1225 gspca_dev = (struct gspca_dev *) video_devdata(file);
1226 if (!gspca_dev->present)
1227 return -ENODEV;
1229 /* protect the subdriver against rmmod */
1230 if (!try_module_get(gspca_dev->module))
1231 return -ENODEV;
1233 file->private_data = gspca_dev;
1234 #ifdef GSPCA_DEBUG
1235 /* activate the v4l2 debug */
1236 if (gspca_debug & D_V4L2)
1237 gspca_dev->vdev.debug |= V4L2_DEBUG_IOCTL
1238 | V4L2_DEBUG_IOCTL_ARG;
1239 else
1240 gspca_dev->vdev.debug &= ~(V4L2_DEBUG_IOCTL
1241 | V4L2_DEBUG_IOCTL_ARG);
1242 #endif
1243 return 0;
1246 static int dev_close(struct file *file)
1248 struct gspca_dev *gspca_dev = file->private_data;
1250 PDEBUG(D_STREAM, "[%s] close", current->comm);
1251 if (mutex_lock_interruptible(&gspca_dev->queue_lock))
1252 return -ERESTARTSYS;
1254 /* if the file did the capture, free the streaming resources */
1255 if (gspca_dev->capt_file == file) {
1256 if (gspca_dev->streaming) {
1257 mutex_lock(&gspca_dev->usb_lock);
1258 gspca_dev->usb_err = 0;
1259 gspca_stream_off(gspca_dev);
1260 mutex_unlock(&gspca_dev->usb_lock);
1262 frame_free(gspca_dev);
1264 file->private_data = NULL;
1265 module_put(gspca_dev->module);
1266 mutex_unlock(&gspca_dev->queue_lock);
1268 PDEBUG(D_STREAM, "close done");
1270 return 0;
1273 static int vidioc_querycap(struct file *file, void *priv,
1274 struct v4l2_capability *cap)
1276 struct gspca_dev *gspca_dev = priv;
1277 int ret;
1279 /* protect the access to the usb device */
1280 if (mutex_lock_interruptible(&gspca_dev->usb_lock))
1281 return -ERESTARTSYS;
1282 if (!gspca_dev->present) {
1283 ret = -ENODEV;
1284 goto out;
1286 strlcpy((char *) cap->driver, gspca_dev->sd_desc->name,
1287 sizeof cap->driver);
1288 if (gspca_dev->dev->product != NULL) {
1289 strlcpy((char *) cap->card, gspca_dev->dev->product,
1290 sizeof cap->card);
1291 } else {
1292 snprintf((char *) cap->card, sizeof cap->card,
1293 "USB Camera (%04x:%04x)",
1294 le16_to_cpu(gspca_dev->dev->descriptor.idVendor),
1295 le16_to_cpu(gspca_dev->dev->descriptor.idProduct));
1297 usb_make_path(gspca_dev->dev, (char *) cap->bus_info,
1298 sizeof(cap->bus_info));
1299 cap->capabilities = V4L2_CAP_VIDEO_CAPTURE
1300 | V4L2_CAP_STREAMING
1301 | V4L2_CAP_READWRITE;
1302 ret = 0;
1303 out:
1304 mutex_unlock(&gspca_dev->usb_lock);
1305 return ret;
1308 static int get_ctrl(struct gspca_dev *gspca_dev,
1309 int id)
1311 const struct ctrl *ctrls;
1312 int i;
1314 for (i = 0, ctrls = gspca_dev->sd_desc->ctrls;
1315 i < gspca_dev->sd_desc->nctrls;
1316 i++, ctrls++) {
1317 if (gspca_dev->ctrl_dis & (1 << i))
1318 continue;
1319 if (id == ctrls->qctrl.id)
1320 return i;
1322 return -1;
1325 static int vidioc_queryctrl(struct file *file, void *priv,
1326 struct v4l2_queryctrl *q_ctrl)
1328 struct gspca_dev *gspca_dev = priv;
1329 const struct ctrl *ctrls;
1330 struct gspca_ctrl *gspca_ctrl;
1331 int i, idx;
1332 u32 id;
1334 id = q_ctrl->id;
1335 if (id & V4L2_CTRL_FLAG_NEXT_CTRL) {
1336 id &= V4L2_CTRL_ID_MASK;
1337 id++;
1338 idx = -1;
1339 for (i = 0; i < gspca_dev->sd_desc->nctrls; i++) {
1340 if (gspca_dev->ctrl_dis & (1 << i))
1341 continue;
1342 if (gspca_dev->sd_desc->ctrls[i].qctrl.id < id)
1343 continue;
1344 if (idx >= 0
1345 && gspca_dev->sd_desc->ctrls[i].qctrl.id
1346 > gspca_dev->sd_desc->ctrls[idx].qctrl.id)
1347 continue;
1348 idx = i;
1350 } else {
1351 idx = get_ctrl(gspca_dev, id);
1353 if (idx < 0)
1354 return -EINVAL;
1355 ctrls = &gspca_dev->sd_desc->ctrls[idx];
1356 memcpy(q_ctrl, &ctrls->qctrl, sizeof *q_ctrl);
1357 if (gspca_dev->cam.ctrls != NULL) {
1358 gspca_ctrl = &gspca_dev->cam.ctrls[idx];
1359 q_ctrl->default_value = gspca_ctrl->def;
1360 q_ctrl->minimum = gspca_ctrl->min;
1361 q_ctrl->maximum = gspca_ctrl->max;
1363 if (gspca_dev->ctrl_inac & (1 << idx))
1364 q_ctrl->flags |= V4L2_CTRL_FLAG_INACTIVE;
1365 return 0;
1368 static int vidioc_s_ctrl(struct file *file, void *priv,
1369 struct v4l2_control *ctrl)
1371 struct gspca_dev *gspca_dev = priv;
1372 const struct ctrl *ctrls;
1373 struct gspca_ctrl *gspca_ctrl;
1374 int idx, ret;
1376 idx = get_ctrl(gspca_dev, ctrl->id);
1377 if (idx < 0)
1378 return -EINVAL;
1379 if (gspca_dev->ctrl_inac & (1 << idx))
1380 return -EINVAL;
1381 ctrls = &gspca_dev->sd_desc->ctrls[idx];
1382 if (gspca_dev->cam.ctrls != NULL) {
1383 gspca_ctrl = &gspca_dev->cam.ctrls[idx];
1384 if (ctrl->value < gspca_ctrl->min
1385 || ctrl->value > gspca_ctrl->max)
1386 return -ERANGE;
1387 } else {
1388 gspca_ctrl = NULL;
1389 if (ctrl->value < ctrls->qctrl.minimum
1390 || ctrl->value > ctrls->qctrl.maximum)
1391 return -ERANGE;
1393 PDEBUG(D_CONF, "set ctrl [%08x] = %d", ctrl->id, ctrl->value);
1394 if (mutex_lock_interruptible(&gspca_dev->usb_lock))
1395 return -ERESTARTSYS;
1396 if (!gspca_dev->present) {
1397 ret = -ENODEV;
1398 goto out;
1400 gspca_dev->usb_err = 0;
1401 if (ctrls->set != NULL) {
1402 ret = ctrls->set(gspca_dev, ctrl->value);
1403 goto out;
1405 if (gspca_ctrl != NULL) {
1406 gspca_ctrl->val = ctrl->value;
1407 if (ctrls->set_control != NULL
1408 && gspca_dev->streaming)
1409 ctrls->set_control(gspca_dev);
1411 ret = gspca_dev->usb_err;
1412 out:
1413 mutex_unlock(&gspca_dev->usb_lock);
1414 return ret;
1417 static int vidioc_g_ctrl(struct file *file, void *priv,
1418 struct v4l2_control *ctrl)
1420 struct gspca_dev *gspca_dev = priv;
1421 const struct ctrl *ctrls;
1422 int idx, ret;
1424 idx = get_ctrl(gspca_dev, ctrl->id);
1425 if (idx < 0)
1426 return -EINVAL;
1427 ctrls = &gspca_dev->sd_desc->ctrls[idx];
1429 if (mutex_lock_interruptible(&gspca_dev->usb_lock))
1430 return -ERESTARTSYS;
1431 if (!gspca_dev->present) {
1432 ret = -ENODEV;
1433 goto out;
1435 gspca_dev->usb_err = 0;
1436 if (ctrls->get != NULL) {
1437 ret = ctrls->get(gspca_dev, &ctrl->value);
1438 goto out;
1440 if (gspca_dev->cam.ctrls != NULL)
1441 ctrl->value = gspca_dev->cam.ctrls[idx].val;
1442 ret = 0;
1443 out:
1444 mutex_unlock(&gspca_dev->usb_lock);
1445 return ret;
1448 static int vidioc_querymenu(struct file *file, void *priv,
1449 struct v4l2_querymenu *qmenu)
1451 struct gspca_dev *gspca_dev = priv;
1453 if (!gspca_dev->sd_desc->querymenu)
1454 return -EINVAL;
1455 return gspca_dev->sd_desc->querymenu(gspca_dev, qmenu);
1458 static int vidioc_enum_input(struct file *file, void *priv,
1459 struct v4l2_input *input)
1461 struct gspca_dev *gspca_dev = priv;
1463 if (input->index != 0)
1464 return -EINVAL;
1465 input->type = V4L2_INPUT_TYPE_CAMERA;
1466 input->status = gspca_dev->cam.input_flags;
1467 strlcpy(input->name, gspca_dev->sd_desc->name,
1468 sizeof input->name);
1469 return 0;
1472 static int vidioc_g_input(struct file *file, void *priv, unsigned int *i)
1474 *i = 0;
1475 return 0;
1478 static int vidioc_s_input(struct file *file, void *priv, unsigned int i)
1480 if (i > 0)
1481 return -EINVAL;
1482 return (0);
1485 static int vidioc_reqbufs(struct file *file, void *priv,
1486 struct v4l2_requestbuffers *rb)
1488 struct gspca_dev *gspca_dev = priv;
1489 int i, ret = 0, streaming;
1491 i = rb->memory; /* (avoid compilation warning) */
1492 switch (i) {
1493 case GSPCA_MEMORY_READ: /* (internal call) */
1494 case V4L2_MEMORY_MMAP:
1495 case V4L2_MEMORY_USERPTR:
1496 break;
1497 default:
1498 return -EINVAL;
1500 if (mutex_lock_interruptible(&gspca_dev->queue_lock))
1501 return -ERESTARTSYS;
1503 if (gspca_dev->memory != GSPCA_MEMORY_NO
1504 && gspca_dev->memory != GSPCA_MEMORY_READ
1505 && gspca_dev->memory != rb->memory) {
1506 ret = -EBUSY;
1507 goto out;
1510 /* only one file may do the capture */
1511 if (gspca_dev->capt_file != NULL
1512 && gspca_dev->capt_file != file) {
1513 ret = -EBUSY;
1514 goto out;
1517 /* if allocated, the buffers must not be mapped */
1518 for (i = 0; i < gspca_dev->nframes; i++) {
1519 if (gspca_dev->frame[i].vma_use_count) {
1520 ret = -EBUSY;
1521 goto out;
1525 /* stop streaming */
1526 streaming = gspca_dev->streaming;
1527 if (streaming) {
1528 mutex_lock(&gspca_dev->usb_lock);
1529 gspca_dev->usb_err = 0;
1530 gspca_stream_off(gspca_dev);
1531 mutex_unlock(&gspca_dev->usb_lock);
1533 /* Don't restart the stream when switching from read
1534 * to mmap mode */
1535 if (gspca_dev->memory == GSPCA_MEMORY_READ)
1536 streaming = 0;
1539 /* free the previous allocated buffers, if any */
1540 if (gspca_dev->nframes != 0)
1541 frame_free(gspca_dev);
1542 if (rb->count == 0) /* unrequest */
1543 goto out;
1544 ret = frame_alloc(gspca_dev, file, rb->memory, rb->count);
1545 if (ret == 0) {
1546 rb->count = gspca_dev->nframes;
1547 if (streaming)
1548 ret = gspca_init_transfer(gspca_dev);
1550 out:
1551 mutex_unlock(&gspca_dev->queue_lock);
1552 PDEBUG(D_STREAM, "reqbufs st:%d c:%d", ret, rb->count);
1553 return ret;
1556 static int vidioc_querybuf(struct file *file, void *priv,
1557 struct v4l2_buffer *v4l2_buf)
1559 struct gspca_dev *gspca_dev = priv;
1560 struct gspca_frame *frame;
1562 if (v4l2_buf->index < 0
1563 || v4l2_buf->index >= gspca_dev->nframes)
1564 return -EINVAL;
1566 frame = &gspca_dev->frame[v4l2_buf->index];
1567 memcpy(v4l2_buf, &frame->v4l2_buf, sizeof *v4l2_buf);
1568 return 0;
1571 static int vidioc_streamon(struct file *file, void *priv,
1572 enum v4l2_buf_type buf_type)
1574 struct gspca_dev *gspca_dev = priv;
1575 int ret;
1577 if (buf_type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
1578 return -EINVAL;
1579 if (mutex_lock_interruptible(&gspca_dev->queue_lock))
1580 return -ERESTARTSYS;
1582 /* check the capture file */
1583 if (gspca_dev->capt_file != file) {
1584 ret = -EBUSY;
1585 goto out;
1588 if (gspca_dev->nframes == 0
1589 || !(gspca_dev->frame[0].v4l2_buf.flags & V4L2_BUF_FLAG_QUEUED)) {
1590 ret = -EINVAL;
1591 goto out;
1593 if (!gspca_dev->streaming) {
1594 ret = gspca_init_transfer(gspca_dev);
1595 if (ret < 0)
1596 goto out;
1598 #ifdef GSPCA_DEBUG
1599 if (gspca_debug & D_STREAM) {
1600 PDEBUG_MODE("stream on OK",
1601 gspca_dev->pixfmt,
1602 gspca_dev->width,
1603 gspca_dev->height);
1605 #endif
1606 ret = 0;
1607 out:
1608 mutex_unlock(&gspca_dev->queue_lock);
1609 return ret;
1612 static int vidioc_streamoff(struct file *file, void *priv,
1613 enum v4l2_buf_type buf_type)
1615 struct gspca_dev *gspca_dev = priv;
1616 int ret;
1618 if (buf_type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
1619 return -EINVAL;
1621 if (mutex_lock_interruptible(&gspca_dev->queue_lock))
1622 return -ERESTARTSYS;
1624 if (!gspca_dev->streaming) {
1625 ret = 0;
1626 goto out;
1629 /* check the capture file */
1630 if (gspca_dev->capt_file != file) {
1631 ret = -EBUSY;
1632 goto out;
1635 /* stop streaming */
1636 if (mutex_lock_interruptible(&gspca_dev->usb_lock)) {
1637 ret = -ERESTARTSYS;
1638 goto out;
1640 gspca_dev->usb_err = 0;
1641 gspca_stream_off(gspca_dev);
1642 mutex_unlock(&gspca_dev->usb_lock);
1643 /* In case another thread is waiting in dqbuf */
1644 wake_up_interruptible(&gspca_dev->wq);
1646 /* empty the transfer queues */
1647 atomic_set(&gspca_dev->fr_q, 0);
1648 atomic_set(&gspca_dev->fr_i, 0);
1649 gspca_dev->fr_o = 0;
1650 ret = 0;
1651 out:
1652 mutex_unlock(&gspca_dev->queue_lock);
1653 return ret;
1656 static int vidioc_g_jpegcomp(struct file *file, void *priv,
1657 struct v4l2_jpegcompression *jpegcomp)
1659 struct gspca_dev *gspca_dev = priv;
1660 int ret;
1662 if (!gspca_dev->sd_desc->get_jcomp)
1663 return -EINVAL;
1664 if (mutex_lock_interruptible(&gspca_dev->usb_lock))
1665 return -ERESTARTSYS;
1666 gspca_dev->usb_err = 0;
1667 if (gspca_dev->present)
1668 ret = gspca_dev->sd_desc->get_jcomp(gspca_dev, jpegcomp);
1669 else
1670 ret = -ENODEV;
1671 mutex_unlock(&gspca_dev->usb_lock);
1672 return ret;
1675 static int vidioc_s_jpegcomp(struct file *file, void *priv,
1676 struct v4l2_jpegcompression *jpegcomp)
1678 struct gspca_dev *gspca_dev = priv;
1679 int ret;
1681 if (!gspca_dev->sd_desc->set_jcomp)
1682 return -EINVAL;
1683 if (mutex_lock_interruptible(&gspca_dev->usb_lock))
1684 return -ERESTARTSYS;
1685 gspca_dev->usb_err = 0;
1686 if (gspca_dev->present)
1687 ret = gspca_dev->sd_desc->set_jcomp(gspca_dev, jpegcomp);
1688 else
1689 ret = -ENODEV;
1690 mutex_unlock(&gspca_dev->usb_lock);
1691 return ret;
1694 static int vidioc_g_parm(struct file *filp, void *priv,
1695 struct v4l2_streamparm *parm)
1697 struct gspca_dev *gspca_dev = priv;
1699 parm->parm.capture.readbuffers = gspca_dev->nbufread;
1701 if (gspca_dev->sd_desc->get_streamparm) {
1702 int ret;
1704 if (mutex_lock_interruptible(&gspca_dev->usb_lock))
1705 return -ERESTARTSYS;
1706 if (gspca_dev->present) {
1707 gspca_dev->usb_err = 0;
1708 gspca_dev->sd_desc->get_streamparm(gspca_dev, parm);
1709 ret = gspca_dev->usb_err;
1710 } else {
1711 ret = -ENODEV;
1713 mutex_unlock(&gspca_dev->usb_lock);
1714 return ret;
1717 return 0;
1720 static int vidioc_s_parm(struct file *filp, void *priv,
1721 struct v4l2_streamparm *parm)
1723 struct gspca_dev *gspca_dev = priv;
1724 int n;
1726 n = parm->parm.capture.readbuffers;
1727 if (n == 0 || n >= GSPCA_MAX_FRAMES)
1728 parm->parm.capture.readbuffers = gspca_dev->nbufread;
1729 else
1730 gspca_dev->nbufread = n;
1732 if (gspca_dev->sd_desc->set_streamparm) {
1733 int ret;
1735 if (mutex_lock_interruptible(&gspca_dev->usb_lock))
1736 return -ERESTARTSYS;
1737 if (gspca_dev->present) {
1738 gspca_dev->usb_err = 0;
1739 gspca_dev->sd_desc->set_streamparm(gspca_dev, parm);
1740 ret = gspca_dev->usb_err;
1741 } else {
1742 ret = -ENODEV;
1744 mutex_unlock(&gspca_dev->usb_lock);
1745 return ret;
1748 return 0;
1751 static int dev_mmap(struct file *file, struct vm_area_struct *vma)
1753 struct gspca_dev *gspca_dev = file->private_data;
1754 struct gspca_frame *frame;
1755 struct page *page;
1756 unsigned long addr, start, size;
1757 int i, ret;
1759 start = vma->vm_start;
1760 size = vma->vm_end - vma->vm_start;
1761 PDEBUG(D_STREAM, "mmap start:%08x size:%d", (int) start, (int) size);
1763 if (mutex_lock_interruptible(&gspca_dev->queue_lock))
1764 return -ERESTARTSYS;
1765 if (!gspca_dev->present) {
1766 ret = -ENODEV;
1767 goto out;
1769 if (gspca_dev->capt_file != file) {
1770 ret = -EINVAL;
1771 goto out;
1774 frame = NULL;
1775 for (i = 0; i < gspca_dev->nframes; ++i) {
1776 if (gspca_dev->frame[i].v4l2_buf.memory != V4L2_MEMORY_MMAP) {
1777 PDEBUG(D_STREAM, "mmap bad memory type");
1778 break;
1780 if ((gspca_dev->frame[i].v4l2_buf.m.offset >> PAGE_SHIFT)
1781 == vma->vm_pgoff) {
1782 frame = &gspca_dev->frame[i];
1783 break;
1786 if (frame == NULL) {
1787 PDEBUG(D_STREAM, "mmap no frame buffer found");
1788 ret = -EINVAL;
1789 goto out;
1791 if (size != frame->v4l2_buf.length) {
1792 PDEBUG(D_STREAM, "mmap bad size");
1793 ret = -EINVAL;
1794 goto out;
1798 * - VM_IO marks the area as being a mmaped region for I/O to a
1799 * device. It also prevents the region from being core dumped.
1801 vma->vm_flags |= VM_IO;
1803 addr = (unsigned long) frame->data;
1804 while (size > 0) {
1805 page = vmalloc_to_page((void *) addr);
1806 ret = vm_insert_page(vma, start, page);
1807 if (ret < 0)
1808 goto out;
1809 start += PAGE_SIZE;
1810 addr += PAGE_SIZE;
1811 size -= PAGE_SIZE;
1814 vma->vm_ops = &gspca_vm_ops;
1815 vma->vm_private_data = frame;
1816 gspca_vm_open(vma);
1817 ret = 0;
1818 out:
1819 mutex_unlock(&gspca_dev->queue_lock);
1820 return ret;
1823 static int frame_ready_nolock(struct gspca_dev *gspca_dev, struct file *file,
1824 enum v4l2_memory memory)
1826 if (!gspca_dev->present)
1827 return -ENODEV;
1828 if (gspca_dev->capt_file != file || gspca_dev->memory != memory ||
1829 !gspca_dev->streaming)
1830 return -EINVAL;
1832 /* check if a frame is ready */
1833 return gspca_dev->fr_o != atomic_read(&gspca_dev->fr_i);
1836 static int frame_ready(struct gspca_dev *gspca_dev, struct file *file,
1837 enum v4l2_memory memory)
1839 int ret;
1841 if (mutex_lock_interruptible(&gspca_dev->queue_lock))
1842 return -ERESTARTSYS;
1843 ret = frame_ready_nolock(gspca_dev, file, memory);
1844 mutex_unlock(&gspca_dev->queue_lock);
1845 return ret;
1849 * dequeue a video buffer
1851 * If nonblock_ing is false, block until a buffer is available.
1853 static int vidioc_dqbuf(struct file *file, void *priv,
1854 struct v4l2_buffer *v4l2_buf)
1856 struct gspca_dev *gspca_dev = priv;
1857 struct gspca_frame *frame;
1858 int i, j, ret;
1860 PDEBUG(D_FRAM, "dqbuf");
1862 if (mutex_lock_interruptible(&gspca_dev->queue_lock))
1863 return -ERESTARTSYS;
1865 for (;;) {
1866 ret = frame_ready_nolock(gspca_dev, file, v4l2_buf->memory);
1867 if (ret < 0)
1868 goto out;
1869 if (ret > 0)
1870 break;
1872 mutex_unlock(&gspca_dev->queue_lock);
1874 if (file->f_flags & O_NONBLOCK)
1875 return -EAGAIN;
1877 /* wait till a frame is ready */
1878 ret = wait_event_interruptible_timeout(gspca_dev->wq,
1879 frame_ready(gspca_dev, file, v4l2_buf->memory),
1880 msecs_to_jiffies(3000));
1881 if (ret < 0)
1882 return ret;
1883 if (ret == 0)
1884 return -EIO;
1886 if (mutex_lock_interruptible(&gspca_dev->queue_lock))
1887 return -ERESTARTSYS;
1890 i = gspca_dev->fr_o;
1891 j = gspca_dev->fr_queue[i];
1892 frame = &gspca_dev->frame[j];
1894 gspca_dev->fr_o = (i + 1) % GSPCA_MAX_FRAMES;
1896 if (gspca_dev->sd_desc->dq_callback) {
1897 mutex_lock(&gspca_dev->usb_lock);
1898 gspca_dev->usb_err = 0;
1899 if (gspca_dev->present)
1900 gspca_dev->sd_desc->dq_callback(gspca_dev);
1901 mutex_unlock(&gspca_dev->usb_lock);
1904 frame->v4l2_buf.flags &= ~V4L2_BUF_FLAG_DONE;
1905 memcpy(v4l2_buf, &frame->v4l2_buf, sizeof *v4l2_buf);
1906 PDEBUG(D_FRAM, "dqbuf %d", j);
1907 ret = 0;
1909 if (gspca_dev->memory == V4L2_MEMORY_USERPTR) {
1910 if (copy_to_user((__u8 __user *) frame->v4l2_buf.m.userptr,
1911 frame->data,
1912 frame->v4l2_buf.bytesused)) {
1913 PDEBUG(D_ERR|D_STREAM,
1914 "dqbuf cp to user failed");
1915 ret = -EFAULT;
1918 out:
1919 mutex_unlock(&gspca_dev->queue_lock);
1920 return ret;
1924 * queue a video buffer
1926 * Attempting to queue a buffer that has already been
1927 * queued will return -EINVAL.
1929 static int vidioc_qbuf(struct file *file, void *priv,
1930 struct v4l2_buffer *v4l2_buf)
1932 struct gspca_dev *gspca_dev = priv;
1933 struct gspca_frame *frame;
1934 int i, index, ret;
1936 PDEBUG(D_FRAM, "qbuf %d", v4l2_buf->index);
1938 if (mutex_lock_interruptible(&gspca_dev->queue_lock))
1939 return -ERESTARTSYS;
1941 index = v4l2_buf->index;
1942 if ((unsigned) index >= gspca_dev->nframes) {
1943 PDEBUG(D_FRAM,
1944 "qbuf idx %d >= %d", index, gspca_dev->nframes);
1945 ret = -EINVAL;
1946 goto out;
1948 if (v4l2_buf->memory != gspca_dev->memory) {
1949 PDEBUG(D_FRAM, "qbuf bad memory type");
1950 ret = -EINVAL;
1951 goto out;
1954 frame = &gspca_dev->frame[index];
1955 if (frame->v4l2_buf.flags & BUF_ALL_FLAGS) {
1956 PDEBUG(D_FRAM, "qbuf bad state");
1957 ret = -EINVAL;
1958 goto out;
1961 frame->v4l2_buf.flags |= V4L2_BUF_FLAG_QUEUED;
1963 if (frame->v4l2_buf.memory == V4L2_MEMORY_USERPTR) {
1964 frame->v4l2_buf.m.userptr = v4l2_buf->m.userptr;
1965 frame->v4l2_buf.length = v4l2_buf->length;
1968 /* put the buffer in the 'queued' queue */
1969 i = atomic_read(&gspca_dev->fr_q);
1970 gspca_dev->fr_queue[i] = index;
1971 atomic_set(&gspca_dev->fr_q, (i + 1) % GSPCA_MAX_FRAMES);
1973 v4l2_buf->flags |= V4L2_BUF_FLAG_QUEUED;
1974 v4l2_buf->flags &= ~V4L2_BUF_FLAG_DONE;
1975 ret = 0;
1976 out:
1977 mutex_unlock(&gspca_dev->queue_lock);
1978 return ret;
1982 * allocate the resources for read()
1984 static int read_alloc(struct gspca_dev *gspca_dev,
1985 struct file *file)
1987 struct v4l2_buffer v4l2_buf;
1988 int i, ret;
1990 PDEBUG(D_STREAM, "read alloc");
1991 if (gspca_dev->nframes == 0) {
1992 struct v4l2_requestbuffers rb;
1994 memset(&rb, 0, sizeof rb);
1995 rb.count = gspca_dev->nbufread;
1996 rb.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1997 rb.memory = GSPCA_MEMORY_READ;
1998 ret = vidioc_reqbufs(file, gspca_dev, &rb);
1999 if (ret != 0) {
2000 PDEBUG(D_STREAM, "read reqbuf err %d", ret);
2001 return ret;
2003 memset(&v4l2_buf, 0, sizeof v4l2_buf);
2004 v4l2_buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2005 v4l2_buf.memory = GSPCA_MEMORY_READ;
2006 for (i = 0; i < gspca_dev->nbufread; i++) {
2007 v4l2_buf.index = i;
2008 ret = vidioc_qbuf(file, gspca_dev, &v4l2_buf);
2009 if (ret != 0) {
2010 PDEBUG(D_STREAM, "read qbuf err: %d", ret);
2011 return ret;
2014 gspca_dev->memory = GSPCA_MEMORY_READ;
2017 /* start streaming */
2018 ret = vidioc_streamon(file, gspca_dev, V4L2_BUF_TYPE_VIDEO_CAPTURE);
2019 if (ret != 0)
2020 PDEBUG(D_STREAM, "read streamon err %d", ret);
2021 return ret;
2024 static unsigned int dev_poll(struct file *file, poll_table *wait)
2026 struct gspca_dev *gspca_dev = file->private_data;
2027 int ret;
2029 PDEBUG(D_FRAM, "poll");
2031 poll_wait(file, &gspca_dev->wq, wait);
2033 /* if reqbufs is not done, the user would use read() */
2034 if (gspca_dev->memory == GSPCA_MEMORY_NO) {
2035 ret = read_alloc(gspca_dev, file);
2036 if (ret != 0)
2037 return POLLERR;
2040 if (mutex_lock_interruptible(&gspca_dev->queue_lock) != 0)
2041 return POLLERR;
2043 /* check if an image has been received */
2044 if (gspca_dev->fr_o != atomic_read(&gspca_dev->fr_i))
2045 ret = POLLIN | POLLRDNORM; /* yes */
2046 else
2047 ret = 0;
2048 mutex_unlock(&gspca_dev->queue_lock);
2049 if (!gspca_dev->present)
2050 return POLLHUP;
2051 return ret;
2054 static ssize_t dev_read(struct file *file, char __user *data,
2055 size_t count, loff_t *ppos)
2057 struct gspca_dev *gspca_dev = file->private_data;
2058 struct gspca_frame *frame;
2059 struct v4l2_buffer v4l2_buf;
2060 struct timeval timestamp;
2061 int n, ret, ret2;
2063 PDEBUG(D_FRAM, "read (%zd)", count);
2064 if (!gspca_dev->present)
2065 return -ENODEV;
2066 if (gspca_dev->memory == GSPCA_MEMORY_NO) { /* first time ? */
2067 ret = read_alloc(gspca_dev, file);
2068 if (ret != 0)
2069 return ret;
2072 /* get a frame */
2073 timestamp = ktime_to_timeval(ktime_get());
2074 timestamp.tv_sec--;
2075 n = 2;
2076 for (;;) {
2077 memset(&v4l2_buf, 0, sizeof v4l2_buf);
2078 v4l2_buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2079 v4l2_buf.memory = GSPCA_MEMORY_READ;
2080 ret = vidioc_dqbuf(file, gspca_dev, &v4l2_buf);
2081 if (ret != 0) {
2082 PDEBUG(D_STREAM, "read dqbuf err %d", ret);
2083 return ret;
2086 /* if the process slept for more than 1 second,
2087 * get a newer frame */
2088 frame = &gspca_dev->frame[v4l2_buf.index];
2089 if (--n < 0)
2090 break; /* avoid infinite loop */
2091 if (frame->v4l2_buf.timestamp.tv_sec >= timestamp.tv_sec)
2092 break;
2093 ret = vidioc_qbuf(file, gspca_dev, &v4l2_buf);
2094 if (ret != 0) {
2095 PDEBUG(D_STREAM, "read qbuf err %d", ret);
2096 return ret;
2100 /* copy the frame */
2101 if (count > frame->v4l2_buf.bytesused)
2102 count = frame->v4l2_buf.bytesused;
2103 ret = copy_to_user(data, frame->data, count);
2104 if (ret != 0) {
2105 PDEBUG(D_ERR|D_STREAM,
2106 "read cp to user lack %d / %zd", ret, count);
2107 ret = -EFAULT;
2108 goto out;
2110 ret = count;
2111 out:
2112 /* in each case, requeue the buffer */
2113 ret2 = vidioc_qbuf(file, gspca_dev, &v4l2_buf);
2114 if (ret2 != 0)
2115 return ret2;
2116 return ret;
2119 static struct v4l2_file_operations dev_fops = {
2120 .owner = THIS_MODULE,
2121 .open = dev_open,
2122 .release = dev_close,
2123 .read = dev_read,
2124 .mmap = dev_mmap,
2125 .unlocked_ioctl = video_ioctl2,
2126 .poll = dev_poll,
2129 static const struct v4l2_ioctl_ops dev_ioctl_ops = {
2130 .vidioc_querycap = vidioc_querycap,
2131 .vidioc_dqbuf = vidioc_dqbuf,
2132 .vidioc_qbuf = vidioc_qbuf,
2133 .vidioc_enum_fmt_vid_cap = vidioc_enum_fmt_vid_cap,
2134 .vidioc_try_fmt_vid_cap = vidioc_try_fmt_vid_cap,
2135 .vidioc_g_fmt_vid_cap = vidioc_g_fmt_vid_cap,
2136 .vidioc_s_fmt_vid_cap = vidioc_s_fmt_vid_cap,
2137 .vidioc_streamon = vidioc_streamon,
2138 .vidioc_queryctrl = vidioc_queryctrl,
2139 .vidioc_g_ctrl = vidioc_g_ctrl,
2140 .vidioc_s_ctrl = vidioc_s_ctrl,
2141 .vidioc_querymenu = vidioc_querymenu,
2142 .vidioc_enum_input = vidioc_enum_input,
2143 .vidioc_g_input = vidioc_g_input,
2144 .vidioc_s_input = vidioc_s_input,
2145 .vidioc_reqbufs = vidioc_reqbufs,
2146 .vidioc_querybuf = vidioc_querybuf,
2147 .vidioc_streamoff = vidioc_streamoff,
2148 .vidioc_g_jpegcomp = vidioc_g_jpegcomp,
2149 .vidioc_s_jpegcomp = vidioc_s_jpegcomp,
2150 .vidioc_g_parm = vidioc_g_parm,
2151 .vidioc_s_parm = vidioc_s_parm,
2152 .vidioc_enum_framesizes = vidioc_enum_framesizes,
2153 .vidioc_enum_frameintervals = vidioc_enum_frameintervals,
2154 #ifdef CONFIG_VIDEO_ADV_DEBUG
2155 .vidioc_g_register = vidioc_g_register,
2156 .vidioc_s_register = vidioc_s_register,
2157 #endif
2158 .vidioc_g_chip_ident = vidioc_g_chip_ident,
2161 static const struct video_device gspca_template = {
2162 .name = "gspca main driver",
2163 .fops = &dev_fops,
2164 .ioctl_ops = &dev_ioctl_ops,
2165 .release = gspca_release,
2168 /* initialize the controls */
2169 static void ctrls_init(struct gspca_dev *gspca_dev)
2171 struct gspca_ctrl *ctrl;
2172 int i;
2174 for (i = 0, ctrl = gspca_dev->cam.ctrls;
2175 i < gspca_dev->sd_desc->nctrls;
2176 i++, ctrl++) {
2177 ctrl->def = gspca_dev->sd_desc->ctrls[i].qctrl.default_value;
2178 ctrl->val = ctrl->def;
2179 ctrl->min = gspca_dev->sd_desc->ctrls[i].qctrl.minimum;
2180 ctrl->max = gspca_dev->sd_desc->ctrls[i].qctrl.maximum;
2185 * probe and create a new gspca device
2187 * This function must be called by the sub-driver when it is
2188 * called for probing a new device.
2190 int gspca_dev_probe2(struct usb_interface *intf,
2191 const struct usb_device_id *id,
2192 const struct sd_desc *sd_desc,
2193 int dev_size,
2194 struct module *module)
2196 struct gspca_dev *gspca_dev;
2197 struct usb_device *dev = interface_to_usbdev(intf);
2198 int ret;
2200 PDEBUG(D_PROBE, "probing %04x:%04x", id->idVendor, id->idProduct);
2202 /* create the device */
2203 if (dev_size < sizeof *gspca_dev)
2204 dev_size = sizeof *gspca_dev;
2205 gspca_dev = kzalloc(dev_size, GFP_KERNEL);
2206 if (!gspca_dev) {
2207 pr_err("couldn't kzalloc gspca struct\n");
2208 return -ENOMEM;
2210 gspca_dev->usb_buf = kmalloc(USB_BUF_SZ, GFP_KERNEL);
2211 if (!gspca_dev->usb_buf) {
2212 pr_err("out of memory\n");
2213 ret = -ENOMEM;
2214 goto out;
2216 gspca_dev->dev = dev;
2217 gspca_dev->iface = intf->cur_altsetting->desc.bInterfaceNumber;
2218 gspca_dev->nbalt = intf->num_altsetting;
2220 /* check if any audio device */
2221 if (dev->config->desc.bNumInterfaces != 1) {
2222 int i;
2223 struct usb_interface *intf2;
2225 for (i = 0; i < dev->config->desc.bNumInterfaces; i++) {
2226 intf2 = dev->config->interface[i];
2227 if (intf2 != NULL
2228 && intf2->altsetting != NULL
2229 && intf2->altsetting->desc.bInterfaceClass ==
2230 USB_CLASS_AUDIO) {
2231 gspca_dev->audio = 1;
2232 break;
2237 gspca_dev->sd_desc = sd_desc;
2238 gspca_dev->nbufread = 2;
2239 gspca_dev->empty_packet = -1; /* don't check the empty packets */
2241 /* configure the subdriver and initialize the USB device */
2242 ret = sd_desc->config(gspca_dev, id);
2243 if (ret < 0)
2244 goto out;
2245 if (gspca_dev->cam.ctrls != NULL)
2246 ctrls_init(gspca_dev);
2247 ret = sd_desc->init(gspca_dev);
2248 if (ret < 0)
2249 goto out;
2250 gspca_set_default_mode(gspca_dev);
2252 ret = gspca_input_connect(gspca_dev);
2253 if (ret)
2254 goto out;
2256 mutex_init(&gspca_dev->usb_lock);
2257 mutex_init(&gspca_dev->queue_lock);
2258 init_waitqueue_head(&gspca_dev->wq);
2260 /* init video stuff */
2261 memcpy(&gspca_dev->vdev, &gspca_template, sizeof gspca_template);
2262 gspca_dev->vdev.parent = &intf->dev;
2263 gspca_dev->module = module;
2264 gspca_dev->present = 1;
2265 ret = video_register_device(&gspca_dev->vdev,
2266 VFL_TYPE_GRABBER,
2267 -1);
2268 if (ret < 0) {
2269 pr_err("video_register_device err %d\n", ret);
2270 goto out;
2273 usb_set_intfdata(intf, gspca_dev);
2274 PDEBUG(D_PROBE, "%s created", video_device_node_name(&gspca_dev->vdev));
2276 gspca_input_create_urb(gspca_dev);
2278 return 0;
2279 out:
2280 #if defined(CONFIG_INPUT) || defined(CONFIG_INPUT_MODULE)
2281 if (gspca_dev->input_dev)
2282 input_unregister_device(gspca_dev->input_dev);
2283 #endif
2284 kfree(gspca_dev->usb_buf);
2285 kfree(gspca_dev);
2286 return ret;
2288 EXPORT_SYMBOL(gspca_dev_probe2);
2290 /* same function as the previous one, but check the interface */
2291 int gspca_dev_probe(struct usb_interface *intf,
2292 const struct usb_device_id *id,
2293 const struct sd_desc *sd_desc,
2294 int dev_size,
2295 struct module *module)
2297 struct usb_device *dev = interface_to_usbdev(intf);
2299 /* we don't handle multi-config cameras */
2300 if (dev->descriptor.bNumConfigurations != 1) {
2301 pr_err("%04x:%04x too many config\n",
2302 id->idVendor, id->idProduct);
2303 return -ENODEV;
2306 /* the USB video interface must be the first one */
2307 if (dev->config->desc.bNumInterfaces != 1
2308 && intf->cur_altsetting->desc.bInterfaceNumber != 0)
2309 return -ENODEV;
2311 return gspca_dev_probe2(intf, id, sd_desc, dev_size, module);
2313 EXPORT_SYMBOL(gspca_dev_probe);
2316 * USB disconnection
2318 * This function must be called by the sub-driver
2319 * when the device disconnects, after the specific resources are freed.
2321 void gspca_disconnect(struct usb_interface *intf)
2323 struct gspca_dev *gspca_dev = usb_get_intfdata(intf);
2324 #if defined(CONFIG_INPUT) || defined(CONFIG_INPUT_MODULE)
2325 struct input_dev *input_dev;
2326 #endif
2328 PDEBUG(D_PROBE, "%s disconnect",
2329 video_device_node_name(&gspca_dev->vdev));
2330 mutex_lock(&gspca_dev->usb_lock);
2332 gspca_dev->present = 0;
2333 wake_up_interruptible(&gspca_dev->wq);
2335 destroy_urbs(gspca_dev);
2337 #if defined(CONFIG_INPUT) || defined(CONFIG_INPUT_MODULE)
2338 gspca_input_destroy_urb(gspca_dev);
2339 input_dev = gspca_dev->input_dev;
2340 if (input_dev) {
2341 gspca_dev->input_dev = NULL;
2342 input_unregister_device(input_dev);
2344 #endif
2346 /* the device is freed at exit of this function */
2347 gspca_dev->dev = NULL;
2348 mutex_unlock(&gspca_dev->usb_lock);
2350 usb_set_intfdata(intf, NULL);
2352 /* release the device */
2353 /* (this will call gspca_release() immediately or on last close) */
2354 video_unregister_device(&gspca_dev->vdev);
2356 /* PDEBUG(D_PROBE, "disconnect complete"); */
2358 EXPORT_SYMBOL(gspca_disconnect);
2360 #ifdef CONFIG_PM
2361 int gspca_suspend(struct usb_interface *intf, pm_message_t message)
2363 struct gspca_dev *gspca_dev = usb_get_intfdata(intf);
2365 if (!gspca_dev->streaming)
2366 return 0;
2367 gspca_dev->frozen = 1; /* avoid urb error messages */
2368 if (gspca_dev->sd_desc->stopN)
2369 gspca_dev->sd_desc->stopN(gspca_dev);
2370 destroy_urbs(gspca_dev);
2371 gspca_input_destroy_urb(gspca_dev);
2372 gspca_set_alt0(gspca_dev);
2373 if (gspca_dev->sd_desc->stop0)
2374 gspca_dev->sd_desc->stop0(gspca_dev);
2375 return 0;
2377 EXPORT_SYMBOL(gspca_suspend);
2379 int gspca_resume(struct usb_interface *intf)
2381 struct gspca_dev *gspca_dev = usb_get_intfdata(intf);
2383 gspca_dev->frozen = 0;
2384 gspca_dev->sd_desc->init(gspca_dev);
2385 gspca_input_create_urb(gspca_dev);
2386 if (gspca_dev->streaming)
2387 return gspca_init_transfer(gspca_dev);
2388 return 0;
2390 EXPORT_SYMBOL(gspca_resume);
2391 #endif
2392 /* -- cam driver utility functions -- */
2394 /* auto gain and exposure algorithm based on the knee algorithm described here:
2395 http://ytse.tricolour.net/docs/LowLightOptimization.html
2397 Returns 0 if no changes were made, 1 if the gain and or exposure settings
2398 where changed. */
2399 int gspca_auto_gain_n_exposure(struct gspca_dev *gspca_dev, int avg_lum,
2400 int desired_avg_lum, int deadzone, int gain_knee, int exposure_knee)
2402 int i, steps, gain, orig_gain, exposure, orig_exposure, autogain;
2403 const struct ctrl *gain_ctrl = NULL;
2404 const struct ctrl *exposure_ctrl = NULL;
2405 const struct ctrl *autogain_ctrl = NULL;
2406 int retval = 0;
2408 for (i = 0; i < gspca_dev->sd_desc->nctrls; i++) {
2409 if (gspca_dev->ctrl_dis & (1 << i))
2410 continue;
2411 if (gspca_dev->sd_desc->ctrls[i].qctrl.id == V4L2_CID_GAIN)
2412 gain_ctrl = &gspca_dev->sd_desc->ctrls[i];
2413 if (gspca_dev->sd_desc->ctrls[i].qctrl.id == V4L2_CID_EXPOSURE)
2414 exposure_ctrl = &gspca_dev->sd_desc->ctrls[i];
2415 if (gspca_dev->sd_desc->ctrls[i].qctrl.id == V4L2_CID_AUTOGAIN)
2416 autogain_ctrl = &gspca_dev->sd_desc->ctrls[i];
2418 if (!gain_ctrl || !exposure_ctrl || !autogain_ctrl) {
2419 PDEBUG(D_ERR, "Error: gspca_auto_gain_n_exposure called "
2420 "on cam without (auto)gain/exposure");
2421 return 0;
2424 if (gain_ctrl->get(gspca_dev, &gain) ||
2425 exposure_ctrl->get(gspca_dev, &exposure) ||
2426 autogain_ctrl->get(gspca_dev, &autogain) || !autogain)
2427 return 0;
2429 orig_gain = gain;
2430 orig_exposure = exposure;
2432 /* If we are of a multiple of deadzone, do multiple steps to reach the
2433 desired lumination fast (with the risc of a slight overshoot) */
2434 steps = abs(desired_avg_lum - avg_lum) / deadzone;
2436 PDEBUG(D_FRAM, "autogain: lum: %d, desired: %d, steps: %d",
2437 avg_lum, desired_avg_lum, steps);
2439 for (i = 0; i < steps; i++) {
2440 if (avg_lum > desired_avg_lum) {
2441 if (gain > gain_knee)
2442 gain--;
2443 else if (exposure > exposure_knee)
2444 exposure--;
2445 else if (gain > gain_ctrl->qctrl.default_value)
2446 gain--;
2447 else if (exposure > exposure_ctrl->qctrl.minimum)
2448 exposure--;
2449 else if (gain > gain_ctrl->qctrl.minimum)
2450 gain--;
2451 else
2452 break;
2453 } else {
2454 if (gain < gain_ctrl->qctrl.default_value)
2455 gain++;
2456 else if (exposure < exposure_knee)
2457 exposure++;
2458 else if (gain < gain_knee)
2459 gain++;
2460 else if (exposure < exposure_ctrl->qctrl.maximum)
2461 exposure++;
2462 else if (gain < gain_ctrl->qctrl.maximum)
2463 gain++;
2464 else
2465 break;
2469 if (gain != orig_gain) {
2470 gain_ctrl->set(gspca_dev, gain);
2471 retval = 1;
2473 if (exposure != orig_exposure) {
2474 exposure_ctrl->set(gspca_dev, exposure);
2475 retval = 1;
2478 return retval;
2480 EXPORT_SYMBOL(gspca_auto_gain_n_exposure);
2482 /* -- module insert / remove -- */
2483 static int __init gspca_init(void)
2485 pr_info("v" DRIVER_VERSION_NUMBER " registered\n");
2486 return 0;
2488 static void __exit gspca_exit(void)
2492 module_init(gspca_init);
2493 module_exit(gspca_exit);
2495 #ifdef GSPCA_DEBUG
2496 module_param_named(debug, gspca_debug, int, 0644);
2497 MODULE_PARM_DESC(debug,
2498 "Debug (bit) 0x01:error 0x02:probe 0x04:config"
2499 " 0x08:stream 0x10:frame 0x20:packet"
2500 " 0x0100: v4l2");
2501 #endif