| blob | 68b1f4fd1cd10efa4c3c72969c2b4bae30764012 |
1 /******************************************************************************
2 * *
3 * easycap_main.c *
4 * *
5 * Video driver for EasyCAP USB2.0 Video Capture Device DC60 *
6 * *
7 * *
8 ******************************************************************************/
9 /*
10 *
11 * Copyright (C) 2010 R.M. Thomas <rmthomas@sciolus.org>
12 *
13 *
14 * This is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License as published by
16 * the Free Software Foundation; either version 2 of the License, or
17 * (at your option) any later version.
18 *
19 * The software is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU General Public License for more details.
23 *
24 * You should have received a copy of the GNU General Public License
25 * along with this software; if not, write to the Free Software
26 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
27 *
28 */
29 /*****************************************************************************/
32 #include <linux/usb/audio.h>
40 #ifdef CONFIG_EASYCAP_DEBUG
71 {
72 #define ERRNOSTR(_e) case _e: return # _e
107 }
109 #undef ERRNOSTR
110 }
112 /*---------------------------------------------------------------------------*/
113 /*
114 * PARAMETERS USED WHEN REGISTERING THE VIDEO INTERFACE
115 *
116 * NOTE: SOME KERNELS IGNORE usb_class_driver.minor_base, AS MENTIONED BY
117 * CORBET ET AL. "LINUX DEVICE DRIVERS", 3rd EDITION, PAGE 253.
118 * THIS IS THE CASE FOR OpenSUSE.
119 */
120 /*---------------------------------------------------------------------------*/
121 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
122 /****************************************************************************/
123 /*---------------------------------------------------------------------------*/
124 /*
125 * THIS ROUTINE DOES NOT DETECT DUPLICATE OCCURRENCES OF POINTER peasycap
126 */
127 /*---------------------------------------------------------------------------*/
129 {
137 }
138 }
140 }
141 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
143 {
155 }
160 }
164 }
170 }
179 else
182 }
188 }
190 }
192 /*****************************************************************************/
193 /*---------------------------------------------------------------------------*/
194 /*
195 * RESET THE HARDWARE TO ITS REFERENCE STATE.
196 *
197 * THIS ROUTINE MAY BE CALLED REPEATEDLY IF easycap_complete() DETECTS
198 * A BAD VIDEO FRAME SIZE.
199 */
200 /*---------------------------------------------------------------------------*/
202 {
211 }
214 /*---------------------------------------------------------------------------*/
215 /*
216 * IF THE SAA7113H HAS ALREADY ACQUIRED SYNC, USE ITS HARDWARE-DETECTED
217 * FIELD FREQUENCY TO DISTINGUISH NTSC FROM PAL. THIS IS ESSENTIAL FOR
218 * gstreamer AND OTHER USERSPACE PROGRAMS WHICH MAY NOT ATTEMPT TO INITIATE
219 * A SWITCH BETWEEN PAL AND NTSC.
220 *
221 * FUNCTION ready_saa() MAY REQUIRE A SUBSTANTIAL FRACTION OF A SECOND TO
222 * COMPLETE, SO SHOULD NOT BE INVOKED WITHOUT GOOD REASON.
223 */
224 /*---------------------------------------------------------------------------*/
237 }
242 }
254 }
258 }
260 /*---------------------------------------------------------------------------*/
266 }
271 }
278 /*---------------------------------------------------------------------------*/
279 /*
280 * RESTORE INPUT AND FORCE REFRESH OF STANDARD, FORMAT, ETC.
281 *
282 * WHILE THIS PROCEDURE IS IN PROGRESS, SOME IOCTL COMMANDS WILL RETURN -EBUSY.
283 */
284 /*---------------------------------------------------------------------------*/
295 }
296 peasycap_standard++;
297 }
301 }
304 }
316 }
324 }
329 }
334 }
339 }
343 }
348 }
352 }
354 }
355 /*****************************************************************************/
356 /*---------------------------------------------------------------------------*/
357 /*
358 * IF THE REQUESTED INPUT IS THE SAME AS THE EXISTING INPUT, DO NOTHING.
359 * OTHERWISE:
360 * KILL URBS, CLEAR FIELD AND FRAME BUFFERS AND RESET THEIR
361 * _read AND _fill POINTERS.
362 * SELECT THE NEW INPUT.
363 * ADJUST THE STANDARD, FORMAT, BRIGHTNESS, CONTRAST, SATURATION AND HUE
364 * ON THE BASIS OF INFORMATION IN STRUCTURE easycap.inputset[input].
365 * RESUBMIT THE URBS IF STREAMING WAS ALREADY IN PROGRESS.
366 *
367 * NOTE:
368 * THIS ROUTINE MAY BE CALLED FREQUENTLY BY ZONEMINDER VIA IOCTL,
369 * SO IT SHOULD WRITE ONLY SPARINGLY TO THE LOGFILE.
370 */
371 /*---------------------------------------------------------------------------*/
372 int
374 {
382 }
390 /*---------------------------------------------------------------------------*/
391 /*
392 * IF STREAMING IS IN PROGRESS THE URBS ARE KILLED AT THIS
393 * STAGE AND WILL BE RESUBMITTED PRIOR TO EXIT FROM THE ROUTINE.
394 * IF NO STREAMING IS IN PROGRESS NO URBS WILL BE SUBMITTED BY THE
395 * ROUTINE.
396 */
397 /*---------------------------------------------------------------------------*/
408 }
409 /*---------------------------------------------------------------------------*/
413 }
420 }
425 }
429 }
433 }
444 }
447 /*---------------------------------------------------------------------------*/
456 }
462 }
473 }
479 }
486 }
489 }
496 }
498 }
505 }
508 }
515 }
517 }
521 }
522 /*---------------------------------------------------------------------------*/
526 }
533 }
538 }
548 }
549 /*****************************************************************************/
551 {
561 }
566 }
570 }
601 }
605 isbad++;
610 nospc++;
612 m++;
613 }
615 isbad++;
616 }
617 }
622 }
633 }
634 }
639 }
642 }
644 }
645 /*****************************************************************************/
647 {
655 }
660 }
664 }
673 m++;
674 }
675 }
679 }
680 /****************************************************************************/
681 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
682 /*--------------------------------------------------------------------------*/
684 {
686 }
689 {
697 }
701 }
705 }
708 }
709 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
710 /*****************************************************************************/
711 /*--------------------------------------------------------------------------*/
712 /*
713 * THIS FUNCTION IS CALLED FROM WITHIN easycap_usb_disconnect() AND IS
714 * PROTECTED BY SEMAPHORES SET AND CLEARED BY easycap_usb_disconnect().
715 *
716 * BY THIS STAGE THE DEVICE HAS ALREADY BEEN PHYSICALLY UNPLUGGED, SO
717 * peasycap->pusb_device IS NO LONGER VALID.
718 */
719 /*---------------------------------------------------------------------------*/
721 {
738 }
742 }
744 /*---------------------------------------------------------------------------*/
745 /*
746 * FREE VIDEO.
747 */
748 /*---------------------------------------------------------------------------*/
762 m++;
763 }
764 }
765 }
768 /*---------------------------------------------------------------------------*/
780 m++;
781 }
782 }
786 }
787 /*---------------------------------------------------------------------------*/
794 VIDEO_ISOC_ORDER);
798 m++;
799 }
800 }
803 /*---------------------------------------------------------------------------*/
813 gone++;
814 }
815 }
816 }
818 /*---------------------------------------------------------------------------*/
828 gone++;
829 }
830 }
831 }
833 /*---------------------------------------------------------------------------*/
834 /*
835 * FREE AUDIO.
836 */
837 /*---------------------------------------------------------------------------*/
851 m++;
852 }
853 }
854 }
856 /*---------------------------------------------------------------------------*/
868 m++;
869 }
870 }
874 }
875 /*---------------------------------------------------------------------------*/
882 AUDIO_ISOC_ORDER);
886 m++;
887 }
888 }
891 /*---------------------------------------------------------------------------*/
892 #ifdef CONFIG_EASYCAP_OSS
900 gone++;
901 }
902 }
905 /*---------------------------------------------------------------------------*/
928 }
931 }
932 /*---------------------------------------------------------------------------*/
944 }
945 /*****************************************************************************/
947 {
958 }
963 }
967 }
971 }
972 /*---------------------------------------------------------------------------*/
978 }
980 /*
981 * MEANWHILE, easycap_usb_disconnect() MAY HAVE FREED POINTER
982 * peasycap, IN WHICH CASE A REPEAT CALL TO isdongle() WILL FAIL.
983 * IF NECESSARY, BAIL OUT.
984 */
991 }
997 }
1002 }
1007 }
1009 /*
1010 * IF easycap_usb_disconnect() HAS ALREADY FREED POINTER peasycap
1011 * BEFORE THE ATTEMPT TO ACQUIRE THE SEMAPHORE, isdongle() WILL
1012 * HAVE FAILED. BAIL OUT.
1013 */
1015 /*---------------------------------------------------------------------------*/
1021 else
1023 }
1024 /*****************************************************************************/
1025 /*---------------------------------------------------------------------------*/
1026 /*
1027 * IF mode IS NONZERO THIS ROUTINE RETURNS -EAGAIN RATHER THAN BLOCKING.
1028 */
1029 /*---------------------------------------------------------------------------*/
1031 {
1038 }
1042 }
1045 /*---------------------------------------------------------------------------*/
1046 /*
1047 * CHECK FOR LOST INPUT SIGNAL.
1048 *
1049 * FOR THE FOUR-CVBS EasyCAP, THIS DOES NOT WORK AS EXPECTED.
1050 * IF INPUT 0 IS PRESENT AND SYNC ACQUIRED, UNPLUGGING INPUT 4 DOES NOT
1051 * RESULT IN SETTING BIT 0x40 ON REGISTER 0x1F, PRESUMABLY BECAUSE THERE
1052 * IS FLYWHEELING ON INPUT 0. THE UPSHOT IS:
1053 *
1054 * INPUT 0 PLUGGED, INPUT 4 PLUGGED => SCREEN 0 OK, SCREEN 4 OK
1055 * INPUT 0 PLUGGED, INPUT 4 UNPLUGGED => SCREEN 0 OK, SCREEN 4 BLACK
1056 * INPUT 0 UNPLUGGED, INPUT 4 PLUGGED => SCREEN 0 BARS, SCREEN 4 OK
1057 * INPUT 0 UNPLUGGED, INPUT 4 UNPLUGGED => SCREEN 0 BARS, SCREEN 4 BARS
1058 */
1059 /*---------------------------------------------------------------------------*/
1066 else
1073 }
1074 }
1075 /*---------------------------------------------------------------------------*/
1076 /*
1077 * WAIT FOR FIELD ifield (0 => TOP, 1 => BOTTOM)
1078 */
1079 /*---------------------------------------------------------------------------*/
1099 }
1104 }
1107 #if defined(PERSEVERE)
1118 }
1122 }
1129 }
1130 miss++;
1131 }
1137 /*---------------------------------------------------------------------------*/
1138 /*
1139 * WAIT FOR THE OTHER FIELD
1140 */
1141 /*---------------------------------------------------------------------------*/
1144 else
1162 }
1167 }
1170 #if defined(PERSEVERE)
1181 }
1185 }
1192 }
1193 miss++;
1194 }
1200 /*---------------------------------------------------------------------------*/
1201 /*
1202 * WASTE THIS FRAME
1203 */
1204 /*---------------------------------------------------------------------------*/
1209 else
1211 }
1212 /*---------------------------------------------------------------------------*/
1223 V4L2_FIELD_TOP;
1224 else
1226 V4L2_FIELD_BOTTOM;
1233 }
1234 /*****************************************************************************/
1235 /*---------------------------------------------------------------------------*/
1236 /*
1237 * BY DEFINITION, odd IS true FOR THE FIELD OCCUPYING LINES 1,3,5,...,479
1238 * odd IS false FOR THE FIELD OCCUPYING LINES 0,2,4,...,478
1239 *
1240 * WHEN BOOLEAN PARAMETER decimatepixel IS true, ONLY THE FIELD FOR WHICH
1241 * odd==false IS TRANSFERRED TO THE FRAME BUFFER.
1242 *
1243 * THE BOOLEAN PARAMETER offerfields IS true ONLY WHEN THE USER PROGRAM
1244 * CHOOSES THE OPTION V4L2_FIELD_INTERLACED.
1245 */
1246 /*---------------------------------------------------------------------------*/
1247 int
1249 {
1252 u32 remainder;
1266 }
1280 /*---------------------------------------------------------------------------*/
1281 /*
1282 * REJECT OR CLEAN BAD FIELDS
1283 */
1284 /*---------------------------------------------------------------------------*/
1289 }
1290 #ifdef EASYCAP_TESTCARD
1292 #else
1296 }
1298 /*---------------------------------------------------------------------------*/
1309 }
1312 else
1331 }
1337 /*
1338 * PROCESS ONE LINE OF FRAME AT FULL RESOLUTION:
1339 * READ w2 BYTES FROM FIELD BUFFER,
1340 * WRITE w3 BYTES TO FRAME BUFFER
1341 */
1354 }
1358 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1361 /*
1362 * INJUDICIOUS ALTERATION OF
1363 * THIS STATEMENT BLOCK WILL
1364 * CAUSE BREAKAGE. BEWARE.
1365 */
1370 }
1377 else
1379 }
1382 bytesperpixel);
1384 }
1386 caches++;
1389 "[%i][%i].input, "
1391 peasycap->field_buffer
1394 }
1400 }
1407 mex++;
1412 }
1416 mad++;
1422 }
1423 }
1425 /*---------------------------------------------------------------------------*/
1426 /*
1427 * SKIP w3 BYTES IN TARGET FRAME BUFFER,
1428 * UNLESS IT IS THE LAST LINE OF AN ODD FRAME
1429 */
1430 /*---------------------------------------------------------------------------*/
1435 mad++;
1439 }
1447 }
1448 /*---------------------------------------------------------------------------*/
1449 /*
1450 * PROCESS ONE LINE OF FRAME AT REDUCED RESOLUTION:
1451 * ONLY IF false==odd,
1452 * READ w2 BYTES FROM FIELD BUFFER,
1453 * WRITE w3 / 2 BYTES TO FRAME BUFFER
1454 */
1455 /*---------------------------------------------------------------------------*/
1467 }
1470 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1473 /*
1474 * INJUDICIOUS ALTERATION OF
1475 * THIS STATEMENT BLOCK
1476 * WILL CAUSE BREAKAGE.
1477 * BEWARE.
1478 */
1483 }
1490 else
1492 }
1493 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1496 bytesperpixel);
1498 }
1499 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1501 caches++;
1505 "[%i][%i].input, "
1507 peasycap->field_buffer
1510 }
1516 }
1520 mex++;
1526 }
1530 mad++;
1536 }
1537 }
1539 /*---------------------------------------------------------------------------*/
1540 /*
1541 * OTHERWISE JUST
1542 * READ w2 BYTES FROM FIELD BUFFER AND DISCARD THEM
1543 */
1544 /*---------------------------------------------------------------------------*/
1549 mex++;
1555 "[%i][%i].input, "
1557 peasycap->field_buffer
1561 }
1562 }
1571 }
1572 }
1573 /*---------------------------------------------------------------------------*/
1574 /*
1575 * SANITY CHECKS
1576 */
1577 /*---------------------------------------------------------------------------*/
1597 }
1598 }
1611 /*---------------------------------------------------------------------------*/
1612 /*
1613 * CALCULATE VIDEO STREAMING RATE
1614 */
1615 /*---------------------------------------------------------------------------*/
1630 }
1636 }
1637 /*****************************************************************************/
1638 struct signed_div_result
1640 {
1653 }
1655 }
1656 /*****************************************************************************/
1657 /*---------------------------------------------------------------------------*/
1658 /*
1659 * DECIMATION AND COLOURSPACE CONVERSION.
1660 *
1661 * THIS ROUTINE REQUIRES THAT ALL THE DATA TO BE READ RESIDES ON ONE PAGE
1662 * AND THAT ALL THE DATA TO BE WRITTEN RESIDES ON ONE (DIFFERENT) PAGE.
1663 * THE CALLING ROUTINE MUST ENSURE THAT THIS REQUIREMENT IS MET, AND MUST
1664 * ALSO ENSURE THAT much IS EVEN.
1665 *
1666 * much BYTES ARE READ, AT LEAST (bytesperpixel * much)/2 BYTES ARE WRITTEN
1667 * IF THERE IS NO DECIMATION, HALF THIS AMOUNT IF THERE IS DECIMATION.
1668 *
1669 * mask IS ZERO WHEN NO SPECIAL BEHAVIOUR REQUIRED. OTHERWISE IT IS SET THUS:
1670 * 0x03 & mask = number of bytes to be written to cache instead of to
1671 * frame buffer
1672 * 0x04 & mask => use argument margin to set the chrominance for last pixel
1673 * 0x08 & mask => do not set the chrominance for last pixel
1674 *
1675 * YUV to RGB CONVERSION IS (OR SHOULD BE) ITU-R BT 601.
1676 *
1677 * THERE IS A LOT OF CODE REPETITION IN THIS ROUTINE IN ORDER TO AVOID
1678 * INEFFICIENT SWITCHING INSIDE INNER LOOPS. REARRANGING THE LOGIC TO
1679 * REDUCE CODE LENGTH WILL GENERALLY IMPAIR RUNTIME PERFORMANCE. BEWARE.
1680 */
1681 /*---------------------------------------------------------------------------*/
1682 int
1685 {
1692 s32 tmp;
1697 }
1702 /*---------------------------------------------------------------------------*/
1713 }
1717 }
1721 }
1729 }
1733 /*---------------------------------------------------------------------------*/
1734 /*
1735 * TRANSFER CONTENTS OF CACHE TO THE FRAME BUFFER
1736 */
1737 /*---------------------------------------------------------------------------*/
1741 }
1749 }
1754 }
1755 /*---------------------------------------------------------------------------*/
1759 p2++;
1763 else
1769 /*---------------------------------------------------------------------------*/
1775 /* UYVY */
1778 /* YUYV */
1785 }
1787 }
1790 /* UYVY DECIMATED */
1798 }
1801 /* YUYV DECIMATED */
1809 }
1811 }
1812 }
1814 }
1816 {
1819 /* RGB */
1823 else
1830 else
1834 ;
1838 else
1840 }
1860 }
1866 }
1871 }
1872 }
1877 }
1881 else
1884 }
1887 /* BGR */
1891 else
1898 else
1900 }
1901 else
1903 ;
1907 else
1909 }
1929 }
1935 }
1940 }
1941 }
1946 }
1950 else
1953 }
1954 }
1958 /* RGB DECIMATED */
1962 else
1969 else
1973 ;
1977 else
1979 }
2001 }
2007 }
2013 }
2014 }
2019 }
2024 }
2026 }
2029 /* BGR DECIMATED */
2033 else
2040 else
2044 ;
2048 else
2050 }
2073 }
2079 }
2085 }
2086 }
2091 }
2094 }
2095 else
2098 }
2100 }
2101 }
2103 }
2105 {
2108 /* RGBA */
2112 else
2119 else
2123 ;
2127 else
2129 }
2150 }
2157 }
2164 }
2169 }
2170 }
2176 }
2180 else
2183 }
2186 /*
2187 * BGRA
2188 */
2192 else
2199 else
2203 ;
2207 else
2209 }
2230 }
2237 }
2244 }
2249 }
2255 }
2259 else
2262 }
2263 }
2267 /*
2268 * RGBA DECIMATED
2269 */
2273 else
2280 else
2284 ;
2288 else
2290 }
2314 }
2321 }
2328 }
2332 bytesperpixel -
2333 rump);
2335 }
2336 }
2342 }
2348 }
2351 /*
2352 * BGRA DECIMATED
2353 */
2357 else
2364 else
2368 ;
2372 else
2374 }
2397 }
2404 }
2411 }
2417 }
2418 }
2424 }
2430 }
2432 }
2433 }
2435 }
2439 }
2440 }
2442 }
2443 /*****************************************************************************/
2444 /*
2445 * SEE CORBET ET AL. "LINUX DEVICE DRIVERS", 3rd EDITION, PAGES 430-434
2446 */
2447 /*****************************************************************************/
2449 {
2456 }
2460 }
2464 }
2465 /*****************************************************************************/
2467 {
2474 }
2478 }
2482 }
2483 /*****************************************************************************/
2485 {
2496 }
2500 }
2507 else
2513 }
2517 }
2522 }
2523 /*---------------------------------------------------------------------------*/
2528 }
2533 }
2535 /*---------------------------------------------------------------------------*/
2541 }
2543 }
2549 };
2552 {
2561 }
2562 /*****************************************************************************/
2563 /*---------------------------------------------------------------------------*/
2564 /*
2565 * ON COMPLETION OF A VIDEO URB ITS DATA IS COPIED TO THE FIELD BUFFERS
2566 * PROVIDED peasycap->video_idle IS ZERO. REGARDLESS OF THIS BEING TRUE,
2567 * IT IS RESUBMITTED PROVIDED peasycap->video_isoc_streaming IS NOT ZERO.
2568 *
2569 * THIS FUNCTION IS AN INTERRUPT SERVICE ROUTINE AND MUST NOT SLEEP.
2570 *
2571 * INFORMATION ABOUT THE VALIDITY OF THE CONTENTS OF THE FIELD BUFFER ARE
2572 * STORED IN THE TWO-BYTE STATUS PARAMETER
2573 * peasycap->field_buffer[peasycap->field_fill][0].kount
2574 * NOTICE THAT THE INFORMATION IS STORED ONLY WITH PAGE 0 OF THE FIELD BUFFER.
2575 *
2576 * THE LOWER BYTE CONTAINS THE FIELD PARITY BYTE FURNISHED BY THE SAA7113H
2577 * CHIP.
2578 *
2579 * THE UPPER BYTE IS ZERO IF NO PROBLEMS, OTHERWISE:
2580 * 0 != (kount & 0x8000) => AT LEAST ONE URB COMPLETED WITH ERRORS
2581 * 0 != (kount & 0x4000) => BUFFER HAS TOO MUCH DATA
2582 * 0 != (kount & 0x2000) => BUFFER HAS NOT ENOUGH DATA
2583 * 0 != (kount & 0x1000) => BUFFER HAS DATA FROM DISPARATE INPUTS
2584 * 0 != (kount & 0x0400) => RESERVED
2585 * 0 != (kount & 0x0200) => FIELD BUFFER NOT YET CHECKED
2586 * 0 != (kount & 0x0100) => BUFFER HAS TWO EXTRA BYTES - WHY?
2587 */
2588 /*---------------------------------------------------------------------------*/
2590 {
2603 }
2608 }
2612 }
2624 }
2636 "usb_submit_urb() "
2639 }
2640 }
2642 }
2644 /*---------------------------------------------------------------------------*/
2648 }
2653 }
2658 /*---------------------------------------------------------------------------*/
2664 /* FIXME: 1. missing '-' check boundaries */
2667 }
2674 "%4i=status "
2675 "%4i=actual "
2676 "%4i=length "
2684 PAGE_SIZE) +
2693 }
2697 }
2702 }
2709 else
2711 /*--------------------------------------------------------------------------*/
2712 /*
2713 * EIGHT-BYTE END-OF-VIDEOFIELD MARKER.
2714 * NOTE: A SUCCESSION OF URB FRAMES FOLLOWING THIS ARE EMPTY,
2715 * CORRESPONDING TO THE FIELD FLYBACK (VERTICAL BLANKING) PERIOD.
2716 *
2717 * PROVIDED THE FIELD BUFFER CONTAINS GOOD DATA AS INDICATED BY A ZERO UPPER
2718 * BYTE OF
2719 * peasycap->field_buffer[peasycap->field_fill][0].kount
2720 * THE CONTENTS OF THE FIELD BUFFER ARE OFFERED TO dqbuf(), field_read IS
2721 * UPDATED AND field_fill IS BUMPED. IF THE FIELD BUFFER CONTAINS BAD DATA
2722 * NOTHING IS OFFERED TO dqbuf().
2723 *
2724 * THE DECISION ON WHETHER THE PARITY OF THE OFFERED FIELD BUFFER IS RIGHT
2725 * RESTS WITH dqbuf().
2726 */
2727 /*---------------------------------------------------------------------------*/
2732 peasycap->
2733 videofieldamount) {
2738 VIDEO_JUNK_TOLERATE);
2744 peasycap->
2745 videofieldamount) {
2749 }
2761 field_fill)++;
2763 peasycap->
2764 field_fill)
2765 peasycap->
2769 field_buffer
2771 field_fill]
2773 field_page];
2777 "peasycap->"
2778 "field_fill %i="
2784 "%i bytes fit to be "
2787 videofieldamount);
2789 "wq_video, "
2790 "%i=field_read "
2791 "%i=field_fill "
2796 field_buffer
2799 wake_up_interruptible
2801 wq_video));
2802 do_gettimeofday
2810 "bytes, now discarded: "
2813 videofieldamount,
2815 peasycap->field_buffer
2817 kount));
2824 pfield_buffer =
2835 }
2842 else
2848 }
2849 }
2850 /*---------------------------------------------------------------------------*/
2851 /*
2852 * COPY more BYTES FROM ISOC BUFFER TO FIELD BUFFER
2853 */
2854 /*---------------------------------------------------------------------------*/
2861 }
2865 }
2876 }
2885 }
2887 field_buffer
2895 input !=
2900 }
2912 }
2913 }
2914 }
2915 }
2916 }
2917 /*---------------------------------------------------------------------------*/
2918 /*
2919 * RESUBMIT THIS URB, UNLESS A SEVERE PERSISTENT ERROR CONDITION EXISTS.
2920 *
2921 * IF THE WAIT QUEUES ARE NOT CLEARED IN RESPONSE TO AN ERROR CONDITION
2922 * THE USERSPACE PROGRAM, E.G. mplayer, MAY HANG ON EXIT. BEWARE.
2923 */
2924 /*---------------------------------------------------------------------------*/
2931 #if !defined(PERSEVERE)
2936 }
2943 "usb_submit_urb() "
2946 }
2947 }
2949 }
2957 };
2962 };
2963 /*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
2970 };
2971 /*****************************************************************************/
2972 /*---------------------------------------------------------------------------*/
2973 /*
2974 * WHEN THE EasyCAP IS PHYSICALLY PLUGGED IN, THIS FUNCTION IS CALLED THREE
2975 * TIMES, ONCE FOR EACH OF THE THREE INTERFACES. BEWARE.
2976 */
2977 /*---------------------------------------------------------------------------*/
2980 {
2994 u8 bEndpointAddress;
2995 u8 ISOCbEndpointAddress;
2996 u8 INTbEndpointAddress;
2998 u8 bInterfaceNumber;
2999 u8 bInterfaceClass;
3000 u8 bInterfaceSubClass;
3006 u16 mask;
3007 s32 value;
3015 /*---------------------------------------------------------------------------*/
3020 }
3025 }
3026 /*---------------------------------------------------------------------------*/
3027 /*
3028 * GET PROPERTIES OF PROBED INTERFACE
3029 */
3030 /*---------------------------------------------------------------------------*/
3038 bInterfaceNumber,
3042 /*---------------------------------------------------------------------------*/
3043 /*
3044 * A NEW struct easycap IS ALWAYS ALLOCATED WHEN INTERFACE 0 IS PROBED.
3045 * IT IS NOT POSSIBLE HERE TO FREE ANY EXISTING struct easycap. THIS
3046 * SHOULD HAVE BEEN DONE BY easycap_delete() WHEN THE EasyCAP WAS
3047 * PHYSICALLY UNPLUGGED.
3048 *
3049 * THE POINTER peasycap TO THE struct easycap IS REMEMBERED WHEN
3050 * INTERFACES 1 AND 2 ARE PROBED.
3051 */
3052 /*---------------------------------------------------------------------------*/
3058 }
3059 /*---------------------------------------------------------------------------*/
3060 /*
3061 * PERFORM URGENT INTIALIZATIONS ...
3062 */
3063 /*---------------------------------------------------------------------------*/
3071 /* module params */
3082 /*---------------------------------------------------------------------------*/
3083 /*
3084 * FOR INTERFACES 1 AND 2 THE POINTER peasycap WILL NEED TO
3085 * TO BE THE SAME AS THAT ALLOCATED NOW FOR INTERFACE 0.
3086 *
3087 * NORMALLY ndong WILL NOT HAVE CHANGED SINCE INTERFACE 0 WAS
3088 * PROBED, BUT THIS MAY NOT BE THE CASE IF, FOR EXAMPLE, TWO
3089 * EASYCAPs ARE PLUGGED IN SIMULTANEOUSLY.
3090 */
3091 /*---------------------------------------------------------------------------*/
3104 }
3105 }
3110 }
3112 }
3120 /*---------------------------------------------------------------------------*/
3121 /*
3122 * ... AND FURTHER INITIALIZE THE STRUCTURE
3123 */
3124 /*---------------------------------------------------------------------------*/
3152 /*---------------------------------------------------------------------------*/
3153 /*
3154 * DYNAMICALLY FILL IN THE AVAILABLE FORMATS ...
3155 */
3156 /*---------------------------------------------------------------------------*/
3161 }
3163 /*---------------------------------------------------------------------------*/
3164 /*
3165 * ... AND POPULATE easycap.inputset[]
3166 */
3167 /*---------------------------------------------------------------------------*/
3168 /* FIXME: maybe we just use memset 0 */
3178 }
3185 m++;
3190 }
3191 }
3197 }
3208 m++;
3212 }
3213 peasycap_format++;
3214 }
3218 }
3224 m++;
3228 m++;
3232 m++;
3236 m++;
3239 }
3240 }
3245 }
3251 /*---------------------------------------------------------------------------*/
3252 /*
3253 * FIXME
3254 *
3255 * IDENTIFY THE APPROPRIATE POINTER peasycap FOR INTERFACES 1 AND 2.
3256 * THE ADDRESS OF peasycap->pusb_device IS RELUCTANTLY USED FOR THIS PURPOSE.
3257 */
3258 /*---------------------------------------------------------------------------*/
3261 pusb_device) {
3266 }
3267 }
3270 bInterfaceNumber);
3272 }
3275 bInterfaceNumber);
3277 }
3278 /*---------------------------------------------------------------------------*/
3279 /*
3280 * SOME VERSIONS OF THE videodev MODULE OVERWRITE THE DATA WHICH HAS
3281 * BEEN WRITTEN BY THE CALL TO usb_set_intfdata() IN easycap_usb_probe(),
3282 * REPLACING IT WITH A POINTER TO THE EMBEDDED v4l2_device STRUCTURE.
3283 * TO DETECT THIS, THE STRING IN THE easycap.telltale[] BUFFER IS CHECKED.
3284 */
3285 /*---------------------------------------------------------------------------*/
3291 }
3294 }
3295 }
3296 /*---------------------------------------------------------------------------*/
3310 }
3311 }
3325 }
3326 }
3327 }
3328 /*---------------------------------------------------------------------------*/
3329 /*
3330 * INVESTIGATE ALL ALTSETTINGS.
3331 * DONE IN DETAIL BECAUSE USB DEVICE 05e1:0408 HAS DISPARATE INCARNATIONS.
3332 */
3333 /*---------------------------------------------------------------------------*/
3341 }
3346 }
3375 /*---------------------------------------------------------------------------*/
3382 }
3409 }
3411 USB_ENDPOINT_XFER_ISOC) {
3422 }
3429 isokalt);
3431 ep->
3432 bEndpointAddress &
3437 isokalt);
3440 wMaxPacketSize);
3444 isokalt);
3445 isokalt++;
3446 }
3449 video_altsetting_off) {
3450 peasycap->
3451 video_altsetting_off =
3452 i;
3454 "altsetting_off "
3456 peasycap->
3457 video_altsetting_off);
3460 "->video_altsetting_"
3463 "continuing with "
3464 "%i=peasycap->video_"
3466 peasycap->
3467 video_altsetting_off);
3468 }
3469 }
3471 }
3474 USB_SUBCLASS_AUDIOSTREAMING)
3480 }
3487 isokalt);
3489 ep->
3490 bEndpointAddress &
3495 isokalt);
3498 wMaxPacketSize);
3502 isokalt);
3503 isokalt++;
3504 }
3507 audio_altsetting_off) {
3508 peasycap->
3509 audio_altsetting_off =
3510 i;
3512 "altsetting_off "
3514 peasycap->
3515 audio_altsetting_off);
3518 "->audio_altsetting_"
3521 "continuing with "
3522 "%i=peasycap->"
3523 "audio_altsetting_"
3525 peasycap->
3526 audio_altsetting_off);
3527 }
3528 }
3530 }
3533 }
3534 }
3536 USB_ENDPOINT_XFERTYPE_MASK) ==
3537 USB_ENDPOINT_XFER_BULK) {
3541 USB_ENDPOINT_XFERTYPE_MASK) ==
3542 USB_ENDPOINT_XFER_INT) {
3548 }
3553 }
3554 }
3555 }
3556 /*---------------------------------------------------------------------------*/
3557 /*
3558 * PERFORM INITIALIZATION OF THE PROBED INTERFACE
3559 */
3560 /*---------------------------------------------------------------------------*/
3564 /*---------------------------------------------------------------------------*/
3565 /*
3566 * INTERFACE 0 IS THE VIDEO INTERFACE
3567 */
3568 /*---------------------------------------------------------------------------*/
3573 }
3581 }
3582 /*---------------------------------------------------------------------------*/
3583 /*
3584 * DECIDE THE VIDEO STREAMING PARAMETERS
3585 */
3586 /*---------------------------------------------------------------------------*/
3597 }
3607 }
3617 }
3618 /*---------------------------------------------------------------------------*/
3622 }
3626 }
3630 }
3634 }
3638 }
3642 }
3643 /*---------------------------------------------------------------------------*/
3644 /*
3645 * ALLOCATE MEMORY FOR VIDEO BUFFERS. LISTS MUST BE INITIALIZED FIRST.
3646 */
3647 /*---------------------------------------------------------------------------*/
3650 /*---------------------------------------------------------------------------*/
3670 }
3673 }
3674 }
3679 m);
3680 /*---------------------------------------------------------------------------*/
3697 }
3698 else
3701 }
3704 }
3706 }
3711 m);
3712 /*---------------------------------------------------------------------------*/
3714 VIDEO_ISOC_BUFFER_MANY,
3720 VIDEO_ISOC_ORDER);
3733 }
3736 /*---------------------------------------------------------------------------*/
3737 /*
3738 * ALLOCATE AND INITIALIZE MULTIPLE struct urb ...
3739 */
3740 /*---------------------------------------------------------------------------*/
3751 GFP_KERNEL);
3758 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
3772 /*---------------------------------------------------------------------------*/
3773 /*
3774 * ... AND INITIALIZE THEM
3775 */
3776 /*---------------------------------------------------------------------------*/
3802 }
3821 }
3822 }
3824 /*--------------------------------------------------------------------------*/
3825 /*
3826 * SAVE POINTER peasycap IN THIS INTERFACE.
3827 */
3828 /*--------------------------------------------------------------------------*/
3830 /*---------------------------------------------------------------------------*/
3831 /*
3832 * IT IS ESSENTIAL TO INITIALIZE THE HARDWARE BEFORE, RATHER THAN AFTER,
3833 * THE DEVICE IS REGISTERED, BECAUSE SOME VERSIONS OF THE videodev MODULE
3834 * CALL easycap_open() IMMEDIATELY AFTER REGISTRATION, CAUSING A CLASH.
3835 * BEWARE.
3836 */
3837 /*---------------------------------------------------------------------------*/
3845 }
3846 /*--------------------------------------------------------------------------*/
3847 /*
3848 * THE VIDEO DEVICE CAN BE REGISTERED NOW, AS IT IS READY.
3849 */
3850 /*--------------------------------------------------------------------------*/
3858 }
3859 /*---------------------------------------------------------------------------*/
3860 /*
3861 * FIXME
3862 *
3863 *
3864 * THIS IS BELIEVED TO BE HARMLESS, BUT MAY WELL BE UNNECESSARY OR WRONG:
3865 */
3866 /*---------------------------------------------------------------------------*/
3868 /*---------------------------------------------------------------------------*/
3888 }
3889 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
3892 }
3893 /*--------------------------------------------------------------------------*/
3894 /*
3895 * INTERFACE 1 IS THE AUDIO CONTROL INTERFACE
3896 * INTERFACE 2 IS THE AUDIO STREAMING INTERFACE
3897 */
3898 /*--------------------------------------------------------------------------*/
3903 }
3904 /*--------------------------------------------------------------------------*/
3905 /*
3906 * SAVE POINTER peasycap IN INTERFACE 1
3907 */
3908 /*--------------------------------------------------------------------------*/
3913 }
3914 /*--------------------------------------------------------------------------*/
3919 }
3927 }
3938 }
3944 PAGES_PER_AUDIO_FRAGMENT;
3950 PAGES_PER_AUDIO_FRAGMENT;
3956 }
3978 }
3988 AUDIO_ISOC_BUFFER_SIZE);
3990 }
3994 }
3998 }
4002 }
4006 }
4010 }
4014 }
4015 /*---------------------------------------------------------------------------*/
4016 /*
4017 * ALLOCATE MEMORY FOR AUDIO BUFFERS. LISTS MUST BE INITIALIZED FIRST.
4018 */
4019 /*---------------------------------------------------------------------------*/
4023 #ifdef CONFIG_EASYCAP_OSS
4041 }
4043 }
4049 /*---------------------------------------------------------------------------*/
4051 AUDIO_ISOC_BUFFER_MANY,
4057 AUDIO_ISOC_ORDER);
4070 }
4072 /*---------------------------------------------------------------------------*/
4073 /*
4074 * ALLOCATE AND INITIALIZE MULTIPLE struct urb ...
4075 */
4076 /*---------------------------------------------------------------------------*/
4087 GFP_KERNEL);
4092 }
4094 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
4099 }
4108 /*---------------------------------------------------------------------------*/
4109 /*
4110 * ... AND INITIALIZE THEM
4111 */
4112 /*---------------------------------------------------------------------------*/
4125 #ifdef CONFIG_EASYCAP_OSS
4142 }
4152 #ifdef CONFIG_EASYCAP_OSS
4165 }
4166 }
4168 /*---------------------------------------------------------------------------*/
4169 /*
4170 * SAVE POINTER peasycap IN THIS INTERFACE.
4171 */
4172 /*---------------------------------------------------------------------------*/
4174 /*---------------------------------------------------------------------------*/
4175 /*
4176 * THE AUDIO DEVICE CAN BE REGISTERED NOW, AS IT IS READY.
4177 */
4178 /*---------------------------------------------------------------------------*/
4179 #ifndef CONFIG_EASYCAP_OSS
4191 }
4204 }
4209 }
4210 /*---------------------------------------------------------------------------*/
4211 /*
4212 * INTERFACES OTHER THAN 0, 1 AND 2 ARE UNEXPECTED
4213 */
4214 /*---------------------------------------------------------------------------*/
4218 }
4221 }
4222 /*****************************************************************************/
4223 /*---------------------------------------------------------------------------*/
4224 /*
4225 * WHEN THIS FUNCTION IS CALLED THE EasyCAP HAS ALREADY BEEN PHYSICALLY
4226 * UNPLUGGED. HENCE peasycap->pusb_device IS NO LONGER VALID.
4227 *
4228 * THIS FUNCTION AFFECTS BOTH OSS AND ALSA. BEWARE.
4229 */
4230 /*---------------------------------------------------------------------------*/
4232 {
4235 u8 bInterfaceNumber;
4249 }
4254 }
4266 }
4267 /*---------------------------------------------------------------------------*/
4268 /*
4269 * SOME VERSIONS OF THE videodev MODULE OVERWRITE THE DATA WHICH HAS
4270 * BEEN WRITTEN BY THE CALL TO usb_set_intfdata() IN easycap_usb_probe(),
4271 * REPLACING IT WITH A POINTER TO THE EMBEDDED v4l2_device STRUCTURE.
4272 * TO DETECT THIS, THE STRING IN THE easycap.telltale[] BUFFER IS CHECKED.
4273 */
4274 /*---------------------------------------------------------------------------*/
4280 }
4283 }
4284 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
4285 /*---------------------------------------------------------------------------*/
4289 }
4290 /*---------------------------------------------------------------------------*/
4291 /*
4292 * IF THE WAIT QUEUES ARE NOT CLEARED A DEADLOCK IS POSSIBLE. BEWARE.
4293 */
4294 /*---------------------------------------------------------------------------*/
4299 /*---------------------------------------------------------------------------*/
4311 m++;
4312 }
4313 }
4314 }
4316 }
4318 }
4319 /*---------------------------------------------------------------------------*/
4330 m++;
4331 }
4332 }
4333 }
4335 }
4337 }
4340 }
4341 /*--------------------------------------------------------------------------*/
4342 /*
4343 * DEREGISTER
4344 *
4345 * THIS PROCEDURE WILL BLOCK UNTIL easycap_poll(), VIDEO IOCTL AND AUDIO
4346 * IOCTL ARE ALL UNLOCKED. IF THIS IS NOT DONE AN Oops CAN OCCUR WHEN
4347 * AN EasyCAP IS UNPLUGGED WHILE THE URBS ARE RUNNING. BEWARE.
4348 */
4349 /*--------------------------------------------------------------------------*/
4357 mutex_video)) {
4361 }
4365 }
4366 /*---------------------------------------------------------------------------*/
4372 }
4382 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
4387 }
4389 }
4395 mutex_audio)) {
4399 }
4403 #ifndef CONFIG_EASYCAP_OSS
4409 }
4419 }
4421 }
4424 }
4425 /*---------------------------------------------------------------------------*/
4426 /*
4427 * CALL easycap_delete() IF NO REMAINING REFERENCES TO peasycap
4428 * (ALSO WHEN ALSA HAS BEEN IN USE)
4429 */
4430 /*---------------------------------------------------------------------------*/
4436 }
4443 }
4452 }
4454 }
4464 }
4465 /*---------------------------------------------------------------------------*/
4468 }
4469 /*****************************************************************************/
4471 /*---------------------------------------------------------------------------*/
4472 /*
4473 * PARAMETERS APPLICABLE TO ENTIRE DRIVER, I.E. BOTH VIDEO AND AUDIO
4474 */
4475 /*---------------------------------------------------------------------------*/
4478 { }
4479 };
4487 };
4490 {
4503 }
4509 }
4510 /*****************************************************************************/
4512 {
4514 }
4515 /*****************************************************************************/
4520 /*****************************************************************************/