From ae9d2873a8aae5df64608228175fdf921c35786f Mon Sep 17 00:00:00 2001 From: Mauro Carvalho Chehab Date: Sun, 17 Jul 2016 19:26:43 -0300 Subject: [PATCH] [media] doc-rst: add documentation for saa7134 Convert it to ReST and add to the media/v4l-device book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/v4l-drivers/index.rst | 1 + Documentation/media/v4l-drivers/saa7134.rst | 43 +++++++++------------ 2 files changed, 20 insertions(+), 24 deletions(-) diff --git a/Documentation/media/v4l-drivers/index.rst b/Documentation/media/v4l-drivers/index.rst index 03d07f25c5fb..f761627d3fa1 100644 --- a/Documentation/media/v4l-drivers/index.rst +++ b/Documentation/media/v4l-drivers/index.rst @@ -33,4 +33,5 @@ License". pvrusb2 pxa_camera radiotrack + saa7134 zr364xx diff --git a/Documentation/media/v4l-drivers/saa7134.rst b/Documentation/media/v4l-drivers/saa7134.rst index b911f0871874..584caf8a3594 100644 --- a/Documentation/media/v4l-drivers/saa7134.rst +++ b/Documentation/media/v4l-drivers/saa7134.rst @@ -1,7 +1,8 @@ +The saa7134 driver +================== +Author Gerd Hoffmann -What is it? -=========== This is a v4l2/oss device driver for saa7130/33/34/35 based capture / TV boards. See http://www.semiconductors.philips.com/pip/saa7134hl for a @@ -9,7 +10,7 @@ description. Status -====== +------ Almost everything is working. video, sound, tuner, radio, mpeg ts, ... @@ -19,12 +20,14 @@ configuration info. Build -===== +----- Pick up videodev + v4l2 patches from http://bytesex.org/patches/. Configure, build, install + boot the new kernel. You'll need at least these config options: +.. code-block:: none + CONFIG_I2C=m CONFIG_VIDEO_DEV=m @@ -35,7 +38,7 @@ valid choices. Changes / Fixes -=============== +--------------- Please mail me unified diffs ("diff -u") with your changes, and don't forget to tell me what it changes / which problem it fixes / whatever @@ -43,40 +46,32 @@ it is good for ... Known Problems -============== +-------------- * The tuner for the flyvideos isn't detected automatically and the default might not work for you depending on which version you have. There is a tuner= insmod option to override the driver's default. Card Variations: -================ +---------------- Cards can use either of these two crystals (xtal): - - 32.11 MHz -> .audio_clock=0x187de7 - - 24.576MHz -> .audio_clock=0x200000 -(xtal * .audio_clock = 51539600) + +- 32.11 MHz -> .audio_clock=0x187de7 +- 24.576MHz -> .audio_clock=0x200000 (xtal * .audio_clock = 51539600) Some details about 30/34/35: - - saa7130 - low-price chip, doesn't have mute, that is why all those - cards should have .mute field defined in their tuner structure. +- saa7130 - low-price chip, doesn't have mute, that is why all those + cards should have .mute field defined in their tuner structure. - - saa7134 - usual chip +- saa7134 - usual chip - - saa7133/35 - saa7135 is probably a marketing decision, since all those - chips identifies itself as 33 on pci. +- saa7133/35 - saa7135 is probably a marketing decision, since all those + chips identifies itself as 33 on pci. Credits -======= +------- andrew.stevens@philips.com + werner.leeb@philips.com for providing saa7134 hardware specs and sample board. - - -Have fun, - - Gerd - --- -Gerd Knorr [SuSE Labs] -- 2.20.1