aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@woody.linux-foundation.org>2007-04-27 17:18:45 -0400
committerLinus Torvalds <torvalds@woody.linux-foundation.org>2007-04-27 17:18:45 -0400
commitaa5bc2b58e3344da57f26b62e99e13e91c9e0a94 (patch)
treec6e9ea1b3ee8af88b3a050b3fba160ea2f77e404 /Documentation
parentd868772fff6c4b881d66af8640251714e1aefa98 (diff)
parentd455cf5d0db9e3eb1b204cd4a61d8c5ccfe4305f (diff)
Merge branch 'master' of ssh://master.kernel.org/pub/scm/linux/kernel/git/mchehab/v4l-dvb
* 'master' of ssh://master.kernel.org/pub/scm/linux/kernel/git/mchehab/v4l-dvb: (184 commits) V4L/DVB (5563): Radio-maestro.c Replace radio_ioctl to use video_ioctl2 V4L/DVB (5562): Radio-gemtek-pci.c Replace gemtek_pci_ioctl to use video_ioctl2 V4L/DVB (5560): Ivtv: fix incorrect bitwise-and for command flags. V4L/DVB (5558): Opera: use 7-bit i2c addresses V4L/DVB (5557): Cafe_ccic: check return value of pci_enable_device V4L/DVB (5556): Radio-gemtek.c Replace gemtek_ioctl to use video_ioctl2 V4L/DVB (5555): Radio-aimslab.c Replace rt_ioctl to use video_ioctl2 V4L/DVB (5554): Fix: vidioc_g_parm were not zeroing the memory V4L/DVB (5553): Replace typhoon_do_ioctl to use video_ioctl2 V4L/DVB (5552): Plan-b: Switch to refcounting PCI API V4L/DVB (5551): Plan-b: header change V4L/DVB (5550): Radio-sf16fmi.c Replace fmi_do_ioctl to use video_ioctl2 V4L/DVB (5549): Radio-sf16fmr2.c Replace fmr2_do_ioctl to use video_ioctl2 V4L/DVB (5548): Fix v4l2 buffer to the length V4L/DVB (5547): Add ENUM_FRAMESIZES and ENUM_FRAMEINTERVALS ioctls V4L/DVB (5546): Radio-terratec.c Replace tt_do_ioctl to use video_ioctl2 V4L/DVB (5545): Saa7146: Release capture buffers on device close V4L/DVB (5544): Budget-av: Make inversion setting configurable, add KNC ONE V1.0 card V4L/DVB (5543): Tda10023: Add support for frontend TDA10023 V4L/DVB (5542): Budget-av: Remove polarity switching of the clock for DVB-C ...
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/feature-removal-schedule.txt12
-rw-r--r--Documentation/video4linux/CARDLIST.bttv2
-rw-r--r--Documentation/video4linux/CARDLIST.cx882
-rw-r--r--Documentation/video4linux/CARDLIST.ivtv18
-rw-r--r--Documentation/video4linux/CARDLIST.saa71348
-rw-r--r--Documentation/video4linux/CARDLIST.usbvision64
-rw-r--r--Documentation/video4linux/README.ivtv187
-rw-r--r--Documentation/video4linux/cx2341x/fw-decoder-regs.txt12
-rw-r--r--Documentation/video4linux/cx2341x/fw-encoder-api.txt19
-rw-r--r--Documentation/video4linux/cx2341x/fw-osd-api.txt12
-rw-r--r--Documentation/video4linux/sn9c102.txt64
-rw-r--r--Documentation/video4linux/zr364xx.txt65
12 files changed, 420 insertions, 45 deletions
diff --git a/Documentation/feature-removal-schedule.txt b/Documentation/feature-removal-schedule.txt
index ec0b4843b1cb..5c88ba1ea262 100644
--- a/Documentation/feature-removal-schedule.txt
+++ b/Documentation/feature-removal-schedule.txt
@@ -6,6 +6,18 @@ be removed from this file.
6 6
7--------------------------- 7---------------------------
8 8
9What: V4L2 VIDIOC_G_MPEGCOMP and VIDIOC_S_MPEGCOMP
10When: October 2007
11Why: Broken attempt to set MPEG compression parameters. These ioctls are
12 not able to implement the wide variety of parameters that can be set
13 by hardware MPEG encoders. A new MPEG control mechanism was created
14 in kernel 2.6.18 that replaces these ioctls. See the V4L2 specification
15 (section 1.9: Extended controls) for more information on this topic.
16Who: Hans Verkuil <hverkuil@xs4all.nl> and
17 Mauro Carvalho Chehab <mchehab@infradead.org>
18
19---------------------------
20
9What: /sys/devices/.../power/state 21What: /sys/devices/.../power/state
10 dev->power.power_state 22 dev->power.power_state
11 dpm_runtime_{suspend,resume)() 23 dpm_runtime_{suspend,resume)()
diff --git a/Documentation/video4linux/CARDLIST.bttv b/Documentation/video4linux/CARDLIST.bttv
index fc2fe9bc6713..b60639130a51 100644
--- a/Documentation/video4linux/CARDLIST.bttv
+++ b/Documentation/video4linux/CARDLIST.bttv
@@ -143,3 +143,5 @@
143142 -> Sabrent TV-FM (bttv version) 143142 -> Sabrent TV-FM (bttv version)
144143 -> Hauppauge ImpactVCB (bt878) [0070:13eb] 144143 -> Hauppauge ImpactVCB (bt878) [0070:13eb]
145144 -> MagicTV 145144 -> MagicTV
146145 -> SSAI Security Video Interface [4149:5353]
147146 -> SSAI Ultrasound Video Interface [414a:5353]
diff --git a/Documentation/video4linux/CARDLIST.cx88 b/Documentation/video4linux/CARDLIST.cx88
index 62e32b49cec9..60f838beb9c8 100644
--- a/Documentation/video4linux/CARDLIST.cx88
+++ b/Documentation/video4linux/CARDLIST.cx88
@@ -37,7 +37,7 @@
37 36 -> AVerTV 303 (M126) [1461:000a] 37 36 -> AVerTV 303 (M126) [1461:000a]
38 37 -> Hauppauge Nova-S-Plus DVB-S [0070:9201,0070:9202] 38 37 -> Hauppauge Nova-S-Plus DVB-S [0070:9201,0070:9202]
39 38 -> Hauppauge Nova-SE2 DVB-S [0070:9200] 39 38 -> Hauppauge Nova-SE2 DVB-S [0070:9200]
40 39 -> KWorld DVB-S 100 [17de:08b2] 40 39 -> KWorld DVB-S 100 [17de:08b2,1421:0341]
41 40 -> Hauppauge WinTV-HVR1100 DVB-T/Hybrid [0070:9400,0070:9402] 41 40 -> Hauppauge WinTV-HVR1100 DVB-T/Hybrid [0070:9400,0070:9402]
42 41 -> Hauppauge WinTV-HVR1100 DVB-T/Hybrid (Low Profile) [0070:9800,0070:9802] 42 41 -> Hauppauge WinTV-HVR1100 DVB-T/Hybrid (Low Profile) [0070:9800,0070:9802]
43 42 -> digitalnow DNTV Live! DVB-T Pro [1822:0025,1822:0019] 43 42 -> digitalnow DNTV Live! DVB-T Pro [1822:0025,1822:0019]
diff --git a/Documentation/video4linux/CARDLIST.ivtv b/Documentation/video4linux/CARDLIST.ivtv
new file mode 100644
index 000000000000..ddd76a0eb100
--- /dev/null
+++ b/Documentation/video4linux/CARDLIST.ivtv
@@ -0,0 +1,18 @@
1 1 -> Hauppauge WinTV PVR-250
2 2 -> Hauppauge WinTV PVR-350
3 3 -> Hauppauge WinTV PVR-150 or PVR-500
4 4 -> AVerMedia M179 [1461:a3ce,1461:a3cf]
5 5 -> Yuan MPG600/Kuroutoshikou iTVC16-STVLP [12ab:fff3,12ab:ffff]
6 6 -> Yuan MPG160/Kuroutoshikou iTVC15-STVLP [12ab:0000,10fc:40a0]
7 7 -> Yuan PG600/DiamondMM PVR-550 [ff92:0070,ffab:0600]
8 8 -> Adaptec AVC-2410 [9005:0093]
9 9 -> Adaptec AVC-2010 [9005:0092]
1010 -> NAGASE TRANSGEAR 5000TV [1461:bfff]
1111 -> AOpen VA2000MAX-STN6 [0000:ff5f]
1212 -> YUAN MPG600GR/Kuroutoshikou CX23416GYC-STVLP [12ab:0600,fbab:0600,1154:0523]
1313 -> I/O Data GV-MVP/RX [10fc:d01e,10fc:d038,10fc:d039]
1414 -> I/O Data GV-MVP/RX2E [10fc:d025]
1515 -> GOTVIEW PCI DVD (partial support only) [12ab:0600]
1616 -> GOTVIEW PCI DVD2 Deluxe [ffac:0600]
1717 -> Yuan MPC622 [ff01:d998]
1818 -> Digital Cowboy DCT-MTVP1 [1461:bfff]
diff --git a/Documentation/video4linux/CARDLIST.saa7134 b/Documentation/video4linux/CARDLIST.saa7134
index a12246a9bf23..d7bb2e2e4d9b 100644
--- a/Documentation/video4linux/CARDLIST.saa7134
+++ b/Documentation/video4linux/CARDLIST.saa7134
@@ -53,7 +53,7 @@
53 52 -> AverMedia AverTV/305 [1461:2108] 53 52 -> AverMedia AverTV/305 [1461:2108]
54 53 -> ASUS TV-FM 7135 [1043:4845] 54 53 -> ASUS TV-FM 7135 [1043:4845]
55 54 -> LifeView FlyTV Platinum FM / Gold [5168:0214,1489:0214,5168:0304] 55 54 -> LifeView FlyTV Platinum FM / Gold [5168:0214,1489:0214,5168:0304]
56 55 -> LifeView FlyDVB-T DUO [5168:0306] 56 55 -> LifeView FlyDVB-T DUO / MSI TV@nywhere Duo [5168:0306,4E42:0306]
57 56 -> Avermedia AVerTV 307 [1461:a70a] 57 56 -> Avermedia AVerTV 307 [1461:a70a]
58 57 -> Avermedia AVerTV GO 007 FM [1461:f31f] 58 57 -> Avermedia AVerTV GO 007 FM [1461:f31f]
59 58 -> ADS Tech Instant TV (saa7135) [1421:0350,1421:0351,1421:0370,1421:1370] 59 58 -> ADS Tech Instant TV (saa7135) [1421:0350,1421:0351,1421:0370,1421:1370]
@@ -76,7 +76,7 @@
76 75 -> AVerMedia AVerTVHD MCE A180 [1461:1044] 76 75 -> AVerMedia AVerTVHD MCE A180 [1461:1044]
77 76 -> SKNet MonsterTV Mobile [1131:4ee9] 77 76 -> SKNet MonsterTV Mobile [1131:4ee9]
78 77 -> Pinnacle PCTV 40i/50i/110i (saa7133) [11bd:002e] 78 77 -> Pinnacle PCTV 40i/50i/110i (saa7133) [11bd:002e]
79 78 -> ASUSTeK P7131 Dual [1043:4862,1043:4876] 79 78 -> ASUSTeK P7131 Dual [1043:4862,1043:4857]
80 79 -> Sedna/MuchTV PC TV Cardbus TV/Radio (ITO25 Rev:2B) 80 79 -> Sedna/MuchTV PC TV Cardbus TV/Radio (ITO25 Rev:2B)
81 80 -> ASUS Digimatrix TV [1043:0210] 81 80 -> ASUS Digimatrix TV [1043:0210]
82 81 -> Philips Tiger reference design [1131:2018] 82 81 -> Philips Tiger reference design [1131:2018]
@@ -107,3 +107,7 @@
107106 -> Encore ENLTV [1131:2342,1131:2341,3016:2344] 107106 -> Encore ENLTV [1131:2342,1131:2341,3016:2344]
108107 -> Encore ENLTV-FM [1131:230f] 108107 -> Encore ENLTV-FM [1131:230f]
109108 -> Terratec Cinergy HT PCI [153b:1175] 109108 -> Terratec Cinergy HT PCI [153b:1175]
110109 -> Philips Tiger - S Reference design
111110 -> Avermedia M102 [1461:f31e]
112111 -> ASUS P7131 4871 [1043:4871]
113112 -> ASUSTeK P7131 Hybrid [1043:4876]
diff --git a/Documentation/video4linux/CARDLIST.usbvision b/Documentation/video4linux/CARDLIST.usbvision
new file mode 100644
index 000000000000..3d6850ef0245
--- /dev/null
+++ b/Documentation/video4linux/CARDLIST.usbvision
@@ -0,0 +1,64 @@
1 0 -> Xanboo [0a6f:0400]
2 1 -> Belkin USB VideoBus II Adapter [050d:0106]
3 2 -> Belkin Components USB VideoBus [050d:0207]
4 3 -> Belkin USB VideoBus II [050d:0208]
5 4 -> echoFX InterView Lite [0571:0002]
6 5 -> USBGear USBG-V1 resp. HAMA USB [0573:0003]
7 6 -> D-Link V100 [0573:0400]
8 7 -> X10 USB Camera [0573:2000]
9 8 -> Hauppauge WinTV USB Live (PAL B/G) [0573:2d00]
10 9 -> Hauppauge WinTV USB Live Pro (NTSC M/N) [0573:2d01]
11 10 -> Zoran Co. PMD (Nogatech) AV-grabber Manhattan [0573:2101]
12 11 -> Nogatech USB-TV (NTSC) FM [0573:4100]
13 12 -> PNY USB-TV (NTSC) FM [0573:4110]
14 13 -> PixelView PlayTv-USB PRO (PAL) FM [0573:4450]
15 14 -> ZTV ZT-721 2.4GHz USB A/V Receiver [0573:4550]
16 15 -> Hauppauge WinTV USB (NTSC M/N) [0573:4d00]
17 16 -> Hauppauge WinTV USB (PAL B/G) [0573:4d01]
18 17 -> Hauppauge WinTV USB (PAL I) [0573:4d02]
19 18 -> Hauppauge WinTV USB (PAL/SECAM L) [0573:4d03]
20 19 -> Hauppauge WinTV USB (PAL D/K) [0573:4d04]
21 20 -> Hauppauge WinTV USB (NTSC FM) [0573:4d10]
22 21 -> Hauppauge WinTV USB (PAL B/G FM) [0573:4d11]
23 22 -> Hauppauge WinTV USB (PAL I FM) [0573:4d12]
24 23 -> Hauppauge WinTV USB (PAL D/K FM) [0573:4d14]
25 24 -> Hauppauge WinTV USB Pro (NTSC M/N) [0573:4d2a]
26 25 -> Hauppauge WinTV USB Pro (NTSC M/N) V2 [0573:4d2b]
27 26 -> Hauppauge WinTV USB Pro (PAL/SECAM B/G/I/D/K/L) [0573:4d2c]
28 27 -> Hauppauge WinTV USB Pro (NTSC M/N) V3 [0573:4d20]
29 28 -> Hauppauge WinTV USB Pro (PAL B/G) [0573:4d21]
30 29 -> Hauppauge WinTV USB Pro (PAL I) [0573:4d22]
31 30 -> Hauppauge WinTV USB Pro (PAL/SECAM L) [0573:4d23]
32 31 -> Hauppauge WinTV USB Pro (PAL D/K) [0573:4d24]
33 32 -> Hauppauge WinTV USB Pro (PAL/SECAM BGDK/I/L) [0573:4d25]
34 33 -> Hauppauge WinTV USB Pro (PAL/SECAM BGDK/I/L) V2 [0573:4d26]
35 34 -> Hauppauge WinTV USB Pro (PAL B/G) V2 [0573:4d27]
36 35 -> Hauppauge WinTV USB Pro (PAL B/G,D/K) [0573:4d28]
37 36 -> Hauppauge WinTV USB Pro (PAL I,D/K) [0573:4d29]
38 37 -> Hauppauge WinTV USB Pro (NTSC M/N FM) [0573:4d30]
39 38 -> Hauppauge WinTV USB Pro (PAL B/G FM) [0573:4d31]
40 39 -> Hauppauge WinTV USB Pro (PAL I FM) [0573:4d32]
41 40 -> Hauppauge WinTV USB Pro (PAL D/K FM) [0573:4d34]
42 41 -> Hauppauge WinTV USB Pro (Temic PAL/SECAM B/G/I/D/K/L FM) [0573:4d35]
43 42 -> Hauppauge WinTV USB Pro (Temic PAL B/G FM) [0573:4d36]
44 43 -> Hauppauge WinTV USB Pro (PAL/SECAM B/G/I/D/K/L FM) [0573:4d37]
45 44 -> Hauppauge WinTV USB Pro (NTSC M/N FM) V2 [0573:4d38]
46 45 -> Camtel Technology USB TV Genie Pro FM Model TVB330 [0768:0006]
47 46 -> Digital Video Creator I [07d0:0001]
48 47 -> Global Village GV-007 (NTSC) [07d0:0002]
49 48 -> Dazzle Fusion Model DVC-50 Rev 1 (NTSC) [07d0:0003]
50 49 -> Dazzle Fusion Model DVC-80 Rev 1 (PAL) [07d0:0004]
51 50 -> Dazzle Fusion Model DVC-90 Rev 1 (SECAM) [07d0:0005]
52 51 -> Eskape Labs MyTV2Go [07f8:9104]
53 52 -> Pinnacle Studio PCTV USB (PAL) [2304:010d]
54 53 -> Pinnacle Studio PCTV USB (SECAM) [2304:0109]
55 54 -> Pinnacle Studio PCTV USB (PAL) FM [2304:0110]
56 55 -> Miro PCTV USB [2304:0111]
57 56 -> Pinnacle Studio PCTV USB (NTSC) FM [2304:0112]
58 57 -> Pinnacle Studio PCTV USB (PAL) FM V2 [2304:0210]
59 58 -> Pinnacle Studio PCTV USB (NTSC) FM V2 [2304:0212]
60 59 -> Pinnacle Studio PCTV USB (PAL) FM V3 [2304:0214]
61 60 -> Pinnacle Studio Linx Video input cable (NTSC) [2304:0300]
62 61 -> Pinnacle Studio Linx Video input cable (PAL) [2304:0301]
63 62 -> Pinnacle PCTV Bungee USB (PAL) FM [2304:0419]
64 63 -> Hauppauge WinTv-USB [2400:4200]
diff --git a/Documentation/video4linux/README.ivtv b/Documentation/video4linux/README.ivtv
new file mode 100644
index 000000000000..73df22c40bfe
--- /dev/null
+++ b/Documentation/video4linux/README.ivtv
@@ -0,0 +1,187 @@
1
2ivtv release notes
3==================
4
5This is a v4l2 device driver for the Conexant cx23415/6 MPEG encoder/decoder.
6The cx23415 can do both encoding and decoding, the cx23416 can only do MPEG
7encoding. Currently the only card featuring full decoding support is the
8Hauppauge PVR-350.
9
10NOTE: this driver requires the latest encoder firmware (version 2.06.039, size
11376836 bytes). Get the firmware from here:
12
13http://dl.ivtvdriver.org/ivtv/firmware/firmware.tar.gz
14
15NOTE: 'normal' TV applications do not work with this driver, you need
16an application that can handle MPEG input such as mplayer, xine, MythTV,
17etc.
18
19The primary goal of the IVTV project is to provide a "clean room" Linux
20Open Source driver implementation for video capture cards based on the
21iCompression iTVC15 or Conexant CX23415/CX23416 MPEG Codec.
22
23Features:
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
34Additional 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) (this framebuffer is not yet part of the kernel. In the meantime it
40 is available from www.ivtvdriver.org).
41 * Supports raw YUV output.
42
43IMPORTANT: In case of problems first read this page:
44 http://www.ivtvdriver.org/index.php/Troubleshooting
45
46See also:
47
48Homepage + Wiki
49http://www.ivtvdriver.org
50
51IRC
52irc://irc.freenode.net/ivtv-dev
53
54----------------------------------------------------------
55
56Devices
57=======
58
59A maximum of 12 ivtv boards are allowed at the moment.
60
61Cards that don't have a video output capability (i.e. non PVR350 cards)
62lack the vbi8, vbi16, video16 and video48 devices. They also do not
63support the framebuffer device /dev/fbx for OSD.
64
65The radio0 device may or may not be present, depending on whether the
66card has a radio tuner or not.
67
68Here is a list of the base v4l devices:
69crw-rw---- 1 root video 81, 0 Jun 19 22:22 /dev/video0
70crw-rw---- 1 root video 81, 16 Jun 19 22:22 /dev/video16
71crw-rw---- 1 root video 81, 24 Jun 19 22:22 /dev/video24
72crw-rw---- 1 root video 81, 32 Jun 19 22:22 /dev/video32
73crw-rw---- 1 root video 81, 48 Jun 19 22:22 /dev/video48
74crw-rw---- 1 root video 81, 64 Jun 19 22:22 /dev/radio0
75crw-rw---- 1 root video 81, 224 Jun 19 22:22 /dev/vbi0
76crw-rw---- 1 root video 81, 228 Jun 19 22:22 /dev/vbi8
77crw-rw---- 1 root video 81, 232 Jun 19 22:22 /dev/vbi16
78
79Base devices
80============
81
82For every extra card you have the numbers increased by one. For example,
83/dev/video0 is listed as the 'base' encoding capture device so we have:
84
85 /dev/video0 is the encoding capture device for the first card (card 0)
86 /dev/video1 is the encoding capture device for the second card (card 1)
87 /dev/video2 is the encoding capture device for the third card (card 2)
88
89Note that if the first card doesn't have a feature (eg no decoder, so no
90video16, the second card will still use video17. The simple rule is 'add
91the card number to the base device number'. If you have other capture
92cards (e.g. WinTV PCI) that are detected first, then you have to tell
93the ivtv module about it so that it will start counting at 1 (or 2, or
94whatever). Otherwise the device numbers can get confusing. The ivtv
95'ivtv_first_minor' module option can be used for that.
96
97
98/dev/video0
99The encoding capture device(s).
100Read-only.
101
102Reading from this device gets you the MPEG1/2 program stream.
103Example:
104
105cat /dev/video0 > my.mpg (you need to hit ctrl-c to exit)
106
107
108/dev/video16
109The decoder output device(s)
110Write-only. Only present if the MPEG decoder (i.e. CX23415) exists.
111
112An mpeg2 stream sent to this device will appear on the selected video
113display, audio will appear on the line-out/audio out. It is only
114available for cards that support video out. Example:
115
116cat my.mpg >/dev/video16
117
118
119/dev/video24
120The raw audio capture device(s).
121Read-only
122
123The raw audio PCM stereo stream from the currently selected
124tuner or audio line-in. Reading from this device results in a raw
125(signed 16 bit Little Endian, 48000 Hz, stereo pcm) capture.
126This device only captures audio. This should be replaced by an ALSA
127device in the future.
128Note that there is no corresponding raw audio output device, this is
129not supported in the decoder firmware.
130
131
132/dev/video32
133The raw video capture device(s)
134Read-only
135
136The raw YUV video output from the current video input. The YUV format
137is non-standard (V4L2_PIX_FMT_HM12).
138
139Note that the YUV and PCM streams are not synchronized, so they are of
140limited use.
141
142
143/dev/video48
144The raw video display device(s)
145Write-only. Only present if the MPEG decoder (i.e. CX23415) exists.
146
147Writes a YUV stream to the decoder of the card.
148
149
150/dev/radio0
151The radio tuner device(s)
152Cannot be read or written.
153
154Used to enable the radio tuner and tune to a frequency. You cannot
155read or write audio streams with this device. Once you use this
156device to tune the radio, use /dev/video24 to read the raw pcm stream
157or /dev/video0 to get an mpeg2 stream with black video.
158
159
160/dev/vbi0
161The 'vertical blank interval' (Teletext, CC, WSS etc) capture device(s)
162Read-only
163
164Captures the raw (or sliced) video data sent during the Vertical Blank
165Interval. This data is used to encode teletext, closed captions, VPS,
166widescreen signalling, electronic program guide information, and other
167services.
168
169
170/dev/vbi8
171Processed vbi feedback device(s)
172Read-only. Only present if the MPEG decoder (i.e. CX23415) exists.
173
174The sliced VBI data embedded in an MPEG stream is reproduced on this
175device. So while playing back a recording on /dev/video16, you can
176read the embedded VBI data from /dev/vbi8.
177
178
179/dev/vbi16
180The vbi 'display' device(s)
181Write-only. Only present if the MPEG decoder (i.e. CX23415) exists.
182
183Can be used to send sliced VBI data to the video-out connector.
184
185---------------------------------
186
187Hans Verkuil <hverkuil@xs4all.nl>
diff --git a/Documentation/video4linux/cx2341x/fw-decoder-regs.txt b/Documentation/video4linux/cx2341x/fw-decoder-regs.txt
index db2366c634e8..cf52c8f20b9e 100644
--- a/Documentation/video4linux/cx2341x/fw-decoder-regs.txt
+++ b/Documentation/video4linux/cx2341x/fw-decoder-regs.txt
@@ -624,11 +624,11 @@ out what values are bad when it hangs.
6242A00 6242A00
625 bits 0:2 625 bits 0:2
626 osd colour mode 626 osd colour mode
627 000 = 8 bit indexed
627 001 = 16 bit (565) 628 001 = 16 bit (565)
628 010 = 15 bit (555) 629 010 = 15 bit (555)
629 011 = 12 bit (444) 630 011 = 12 bit (444)
630 100 = 32 bit (8888) 631 100 = 32 bit (8888)
631 101 = 8 bit indexed
632 632
633 bits 4:5 633 bits 4:5
634 osd display bpp 634 osd display bpp
@@ -676,9 +676,11 @@ out what values are bad when it hangs.
676 completely transparent. When using 565, 555 or 444 colour modes, the 676 completely transparent. When using 565, 555 or 444 colour modes, the
677 colour key is always 16 bits wide. The colour to key on is set in Reg 2A18. 677 colour key is always 16 bits wide. The colour to key on is set in Reg 2A18.
678 678
679 Local alpha is a per-pixel 256 step transparency, with 0 being transparent 679 Local alpha works differently depending on the colour mode. For 32bpp & 8
680 and 255 being solid. This is only available in 32 bit & 8 bit indexed 680 bit indexed, local alpha is a per-pixel 256 step transparency, with 0 being
681 colour modes. 681 transparent and 255 being solid. For the 16bpp modes 555 & 444, the unused
682 bit(s) act as a simple transparency switch, with 0 being solid & 1 being
683 fully transparent. There is no local alpha support for 16bit 565.
682 684
683 Global alpha is a 256 step transparency that applies to the entire osd, 685 Global alpha is a 256 step transparency that applies to the entire osd,
684 with 0 being transparent & 255 being solid. 686 with 0 being transparent & 255 being solid.
@@ -811,5 +813,5 @@ out what values are bad when it hangs.
811 813
812-------------------------------------------------------------------------------- 814--------------------------------------------------------------------------------
813 815
814v0.3 - 2 February 2007 - Ian Armstrong (ian@iarmst.demon.co.uk) 816v0.4 - 12 March 2007 - Ian Armstrong (ian@iarmst.demon.co.uk)
815 817
diff --git a/Documentation/video4linux/cx2341x/fw-encoder-api.txt b/Documentation/video4linux/cx2341x/fw-encoder-api.txt
index 242104ce5b61..5dd3109a8b3f 100644
--- a/Documentation/video4linux/cx2341x/fw-encoder-api.txt
+++ b/Documentation/video4linux/cx2341x/fw-encoder-api.txt
@@ -663,12 +663,13 @@ Param[0]
663 663
664------------------------------------------------------------------------------- 664-------------------------------------------------------------------------------
665 665
666Name CX2341X_ENC_UNKNOWN 666Name CX2341X_ENC_SET_VERT_CROP_LINE
667Enum 219/0xDB 667Enum 219/0xDB
668Description 668Description
669 Unknown API, it's used by Hauppauge though. 669 Something to do with 'Vertical Crop Line'
670Param[0] 670Param[0]
671 0 This is the value Hauppauge uses, Unknown what it means. 671 If saa7114 and raw VBI capture and 60 Hz, then set to 10001.
672 Else 0.
672 673
673------------------------------------------------------------------------------- 674-------------------------------------------------------------------------------
674 675
@@ -682,11 +683,9 @@ Param[0]
682 Command number: 683 Command number:
683 1=set initial SCR value when starting encoding (works). 684 1=set initial SCR value when starting encoding (works).
684 2=set quality mode (apparently some test setting). 685 2=set quality mode (apparently some test setting).
685 3=setup advanced VIM protection handling (supposedly only for the cx23416 686 3=setup advanced VIM protection handling.
686 for raw YUV). 687 Always 1 for the cx23416 and 0 for cx23415.
687 Actually it looks like this should be 0 for saa7114/5 based card and 1 688 4=generate DVD compatible PTS timestamps
688 for cx25840 based cards.
689 4=generate artificial PTS timestamps
690 5=USB flush mode 689 5=USB flush mode
691 6=something to do with the quantization matrix 690 6=something to do with the quantization matrix
692 7=set navigation pack insertion for DVD: adds 0xbf (private stream 2) 691 7=set navigation pack insertion for DVD: adds 0xbf (private stream 2)
@@ -698,7 +697,9 @@ Param[0]
698 9=set history parameters of the video input module 697 9=set history parameters of the video input module
699 10=set input field order of VIM 698 10=set input field order of VIM
700 11=set quantization matrix 699 11=set quantization matrix
701 12=reset audio interface 700 12=reset audio interface after channel change or input switch (has no argument).
701 Needed for the cx2584x, not needed for the mspx4xx, but it doesn't seem to
702 do any harm calling it regardless.
702 13=set audio volume delay 703 13=set audio volume delay
703 14=set audio delay 704 14=set audio delay
704 705
diff --git a/Documentation/video4linux/cx2341x/fw-osd-api.txt b/Documentation/video4linux/cx2341x/fw-osd-api.txt
index 0a602f3e601b..89c4601042c1 100644
--- a/Documentation/video4linux/cx2341x/fw-osd-api.txt
+++ b/Documentation/video4linux/cx2341x/fw-osd-api.txt
@@ -21,7 +21,11 @@ Enum 66/0x42
21Description 21Description
22 Query OSD format 22 Query OSD format
23Result[0] 23Result[0]
24 0=8bit index, 4=AlphaRGB 8:8:8:8 24 0=8bit index
25 1=16bit RGB 5:6:5
26 2=16bit ARGB 1:5:5:5
27 3=16bit ARGB 1:4:4:4
28 4=32bit ARGB 8:8:8:8
25 29
26------------------------------------------------------------------------------- 30-------------------------------------------------------------------------------
27 31
@@ -30,7 +34,11 @@ Enum 67/0x43
30Description 34Description
31 Assign pixel format 35 Assign pixel format
32Param[0] 36Param[0]
33 0=8bit index, 4=AlphaRGB 8:8:8:8 37 0=8bit index
38 1=16bit RGB 5:6:5
39 2=16bit ARGB 1:5:5:5
40 3=16bit ARGB 1:4:4:4
41 4=32bit ARGB 8:8:8:8
34 42
35------------------------------------------------------------------------------- 43-------------------------------------------------------------------------------
36 44
diff --git a/Documentation/video4linux/sn9c102.txt b/Documentation/video4linux/sn9c102.txt
index 2913da3d0878..5fe0ad7dfc20 100644
--- a/Documentation/video4linux/sn9c102.txt
+++ b/Documentation/video4linux/sn9c102.txt
@@ -25,7 +25,7 @@ Index
25 25
261. Copyright 261. Copyright
27============ 27============
28Copyright (C) 2004-2006 by Luca Risolia <luca.risolia@studio.unibo.it> 28Copyright (C) 2004-2007 by Luca Risolia <luca.risolia@studio.unibo.it>
29 29
30 30
312. Disclaimer 312. Disclaimer
@@ -216,10 +216,10 @@ Description: Debugging information level, from 0 to 3:
216 1 = critical errors 216 1 = critical errors
217 2 = significant informations 217 2 = significant informations
218 3 = more verbose messages 218 3 = more verbose messages
219 Level 3 is useful for testing only, when only one device 219 Level 3 is useful for testing only. It also shows some more
220 is used. It also shows some more informations about the 220 informations about the hardware being detected.
221 hardware being detected. This parameter can be changed at 221 This parameter can be changed at runtime thanks to the /sys
222 runtime thanks to the /sys filesystem interface. 222 filesystem interface.
223Default: 2 223Default: 2
224------------------------------------------------------------------------------- 224-------------------------------------------------------------------------------
225 225
@@ -235,7 +235,7 @@ created in the /sys/class/video4linux/videoX directory. You can set the green
235channel's gain by writing the desired value to it. The value may range from 0 235channel's gain by writing the desired value to it. The value may range from 0
236to 15 for the SN9C101 or SN9C102 bridges, from 0 to 127 for the SN9C103, 236to 15 for the SN9C101 or SN9C102 bridges, from 0 to 127 for the SN9C103,
237SN9C105 and SN9C120 bridges. 237SN9C105 and SN9C120 bridges.
238Similarly, only for the SN9C103, SN9C105 and SN9120 controllers, blue and red 238Similarly, only for the SN9C103, SN9C105 and SN9C120 controllers, blue and red
239gain control files are available in the same directory, for which accepted 239gain control files are available in the same directory, for which accepted
240values may range from 0 to 127. 240values may range from 0 to 127.
241 241
@@ -402,38 +402,49 @@ Vendor ID Product ID
4020x0c45 0x60bc 4020x0c45 0x60bc
4030x0c45 0x60be 4030x0c45 0x60be
4040x0c45 0x60c0 4040x0c45 0x60c0
4050x0c45 0x60c2
4050x0c45 0x60c8 4060x0c45 0x60c8
4060x0c45 0x60cc 4070x0c45 0x60cc
4070x0c45 0x60ea 4080x0c45 0x60ea
4080x0c45 0x60ec 4090x0c45 0x60ec
4100x0c45 0x60ef
4090x0c45 0x60fa 4110x0c45 0x60fa
4100x0c45 0x60fb 4120x0c45 0x60fb
4110x0c45 0x60fc 4130x0c45 0x60fc
4120x0c45 0x60fe 4140x0c45 0x60fe
4150x0c45 0x6102
4160x0c45 0x6108
4170x0c45 0x610f
4130x0c45 0x6130 4180x0c45 0x6130
4190x0c45 0x6138
4140x0c45 0x613a 4200x0c45 0x613a
4150x0c45 0x613b 4210x0c45 0x613b
4160x0c45 0x613c 4220x0c45 0x613c
4170x0c45 0x613e 4230x0c45 0x613e
418 424
419The list above does not imply that all those devices work with this driver: up 425The list above does not imply that all those devices work with this driver: up
420until now only the ones that assemble the following image sensors are 426until now only the ones that assemble the following pairs of SN9C1xx bridges
421supported; kernel messages will always tell you whether this is the case (see 427and image sensors are supported; kernel messages will always tell you whether
422"Module loading" paragraph): 428this is the case (see "Module loading" paragraph):
423 429
424Model Manufacturer 430Image sensor / SN9C1xx bridge | SN9C10[12] SN9C103 SN9C105 SN9C120
425----- ------------ 431-------------------------------------------------------------------------------
426HV7131D Hynix Semiconductor, Inc. 432HV7131D Hynix Semiconductor | Yes No No No
427MI-0343 Micron Technology, Inc. 433HV7131R Hynix Semiconductor | No Yes Yes Yes
428OV7630 OmniVision Technologies, Inc. 434MI-0343 Micron Technology | Yes No No No
429OV7660 OmniVision Technologies, Inc. 435MI-0360 Micron Technology | No Yes No No
430PAS106B PixArt Imaging, Inc. 436OV7630 OmniVision Technologies | Yes Yes No No
431PAS202BCA PixArt Imaging, Inc. 437OV7660 OmniVision Technologies | No No Yes Yes
432PAS202BCB PixArt Imaging, Inc. 438PAS106B PixArt Imaging | Yes No No No
433TAS5110C1B Taiwan Advanced Sensor Corporation 439PAS202B PixArt Imaging | Yes Yes No No
434TAS5130D1B Taiwan Advanced Sensor Corporation 440TAS5110C1B Taiwan Advanced Sensor | Yes No No No
435 441TAS5110D Taiwan Advanced Sensor | Yes No No No
436Some of the available control settings of each image sensor are supported 442TAS5130D1B Taiwan Advanced Sensor | Yes No No No
443
444"Yes" means that the pair is supported by the driver, while "No" means that the
445pair does not exist or is not supported by the driver.
446
447Only some of the available control settings of each image sensor are supported
437through the V4L2 interface. 448through the V4L2 interface.
438 449
439Donations of new models for further testing and support would be much 450Donations of new models for further testing and support would be much
@@ -482,8 +493,8 @@ The SN9C1xx PC Camera Controllers can send images in two possible video
482formats over the USB: either native "Sequential RGB Bayer" or compressed. 493formats over the USB: either native "Sequential RGB Bayer" or compressed.
483The compression is used to achieve high frame rates. With regard to the 494The compression is used to achieve high frame rates. With regard to the
484SN9C101, SN9C102 and SN9C103, the compression is based on the Huffman encoding 495SN9C101, SN9C102 and SN9C103, the compression is based on the Huffman encoding
485algorithm described below, while the SN9C105 and SN9C120 the compression is 496algorithm described below, while with regard to the SN9C105 and SN9C120 the
486based on the JPEG standard. 497compression is based on the JPEG standard.
487The current video format may be selected or queried from the user application 498The current video format may be selected or queried from the user application
488by calling the VIDIOC_S_FMT or VIDIOC_G_FMT ioctl's, as described in the V4L2 499by calling the VIDIOC_S_FMT or VIDIOC_G_FMT ioctl's, as described in the V4L2
489API specifications. 500API specifications.
@@ -573,4 +584,5 @@ order):
573- Mizuno Takafumi for the donation of a webcam; 584- Mizuno Takafumi for the donation of a webcam;
574- an "anonymous" donator (who didn't want his name to be revealed) for the 585- an "anonymous" donator (who didn't want his name to be revealed) for the
575 donation of a webcam. 586 donation of a webcam.
576- an anonymous donator for the donation of four webcams. 587- an anonymous donator for the donation of four webcams and two boards with ten
588 image sensors.
diff --git a/Documentation/video4linux/zr364xx.txt b/Documentation/video4linux/zr364xx.txt
new file mode 100644
index 000000000000..c76992d0ff4d
--- /dev/null
+++ b/Documentation/video4linux/zr364xx.txt
@@ -0,0 +1,65 @@
1Zoran 364xx based USB webcam module version 0.72
2site: http://royale.zerezo.com/zr364xx/
3mail: royale@zerezo.com
4
5introduction:
6This brings support under Linux for the Aiptek PocketDV 3300 in webcam mode.
7If you just want to get on your PC the pictures and movies on the camera, you should use the usb-storage module instead.
8The driver works with several other cameras in webcam mode (see the list below).
9Maybe this code can work for other JPEG/USB cams based on the Coach chips from Zoran?
10Possible chipsets are : ZR36430 (ZR36430BGC) and maybe ZR36431, ZR36440, ZR36442...
11You can try the experience changing the vendor/product ID values (look at the source code).
12You can get these values by looking at /var/log/messages when you plug your camera, or by typing : cat /proc/bus/usb/devices.
13If you manage to use your cam with this code, you can send me a mail (royale@zerezo.com) with the name of your cam and a patch if needed.
14This is a beta release of the driver.
15Since version 0.70, this driver is only compatible with V4L2 API and 2.6.x kernels.
16If you need V4L1 or 2.4x kernels support, please use an older version, but the code is not maintained anymore.
17Good luck!
18
19install:
20In order to use this driver, you must compile it with your kernel.
21Location: Device Drivers -> Multimedia devices -> Video For Linux -> Video Capture Adapters -> V4L USB devices
22
23usage:
24modprobe zr364xx debug=X mode=Y
25 - debug : set to 1 to enable verbose debug messages
26 - mode : 0 = 320x240, 1 = 160x120, 2 = 640x480
27You can then use the camera with V4L2 compatible applications, for example Ekiga.
28To capture a single image, try this: dd if=/dev/video0 of=test.jpg bs=1 count=1
29
30links :
31http://mxhaard.free.fr/ (support for many others cams including some Aiptek PocketDV)
32http://www.harmwal.nl/pccam880/ (this project also supports cameras based on this chipset)
33
34supported devices:
35------ ------- ----------- -----
36Vendor Product Distributor Model
37------ ------- ----------- -----
380x08ca 0x0109 Aiptek PocketDV 3300
390x08ca 0x0109 Maxell Maxcam PRO DV3
400x041e 0x4024 Creative PC-CAM 880
410x0d64 0x0108 Aiptek Fidelity 3200
420x0d64 0x0108 Praktica DCZ 1.3 S
430x0d64 0x0108 Genius Digital Camera (?)
440x0d64 0x0108 DXG Technology Fashion Cam
450x0546 0x3187 Polaroid iON 230
460x0d64 0x3108 Praktica Exakta DC 2200
470x0d64 0x3108 Genius G-Shot D211
480x0595 0x4343 Concord Eye-Q Duo 1300
490x0595 0x4343 Concord Eye-Q Duo 2000
500x0595 0x4343 Fujifilm EX-10
510x0595 0x4343 Ricoh RDC-6000
520x0595 0x4343 Digitrex DSC 1300
530x0595 0x4343 Firstline FDC 2000
540x0bb0 0x500d Concord EyeQ Go Wireless
550x0feb 0x2004 CRS Electronic 3.3 Digital Camera
560x0feb 0x2004 Packard Bell DSC-300
570x055f 0xb500 Mustek MDC 3000
580x08ca 0x2062 Aiptek PocketDV 5700
590x052b 0x1a18 Chiphead Megapix V12
600x04c8 0x0729 Konica Revio 2
610x04f2 0xa208 Creative PC-CAM 850
620x0784 0x0040 Traveler Slimline X5
630x06d6 0x0034 Trust Powerc@m 750
640x0a17 0x0062 Pentax Optio 50L
65