Merge commit '81fd23e2b3ccf71c807e671444e8accaba98ca53' of https://git.pengutronix...
[linux-2.6-microblaze.git] / Documentation / admin-guide / media / saa7134.rst
1 .. SPDX-License-Identifier: GPL-2.0
2
3 The saa7134 driver
4 ==================
5
6 Author Gerd Hoffmann
7
8
9 This is a v4l2/oss device driver for saa7130/33/34/35 based capture / TV
10 boards.
11
12
13 Status
14 ------
15
16 Almost everything is working.  video, sound, tuner, radio, mpeg ts, ...
17
18 As with bttv, card-specific tweaks are needed.  Check CARDLIST for a
19 list of known TV cards and saa7134-cards.c for the drivers card
20 configuration info.
21
22
23 Build
24 -----
25
26 Once you pick up a Kernel source, you should configure, build,
27 install and boot the new kernel.  You'll need at least
28 these config options::
29
30     ./scripts/config -e PCI
31     ./scripts/config -e INPUT
32     ./scripts/config -m I2C
33     ./scripts/config -m MEDIA_SUPPORT
34     ./scripts/config -e MEDIA_PCI_SUPPORT
35     ./scripts/config -e MEDIA_ANALOG_TV_SUPPORT
36     ./scripts/config -e MEDIA_DIGITAL_TV_SUPPORT
37     ./scripts/config -e MEDIA_RADIO_SUPPORT
38     ./scripts/config -e RC_CORE
39     ./scripts/config -e MEDIA_SUBDRV_AUTOSELECT
40     ./scripts/config -m VIDEO_SAA7134
41     ./scripts/config -e SAA7134_ALSA
42     ./scripts/config -e VIDEO_SAA7134_RC
43     ./scripts/config -e VIDEO_SAA7134_DVB
44     ./scripts/config -e VIDEO_SAA7134_GO7007
45
46 To build and install, you should run::
47
48     make && make modules_install && make install
49
50 Once the new Kernel is booted, saa7134 driver should be loaded automatically.
51
52 Depending on the card you might have to pass ``card=<nr>`` as insmod option.
53 If so, please check Documentation/admin-guide/media/saa7134-cardlist.rst
54 for valid choices.
55
56 Once you have your card type number, you can pass a modules configuration
57 via a file (usually, it is either ``/etc/modules.conf`` or some file at
58 ``/etc/modules-load.d/``, but the actual place depends on your
59 distribution), with this content::
60
61     options saa7134 card=13 # Assuming that your card type is #13
62
63
64 Changes / Fixes
65 ---------------
66
67 Please mail to linux-media AT vger.kernel.org unified diffs against
68 the linux media git tree:
69
70     https://git.linuxtv.org/media_tree.git/
71
72 This is done by committing a patch at a clone of the git tree and
73 submitting the patch using ``git send-email``. Don't forget to
74 describe at the lots  what it changes / which problem it fixes / whatever
75 it is good for ...
76
77
78 Known Problems
79 --------------
80
81 * The tuner for the flyvideos isn't detected automatically and the
82   default might not work for you depending on which version you have.
83   There is a ``tuner=`` insmod option to override the driver's default.
84
85 Credits
86 -------
87
88 andrew.stevens@philips.com + werner.leeb@philips.com for providing
89 saa7134 hardware specs and sample board.