Documentation/media/v4l-drivers/saa7134.rst

   1 .. SPDX-License-Identifier: GPL-2.0
   2
   3 The saa7134 driver
   4 ==================
   5
   6 Author Gerd Hoffmann
   7
   8
   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.
  12
  13
  14 Status
  15 ------
  16
  17 Almost everything is working.  video, sound, tuner, radio, mpeg ts, ...
  18
  19 As with bttv, card-specific tweaks are needed.  Check CARDLIST for a
  20 list of known TV cards and saa7134-cards.c for the drivers card
  21 configuration info.
  22
  23
  24 Build
  25 -----
  26
  27 Pick up videodev + v4l2 patches from http://bytesex.org/patches/.
  28 Configure, build, install + boot the new kernel.  You'll need at least
  29 these config options:
  30
  31 .. code-block:: none
  32
  33         CONFIG_I2C=m
  34         CONFIG_VIDEO_DEV=m
  35
  36 Type "make" to build the driver now.  "make install" installs the
  37 driver.  "modprobe saa7134" should load it.  Depending on the card you
  38 might have to pass card=<nr> as insmod option, check CARDLIST for
  39 valid choices.
  40
  41
  42 Changes / Fixes
  43 ---------------
  44
  45 Please mail me unified diffs ("diff -u") with your changes, and don't
  46 forget to tell me what it changes / which problem it fixes / whatever
  47 it is good for ...
  48
  49
  50 Known Problems
  51 --------------
  52
  53 * The tuner for the flyvideos isn't detected automatically and the
  54   default might not work for you depending on which version you have.
  55   There is a tuner= insmod option to override the driver's default.
  56
  57 Card Variations:
  58 ----------------
  59
  60 Cards can use either of these two crystals (xtal):
  61
  62 - 32.11 MHz -> .audio_clock=0x187de7
  63 - 24.576MHz -> .audio_clock=0x200000 (xtal * .audio_clock = 51539600)
  64
  65 Some details about 30/34/35:
  66
  67 - saa7130 - low-price chip, doesn't have mute, that is why all those
  68   cards should have .mute field defined in their tuner structure.
  69
  70 - saa7134 - usual chip
  71
  72 - saa7133/35 - saa7135 is probably a marketing decision, since all those
  73   chips identifies itself as 33 on pci.
  74
  75 LifeView GPIOs
  76 --------------
  77
  78 This section was authored by: Peter Missel <peter.missel@onlinehome.de>
  79
  80 - LifeView FlyTV Platinum FM (LR214WF)
  81
  82     - GP27    MDT2005 PB4 pin 10
  83     - GP26    MDT2005 PB3 pin 9
  84     - GP25    MDT2005 PB2 pin 8
  85     - GP23    MDT2005 PB1 pin 7
  86     - GP22    MDT2005 PB0 pin 6
  87     - GP21    MDT2005 PB5 pin 11
  88     - GP20    MDT2005 PB6 pin 12
  89     - GP19    MDT2005 PB7 pin 13
  90     - nc      MDT2005 PA3 pin 2
  91     - Remote  MDT2005 PA2 pin 1
  92     - GP18    MDT2005 PA1 pin 18
  93     - nc      MDT2005 PA0 pin 17 strap low
  94     - GP17    Strap "GP7"=High
  95     - GP16    Strap "GP6"=High
  96
  97         - 0=Radio 1=TV
  98         - Drives SA630D ENCH1 and HEF4052 A1 pinsto do FM radio through
  99           SIF input
 100
 101     - GP15    nc
 102     - GP14    nc
 103     - GP13    nc
 104     - GP12    Strap "GP5" = High
 105     - GP11    Strap "GP4" = High
 106     - GP10    Strap "GP3" = High
 107     - GP09    Strap "GP2" = Low
 108     - GP08    Strap "GP1" = Low
 109     - GP07.00 nc
 110
 111 Credits
 112 -------
 113
 114 andrew.stevens@philips.com + werner.leeb@philips.com for providing
 115 saa7134 hardware specs and sample board.