| blob | 62e07f6a026c86461c42e7ee88b803557c0d9a2c |
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 {
2990 u8 bInterfaceNumber;
2991 u8 bInterfaceClass;
2992 u8 bInterfaceSubClass;
2998 u16 mask;
2999 s32 value;
3007 /*---------------------------------------------------------------------------*/
3012 }
3017 }
3018 /*---------------------------------------------------------------------------*/
3019 /*
3020 * GET PROPERTIES OF PROBED INTERFACE
3021 */
3022 /*---------------------------------------------------------------------------*/
3030 bInterfaceNumber,
3034 /*---------------------------------------------------------------------------*/
3035 /*
3036 * A NEW struct easycap IS ALWAYS ALLOCATED WHEN INTERFACE 0 IS PROBED.
3037 * IT IS NOT POSSIBLE HERE TO FREE ANY EXISTING struct easycap. THIS
3038 * SHOULD HAVE BEEN DONE BY easycap_delete() WHEN THE EasyCAP WAS
3039 * PHYSICALLY UNPLUGGED.
3040 *
3041 * THE POINTER peasycap TO THE struct easycap IS REMEMBERED WHEN
3042 * INTERFACES 1 AND 2 ARE PROBED.
3043 */
3044 /*---------------------------------------------------------------------------*/
3050 }
3051 /*---------------------------------------------------------------------------*/
3052 /*
3053 * PERFORM URGENT INTIALIZATIONS ...
3054 */
3055 /*---------------------------------------------------------------------------*/
3063 /* module params */
3074 /*---------------------------------------------------------------------------*/
3075 /*
3076 * FOR INTERFACES 1 AND 2 THE POINTER peasycap WILL NEED TO
3077 * TO BE THE SAME AS THAT ALLOCATED NOW FOR INTERFACE 0.
3078 *
3079 * NORMALLY ndong WILL NOT HAVE CHANGED SINCE INTERFACE 0 WAS
3080 * PROBED, BUT THIS MAY NOT BE THE CASE IF, FOR EXAMPLE, TWO
3081 * EASYCAPs ARE PLUGGED IN SIMULTANEOUSLY.
3082 */
3083 /*---------------------------------------------------------------------------*/
3096 }
3097 }
3102 }
3104 }
3112 /*---------------------------------------------------------------------------*/
3113 /*
3114 * ... AND FURTHER INITIALIZE THE STRUCTURE
3115 */
3116 /*---------------------------------------------------------------------------*/
3144 /*---------------------------------------------------------------------------*/
3145 /*
3146 * DYNAMICALLY FILL IN THE AVAILABLE FORMATS ...
3147 */
3148 /*---------------------------------------------------------------------------*/
3153 }
3155 /*---------------------------------------------------------------------------*/
3156 /*
3157 * ... AND POPULATE easycap.inputset[]
3158 */
3159 /*---------------------------------------------------------------------------*/
3160 /* FIXME: maybe we just use memset 0 */
3170 }
3177 m++;
3182 }
3183 }
3189 }
3200 m++;
3204 }
3205 peasycap_format++;
3206 }
3210 }
3216 m++;
3220 m++;
3224 m++;
3228 m++;
3231 }
3232 }
3237 }
3243 /*---------------------------------------------------------------------------*/
3244 /*
3245 * FIXME
3246 *
3247 * IDENTIFY THE APPROPRIATE POINTER peasycap FOR INTERFACES 1 AND 2.
3248 * THE ADDRESS OF peasycap->pusb_device IS RELUCTANTLY USED FOR THIS PURPOSE.
3249 */
3250 /*---------------------------------------------------------------------------*/
3253 pusb_device) {
3258 }
3259 }
3262 bInterfaceNumber);
3264 }
3267 bInterfaceNumber);
3269 }
3270 /*---------------------------------------------------------------------------*/
3271 /*
3272 * SOME VERSIONS OF THE videodev MODULE OVERWRITE THE DATA WHICH HAS
3273 * BEEN WRITTEN BY THE CALL TO usb_set_intfdata() IN easycap_usb_probe(),
3274 * REPLACING IT WITH A POINTER TO THE EMBEDDED v4l2_device STRUCTURE.
3275 * TO DETECT THIS, THE STRING IN THE easycap.telltale[] BUFFER IS CHECKED.
3276 */
3277 /*---------------------------------------------------------------------------*/
3283 }
3286 }
3287 }
3288 /*---------------------------------------------------------------------------*/
3302 }
3303 }
3317 }
3318 }
3319 }
3320 /*---------------------------------------------------------------------------*/
3321 /*
3322 * INVESTIGATE ALL ALTSETTINGS.
3323 * DONE IN DETAIL BECAUSE USB DEVICE 05e1:0408 HAS DISPARATE INCARNATIONS.
3324 */
3325 /*---------------------------------------------------------------------------*/
3333 }
3338 }
3343 /*---------------------------------------------------------------------------*/
3350 }
3354 bInterfaceNumber,
3359 }
3361 }
3371 isokalt);
3373 ep->
3374 bEndpointAddress &
3379 isokalt);
3382 wMaxPacketSize);
3386 isokalt);
3387 isokalt++;
3388 }
3391 video_altsetting_off) {
3392 peasycap->
3393 video_altsetting_off =
3394 i;
3396 "altsetting_off "
3398 peasycap->
3399 video_altsetting_off);
3402 "->video_altsetting_"
3405 "continuing with "
3406 "%i=peasycap->video_"
3408 peasycap->
3409 video_altsetting_off);
3410 }
3411 }
3413 }
3416 USB_SUBCLASS_AUDIOSTREAMING)
3422 }
3429 isokalt);
3431 ep->
3432 bEndpointAddress &
3437 isokalt);
3440 wMaxPacketSize);
3444 isokalt);
3445 isokalt++;
3446 }
3449 audio_altsetting_off) {
3450 peasycap->
3451 audio_altsetting_off =
3452 i;
3454 "altsetting_off "
3456 peasycap->
3457 audio_altsetting_off);
3460 "->audio_altsetting_"
3463 "continuing with "
3464 "%i=peasycap->"
3465 "audio_altsetting_"
3467 peasycap->
3468 audio_altsetting_off);
3469 }
3470 }
3472 }
3475 }
3480 }
3481 }
3482 }
3483 /*---------------------------------------------------------------------------*/
3484 /*
3485 * PERFORM INITIALIZATION OF THE PROBED INTERFACE
3486 */
3487 /*---------------------------------------------------------------------------*/
3491 /*---------------------------------------------------------------------------*/
3492 /*
3493 * INTERFACE 0 IS THE VIDEO INTERFACE
3494 */
3495 /*---------------------------------------------------------------------------*/
3500 }
3508 }
3509 /*---------------------------------------------------------------------------*/
3510 /*
3511 * DECIDE THE VIDEO STREAMING PARAMETERS
3512 */
3513 /*---------------------------------------------------------------------------*/
3524 }
3534 }
3544 }
3545 /*---------------------------------------------------------------------------*/
3549 }
3553 }
3557 }
3561 }
3565 }
3569 }
3570 /*---------------------------------------------------------------------------*/
3571 /*
3572 * ALLOCATE MEMORY FOR VIDEO BUFFERS. LISTS MUST BE INITIALIZED FIRST.
3573 */
3574 /*---------------------------------------------------------------------------*/
3577 /*---------------------------------------------------------------------------*/
3597 }
3600 }
3601 }
3606 m);
3607 /*---------------------------------------------------------------------------*/
3624 }
3625 else
3628 }
3631 }
3633 }
3638 m);
3639 /*---------------------------------------------------------------------------*/
3641 VIDEO_ISOC_BUFFER_MANY,
3647 VIDEO_ISOC_ORDER);
3660 }
3663 /*---------------------------------------------------------------------------*/
3664 /*
3665 * ALLOCATE AND INITIALIZE MULTIPLE struct urb ...
3666 */
3667 /*---------------------------------------------------------------------------*/
3678 GFP_KERNEL);
3685 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
3699 /*---------------------------------------------------------------------------*/
3700 /*
3701 * ... AND INITIALIZE THEM
3702 */
3703 /*---------------------------------------------------------------------------*/
3729 }
3748 }
3749 }
3751 /*--------------------------------------------------------------------------*/
3752 /*
3753 * SAVE POINTER peasycap IN THIS INTERFACE.
3754 */
3755 /*--------------------------------------------------------------------------*/
3757 /*---------------------------------------------------------------------------*/
3758 /*
3759 * IT IS ESSENTIAL TO INITIALIZE THE HARDWARE BEFORE, RATHER THAN AFTER,
3760 * THE DEVICE IS REGISTERED, BECAUSE SOME VERSIONS OF THE videodev MODULE
3761 * CALL easycap_open() IMMEDIATELY AFTER REGISTRATION, CAUSING A CLASH.
3762 * BEWARE.
3763 */
3764 /*---------------------------------------------------------------------------*/
3772 }
3773 /*--------------------------------------------------------------------------*/
3774 /*
3775 * THE VIDEO DEVICE CAN BE REGISTERED NOW, AS IT IS READY.
3776 */
3777 /*--------------------------------------------------------------------------*/
3785 }
3786 /*---------------------------------------------------------------------------*/
3787 /*
3788 * FIXME
3789 *
3790 *
3791 * THIS IS BELIEVED TO BE HARMLESS, BUT MAY WELL BE UNNECESSARY OR WRONG:
3792 */
3793 /*---------------------------------------------------------------------------*/
3795 /*---------------------------------------------------------------------------*/
3815 }
3816 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
3819 }
3820 /*--------------------------------------------------------------------------*/
3821 /*
3822 * INTERFACE 1 IS THE AUDIO CONTROL INTERFACE
3823 * INTERFACE 2 IS THE AUDIO STREAMING INTERFACE
3824 */
3825 /*--------------------------------------------------------------------------*/
3830 }
3831 /*--------------------------------------------------------------------------*/
3832 /*
3833 * SAVE POINTER peasycap IN INTERFACE 1
3834 */
3835 /*--------------------------------------------------------------------------*/
3840 }
3841 /*--------------------------------------------------------------------------*/
3846 }
3854 }
3865 }
3871 PAGES_PER_AUDIO_FRAGMENT;
3877 PAGES_PER_AUDIO_FRAGMENT;
3883 }
3905 }
3915 AUDIO_ISOC_BUFFER_SIZE);
3917 }
3921 }
3925 }
3929 }
3933 }
3937 }
3941 }
3942 /*---------------------------------------------------------------------------*/
3943 /*
3944 * ALLOCATE MEMORY FOR AUDIO BUFFERS. LISTS MUST BE INITIALIZED FIRST.
3945 */
3946 /*---------------------------------------------------------------------------*/
3950 #ifdef CONFIG_EASYCAP_OSS
3968 }
3970 }
3976 /*---------------------------------------------------------------------------*/
3978 AUDIO_ISOC_BUFFER_MANY,
3984 AUDIO_ISOC_ORDER);
3997 }
3999 /*---------------------------------------------------------------------------*/
4000 /*
4001 * ALLOCATE AND INITIALIZE MULTIPLE struct urb ...
4002 */
4003 /*---------------------------------------------------------------------------*/
4014 GFP_KERNEL);
4019 }
4021 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
4026 }
4035 /*---------------------------------------------------------------------------*/
4036 /*
4037 * ... AND INITIALIZE THEM
4038 */
4039 /*---------------------------------------------------------------------------*/
4052 #ifdef CONFIG_EASYCAP_OSS
4069 }
4079 #ifdef CONFIG_EASYCAP_OSS
4092 }
4093 }
4095 /*---------------------------------------------------------------------------*/
4096 /*
4097 * SAVE POINTER peasycap IN THIS INTERFACE.
4098 */
4099 /*---------------------------------------------------------------------------*/
4101 /*---------------------------------------------------------------------------*/
4102 /*
4103 * THE AUDIO DEVICE CAN BE REGISTERED NOW, AS IT IS READY.
4104 */
4105 /*---------------------------------------------------------------------------*/
4106 #ifndef CONFIG_EASYCAP_OSS
4113 }
4121 }
4130 }
4131 /*---------------------------------------------------------------------------*/
4132 /*
4133 * INTERFACES OTHER THAN 0, 1 AND 2 ARE UNEXPECTED
4134 */
4135 /*---------------------------------------------------------------------------*/
4139 }
4142 }
4143 /*****************************************************************************/
4144 /*---------------------------------------------------------------------------*/
4145 /*
4146 * WHEN THIS FUNCTION IS CALLED THE EasyCAP HAS ALREADY BEEN PHYSICALLY
4147 * UNPLUGGED. HENCE peasycap->pusb_device IS NO LONGER VALID.
4148 *
4149 * THIS FUNCTION AFFECTS BOTH OSS AND ALSA. BEWARE.
4150 */
4151 /*---------------------------------------------------------------------------*/
4153 {
4156 u8 bInterfaceNumber;
4170 }
4175 }
4187 }
4188 /*---------------------------------------------------------------------------*/
4189 /*
4190 * SOME VERSIONS OF THE videodev MODULE OVERWRITE THE DATA WHICH HAS
4191 * BEEN WRITTEN BY THE CALL TO usb_set_intfdata() IN easycap_usb_probe(),
4192 * REPLACING IT WITH A POINTER TO THE EMBEDDED v4l2_device STRUCTURE.
4193 * TO DETECT THIS, THE STRING IN THE easycap.telltale[] BUFFER IS CHECKED.
4194 */
4195 /*---------------------------------------------------------------------------*/
4201 }
4204 }
4205 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
4206 /*---------------------------------------------------------------------------*/
4210 }
4211 /*---------------------------------------------------------------------------*/
4212 /*
4213 * IF THE WAIT QUEUES ARE NOT CLEARED A DEADLOCK IS POSSIBLE. BEWARE.
4214 */
4215 /*---------------------------------------------------------------------------*/
4220 /*---------------------------------------------------------------------------*/
4232 m++;
4233 }
4234 }
4235 }
4237 }
4239 }
4240 /*---------------------------------------------------------------------------*/
4251 m++;
4252 }
4253 }
4254 }
4256 }
4258 }
4261 }
4262 /*--------------------------------------------------------------------------*/
4263 /*
4264 * DEREGISTER
4265 *
4266 * THIS PROCEDURE WILL BLOCK UNTIL easycap_poll(), VIDEO IOCTL AND AUDIO
4267 * IOCTL ARE ALL UNLOCKED. IF THIS IS NOT DONE AN Oops CAN OCCUR WHEN
4268 * AN EasyCAP IS UNPLUGGED WHILE THE URBS ARE RUNNING. BEWARE.
4269 */
4270 /*--------------------------------------------------------------------------*/
4278 mutex_video)) {
4282 }
4286 }
4287 /*---------------------------------------------------------------------------*/
4293 }
4303 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
4308 }
4310 }
4316 mutex_audio)) {
4320 }
4324 #ifndef CONFIG_EASYCAP_OSS
4330 }
4340 }
4342 }
4345 }
4346 /*---------------------------------------------------------------------------*/
4347 /*
4348 * CALL easycap_delete() IF NO REMAINING REFERENCES TO peasycap
4349 * (ALSO WHEN ALSA HAS BEEN IN USE)
4350 */
4351 /*---------------------------------------------------------------------------*/
4357 }
4364 }
4373 }
4375 }
4385 }
4386 /*---------------------------------------------------------------------------*/
4389 }
4390 /*****************************************************************************/
4392 /*---------------------------------------------------------------------------*/
4393 /*
4394 * PARAMETERS APPLICABLE TO ENTIRE DRIVER, I.E. BOTH VIDEO AND AUDIO
4395 */
4396 /*---------------------------------------------------------------------------*/
4399 { }
4400 };
4408 };
4411 {
4424 }
4430 }
4431 /*****************************************************************************/
4433 {
4435 }
4436 /*****************************************************************************/
4441 /*****************************************************************************/