Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

media: docs: saa7134.rst: update the documentation

There are several things here that are outdated, because this
document was written a long time ago.

Update them to reflect the current status of the driver and
the media subsystem.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>

+42 -15
+42 -15
Documentation/admin-guide/media/saa7134.rst
··· 7 7 8 8 9 9 This is a v4l2/oss device driver for saa7130/33/34/35 based capture / TV 10 - boards. See http://www.semiconductors.philips.com/pip/saa7134hl for a 11 - description. 10 + boards. 12 11 13 12 14 13 Status ··· 23 24 Build 24 25 ----- 25 26 26 - Pick up videodev + v4l2 patches from http://bytesex.org/patches/. 27 - Configure, build, install + boot the new kernel. You'll need at least 28 - these config options: 27 + Once you pick up a Kernel source, you should configure, build, 28 + install and boot the new kernel. You'll need at least 29 + these config options:: 29 30 30 - .. code-block:: none 31 + ./scripts/config -e PCI 32 + ./scripts/config -e INPUT 33 + ./scripts/config -m I2C 34 + ./scripts/config -m MEDIA_SUPPORT 35 + ./scripts/config -e MEDIA_PCI_SUPPORT 36 + ./scripts/config -e MEDIA_ANALOG_TV_SUPPORT 37 + ./scripts/config -e MEDIA_DIGITAL_TV_SUPPORT 38 + ./scripts/config -e MEDIA_RADIO_SUPPORT 39 + ./scripts/config -e RC_CORE 40 + ./scripts/config -e MEDIA_SUBDRV_AUTOSELECT 41 + ./scripts/config -m VIDEO_SAA7134 42 + ./scripts/config -e SAA7134_ALSA 43 + ./scripts/config -e VIDEO_SAA7134_RC 44 + ./scripts/config -e VIDEO_SAA7134_DVB 45 + ./scripts/config -e VIDEO_SAA7134_GO7007 31 46 32 - CONFIG_I2C=m 33 - CONFIG_VIDEO_DEV=m 47 + To build and install, you should run:: 34 48 35 - Type "make" to build the driver now. "make install" installs the 36 - driver. "modprobe saa7134" should load it. Depending on the card you 37 - might have to pass card=<nr> as insmod option, check CARDLIST for 38 - valid choices. 49 + make && make modules_install && make install 50 + 51 + Once the new Kernel is booted, saa7134 driver should be loaded automatically. 52 + 53 + Depending on the card you might have to pass ``card=<nr>`` as insmod option. 54 + If so, please check :doc:`saa7134-cardlist` 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 39 62 40 63 41 64 Changes / Fixes 42 65 --------------- 43 66 44 - Please mail me unified diffs ("diff -u") with your changes, and don't 45 - forget to tell me what it changes / which problem it fixes / whatever 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 46 75 it is good for ... 47 76 48 77 ··· 79 52 80 53 * The tuner for the flyvideos isn't detected automatically and the 81 54 default might not work for you depending on which version you have. 82 - There is a tuner= insmod option to override the driver's default. 55 + There is a ``tuner=`` insmod option to override the driver's default. 83 56 84 57 Credits 85 58 -------