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