media: docs: split uAPI info from saa7134-devel.rst

This file contains both driver develompent documentation and
userspace API.

Split on two, as they're usually read by different audiences.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
This commit is contained in:
Mauro Carvalho Chehab 2020-03-05 07:48:35 +01:00
parent b4a5f46cde
commit f8dd7a257d
3 changed files with 68 additions and 54 deletions

View File

@ -71,6 +71,7 @@ For more details see the file COPYING in the source distribution of Linux.
cx88-devel
davinci-vpbe-devel
fimc-devel
saa7134-devel
vimc-devel
cx2341x-uapi

View File

@ -0,0 +1,67 @@
.. SPDX-License-Identifier: GPL-2.0
The saa7134 driver
==================
Author Gerd Hoffmann
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)
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.
- saa7134 - usual chip
- saa7133/35 - saa7135 is probably a marketing decision, since all those
chips identifies itself as 33 on pci.
LifeView GPIOs
--------------
This section was authored by: Peter Missel <peter.missel@onlinehome.de>
- LifeView FlyTV Platinum FM (LR214WF)
- GP27 MDT2005 PB4 pin 10
- GP26 MDT2005 PB3 pin 9
- GP25 MDT2005 PB2 pin 8
- GP23 MDT2005 PB1 pin 7
- GP22 MDT2005 PB0 pin 6
- GP21 MDT2005 PB5 pin 11
- GP20 MDT2005 PB6 pin 12
- GP19 MDT2005 PB7 pin 13
- nc MDT2005 PA3 pin 2
- Remote MDT2005 PA2 pin 1
- GP18 MDT2005 PA1 pin 18
- nc MDT2005 PA0 pin 17 strap low
- GP17 Strap "GP7"=High
- GP16 Strap "GP6"=High
- 0=Radio 1=TV
- Drives SA630D ENCH1 and HEF4052 A1 pinsto do FM radio through
SIF input
- GP15 nc
- GP14 nc
- GP13 nc
- GP12 Strap "GP5" = High
- GP11 Strap "GP4" = High
- GP10 Strap "GP3" = High
- GP09 Strap "GP2" = Low
- GP08 Strap "GP1" = Low
- GP07.00 nc
Credits
-------
andrew.stevens@philips.com + werner.leeb@philips.com for providing
saa7134 hardware specs and sample board.

View File

@ -54,60 +54,6 @@ Known Problems
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)
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.
- saa7134 - usual chip
- saa7133/35 - saa7135 is probably a marketing decision, since all those
chips identifies itself as 33 on pci.
LifeView GPIOs
--------------
This section was authored by: Peter Missel <peter.missel@onlinehome.de>
- LifeView FlyTV Platinum FM (LR214WF)
- GP27 MDT2005 PB4 pin 10
- GP26 MDT2005 PB3 pin 9
- GP25 MDT2005 PB2 pin 8
- GP23 MDT2005 PB1 pin 7
- GP22 MDT2005 PB0 pin 6
- GP21 MDT2005 PB5 pin 11
- GP20 MDT2005 PB6 pin 12
- GP19 MDT2005 PB7 pin 13
- nc MDT2005 PA3 pin 2
- Remote MDT2005 PA2 pin 1
- GP18 MDT2005 PA1 pin 18
- nc MDT2005 PA0 pin 17 strap low
- GP17 Strap "GP7"=High
- GP16 Strap "GP6"=High
- 0=Radio 1=TV
- Drives SA630D ENCH1 and HEF4052 A1 pinsto do FM radio through
SIF input
- GP15 nc
- GP14 nc
- GP13 nc
- GP12 Strap "GP5" = High
- GP11 Strap "GP4" = High
- GP10 Strap "GP3" = High
- GP09 Strap "GP2" = Low
- GP08 Strap "GP1" = Low
- GP07.00 nc
Credits
-------