]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - drivers/media/video/usbvideo/usbvideo.c
V4L/DVB (10135): v4l2: introduce v4l2_file_operations.
[mirror_ubuntu-artful-kernel.git] / drivers / media / video / usbvideo / usbvideo.c
CommitLineData
1da177e4
LT
1/*
2 * This program is free software; you can redistribute it and/or modify
3 * it under the terms of the GNU General Public License as published by
4 * the Free Software Foundation; either version 2, or (at your option)
5 * any later version.
6 *
7 * This program is distributed in the hope that it will be useful,
8 * but WITHOUT ANY WARRANTY; without even the implied warranty of
9 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10 * GNU General Public License for more details.
11 *
12 * You should have received a copy of the GNU General Public License
13 * along with this program; if not, write to the Free Software
14 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
15 */
16
17#include <linux/kernel.h>
18#include <linux/sched.h>
19#include <linux/list.h>
20#include <linux/slab.h>
21#include <linux/module.h>
22#include <linux/mm.h>
1da177e4
LT
23#include <linux/vmalloc.h>
24#include <linux/init.h>
25#include <linux/spinlock.h>
26
27#include <asm/io.h>
28
29#include "usbvideo.h"
30
31#if defined(MAP_NR)
32#define virt_to_page(v) MAP_NR(v) /* Kernels 2.2.x */
33#endif
34
35static int video_nr = -1;
36module_param(video_nr, int, 0);
37
38/*
39 * Local prototypes.
40 */
41static void usbvideo_Disconnect(struct usb_interface *intf);
42static void usbvideo_CameraRelease(struct uvd *uvd);
43
bec43661 44static int usbvideo_v4l_ioctl(struct file *file,
1da177e4
LT
45 unsigned int cmd, unsigned long arg);
46static int usbvideo_v4l_mmap(struct file *file, struct vm_area_struct *vma);
bec43661 47static int usbvideo_v4l_open(struct file *file);
1da177e4
LT
48static ssize_t usbvideo_v4l_read(struct file *file, char __user *buf,
49 size_t count, loff_t *ppos);
bec43661 50static int usbvideo_v4l_close(struct file *file);
1da177e4
LT
51
52static int usbvideo_StartDataPump(struct uvd *uvd);
53static void usbvideo_StopDataPump(struct uvd *uvd);
54static int usbvideo_GetFrame(struct uvd *uvd, int frameNum);
55static int usbvideo_NewFrame(struct uvd *uvd, int framenum);
56static void usbvideo_SoftwareContrastAdjustment(struct uvd *uvd,
57 struct usbvideo_frame *frame);
58
59/*******************************/
60/* Memory management functions */
61/*******************************/
62static void *usbvideo_rvmalloc(unsigned long size)
63{
64 void *mem;
65 unsigned long adr;
66
67 size = PAGE_ALIGN(size);
68 mem = vmalloc_32(size);
69 if (!mem)
70 return NULL;
71
72 memset(mem, 0, size); /* Clear the ram out, no junk to the user */
73 adr = (unsigned long) mem;
74 while (size > 0) {
75 SetPageReserved(vmalloc_to_page((void *)adr));
76 adr += PAGE_SIZE;
77 size -= PAGE_SIZE;
78 }
79
80 return mem;
81}
82
83static void usbvideo_rvfree(void *mem, unsigned long size)
84{
85 unsigned long adr;
86
87 if (!mem)
88 return;
89
90 adr = (unsigned long) mem;
91 while ((long) size > 0) {
92 ClearPageReserved(vmalloc_to_page((void *)adr));
93 adr += PAGE_SIZE;
94 size -= PAGE_SIZE;
95 }
96 vfree(mem);
97}
98
99static void RingQueue_Initialize(struct RingQueue *rq)
100{
101 assert(rq != NULL);
102 init_waitqueue_head(&rq->wqh);
103}
104
105static void RingQueue_Allocate(struct RingQueue *rq, int rqLen)
106{
107 /* Make sure the requested size is a power of 2 and
108 round up if necessary. This allows index wrapping
109 using masks rather than modulo */
110
111 int i = 1;
112 assert(rq != NULL);
113 assert(rqLen > 0);
114
115 while(rqLen >> i)
116 i++;
117 if(rqLen != 1 << (i-1))
118 rqLen = 1 << i;
119
120 rq->length = rqLen;
121 rq->ri = rq->wi = 0;
122 rq->queue = usbvideo_rvmalloc(rq->length);
123 assert(rq->queue != NULL);
124}
125
126static int RingQueue_IsAllocated(const struct RingQueue *rq)
127{
128 if (rq == NULL)
129 return 0;
130 return (rq->queue != NULL) && (rq->length > 0);
131}
132
133static void RingQueue_Free(struct RingQueue *rq)
134{
135 assert(rq != NULL);
136 if (RingQueue_IsAllocated(rq)) {
137 usbvideo_rvfree(rq->queue, rq->length);
138 rq->queue = NULL;
139 rq->length = 0;
140 }
141}
142
143int RingQueue_Dequeue(struct RingQueue *rq, unsigned char *dst, int len)
144{
145 int rql, toread;
146
147 assert(rq != NULL);
148 assert(dst != NULL);
149
150 rql = RingQueue_GetLength(rq);
151 if(!rql)
152 return 0;
153
154 /* Clip requested length to available data */
155 if(len > rql)
156 len = rql;
157
158 toread = len;
159 if(rq->ri > rq->wi) {
160 /* Read data from tail */
161 int read = (toread < (rq->length - rq->ri)) ? toread : rq->length - rq->ri;
162 memcpy(dst, rq->queue + rq->ri, read);
163 toread -= read;
164 dst += read;
165 rq->ri = (rq->ri + read) & (rq->length-1);
166 }
167 if(toread) {
168 /* Read data from head */
169 memcpy(dst, rq->queue + rq->ri, toread);
170 rq->ri = (rq->ri + toread) & (rq->length-1);
171 }
172 return len;
173}
174
175EXPORT_SYMBOL(RingQueue_Dequeue);
176
177int RingQueue_Enqueue(struct RingQueue *rq, const unsigned char *cdata, int n)
178{
179 int enqueued = 0;
180
181 assert(rq != NULL);
182 assert(cdata != NULL);
183 assert(rq->length > 0);
184 while (n > 0) {
185 int m, q_avail;
186
187 /* Calculate the largest chunk that fits the tail of the ring */
188 q_avail = rq->length - rq->wi;
189 if (q_avail <= 0) {
190 rq->wi = 0;
191 q_avail = rq->length;
192 }
193 m = n;
194 assert(q_avail > 0);
195 if (m > q_avail)
196 m = q_avail;
197
198 memcpy(rq->queue + rq->wi, cdata, m);
199 RING_QUEUE_ADVANCE_INDEX(rq, wi, m);
200 cdata += m;
201 enqueued += m;
202 n -= m;
203 }
204 return enqueued;
205}
206
207EXPORT_SYMBOL(RingQueue_Enqueue);
208
209static void RingQueue_InterruptibleSleepOn(struct RingQueue *rq)
210{
211 assert(rq != NULL);
212 interruptible_sleep_on(&rq->wqh);
213}
214
215void RingQueue_WakeUpInterruptible(struct RingQueue *rq)
216{
217 assert(rq != NULL);
218 if (waitqueue_active(&rq->wqh))
219 wake_up_interruptible(&rq->wqh);
220}
221
222EXPORT_SYMBOL(RingQueue_WakeUpInterruptible);
223
224void RingQueue_Flush(struct RingQueue *rq)
225{
226 assert(rq != NULL);
227 rq->ri = 0;
228 rq->wi = 0;
229}
230
231EXPORT_SYMBOL(RingQueue_Flush);
232
233
234/*
235 * usbvideo_VideosizeToString()
236 *
237 * This procedure converts given videosize value to readable string.
238 *
239 * History:
240 * 07-Aug-2000 Created.
241 * 19-Oct-2000 Reworked for usbvideo module.
242 */
243static void usbvideo_VideosizeToString(char *buf, int bufLen, videosize_t vs)
244{
245 char tmp[40];
246 int n;
247
248 n = 1 + sprintf(tmp, "%ldx%ld", VIDEOSIZE_X(vs), VIDEOSIZE_Y(vs));
249 assert(n < sizeof(tmp));
250 if ((buf == NULL) || (bufLen < n))
251 err("usbvideo_VideosizeToString: buffer is too small.");
252 else
253 memmove(buf, tmp, n);
254}
255
256/*
257 * usbvideo_OverlayChar()
258 *
259 * History:
260 * 01-Feb-2000 Created.
261 */
262static void usbvideo_OverlayChar(struct uvd *uvd, struct usbvideo_frame *frame,
263 int x, int y, int ch)
264{
265 static const unsigned short digits[16] = {
266 0xF6DE, /* 0 */
267 0x2492, /* 1 */
268 0xE7CE, /* 2 */
269 0xE79E, /* 3 */
270 0xB792, /* 4 */
271 0xF39E, /* 5 */
272 0xF3DE, /* 6 */
273 0xF492, /* 7 */
274 0xF7DE, /* 8 */
275 0xF79E, /* 9 */
276 0x77DA, /* a */
277 0xD75C, /* b */
278 0xF24E, /* c */
279 0xD6DC, /* d */
280 0xF34E, /* e */
281 0xF348 /* f */
282 };
283 unsigned short digit;
284 int ix, iy;
285
286 if ((uvd == NULL) || (frame == NULL))
287 return;
288
289 if (ch >= '0' && ch <= '9')
290 ch -= '0';
291 else if (ch >= 'A' && ch <= 'F')
292 ch = 10 + (ch - 'A');
293 else if (ch >= 'a' && ch <= 'f')
294 ch = 10 + (ch - 'a');
295 else
296 return;
297 digit = digits[ch];
298
299 for (iy=0; iy < 5; iy++) {
300 for (ix=0; ix < 3; ix++) {
301 if (digit & 0x8000) {
302 if (uvd->paletteBits & (1L << VIDEO_PALETTE_RGB24)) {
303/* TODO */ RGB24_PUTPIXEL(frame, x+ix, y+iy, 0xFF, 0xFF, 0xFF);
304 }
305 }
306 digit = digit << 1;
307 }
308 }
309}
310
311/*
312 * usbvideo_OverlayString()
313 *
314 * History:
315 * 01-Feb-2000 Created.
316 */
317static void usbvideo_OverlayString(struct uvd *uvd, struct usbvideo_frame *frame,
318 int x, int y, const char *str)
319{
320 while (*str) {
321 usbvideo_OverlayChar(uvd, frame, x, y, *str);
322 str++;
323 x += 4; /* 3 pixels character + 1 space */
324 }
325}
326
327/*
328 * usbvideo_OverlayStats()
329 *
330 * Overlays important debugging information.
331 *
332 * History:
333 * 01-Feb-2000 Created.
334 */
335static void usbvideo_OverlayStats(struct uvd *uvd, struct usbvideo_frame *frame)
336{
337 const int y_diff = 8;
338 char tmp[16];
339 int x = 10, y=10;
340 long i, j, barLength;
341 const int qi_x1 = 60, qi_y1 = 10;
342 const int qi_x2 = VIDEOSIZE_X(frame->request) - 10, qi_h = 10;
343
344 /* Call the user callback, see if we may proceed after that */
345 if (VALID_CALLBACK(uvd, overlayHook)) {
346 if (GET_CALLBACK(uvd, overlayHook)(uvd, frame) < 0)
347 return;
348 }
349
350 /*
351 * We draw a (mostly) hollow rectangle with qi_xxx coordinates.
352 * Left edge symbolizes the queue index 0; right edge symbolizes
353 * the full capacity of the queue.
354 */
355 barLength = qi_x2 - qi_x1 - 2;
356 if ((barLength > 10) && (uvd->paletteBits & (1L << VIDEO_PALETTE_RGB24))) {
357/* TODO */ long u_lo, u_hi, q_used;
358 long m_ri, m_wi, m_lo, m_hi;
359
360 /*
361 * Determine fill zones (used areas of the queue):
362 * 0 xxxxxxx u_lo ...... uvd->dp.ri xxxxxxxx u_hi ..... uvd->dp.length
363 *
364 * if u_lo < 0 then there is no first filler.
365 */
366
367 q_used = RingQueue_GetLength(&uvd->dp);
368 if ((uvd->dp.ri + q_used) >= uvd->dp.length) {
369 u_hi = uvd->dp.length;
370 u_lo = (q_used + uvd->dp.ri) & (uvd->dp.length-1);
371 } else {
372 u_hi = (q_used + uvd->dp.ri);
373 u_lo = -1;
374 }
375
376 /* Convert byte indices into screen units */
377 m_ri = qi_x1 + ((barLength * uvd->dp.ri) / uvd->dp.length);
378 m_wi = qi_x1 + ((barLength * uvd->dp.wi) / uvd->dp.length);
379 m_lo = (u_lo > 0) ? (qi_x1 + ((barLength * u_lo) / uvd->dp.length)) : -1;
380 m_hi = qi_x1 + ((barLength * u_hi) / uvd->dp.length);
381
382 for (j=qi_y1; j < (qi_y1 + qi_h); j++) {
383 for (i=qi_x1; i < qi_x2; i++) {
384 /* Draw border lines */
385 if ((j == qi_y1) || (j == (qi_y1 + qi_h - 1)) ||
386 (i == qi_x1) || (i == (qi_x2 - 1))) {
387 RGB24_PUTPIXEL(frame, i, j, 0xFF, 0xFF, 0xFF);
388 continue;
389 }
390 /* For all other points the Y coordinate does not matter */
391 if ((i >= m_ri) && (i <= (m_ri + 3))) {
392 RGB24_PUTPIXEL(frame, i, j, 0x00, 0xFF, 0x00);
393 } else if ((i >= m_wi) && (i <= (m_wi + 3))) {
394 RGB24_PUTPIXEL(frame, i, j, 0xFF, 0x00, 0x00);
395 } else if ((i < m_lo) || ((i > m_ri) && (i < m_hi)))
396 RGB24_PUTPIXEL(frame, i, j, 0x00, 0x00, 0xFF);
397 }
398 }
399 }
400
401 sprintf(tmp, "%8lx", uvd->stats.frame_num);
402 usbvideo_OverlayString(uvd, frame, x, y, tmp);
403 y += y_diff;
404
405 sprintf(tmp, "%8lx", uvd->stats.urb_count);
406 usbvideo_OverlayString(uvd, frame, x, y, tmp);
407 y += y_diff;
408
409 sprintf(tmp, "%8lx", uvd->stats.urb_length);
410 usbvideo_OverlayString(uvd, frame, x, y, tmp);
411 y += y_diff;
412
413 sprintf(tmp, "%8lx", uvd->stats.data_count);
414 usbvideo_OverlayString(uvd, frame, x, y, tmp);
415 y += y_diff;
416
417 sprintf(tmp, "%8lx", uvd->stats.header_count);
418 usbvideo_OverlayString(uvd, frame, x, y, tmp);
419 y += y_diff;
420
421 sprintf(tmp, "%8lx", uvd->stats.iso_skip_count);
422 usbvideo_OverlayString(uvd, frame, x, y, tmp);
423 y += y_diff;
424
425 sprintf(tmp, "%8lx", uvd->stats.iso_err_count);
426 usbvideo_OverlayString(uvd, frame, x, y, tmp);
427 y += y_diff;
428
429 sprintf(tmp, "%8x", uvd->vpic.colour);
430 usbvideo_OverlayString(uvd, frame, x, y, tmp);
431 y += y_diff;
432
433 sprintf(tmp, "%8x", uvd->vpic.hue);
434 usbvideo_OverlayString(uvd, frame, x, y, tmp);
435 y += y_diff;
436
437 sprintf(tmp, "%8x", uvd->vpic.brightness >> 8);
438 usbvideo_OverlayString(uvd, frame, x, y, tmp);
439 y += y_diff;
440
441 sprintf(tmp, "%8x", uvd->vpic.contrast >> 12);
442 usbvideo_OverlayString(uvd, frame, x, y, tmp);
443 y += y_diff;
444
445 sprintf(tmp, "%8d", uvd->vpic.whiteness >> 8);
446 usbvideo_OverlayString(uvd, frame, x, y, tmp);
447 y += y_diff;
448}
449
450/*
451 * usbvideo_ReportStatistics()
452 *
453 * This procedure prints packet and transfer statistics.
454 *
455 * History:
456 * 14-Jan-2000 Corrected default multiplier.
457 */
458static void usbvideo_ReportStatistics(const struct uvd *uvd)
459{
460 if ((uvd != NULL) && (uvd->stats.urb_count > 0)) {
461 unsigned long allPackets, badPackets, goodPackets, percent;
462 allPackets = uvd->stats.urb_count * CAMERA_URB_FRAMES;
463 badPackets = uvd->stats.iso_skip_count + uvd->stats.iso_err_count;
464 goodPackets = allPackets - badPackets;
465 /* Calculate percentage wisely, remember integer limits */
466 assert(allPackets != 0);
467 if (goodPackets < (((unsigned long)-1)/100))
468 percent = (100 * goodPackets) / allPackets;
469 else
470 percent = goodPackets / (allPackets / 100);
a482f327
GKH
471 dev_info(&uvd->dev->dev,
472 "Packet Statistics: Total=%lu. Empty=%lu. Usage=%lu%%\n",
473 allPackets, badPackets, percent);
1da177e4
LT
474 if (uvd->iso_packet_len > 0) {
475 unsigned long allBytes, xferBytes;
476 char multiplier = ' ';
477 allBytes = allPackets * uvd->iso_packet_len;
478 xferBytes = uvd->stats.data_count;
479 assert(allBytes != 0);
480 if (xferBytes < (((unsigned long)-1)/100))
481 percent = (100 * xferBytes) / allBytes;
482 else
483 percent = xferBytes / (allBytes / 100);
484 /* Scale xferBytes for easy reading */
485 if (xferBytes > 10*1024) {
486 xferBytes /= 1024;
487 multiplier = 'K';
488 if (xferBytes > 10*1024) {
489 xferBytes /= 1024;
490 multiplier = 'M';
491 if (xferBytes > 10*1024) {
492 xferBytes /= 1024;
493 multiplier = 'G';
494 if (xferBytes > 10*1024) {
495 xferBytes /= 1024;
496 multiplier = 'T';
497 }
498 }
499 }
500 }
a482f327
GKH
501 dev_info(&uvd->dev->dev,
502 "Transfer Statistics: Transferred=%lu%cB Usage=%lu%%\n",
503 xferBytes, multiplier, percent);
1da177e4
LT
504 }
505 }
506}
507
508/*
509 * usbvideo_TestPattern()
510 *
511 * Procedure forms a test pattern (yellow grid on blue background).
512 *
513 * Parameters:
514 * fullframe: if TRUE then entire frame is filled, otherwise the procedure
515 * continues from the current scanline.
516 * pmode 0: fill the frame with solid blue color (like on VCR or TV)
517 * 1: Draw a colored grid
518 *
519 * History:
520 * 01-Feb-2000 Created.
521 */
522void usbvideo_TestPattern(struct uvd *uvd, int fullframe, int pmode)
523{
524 struct usbvideo_frame *frame;
525 int num_cell = 0;
526 int scan_length = 0;
ff699e6b 527 static int num_pass;
1da177e4
LT
528
529 if (uvd == NULL) {
4126a8f5 530 err("%s: uvd == NULL", __func__);
1da177e4
LT
531 return;
532 }
533 if ((uvd->curframe < 0) || (uvd->curframe >= USBVIDEO_NUMFRAMES)) {
4126a8f5 534 err("%s: uvd->curframe=%d.", __func__, uvd->curframe);
1da177e4
LT
535 return;
536 }
537
538 /* Grab the current frame */
539 frame = &uvd->frame[uvd->curframe];
540
541 /* Optionally start at the beginning */
542 if (fullframe) {
543 frame->curline = 0;
544 frame->seqRead_Length = 0;
545 }
546#if 0
547 { /* For debugging purposes only */
548 char tmp[20];
549 usbvideo_VideosizeToString(tmp, sizeof(tmp), frame->request);
a482f327 550 dev_info(&uvd->dev->dev, "testpattern: frame=%s\n", tmp);
1da177e4
LT
551 }
552#endif
553 /* Form every scan line */
554 for (; frame->curline < VIDEOSIZE_Y(frame->request); frame->curline++) {
555 int i;
556 unsigned char *f = frame->data +
557 (VIDEOSIZE_X(frame->request) * V4L_BYTES_PER_PIXEL * frame->curline);
558 for (i=0; i < VIDEOSIZE_X(frame->request); i++) {
559 unsigned char cb=0x80;
560 unsigned char cg = 0;
561 unsigned char cr = 0;
562
563 if (pmode == 1) {
564 if (frame->curline % 32 == 0)
565 cb = 0, cg = cr = 0xFF;
566 else if (i % 32 == 0) {
567 if (frame->curline % 32 == 1)
568 num_cell++;
569 cb = 0, cg = cr = 0xFF;
570 } else {
571 cb = ((num_cell*7) + num_pass) & 0xFF;
572 cg = ((num_cell*5) + num_pass*2) & 0xFF;
573 cr = ((num_cell*3) + num_pass*3) & 0xFF;
574 }
575 } else {
576 /* Just the blue screen */
577 }
d56410e0 578
1da177e4
LT
579 *f++ = cb;
580 *f++ = cg;
581 *f++ = cr;
582 scan_length += 3;
583 }
584 }
585
586 frame->frameState = FrameState_Done;
587 frame->seqRead_Length += scan_length;
588 ++num_pass;
589
590 /* We do this unconditionally, regardless of FLAGS_OVERLAY_STATS */
591 usbvideo_OverlayStats(uvd, frame);
592}
593
594EXPORT_SYMBOL(usbvideo_TestPattern);
595
596
597#ifdef DEBUG
598/*
599 * usbvideo_HexDump()
600 *
601 * A debugging tool. Prints hex dumps.
602 *
603 * History:
604 * 29-Jul-2000 Added printing of offsets.
605 */
606void usbvideo_HexDump(const unsigned char *data, int len)
607{
608 const int bytes_per_line = 32;
609 char tmp[128]; /* 32*3 + 5 */
610 int i, k;
611
612 for (i=k=0; len > 0; i++, len--) {
613 if (i > 0 && ((i % bytes_per_line) == 0)) {
614 printk("%s\n", tmp);
615 k=0;
616 }
617 if ((i % bytes_per_line) == 0)
618 k += sprintf(&tmp[k], "%04x: ", i);
619 k += sprintf(&tmp[k], "%02x ", data[i]);
620 }
621 if (k > 0)
622 printk("%s\n", tmp);
623}
624
625EXPORT_SYMBOL(usbvideo_HexDump);
626
627#endif
628
629/* ******************************************************************** */
630
631/* XXX: this piece of crap really wants some error handling.. */
5332bdbe 632static int usbvideo_ClientIncModCount(struct uvd *uvd)
1da177e4
LT
633{
634 if (uvd == NULL) {
4126a8f5 635 err("%s: uvd == NULL", __func__);
5332bdbe 636 return -EINVAL;
1da177e4
LT
637 }
638 if (uvd->handle == NULL) {
4126a8f5 639 err("%s: uvd->handle == NULL", __func__);
5332bdbe 640 return -EINVAL;
1da177e4
LT
641 }
642 if (!try_module_get(uvd->handle->md_module)) {
4126a8f5 643 err("%s: try_module_get() == 0", __func__);
5332bdbe 644 return -ENODEV;
1da177e4 645 }
5332bdbe 646 return 0;
1da177e4
LT
647}
648
649static void usbvideo_ClientDecModCount(struct uvd *uvd)
650{
651 if (uvd == NULL) {
4126a8f5 652 err("%s: uvd == NULL", __func__);
1da177e4
LT
653 return;
654 }
655 if (uvd->handle == NULL) {
4126a8f5 656 err("%s: uvd->handle == NULL", __func__);
1da177e4
LT
657 return;
658 }
659 if (uvd->handle->md_module == NULL) {
4126a8f5 660 err("%s: uvd->handle->md_module == NULL", __func__);
1da177e4
LT
661 return;
662 }
663 module_put(uvd->handle->md_module);
664}
665
666int usbvideo_register(
667 struct usbvideo **pCams,
668 const int num_cams,
669 const int num_extra,
670 const char *driverName,
671 const struct usbvideo_cb *cbTbl,
672 struct module *md,
673 const struct usb_device_id *id_table)
674{
675 struct usbvideo *cams;
676 int i, base_size, result;
677
678 /* Check parameters for sanity */
679 if ((num_cams <= 0) || (pCams == NULL) || (cbTbl == NULL)) {
4126a8f5 680 err("%s: Illegal call", __func__);
1da177e4
LT
681 return -EINVAL;
682 }
683
684 /* Check registration callback - must be set! */
685 if (cbTbl->probe == NULL) {
4126a8f5 686 err("%s: probe() is required!", __func__);
1da177e4
LT
687 return -EINVAL;
688 }
689
690 base_size = num_cams * sizeof(struct uvd) + sizeof(struct usbvideo);
5cbded58 691 cams = kzalloc(base_size, GFP_KERNEL);
1da177e4
LT
692 if (cams == NULL) {
693 err("Failed to allocate %d. bytes for usbvideo struct", base_size);
694 return -ENOMEM;
695 }
696 dbg("%s: Allocated $%p (%d. bytes) for %d. cameras",
4126a8f5 697 __func__, cams, base_size, num_cams);
1da177e4
LT
698
699 /* Copy callbacks, apply defaults for those that are not set */
700 memmove(&cams->cb, cbTbl, sizeof(cams->cb));
701 if (cams->cb.getFrame == NULL)
702 cams->cb.getFrame = usbvideo_GetFrame;
703 if (cams->cb.disconnect == NULL)
704 cams->cb.disconnect = usbvideo_Disconnect;
705 if (cams->cb.startDataPump == NULL)
706 cams->cb.startDataPump = usbvideo_StartDataPump;
707 if (cams->cb.stopDataPump == NULL)
708 cams->cb.stopDataPump = usbvideo_StopDataPump;
709
710 cams->num_cameras = num_cams;
711 cams->cam = (struct uvd *) &cams[1];
712 cams->md_module = md;
4186ecf8 713 mutex_init(&cams->lock); /* to 1 == available */
1da177e4
LT
714
715 for (i = 0; i < num_cams; i++) {
716 struct uvd *up = &cams->cam[i];
717
718 up->handle = cams;
719
720 /* Allocate user_data separately because of kmalloc's limits */
721 if (num_extra > 0) {
722 up->user_size = num_cams * num_extra;
0e8eb0f0 723 up->user_data = kmalloc(up->user_size, GFP_KERNEL);
1da177e4
LT
724 if (up->user_data == NULL) {
725 err("%s: Failed to allocate user_data (%d. bytes)",
4126a8f5 726 __func__, up->user_size);
1da177e4
LT
727 while (i) {
728 up = &cams->cam[--i];
729 kfree(up->user_data);
730 }
731 kfree(cams);
732 return -ENOMEM;
733 }
734 dbg("%s: Allocated cams[%d].user_data=$%p (%d. bytes)",
4126a8f5 735 __func__, i, up->user_data, up->user_size);
1da177e4
LT
736 }
737 }
738
739 /*
740 * Register ourselves with USB stack.
741 */
742 strcpy(cams->drvName, (driverName != NULL) ? driverName : "Unknown");
743 cams->usbdrv.name = cams->drvName;
744 cams->usbdrv.probe = cams->cb.probe;
745 cams->usbdrv.disconnect = cams->cb.disconnect;
746 cams->usbdrv.id_table = id_table;
747
748 /*
749 * Update global handle to usbvideo. This is very important
750 * because probe() can be called before usb_register() returns.
751 * If the handle is not yet updated then the probe() will fail.
752 */
753 *pCams = cams;
754 result = usb_register(&cams->usbdrv);
755 if (result) {
756 for (i = 0; i < num_cams; i++) {
757 struct uvd *up = &cams->cam[i];
758 kfree(up->user_data);
759 }
760 kfree(cams);
761 }
762
763 return result;
764}
765
766EXPORT_SYMBOL(usbvideo_register);
767
768/*
769 * usbvideo_Deregister()
770 *
771 * Procedure frees all usbvideo and user data structures. Be warned that
772 * if you had some dynamically allocated components in ->user field then
773 * you should free them before calling here.
774 */
775void usbvideo_Deregister(struct usbvideo **pCams)
776{
777 struct usbvideo *cams;
778 int i;
779
780 if (pCams == NULL) {
4126a8f5 781 err("%s: pCams == NULL", __func__);
1da177e4
LT
782 return;
783 }
784 cams = *pCams;
785 if (cams == NULL) {
4126a8f5 786 err("%s: cams == NULL", __func__);
1da177e4
LT
787 return;
788 }
789
4126a8f5 790 dbg("%s: Deregistering %s driver.", __func__, cams->drvName);
1da177e4
LT
791 usb_deregister(&cams->usbdrv);
792
4126a8f5 793 dbg("%s: Deallocating cams=$%p (%d. cameras)", __func__, cams, cams->num_cameras);
1da177e4
LT
794 for (i=0; i < cams->num_cameras; i++) {
795 struct uvd *up = &cams->cam[i];
796 int warning = 0;
797
798 if (up->user_data != NULL) {
799 if (up->user_size <= 0)
800 ++warning;
801 } else {
802 if (up->user_size > 0)
803 ++warning;
804 }
805 if (warning) {
806 err("%s: Warning: user_data=$%p user_size=%d.",
4126a8f5 807 __func__, up->user_data, up->user_size);
1da177e4
LT
808 } else {
809 dbg("%s: Freeing %d. $%p->user_data=$%p",
4126a8f5 810 __func__, i, up, up->user_data);
1da177e4
LT
811 kfree(up->user_data);
812 }
813 }
814 /* Whole array was allocated in one chunk */
815 dbg("%s: Freed %d uvd structures",
4126a8f5 816 __func__, cams->num_cameras);
1da177e4
LT
817 kfree(cams);
818 *pCams = NULL;
819}
820
821EXPORT_SYMBOL(usbvideo_Deregister);
822
823/*
824 * usbvideo_Disconnect()
825 *
826 * This procedure stops all driver activity. Deallocation of
827 * the interface-private structure (pointed by 'ptr') is done now
828 * (if we don't have any open files) or later, when those files
829 * are closed. After that driver should be removable.
830 *
831 * This code handles surprise removal. The uvd->user is a counter which
832 * increments on open() and decrements on close(). If we see here that
833 * this counter is not 0 then we have a client who still has us opened.
834 * We set uvd->remove_pending flag as early as possible, and after that
835 * all access to the camera will gracefully fail. These failures should
836 * prompt client to (eventually) close the video device, and then - in
837 * usbvideo_v4l_close() - we decrement uvd->uvd_used and usage counter.
838 *
839 * History:
840 * 22-Jan-2000 Added polling of MOD_IN_USE to delay removal until all users gone.
841 * 27-Jan-2000 Reworked to allow pending disconnects; see xxx_close()
842 * 24-May-2000 Corrected to prevent race condition (MOD_xxx_USE_COUNT).
843 * 19-Oct-2000 Moved to usbvideo module.
844 */
845static void usbvideo_Disconnect(struct usb_interface *intf)
846{
847 struct uvd *uvd = usb_get_intfdata (intf);
848 int i;
849
850 if (uvd == NULL) {
4126a8f5 851 err("%s($%p): Illegal call.", __func__, intf);
1da177e4
LT
852 return;
853 }
854
855 usb_set_intfdata (intf, NULL);
856
857 usbvideo_ClientIncModCount(uvd);
858 if (uvd->debug > 0)
a482f327 859 dev_info(&intf->dev, "%s(%p.)\n", __func__, intf);
1da177e4 860
4186ecf8 861 mutex_lock(&uvd->lock);
1da177e4
LT
862 uvd->remove_pending = 1; /* Now all ISO data will be ignored */
863
864 /* At this time we ask to cancel outstanding URBs */
865 GET_CALLBACK(uvd, stopDataPump)(uvd);
866
867 for (i=0; i < USBVIDEO_NUMSBUF; i++)
868 usb_free_urb(uvd->sbuf[i].urb);
869
870 usb_put_dev(uvd->dev);
871 uvd->dev = NULL; /* USB device is no more */
872
873 video_unregister_device(&uvd->vdev);
874 if (uvd->debug > 0)
a482f327 875 dev_info(&intf->dev, "%s: Video unregistered.\n", __func__);
1da177e4
LT
876
877 if (uvd->user)
a482f327
GKH
878 dev_info(&intf->dev, "%s: In use, disconnect pending.\n",
879 __func__);
1da177e4
LT
880 else
881 usbvideo_CameraRelease(uvd);
4186ecf8 882 mutex_unlock(&uvd->lock);
a482f327 883 dev_info(&intf->dev, "USB camera disconnected.\n");
1da177e4
LT
884
885 usbvideo_ClientDecModCount(uvd);
886}
887
888/*
889 * usbvideo_CameraRelease()
890 *
891 * This code does final release of uvd. This happens
892 * after the device is disconnected -and- all clients
893 * closed their files.
894 *
895 * History:
896 * 27-Jan-2000 Created.
897 */
898static void usbvideo_CameraRelease(struct uvd *uvd)
899{
900 if (uvd == NULL) {
4126a8f5 901 err("%s: Illegal call", __func__);
1da177e4
LT
902 return;
903 }
904
905 RingQueue_Free(&uvd->dp);
906 if (VALID_CALLBACK(uvd, userFree))
907 GET_CALLBACK(uvd, userFree)(uvd);
908 uvd->uvd_used = 0; /* This is atomic, no need to take mutex */
909}
910
911/*
912 * usbvideo_find_struct()
913 *
914 * This code searches the array of preallocated (static) structures
915 * and returns index of the first one that isn't in use. Returns -1
916 * if there are no free structures.
917 *
918 * History:
919 * 27-Jan-2000 Created.
920 */
921static int usbvideo_find_struct(struct usbvideo *cams)
922{
923 int u, rv = -1;
924
925 if (cams == NULL) {
926 err("No usbvideo handle?");
927 return -1;
928 }
4186ecf8 929 mutex_lock(&cams->lock);
1da177e4
LT
930 for (u = 0; u < cams->num_cameras; u++) {
931 struct uvd *uvd = &cams->cam[u];
932 if (!uvd->uvd_used) /* This one is free */
933 {
934 uvd->uvd_used = 1; /* In use now */
4186ecf8 935 mutex_init(&uvd->lock); /* to 1 == available */
1da177e4
LT
936 uvd->dev = NULL;
937 rv = u;
938 break;
939 }
940 }
4186ecf8 941 mutex_unlock(&cams->lock);
1da177e4
LT
942 return rv;
943}
944
bec43661 945static const struct v4l2_file_operations usbvideo_fops = {
1da177e4
LT
946 .owner = THIS_MODULE,
947 .open = usbvideo_v4l_open,
948 .release =usbvideo_v4l_close,
949 .read = usbvideo_v4l_read,
950 .mmap = usbvideo_v4l_mmap,
951 .ioctl = usbvideo_v4l_ioctl,
1da177e4 952};
4c4c9432 953static const struct video_device usbvideo_template = {
1da177e4
LT
954 .fops = &usbvideo_fops,
955};
956
957struct uvd *usbvideo_AllocateDevice(struct usbvideo *cams)
958{
959 int i, devnum;
960 struct uvd *uvd = NULL;
961
962 if (cams == NULL) {
963 err("No usbvideo handle?");
964 return NULL;
965 }
966
967 devnum = usbvideo_find_struct(cams);
968 if (devnum == -1) {
969 err("IBM USB camera driver: Too many devices!");
970 return NULL;
971 }
972 uvd = &cams->cam[devnum];
973 dbg("Device entry #%d. at $%p", devnum, uvd);
974
975 /* Not relying upon caller we increase module counter ourselves */
976 usbvideo_ClientIncModCount(uvd);
977
4186ecf8 978 mutex_lock(&uvd->lock);
1da177e4
LT
979 for (i=0; i < USBVIDEO_NUMSBUF; i++) {
980 uvd->sbuf[i].urb = usb_alloc_urb(FRAMES_PER_DESC, GFP_KERNEL);
981 if (uvd->sbuf[i].urb == NULL) {
982 err("usb_alloc_urb(%d.) failed.", FRAMES_PER_DESC);
983 uvd->uvd_used = 0;
984 uvd = NULL;
985 goto allocate_done;
986 }
987 }
988 uvd->user=0;
989 uvd->remove_pending = 0;
990 uvd->last_error = 0;
991 RingQueue_Initialize(&uvd->dp);
992
993 /* Initialize video device structure */
994 uvd->vdev = usbvideo_template;
995 sprintf(uvd->vdev.name, "%.20s USB Camera", cams->drvName);
996 /*
997 * The client is free to overwrite those because we
998 * return control to the client's probe function right now.
999 */
1000allocate_done:
4186ecf8 1001 mutex_unlock(&uvd->lock);
1da177e4
LT
1002 usbvideo_ClientDecModCount(uvd);
1003 return uvd;
1004}
1005
1006EXPORT_SYMBOL(usbvideo_AllocateDevice);
1007
1008int usbvideo_RegisterVideoDevice(struct uvd *uvd)
1009{
1010 char tmp1[20], tmp2[20]; /* Buffers for printing */
1011
1012 if (uvd == NULL) {
4126a8f5 1013 err("%s: Illegal call.", __func__);
1da177e4
LT
1014 return -EINVAL;
1015 }
1016 if (uvd->video_endp == 0) {
a482f327
GKH
1017 dev_info(&uvd->dev->dev,
1018 "%s: No video endpoint specified; data pump disabled.\n",
1019 __func__);
1da177e4
LT
1020 }
1021 if (uvd->paletteBits == 0) {
4126a8f5 1022 err("%s: No palettes specified!", __func__);
1da177e4
LT
1023 return -EINVAL;
1024 }
1025 if (uvd->defaultPalette == 0) {
a482f327
GKH
1026 dev_info(&uvd->dev->dev, "%s: No default palette!\n",
1027 __func__);
1da177e4
LT
1028 }
1029
1030 uvd->max_frame_size = VIDEOSIZE_X(uvd->canvas) *
1031 VIDEOSIZE_Y(uvd->canvas) * V4L_BYTES_PER_PIXEL;
1032 usbvideo_VideosizeToString(tmp1, sizeof(tmp1), uvd->videosize);
1033 usbvideo_VideosizeToString(tmp2, sizeof(tmp2), uvd->canvas);
1034
1035 if (uvd->debug > 0) {
a482f327
GKH
1036 dev_info(&uvd->dev->dev,
1037 "%s: iface=%d. endpoint=$%02x paletteBits=$%08lx\n",
1038 __func__, uvd->iface, uvd->video_endp,
1039 uvd->paletteBits);
1da177e4 1040 }
974a911d 1041 if (uvd->dev == NULL) {
1c659689 1042 err("%s: uvd->dev == NULL", __func__);
974a911d
PT
1043 return -EINVAL;
1044 }
5e85e732 1045 uvd->vdev.parent = &uvd->dev->dev;
aa5e90af 1046 uvd->vdev.release = video_device_release_empty;
e758c6f8 1047 if (video_register_device(&uvd->vdev, VFL_TYPE_GRABBER, video_nr) < 0) {
4126a8f5 1048 err("%s: video_register_device failed", __func__);
1da177e4
LT
1049 return -EPIPE;
1050 }
1051 if (uvd->debug > 1) {
a482f327
GKH
1052 dev_info(&uvd->dev->dev,
1053 "%s: video_register_device() successful\n", __func__);
1da177e4 1054 }
1da177e4 1055
a482f327
GKH
1056 dev_info(&uvd->dev->dev, "%s on /dev/video%d: canvas=%s videosize=%s\n",
1057 (uvd->handle != NULL) ? uvd->handle->drvName : "???",
c6330fb8 1058 uvd->vdev.num, tmp2, tmp1);
1da177e4
LT
1059
1060 usb_get_dev(uvd->dev);
1061 return 0;
1062}
1063
1064EXPORT_SYMBOL(usbvideo_RegisterVideoDevice);
1065
1066/* ******************************************************************** */
1067
1068static int usbvideo_v4l_mmap(struct file *file, struct vm_area_struct *vma)
1069{
1070 struct uvd *uvd = file->private_data;
1071 unsigned long start = vma->vm_start;
1072 unsigned long size = vma->vm_end-vma->vm_start;
1073 unsigned long page, pos;
1074
1075 if (!CAMERA_IS_OPERATIONAL(uvd))
1076 return -EFAULT;
1077
1078 if (size > (((USBVIDEO_NUMFRAMES * uvd->max_frame_size) + PAGE_SIZE - 1) & ~(PAGE_SIZE - 1)))
1079 return -EINVAL;
1080
1081 pos = (unsigned long) uvd->fbuf;
1082 while (size > 0) {
1083 page = vmalloc_to_pfn((void *)pos);
1084 if (remap_pfn_range(vma, start, page, PAGE_SIZE, PAGE_SHARED))
1085 return -EAGAIN;
1086
1087 start += PAGE_SIZE;
1088 pos += PAGE_SIZE;
1089 if (size > PAGE_SIZE)
1090 size -= PAGE_SIZE;
1091 else
1092 size = 0;
1093 }
1094
1095 return 0;
1096}
1097
1098/*
1099 * usbvideo_v4l_open()
1100 *
1101 * This is part of Video 4 Linux API. The driver can be opened by one
1102 * client only (checks internal counter 'uvdser'). The procedure
1103 * then allocates buffers needed for video processing.
1104 *
1105 * History:
1106 * 22-Jan-2000 Rewrote, moved scratch buffer allocation here. Now the
1107 * camera is also initialized here (once per connect), at
1108 * expense of V4L client (it waits on open() call).
1109 * 27-Jan-2000 Used USBVIDEO_NUMSBUF as number of URB buffers.
1110 * 24-May-2000 Corrected to prevent race condition (MOD_xxx_USE_COUNT).
1111 */
bec43661 1112static int usbvideo_v4l_open(struct file *file)
1da177e4
LT
1113{
1114 struct video_device *dev = video_devdata(file);
1115 struct uvd *uvd = (struct uvd *) dev;
1116 const int sb_size = FRAMES_PER_DESC * uvd->iso_packet_len;
1117 int i, errCode = 0;
1118
1119 if (uvd->debug > 1)
a482f327 1120 dev_info(&uvd->dev->dev, "%s($%p)\n", __func__, dev);
1da177e4 1121
be49e368 1122 if (usbvideo_ClientIncModCount(uvd) < 0)
5332bdbe 1123 return -ENODEV;
4186ecf8 1124 mutex_lock(&uvd->lock);
1da177e4
LT
1125
1126 if (uvd->user) {
4126a8f5 1127 err("%s: Someone tried to open an already opened device!", __func__);
1da177e4
LT
1128 errCode = -EBUSY;
1129 } else {
1130 /* Clear statistics */
1131 memset(&uvd->stats, 0, sizeof(uvd->stats));
1132
1133 /* Clean pointers so we know if we allocated something */
1134 for (i=0; i < USBVIDEO_NUMSBUF; i++)
1135 uvd->sbuf[i].data = NULL;
1136
1137 /* Allocate memory for the frame buffers */
1138 uvd->fbuf_size = USBVIDEO_NUMFRAMES * uvd->max_frame_size;
1139 uvd->fbuf = usbvideo_rvmalloc(uvd->fbuf_size);
1140 RingQueue_Allocate(&uvd->dp, RING_QUEUE_SIZE);
1141 if ((uvd->fbuf == NULL) ||
1142 (!RingQueue_IsAllocated(&uvd->dp))) {
4126a8f5 1143 err("%s: Failed to allocate fbuf or dp", __func__);
1da177e4
LT
1144 errCode = -ENOMEM;
1145 } else {
1146 /* Allocate all buffers */
1147 for (i=0; i < USBVIDEO_NUMFRAMES; i++) {
1148 uvd->frame[i].frameState = FrameState_Unused;
1149 uvd->frame[i].data = uvd->fbuf + i*(uvd->max_frame_size);
1150 /*
1151 * Set default sizes in case IOCTL (VIDIOCMCAPTURE)
1152 * is not used (using read() instead).
1153 */
1154 uvd->frame[i].canvas = uvd->canvas;
1155 uvd->frame[i].seqRead_Index = 0;
1156 }
1157 for (i=0; i < USBVIDEO_NUMSBUF; i++) {
1158 uvd->sbuf[i].data = kmalloc(sb_size, GFP_KERNEL);
1159 if (uvd->sbuf[i].data == NULL) {
1160 errCode = -ENOMEM;
1161 break;
1162 }
1163 }
1164 }
1165 if (errCode != 0) {
1166 /* Have to free all that memory */
1167 if (uvd->fbuf != NULL) {
1168 usbvideo_rvfree(uvd->fbuf, uvd->fbuf_size);
1169 uvd->fbuf = NULL;
1170 }
1171 RingQueue_Free(&uvd->dp);
1172 for (i=0; i < USBVIDEO_NUMSBUF; i++) {
1bc3c9e1
JJ
1173 kfree(uvd->sbuf[i].data);
1174 uvd->sbuf[i].data = NULL;
1da177e4
LT
1175 }
1176 }
1177 }
1178
1179 /* If so far no errors then we shall start the camera */
1180 if (errCode == 0) {
1181 /* Start data pump if we have valid endpoint */
1182 if (uvd->video_endp != 0)
1183 errCode = GET_CALLBACK(uvd, startDataPump)(uvd);
1184 if (errCode == 0) {
1185 if (VALID_CALLBACK(uvd, setupOnOpen)) {
1186 if (uvd->debug > 1)
a482f327
GKH
1187 dev_info(&uvd->dev->dev,
1188 "%s: setupOnOpen callback\n",
1189 __func__);
1da177e4
LT
1190 errCode = GET_CALLBACK(uvd, setupOnOpen)(uvd);
1191 if (errCode < 0) {
1192 err("%s: setupOnOpen callback failed (%d.).",
4126a8f5 1193 __func__, errCode);
1da177e4 1194 } else if (uvd->debug > 1) {
a482f327
GKH
1195 dev_info(&uvd->dev->dev,
1196 "%s: setupOnOpen callback successful\n",
1197 __func__);
1da177e4
LT
1198 }
1199 }
1200 if (errCode == 0) {
1201 uvd->settingsAdjusted = 0;
1202 if (uvd->debug > 1)
a482f327
GKH
1203 dev_info(&uvd->dev->dev,
1204 "%s: Open succeeded.\n",
1205 __func__);
1da177e4
LT
1206 uvd->user++;
1207 file->private_data = uvd;
1208 }
1209 }
1210 }
4186ecf8 1211 mutex_unlock(&uvd->lock);
1da177e4
LT
1212 if (errCode != 0)
1213 usbvideo_ClientDecModCount(uvd);
1214 if (uvd->debug > 0)
a482f327
GKH
1215 dev_info(&uvd->dev->dev, "%s: Returning %d.\n", __func__,
1216 errCode);
1da177e4
LT
1217 return errCode;
1218}
1219
1220/*
1221 * usbvideo_v4l_close()
1222 *
1223 * This is part of Video 4 Linux API. The procedure
1224 * stops streaming and deallocates all buffers that were earlier
1225 * allocated in usbvideo_v4l_open().
1226 *
1227 * History:
1228 * 22-Jan-2000 Moved scratch buffer deallocation here.
1229 * 27-Jan-2000 Used USBVIDEO_NUMSBUF as number of URB buffers.
1230 * 24-May-2000 Moved MOD_DEC_USE_COUNT outside of code that can sleep.
1231 */
bec43661 1232static int usbvideo_v4l_close(struct file *file)
1da177e4
LT
1233{
1234 struct video_device *dev = file->private_data;
1235 struct uvd *uvd = (struct uvd *) dev;
1236 int i;
1237
1238 if (uvd->debug > 1)
a482f327 1239 dev_info(&uvd->dev->dev, "%s($%p)\n", __func__, dev);
1da177e4 1240
4186ecf8 1241 mutex_lock(&uvd->lock);
1da177e4
LT
1242 GET_CALLBACK(uvd, stopDataPump)(uvd);
1243 usbvideo_rvfree(uvd->fbuf, uvd->fbuf_size);
1244 uvd->fbuf = NULL;
1245 RingQueue_Free(&uvd->dp);
1246
1247 for (i=0; i < USBVIDEO_NUMSBUF; i++) {
1248 kfree(uvd->sbuf[i].data);
1249 uvd->sbuf[i].data = NULL;
1250 }
1251
1252#if USBVIDEO_REPORT_STATS
1253 usbvideo_ReportStatistics(uvd);
d56410e0 1254#endif
1da177e4
LT
1255
1256 uvd->user--;
1257 if (uvd->remove_pending) {
1258 if (uvd->debug > 0)
a482f327
GKH
1259 dev_info(&uvd->dev->dev, "%s: Final disconnect.\n",
1260 __func__);
1da177e4
LT
1261 usbvideo_CameraRelease(uvd);
1262 }
4186ecf8 1263 mutex_unlock(&uvd->lock);
1da177e4
LT
1264 usbvideo_ClientDecModCount(uvd);
1265
1266 if (uvd->debug > 1)
a482f327 1267 dev_info(&uvd->dev->dev, "%s: Completed.\n", __func__);
1da177e4
LT
1268 file->private_data = NULL;
1269 return 0;
1270}
1271
1272/*
1273 * usbvideo_v4l_ioctl()
1274 *
1275 * This is part of Video 4 Linux API. The procedure handles ioctl() calls.
1276 *
1277 * History:
1278 * 22-Jan-2000 Corrected VIDIOCSPICT to reject unsupported settings.
1279 */
f473bf76 1280static int usbvideo_v4l_do_ioctl(struct file *file, unsigned int cmd, void *arg)
1da177e4
LT
1281{
1282 struct uvd *uvd = file->private_data;
1283
1284 if (!CAMERA_IS_OPERATIONAL(uvd))
1285 return -EIO;
1286
1287 switch (cmd) {
1288 case VIDIOCGCAP:
1289 {
1290 struct video_capability *b = arg;
1291 *b = uvd->vcap;
1292 return 0;
1293 }
1294 case VIDIOCGCHAN:
1295 {
1296 struct video_channel *v = arg;
1297 *v = uvd->vchan;
1298 return 0;
1299 }
1300 case VIDIOCSCHAN:
d56410e0 1301 {
1da177e4
LT
1302 struct video_channel *v = arg;
1303 if (v->channel != 0)
1304 return -EINVAL;
1305 return 0;
1306 }
1307 case VIDIOCGPICT:
1308 {
1309 struct video_picture *pic = arg;
1310 *pic = uvd->vpic;
1311 return 0;
1312 }
1313 case VIDIOCSPICT:
1314 {
1315 struct video_picture *pic = arg;
1316 /*
1317 * Use temporary 'video_picture' structure to preserve our
1318 * own settings (such as color depth, palette) that we
1319 * aren't allowing everyone (V4L client) to change.
1320 */
1321 uvd->vpic.brightness = pic->brightness;
1322 uvd->vpic.hue = pic->hue;
1323 uvd->vpic.colour = pic->colour;
1324 uvd->vpic.contrast = pic->contrast;
1325 uvd->settingsAdjusted = 0; /* Will force new settings */
1326 return 0;
1327 }
1328 case VIDIOCSWIN:
1329 {
1330 struct video_window *vw = arg;
1331
1332 if(VALID_CALLBACK(uvd, setVideoMode)) {
1333 return GET_CALLBACK(uvd, setVideoMode)(uvd, vw);
1334 }
1335
1336 if (vw->flags)
1337 return -EINVAL;
1338 if (vw->clipcount)
1339 return -EINVAL;
1340 if (vw->width != VIDEOSIZE_X(uvd->canvas))
1341 return -EINVAL;
1342 if (vw->height != VIDEOSIZE_Y(uvd->canvas))
1343 return -EINVAL;
1344
1345 return 0;
1346 }
1347 case VIDIOCGWIN:
1348 {
1349 struct video_window *vw = arg;
1350
1351 vw->x = 0;
1352 vw->y = 0;
1353 vw->width = VIDEOSIZE_X(uvd->videosize);
1354 vw->height = VIDEOSIZE_Y(uvd->videosize);
1355 vw->chromakey = 0;
1356 if (VALID_CALLBACK(uvd, getFPS))
1357 vw->flags = GET_CALLBACK(uvd, getFPS)(uvd);
d56410e0 1358 else
1da177e4
LT
1359 vw->flags = 10; /* FIXME: do better! */
1360 return 0;
1361 }
1362 case VIDIOCGMBUF:
1363 {
1364 struct video_mbuf *vm = arg;
1365 int i;
1366
1367 memset(vm, 0, sizeof(*vm));
1368 vm->size = uvd->max_frame_size * USBVIDEO_NUMFRAMES;
1369 vm->frames = USBVIDEO_NUMFRAMES;
d56410e0 1370 for(i = 0; i < USBVIDEO_NUMFRAMES; i++)
1da177e4
LT
1371 vm->offsets[i] = i * uvd->max_frame_size;
1372
1373 return 0;
1374 }
1375 case VIDIOCMCAPTURE:
1376 {
1377 struct video_mmap *vm = arg;
1378
1379 if (uvd->debug >= 1) {
a482f327
GKH
1380 dev_info(&uvd->dev->dev,
1381 "VIDIOCMCAPTURE: frame=%d. size=%dx%d, format=%d.\n",
1382 vm->frame, vm->width, vm->height, vm->format);
1da177e4
LT
1383 }
1384 /*
1385 * Check if the requested size is supported. If the requestor
1386 * requests too big a frame then we may be tricked into accessing
1387 * outside of own preallocated frame buffer (in uvd->frame).
1388 * This will cause oops or a security hole. Theoretically, we
1389 * could only clamp the size down to acceptable bounds, but then
1390 * we'd need to figure out how to insert our smaller buffer into
1391 * larger caller's buffer... this is not an easy question. So we
1392 * here just flatly reject too large requests, assuming that the
1393 * caller will resubmit with smaller size. Callers should know
1394 * what size we support (returned by VIDIOCGCAP). However vidcat,
1395 * for one, does not care and allows to ask for any size.
1396 */
1397 if ((vm->width > VIDEOSIZE_X(uvd->canvas)) ||
1398 (vm->height > VIDEOSIZE_Y(uvd->canvas))) {
1399 if (uvd->debug > 0) {
a482f327
GKH
1400 dev_info(&uvd->dev->dev,
1401 "VIDIOCMCAPTURE: Size=%dx%d "
1402 "too large; allowed only up "
1403 "to %ldx%ld\n", vm->width,
1404 vm->height,
1405 VIDEOSIZE_X(uvd->canvas),
1406 VIDEOSIZE_Y(uvd->canvas));
1da177e4
LT
1407 }
1408 return -EINVAL;
1409 }
1410 /* Check if the palette is supported */
1411 if (((1L << vm->format) & uvd->paletteBits) == 0) {
1412 if (uvd->debug > 0) {
a482f327
GKH
1413 dev_info(&uvd->dev->dev,
1414 "VIDIOCMCAPTURE: format=%d. "
1415 "not supported "
1416 "(paletteBits=$%08lx)\n",
1417 vm->format, uvd->paletteBits);
1da177e4
LT
1418 }
1419 return -EINVAL;
1420 }
1421 if ((vm->frame < 0) || (vm->frame >= USBVIDEO_NUMFRAMES)) {
1422 err("VIDIOCMCAPTURE: vm.frame=%d. !E [0-%d]", vm->frame, USBVIDEO_NUMFRAMES-1);
1423 return -EINVAL;
1424 }
1425 if (uvd->frame[vm->frame].frameState == FrameState_Grabbing) {
1426 /* Not an error - can happen */
1427 }
1428 uvd->frame[vm->frame].request = VIDEOSIZE(vm->width, vm->height);
1429 uvd->frame[vm->frame].palette = vm->format;
1430
1431 /* Mark it as ready */
1432 uvd->frame[vm->frame].frameState = FrameState_Ready;
1433
1434 return usbvideo_NewFrame(uvd, vm->frame);
1435 }
1436 case VIDIOCSYNC:
1437 {
1438 int *frameNum = arg;
1439 int ret;
1440
1441 if (*frameNum < 0 || *frameNum >= USBVIDEO_NUMFRAMES)
1442 return -EINVAL;
d56410e0 1443
1da177e4 1444 if (uvd->debug >= 1)
a482f327
GKH
1445 dev_info(&uvd->dev->dev,
1446 "VIDIOCSYNC: syncing to frame %d.\n",
1447 *frameNum);
1da177e4
LT
1448 if (uvd->flags & FLAGS_NO_DECODING)
1449 ret = usbvideo_GetFrame(uvd, *frameNum);
1450 else if (VALID_CALLBACK(uvd, getFrame)) {
1451 ret = GET_CALLBACK(uvd, getFrame)(uvd, *frameNum);
1452 if ((ret < 0) && (uvd->debug >= 1)) {
1453 err("VIDIOCSYNC: getFrame() returned %d.", ret);
1454 }
1455 } else {
1456 err("VIDIOCSYNC: getFrame is not set");
1457 ret = -EFAULT;
1458 }
1459
1460 /*
1461 * The frame is in FrameState_Done_Hold state. Release it
1462 * right now because its data is already mapped into
1463 * the user space and it's up to the application to
1464 * make use of it until it asks for another frame.
1465 */
1466 uvd->frame[*frameNum].frameState = FrameState_Unused;
1467 return ret;
1468 }
1469 case VIDIOCGFBUF:
1470 {
1471 struct video_buffer *vb = arg;
1472
1473 memset(vb, 0, sizeof(*vb));
d56410e0
MCC
1474 return 0;
1475 }
1da177e4
LT
1476 case VIDIOCKEY:
1477 return 0;
1478
1479 case VIDIOCCAPTURE:
1480 return -EINVAL;
1481
1482 case VIDIOCSFBUF:
1483
1484 case VIDIOCGTUNER:
1485 case VIDIOCSTUNER:
1486
1487 case VIDIOCGFREQ:
1488 case VIDIOCSFREQ:
1489
1490 case VIDIOCGAUDIO:
1491 case VIDIOCSAUDIO:
1492 return -EINVAL;
1493
1494 default:
1495 return -ENOIOCTLCMD;
1496 }
1497 return 0;
1498}
1499
bec43661 1500static int usbvideo_v4l_ioctl(struct file *file,
1da177e4
LT
1501 unsigned int cmd, unsigned long arg)
1502{
f473bf76 1503 return video_usercopy(file, cmd, arg, usbvideo_v4l_do_ioctl);
1da177e4
LT
1504}
1505
1506/*
1507 * usbvideo_v4l_read()
1508 *
1509 * This is mostly boring stuff. We simply ask for a frame and when it
1510 * arrives copy all the video data from it into user space. There is
1511 * no obvious need to override this method.
1512 *
1513 * History:
1514 * 20-Oct-2000 Created.
1515 * 01-Nov-2000 Added mutex (uvd->lock).
1516 */
1517static ssize_t usbvideo_v4l_read(struct file *file, char __user *buf,
1518 size_t count, loff_t *ppos)
1519{
1520 struct uvd *uvd = file->private_data;
1521 int noblock = file->f_flags & O_NONBLOCK;
1522 int frmx = -1, i;
1523 struct usbvideo_frame *frame;
1524
1525 if (!CAMERA_IS_OPERATIONAL(uvd) || (buf == NULL))
1526 return -EFAULT;
1527
1528 if (uvd->debug >= 1)
a482f327
GKH
1529 dev_info(&uvd->dev->dev,
1530 "%s: %Zd. bytes, noblock=%d.\n",
1531 __func__, count, noblock);
1da177e4 1532
4186ecf8 1533 mutex_lock(&uvd->lock);
1da177e4
LT
1534
1535 /* See if a frame is completed, then use it. */
1536 for(i = 0; i < USBVIDEO_NUMFRAMES; i++) {
1537 if ((uvd->frame[i].frameState == FrameState_Done) ||
1538 (uvd->frame[i].frameState == FrameState_Done_Hold) ||
1539 (uvd->frame[i].frameState == FrameState_Error)) {
1540 frmx = i;
1541 break;
1542 }
1543 }
1544
1545 /* FIXME: If we don't start a frame here then who ever does? */
1546 if (noblock && (frmx == -1)) {
1547 count = -EAGAIN;
1548 goto read_done;
1549 }
1550
1551 /*
1552 * If no FrameState_Done, look for a FrameState_Grabbing state.
1553 * See if a frame is in process (grabbing), then use it.
1554 * We will need to wait until it becomes cooked, of course.
1555 */
1556 if (frmx == -1) {
1557 for(i = 0; i < USBVIDEO_NUMFRAMES; i++) {
1558 if (uvd->frame[i].frameState == FrameState_Grabbing) {
1559 frmx = i;
1560 break;
1561 }
1562 }
1563 }
1564
1565 /*
1566 * If no frame is active, start one. We don't care which one
1567 * it will be, so #0 is as good as any.
1568 * In read access mode we don't have convenience of VIDIOCMCAPTURE
1569 * to specify the requested palette (video format) on per-frame
1570 * basis. This means that we have to return data in -some- format
1571 * and just hope that the client knows what to do with it.
1572 * The default format is configured in uvd->defaultPalette field
1573 * as one of VIDEO_PALETTE_xxx values. We stuff it into the new
1574 * frame and initiate the frame filling process.
1575 */
1576 if (frmx == -1) {
1577 if (uvd->defaultPalette == 0) {
4126a8f5 1578 err("%s: No default palette; don't know what to do!", __func__);
1da177e4
LT
1579 count = -EFAULT;
1580 goto read_done;
1581 }
1582 frmx = 0;
1583 /*
1584 * We have no per-frame control over video size.
1585 * Therefore we only can use whatever size was
1586 * specified as default.
1587 */
1588 uvd->frame[frmx].request = uvd->videosize;
1589 uvd->frame[frmx].palette = uvd->defaultPalette;
1590 uvd->frame[frmx].frameState = FrameState_Ready;
1591 usbvideo_NewFrame(uvd, frmx);
1592 /* Now frame 0 is supposed to start filling... */
1593 }
1594
1595 /*
1596 * Get a pointer to the active frame. It is either previously
1597 * completed frame or frame in progress but not completed yet.
1598 */
1599 frame = &uvd->frame[frmx];
1600
1601 /*
1602 * Sit back & wait until the frame gets filled and postprocessed.
1603 * If we fail to get the picture [in time] then return the error.
1604 * In this call we specify that we want the frame to be waited for,
1605 * postprocessed and switched into FrameState_Done_Hold state. This
1606 * state is used to hold the frame as "fully completed" between
1607 * subsequent partial reads of the same frame.
1608 */
1609 if (frame->frameState != FrameState_Done_Hold) {
1610 long rv = -EFAULT;
1611 if (uvd->flags & FLAGS_NO_DECODING)
1612 rv = usbvideo_GetFrame(uvd, frmx);
1613 else if (VALID_CALLBACK(uvd, getFrame))
1614 rv = GET_CALLBACK(uvd, getFrame)(uvd, frmx);
1615 else
1616 err("getFrame is not set");
1617 if ((rv != 0) || (frame->frameState != FrameState_Done_Hold)) {
1618 count = rv;
1619 goto read_done;
1620 }
1621 }
1622
1623 /*
1624 * Copy bytes to user space. We allow for partial reads, which
1625 * means that the user application can request read less than
1626 * the full frame size. It is up to the application to issue
1627 * subsequent calls until entire frame is read.
1628 *
1629 * First things first, make sure we don't copy more than we
1630 * have - even if the application wants more. That would be
1631 * a big security embarassment!
1632 */
1633 if ((count + frame->seqRead_Index) > frame->seqRead_Length)
1634 count = frame->seqRead_Length - frame->seqRead_Index;
1635
1636 /*
1637 * Copy requested amount of data to user space. We start
1638 * copying from the position where we last left it, which
1639 * will be zero for a new frame (not read before).
1640 */
1641 if (copy_to_user(buf, frame->data + frame->seqRead_Index, count)) {
1642 count = -EFAULT;
1643 goto read_done;
1644 }
1645
1646 /* Update last read position */
1647 frame->seqRead_Index += count;
1648 if (uvd->debug >= 1) {
1649 err("%s: {copy} count used=%Zd, new seqRead_Index=%ld",
4126a8f5 1650 __func__, count, frame->seqRead_Index);
1da177e4
LT
1651 }
1652
1653 /* Finally check if the frame is done with and "release" it */
1654 if (frame->seqRead_Index >= frame->seqRead_Length) {
1655 /* All data has been read */
1656 frame->seqRead_Index = 0;
1657
1658 /* Mark it as available to be used again. */
1659 uvd->frame[frmx].frameState = FrameState_Unused;
1660 if (usbvideo_NewFrame(uvd, (frmx + 1) % USBVIDEO_NUMFRAMES)) {
4126a8f5 1661 err("%s: usbvideo_NewFrame failed.", __func__);
1da177e4
LT
1662 }
1663 }
1664read_done:
4186ecf8 1665 mutex_unlock(&uvd->lock);
1da177e4
LT
1666 return count;
1667}
1668
1669/*
1670 * Make all of the blocks of data contiguous
1671 */
1672static int usbvideo_CompressIsochronous(struct uvd *uvd, struct urb *urb)
1673{
1674 char *cdata;
1675 int i, totlen = 0;
1676
1677 for (i = 0; i < urb->number_of_packets; i++) {
1678 int n = urb->iso_frame_desc[i].actual_length;
1679 int st = urb->iso_frame_desc[i].status;
1680
1681 cdata = urb->transfer_buffer + urb->iso_frame_desc[i].offset;
1682
1683 /* Detect and ignore errored packets */
1684 if (st < 0) {
1685 if (uvd->debug >= 1)
1686 err("Data error: packet=%d. len=%d. status=%d.", i, n, st);
1687 uvd->stats.iso_err_count++;
1688 continue;
1689 }
1690
1691 /* Detect and ignore empty packets */
1692 if (n <= 0) {
1693 uvd->stats.iso_skip_count++;
1694 continue;
1695 }
1696 totlen += n; /* Little local accounting */
1697 RingQueue_Enqueue(&uvd->dp, cdata, n);
1698 }
1699 return totlen;
1700}
1701
7d12e780 1702static void usbvideo_IsocIrq(struct urb *urb)
1da177e4
LT
1703{
1704 int i, ret, len;
1705 struct uvd *uvd = urb->context;
1706
1707 /* We don't want to do anything if we are about to be removed! */
1708 if (!CAMERA_IS_OPERATIONAL(uvd))
1709 return;
1710#if 0
1711 if (urb->actual_length > 0) {
a482f327
GKH
1712 dev_info(&uvd->dev->dev,
1713 "urb=$%p status=%d. errcount=%d. length=%d.\n",
1714 urb, urb->status, urb->error_count,
1715 urb->actual_length);
1da177e4
LT
1716 } else {
1717 static int c = 0;
1718 if (c++ % 100 == 0)
a482f327 1719 dev_info(&uvd->dev->dev, "No Isoc data\n");
1da177e4
LT
1720 }
1721#endif
1722
1723 if (!uvd->streaming) {
1724 if (uvd->debug >= 1)
a482f327
GKH
1725 dev_info(&uvd->dev->dev,
1726 "Not streaming, but interrupt!\n");
1da177e4
LT
1727 return;
1728 }
d56410e0 1729
1da177e4
LT
1730 uvd->stats.urb_count++;
1731 if (urb->actual_length <= 0)
1732 goto urb_done_with;
1733
1734 /* Copy the data received into ring queue */
1735 len = usbvideo_CompressIsochronous(uvd, urb);
1736 uvd->stats.urb_length = len;
1737 if (len <= 0)
1738 goto urb_done_with;
1739
1740 /* Here we got some data */
1741 uvd->stats.data_count += len;
1742 RingQueue_WakeUpInterruptible(&uvd->dp);
1743
1744urb_done_with:
1745 for (i = 0; i < FRAMES_PER_DESC; i++) {
1746 urb->iso_frame_desc[i].status = 0;
1747 urb->iso_frame_desc[i].actual_length = 0;
1748 }
1749 urb->status = 0;
1750 urb->dev = uvd->dev;
1751 ret = usb_submit_urb (urb, GFP_KERNEL);
1752 if(ret)
1753 err("usb_submit_urb error (%d)", ret);
1754 return;
1755}
1756
1757/*
1758 * usbvideo_StartDataPump()
1759 *
1760 * History:
1761 * 27-Jan-2000 Used ibmcam->iface, ibmcam->ifaceAltActive instead
1762 * of hardcoded values. Simplified by using for loop,
1763 * allowed any number of URBs.
1764 */
1765static int usbvideo_StartDataPump(struct uvd *uvd)
1766{
1767 struct usb_device *dev = uvd->dev;
1768 int i, errFlag;
1769
1770 if (uvd->debug > 1)
a482f327 1771 dev_info(&uvd->dev->dev, "%s($%p)\n", __func__, uvd);
1da177e4
LT
1772
1773 if (!CAMERA_IS_OPERATIONAL(uvd)) {
4126a8f5 1774 err("%s: Camera is not operational", __func__);
1da177e4
LT
1775 return -EFAULT;
1776 }
1777 uvd->curframe = -1;
1778
1779 /* Alternate interface 1 is is the biggest frame size */
1780 i = usb_set_interface(dev, uvd->iface, uvd->ifaceAltActive);
1781 if (i < 0) {
4126a8f5 1782 err("%s: usb_set_interface error", __func__);
1da177e4
LT
1783 uvd->last_error = i;
1784 return -EBUSY;
1785 }
1786 if (VALID_CALLBACK(uvd, videoStart))
1787 GET_CALLBACK(uvd, videoStart)(uvd);
d56410e0 1788 else
4126a8f5 1789 err("%s: videoStart not set", __func__);
1da177e4
LT
1790
1791 /* We double buffer the Iso lists */
1792 for (i=0; i < USBVIDEO_NUMSBUF; i++) {
1793 int j, k;
1794 struct urb *urb = uvd->sbuf[i].urb;
1795 urb->dev = dev;
1796 urb->context = uvd;
1797 urb->pipe = usb_rcvisocpipe(dev, uvd->video_endp);
1798 urb->interval = 1;
1799 urb->transfer_flags = URB_ISO_ASAP;
1800 urb->transfer_buffer = uvd->sbuf[i].data;
1801 urb->complete = usbvideo_IsocIrq;
1802 urb->number_of_packets = FRAMES_PER_DESC;
1803 urb->transfer_buffer_length = uvd->iso_packet_len * FRAMES_PER_DESC;
1804 for (j=k=0; j < FRAMES_PER_DESC; j++, k += uvd->iso_packet_len) {
1805 urb->iso_frame_desc[j].offset = k;
1806 urb->iso_frame_desc[j].length = uvd->iso_packet_len;
1807 }
1808 }
1809
1810 /* Submit all URBs */
1811 for (i=0; i < USBVIDEO_NUMSBUF; i++) {
1812 errFlag = usb_submit_urb(uvd->sbuf[i].urb, GFP_KERNEL);
1813 if (errFlag)
4126a8f5 1814 err("%s: usb_submit_isoc(%d) ret %d", __func__, i, errFlag);
1da177e4
LT
1815 }
1816
1817 uvd->streaming = 1;
1818 if (uvd->debug > 1)
a482f327
GKH
1819 dev_info(&uvd->dev->dev,
1820 "%s: streaming=1 video_endp=$%02x\n", __func__,
1821 uvd->video_endp);
1da177e4
LT
1822 return 0;
1823}
1824
1825/*
1826 * usbvideo_StopDataPump()
1827 *
1828 * This procedure stops streaming and deallocates URBs. Then it
1829 * activates zero-bandwidth alt. setting of the video interface.
1830 *
1831 * History:
1832 * 22-Jan-2000 Corrected order of actions to work after surprise removal.
1833 * 27-Jan-2000 Used uvd->iface, uvd->ifaceAltInactive instead of hardcoded values.
1834 */
1835static void usbvideo_StopDataPump(struct uvd *uvd)
1836{
1837 int i, j;
1838
1839 if ((uvd == NULL) || (!uvd->streaming) || (uvd->dev == NULL))
1840 return;
1841
1842 if (uvd->debug > 1)
a482f327 1843 dev_info(&uvd->dev->dev, "%s($%p)\n", __func__, uvd);
1da177e4
LT
1844
1845 /* Unschedule all of the iso td's */
1846 for (i=0; i < USBVIDEO_NUMSBUF; i++) {
1847 usb_kill_urb(uvd->sbuf[i].urb);
1848 }
1849 if (uvd->debug > 1)
a482f327 1850 dev_info(&uvd->dev->dev, "%s: streaming=0\n", __func__);
1da177e4
LT
1851 uvd->streaming = 0;
1852
1853 if (!uvd->remove_pending) {
1854 /* Invoke minidriver's magic to stop the camera */
1855 if (VALID_CALLBACK(uvd, videoStop))
1856 GET_CALLBACK(uvd, videoStop)(uvd);
d56410e0 1857 else
4126a8f5 1858 err("%s: videoStop not set", __func__);
1da177e4
LT
1859
1860 /* Set packet size to 0 */
1861 j = usb_set_interface(uvd->dev, uvd->iface, uvd->ifaceAltInactive);
1862 if (j < 0) {
4126a8f5 1863 err("%s: usb_set_interface() error %d.", __func__, j);
1da177e4
LT
1864 uvd->last_error = j;
1865 }
1866 }
1867}
1868
1869/*
1870 * usbvideo_NewFrame()
1871 *
1872 * History:
1873 * 29-Mar-00 Added copying of previous frame into the current one.
1874 * 6-Aug-00 Added model 3 video sizes, removed redundant width, height.
1875 */
1876static int usbvideo_NewFrame(struct uvd *uvd, int framenum)
1877{
1878 struct usbvideo_frame *frame;
1879 int n;
1880
1881 if (uvd->debug > 1)
a482f327
GKH
1882 dev_info(&uvd->dev->dev, "usbvideo_NewFrame($%p,%d.)\n", uvd,
1883 framenum);
1da177e4
LT
1884
1885 /* If we're not grabbing a frame right now and the other frame is */
1886 /* ready to be grabbed into, then use it instead */
1887 if (uvd->curframe != -1)
1888 return 0;
1889
1890 /* If necessary we adjust picture settings between frames */
1891 if (!uvd->settingsAdjusted) {
1892 if (VALID_CALLBACK(uvd, adjustPicture))
1893 GET_CALLBACK(uvd, adjustPicture)(uvd);
1894 uvd->settingsAdjusted = 1;
1895 }
1896
1897 n = (framenum + 1) % USBVIDEO_NUMFRAMES;
1898 if (uvd->frame[n].frameState == FrameState_Ready)
1899 framenum = n;
1900
1901 frame = &uvd->frame[framenum];
1902
1903 frame->frameState = FrameState_Grabbing;
1904 frame->scanstate = ScanState_Scanning;
1905 frame->seqRead_Length = 0; /* Accumulated in xxx_parse_data() */
1906 frame->deinterlace = Deinterlace_None;
1907 frame->flags = 0; /* No flags yet, up to minidriver (or us) to set them */
1908 uvd->curframe = framenum;
1909
1910 /*
1911 * Normally we would want to copy previous frame into the current one
1912 * before we even start filling it with data; this allows us to stop
1913 * filling at any moment; top portion of the frame will be new and
1914 * bottom portion will stay as it was in previous frame. If we don't
1915 * do that then missing chunks of video stream will result in flickering
1916 * portions of old data whatever it was before.
1917 *
1918 * If we choose not to copy previous frame (to, for example, save few
1919 * bus cycles - the frame can be pretty large!) then we have an option
1920 * to clear the frame before using. If we experience losses in this
1921 * mode then missing picture will be black (no flickering).
1922 *
1923 * Finally, if user chooses not to clean the current frame before
1924 * filling it with data then the old data will be visible if we fail
1925 * to refill entire frame with new data.
1926 */
1927 if (!(uvd->flags & FLAGS_SEPARATE_FRAMES)) {
1928 /* This copies previous frame into this one to mask losses */
1929 int prev = (framenum - 1 + USBVIDEO_NUMFRAMES) % USBVIDEO_NUMFRAMES;
1930 memmove(frame->data, uvd->frame[prev].data, uvd->max_frame_size);
1931 } else {
1932 if (uvd->flags & FLAGS_CLEAN_FRAMES) {
1933 /* This provides a "clean" frame but slows things down */
1934 memset(frame->data, 0, uvd->max_frame_size);
1935 }
1936 }
1937 return 0;
1938}
1939
1940/*
1941 * usbvideo_CollectRawData()
1942 *
1943 * This procedure can be used instead of 'processData' callback if you
1944 * only want to dump the raw data from the camera into the output
1945 * device (frame buffer). You can look at it with V4L client, but the
1946 * image will be unwatchable. The main purpose of this code and of the
1947 * mode FLAGS_NO_DECODING is debugging and capturing of datastreams from
1948 * new, unknown cameras. This procedure will be automatically invoked
1949 * instead of the specified callback handler when uvd->flags has bit
1950 * FLAGS_NO_DECODING set. Therefore, any regular build of any driver
1951 * based on usbvideo can use this feature at any time.
1952 */
1953static void usbvideo_CollectRawData(struct uvd *uvd, struct usbvideo_frame *frame)
1954{
1955 int n;
1956
1957 assert(uvd != NULL);
1958 assert(frame != NULL);
1959
1960 /* Try to move data from queue into frame buffer */
1961 n = RingQueue_GetLength(&uvd->dp);
1962 if (n > 0) {
1963 int m;
1964 /* See how much space we have left */
1965 m = uvd->max_frame_size - frame->seqRead_Length;
1966 if (n > m)
1967 n = m;
1968 /* Now move that much data into frame buffer */
1969 RingQueue_Dequeue(
1970 &uvd->dp,
1971 frame->data + frame->seqRead_Length,
1972 m);
1973 frame->seqRead_Length += m;
1974 }
1975 /* See if we filled the frame */
1976 if (frame->seqRead_Length >= uvd->max_frame_size) {
1977 frame->frameState = FrameState_Done;
1978 uvd->curframe = -1;
1979 uvd->stats.frame_num++;
1980 }
1981}
1982
1983static int usbvideo_GetFrame(struct uvd *uvd, int frameNum)
1984{
1985 struct usbvideo_frame *frame = &uvd->frame[frameNum];
1986
1987 if (uvd->debug >= 2)
a482f327
GKH
1988 dev_info(&uvd->dev->dev, "%s($%p,%d.)\n", __func__, uvd,
1989 frameNum);
1da177e4
LT
1990
1991 switch (frame->frameState) {
d56410e0 1992 case FrameState_Unused:
1da177e4 1993 if (uvd->debug >= 2)
a482f327
GKH
1994 dev_info(&uvd->dev->dev, "%s: FrameState_Unused\n",
1995 __func__);
1da177e4 1996 return -EINVAL;
d56410e0
MCC
1997 case FrameState_Ready:
1998 case FrameState_Grabbing:
1999 case FrameState_Error:
2000 {
1da177e4
LT
2001 int ntries, signalPending;
2002 redo:
2003 if (!CAMERA_IS_OPERATIONAL(uvd)) {
2004 if (uvd->debug >= 2)
a482f327
GKH
2005 dev_info(&uvd->dev->dev,
2006 "%s: Camera is not operational (1)\n",
2007 __func__);
1da177e4
LT
2008 return -EIO;
2009 }
d56410e0 2010 ntries = 0;
1da177e4
LT
2011 do {
2012 RingQueue_InterruptibleSleepOn(&uvd->dp);
2013 signalPending = signal_pending(current);
2014 if (!CAMERA_IS_OPERATIONAL(uvd)) {
2015 if (uvd->debug >= 2)
a482f327
GKH
2016 dev_info(&uvd->dev->dev,
2017 "%s: Camera is not "
2018 "operational (2)\n", __func__);
1da177e4
LT
2019 return -EIO;
2020 }
2021 assert(uvd->fbuf != NULL);
2022 if (signalPending) {
2023 if (uvd->debug >= 2)
a482f327
GKH
2024 dev_info(&uvd->dev->dev,
2025 "%s: Signal=$%08x\n", __func__,
2026 signalPending);
1da177e4
LT
2027 if (uvd->flags & FLAGS_RETRY_VIDIOCSYNC) {
2028 usbvideo_TestPattern(uvd, 1, 0);
2029 uvd->curframe = -1;
2030 uvd->stats.frame_num++;
2031 if (uvd->debug >= 2)
a482f327
GKH
2032 dev_info(&uvd->dev->dev,
2033 "%s: Forced test "
2034 "pattern screen\n",
2035 __func__);
1da177e4
LT
2036 return 0;
2037 } else {
2038 /* Standard answer: Interrupted! */
2039 if (uvd->debug >= 2)
a482f327
GKH
2040 dev_info(&uvd->dev->dev,
2041 "%s: Interrupted!\n",
2042 __func__);
1da177e4
LT
2043 return -EINTR;
2044 }
2045 } else {
2046 /* No signals - we just got new data in dp queue */
2047 if (uvd->flags & FLAGS_NO_DECODING)
2048 usbvideo_CollectRawData(uvd, frame);
2049 else if (VALID_CALLBACK(uvd, processData))
2050 GET_CALLBACK(uvd, processData)(uvd, frame);
d56410e0 2051 else
4126a8f5 2052 err("%s: processData not set", __func__);
1da177e4
LT
2053 }
2054 } while (frame->frameState == FrameState_Grabbing);
2055 if (uvd->debug >= 2) {
a482f327
GKH
2056 dev_info(&uvd->dev->dev,
2057 "%s: Grabbing done; state=%d. (%lu. bytes)\n",
2058 __func__, frame->frameState,
2059 frame->seqRead_Length);
1da177e4
LT
2060 }
2061 if (frame->frameState == FrameState_Error) {
2062 int ret = usbvideo_NewFrame(uvd, frameNum);
2063 if (ret < 0) {
4126a8f5 2064 err("%s: usbvideo_NewFrame() failed (%d.)", __func__, ret);
1da177e4
LT
2065 return ret;
2066 }
2067 goto redo;
2068 }
2069 /* Note that we fall through to meet our destiny below */
d56410e0
MCC
2070 }
2071 case FrameState_Done:
1da177e4
LT
2072 /*
2073 * Do all necessary postprocessing of data prepared in
2074 * "interrupt" code and the collecting code above. The
2075 * frame gets marked as FrameState_Done by queue parsing code.
2076 * This status means that we collected enough data and
2077 * most likely processed it as we went through. However
2078 * the data may need postprocessing, such as deinterlacing
2079 * or picture adjustments implemented in software (horror!)
2080 *
2081 * As soon as the frame becomes "final" it gets promoted to
2082 * FrameState_Done_Hold status where it will remain until the
2083 * caller consumed all the video data from the frame. Then
2084 * the empty shell of ex-frame is thrown out for dogs to eat.
2085 * But we, worried about pets, will recycle the frame!
2086 */
2087 uvd->stats.frame_num++;
2088 if ((uvd->flags & FLAGS_NO_DECODING) == 0) {
2089 if (VALID_CALLBACK(uvd, postProcess))
2090 GET_CALLBACK(uvd, postProcess)(uvd, frame);
2091 if (frame->flags & USBVIDEO_FRAME_FLAG_SOFTWARE_CONTRAST)
2092 usbvideo_SoftwareContrastAdjustment(uvd, frame);
2093 }
2094 frame->frameState = FrameState_Done_Hold;
2095 if (uvd->debug >= 2)
a482f327
GKH
2096 dev_info(&uvd->dev->dev,
2097 "%s: Entered FrameState_Done_Hold state.\n",
2098 __func__);
1da177e4
LT
2099 return 0;
2100
2101 case FrameState_Done_Hold:
2102 /*
2103 * We stay in this state indefinitely until someone external,
2104 * like ioctl() or read() call finishes digesting the frame
2105 * data. Then it will mark the frame as FrameState_Unused and
2106 * it will be released back into the wild to roam freely.
2107 */
2108 if (uvd->debug >= 2)
a482f327
GKH
2109 dev_info(&uvd->dev->dev,
2110 "%s: FrameState_Done_Hold state.\n",
2111 __func__);
1da177e4
LT
2112 return 0;
2113 }
2114
2115 /* Catch-all for other cases. We shall not be here. */
4126a8f5 2116 err("%s: Invalid state %d.", __func__, frame->frameState);
1da177e4
LT
2117 frame->frameState = FrameState_Unused;
2118 return 0;
2119}
2120
2121/*
2122 * usbvideo_DeinterlaceFrame()
2123 *
2124 * This procedure deinterlaces the given frame. Some cameras produce
2125 * only half of scanlines - sometimes only even lines, sometimes only
2126 * odd lines. The deinterlacing method is stored in frame->deinterlace
2127 * variable.
2128 *
2129 * Here we scan the frame vertically and replace missing scanlines with
2130 * average between surrounding ones - before and after. If we have no
2131 * line above then we just copy next line. Similarly, if we need to
2132 * create a last line then preceding line is used.
2133 */
2134void usbvideo_DeinterlaceFrame(struct uvd *uvd, struct usbvideo_frame *frame)
2135{
2136 if ((uvd == NULL) || (frame == NULL))
2137 return;
2138
2139 if ((frame->deinterlace == Deinterlace_FillEvenLines) ||
2140 (frame->deinterlace == Deinterlace_FillOddLines))
2141 {
2142 const int v4l_linesize = VIDEOSIZE_X(frame->request) * V4L_BYTES_PER_PIXEL;
2143 int i = (frame->deinterlace == Deinterlace_FillEvenLines) ? 0 : 1;
2144
2145 for (; i < VIDEOSIZE_Y(frame->request); i += 2) {
2146 const unsigned char *fs1, *fs2;
2147 unsigned char *fd;
2148 int ip, in, j; /* Previous and next lines */
2149
2150 /*
2151 * Need to average lines before and after 'i'.
2152 * If we go out of bounds seeking those lines then
2153 * we point back to existing line.
2154 */
2155 ip = i - 1; /* First, get rough numbers */
2156 in = i + 1;
2157
2158 /* Now validate */
2159 if (ip < 0)
2160 ip = in;
2161 if (in >= VIDEOSIZE_Y(frame->request))
2162 in = ip;
2163
2164 /* Sanity check */
2165 if ((ip < 0) || (in < 0) ||
2166 (ip >= VIDEOSIZE_Y(frame->request)) ||
2167 (in >= VIDEOSIZE_Y(frame->request)))
2168 {
2169 err("Error: ip=%d. in=%d. req.height=%ld.",
2170 ip, in, VIDEOSIZE_Y(frame->request));
2171 break;
2172 }
2173
2174 /* Now we need to average lines 'ip' and 'in' to produce line 'i' */
2175 fs1 = frame->data + (v4l_linesize * ip);
2176 fs2 = frame->data + (v4l_linesize * in);
2177 fd = frame->data + (v4l_linesize * i);
2178
2179 /* Average lines around destination */
2180 for (j=0; j < v4l_linesize; j++) {
2181 fd[j] = (unsigned char)((((unsigned) fs1[j]) +
2182 ((unsigned)fs2[j])) >> 1);
2183 }
2184 }
2185 }
2186
2187 /* Optionally display statistics on the screen */
2188 if (uvd->flags & FLAGS_OVERLAY_STATS)
2189 usbvideo_OverlayStats(uvd, frame);
2190}
2191
2192EXPORT_SYMBOL(usbvideo_DeinterlaceFrame);
2193
2194/*
2195 * usbvideo_SoftwareContrastAdjustment()
2196 *
2197 * This code adjusts the contrast of the frame, assuming RGB24 format.
2198 * As most software image processing, this job is CPU-intensive.
2199 * Get a camera that supports hardware adjustment!
2200 *
2201 * History:
2202 * 09-Feb-2001 Created.
2203 */
d56410e0 2204static void usbvideo_SoftwareContrastAdjustment(struct uvd *uvd,
1da177e4
LT
2205 struct usbvideo_frame *frame)
2206{
2207 int i, j, v4l_linesize;
2208 signed long adj;
2209 const int ccm = 128; /* Color correction median - see below */
2210
2211 if ((uvd == NULL) || (frame == NULL)) {
4126a8f5 2212 err("%s: Illegal call.", __func__);
1da177e4
LT
2213 return;
2214 }
2215 adj = (uvd->vpic.contrast - 0x8000) >> 8; /* -128..+127 = -ccm..+(ccm-1)*/
2216 RESTRICT_TO_RANGE(adj, -ccm, ccm+1);
2217 if (adj == 0) {
2218 /* In rare case of no adjustment */
2219 return;
2220 }
2221 v4l_linesize = VIDEOSIZE_X(frame->request) * V4L_BYTES_PER_PIXEL;
2222 for (i=0; i < VIDEOSIZE_Y(frame->request); i++) {
2223 unsigned char *fd = frame->data + (v4l_linesize * i);
2224 for (j=0; j < v4l_linesize; j++) {
2225 signed long v = (signed long) fd[j];
2226 /* Magnify up to 2 times, reduce down to zero */
2227 v = 128 + ((ccm + adj) * (v - 128)) / ccm;
2228 RESTRICT_TO_RANGE(v, 0, 0xFF); /* Must flatten tails */
2229 fd[j] = (unsigned char) v;
2230 }
2231 }
2232}
2233
2234MODULE_LICENSE("GPL");