R.M. Thomas | 702422b | 2010-06-18 12:29:49 -0700 | [diff] [blame] | 1 | |
| 2 | *********************************************************** |
| 3 | * EasyCAP USB 2.0 Video Adapter with Audio, Model DC60 * |
| 4 | * and * |
| 5 | * EasyCAP002 4-Channel USB 2.0 DVR * |
| 6 | *********************************************************** |
| 7 | Mike Thomas <rmthomas@sciolus.org> |
| 8 | |
| 9 | |
| 10 | |
| 11 | SUPPORTED HARDWARE |
| 12 | ------------------ |
| 13 | |
| 14 | This driver is intended for use with hardware having USB ID 05e1:0408. |
| 15 | Two kinds of EasyCAP have this USB ID, namely: |
| 16 | |
| 17 | * EasyCAP USB 2.0 Video Adapter with Audio, Model DC60, |
| 18 | having input cables labelled CVBS, S-VIDEO, AUDIO(L), AUDIO(R) |
| 19 | |
| 20 | * EasyCAP002 4-Channel USB 2.0 DVR, having input cables labelled |
| 21 | 1, 2, 3, 4 and an unlabelled input cable for a microphone. |
| 22 | |
| 23 | |
| 24 | BUILD OPTIONS AND DEPENDENCIES |
| 25 | ------------------------------ |
| 26 | |
Mike Thomas | 268dfed | 2010-11-07 20:11:36 +0000 | [diff] [blame] | 27 | Unless EASYCAP_DEBUG is defined during compilation it will not be possible |
| 28 | to select a debug level at the time of module installation. |
| 29 | |
R.M. Thomas | 702422b | 2010-06-18 12:29:49 -0700 | [diff] [blame] | 30 | |
| 31 | KNOWN RUNTIME ISSUES |
| 32 | -------------------- |
| 33 | |
Mike Thomas | 268dfed | 2010-11-07 20:11:36 +0000 | [diff] [blame] | 34 | (1) Intentionally, this driver will not stream material which is unambiguously |
| 35 | identified by the hardware as copy-protected. Normal video output will be |
| 36 | present for about a minute but will then freeze when this situation arises. |
R.M. Thomas | 702422b | 2010-06-18 12:29:49 -0700 | [diff] [blame] | 37 | |
Mike Thomas | 268dfed | 2010-11-07 20:11:36 +0000 | [diff] [blame] | 38 | (2) The controls for luminance, contrast, saturation, hue and volume may not |
R.M. Thomas | 702422b | 2010-06-18 12:29:49 -0700 | [diff] [blame] | 39 | always work properly. |
| 40 | |
Mike Thomas | 268dfed | 2010-11-07 20:11:36 +0000 | [diff] [blame] | 41 | (3) Reduced-resolution S-Video seems to suffer from moire artefacts. |
| 42 | |
| 43 | |
| 44 | INPUT NUMBERING |
| 45 | --------------- |
| 46 | |
| 47 | For the EasyCAP with S-VIDEO input cable the driver regards a request for |
| 48 | inputs numbered 0 or 1 as referring to CVBS and a request for input |
| 49 | numbered 5 as referring to S-VIDEO. |
| 50 | |
| 51 | For the EasyCAP with four CVBS inputs the driver expects to be asked for |
| 52 | any one of inputs numbered 1,2,3,4. If input 0 is asked for, it is |
| 53 | interpreted as input 1. |
| 54 | |
| 55 | |
| 56 | MODULE PARAMETERS |
| 57 | ----------------- |
| 58 | |
| 59 | Three module parameters are defined: |
| 60 | |
| 61 | debug the easycap module is configured at diagnostic level n (0 to 9) |
| 62 | gain audio gain level n (0 to 31, default is 16) |
Kirill Smelkov | eb4cfab | 2011-06-14 20:46:49 +0400 | [diff] [blame] | 63 | bars whether to display testcard bars when incoming video signal is lost |
| 64 | 0 => no, 1 => yes (default) |
R.M. Thomas | 702422b | 2010-06-18 12:29:49 -0700 | [diff] [blame] | 65 | |
| 66 | |
| 67 | SUPPORTED TV STANDARDS AND RESOLUTIONS |
| 68 | -------------------------------------- |
| 69 | |
| 70 | The following TV standards are natively supported by the hardware and are |
| 71 | usable as (for example) the "norm=" parameter in the mplayer command: |
| 72 | |
| 73 | PAL_BGHIN, NTSC_N_443, |
| 74 | PAL_Nc, NTSC_N, |
| 75 | SECAM, NTSC_M, NTSC_M_JP, |
| 76 | PAL_60, NTSC_443, |
| 77 | PAL_M. |
| 78 | |
Mike Thomas | 268dfed | 2010-11-07 20:11:36 +0000 | [diff] [blame] | 79 | In addition, the driver offers "custom" pseudo-standards with a framerate |
| 80 | which is 20% of the usual framerate. These pseudo-standards are named: |
| 81 | |
| 82 | PAL_BGHIN_SLOW, NTSC_N_443_SLOW, |
| 83 | PAL_Nc_SLOW, NTSC_N_SLOW, |
| 84 | SECAM_SLOW, NTSC_M_SLOW, NTSC_M_JP_SLOW, |
| 85 | PAL_60_SLOW, NTSC_443_SLOW, |
| 86 | PAL_M_SLOW. |
| 87 | |
| 88 | |
R.M. Thomas | 702422b | 2010-06-18 12:29:49 -0700 | [diff] [blame] | 89 | The available picture sizes are: |
| 90 | |
| 91 | at 25 frames per second: 720x576, 704x576, 640x480, 360x288, 320x240; |
Mike Thomas | 268dfed | 2010-11-07 20:11:36 +0000 | [diff] [blame] | 92 | at 30 frames per second: 720x480, 640x480, 360x240, 320x240. |
R.M. Thomas | 702422b | 2010-06-18 12:29:49 -0700 | [diff] [blame] | 93 | |
| 94 | |
| 95 | WHAT'S TESTED AND WHAT'S NOT |
| 96 | ---------------------------- |
| 97 | |
Mike Thomas | 268dfed | 2010-11-07 20:11:36 +0000 | [diff] [blame] | 98 | This driver is known to work with mplayer, mencoder, tvtime, zoneminder, |
| 99 | xawtv, gstreamer and sufficiently recent versions of vlc. An interface |
| 100 | to ffmpeg is implemented, but serious audio-video synchronization problems |
| 101 | remain. |
R.M. Thomas | 702422b | 2010-06-18 12:29:49 -0700 | [diff] [blame] | 102 | |
| 103 | The driver is designed to support all the TV standards accepted by the |
| 104 | hardware, but as yet it has actually been tested on only a few of these. |
| 105 | |
| 106 | I have been unable to test and calibrate the S-video input myself because I |
| 107 | do not possess any equipment with S-video output. |
| 108 | |
R.M. Thomas | 702422b | 2010-06-18 12:29:49 -0700 | [diff] [blame] | 109 | |
| 110 | UDEV RULES |
| 111 | ---------- |
| 112 | |
| 113 | In order that the special files /dev/easycap0 and /dev/easysnd1 are created |
| 114 | with conveniently relaxed permissions when the EasyCAP is plugged in, a file |
| 115 | is preferably to be provided in directory /etc/udev/rules.d with content: |
| 116 | |
| 117 | ACTION!="add|change", GOTO="easycap_rules_end" |
| 118 | ATTRS{idVendor}=="05e1", ATTRS{idProduct}=="0408", \ |
| 119 | MODE="0666", OWNER="root", GROUP="root" |
| 120 | LABEL="easycap_rules_end" |
| 121 | |
| 122 | |
Mike Thomas | 268dfed | 2010-11-07 20:11:36 +0000 | [diff] [blame] | 123 | MODPROBE CONFIGURATION |
| 124 | ---------------------- |
| 125 | |
| 126 | The easycap module is in competition with the module snd-usb-audio for the |
| 127 | EasyCAP's audio channel, and its installation can be aided by providing a |
| 128 | file in directory /etc/modprobe.d with content: |
| 129 | |
| 130 | options easycap gain=16 bars=1 |
| 131 | install easycap /sbin/rmmod snd-usb-audio; /sbin/modprobe --ignore-install easycap |
| 132 | |
| 133 | |
R.M. Thomas | 702422b | 2010-06-18 12:29:49 -0700 | [diff] [blame] | 134 | ACKNOWLEGEMENTS AND REFERENCES |
| 135 | ------------------------------ |
| 136 | This driver makes use of information contained in the Syntek Semicon DC-1125 |
| 137 | Driver, presently maintained at http://sourceforge.net/projects/syntekdriver/ |
| 138 | by Nicolas Vivien. Particularly useful has been a patch to the latter driver |
| 139 | provided by Ivor Hewitt in January 2009. The NTSC implementation is taken |
| 140 | from the work of Ben Trask. |
| 141 | |