Merge branch 'master'
[pandora-kernel.git] / Documentation / video4linux / README.saa7134
1
2
3 What is it?
4 ===========
5
6 This is a v4l2/oss device driver for saa7130/33/34/35 based capture / TV
7 boards.  See http://www.semiconductors.philips.com/pip/saa7134hl for a
8 description.
9
10
11 Status
12 ======
13
14 Almost everything is working.  video, sound, tuner, radio, mpeg ts, ...
15
16 As with bttv, card-specific tweaks are needed.  Check CARDLIST for a
17 list of known TV cards and saa7134-cards.c for the drivers card
18 configuration info.
19
20
21 Build
22 =====
23
24 Pick up videodev + v4l2 patches from http://bytesex.org/patches/.
25 Configure, build, install + boot the new kernel.  You'll need at least
26 these config options:
27
28         CONFIG_I2C=m
29         CONFIG_VIDEO_DEV=m
30
31 Type "make" to build the driver now.  "make install" installs the
32 driver.  "modprobe saa7134" should load it.  Depending on the card you
33 might have to pass card=<nr> as insmod option, check CARDLIST for
34 valid choices.
35
36
37 Changes / Fixes
38 ===============
39
40 Please mail me unified diffs ("diff -u") with your changes, and don't
41 forget to tell me what it changes / which problem it fixes / whatever
42 it is good for ...
43
44
45 Known Problems
46 ==============
47
48 * The tuner for the flyvideos isn't detected automatically and the
49   default might not work for you depending on which version you have.
50   There is a tuner= insmod option to override the driver's default.
51
52 Card Variations:
53 ================
54
55 Cards can use either of these two crystals (xtal):
56  - 32.11 MHz -> .audio_clock=0x187de7
57  - 24.576MHz -> .audio_clock=0x200000
58 (xtal * .audio_clock = 51539600)
59
60 Some details about 30/34/35:
61
62  - saa7130 - low-price chip, doesn't have mute, that is why all those
63  cards should have .mute field defined in their tuner structure.
64
65  - saa7134 - usual chip
66
67  - saa7133/35 - saa7135 is probably a marketing decision, since all those
68  chips identifies itself as 33 on pci.
69
70 Credits
71 =======
72
73 andrew.stevens@philips.com + werner.leeb@philips.com for providing
74 saa7134 hardware specs and sample board.
75
76
77 Have fun,
78
79   Gerd
80
81 --
82 Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]