blob: 7ab9c70b9abea6108082c99f46da2f9fa8b5e93e [file] [log] [blame]
Mauro Carvalho Chehabf2ac8ce2018-08-30 10:20:04 -04001.. SPDX-License-Identifier: GPL-2.0
2
Mauro Carvalho Chehabae9d2872016-07-17 19:26:43 -03003The saa7134 driver
4==================
Linus Torvalds1da177e2005-04-16 15:20:36 -07005
Mauro Carvalho Chehabae9d2872016-07-17 19:26:43 -03006Author Gerd Hoffmann
Linus Torvalds1da177e2005-04-16 15:20:36 -07007
Linus Torvalds1da177e2005-04-16 15:20:36 -07008
9This is a v4l2/oss device driver for saa7130/33/34/35 based capture / TV
Mauro Carvalho Chehab12bcf902020-03-10 13:10:17 +010010boards.
Linus Torvalds1da177e2005-04-16 15:20:36 -070011
12
13Status
Mauro Carvalho Chehabae9d2872016-07-17 19:26:43 -030014------
Linus Torvalds1da177e2005-04-16 15:20:36 -070015
16Almost everything is working. video, sound, tuner, radio, mpeg ts, ...
17
18As with bttv, card-specific tweaks are needed. Check CARDLIST for a
19list of known TV cards and saa7134-cards.c for the drivers card
20configuration info.
21
22
23Build
Mauro Carvalho Chehabae9d2872016-07-17 19:26:43 -030024-----
Linus Torvalds1da177e2005-04-16 15:20:36 -070025
Mauro Carvalho Chehab12bcf902020-03-10 13:10:17 +010026Once you pick up a Kernel source, you should configure, build,
27install and boot the new kernel. You'll need at least
28these config options::
Linus Torvalds1da177e2005-04-16 15:20:36 -070029
Mauro Carvalho Chehab12bcf902020-03-10 13:10:17 +010030 ./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
Mauro Carvalho Chehabae9d2872016-07-17 19:26:43 -030045
Mauro Carvalho Chehab12bcf902020-03-10 13:10:17 +010046To build and install, you should run::
Linus Torvalds1da177e2005-04-16 15:20:36 -070047
Mauro Carvalho Chehab12bcf902020-03-10 13:10:17 +010048 make && make modules_install && make install
49
50Once the new Kernel is booted, saa7134 driver should be loaded automatically.
51
52Depending on the card you might have to pass ``card=<nr>`` as insmod option.
53If so, please check :doc:`saa7134-cardlist` for valid choices.
54
55Once you have your card type number, you can pass a modules configuration
56via a file (usually, it is either ``/etc/modules.conf`` or some file at
57``/etc/modules-load.d/``, but the actual place depends on your
58distribution), with this content::
59
60 options saa7134 card=13 # Assuming that your card type is #13
Linus Torvalds1da177e2005-04-16 15:20:36 -070061
62
63Changes / Fixes
Mauro Carvalho Chehabae9d2872016-07-17 19:26:43 -030064---------------
Linus Torvalds1da177e2005-04-16 15:20:36 -070065
Mauro Carvalho Chehab12bcf902020-03-10 13:10:17 +010066Please mail to linux-media AT vger.kernel.org unified diffs against
67the linux media git tree:
68
69 https://git.linuxtv.org/media_tree.git/
70
71This is done by committing a patch at a clone of the git tree and
72submitting the patch using ``git send-email``. Don't forget to
73describe at the lots what it changes / which problem it fixes / whatever
Linus Torvalds1da177e2005-04-16 15:20:36 -070074it is good for ...
75
76
77Known Problems
Mauro Carvalho Chehabae9d2872016-07-17 19:26:43 -030078--------------
Linus Torvalds1da177e2005-04-16 15:20:36 -070079
80* The tuner for the flyvideos isn't detected automatically and the
81 default might not work for you depending on which version you have.
Mauro Carvalho Chehab12bcf902020-03-10 13:10:17 +010082 There is a ``tuner=`` insmod option to override the driver's default.
Linus Torvalds1da177e2005-04-16 15:20:36 -070083
Linus Torvalds1da177e2005-04-16 15:20:36 -070084Credits
Mauro Carvalho Chehabae9d2872016-07-17 19:26:43 -030085-------
Linus Torvalds1da177e2005-04-16 15:20:36 -070086
87andrew.stevens@philips.com + werner.leeb@philips.com for providing
88saa7134 hardware specs and sample board.