| blob | bea281624c41a3889ac50954d12b9ff611a127b5 |
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 }
166 }
175 else
178 }
184 }
186 }
188 /*****************************************************************************/
189 /*---------------------------------------------------------------------------*/
190 /*
191 * RESET THE HARDWARE TO ITS REFERENCE STATE.
192 *
193 * THIS ROUTINE MAY BE CALLED REPEATEDLY IF easycap_complete() DETECTS
194 * A BAD VIDEO FRAME SIZE.
195 */
196 /*---------------------------------------------------------------------------*/
198 {
207 }
210 /*---------------------------------------------------------------------------*/
211 /*
212 * IF THE SAA7113H HAS ALREADY ACQUIRED SYNC, USE ITS HARDWARE-DETECTED
213 * FIELD FREQUENCY TO DISTINGUISH NTSC FROM PAL. THIS IS ESSENTIAL FOR
214 * gstreamer AND OTHER USERSPACE PROGRAMS WHICH MAY NOT ATTEMPT TO INITIATE
215 * A SWITCH BETWEEN PAL AND NTSC.
216 *
217 * FUNCTION ready_saa() MAY REQUIRE A SUBSTANTIAL FRACTION OF A SECOND TO
218 * COMPLETE, SO SHOULD NOT BE INVOKED WITHOUT GOOD REASON.
219 */
220 /*---------------------------------------------------------------------------*/
233 }
238 }
250 }
254 }
256 /*---------------------------------------------------------------------------*/
262 }
267 }
274 /*---------------------------------------------------------------------------*/
275 /*
276 * RESTORE INPUT AND FORCE REFRESH OF STANDARD, FORMAT, ETC.
277 *
278 * WHILE THIS PROCEDURE IS IN PROGRESS, SOME IOCTL COMMANDS WILL RETURN -EBUSY.
279 */
280 /*---------------------------------------------------------------------------*/
291 }
292 peasycap_standard++;
293 }
297 }
300 }
312 }
320 }
325 }
330 }
335 }
339 }
344 }
348 }
350 }
351 /*****************************************************************************/
352 /*---------------------------------------------------------------------------*/
353 /*
354 * IF THE REQUESTED INPUT IS THE SAME AS THE EXISTING INPUT, DO NOTHING.
355 * OTHERWISE:
356 * KILL URBS, CLEAR FIELD AND FRAME BUFFERS AND RESET THEIR
357 * _read AND _fill POINTERS.
358 * SELECT THE NEW INPUT.
359 * ADJUST THE STANDARD, FORMAT, BRIGHTNESS, CONTRAST, SATURATION AND HUE
360 * ON THE BASIS OF INFORMATION IN STRUCTURE easycap.inputset[input].
361 * RESUBMIT THE URBS IF STREAMING WAS ALREADY IN PROGRESS.
362 *
363 * NOTE:
364 * THIS ROUTINE MAY BE CALLED FREQUENTLY BY ZONEMINDER VIA IOCTL,
365 * SO IT SHOULD WRITE ONLY SPARINGLY TO THE LOGFILE.
366 */
367 /*---------------------------------------------------------------------------*/
368 int
370 {
378 }
386 /*---------------------------------------------------------------------------*/
387 /*
388 * IF STREAMING IS IN PROGRESS THE URBS ARE KILLED AT THIS
389 * STAGE AND WILL BE RESUBMITTED PRIOR TO EXIT FROM THE ROUTINE.
390 * IF NO STREAMING IS IN PROGRESS NO URBS WILL BE SUBMITTED BY THE
391 * ROUTINE.
392 */
393 /*---------------------------------------------------------------------------*/
404 }
405 /*---------------------------------------------------------------------------*/
409 }
416 }
421 }
425 }
429 }
440 }
443 /*---------------------------------------------------------------------------*/
452 }
458 }
469 }
475 }
482 }
485 }
492 }
494 }
501 }
504 }
511 }
513 }
517 }
518 /*---------------------------------------------------------------------------*/
522 }
529 }
534 }
544 }
545 /*****************************************************************************/
547 {
557 }
562 }
566 }
597 }
601 isbad++;
606 nospc++;
608 m++;
609 }
611 isbad++;
612 }
613 }
618 }
629 }
630 }
635 }
638 }
640 }
641 /*****************************************************************************/
643 {
651 }
656 }
660 }
669 m++;
670 }
671 }
675 }
676 /****************************************************************************/
677 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
678 /*--------------------------------------------------------------------------*/
680 {
682 }
685 {
693 }
697 }
700 }
701 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
702 /*****************************************************************************/
703 /*--------------------------------------------------------------------------*/
704 /*
705 * THIS FUNCTION IS CALLED FROM WITHIN easycap_usb_disconnect() AND IS
706 * PROTECTED BY SEMAPHORES SET AND CLEARED BY easycap_usb_disconnect().
707 *
708 * BY THIS STAGE THE DEVICE HAS ALREADY BEEN PHYSICALLY UNPLUGGED, SO
709 * peasycap->pusb_device IS NO LONGER VALID.
710 */
711 /*---------------------------------------------------------------------------*/
713 {
730 }
732 /*---------------------------------------------------------------------------*/
733 /*
734 * FREE VIDEO.
735 */
736 /*---------------------------------------------------------------------------*/
750 m++;
751 }
752 }
753 }
756 /*---------------------------------------------------------------------------*/
768 m++;
769 }
770 }
774 }
775 /*---------------------------------------------------------------------------*/
782 VIDEO_ISOC_ORDER);
786 m++;
787 }
788 }
791 /*---------------------------------------------------------------------------*/
801 gone++;
802 }
803 }
804 }
806 /*---------------------------------------------------------------------------*/
816 gone++;
817 }
818 }
819 }
821 /*---------------------------------------------------------------------------*/
822 /*
823 * FREE AUDIO.
824 */
825 /*---------------------------------------------------------------------------*/
839 m++;
840 }
841 }
842 }
844 /*---------------------------------------------------------------------------*/
856 m++;
857 }
858 }
862 }
863 /*---------------------------------------------------------------------------*/
870 AUDIO_ISOC_ORDER);
874 m++;
875 }
876 }
879 /*---------------------------------------------------------------------------*/
900 }
903 }
907 /*---------------------------------------------------------------------------*/
919 }
920 /*****************************************************************************/
922 {
933 }
938 }
942 }
943 /*---------------------------------------------------------------------------*/
949 }
951 /*
952 * MEANWHILE, easycap_usb_disconnect() MAY HAVE FREED POINTER
953 * peasycap, IN WHICH CASE A REPEAT CALL TO isdongle() WILL FAIL.
954 * IF NECESSARY, BAIL OUT.
955 */
962 }
968 }
973 }
975 /*
976 * IF easycap_usb_disconnect() HAS ALREADY FREED POINTER peasycap
977 * BEFORE THE ATTEMPT TO ACQUIRE THE SEMAPHORE, isdongle() WILL
978 * HAVE FAILED. BAIL OUT.
979 */
981 /*---------------------------------------------------------------------------*/
987 else
989 }
990 /*****************************************************************************/
991 /*---------------------------------------------------------------------------*/
992 /*
993 * IF mode IS NONZERO THIS ROUTINE RETURNS -EAGAIN RATHER THAN BLOCKING.
994 */
995 /*---------------------------------------------------------------------------*/
997 {
1004 }
1008 }
1011 /*---------------------------------------------------------------------------*/
1012 /*
1013 * CHECK FOR LOST INPUT SIGNAL.
1014 *
1015 * FOR THE FOUR-CVBS EasyCAP, THIS DOES NOT WORK AS EXPECTED.
1016 * IF INPUT 0 IS PRESENT AND SYNC ACQUIRED, UNPLUGGING INPUT 4 DOES NOT
1017 * RESULT IN SETTING BIT 0x40 ON REGISTER 0x1F, PRESUMABLY BECAUSE THERE
1018 * IS FLYWHEELING ON INPUT 0. THE UPSHOT IS:
1019 *
1020 * INPUT 0 PLUGGED, INPUT 4 PLUGGED => SCREEN 0 OK, SCREEN 4 OK
1021 * INPUT 0 PLUGGED, INPUT 4 UNPLUGGED => SCREEN 0 OK, SCREEN 4 BLACK
1022 * INPUT 0 UNPLUGGED, INPUT 4 PLUGGED => SCREEN 0 BARS, SCREEN 4 OK
1023 * INPUT 0 UNPLUGGED, INPUT 4 UNPLUGGED => SCREEN 0 BARS, SCREEN 4 BARS
1024 */
1025 /*---------------------------------------------------------------------------*/
1032 else
1039 }
1040 }
1041 /*---------------------------------------------------------------------------*/
1042 /*
1043 * WAIT FOR FIELD ifield (0 => TOP, 1 => BOTTOM)
1044 */
1045 /*---------------------------------------------------------------------------*/
1065 }
1070 }
1073 #if defined(PERSEVERE)
1084 }
1088 }
1095 }
1096 miss++;
1097 }
1103 /*---------------------------------------------------------------------------*/
1104 /*
1105 * WAIT FOR THE OTHER FIELD
1106 */
1107 /*---------------------------------------------------------------------------*/
1110 else
1128 }
1133 }
1136 #if defined(PERSEVERE)
1147 }
1151 }
1158 }
1159 miss++;
1160 }
1166 /*---------------------------------------------------------------------------*/
1167 /*
1168 * WASTE THIS FRAME
1169 */
1170 /*---------------------------------------------------------------------------*/
1175 else
1177 }
1178 /*---------------------------------------------------------------------------*/
1189 V4L2_FIELD_TOP;
1190 else
1192 V4L2_FIELD_BOTTOM;
1199 }
1200 /*****************************************************************************/
1201 /*---------------------------------------------------------------------------*/
1202 /*
1203 * BY DEFINITION, odd IS true FOR THE FIELD OCCUPYING LINES 1,3,5,...,479
1204 * odd IS false FOR THE FIELD OCCUPYING LINES 0,2,4,...,478
1205 *
1206 * WHEN BOOLEAN PARAMETER decimatepixel IS true, ONLY THE FIELD FOR WHICH
1207 * odd==false IS TRANSFERRED TO THE FRAME BUFFER.
1208 *
1209 * THE BOOLEAN PARAMETER offerfields IS true ONLY WHEN THE USER PROGRAM
1210 * CHOOSES THE OPTION V4L2_FIELD_INTERLACED.
1211 */
1212 /*---------------------------------------------------------------------------*/
1213 int
1215 {
1218 u32 remainder;
1232 }
1246 /*---------------------------------------------------------------------------*/
1247 /*
1248 * REJECT OR CLEAN BAD FIELDS
1249 */
1250 /*---------------------------------------------------------------------------*/
1255 }
1256 #ifdef EASYCAP_TESTCARD
1258 #else
1262 }
1264 /*---------------------------------------------------------------------------*/
1275 }
1278 else
1297 }
1303 /*
1304 * PROCESS ONE LINE OF FRAME AT FULL RESOLUTION:
1305 * READ w2 BYTES FROM FIELD BUFFER,
1306 * WRITE w3 BYTES TO FRAME BUFFER
1307 */
1320 }
1324 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1327 /*
1328 * INJUDICIOUS ALTERATION OF
1329 * THIS STATEMENT BLOCK WILL
1330 * CAUSE BREAKAGE. BEWARE.
1331 */
1336 }
1343 else
1345 }
1348 bytesperpixel);
1350 }
1352 caches++;
1355 "[%i][%i].input, "
1357 peasycap->field_buffer
1360 }
1366 }
1373 mex++;
1378 }
1382 mad++;
1388 }
1389 }
1391 /*---------------------------------------------------------------------------*/
1392 /*
1393 * SKIP w3 BYTES IN TARGET FRAME BUFFER,
1394 * UNLESS IT IS THE LAST LINE OF AN ODD FRAME
1395 */
1396 /*---------------------------------------------------------------------------*/
1401 mad++;
1405 }
1413 }
1414 /*---------------------------------------------------------------------------*/
1415 /*
1416 * PROCESS ONE LINE OF FRAME AT REDUCED RESOLUTION:
1417 * ONLY IF false==odd,
1418 * READ w2 BYTES FROM FIELD BUFFER,
1419 * WRITE w3 / 2 BYTES TO FRAME BUFFER
1420 */
1421 /*---------------------------------------------------------------------------*/
1433 }
1436 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1439 /*
1440 * INJUDICIOUS ALTERATION OF
1441 * THIS STATEMENT BLOCK
1442 * WILL CAUSE BREAKAGE.
1443 * BEWARE.
1444 */
1449 }
1456 else
1458 }
1459 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1462 bytesperpixel);
1464 }
1465 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1467 caches++;
1471 "[%i][%i].input, "
1473 peasycap->field_buffer
1476 }
1482 }
1486 mex++;
1492 }
1496 mad++;
1502 }
1503 }
1505 /*---------------------------------------------------------------------------*/
1506 /*
1507 * OTHERWISE JUST
1508 * READ w2 BYTES FROM FIELD BUFFER AND DISCARD THEM
1509 */
1510 /*---------------------------------------------------------------------------*/
1515 mex++;
1521 "[%i][%i].input, "
1523 peasycap->field_buffer
1527 }
1528 }
1537 }
1538 }
1539 /*---------------------------------------------------------------------------*/
1540 /*
1541 * SANITY CHECKS
1542 */
1543 /*---------------------------------------------------------------------------*/
1563 }
1564 }
1577 /*---------------------------------------------------------------------------*/
1578 /*
1579 * CALCULATE VIDEO STREAMING RATE
1580 */
1581 /*---------------------------------------------------------------------------*/
1596 }
1602 }
1603 /*****************************************************************************/
1604 struct signed_div_result
1606 {
1619 }
1621 }
1622 /*****************************************************************************/
1623 /*---------------------------------------------------------------------------*/
1624 /*
1625 * DECIMATION AND COLOURSPACE CONVERSION.
1626 *
1627 * THIS ROUTINE REQUIRES THAT ALL THE DATA TO BE READ RESIDES ON ONE PAGE
1628 * AND THAT ALL THE DATA TO BE WRITTEN RESIDES ON ONE (DIFFERENT) PAGE.
1629 * THE CALLING ROUTINE MUST ENSURE THAT THIS REQUIREMENT IS MET, AND MUST
1630 * ALSO ENSURE THAT much IS EVEN.
1631 *
1632 * much BYTES ARE READ, AT LEAST (bytesperpixel * much)/2 BYTES ARE WRITTEN
1633 * IF THERE IS NO DECIMATION, HALF THIS AMOUNT IF THERE IS DECIMATION.
1634 *
1635 * mask IS ZERO WHEN NO SPECIAL BEHAVIOUR REQUIRED. OTHERWISE IT IS SET THUS:
1636 * 0x03 & mask = number of bytes to be written to cache instead of to
1637 * frame buffer
1638 * 0x04 & mask => use argument margin to set the chrominance for last pixel
1639 * 0x08 & mask => do not set the chrominance for last pixel
1640 *
1641 * YUV to RGB CONVERSION IS (OR SHOULD BE) ITU-R BT 601.
1642 *
1643 * THERE IS A LOT OF CODE REPETITION IN THIS ROUTINE IN ORDER TO AVOID
1644 * INEFFICIENT SWITCHING INSIDE INNER LOOPS. REARRANGING THE LOGIC TO
1645 * REDUCE CODE LENGTH WILL GENERALLY IMPAIR RUNTIME PERFORMANCE. BEWARE.
1646 */
1647 /*---------------------------------------------------------------------------*/
1648 int
1651 {
1658 s32 tmp;
1663 }
1668 /*---------------------------------------------------------------------------*/
1679 }
1683 }
1687 }
1695 }
1699 /*---------------------------------------------------------------------------*/
1700 /*
1701 * TRANSFER CONTENTS OF CACHE TO THE FRAME BUFFER
1702 */
1703 /*---------------------------------------------------------------------------*/
1707 }
1715 }
1720 }
1721 /*---------------------------------------------------------------------------*/
1725 p2++;
1729 else
1735 /*---------------------------------------------------------------------------*/
1741 /* UYVY */
1744 /* YUYV */
1751 }
1753 }
1756 /* UYVY DECIMATED */
1764 }
1767 /* YUYV DECIMATED */
1775 }
1777 }
1778 }
1780 }
1782 {
1785 /* RGB */
1789 else
1796 else
1800 ;
1804 else
1806 }
1826 }
1832 }
1837 }
1838 }
1843 }
1847 else
1850 }
1853 /* BGR */
1857 else
1864 else
1866 }
1867 else
1869 ;
1873 else
1875 }
1895 }
1901 }
1906 }
1907 }
1912 }
1916 else
1919 }
1920 }
1924 /* RGB DECIMATED */
1928 else
1935 else
1939 ;
1943 else
1945 }
1967 }
1973 }
1979 }
1980 }
1985 }
1990 }
1992 }
1995 /* BGR DECIMATED */
1999 else
2006 else
2010 ;
2014 else
2016 }
2039 }
2045 }
2051 }
2052 }
2057 }
2060 }
2061 else
2064 }
2066 }
2067 }
2069 }
2071 {
2074 /* RGBA */
2078 else
2085 else
2089 ;
2093 else
2095 }
2116 }
2123 }
2130 }
2135 }
2136 }
2142 }
2146 else
2149 }
2152 /*
2153 * BGRA
2154 */
2158 else
2165 else
2169 ;
2173 else
2175 }
2196 }
2203 }
2210 }
2215 }
2221 }
2225 else
2228 }
2229 }
2233 /*
2234 * RGBA DECIMATED
2235 */
2239 else
2246 else
2250 ;
2254 else
2256 }
2280 }
2287 }
2294 }
2298 bytesperpixel -
2299 rump);
2301 }
2302 }
2308 }
2314 }
2317 /*
2318 * BGRA DECIMATED
2319 */
2323 else
2330 else
2334 ;
2338 else
2340 }
2363 }
2370 }
2377 }
2383 }
2384 }
2390 }
2396 }
2398 }
2399 }
2401 }
2405 }
2406 }
2408 }
2409 /*****************************************************************************/
2410 /*
2411 * SEE CORBET ET AL. "LINUX DEVICE DRIVERS", 3rd EDITION, PAGES 430-434
2412 */
2413 /*****************************************************************************/
2415 {
2422 }
2426 }
2427 /*****************************************************************************/
2429 {
2436 }
2440 }
2441 /*****************************************************************************/
2443 {
2454 }
2458 }
2465 else
2471 }
2475 }
2480 }
2481 /*---------------------------------------------------------------------------*/
2486 }
2491 }
2493 /*---------------------------------------------------------------------------*/
2499 }
2501 }
2507 };
2510 {
2519 }
2520 /*****************************************************************************/
2521 /*---------------------------------------------------------------------------*/
2522 /*
2523 * ON COMPLETION OF A VIDEO URB ITS DATA IS COPIED TO THE FIELD BUFFERS
2524 * PROVIDED peasycap->video_idle IS ZERO. REGARDLESS OF THIS BEING TRUE,
2525 * IT IS RESUBMITTED PROVIDED peasycap->video_isoc_streaming IS NOT ZERO.
2526 *
2527 * THIS FUNCTION IS AN INTERRUPT SERVICE ROUTINE AND MUST NOT SLEEP.
2528 *
2529 * INFORMATION ABOUT THE VALIDITY OF THE CONTENTS OF THE FIELD BUFFER ARE
2530 * STORED IN THE TWO-BYTE STATUS PARAMETER
2531 * peasycap->field_buffer[peasycap->field_fill][0].kount
2532 * NOTICE THAT THE INFORMATION IS STORED ONLY WITH PAGE 0 OF THE FIELD BUFFER.
2533 *
2534 * THE LOWER BYTE CONTAINS THE FIELD PARITY BYTE FURNISHED BY THE SAA7113H
2535 * CHIP.
2536 *
2537 * THE UPPER BYTE IS ZERO IF NO PROBLEMS, OTHERWISE:
2538 * 0 != (kount & 0x8000) => AT LEAST ONE URB COMPLETED WITH ERRORS
2539 * 0 != (kount & 0x4000) => BUFFER HAS TOO MUCH DATA
2540 * 0 != (kount & 0x2000) => BUFFER HAS NOT ENOUGH DATA
2541 * 0 != (kount & 0x1000) => BUFFER HAS DATA FROM DISPARATE INPUTS
2542 * 0 != (kount & 0x0400) => RESERVED
2543 * 0 != (kount & 0x0200) => FIELD BUFFER NOT YET CHECKED
2544 * 0 != (kount & 0x0100) => BUFFER HAS TWO EXTRA BYTES - WHY?
2545 */
2546 /*---------------------------------------------------------------------------*/
2548 {
2561 }
2566 }
2578 }
2590 "usb_submit_urb() "
2593 }
2594 }
2596 }
2598 /*---------------------------------------------------------------------------*/
2602 }
2607 }
2612 /*---------------------------------------------------------------------------*/
2618 /* FIXME: 1. missing '-' check boundaries */
2621 }
2628 "%4i=status "
2629 "%4i=actual "
2630 "%4i=length "
2638 PAGE_SIZE) +
2647 }
2651 }
2656 }
2663 else
2665 /*--------------------------------------------------------------------------*/
2666 /*
2667 * EIGHT-BYTE END-OF-VIDEOFIELD MARKER.
2668 * NOTE: A SUCCESSION OF URB FRAMES FOLLOWING THIS ARE EMPTY,
2669 * CORRESPONDING TO THE FIELD FLYBACK (VERTICAL BLANKING) PERIOD.
2670 *
2671 * PROVIDED THE FIELD BUFFER CONTAINS GOOD DATA AS INDICATED BY A ZERO UPPER
2672 * BYTE OF
2673 * peasycap->field_buffer[peasycap->field_fill][0].kount
2674 * THE CONTENTS OF THE FIELD BUFFER ARE OFFERED TO dqbuf(), field_read IS
2675 * UPDATED AND field_fill IS BUMPED. IF THE FIELD BUFFER CONTAINS BAD DATA
2676 * NOTHING IS OFFERED TO dqbuf().
2677 *
2678 * THE DECISION ON WHETHER THE PARITY OF THE OFFERED FIELD BUFFER IS RIGHT
2679 * RESTS WITH dqbuf().
2680 */
2681 /*---------------------------------------------------------------------------*/
2686 peasycap->
2687 videofieldamount) {
2692 VIDEO_JUNK_TOLERATE);
2698 peasycap->
2699 videofieldamount) {
2703 }
2715 field_fill)++;
2717 peasycap->
2718 field_fill)
2719 peasycap->
2723 field_buffer
2725 field_fill]
2727 field_page];
2731 "peasycap->"
2732 "field_fill %i="
2738 "%i bytes fit to be "
2741 videofieldamount);
2743 "wq_video, "
2744 "%i=field_read "
2745 "%i=field_fill "
2750 field_buffer
2753 wake_up_interruptible
2755 wq_video));
2756 do_gettimeofday
2764 "bytes, now discarded: "
2767 videofieldamount,
2769 peasycap->field_buffer
2771 kount));
2778 pfield_buffer =
2789 }
2796 else
2802 }
2803 }
2804 /*---------------------------------------------------------------------------*/
2805 /*
2806 * COPY more BYTES FROM ISOC BUFFER TO FIELD BUFFER
2807 */
2808 /*---------------------------------------------------------------------------*/
2815 }
2819 }
2830 }
2839 }
2841 field_buffer
2849 input !=
2854 }
2866 }
2867 }
2868 }
2869 }
2870 }
2871 /*---------------------------------------------------------------------------*/
2872 /*
2873 * RESUBMIT THIS URB, UNLESS A SEVERE PERSISTENT ERROR CONDITION EXISTS.
2874 *
2875 * IF THE WAIT QUEUES ARE NOT CLEARED IN RESPONSE TO AN ERROR CONDITION
2876 * THE USERSPACE PROGRAM, E.G. mplayer, MAY HANG ON EXIT. BEWARE.
2877 */
2878 /*---------------------------------------------------------------------------*/
2885 #if !defined(PERSEVERE)
2890 }
2897 "usb_submit_urb() "
2900 }
2901 }
2903 }
2911 };
2916 };
2917 /*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
2924 };
2925 /*****************************************************************************/
2926 /*---------------------------------------------------------------------------*/
2927 /*
2928 * WHEN THE EasyCAP IS PHYSICALLY PLUGGED IN, THIS FUNCTION IS CALLED THREE
2929 * TIMES, ONCE FOR EACH OF THE THREE INTERFACES. BEWARE.
2930 */
2931 /*---------------------------------------------------------------------------*/
2934 {
2944 u8 bInterfaceNumber;
2945 u8 bInterfaceClass;
2946 u8 bInterfaceSubClass;
2952 u16 mask;
2953 s32 value;
2960 /*---------------------------------------------------------------------------*/
2965 }
2970 }
2971 /*---------------------------------------------------------------------------*/
2972 /*
2973 * GET PROPERTIES OF PROBED INTERFACE
2974 */
2975 /*---------------------------------------------------------------------------*/
2983 bInterfaceNumber,
2987 /*---------------------------------------------------------------------------*/
2988 /*
2989 * A NEW struct easycap IS ALWAYS ALLOCATED WHEN INTERFACE 0 IS PROBED.
2990 * IT IS NOT POSSIBLE HERE TO FREE ANY EXISTING struct easycap. THIS
2991 * SHOULD HAVE BEEN DONE BY easycap_delete() WHEN THE EasyCAP WAS
2992 * PHYSICALLY UNPLUGGED.
2993 *
2994 * THE POINTER peasycap TO THE struct easycap IS REMEMBERED WHEN
2995 * INTERFACES 1 AND 2 ARE PROBED.
2996 */
2997 /*---------------------------------------------------------------------------*/
3003 }
3004 /*---------------------------------------------------------------------------*/
3005 /*
3006 * PERFORM URGENT INTIALIZATIONS ...
3007 */
3008 /*---------------------------------------------------------------------------*/
3015 /* module params */
3026 /*---------------------------------------------------------------------------*/
3027 /*
3028 * FOR INTERFACES 1 AND 2 THE POINTER peasycap WILL NEED TO
3029 * TO BE THE SAME AS THAT ALLOCATED NOW FOR INTERFACE 0.
3030 *
3031 * NORMALLY ndong WILL NOT HAVE CHANGED SINCE INTERFACE 0 WAS
3032 * PROBED, BUT THIS MAY NOT BE THE CASE IF, FOR EXAMPLE, TWO
3033 * EASYCAPs ARE PLUGGED IN SIMULTANEOUSLY.
3034 */
3035 /*---------------------------------------------------------------------------*/
3048 }
3049 }
3054 }
3056 }
3064 /*---------------------------------------------------------------------------*/
3065 /*
3066 * ... AND FURTHER INITIALIZE THE STRUCTURE
3067 */
3068 /*---------------------------------------------------------------------------*/
3096 /*---------------------------------------------------------------------------*/
3097 /*
3098 * DYNAMICALLY FILL IN THE AVAILABLE FORMATS ...
3099 */
3100 /*---------------------------------------------------------------------------*/
3105 }
3107 /*---------------------------------------------------------------------------*/
3108 /*
3109 * ... AND POPULATE easycap.inputset[]
3110 */
3111 /*---------------------------------------------------------------------------*/
3112 /* FIXME: maybe we just use memset 0 */
3122 }
3129 m++;
3134 }
3135 }
3141 }
3152 m++;
3156 }
3157 peasycap_format++;
3158 }
3162 }
3168 m++;
3172 m++;
3176 m++;
3180 m++;
3183 }
3184 }
3189 }
3195 /*---------------------------------------------------------------------------*/
3196 /*
3197 * FIXME
3198 *
3199 * IDENTIFY THE APPROPRIATE POINTER peasycap FOR INTERFACES 1 AND 2.
3200 * THE ADDRESS OF peasycap->pusb_device IS RELUCTANTLY USED FOR THIS PURPOSE.
3201 */
3202 /*---------------------------------------------------------------------------*/
3205 pusb_device) {
3210 }
3211 }
3214 bInterfaceNumber);
3216 }
3219 bInterfaceNumber);
3221 }
3222 }
3223 /*---------------------------------------------------------------------------*/
3237 }
3238 }
3252 }
3253 }
3254 }
3255 /*---------------------------------------------------------------------------*/
3256 /*
3257 * INVESTIGATE ALL ALTSETTINGS.
3258 * DONE IN DETAIL BECAUSE USB DEVICE 05e1:0408 HAS DISPARATE INCARNATIONS.
3259 */
3260 /*---------------------------------------------------------------------------*/
3268 }
3273 }
3278 /*---------------------------------------------------------------------------*/
3285 }
3289 bInterfaceNumber,
3294 }
3296 }
3306 isokalt);
3308 ep->
3309 bEndpointAddress &
3314 isokalt);
3317 wMaxPacketSize);
3321 isokalt);
3322 isokalt++;
3323 }
3326 video_altsetting_off) {
3327 peasycap->
3328 video_altsetting_off =
3329 i;
3331 "altsetting_off "
3333 peasycap->
3334 video_altsetting_off);
3337 "->video_altsetting_"
3340 "continuing with "
3341 "%i=peasycap->video_"
3343 peasycap->
3344 video_altsetting_off);
3345 }
3346 }
3348 }
3351 USB_SUBCLASS_AUDIOSTREAMING)
3357 }
3364 isokalt);
3366 ep->
3367 bEndpointAddress &
3372 isokalt);
3375 wMaxPacketSize);
3379 isokalt);
3380 isokalt++;
3381 }
3384 audio_altsetting_off) {
3385 peasycap->
3386 audio_altsetting_off =
3387 i;
3389 "altsetting_off "
3391 peasycap->
3392 audio_altsetting_off);
3395 "->audio_altsetting_"
3398 "continuing with "
3399 "%i=peasycap->"
3400 "audio_altsetting_"
3402 peasycap->
3403 audio_altsetting_off);
3404 }
3405 }
3407 }
3410 }
3415 }
3416 }
3417 }
3418 /*---------------------------------------------------------------------------*/
3419 /*
3420 * PERFORM INITIALIZATION OF THE PROBED INTERFACE
3421 */
3422 /*---------------------------------------------------------------------------*/
3426 /*---------------------------------------------------------------------------*/
3427 /*
3428 * INTERFACE 0 IS THE VIDEO INTERFACE
3429 */
3430 /*---------------------------------------------------------------------------*/
3435 }
3443 }
3444 /*---------------------------------------------------------------------------*/
3445 /*
3446 * DECIDE THE VIDEO STREAMING PARAMETERS
3447 */
3448 /*---------------------------------------------------------------------------*/
3459 }
3469 }
3479 }
3480 /*---------------------------------------------------------------------------*/
3484 }
3488 }
3492 }
3496 }
3500 }
3504 }
3505 /*---------------------------------------------------------------------------*/
3506 /*
3507 * ALLOCATE MEMORY FOR VIDEO BUFFERS. LISTS MUST BE INITIALIZED FIRST.
3508 */
3509 /*---------------------------------------------------------------------------*/
3512 /*---------------------------------------------------------------------------*/
3532 }
3535 }
3536 }
3541 m);
3542 /*---------------------------------------------------------------------------*/
3559 }
3560 else
3563 }
3566 }
3568 }
3573 m);
3574 /*---------------------------------------------------------------------------*/
3576 VIDEO_ISOC_BUFFER_MANY,
3582 VIDEO_ISOC_ORDER);
3595 }
3598 /*---------------------------------------------------------------------------*/
3599 /*
3600 * ALLOCATE AND INITIALIZE MULTIPLE struct urb ...
3601 */
3602 /*---------------------------------------------------------------------------*/
3613 GFP_KERNEL);
3620 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
3634 /*---------------------------------------------------------------------------*/
3635 /*
3636 * ... AND INITIALIZE THEM
3637 */
3638 /*---------------------------------------------------------------------------*/
3664 }
3683 }
3684 }
3686 /*--------------------------------------------------------------------------*/
3687 /*
3688 * SAVE POINTER peasycap IN THIS INTERFACE.
3689 */
3690 /*--------------------------------------------------------------------------*/
3692 /*---------------------------------------------------------------------------*/
3693 /*
3694 * IT IS ESSENTIAL TO INITIALIZE THE HARDWARE BEFORE, RATHER THAN AFTER,
3695 * THE DEVICE IS REGISTERED, BECAUSE SOME VERSIONS OF THE videodev MODULE
3696 * CALL easycap_open() IMMEDIATELY AFTER REGISTRATION, CAUSING A CLASH.
3697 * BEWARE.
3698 */
3699 /*---------------------------------------------------------------------------*/
3707 }
3708 /*--------------------------------------------------------------------------*/
3709 /*
3710 * THE VIDEO DEVICE CAN BE REGISTERED NOW, AS IT IS READY.
3711 */
3712 /*--------------------------------------------------------------------------*/
3716 }
3719 /*---------------------------------------------------------------------------*/
3720 /*
3721 * FIXME
3722 *
3723 *
3724 * THIS IS BELIEVED TO BE HARMLESS, BUT MAY WELL BE UNNECESSARY OR WRONG:
3725 */
3726 /*---------------------------------------------------------------------------*/
3728 /*---------------------------------------------------------------------------*/
3748 }
3749 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
3752 }
3753 /*--------------------------------------------------------------------------*/
3754 /*
3755 * INTERFACE 1 IS THE AUDIO CONTROL INTERFACE
3756 * INTERFACE 2 IS THE AUDIO STREAMING INTERFACE
3757 */
3758 /*--------------------------------------------------------------------------*/
3763 }
3764 /*--------------------------------------------------------------------------*/
3765 /*
3766 * SAVE POINTER peasycap IN INTERFACE 1
3767 */
3768 /*--------------------------------------------------------------------------*/
3773 }
3774 /*--------------------------------------------------------------------------*/
3779 }
3787 }
3798 }
3804 PAGES_PER_AUDIO_FRAGMENT;
3810 PAGES_PER_AUDIO_FRAGMENT;
3816 }
3838 }
3848 AUDIO_ISOC_BUFFER_SIZE);
3850 }
3854 }
3858 }
3862 }
3866 }
3870 }
3874 }
3875 /*---------------------------------------------------------------------------*/
3876 /*
3877 * ALLOCATE MEMORY FOR AUDIO BUFFERS. LISTS MUST BE INITIALIZED FIRST.
3878 */
3879 /*---------------------------------------------------------------------------*/
3883 /*---------------------------------------------------------------------------*/
3885 AUDIO_ISOC_BUFFER_MANY,
3891 AUDIO_ISOC_ORDER);
3904 }
3906 /*---------------------------------------------------------------------------*/
3907 /*
3908 * ALLOCATE AND INITIALIZE MULTIPLE struct urb ...
3909 */
3910 /*---------------------------------------------------------------------------*/
3921 GFP_KERNEL);
3926 }
3928 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
3933 }
3942 /*---------------------------------------------------------------------------*/
3943 /*
3944 * ... AND INITIALIZE THEM
3945 */
3946 /*---------------------------------------------------------------------------*/
3972 }
3991 }
3992 }
3994 /*---------------------------------------------------------------------------*/
3995 /*
3996 * SAVE POINTER peasycap IN THIS INTERFACE.
3997 */
3998 /*---------------------------------------------------------------------------*/
4000 /*---------------------------------------------------------------------------*/
4001 /*
4002 * THE AUDIO DEVICE CAN BE REGISTERED NOW, AS IT IS READY.
4003 */
4004 /*---------------------------------------------------------------------------*/
4011 }
4019 }
4020 /*---------------------------------------------------------------------------*/
4021 /*
4022 * INTERFACES OTHER THAN 0, 1 AND 2 ARE UNEXPECTED
4023 */
4024 /*---------------------------------------------------------------------------*/
4028 }
4031 }
4032 /*****************************************************************************/
4033 /*---------------------------------------------------------------------------*/
4034 /*
4035 * WHEN THIS FUNCTION IS CALLED THE EasyCAP HAS ALREADY BEEN PHYSICALLY
4036 * UNPLUGGED. HENCE peasycap->pusb_device IS NO LONGER VALID.
4037 *
4038 * THIS FUNCTION AFFECTS ALSA. BEWARE.
4039 */
4040 /*---------------------------------------------------------------------------*/
4042 {
4045 u8 bInterfaceNumber;
4058 }
4063 }
4075 }
4076 /*---------------------------------------------------------------------------*/
4077 /*
4078 * IF THE WAIT QUEUES ARE NOT CLEARED A DEADLOCK IS POSSIBLE. BEWARE.
4079 */
4080 /*---------------------------------------------------------------------------*/
4085 /*---------------------------------------------------------------------------*/
4097 m++;
4098 }
4099 }
4100 }
4102 }
4104 }
4105 /*---------------------------------------------------------------------------*/
4116 m++;
4117 }
4118 }
4119 }
4121 }
4123 }
4126 }
4127 /*--------------------------------------------------------------------------*/
4128 /*
4129 * DEREGISTER
4130 *
4131 * THIS PROCEDURE WILL BLOCK UNTIL easycap_poll(), VIDEO IOCTL AND AUDIO
4132 * IOCTL ARE ALL UNLOCKED. IF THIS IS NOT DONE AN Oops CAN OCCUR WHEN
4133 * AN EasyCAP IS UNPLUGGED WHILE THE URBS ARE RUNNING. BEWARE.
4134 */
4135 /*--------------------------------------------------------------------------*/
4143 mutex_video)) {
4147 }
4151 }
4152 /*---------------------------------------------------------------------------*/
4158 }
4168 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
4173 }
4175 }
4181 mutex_audio)) {
4185 }
4194 }
4198 }
4200 }
4203 }
4204 /*---------------------------------------------------------------------------*/
4205 /*
4206 * CALL easycap_delete() IF NO REMAINING REFERENCES TO peasycap
4207 * (ALSO WHEN ALSA HAS BEEN IN USE)
4208 */
4209 /*---------------------------------------------------------------------------*/
4215 }
4222 }
4231 }
4233 }
4243 }
4244 /*---------------------------------------------------------------------------*/
4247 }
4248 /*****************************************************************************/
4250 /*---------------------------------------------------------------------------*/
4251 /*
4252 * PARAMETERS APPLICABLE TO ENTIRE DRIVER, I.E. BOTH VIDEO AND AUDIO
4253 */
4254 /*---------------------------------------------------------------------------*/
4257 { }
4258 };
4266 };
4269 {
4282 }
4288 }
4289 /*****************************************************************************/
4291 {
4293 }
4294 /*****************************************************************************/
4299 /*****************************************************************************/