Root/
1 | |
2 | ivtv release notes |
3 | ================== |
4 | |
5 | This is a v4l2 device driver for the Conexant cx23415/6 MPEG encoder/decoder. |
6 | The cx23415 can do both encoding and decoding, the cx23416 can only do MPEG |
7 | encoding. Currently the only card featuring full decoding support is the |
8 | Hauppauge PVR-350. |
9 | |
10 | NOTE: this driver requires the latest encoder firmware (version 2.06.039, size |
11 | 376836 bytes). Get the firmware from here: |
12 | |
13 | http://dl.ivtvdriver.org/ivtv/firmware/ |
14 | |
15 | NOTE: 'normal' TV applications do not work with this driver, you need |
16 | an application that can handle MPEG input such as mplayer, xine, MythTV, |
17 | etc. |
18 | |
19 | The primary goal of the IVTV project is to provide a "clean room" Linux |
20 | Open Source driver implementation for video capture cards based on the |
21 | iCompression iTVC15 or Conexant CX23415/CX23416 MPEG Codec. |
22 | |
23 | Features: |
24 | * Hardware mpeg2 capture of broadcast video (and sound) via the tuner or |
25 | S-Video/Composite and audio line-in. |
26 | * Hardware mpeg2 capture of FM radio where hardware support exists |
27 | * Supports NTSC, PAL, SECAM with stereo sound |
28 | * Supports SAP and bilingual transmissions. |
29 | * Supports raw VBI (closed captions and teletext). |
30 | * Supports sliced VBI (closed captions and teletext) and is able to insert |
31 | this into the captured MPEG stream. |
32 | * Supports raw YUV and PCM input. |
33 | |
34 | Additional features for the PVR-350 (CX23415 based): |
35 | * Provides hardware mpeg2 playback |
36 | * Provides comprehensive OSD (On Screen Display: ie. graphics overlaying the |
37 | video signal) |
38 | * Provides a framebuffer (allowing X applications to appear on the video |
39 | device) |
40 | * Supports raw YUV output. |
41 | |
42 | IMPORTANT: In case of problems first read this page: |
43 | http://www.ivtvdriver.org/index.php/Troubleshooting |
44 | |
45 | See also: |
46 | |
47 | Homepage + Wiki |
48 | http://www.ivtvdriver.org |
49 | |
50 | IRC |
51 | irc://irc.freenode.net/ivtv-dev |
52 | |
53 | ---------------------------------------------------------- |
54 | |
55 | Devices |
56 | ======= |
57 | |
58 | A maximum of 12 ivtv boards are allowed at the moment. |
59 | |
60 | Cards that don't have a video output capability (i.e. non PVR350 cards) |
61 | lack the vbi8, vbi16, video16 and video48 devices. They also do not |
62 | support the framebuffer device /dev/fbx for OSD. |
63 | |
64 | The radio0 device may or may not be present, depending on whether the |
65 | card has a radio tuner or not. |
66 | |
67 | Here is a list of the base v4l devices: |
68 | crw-rw---- 1 root video 81, 0 Jun 19 22:22 /dev/video0 |
69 | crw-rw---- 1 root video 81, 16 Jun 19 22:22 /dev/video16 |
70 | crw-rw---- 1 root video 81, 24 Jun 19 22:22 /dev/video24 |
71 | crw-rw---- 1 root video 81, 32 Jun 19 22:22 /dev/video32 |
72 | crw-rw---- 1 root video 81, 48 Jun 19 22:22 /dev/video48 |
73 | crw-rw---- 1 root video 81, 64 Jun 19 22:22 /dev/radio0 |
74 | crw-rw---- 1 root video 81, 224 Jun 19 22:22 /dev/vbi0 |
75 | crw-rw---- 1 root video 81, 228 Jun 19 22:22 /dev/vbi8 |
76 | crw-rw---- 1 root video 81, 232 Jun 19 22:22 /dev/vbi16 |
77 | |
78 | Base devices |
79 | ============ |
80 | |
81 | For every extra card you have the numbers increased by one. For example, |
82 | /dev/video0 is listed as the 'base' encoding capture device so we have: |
83 | |
84 | /dev/video0 is the encoding capture device for the first card (card 0) |
85 | /dev/video1 is the encoding capture device for the second card (card 1) |
86 | /dev/video2 is the encoding capture device for the third card (card 2) |
87 | |
88 | Note that if the first card doesn't have a feature (eg no decoder, so no |
89 | video16, the second card will still use video17. The simple rule is 'add |
90 | the card number to the base device number'. If you have other capture |
91 | cards (e.g. WinTV PCI) that are detected first, then you have to tell |
92 | the ivtv module about it so that it will start counting at 1 (or 2, or |
93 | whatever). Otherwise the device numbers can get confusing. The ivtv |
94 | 'ivtv_first_minor' module option can be used for that. |
95 | |
96 | |
97 | /dev/video0 |
98 | The encoding capture device(s). |
99 | Read-only. |
100 | |
101 | Reading from this device gets you the MPEG1/2 program stream. |
102 | Example: |
103 | |
104 | cat /dev/video0 > my.mpg (you need to hit ctrl-c to exit) |
105 | |
106 | |
107 | /dev/video16 |
108 | The decoder output device(s) |
109 | Write-only. Only present if the MPEG decoder (i.e. CX23415) exists. |
110 | |
111 | An mpeg2 stream sent to this device will appear on the selected video |
112 | display, audio will appear on the line-out/audio out. It is only |
113 | available for cards that support video out. Example: |
114 | |
115 | cat my.mpg >/dev/video16 |
116 | |
117 | |
118 | /dev/video24 |
119 | The raw audio capture device(s). |
120 | Read-only |
121 | |
122 | The raw audio PCM stereo stream from the currently selected |
123 | tuner or audio line-in. Reading from this device results in a raw |
124 | (signed 16 bit Little Endian, 48000 Hz, stereo pcm) capture. |
125 | This device only captures audio. This should be replaced by an ALSA |
126 | device in the future. |
127 | Note that there is no corresponding raw audio output device, this is |
128 | not supported in the decoder firmware. |
129 | |
130 | |
131 | /dev/video32 |
132 | The raw video capture device(s) |
133 | Read-only |
134 | |
135 | The raw YUV video output from the current video input. The YUV format |
136 | is non-standard (V4L2_PIX_FMT_HM12). |
137 | |
138 | Note that the YUV and PCM streams are not synchronized, so they are of |
139 | limited use. |
140 | |
141 | |
142 | /dev/video48 |
143 | The raw video display device(s) |
144 | Write-only. Only present if the MPEG decoder (i.e. CX23415) exists. |
145 | |
146 | Writes a YUV stream to the decoder of the card. |
147 | |
148 | |
149 | /dev/radio0 |
150 | The radio tuner device(s) |
151 | Cannot be read or written. |
152 | |
153 | Used to enable the radio tuner and tune to a frequency. You cannot |
154 | read or write audio streams with this device. Once you use this |
155 | device to tune the radio, use /dev/video24 to read the raw pcm stream |
156 | or /dev/video0 to get an mpeg2 stream with black video. |
157 | |
158 | |
159 | /dev/vbi0 |
160 | The 'vertical blank interval' (Teletext, CC, WSS etc) capture device(s) |
161 | Read-only |
162 | |
163 | Captures the raw (or sliced) video data sent during the Vertical Blank |
164 | Interval. This data is used to encode teletext, closed captions, VPS, |
165 | widescreen signalling, electronic program guide information, and other |
166 | services. |
167 | |
168 | |
169 | /dev/vbi8 |
170 | Processed vbi feedback device(s) |
171 | Read-only. Only present if the MPEG decoder (i.e. CX23415) exists. |
172 | |
173 | The sliced VBI data embedded in an MPEG stream is reproduced on this |
174 | device. So while playing back a recording on /dev/video16, you can |
175 | read the embedded VBI data from /dev/vbi8. |
176 | |
177 | |
178 | /dev/vbi16 |
179 | The vbi 'display' device(s) |
180 | Write-only. Only present if the MPEG decoder (i.e. CX23415) exists. |
181 | |
182 | Can be used to send sliced VBI data to the video-out connector. |
183 | |
184 | --------------------------------- |
185 | |
186 | Hans Verkuil <hverkuil@xs4all.nl> |
187 |
Branches:
ben-wpan
ben-wpan-stefan
javiroman/ks7010
jz-2.6.34
jz-2.6.34-rc5
jz-2.6.34-rc6
jz-2.6.34-rc7
jz-2.6.35
jz-2.6.36
jz-2.6.37
jz-2.6.38
jz-2.6.39
jz-3.0
jz-3.1
jz-3.11
jz-3.12
jz-3.13
jz-3.15
jz-3.16
jz-3.18-dt
jz-3.2
jz-3.3
jz-3.4
jz-3.5
jz-3.6
jz-3.6-rc2-pwm
jz-3.9
jz-3.9-clk
jz-3.9-rc8
jz47xx
jz47xx-2.6.38
master
Tags:
od-2011-09-04
od-2011-09-18
v2.6.34-rc5
v2.6.34-rc6
v2.6.34-rc7
v3.9