x86/kprobes: Remove trampoline_handler() prototype
[sfrench/cifs-2.6.git] / Documentation / media / v4l-drivers / saa7134.rst
1 The saa7134 driver
2 ==================
3
4 Author Gerd Hoffmann
5
6
7 This is a v4l2/oss device driver for saa7130/33/34/35 based capture / TV
8 boards.  See http://www.semiconductors.philips.com/pip/saa7134hl for a
9 description.
10
11
12 Status
13 ------
14
15 Almost everything is working.  video, sound, tuner, radio, mpeg ts, ...
16
17 As with bttv, card-specific tweaks are needed.  Check CARDLIST for a
18 list of known TV cards and saa7134-cards.c for the drivers card
19 configuration info.
20
21
22 Build
23 -----
24
25 Pick up videodev + v4l2 patches from http://bytesex.org/patches/.
26 Configure, build, install + boot the new kernel.  You'll need at least
27 these config options:
28
29 .. code-block:: none
30
31         CONFIG_I2C=m
32         CONFIG_VIDEO_DEV=m
33
34 Type "make" to build the driver now.  "make install" installs the
35 driver.  "modprobe saa7134" should load it.  Depending on the card you
36 might have to pass card=<nr> as insmod option, check CARDLIST for
37 valid choices.
38
39
40 Changes / Fixes
41 ---------------
42
43 Please mail me unified diffs ("diff -u") with your changes, and don't
44 forget to tell me what it changes / which problem it fixes / whatever
45 it is good for ...
46
47
48 Known Problems
49 --------------
50
51 * The tuner for the flyvideos isn't detected automatically and the
52   default might not work for you depending on which version you have.
53   There is a tuner= insmod option to override the driver's default.
54
55 Card Variations:
56 ----------------
57
58 Cards can use either of these two crystals (xtal):
59
60 - 32.11 MHz -> .audio_clock=0x187de7
61 - 24.576MHz -> .audio_clock=0x200000 (xtal * .audio_clock = 51539600)
62
63 Some details about 30/34/35:
64
65 - saa7130 - low-price chip, doesn't have mute, that is why all those
66   cards should have .mute field defined in their tuner structure.
67
68 - saa7134 - usual chip
69
70 - saa7133/35 - saa7135 is probably a marketing decision, since all those
71   chips identifies itself as 33 on pci.
72
73 LifeView GPIOs
74 --------------
75
76 This section was authored by: Peter Missel <peter.missel@onlinehome.de>
77
78 - LifeView FlyTV Platinum FM (LR214WF)
79
80     - GP27    MDT2005 PB4 pin 10
81     - GP26    MDT2005 PB3 pin 9
82     - GP25    MDT2005 PB2 pin 8
83     - GP23    MDT2005 PB1 pin 7
84     - GP22    MDT2005 PB0 pin 6
85     - GP21    MDT2005 PB5 pin 11
86     - GP20    MDT2005 PB6 pin 12
87     - GP19    MDT2005 PB7 pin 13
88     - nc      MDT2005 PA3 pin 2
89     - Remote  MDT2005 PA2 pin 1
90     - GP18    MDT2005 PA1 pin 18
91     - nc      MDT2005 PA0 pin 17 strap low
92     - GP17    Strap "GP7"=High
93     - GP16    Strap "GP6"=High
94
95         - 0=Radio 1=TV
96         - Drives SA630D ENCH1 and HEF4052 A1 pinsto do FM radio through
97           SIF input
98
99     - GP15    nc
100     - GP14    nc
101     - GP13    nc
102     - GP12    Strap "GP5" = High
103     - GP11    Strap "GP4" = High
104     - GP10    Strap "GP3" = High
105     - GP09    Strap "GP2" = Low
106     - GP08    Strap "GP1" = Low
107     - GP07.00 nc
108
109 Credits
110 -------
111
112 andrew.stevens@philips.com + werner.leeb@philips.com for providing
113 saa7134 hardware specs and sample board.