| blob | a45c0b5070678785196fa1c9e2fd04ed77f964dd |
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 }
273 /*---------------------------------------------------------------------------*/
274 /*
275 * RESTORE INPUT AND FORCE REFRESH OF STANDARD, FORMAT, ETC.
276 *
277 * WHILE THIS PROCEDURE IS IN PROGRESS, SOME IOCTL COMMANDS WILL RETURN -EBUSY.
278 */
279 /*---------------------------------------------------------------------------*/
290 }
291 peasycap_standard++;
292 }
296 }
299 }
311 }
319 }
324 }
329 }
334 }
338 }
343 }
347 }
349 }
350 /*****************************************************************************/
351 /*---------------------------------------------------------------------------*/
352 /*
353 * IF THE REQUESTED INPUT IS THE SAME AS THE EXISTING INPUT, DO NOTHING.
354 * OTHERWISE:
355 * KILL URBS, CLEAR FIELD AND FRAME BUFFERS AND RESET THEIR
356 * _read AND _fill POINTERS.
357 * SELECT THE NEW INPUT.
358 * ADJUST THE STANDARD, FORMAT, BRIGHTNESS, CONTRAST, SATURATION AND HUE
359 * ON THE BASIS OF INFORMATION IN STRUCTURE easycap.inputset[input].
360 * RESUBMIT THE URBS IF STREAMING WAS ALREADY IN PROGRESS.
361 *
362 * NOTE:
363 * THIS ROUTINE MAY BE CALLED FREQUENTLY BY ZONEMINDER VIA IOCTL,
364 * SO IT SHOULD WRITE ONLY SPARINGLY TO THE LOGFILE.
365 */
366 /*---------------------------------------------------------------------------*/
367 int
369 {
377 }
385 /*---------------------------------------------------------------------------*/
386 /*
387 * IF STREAMING IS IN PROGRESS THE URBS ARE KILLED AT THIS
388 * STAGE AND WILL BE RESUBMITTED PRIOR TO EXIT FROM THE ROUTINE.
389 * IF NO STREAMING IS IN PROGRESS NO URBS WILL BE SUBMITTED BY THE
390 * ROUTINE.
391 */
392 /*---------------------------------------------------------------------------*/
403 }
404 /*---------------------------------------------------------------------------*/
408 }
415 }
420 }
424 }
428 }
439 }
442 /*---------------------------------------------------------------------------*/
451 }
457 }
468 }
474 }
481 }
484 }
491 }
493 }
500 }
503 }
510 }
512 }
516 }
517 /*---------------------------------------------------------------------------*/
521 }
528 }
533 }
543 }
544 /*****************************************************************************/
546 {
556 }
561 }
565 }
596 }
600 isbad++;
605 nospc++;
607 m++;
608 }
610 isbad++;
611 }
612 }
617 }
628 }
629 }
634 }
637 }
639 }
640 /*****************************************************************************/
642 {
650 }
655 }
659 }
668 m++;
669 }
670 }
674 }
675 /****************************************************************************/
676 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
677 /*--------------------------------------------------------------------------*/
679 {
681 }
684 {
692 }
696 }
699 }
700 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
701 /*****************************************************************************/
702 /*--------------------------------------------------------------------------*/
703 /*
704 * THIS FUNCTION IS CALLED FROM WITHIN easycap_usb_disconnect() AND IS
705 * PROTECTED BY SEMAPHORES SET AND CLEARED BY easycap_usb_disconnect().
706 *
707 * BY THIS STAGE THE DEVICE HAS ALREADY BEEN PHYSICALLY UNPLUGGED, SO
708 * peasycap->pusb_device IS NO LONGER VALID.
709 */
710 /*---------------------------------------------------------------------------*/
712 {
729 }
731 /*---------------------------------------------------------------------------*/
732 /*
733 * FREE VIDEO.
734 */
735 /*---------------------------------------------------------------------------*/
749 m++;
750 }
751 }
752 }
755 /*---------------------------------------------------------------------------*/
767 m++;
768 }
769 }
773 }
774 /*---------------------------------------------------------------------------*/
781 VIDEO_ISOC_ORDER);
785 m++;
786 }
787 }
790 /*---------------------------------------------------------------------------*/
800 gone++;
801 }
802 }
803 }
805 /*---------------------------------------------------------------------------*/
815 gone++;
816 }
817 }
818 }
820 /*---------------------------------------------------------------------------*/
821 /*
822 * FREE AUDIO.
823 */
824 /*---------------------------------------------------------------------------*/
838 m++;
839 }
840 }
841 }
843 /*---------------------------------------------------------------------------*/
855 m++;
856 }
857 }
861 }
862 /*---------------------------------------------------------------------------*/
869 AUDIO_ISOC_ORDER);
873 m++;
874 }
875 }
878 /*---------------------------------------------------------------------------*/
899 }
902 }
906 /*---------------------------------------------------------------------------*/
918 }
919 /*****************************************************************************/
921 {
932 }
937 }
941 }
942 /*---------------------------------------------------------------------------*/
948 }
950 /*
951 * MEANWHILE, easycap_usb_disconnect() MAY HAVE FREED POINTER
952 * peasycap, IN WHICH CASE A REPEAT CALL TO isdongle() WILL FAIL.
953 * IF NECESSARY, BAIL OUT.
954 */
958 }
963 }
969 }
974 }
976 /*
977 * IF easycap_usb_disconnect() HAS ALREADY FREED POINTER peasycap
978 * BEFORE THE ATTEMPT TO ACQUIRE THE SEMAPHORE, isdongle() WILL
979 * HAVE FAILED. BAIL OUT.
980 */
982 /*---------------------------------------------------------------------------*/
988 else
990 }
991 /*****************************************************************************/
992 /*---------------------------------------------------------------------------*/
993 /*
994 * IF mode IS NONZERO THIS ROUTINE RETURNS -EAGAIN RATHER THAN BLOCKING.
995 */
996 /*---------------------------------------------------------------------------*/
998 {
1005 }
1009 }
1012 /*---------------------------------------------------------------------------*/
1013 /*
1014 * CHECK FOR LOST INPUT SIGNAL.
1015 *
1016 * FOR THE FOUR-CVBS EasyCAP, THIS DOES NOT WORK AS EXPECTED.
1017 * IF INPUT 0 IS PRESENT AND SYNC ACQUIRED, UNPLUGGING INPUT 4 DOES NOT
1018 * RESULT IN SETTING BIT 0x40 ON REGISTER 0x1F, PRESUMABLY BECAUSE THERE
1019 * IS FLYWHEELING ON INPUT 0. THE UPSHOT IS:
1020 *
1021 * INPUT 0 PLUGGED, INPUT 4 PLUGGED => SCREEN 0 OK, SCREEN 4 OK
1022 * INPUT 0 PLUGGED, INPUT 4 UNPLUGGED => SCREEN 0 OK, SCREEN 4 BLACK
1023 * INPUT 0 UNPLUGGED, INPUT 4 PLUGGED => SCREEN 0 BARS, SCREEN 4 OK
1024 * INPUT 0 UNPLUGGED, INPUT 4 UNPLUGGED => SCREEN 0 BARS, SCREEN 4 BARS
1025 */
1026 /*---------------------------------------------------------------------------*/
1033 else
1040 }
1041 }
1042 /*---------------------------------------------------------------------------*/
1043 /*
1044 * WAIT FOR FIELD ifield (0 => TOP, 1 => BOTTOM)
1045 */
1046 /*---------------------------------------------------------------------------*/
1066 }
1071 }
1074 #if defined(PERSEVERE)
1085 }
1089 }
1096 }
1097 miss++;
1098 }
1104 /*---------------------------------------------------------------------------*/
1105 /*
1106 * WAIT FOR THE OTHER FIELD
1107 */
1108 /*---------------------------------------------------------------------------*/
1111 else
1129 }
1134 }
1137 #if defined(PERSEVERE)
1148 }
1152 }
1159 }
1160 miss++;
1161 }
1167 /*---------------------------------------------------------------------------*/
1168 /*
1169 * WASTE THIS FRAME
1170 */
1171 /*---------------------------------------------------------------------------*/
1176 else
1178 }
1179 /*---------------------------------------------------------------------------*/
1190 V4L2_FIELD_TOP;
1191 else
1193 V4L2_FIELD_BOTTOM;
1200 }
1201 /*****************************************************************************/
1202 /*---------------------------------------------------------------------------*/
1203 /*
1204 * BY DEFINITION, odd IS true FOR THE FIELD OCCUPYING LINES 1,3,5,...,479
1205 * odd IS false FOR THE FIELD OCCUPYING LINES 0,2,4,...,478
1206 *
1207 * WHEN BOOLEAN PARAMETER decimatepixel IS true, ONLY THE FIELD FOR WHICH
1208 * odd==false IS TRANSFERRED TO THE FRAME BUFFER.
1209 *
1210 * THE BOOLEAN PARAMETER offerfields IS true ONLY WHEN THE USER PROGRAM
1211 * CHOOSES THE OPTION V4L2_FIELD_INTERLACED.
1212 */
1213 /*---------------------------------------------------------------------------*/
1214 int
1216 {
1229 }
1243 /*---------------------------------------------------------------------------*/
1244 /*
1245 * REJECT OR CLEAN BAD FIELDS
1246 */
1247 /*---------------------------------------------------------------------------*/
1252 }
1253 #ifdef EASYCAP_TESTCARD
1255 #else
1259 }
1261 /*---------------------------------------------------------------------------*/
1272 }
1275 else
1294 }
1300 /*
1301 * PROCESS ONE LINE OF FRAME AT FULL RESOLUTION:
1302 * READ w2 BYTES FROM FIELD BUFFER,
1303 * WRITE w3 BYTES TO FRAME BUFFER
1304 */
1317 }
1321 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1324 /*
1325 * INJUDICIOUS ALTERATION OF
1326 * THIS STATEMENT BLOCK WILL
1327 * CAUSE BREAKAGE. BEWARE.
1328 */
1333 }
1340 else
1342 }
1345 bytesperpixel);
1347 }
1349 caches++;
1352 "[%i][%i].input, "
1354 peasycap->field_buffer
1357 }
1363 }
1370 mex++;
1375 }
1379 mad++;
1385 }
1386 }
1388 /*---------------------------------------------------------------------------*/
1389 /*
1390 * SKIP w3 BYTES IN TARGET FRAME BUFFER,
1391 * UNLESS IT IS THE LAST LINE OF AN ODD FRAME
1392 */
1393 /*---------------------------------------------------------------------------*/
1398 mad++;
1402 }
1410 }
1411 /*---------------------------------------------------------------------------*/
1412 /*
1413 * PROCESS ONE LINE OF FRAME AT REDUCED RESOLUTION:
1414 * ONLY IF false==odd,
1415 * READ w2 BYTES FROM FIELD BUFFER,
1416 * WRITE w3 / 2 BYTES TO FRAME BUFFER
1417 */
1418 /*---------------------------------------------------------------------------*/
1430 }
1433 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1436 /*
1437 * INJUDICIOUS ALTERATION OF
1438 * THIS STATEMENT BLOCK
1439 * WILL CAUSE BREAKAGE.
1440 * BEWARE.
1441 */
1446 }
1453 else
1455 }
1456 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1459 bytesperpixel);
1461 }
1462 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
1464 caches++;
1468 "[%i][%i].input, "
1470 peasycap->field_buffer
1473 }
1479 }
1483 mex++;
1489 }
1493 mad++;
1499 }
1500 }
1502 /*---------------------------------------------------------------------------*/
1503 /*
1504 * OTHERWISE JUST
1505 * READ w2 BYTES FROM FIELD BUFFER AND DISCARD THEM
1506 */
1507 /*---------------------------------------------------------------------------*/
1512 mex++;
1518 "[%i][%i].input, "
1520 peasycap->field_buffer
1524 }
1525 }
1534 }
1535 }
1536 /*---------------------------------------------------------------------------*/
1537 /*
1538 * SANITY CHECKS
1539 */
1540 /*---------------------------------------------------------------------------*/
1560 }
1561 }
1578 }
1579 /*---------------------------------------------------------------------------*/
1580 /*
1581 * DECIMATION AND COLOURSPACE CONVERSION.
1582 *
1583 * THIS ROUTINE REQUIRES THAT ALL THE DATA TO BE READ RESIDES ON ONE PAGE
1584 * AND THAT ALL THE DATA TO BE WRITTEN RESIDES ON ONE (DIFFERENT) PAGE.
1585 * THE CALLING ROUTINE MUST ENSURE THAT THIS REQUIREMENT IS MET, AND MUST
1586 * ALSO ENSURE THAT much IS EVEN.
1587 *
1588 * much BYTES ARE READ, AT LEAST (bytesperpixel * much)/2 BYTES ARE WRITTEN
1589 * IF THERE IS NO DECIMATION, HALF THIS AMOUNT IF THERE IS DECIMATION.
1590 *
1591 * mask IS ZERO WHEN NO SPECIAL BEHAVIOUR REQUIRED. OTHERWISE IT IS SET THUS:
1592 * 0x03 & mask = number of bytes to be written to cache instead of to
1593 * frame buffer
1594 * 0x04 & mask => use argument margin to set the chrominance for last pixel
1595 * 0x08 & mask => do not set the chrominance for last pixel
1596 *
1597 * YUV to RGB CONVERSION IS (OR SHOULD BE) ITU-R BT 601.
1598 *
1599 * THERE IS A LOT OF CODE REPETITION IN THIS ROUTINE IN ORDER TO AVOID
1600 * INEFFICIENT SWITCHING INSIDE INNER LOOPS. REARRANGING THE LOGIC TO
1601 * REDUCE CODE LENGTH WILL GENERALLY IMPAIR RUNTIME PERFORMANCE. BEWARE.
1602 */
1603 /*---------------------------------------------------------------------------*/
1604 int
1607 {
1614 s32 tmp;
1619 }
1624 /*---------------------------------------------------------------------------*/
1635 }
1639 }
1643 }
1651 }
1655 /*---------------------------------------------------------------------------*/
1656 /*
1657 * TRANSFER CONTENTS OF CACHE TO THE FRAME BUFFER
1658 */
1659 /*---------------------------------------------------------------------------*/
1663 }
1671 }
1676 }
1677 /*---------------------------------------------------------------------------*/
1681 p2++;
1685 else
1691 /*---------------------------------------------------------------------------*/
1697 /* UYVY */
1700 /* YUYV */
1707 }
1709 }
1712 /* UYVY DECIMATED */
1720 }
1723 /* YUYV DECIMATED */
1731 }
1733 }
1734 }
1736 }
1738 {
1741 /* RGB */
1745 else
1752 else
1756 ;
1760 else
1762 }
1782 }
1788 }
1793 }
1794 }
1799 }
1803 else
1806 }
1809 /* BGR */
1813 else
1820 else
1822 }
1823 else
1825 ;
1829 else
1831 }
1851 }
1857 }
1862 }
1863 }
1868 }
1872 else
1875 }
1876 }
1880 /* RGB DECIMATED */
1884 else
1891 else
1895 ;
1899 else
1901 }
1923 }
1929 }
1935 }
1936 }
1941 }
1946 }
1948 }
1951 /* BGR DECIMATED */
1955 else
1962 else
1966 ;
1970 else
1972 }
1995 }
2001 }
2007 }
2008 }
2013 }
2016 }
2017 else
2020 }
2022 }
2023 }
2025 }
2027 {
2030 /* RGBA */
2034 else
2041 else
2045 ;
2049 else
2051 }
2072 }
2079 }
2086 }
2091 }
2092 }
2098 }
2102 else
2105 }
2108 /*
2109 * BGRA
2110 */
2114 else
2121 else
2125 ;
2129 else
2131 }
2152 }
2159 }
2166 }
2171 }
2177 }
2181 else
2184 }
2185 }
2189 /*
2190 * RGBA DECIMATED
2191 */
2195 else
2202 else
2206 ;
2210 else
2212 }
2236 }
2243 }
2250 }
2254 bytesperpixel -
2255 rump);
2257 }
2258 }
2264 }
2270 }
2273 /*
2274 * BGRA DECIMATED
2275 */
2279 else
2286 else
2290 ;
2294 else
2296 }
2319 }
2326 }
2333 }
2339 }
2340 }
2346 }
2352 }
2354 }
2355 }
2357 }
2361 }
2362 }
2364 }
2365 /*****************************************************************************/
2366 /*
2367 * SEE CORBET ET AL. "LINUX DEVICE DRIVERS", 3rd EDITION, PAGES 430-434
2368 */
2369 /*****************************************************************************/
2371 {
2378 }
2382 }
2383 /*****************************************************************************/
2385 {
2392 }
2396 }
2397 /*****************************************************************************/
2399 {
2410 }
2414 }
2421 else
2427 }
2431 }
2436 }
2437 /*---------------------------------------------------------------------------*/
2442 }
2447 }
2449 /*---------------------------------------------------------------------------*/
2455 }
2457 }
2463 };
2466 {
2475 }
2476 /*****************************************************************************/
2477 /*---------------------------------------------------------------------------*/
2478 /*
2479 * ON COMPLETION OF A VIDEO URB ITS DATA IS COPIED TO THE FIELD BUFFERS
2480 * PROVIDED peasycap->video_idle IS ZERO. REGARDLESS OF THIS BEING TRUE,
2481 * IT IS RESUBMITTED PROVIDED peasycap->video_isoc_streaming IS NOT ZERO.
2482 *
2483 * THIS FUNCTION IS AN INTERRUPT SERVICE ROUTINE AND MUST NOT SLEEP.
2484 *
2485 * INFORMATION ABOUT THE VALIDITY OF THE CONTENTS OF THE FIELD BUFFER ARE
2486 * STORED IN THE TWO-BYTE STATUS PARAMETER
2487 * peasycap->field_buffer[peasycap->field_fill][0].kount
2488 * NOTICE THAT THE INFORMATION IS STORED ONLY WITH PAGE 0 OF THE FIELD BUFFER.
2489 *
2490 * THE LOWER BYTE CONTAINS THE FIELD PARITY BYTE FURNISHED BY THE SAA7113H
2491 * CHIP.
2492 *
2493 * THE UPPER BYTE IS ZERO IF NO PROBLEMS, OTHERWISE:
2494 * 0 != (kount & 0x8000) => AT LEAST ONE URB COMPLETED WITH ERRORS
2495 * 0 != (kount & 0x4000) => BUFFER HAS TOO MUCH DATA
2496 * 0 != (kount & 0x2000) => BUFFER HAS NOT ENOUGH DATA
2497 * 0 != (kount & 0x1000) => BUFFER HAS DATA FROM DISPARATE INPUTS
2498 * 0 != (kount & 0x0400) => RESERVED
2499 * 0 != (kount & 0x0200) => FIELD BUFFER NOT YET CHECKED
2500 * 0 != (kount & 0x0100) => BUFFER HAS TWO EXTRA BYTES - WHY?
2501 */
2502 /*---------------------------------------------------------------------------*/
2504 {
2517 }
2522 }
2534 }
2546 "usb_submit_urb() "
2549 }
2550 }
2552 }
2554 /*---------------------------------------------------------------------------*/
2558 }
2563 }
2568 /*---------------------------------------------------------------------------*/
2574 /* FIXME: 1. missing '-' check boundaries */
2577 }
2584 "%4i=status "
2585 "%4i=actual "
2586 "%4i=length "
2594 PAGE_SIZE) +
2603 }
2607 }
2612 }
2619 else
2621 /*--------------------------------------------------------------------------*/
2622 /*
2623 * EIGHT-BYTE END-OF-VIDEOFIELD MARKER.
2624 * NOTE: A SUCCESSION OF URB FRAMES FOLLOWING THIS ARE EMPTY,
2625 * CORRESPONDING TO THE FIELD FLYBACK (VERTICAL BLANKING) PERIOD.
2626 *
2627 * PROVIDED THE FIELD BUFFER CONTAINS GOOD DATA AS INDICATED BY A ZERO UPPER
2628 * BYTE OF
2629 * peasycap->field_buffer[peasycap->field_fill][0].kount
2630 * THE CONTENTS OF THE FIELD BUFFER ARE OFFERED TO dqbuf(), field_read IS
2631 * UPDATED AND field_fill IS BUMPED. IF THE FIELD BUFFER CONTAINS BAD DATA
2632 * NOTHING IS OFFERED TO dqbuf().
2633 *
2634 * THE DECISION ON WHETHER THE PARITY OF THE OFFERED FIELD BUFFER IS RIGHT
2635 * RESTS WITH dqbuf().
2636 */
2637 /*---------------------------------------------------------------------------*/
2642 peasycap->
2643 videofieldamount) {
2648 VIDEO_JUNK_TOLERATE);
2654 peasycap->
2655 videofieldamount) {
2659 }
2671 field_fill)++;
2673 peasycap->
2674 field_fill)
2675 peasycap->
2679 field_buffer
2681 field_fill]
2683 field_page];
2687 "peasycap->"
2688 "field_fill %i="
2694 "%i bytes fit to be "
2697 videofieldamount);
2699 "wq_video, "
2700 "%i=field_read "
2701 "%i=field_fill "
2706 field_buffer
2709 wake_up_interruptible
2711 wq_video));
2718 "bytes, now discarded: "
2721 videofieldamount,
2723 peasycap->field_buffer
2725 kount));
2732 pfield_buffer =
2743 }
2750 else
2756 }
2757 }
2758 /*---------------------------------------------------------------------------*/
2759 /*
2760 * COPY more BYTES FROM ISOC BUFFER TO FIELD BUFFER
2761 */
2762 /*---------------------------------------------------------------------------*/
2769 }
2773 }
2784 }
2793 }
2795 field_buffer
2803 input !=
2808 }
2820 }
2821 }
2822 }
2823 }
2824 }
2825 /*---------------------------------------------------------------------------*/
2826 /*
2827 * RESUBMIT THIS URB, UNLESS A SEVERE PERSISTENT ERROR CONDITION EXISTS.
2828 *
2829 * IF THE WAIT QUEUES ARE NOT CLEARED IN RESPONSE TO AN ERROR CONDITION
2830 * THE USERSPACE PROGRAM, E.G. mplayer, MAY HANG ON EXIT. BEWARE.
2831 */
2832 /*---------------------------------------------------------------------------*/
2839 #if !defined(PERSEVERE)
2844 }
2851 "usb_submit_urb() "
2854 }
2855 }
2857 }
2865 };
2870 };
2871 /*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
2878 };
2879 /*****************************************************************************/
2880 /*---------------------------------------------------------------------------*/
2881 /*
2882 * WHEN THE EasyCAP IS PHYSICALLY PLUGGED IN, THIS FUNCTION IS CALLED THREE
2883 * TIMES, ONCE FOR EACH OF THE THREE INTERFACES. BEWARE.
2884 */
2885 /*---------------------------------------------------------------------------*/
2888 {
2898 u8 bInterfaceNumber;
2899 u8 bInterfaceClass;
2900 u8 bInterfaceSubClass;
2906 u16 mask;
2907 s32 value;
2914 /*---------------------------------------------------------------------------*/
2919 }
2924 }
2925 /*---------------------------------------------------------------------------*/
2926 /*
2927 * GET PROPERTIES OF PROBED INTERFACE
2928 */
2929 /*---------------------------------------------------------------------------*/
2937 bInterfaceNumber,
2941 /*---------------------------------------------------------------------------*/
2942 /*
2943 * A NEW struct easycap IS ALWAYS ALLOCATED WHEN INTERFACE 0 IS PROBED.
2944 * IT IS NOT POSSIBLE HERE TO FREE ANY EXISTING struct easycap. THIS
2945 * SHOULD HAVE BEEN DONE BY easycap_delete() WHEN THE EasyCAP WAS
2946 * PHYSICALLY UNPLUGGED.
2947 *
2948 * THE POINTER peasycap TO THE struct easycap IS REMEMBERED WHEN
2949 * INTERFACES 1 AND 2 ARE PROBED.
2950 */
2951 /*---------------------------------------------------------------------------*/
2957 }
2958 /*---------------------------------------------------------------------------*/
2959 /*
2960 * PERFORM URGENT INTIALIZATIONS ...
2961 */
2962 /*---------------------------------------------------------------------------*/
2969 /* module params */
2980 /*---------------------------------------------------------------------------*/
2981 /*
2982 * FOR INTERFACES 1 AND 2 THE POINTER peasycap WILL NEED TO
2983 * TO BE THE SAME AS THAT ALLOCATED NOW FOR INTERFACE 0.
2984 *
2985 * NORMALLY ndong WILL NOT HAVE CHANGED SINCE INTERFACE 0 WAS
2986 * PROBED, BUT THIS MAY NOT BE THE CASE IF, FOR EXAMPLE, TWO
2987 * EASYCAPs ARE PLUGGED IN SIMULTANEOUSLY.
2988 */
2989 /*---------------------------------------------------------------------------*/
3002 }
3003 }
3008 }
3010 }
3018 /*---------------------------------------------------------------------------*/
3019 /*
3020 * ... AND FURTHER INITIALIZE THE STRUCTURE
3021 */
3022 /*---------------------------------------------------------------------------*/
3050 /*---------------------------------------------------------------------------*/
3051 /*
3052 * DYNAMICALLY FILL IN THE AVAILABLE FORMATS ...
3053 */
3054 /*---------------------------------------------------------------------------*/
3059 }
3061 /*---------------------------------------------------------------------------*/
3062 /*
3063 * ... AND POPULATE easycap.inputset[]
3064 */
3065 /*---------------------------------------------------------------------------*/
3066 /* FIXME: maybe we just use memset 0 */
3076 }
3083 m++;
3088 }
3089 }
3095 }
3106 m++;
3110 }
3111 peasycap_format++;
3112 }
3116 }
3122 m++;
3126 m++;
3130 m++;
3134 m++;
3137 }
3138 }
3143 }
3149 /*---------------------------------------------------------------------------*/
3150 /*
3151 * FIXME
3152 *
3153 * IDENTIFY THE APPROPRIATE POINTER peasycap FOR INTERFACES 1 AND 2.
3154 * THE ADDRESS OF peasycap->pusb_device IS RELUCTANTLY USED FOR THIS PURPOSE.
3155 */
3156 /*---------------------------------------------------------------------------*/
3159 pusb_device) {
3164 }
3165 }
3168 bInterfaceNumber);
3170 }
3173 bInterfaceNumber);
3175 }
3176 }
3177 /*---------------------------------------------------------------------------*/
3191 }
3192 }
3206 }
3207 }
3208 }
3209 /*---------------------------------------------------------------------------*/
3210 /*
3211 * INVESTIGATE ALL ALTSETTINGS.
3212 * DONE IN DETAIL BECAUSE USB DEVICE 05e1:0408 HAS DISPARATE INCARNATIONS.
3213 */
3214 /*---------------------------------------------------------------------------*/
3222 }
3227 }
3232 /*---------------------------------------------------------------------------*/
3239 }
3243 bInterfaceNumber,
3248 }
3250 }
3260 isokalt);
3262 ep->
3263 bEndpointAddress &
3268 isokalt);
3271 wMaxPacketSize);
3275 isokalt);
3276 isokalt++;
3277 }
3280 video_altsetting_off) {
3281 peasycap->
3282 video_altsetting_off =
3283 i;
3285 "altsetting_off "
3287 peasycap->
3288 video_altsetting_off);
3291 "->video_altsetting_"
3294 "continuing with "
3295 "%i=peasycap->video_"
3297 peasycap->
3298 video_altsetting_off);
3299 }
3300 }
3302 }
3305 USB_SUBCLASS_AUDIOSTREAMING)
3311 }
3318 isokalt);
3320 ep->
3321 bEndpointAddress &
3326 isokalt);
3329 wMaxPacketSize);
3333 isokalt);
3334 isokalt++;
3335 }
3338 audio_altsetting_off) {
3339 peasycap->
3340 audio_altsetting_off =
3341 i;
3343 "altsetting_off "
3345 peasycap->
3346 audio_altsetting_off);
3349 "->audio_altsetting_"
3352 "continuing with "
3353 "%i=peasycap->"
3354 "audio_altsetting_"
3356 peasycap->
3357 audio_altsetting_off);
3358 }
3359 }
3361 }
3364 }
3369 }
3370 }
3371 }
3372 /*---------------------------------------------------------------------------*/
3373 /*
3374 * PERFORM INITIALIZATION OF THE PROBED INTERFACE
3375 */
3376 /*---------------------------------------------------------------------------*/
3380 /*---------------------------------------------------------------------------*/
3381 /*
3382 * INTERFACE 0 IS THE VIDEO INTERFACE
3383 */
3384 /*---------------------------------------------------------------------------*/
3389 }
3397 }
3398 /*---------------------------------------------------------------------------*/
3399 /*
3400 * DECIDE THE VIDEO STREAMING PARAMETERS
3401 */
3402 /*---------------------------------------------------------------------------*/
3413 }
3423 }
3433 }
3434 /*---------------------------------------------------------------------------*/
3438 }
3442 }
3446 }
3450 }
3454 }
3458 }
3459 /*---------------------------------------------------------------------------*/
3460 /*
3461 * ALLOCATE MEMORY FOR VIDEO BUFFERS. LISTS MUST BE INITIALIZED FIRST.
3462 */
3463 /*---------------------------------------------------------------------------*/
3466 /*---------------------------------------------------------------------------*/
3486 }
3489 }
3490 }
3495 m);
3496 /*---------------------------------------------------------------------------*/
3513 }
3514 else
3517 }
3520 }
3522 }
3527 m);
3528 /*---------------------------------------------------------------------------*/
3530 VIDEO_ISOC_BUFFER_MANY,
3536 VIDEO_ISOC_ORDER);
3549 }
3552 /*---------------------------------------------------------------------------*/
3553 /*
3554 * ALLOCATE AND INITIALIZE MULTIPLE struct urb ...
3555 */
3556 /*---------------------------------------------------------------------------*/
3567 GFP_KERNEL);
3574 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
3588 /*---------------------------------------------------------------------------*/
3589 /*
3590 * ... AND INITIALIZE THEM
3591 */
3592 /*---------------------------------------------------------------------------*/
3618 }
3637 }
3638 }
3640 /*--------------------------------------------------------------------------*/
3641 /*
3642 * SAVE POINTER peasycap IN THIS INTERFACE.
3643 */
3644 /*--------------------------------------------------------------------------*/
3646 /*---------------------------------------------------------------------------*/
3647 /*
3648 * IT IS ESSENTIAL TO INITIALIZE THE HARDWARE BEFORE, RATHER THAN AFTER,
3649 * THE DEVICE IS REGISTERED, BECAUSE SOME VERSIONS OF THE videodev MODULE
3650 * CALL easycap_open() IMMEDIATELY AFTER REGISTRATION, CAUSING A CLASH.
3651 * BEWARE.
3652 */
3653 /*---------------------------------------------------------------------------*/
3661 }
3662 /*--------------------------------------------------------------------------*/
3663 /*
3664 * THE VIDEO DEVICE CAN BE REGISTERED NOW, AS IT IS READY.
3665 */
3666 /*--------------------------------------------------------------------------*/
3670 }
3673 /*---------------------------------------------------------------------------*/
3674 /*
3675 * FIXME
3676 *
3677 *
3678 * THIS IS BELIEVED TO BE HARMLESS, BUT MAY WELL BE UNNECESSARY OR WRONG:
3679 */
3680 /*---------------------------------------------------------------------------*/
3682 /*---------------------------------------------------------------------------*/
3702 }
3703 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
3706 }
3707 /*--------------------------------------------------------------------------*/
3708 /*
3709 * INTERFACE 1 IS THE AUDIO CONTROL INTERFACE
3710 * INTERFACE 2 IS THE AUDIO STREAMING INTERFACE
3711 */
3712 /*--------------------------------------------------------------------------*/
3717 }
3718 /*--------------------------------------------------------------------------*/
3719 /*
3720 * SAVE POINTER peasycap IN INTERFACE 1
3721 */
3722 /*--------------------------------------------------------------------------*/
3727 }
3728 /*--------------------------------------------------------------------------*/
3733 }
3741 }
3752 }
3758 PAGES_PER_AUDIO_FRAGMENT;
3764 PAGES_PER_AUDIO_FRAGMENT;
3770 }
3792 }
3802 AUDIO_ISOC_BUFFER_SIZE);
3804 }
3808 }
3812 }
3816 }
3820 }
3824 }
3828 }
3829 /*---------------------------------------------------------------------------*/
3830 /*
3831 * ALLOCATE MEMORY FOR AUDIO BUFFERS. LISTS MUST BE INITIALIZED FIRST.
3832 */
3833 /*---------------------------------------------------------------------------*/
3837 /*---------------------------------------------------------------------------*/
3839 AUDIO_ISOC_BUFFER_MANY,
3845 AUDIO_ISOC_ORDER);
3858 }
3860 /*---------------------------------------------------------------------------*/
3861 /*
3862 * ALLOCATE AND INITIALIZE MULTIPLE struct urb ...
3863 */
3864 /*---------------------------------------------------------------------------*/
3875 GFP_KERNEL);
3880 }
3882 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
3887 }
3896 /*---------------------------------------------------------------------------*/
3897 /*
3898 * ... AND INITIALIZE THEM
3899 */
3900 /*---------------------------------------------------------------------------*/
3926 }
3945 }
3946 }
3948 /*---------------------------------------------------------------------------*/
3949 /*
3950 * SAVE POINTER peasycap IN THIS INTERFACE.
3951 */
3952 /*---------------------------------------------------------------------------*/
3954 /*---------------------------------------------------------------------------*/
3955 /*
3956 * THE AUDIO DEVICE CAN BE REGISTERED NOW, AS IT IS READY.
3957 */
3958 /*---------------------------------------------------------------------------*/
3965 }
3973 }
3974 /*---------------------------------------------------------------------------*/
3975 /*
3976 * INTERFACES OTHER THAN 0, 1 AND 2 ARE UNEXPECTED
3977 */
3978 /*---------------------------------------------------------------------------*/
3982 }
3985 }
3986 /*****************************************************************************/
3987 /*---------------------------------------------------------------------------*/
3988 /*
3989 * WHEN THIS FUNCTION IS CALLED THE EasyCAP HAS ALREADY BEEN PHYSICALLY
3990 * UNPLUGGED. HENCE peasycap->pusb_device IS NO LONGER VALID.
3991 *
3992 * THIS FUNCTION AFFECTS ALSA. BEWARE.
3993 */
3994 /*---------------------------------------------------------------------------*/
3996 {
3999 u8 bInterfaceNumber;
4012 }
4017 }
4029 }
4030 /*---------------------------------------------------------------------------*/
4031 /*
4032 * IF THE WAIT QUEUES ARE NOT CLEARED A DEADLOCK IS POSSIBLE. BEWARE.
4033 */
4034 /*---------------------------------------------------------------------------*/
4039 /*---------------------------------------------------------------------------*/
4051 m++;
4052 }
4053 }
4054 }
4056 }
4058 }
4059 /*---------------------------------------------------------------------------*/
4070 m++;
4071 }
4072 }
4073 }
4075 }
4077 }
4080 }
4081 /*--------------------------------------------------------------------------*/
4082 /*
4083 * DEREGISTER
4084 *
4085 * THIS PROCEDURE WILL BLOCK UNTIL easycap_poll(), VIDEO IOCTL AND AUDIO
4086 * IOCTL ARE ALL UNLOCKED. IF THIS IS NOT DONE AN Oops CAN OCCUR WHEN
4087 * AN EasyCAP IS UNPLUGGED WHILE THE URBS ARE RUNNING. BEWARE.
4088 */
4089 /*--------------------------------------------------------------------------*/
4097 mutex_video)) {
4101 }
4105 }
4106 /*---------------------------------------------------------------------------*/
4112 }
4122 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
4127 }
4129 }
4135 mutex_audio)) {
4139 }
4148 }
4152 }
4154 }
4157 }
4158 /*---------------------------------------------------------------------------*/
4159 /*
4160 * CALL easycap_delete() IF NO REMAINING REFERENCES TO peasycap
4161 * (ALSO WHEN ALSA HAS BEEN IN USE)
4162 */
4163 /*---------------------------------------------------------------------------*/
4169 }
4176 }
4185 }
4187 }
4197 }
4198 /*---------------------------------------------------------------------------*/
4201 }
4202 /*****************************************************************************/
4204 /*---------------------------------------------------------------------------*/
4205 /*
4206 * PARAMETERS APPLICABLE TO ENTIRE DRIVER, I.E. BOTH VIDEO AND AUDIO
4207 */
4208 /*---------------------------------------------------------------------------*/
4211 { }
4212 };
4220 };
4223 {
4236 }
4242 }
4243 /*****************************************************************************/
4245 {
4247 }
4248 /*****************************************************************************/
4253 /*****************************************************************************/