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