Documentation/admin-guide/media/bt8xx.rst

   1 .. SPDX-License-Identifier: GPL-2.0
   2
   3 ==================================
   4 How to get the bt8xx cards working
   5 ==================================
   6
   7 Authors:
   8          Richard Walker,
   9          Jamie Honan,
  10          Michael Hunold,
  11          Manu Abraham,
  12          Uwe Bugla,
  13          Michael Krufky
  14
  15 General information
  16 -------------------
  17
  18 This class of cards has a bt878a as the PCI interface, and require the bttv
  19 driver for accessing the i2c bus and the gpio pins of the bt8xx chipset.
  20
  21 Please see Documentation/admin-guide/media/bttv-cardlist.rst for a complete
  22 list of Cards based on the Conexant Bt8xx PCI bridge supported by the
  23 Linux Kernel.
  24
  25 In order to be able to compile the kernel, some config options should be
  26 enabled::
  27
  28     ./scripts/config -e PCI
  29     ./scripts/config -e INPUT
  30     ./scripts/config -m I2C
  31     ./scripts/config -m MEDIA_SUPPORT
  32     ./scripts/config -e MEDIA_PCI_SUPPORT
  33     ./scripts/config -e MEDIA_ANALOG_TV_SUPPORT
  34     ./scripts/config -e MEDIA_DIGITAL_TV_SUPPORT
  35     ./scripts/config -e MEDIA_RADIO_SUPPORT
  36     ./scripts/config -e RC_CORE
  37     ./scripts/config -m VIDEO_BT848
  38     ./scripts/config -m DVB_BT8XX
  39
  40 If you want to automatically support all possible variants of the Bt8xx
  41 cards, you should also do::
  42
  43     ./scripts/config -e MEDIA_SUBDRV_AUTOSELECT
  44
  45 .. note::
  46
  47    Please use the following options with care as deselection of drivers which
  48    are in fact necessary may result in DVB devices that cannot be tuned due
  49    to lack of driver support.
  50
  51 If your goal is to just support an specific board, you may, instead,
  52 disable MEDIA_SUBDRV_AUTOSELECT and manually select the frontend drivers
  53 required by your board. With that, you can save some RAM.
  54
  55 You can do that by calling make xconfig/qconfig/menuconfig and look at
  56 the options on those menu options (only enabled if
  57 ``Autoselect ancillary drivers`` is disabled:
  58
  59 #) ``Device drivers`` => ``Multimedia support`` => ``Customize TV tuners``
  60 #) ``Device drivers`` => ``Multimedia support`` => ``Customize DVB frontends``
  61
  62 Then, on each of the above menu, please select your card-specific
  63 frontend and tuner modules.
  64
  65
  66 Loading Modules
  67 ---------------
  68
  69 Regular case: If the bttv driver detects a bt8xx-based DVB card, all
  70 frontend and backend modules will be loaded automatically.
  71
  72 Exceptions are:
  73
  74 - Old TV cards without EEPROMs, sharing a common PCI subsystem ID;
  75 - Old TwinHan DST cards or clones with or without CA slot and not
  76   containing an Eeprom.
  77
  78 In the following cases overriding the PCI type detection for bttv and
  79 for dvb-bt8xx drivers by passing modprobe parameters may be necessary.
  80
  81 Running TwinHan and Clones
  82 ~~~~~~~~~~~~~~~~~~~~~~~~~~
  83
  84 As shown at Documentation/admin-guide/media/bttv-cardlist.rst, TwinHan and
  85 clones use ``card=113`` modprobe parameter. So, in order to properly
  86 detect it for devices without EEPROM, you should use::
  87
  88         $ modprobe bttv card=113
  89         $ modprobe dst
  90
  91 Useful parameters for verbosity level and debugging the dst module::
  92
  93         verbose=0:              messages are disabled
  94                 1:              only error messages are displayed
  95                 2:              notifications are displayed
  96                 3:              other useful messages are displayed
  97                 4:              debug setting
  98         dst_addons=0:           card is a free to air (FTA) card only
  99                 0x20:   card has a conditional access slot for scrambled channels
 100         dst_algo=0:             (default) Software tuning algorithm
 101                  1:             Hardware tuning algorithm
 102
 103
 104 The autodetected values are determined by the cards' "response string".
 105
 106 In your logs see f. ex.: dst_get_device_id: Recognize [DSTMCI].
 107
 108 For bug reports please send in a complete log with verbose=4 activated.
 109 Please also see Documentation/admin-guide/media/ci.rst.
 110
 111 Running multiple cards
 112 ~~~~~~~~~~~~~~~~~~~~~~
 113
 114 See Documentation/admin-guide/media/bttv-cardlist.rst for a complete list of
 115 Card ID. Some examples:
 116
 117         ===========================     ===
 118         Brand name                      ID
 119         ===========================     ===
 120         Pinnacle PCTV Sat                94
 121         Nebula Electronics Digi TV      104
 122         pcHDTV HD-2000 TV               112
 123         Twinhan DST and clones          113
 124         Avermedia AverTV DVB-T 77:      123
 125         Avermedia AverTV DVB-T 761      124
 126         DViCO FusionHDTV DVB-T Lite     128
 127         DViCO FusionHDTV 5 Lite         135
 128         ===========================     ===
 129
 130 .. note::
 131
 132    When you have multiple cards, the order of the card ID should
 133    match the order where they're detected by the system. Please notice
 134    that removing/inserting other PCI cards may change the detection
 135    order.
 136
 137 Example::
 138
 139         $ modprobe bttv card=113 card=135
 140
 141 In case of further problems please subscribe and send questions to
 142 the mailing list: linux-media@vger.kernel.org.
 143
 144 Probing the cards with broken PCI subsystem ID
 145 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 146
 147 There are some TwinHan cards whose EEPROM has become corrupted for some
 148 reason. The cards do not have a correct PCI subsystem ID.
 149 Still, it is possible to force probing the cards with::
 150
 151         $ echo 109e 0878 $subvendor $subdevice > \
 152                 /sys/bus/pci/drivers/bt878/new_id
 153
 154 The two numbers there are::
 155
 156         109e: PCI_VENDOR_ID_BROOKTREE
 157         0878: PCI_DEVICE_ID_BROOKTREE_878