1 /* Linux driver for Philips webcam
2 USB and Video4Linux interface part.
3 (C) 1999-2004 Nemosoft Unv.
4 (C) 2004-2006 Luc Saillard (luc@saillard.org)
5 (C) 2011 Hans de Goede <hdegoede@redhat.com>
7 NOTE: this version of pwc is an unofficial (modified) release of pwc & pcwx
8 driver and thus may have bugs that are not present in the original version.
9 Please send bug reports and support requests to <luc@saillard.org>.
10 The decompression routines have been implemented by reverse-engineering the
11 Nemosoft binary pwcx module. Caveat emptor.
13 This program is free software; you can redistribute it and/or modify
14 it under the terms of the GNU General Public License as published by
15 the Free Software Foundation; either version 2 of the License, or
16 (at your option) any later version.
18 This program is distributed in the hope that it will be useful,
19 but WITHOUT ANY WARRANTY; without even the implied warranty of
20 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 GNU General Public License for more details.
23 You should have received a copy of the GNU General Public License
24 along with this program; if not, write to the Free Software
25 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
30 This code forms the interface between the USB layers and the Philips
31 specific stuff. Some adanved stuff of the driver falls under an
32 NDA, signed between me and Philips B.V., Eindhoven, the Netherlands, and
33 is thus not distributed in source form. The binary pwcx.o module
34 contains the code that falls under the NDA.
36 In case you're wondering: 'pwc' stands for "Philips WebCam", but
37 I really didn't want to type 'philips_web_cam' every time (I'm lazy as
38 any Linux kernel hacker, but I don't like uncomprehensible abbreviations
41 Oh yes, convention: to disctinguish between all the various pointers to
42 device-structures, I use these names for the pointer variables:
43 udev: struct usb_device *
44 vdev: struct video_device (member of pwc_dev)
45 pdev: struct pwc_devive *
49 - Alvarado: adding whitebalance code
50 - Alistar Moire: QuickCam 3000 Pro device/product ID
51 - Tony Hoyle: Creative Labs Webcam 5 device/product ID
52 - Mark Burazin: solving hang in VIDIOCSYNC when camera gets unplugged
53 - Jk Fang: Sotec Afina Eye ID
54 - Xavier Roche: QuickCam Pro 4000 ID
55 - Jens Knudsen: QuickCam Zoom ID
56 - J. Debert: QuickCam for Notebooks ID
57 - Pham Thanh Nam: webcam snapshot button as an event input device
60 #include <linux/errno.h>
61 #include <linux/init.h>
63 #include <linux/module.h>
64 #include <linux/poll.h>
65 #include <linux/slab.h>
66 #ifdef CONFIG_USB_PWC_INPUT_EVDEV
67 #include <linux/usb/input.h>
69 #include <linux/vmalloc.h>
71 #include <linux/kernel.h> /* simple_strtol() */
74 #include "pwc-kiara.h"
75 #include "pwc-timon.h"
76 #include "pwc-dec23.h"
79 /* Function prototypes and driver templates */
81 /* hotplug device table support */
82 static const struct usb_device_id pwc_device_table
[] = {
83 { USB_DEVICE(0x0471, 0x0302) }, /* Philips models */
84 { USB_DEVICE(0x0471, 0x0303) },
85 { USB_DEVICE(0x0471, 0x0304) },
86 { USB_DEVICE(0x0471, 0x0307) },
87 { USB_DEVICE(0x0471, 0x0308) },
88 { USB_DEVICE(0x0471, 0x030C) },
89 { USB_DEVICE(0x0471, 0x0310) },
90 { USB_DEVICE(0x0471, 0x0311) }, /* Philips ToUcam PRO II */
91 { USB_DEVICE(0x0471, 0x0312) },
92 { USB_DEVICE(0x0471, 0x0313) }, /* the 'new' 720K */
93 { USB_DEVICE(0x0471, 0x0329) }, /* Philips SPC 900NC PC Camera */
94 { USB_DEVICE(0x069A, 0x0001) }, /* Askey */
95 { USB_DEVICE(0x046D, 0x08B0) }, /* Logitech QuickCam Pro 3000 */
96 { USB_DEVICE(0x046D, 0x08B1) }, /* Logitech QuickCam Notebook Pro */
97 { USB_DEVICE(0x046D, 0x08B2) }, /* Logitech QuickCam Pro 4000 */
98 { USB_DEVICE(0x046D, 0x08B3) }, /* Logitech QuickCam Zoom (old model) */
99 { USB_DEVICE(0x046D, 0x08B4) }, /* Logitech QuickCam Zoom (new model) */
100 { USB_DEVICE(0x046D, 0x08B5) }, /* Logitech QuickCam Orbit/Sphere */
101 { USB_DEVICE(0x046D, 0x08B6) }, /* Cisco VT Camera */
102 { USB_DEVICE(0x046D, 0x08B7) }, /* Logitech ViewPort AV 100 */
103 { USB_DEVICE(0x046D, 0x08B8) }, /* Logitech (reserved) */
104 { USB_DEVICE(0x055D, 0x9000) }, /* Samsung MPC-C10 */
105 { USB_DEVICE(0x055D, 0x9001) }, /* Samsung MPC-C30 */
106 { USB_DEVICE(0x055D, 0x9002) }, /* Samsung SNC-35E (Ver3.0) */
107 { USB_DEVICE(0x041E, 0x400C) }, /* Creative Webcam 5 */
108 { USB_DEVICE(0x041E, 0x4011) }, /* Creative Webcam Pro Ex */
109 { USB_DEVICE(0x04CC, 0x8116) }, /* Afina Eye */
110 { USB_DEVICE(0x06BE, 0x8116) }, /* new Afina Eye */
111 { USB_DEVICE(0x0d81, 0x1910) }, /* Visionite */
112 { USB_DEVICE(0x0d81, 0x1900) },
115 MODULE_DEVICE_TABLE(usb
, pwc_device_table
);
117 static int usb_pwc_probe(struct usb_interface
*intf
, const struct usb_device_id
*id
);
118 static void usb_pwc_disconnect(struct usb_interface
*intf
);
119 static void pwc_isoc_cleanup(struct pwc_device
*pdev
);
121 static struct usb_driver pwc_driver
= {
122 .name
= "Philips webcam", /* name */
123 .id_table
= pwc_device_table
,
124 .probe
= usb_pwc_probe
, /* probe() */
125 .disconnect
= usb_pwc_disconnect
, /* disconnect() */
128 #define MAX_DEV_HINTS 20
129 #define MAX_ISOC_ERRORS 20
131 static int default_fps
= 10;
132 #ifdef CONFIG_USB_PWC_DEBUG
133 int pwc_trace
= PWC_DEBUG_LEVEL
;
135 static int power_save
= -1;
136 static int led_on
= 100, led_off
; /* defaults to LED that is on while in use */
137 static int pwc_preferred_compression
= 1; /* 0..3 = uncompressed..high */
140 char serial_number
[30];
142 struct pwc_device
*pdev
;
143 } device_hint
[MAX_DEV_HINTS
];
147 static int pwc_video_open(struct file
*file
);
148 static int pwc_video_close(struct file
*file
);
149 static ssize_t
pwc_video_read(struct file
*file
, char __user
*buf
,
150 size_t count
, loff_t
*ppos
);
151 static unsigned int pwc_video_poll(struct file
*file
, poll_table
*wait
);
152 static int pwc_video_mmap(struct file
*file
, struct vm_area_struct
*vma
);
153 static void pwc_video_release(struct video_device
*vfd
);
155 static const struct v4l2_file_operations pwc_fops
= {
156 .owner
= THIS_MODULE
,
157 .open
= pwc_video_open
,
158 .release
= pwc_video_close
,
159 .read
= pwc_video_read
,
160 .poll
= pwc_video_poll
,
161 .mmap
= pwc_video_mmap
,
162 .unlocked_ioctl
= video_ioctl2
,
164 static struct video_device pwc_template
= {
165 .name
= "Philips Webcam", /* Filled in later */
166 .release
= pwc_video_release
,
168 .ioctl_ops
= &pwc_ioctl_ops
,
171 /***************************************************************************/
172 /* Private functions */
174 struct pwc_frame_buf
*pwc_get_next_fill_buf(struct pwc_device
*pdev
)
176 unsigned long flags
= 0;
177 struct pwc_frame_buf
*buf
= NULL
;
179 spin_lock_irqsave(&pdev
->queued_bufs_lock
, flags
);
180 if (list_empty(&pdev
->queued_bufs
))
183 buf
= list_entry(pdev
->queued_bufs
.next
, struct pwc_frame_buf
, list
);
184 list_del(&buf
->list
);
186 spin_unlock_irqrestore(&pdev
->queued_bufs_lock
, flags
);
190 static void pwc_snapshot_button(struct pwc_device
*pdev
, int down
)
193 PWC_TRACE("Snapshot button pressed.\n");
194 pdev
->snapshot_button_status
= 1;
196 PWC_TRACE("Snapshot button released.\n");
199 #ifdef CONFIG_USB_PWC_INPUT_EVDEV
200 if (pdev
->button_dev
) {
201 input_report_key(pdev
->button_dev
, KEY_CAMERA
, down
);
202 input_sync(pdev
->button_dev
);
207 static void pwc_frame_complete(struct pwc_device
*pdev
)
209 struct pwc_frame_buf
*fbuf
= pdev
->fill_buf
;
211 /* The ToUCam Fun CMOS sensor causes the firmware to send 2 or 3 bogus
212 frames on the USB wire after an exposure change. This conditition is
213 however detected in the cam and a bit is set in the header.
215 if (pdev
->type
== 730) {
216 unsigned char *ptr
= (unsigned char *)fbuf
->data
;
218 if (ptr
[1] == 1 && ptr
[0] & 0x10) {
219 PWC_TRACE("Hyundai CMOS sensor bug. Dropping frame.\n");
220 pdev
->drop_frames
+= 2;
222 if ((ptr
[0] ^ pdev
->vmirror
) & 0x01) {
223 pwc_snapshot_button(pdev
, ptr
[0] & 0x01);
225 if ((ptr
[0] ^ pdev
->vmirror
) & 0x02) {
227 PWC_TRACE("Image is mirrored.\n");
229 PWC_TRACE("Image is normal.\n");
231 pdev
->vmirror
= ptr
[0] & 0x03;
232 /* Sometimes the trailer of the 730 is still sent as a 4 byte packet
233 after a short frame; this condition is filtered out specifically. A 4 byte
234 frame doesn't make sense anyway.
235 So we get either this sequence:
236 drop_bit set -> 4 byte frame -> short frame -> good frame
238 drop_bit set -> short frame -> good frame
239 So we drop either 3 or 2 frames in all!
241 if (fbuf
->filled
== 4)
243 } else if (pdev
->type
== 740 || pdev
->type
== 720) {
244 unsigned char *ptr
= (unsigned char *)fbuf
->data
;
245 if ((ptr
[0] ^ pdev
->vmirror
) & 0x01) {
246 pwc_snapshot_button(pdev
, ptr
[0] & 0x01);
248 pdev
->vmirror
= ptr
[0] & 0x03;
251 /* In case we were instructed to drop the frame, do so silently. */
252 if (pdev
->drop_frames
> 0) {
255 /* Check for underflow first */
256 if (fbuf
->filled
< pdev
->frame_total_size
) {
257 PWC_DEBUG_FLOW("Frame buffer underflow (%d bytes);"
258 " discarded.\n", fbuf
->filled
);
260 fbuf
->vb
.v4l2_buf
.field
= V4L2_FIELD_NONE
;
261 fbuf
->vb
.v4l2_buf
.sequence
= pdev
->vframe_count
;
262 vb2_buffer_done(&fbuf
->vb
, VB2_BUF_STATE_DONE
);
263 pdev
->fill_buf
= NULL
;
267 pdev
->vframe_count
++;
270 /* This gets called for the Isochronous pipe (video). This is done in
271 * interrupt time, so it has to be fast, not crash, and not stall. Neat.
273 static void pwc_isoc_handler(struct urb
*urb
)
275 struct pwc_device
*pdev
= (struct pwc_device
*)urb
->context
;
277 unsigned char *iso_buf
= NULL
;
279 if (urb
->status
== -ENOENT
|| urb
->status
== -ECONNRESET
||
280 urb
->status
== -ESHUTDOWN
) {
281 PWC_DEBUG_OPEN("URB (%p) unlinked %ssynchronuously.\n", urb
, urb
->status
== -ENOENT
? "" : "a");
285 if (pdev
->fill_buf
== NULL
)
286 pdev
->fill_buf
= pwc_get_next_fill_buf(pdev
);
288 if (urb
->status
!= 0) {
292 switch(urb
->status
) {
293 case -ENOSR
: errmsg
= "Buffer error (overrun)"; break;
294 case -EPIPE
: errmsg
= "Stalled (device not responding)"; break;
295 case -EOVERFLOW
: errmsg
= "Babble (bad cable?)"; break;
296 case -EPROTO
: errmsg
= "Bit-stuff error (bad cable?)"; break;
297 case -EILSEQ
: errmsg
= "CRC/Timeout (could be anything)"; break;
298 case -ETIME
: errmsg
= "Device does not respond"; break;
300 PWC_ERROR("pwc_isoc_handler() called with status %d [%s].\n",
301 urb
->status
, errmsg
);
302 /* Give up after a number of contiguous errors */
303 if (++pdev
->visoc_errors
> MAX_ISOC_ERRORS
)
305 PWC_ERROR("Too many ISOC errors, bailing out.\n");
306 if (pdev
->fill_buf
) {
307 vb2_buffer_done(&pdev
->fill_buf
->vb
,
308 VB2_BUF_STATE_ERROR
);
309 pdev
->fill_buf
= NULL
;
312 pdev
->vsync
= 0; /* Drop the current frame */
316 /* Reset ISOC error counter. We did get here, after all. */
317 pdev
->visoc_errors
= 0;
319 /* vsync: 0 = don't copy data
324 for (i
= 0; i
< urb
->number_of_packets
; i
++) {
325 fst
= urb
->iso_frame_desc
[i
].status
;
326 flen
= urb
->iso_frame_desc
[i
].actual_length
;
327 iso_buf
= urb
->transfer_buffer
+ urb
->iso_frame_desc
[i
].offset
;
329 PWC_ERROR("Iso frame %d has error %d\n", i
, fst
);
332 if (flen
> 0 && pdev
->vsync
) {
333 struct pwc_frame_buf
*fbuf
= pdev
->fill_buf
;
335 if (pdev
->vsync
== 1) {
336 do_gettimeofday(&fbuf
->vb
.v4l2_buf
.timestamp
);
340 if (flen
+ fbuf
->filled
> pdev
->frame_total_size
) {
341 PWC_ERROR("Frame overflow (%d > %d)\n",
343 pdev
->frame_total_size
);
344 pdev
->vsync
= 0; /* Let's wait for an EOF */
346 memcpy(fbuf
->data
+ fbuf
->filled
, iso_buf
,
348 fbuf
->filled
+= flen
;
351 if (flen
< pdev
->vlast_packet_size
) {
352 /* Shorter packet... end of frame */
353 if (pdev
->vsync
== 2)
354 pwc_frame_complete(pdev
);
355 if (pdev
->fill_buf
== NULL
)
356 pdev
->fill_buf
= pwc_get_next_fill_buf(pdev
);
357 if (pdev
->fill_buf
) {
358 pdev
->fill_buf
->filled
= 0;
362 pdev
->vlast_packet_size
= flen
;
366 i
= usb_submit_urb(urb
, GFP_ATOMIC
);
368 PWC_ERROR("Error (%d) re-submitting urb in pwc_isoc_handler.\n", i
);
371 static int pwc_isoc_init(struct pwc_device
*pdev
)
373 struct usb_device
*udev
;
376 struct usb_interface
*intf
;
377 struct usb_host_interface
*idesc
= NULL
;
383 pdev
->vlast_packet_size
= 0;
384 pdev
->fill_buf
= NULL
;
385 pdev
->vframe_count
= 0;
386 pdev
->visoc_errors
= 0;
389 /* Get the current alternate interface, adjust packet size */
390 intf
= usb_ifnum_to_if(udev
, 0);
392 idesc
= usb_altnum_to_altsetting(intf
, pdev
->valternate
);
396 /* Search video endpoint */
397 pdev
->vmax_packet_size
= -1;
398 for (i
= 0; i
< idesc
->desc
.bNumEndpoints
; i
++) {
399 if ((idesc
->endpoint
[i
].desc
.bEndpointAddress
& 0xF) == pdev
->vendpoint
) {
400 pdev
->vmax_packet_size
= le16_to_cpu(idesc
->endpoint
[i
].desc
.wMaxPacketSize
);
405 if (pdev
->vmax_packet_size
< 0 || pdev
->vmax_packet_size
> ISO_MAX_FRAME_SIZE
) {
406 PWC_ERROR("Failed to find packet size for video endpoint in current alternate setting.\n");
407 return -ENFILE
; /* Odd error, that should be noticeable */
410 /* Set alternate interface */
412 PWC_DEBUG_OPEN("Setting alternate interface %d\n", pdev
->valternate
);
413 ret
= usb_set_interface(pdev
->udev
, 0, pdev
->valternate
);
417 /* Allocate and init Isochronuous urbs */
418 for (i
= 0; i
< MAX_ISO_BUFS
; i
++) {
419 urb
= usb_alloc_urb(ISO_FRAMES_PER_DESC
, GFP_KERNEL
);
421 PWC_ERROR("Failed to allocate urb %d\n", i
);
423 pwc_isoc_cleanup(pdev
);
427 PWC_DEBUG_MEMORY("Allocated URB at 0x%p\n", urb
);
429 urb
->interval
= 1; // devik
431 urb
->pipe
= usb_rcvisocpipe(udev
, pdev
->vendpoint
);
432 urb
->transfer_flags
= URB_ISO_ASAP
| URB_NO_TRANSFER_DMA_MAP
;
433 urb
->transfer_buffer
= usb_alloc_coherent(udev
,
437 if (urb
->transfer_buffer
== NULL
) {
438 PWC_ERROR("Failed to allocate urb buffer %d\n", i
);
440 pwc_isoc_cleanup(pdev
);
443 urb
->transfer_buffer_length
= ISO_BUFFER_SIZE
;
444 urb
->complete
= pwc_isoc_handler
;
446 urb
->start_frame
= 0;
447 urb
->number_of_packets
= ISO_FRAMES_PER_DESC
;
448 for (j
= 0; j
< ISO_FRAMES_PER_DESC
; j
++) {
449 urb
->iso_frame_desc
[j
].offset
= j
* ISO_MAX_FRAME_SIZE
;
450 urb
->iso_frame_desc
[j
].length
= pdev
->vmax_packet_size
;
455 for (i
= 0; i
< MAX_ISO_BUFS
; i
++) {
456 ret
= usb_submit_urb(pdev
->urbs
[i
], GFP_KERNEL
);
458 PWC_ERROR("isoc_init() submit_urb %d failed with error %d\n", i
, ret
);
460 pwc_isoc_cleanup(pdev
);
463 PWC_DEBUG_MEMORY("URB 0x%p submitted.\n", pdev
->urbs
[i
]);
468 PWC_DEBUG_OPEN("<< pwc_isoc_init()\n");
472 static void pwc_iso_stop(struct pwc_device
*pdev
)
476 /* Unlinking ISOC buffers one by one */
477 for (i
= 0; i
< MAX_ISO_BUFS
; i
++) {
479 PWC_DEBUG_MEMORY("Unlinking URB %p\n", pdev
->urbs
[i
]);
480 usb_kill_urb(pdev
->urbs
[i
]);
485 static void pwc_iso_free(struct pwc_device
*pdev
)
489 /* Freeing ISOC buffers one by one */
490 for (i
= 0; i
< MAX_ISO_BUFS
; i
++) {
492 PWC_DEBUG_MEMORY("Freeing URB\n");
493 if (pdev
->urbs
[i
]->transfer_buffer
) {
494 usb_free_coherent(pdev
->udev
,
495 pdev
->urbs
[i
]->transfer_buffer_length
,
496 pdev
->urbs
[i
]->transfer_buffer
,
497 pdev
->urbs
[i
]->transfer_dma
);
499 usb_free_urb(pdev
->urbs
[i
]);
500 pdev
->urbs
[i
] = NULL
;
505 static void pwc_isoc_cleanup(struct pwc_device
*pdev
)
507 PWC_DEBUG_OPEN(">> pwc_isoc_cleanup()\n");
509 if (pdev
->iso_init
== 0)
514 usb_set_interface(pdev
->udev
, 0, 0);
517 PWC_DEBUG_OPEN("<< pwc_isoc_cleanup()\n");
521 * Release all queued buffers, no need to take queued_bufs_lock, since all
522 * iso urbs have been killed when we're called so pwc_isoc_handler won't run.
524 static void pwc_cleanup_queued_bufs(struct pwc_device
*pdev
)
526 while (!list_empty(&pdev
->queued_bufs
)) {
527 struct pwc_frame_buf
*buf
;
529 buf
= list_entry(pdev
->queued_bufs
.next
, struct pwc_frame_buf
,
531 list_del(&buf
->list
);
532 vb2_buffer_done(&buf
->vb
, VB2_BUF_STATE_ERROR
);
539 static struct pwc_device
*cd_to_pwc(struct device
*cd
)
541 struct video_device
*vdev
= to_video_device(cd
);
542 return video_get_drvdata(vdev
);
545 static ssize_t
show_pan_tilt(struct device
*class_dev
,
546 struct device_attribute
*attr
, char *buf
)
548 struct pwc_device
*pdev
= cd_to_pwc(class_dev
);
549 return sprintf(buf
, "%d %d\n", pdev
->pan_angle
, pdev
->tilt_angle
);
552 static ssize_t
store_pan_tilt(struct device
*class_dev
,
553 struct device_attribute
*attr
,
554 const char *buf
, size_t count
)
556 struct pwc_device
*pdev
= cd_to_pwc(class_dev
);
560 if (strncmp(buf
, "reset", 5) == 0)
561 ret
= pwc_mpt_reset(pdev
, 0x3);
563 else if (sscanf(buf
, "%d %d", &pan
, &tilt
) > 0)
564 ret
= pwc_mpt_set_angle(pdev
, pan
, tilt
);
570 static DEVICE_ATTR(pan_tilt
, S_IRUGO
| S_IWUSR
, show_pan_tilt
,
573 static ssize_t
show_snapshot_button_status(struct device
*class_dev
,
574 struct device_attribute
*attr
, char *buf
)
576 struct pwc_device
*pdev
= cd_to_pwc(class_dev
);
577 int status
= pdev
->snapshot_button_status
;
578 pdev
->snapshot_button_status
= 0;
579 return sprintf(buf
, "%d\n", status
);
582 static DEVICE_ATTR(button
, S_IRUGO
| S_IWUSR
, show_snapshot_button_status
,
585 static int pwc_create_sysfs_files(struct pwc_device
*pdev
)
589 rc
= device_create_file(&pdev
->vdev
.dev
, &dev_attr_button
);
592 if (pdev
->features
& FEATURE_MOTOR_PANTILT
) {
593 rc
= device_create_file(&pdev
->vdev
.dev
, &dev_attr_pan_tilt
);
601 device_remove_file(&pdev
->vdev
.dev
, &dev_attr_button
);
603 PWC_ERROR("Could not create sysfs files.\n");
607 static void pwc_remove_sysfs_files(struct pwc_device
*pdev
)
609 if (pdev
->features
& FEATURE_MOTOR_PANTILT
)
610 device_remove_file(&pdev
->vdev
.dev
, &dev_attr_pan_tilt
);
611 device_remove_file(&pdev
->vdev
.dev
, &dev_attr_button
);
614 #ifdef CONFIG_USB_PWC_DEBUG
615 static const char *pwc_sensor_type_to_string(unsigned int sensor_type
)
617 switch(sensor_type
) {
619 return "Hyundai CMOS sensor";
621 return "Sony CCD sensor + TDA8787";
623 return "Sony CCD sensor + Exas 98L59";
625 return "Sony CCD sensor + ADI 9804";
627 return "Sharp CCD sensor + TDA8787";
629 return "Sharp CCD sensor + Exas 98L59";
631 return "Sharp CCD sensor + ADI 9804";
633 return "UPA 1021 sensor";
637 return "PAL MR sensor";
639 return "unknown type of sensor";
644 /***************************************************************************/
645 /* Video4Linux functions */
647 static int pwc_video_open(struct file
*file
)
649 struct video_device
*vdev
= video_devdata(file
);
650 struct pwc_device
*pdev
;
652 PWC_DEBUG_OPEN(">> video_open called(vdev = 0x%p).\n", vdev
);
654 pdev
= video_get_drvdata(vdev
);
658 file
->private_data
= vdev
;
659 PWC_DEBUG_OPEN("<< video_open() returns 0.\n");
663 static void pwc_video_release(struct video_device
*vfd
)
665 struct pwc_device
*pdev
= container_of(vfd
, struct pwc_device
, vdev
);
668 /* search device_hint[] table if we occupy a slot, by any chance */
669 for (hint
= 0; hint
< MAX_DEV_HINTS
; hint
++)
670 if (device_hint
[hint
].pdev
== pdev
)
671 device_hint
[hint
].pdev
= NULL
;
673 /* Free intermediate decompression buffer & tables */
674 if (pdev
->decompress_data
!= NULL
) {
675 PWC_DEBUG_MEMORY("Freeing decompression buffer at %p.\n",
676 pdev
->decompress_data
);
677 kfree(pdev
->decompress_data
);
678 pdev
->decompress_data
= NULL
;
681 v4l2_ctrl_handler_free(&pdev
->ctrl_handler
);
686 static int pwc_video_close(struct file
*file
)
688 struct video_device
*vdev
= file
->private_data
;
689 struct pwc_device
*pdev
;
691 PWC_DEBUG_OPEN(">> video_close called(vdev = 0x%p).\n", vdev
);
693 pdev
= video_get_drvdata(vdev
);
694 if (pdev
->capt_file
== file
) {
695 vb2_queue_release(&pdev
->vb_queue
);
696 pdev
->capt_file
= NULL
;
699 PWC_DEBUG_OPEN("<< video_close()\n");
703 static ssize_t
pwc_video_read(struct file
*file
, char __user
*buf
,
704 size_t count
, loff_t
*ppos
)
706 struct video_device
*vdev
= file
->private_data
;
707 struct pwc_device
*pdev
= video_get_drvdata(vdev
);
712 if (pdev
->capt_file
!= NULL
&&
713 pdev
->capt_file
!= file
)
716 pdev
->capt_file
= file
;
718 return vb2_read(&pdev
->vb_queue
, buf
, count
, ppos
,
719 file
->f_flags
& O_NONBLOCK
);
722 static unsigned int pwc_video_poll(struct file
*file
, poll_table
*wait
)
724 struct video_device
*vdev
= file
->private_data
;
725 struct pwc_device
*pdev
= video_get_drvdata(vdev
);
730 return vb2_poll(&pdev
->vb_queue
, file
, wait
);
733 static int pwc_video_mmap(struct file
*file
, struct vm_area_struct
*vma
)
735 struct video_device
*vdev
= file
->private_data
;
736 struct pwc_device
*pdev
= video_get_drvdata(vdev
);
738 if (pdev
->capt_file
!= file
)
741 return vb2_mmap(&pdev
->vb_queue
, vma
);
744 /***************************************************************************/
745 /* Videobuf2 operations */
747 static int queue_setup(struct vb2_queue
*vq
, unsigned int *nbuffers
,
748 unsigned int *nplanes
, unsigned long sizes
[],
751 struct pwc_device
*pdev
= vb2_get_drv_priv(vq
);
753 if (*nbuffers
< MIN_FRAMES
)
754 *nbuffers
= MIN_FRAMES
;
755 else if (*nbuffers
> MAX_FRAMES
)
756 *nbuffers
= MAX_FRAMES
;
760 sizes
[0] = PAGE_ALIGN((pdev
->abs_max
.x
* pdev
->abs_max
.y
* 3) / 2);
765 static int buffer_init(struct vb2_buffer
*vb
)
767 struct pwc_frame_buf
*buf
= container_of(vb
, struct pwc_frame_buf
, vb
);
769 /* need vmalloc since frame buffer > 128K */
770 buf
->data
= vzalloc(PWC_FRAME_SIZE
);
771 if (buf
->data
== NULL
)
777 static int buffer_prepare(struct vb2_buffer
*vb
)
779 struct pwc_device
*pdev
= vb2_get_drv_priv(vb
->vb2_queue
);
781 /* Don't allow queing new buffers after device disconnection */
788 static int buffer_finish(struct vb2_buffer
*vb
)
790 struct pwc_device
*pdev
= vb2_get_drv_priv(vb
->vb2_queue
);
791 struct pwc_frame_buf
*buf
= container_of(vb
, struct pwc_frame_buf
, vb
);
794 * Application has called dqbuf and is getting back a buffer we've
795 * filled, take the pwc data we've stored in buf->data and decompress
796 * it into a usable format, storing the result in the vb2_buffer
798 return pwc_decompress(pdev
, buf
);
801 static void buffer_cleanup(struct vb2_buffer
*vb
)
803 struct pwc_frame_buf
*buf
= container_of(vb
, struct pwc_frame_buf
, vb
);
808 static void buffer_queue(struct vb2_buffer
*vb
)
810 struct pwc_device
*pdev
= vb2_get_drv_priv(vb
->vb2_queue
);
811 struct pwc_frame_buf
*buf
= container_of(vb
, struct pwc_frame_buf
, vb
);
812 unsigned long flags
= 0;
814 spin_lock_irqsave(&pdev
->queued_bufs_lock
, flags
);
815 list_add_tail(&buf
->list
, &pdev
->queued_bufs
);
816 spin_unlock_irqrestore(&pdev
->queued_bufs_lock
, flags
);
819 static int start_streaming(struct vb2_queue
*vq
)
821 struct pwc_device
*pdev
= vb2_get_drv_priv(vq
);
826 /* Turn on camera and set LEDS on */
827 pwc_camera_power(pdev
, 1);
828 if (pdev
->power_save
) {
829 /* Restore video mode */
830 pwc_set_video_mode(pdev
, pdev
->view
.x
, pdev
->view
.y
,
831 pdev
->vframes
, pdev
->vcompression
,
834 pwc_set_leds(pdev
, led_on
, led_off
);
836 return pwc_isoc_init(pdev
);
839 static int stop_streaming(struct vb2_queue
*vq
)
841 struct pwc_device
*pdev
= vb2_get_drv_priv(vq
);
844 pwc_set_leds(pdev
, 0, 0);
845 pwc_camera_power(pdev
, 0);
846 pwc_isoc_cleanup(pdev
);
848 pwc_cleanup_queued_bufs(pdev
);
853 static void pwc_lock(struct vb2_queue
*vq
)
855 struct pwc_device
*pdev
= vb2_get_drv_priv(vq
);
856 mutex_lock(&pdev
->modlock
);
859 static void pwc_unlock(struct vb2_queue
*vq
)
861 struct pwc_device
*pdev
= vb2_get_drv_priv(vq
);
862 mutex_unlock(&pdev
->modlock
);
865 static struct vb2_ops pwc_vb_queue_ops
= {
866 .queue_setup
= queue_setup
,
867 .buf_init
= buffer_init
,
868 .buf_prepare
= buffer_prepare
,
869 .buf_finish
= buffer_finish
,
870 .buf_cleanup
= buffer_cleanup
,
871 .buf_queue
= buffer_queue
,
872 .start_streaming
= start_streaming
,
873 .stop_streaming
= stop_streaming
,
874 .wait_prepare
= pwc_unlock
,
875 .wait_finish
= pwc_lock
,
878 /***************************************************************************/
881 /* This function gets called when a new device is plugged in or the usb core
885 static int usb_pwc_probe(struct usb_interface
*intf
, const struct usb_device_id
*id
)
887 struct usb_device
*udev
= interface_to_usbdev(intf
);
888 struct pwc_device
*pdev
= NULL
;
889 int vendor_id
, product_id
, type_id
;
892 int video_nr
= -1; /* default: use next available device */
893 int my_power_save
= power_save
;
894 char serial_number
[30], *name
;
896 vendor_id
= le16_to_cpu(udev
->descriptor
.idVendor
);
897 product_id
= le16_to_cpu(udev
->descriptor
.idProduct
);
899 /* Check if we can handle this device */
900 PWC_DEBUG_PROBE("probe() called [%04X %04X], if %d\n",
901 vendor_id
, product_id
,
902 intf
->altsetting
->desc
.bInterfaceNumber
);
904 /* the interfaces are probed one by one. We are only interested in the
905 video interface (0) now.
906 Interface 1 is the Audio Control, and interface 2 Audio itself.
908 if (intf
->altsetting
->desc
.bInterfaceNumber
> 0)
911 if (vendor_id
== 0x0471) {
912 switch (product_id
) {
914 PWC_INFO("Philips PCA645VC USB webcam detected.\n");
915 name
= "Philips 645 webcam";
919 PWC_INFO("Philips PCA646VC USB webcam detected.\n");
920 name
= "Philips 646 webcam";
924 PWC_INFO("Askey VC010 type 2 USB webcam detected.\n");
925 name
= "Askey VC010 webcam";
929 PWC_INFO("Philips PCVC675K (Vesta) USB webcam detected.\n");
930 name
= "Philips 675 webcam";
934 PWC_INFO("Philips PCVC680K (Vesta Pro) USB webcam detected.\n");
935 name
= "Philips 680 webcam";
939 PWC_INFO("Philips PCVC690K (Vesta Pro Scan) USB webcam detected.\n");
940 name
= "Philips 690 webcam";
944 PWC_INFO("Philips PCVC730K (ToUCam Fun)/PCVC830 (ToUCam II) USB webcam detected.\n");
945 name
= "Philips 730 webcam";
949 PWC_INFO("Philips PCVC740K (ToUCam Pro)/PCVC840 (ToUCam II) USB webcam detected.\n");
950 name
= "Philips 740 webcam";
954 PWC_INFO("Philips PCVC750K (ToUCam Pro Scan) USB webcam detected.\n");
955 name
= "Philips 750 webcam";
959 PWC_INFO("Philips PCVC720K/40 (ToUCam XS) USB webcam detected.\n");
960 name
= "Philips 720K/40 webcam";
964 PWC_INFO("Philips SPC 900NC USB webcam detected.\n");
965 name
= "Philips SPC 900NC webcam";
973 else if (vendor_id
== 0x069A) {
976 PWC_INFO("Askey VC010 type 1 USB webcam detected.\n");
977 name
= "Askey VC010 webcam";
985 else if (vendor_id
== 0x046d) {
988 PWC_INFO("Logitech QuickCam Pro 3000 USB webcam detected.\n");
989 name
= "Logitech QuickCam Pro 3000";
990 type_id
= 740; /* CCD sensor */
993 PWC_INFO("Logitech QuickCam Notebook Pro USB webcam detected.\n");
994 name
= "Logitech QuickCam Notebook Pro";
995 type_id
= 740; /* CCD sensor */
998 PWC_INFO("Logitech QuickCam 4000 Pro USB webcam detected.\n");
999 name
= "Logitech QuickCam Pro 4000";
1000 type_id
= 740; /* CCD sensor */
1001 if (my_power_save
== -1)
1005 PWC_INFO("Logitech QuickCam Zoom USB webcam detected.\n");
1006 name
= "Logitech QuickCam Zoom";
1007 type_id
= 740; /* CCD sensor */
1010 PWC_INFO("Logitech QuickCam Zoom (new model) USB webcam detected.\n");
1011 name
= "Logitech QuickCam Zoom";
1012 type_id
= 740; /* CCD sensor */
1013 if (my_power_save
== -1)
1017 PWC_INFO("Logitech QuickCam Orbit/Sphere USB webcam detected.\n");
1018 name
= "Logitech QuickCam Orbit";
1019 type_id
= 740; /* CCD sensor */
1020 if (my_power_save
== -1)
1022 features
|= FEATURE_MOTOR_PANTILT
;
1025 PWC_INFO("Logitech/Cisco VT Camera webcam detected.\n");
1026 name
= "Cisco VT Camera";
1027 type_id
= 740; /* CCD sensor */
1030 PWC_INFO("Logitech ViewPort AV 100 webcam detected.\n");
1031 name
= "Logitech ViewPort AV 100";
1032 type_id
= 740; /* CCD sensor */
1034 case 0x08b8: /* Where this released? */
1035 PWC_INFO("Logitech QuickCam detected (reserved ID).\n");
1036 name
= "Logitech QuickCam (res.)";
1037 type_id
= 730; /* Assuming CMOS */
1044 else if (vendor_id
== 0x055d) {
1045 /* I don't know the difference between the C10 and the C30;
1046 I suppose the difference is the sensor, but both cameras
1047 work equally well with a type_id of 675
1049 switch(product_id
) {
1051 PWC_INFO("Samsung MPC-C10 USB webcam detected.\n");
1052 name
= "Samsung MPC-C10";
1056 PWC_INFO("Samsung MPC-C30 USB webcam detected.\n");
1057 name
= "Samsung MPC-C30";
1061 PWC_INFO("Samsung SNC-35E (v3.0) USB webcam detected.\n");
1062 name
= "Samsung MPC-C30";
1070 else if (vendor_id
== 0x041e) {
1071 switch(product_id
) {
1073 PWC_INFO("Creative Labs Webcam 5 detected.\n");
1074 name
= "Creative Labs Webcam 5";
1076 if (my_power_save
== -1)
1080 PWC_INFO("Creative Labs Webcam Pro Ex detected.\n");
1081 name
= "Creative Labs Webcam Pro Ex";
1089 else if (vendor_id
== 0x04cc) {
1090 switch(product_id
) {
1092 PWC_INFO("Sotec Afina Eye USB webcam detected.\n");
1093 name
= "Sotec Afina Eye";
1101 else if (vendor_id
== 0x06be) {
1102 switch(product_id
) {
1104 /* This is essentially the same cam as the Sotec Afina Eye */
1105 PWC_INFO("AME Co. Afina Eye USB webcam detected.\n");
1106 name
= "AME Co. Afina Eye";
1115 else if (vendor_id
== 0x0d81) {
1116 switch(product_id
) {
1118 PWC_INFO("Visionite VCS-UC300 USB webcam detected.\n");
1119 name
= "Visionite VCS-UC300";
1120 type_id
= 740; /* CCD sensor */
1123 PWC_INFO("Visionite VCS-UM100 USB webcam detected.\n");
1124 name
= "Visionite VCS-UM100";
1125 type_id
= 730; /* CMOS sensor */
1133 return -ENODEV
; /* Not any of the know types; but the list keeps growing. */
1135 if (my_power_save
== -1)
1138 memset(serial_number
, 0, 30);
1139 usb_string(udev
, udev
->descriptor
.iSerialNumber
, serial_number
, 29);
1140 PWC_DEBUG_PROBE("Device serial number is %s\n", serial_number
);
1142 if (udev
->descriptor
.bNumConfigurations
> 1)
1143 PWC_WARNING("Warning: more than 1 configuration available.\n");
1145 /* Allocate structure, initialize pointers, mutexes, etc. and link it to the usb_device */
1146 pdev
= kzalloc(sizeof(struct pwc_device
), GFP_KERNEL
);
1148 PWC_ERROR("Oops, could not allocate memory for pwc_device.\n");
1151 pdev
->type
= type_id
;
1152 pdev
->vframes
= default_fps
;
1153 strcpy(pdev
->serial
, serial_number
);
1154 pdev
->features
= features
;
1155 if (vendor_id
== 0x046D && product_id
== 0x08B5) {
1156 /* Logitech QuickCam Orbit
1157 The ranges have been determined experimentally; they may differ from cam to cam.
1158 Also, the exact ranges left-right and up-down are different for my cam
1160 pdev
->angle_range
.pan_min
= -7000;
1161 pdev
->angle_range
.pan_max
= 7000;
1162 pdev
->angle_range
.tilt_min
= -3000;
1163 pdev
->angle_range
.tilt_max
= 2500;
1165 pwc_construct(pdev
); /* set min/max sizes correct */
1167 mutex_init(&pdev
->modlock
);
1168 mutex_init(&pdev
->udevlock
);
1169 spin_lock_init(&pdev
->queued_bufs_lock
);
1170 INIT_LIST_HEAD(&pdev
->queued_bufs
);
1173 pdev
->vcompression
= pwc_preferred_compression
;
1174 pdev
->power_save
= my_power_save
;
1176 /* Init videobuf2 queue structure */
1177 memset(&pdev
->vb_queue
, 0, sizeof(pdev
->vb_queue
));
1178 pdev
->vb_queue
.type
= V4L2_BUF_TYPE_VIDEO_CAPTURE
;
1179 pdev
->vb_queue
.io_modes
= VB2_MMAP
| VB2_USERPTR
| VB2_READ
;
1180 pdev
->vb_queue
.drv_priv
= pdev
;
1181 pdev
->vb_queue
.buf_struct_size
= sizeof(struct pwc_frame_buf
);
1182 pdev
->vb_queue
.ops
= &pwc_vb_queue_ops
;
1183 pdev
->vb_queue
.mem_ops
= &vb2_vmalloc_memops
;
1184 vb2_queue_init(&pdev
->vb_queue
);
1186 /* Init video_device structure */
1187 memcpy(&pdev
->vdev
, &pwc_template
, sizeof(pwc_template
));
1188 pdev
->vdev
.parent
= &intf
->dev
;
1189 pdev
->vdev
.lock
= &pdev
->modlock
;
1190 strcpy(pdev
->vdev
.name
, name
);
1191 video_set_drvdata(&pdev
->vdev
, pdev
);
1193 pdev
->release
= le16_to_cpu(udev
->descriptor
.bcdDevice
);
1194 PWC_DEBUG_PROBE("Release: %04x\n", pdev
->release
);
1196 /* Now search device_hint[] table for a match, so we can hint a node number. */
1197 for (hint
= 0; hint
< MAX_DEV_HINTS
; hint
++) {
1198 if (((device_hint
[hint
].type
== -1) || (device_hint
[hint
].type
== pdev
->type
)) &&
1199 (device_hint
[hint
].pdev
== NULL
)) {
1200 /* so far, so good... try serial number */
1201 if ((device_hint
[hint
].serial_number
[0] == '*') || !strcmp(device_hint
[hint
].serial_number
, serial_number
)) {
1203 video_nr
= device_hint
[hint
].device_node
;
1204 PWC_DEBUG_PROBE("Found hint, will try to register as /dev/video%d\n", video_nr
);
1211 if (hint
< MAX_DEV_HINTS
)
1212 device_hint
[hint
].pdev
= pdev
;
1214 PWC_DEBUG_PROBE("probe() function returning struct at 0x%p.\n", pdev
);
1215 usb_set_intfdata(intf
, pdev
);
1217 #ifdef CONFIG_USB_PWC_DEBUG
1218 /* Query sensor type */
1219 if (pwc_get_cmos_sensor(pdev
, &rc
) >= 0) {
1220 PWC_DEBUG_OPEN("This %s camera is equipped with a %s (%d).\n",
1222 pwc_sensor_type_to_string(rc
), rc
);
1226 /* Set the leds off */
1227 pwc_set_leds(pdev
, 0, 0);
1229 /* Setup intial videomode */
1230 rc
= pwc_set_video_mode(pdev
, pdev
->view_max
.x
, pdev
->view_max
.y
,
1231 pdev
->vframes
, pdev
->vcompression
, 0);
1235 /* Register controls (and read default values from camera */
1236 rc
= pwc_init_controls(pdev
);
1238 PWC_ERROR("Failed to register v4l2 controls (%d).\n", rc
);
1242 pdev
->vdev
.ctrl_handler
= &pdev
->ctrl_handler
;
1244 /* And powerdown the camera until streaming starts */
1245 pwc_camera_power(pdev
, 0);
1247 rc
= video_register_device(&pdev
->vdev
, VFL_TYPE_GRABBER
, video_nr
);
1249 PWC_ERROR("Failed to register as video device (%d).\n", rc
);
1250 goto err_free_controls
;
1252 rc
= pwc_create_sysfs_files(pdev
);
1254 goto err_video_unreg
;
1256 PWC_INFO("Registered as %s.\n", video_device_node_name(&pdev
->vdev
));
1258 #ifdef CONFIG_USB_PWC_INPUT_EVDEV
1259 /* register webcam snapshot button input device */
1260 pdev
->button_dev
= input_allocate_device();
1261 if (!pdev
->button_dev
) {
1262 PWC_ERROR("Err, insufficient memory for webcam snapshot button device.");
1264 pwc_remove_sysfs_files(pdev
);
1265 goto err_video_unreg
;
1268 usb_make_path(udev
, pdev
->button_phys
, sizeof(pdev
->button_phys
));
1269 strlcat(pdev
->button_phys
, "/input0", sizeof(pdev
->button_phys
));
1271 pdev
->button_dev
->name
= "PWC snapshot button";
1272 pdev
->button_dev
->phys
= pdev
->button_phys
;
1273 usb_to_input_id(pdev
->udev
, &pdev
->button_dev
->id
);
1274 pdev
->button_dev
->dev
.parent
= &pdev
->udev
->dev
;
1275 pdev
->button_dev
->evbit
[0] = BIT_MASK(EV_KEY
);
1276 pdev
->button_dev
->keybit
[BIT_WORD(KEY_CAMERA
)] = BIT_MASK(KEY_CAMERA
);
1278 rc
= input_register_device(pdev
->button_dev
);
1280 input_free_device(pdev
->button_dev
);
1281 pdev
->button_dev
= NULL
;
1282 pwc_remove_sysfs_files(pdev
);
1283 goto err_video_unreg
;
1290 if (hint
< MAX_DEV_HINTS
)
1291 device_hint
[hint
].pdev
= NULL
;
1292 video_unregister_device(&pdev
->vdev
);
1294 v4l2_ctrl_handler_free(&pdev
->ctrl_handler
);
1296 usb_set_intfdata(intf
, NULL
);
1301 /* The user yanked out the cable... */
1302 static void usb_pwc_disconnect(struct usb_interface
*intf
)
1304 struct pwc_device
*pdev
= usb_get_intfdata(intf
);
1306 mutex_lock(&pdev
->udevlock
);
1307 mutex_lock(&pdev
->modlock
);
1309 usb_set_intfdata(intf
, NULL
);
1310 /* No need to keep the urbs around after disconnection */
1311 pwc_isoc_cleanup(pdev
);
1312 pwc_cleanup_queued_bufs(pdev
);
1315 mutex_unlock(&pdev
->modlock
);
1316 mutex_unlock(&pdev
->udevlock
);
1318 pwc_remove_sysfs_files(pdev
);
1319 video_unregister_device(&pdev
->vdev
);
1321 #ifdef CONFIG_USB_PWC_INPUT_EVDEV
1322 if (pdev
->button_dev
)
1323 input_unregister_device(pdev
->button_dev
);
1329 * Initialization code & module stuff
1333 static int compression
= -1;
1334 static int leds
[2] = { -1, -1 };
1335 static unsigned int leds_nargs
;
1336 static char *dev_hint
[MAX_DEV_HINTS
];
1337 static unsigned int dev_hint_nargs
;
1339 module_param(fps
, int, 0444);
1340 #ifdef CONFIG_USB_PWC_DEBUG
1341 module_param_named(trace
, pwc_trace
, int, 0644);
1343 module_param(power_save
, int, 0644);
1344 module_param(compression
, int, 0444);
1345 module_param_array(leds
, int, &leds_nargs
, 0444);
1346 module_param_array(dev_hint
, charp
, &dev_hint_nargs
, 0444);
1348 MODULE_PARM_DESC(fps
, "Initial frames per second. Varies with model, useful range 5-30");
1349 #ifdef CONFIG_USB_PWC_DEBUG
1350 MODULE_PARM_DESC(trace
, "For debugging purposes");
1352 MODULE_PARM_DESC(power_save
, "Turn power saving for new cameras on or off");
1353 MODULE_PARM_DESC(compression
, "Preferred compression quality. Range 0 (uncompressed) to 3 (high compression)");
1354 MODULE_PARM_DESC(leds
, "LED on,off time in milliseconds");
1355 MODULE_PARM_DESC(dev_hint
, "Device node hints");
1357 MODULE_DESCRIPTION("Philips & OEM USB webcam driver");
1358 MODULE_AUTHOR("Luc Saillard <luc@saillard.org>");
1359 MODULE_LICENSE("GPL");
1360 MODULE_ALIAS("pwcx");
1361 MODULE_VERSION( PWC_VERSION
);
1363 static int __init
usb_pwc_init(void)
1367 #ifdef CONFIG_USB_PWC_DEBUG
1368 PWC_INFO("Philips webcam module version " PWC_VERSION
" loaded.\n");
1369 PWC_INFO("Supports Philips PCA645/646, PCVC675/680/690, PCVC720[40]/730/740/750 & PCVC830/840.\n");
1370 PWC_INFO("Also supports the Askey VC010, various Logitech Quickcams, Samsung MPC-C10 and MPC-C30,\n");
1371 PWC_INFO("the Creative WebCam 5 & Pro Ex, SOTEC Afina Eye and Visionite VCS-UC300 and VCS-UM100.\n");
1373 if (pwc_trace
>= 0) {
1374 PWC_DEBUG_MODULE("Trace options: 0x%04x\n", pwc_trace
);
1379 if (fps
< 4 || fps
> 30) {
1380 PWC_ERROR("Framerate out of bounds (4-30).\n");
1384 PWC_DEBUG_MODULE("Default framerate set to %d.\n", default_fps
);
1387 if (compression
>= 0) {
1388 if (compression
> 3) {
1389 PWC_ERROR("Invalid compression setting; use a number between 0 (uncompressed) and 3 (high).\n");
1392 pwc_preferred_compression
= compression
;
1393 PWC_DEBUG_MODULE("Preferred compression set to %d.\n", pwc_preferred_compression
);
1400 /* Big device node whoopla. Basically, it allows you to assign a
1401 device node (/dev/videoX) to a camera, based on its type
1402 & serial number. The format is [type[.serialnumber]:]node.
1404 Any camera that isn't matched by these rules gets the next
1405 available free device node.
1407 for (i
= 0; i
< MAX_DEV_HINTS
; i
++) {
1408 char *s
, *colon
, *dot
;
1410 /* This loop also initializes the array */
1411 device_hint
[i
].pdev
= NULL
;
1413 if (s
!= NULL
&& *s
!= '\0') {
1414 device_hint
[i
].type
= -1; /* wildcard */
1415 strcpy(device_hint
[i
].serial_number
, "*");
1417 /* parse string: chop at ':' & '/' */
1419 while (*colon
!= '\0' && *colon
!= ':')
1421 while (*dot
!= '\0' && *dot
!= '.')
1423 /* Few sanity checks */
1424 if (*dot
!= '\0' && dot
> colon
) {
1425 PWC_ERROR("Malformed camera hint: the colon must be after the dot.\n");
1429 if (*colon
== '\0') {
1432 PWC_ERROR("Malformed camera hint: no colon + device node given.\n");
1436 /* No type or serial number specified, just a number. */
1437 device_hint
[i
].device_node
=
1438 simple_strtol(s
, NULL
, 10);
1442 /* There's a colon, so we have at least a type and a device node */
1443 device_hint
[i
].type
=
1444 simple_strtol(s
, NULL
, 10);
1445 device_hint
[i
].device_node
=
1446 simple_strtol(colon
+ 1, NULL
, 10);
1448 /* There's a serial number as well */
1453 while (*dot
!= ':' && k
< 29) {
1454 device_hint
[i
].serial_number
[k
++] = *dot
;
1457 device_hint
[i
].serial_number
[k
] = '\0';
1460 PWC_TRACE("device_hint[%d]:\n", i
);
1461 PWC_TRACE(" type : %d\n", device_hint
[i
].type
);
1462 PWC_TRACE(" serial# : %s\n", device_hint
[i
].serial_number
);
1463 PWC_TRACE(" node : %d\n", device_hint
[i
].device_node
);
1466 device_hint
[i
].type
= 0; /* not filled */
1467 } /* ..for MAX_DEV_HINTS */
1469 PWC_DEBUG_PROBE("Registering driver at address 0x%p.\n", &pwc_driver
);
1470 return usb_register(&pwc_driver
);
1473 static void __exit
usb_pwc_exit(void)
1475 PWC_DEBUG_MODULE("Deregistering driver.\n");
1476 usb_deregister(&pwc_driver
);
1477 PWC_INFO("Philips webcam module removed.\n");
1480 module_init(usb_pwc_init
);
1481 module_exit(usb_pwc_exit
);
1483 /* vim: set cino= formatoptions=croql cindent shiftwidth=8 tabstop=8: */