Documentation/media/dvb-drivers/bt8xx.rst

   1 How to get the bt8xx cards working
   2 ==================================
   3
   4 Authors: Richard Walker,
   5          Jamie Honan,
   6          Michael Hunold,
   7          Manu Abraham,
   8          Uwe Bugla,
   9          Michael Krufky
  10
  11 .. note::
  12
  13    This documentation is outdated. Please check at the DVB wiki
  14    at https://linuxtv.org/wiki for more updated info.
  15
  16 General information
  17 -------------------
  18
  19 This class of cards has a bt878a as the PCI interface, and require the bttv driver
  20 for accessing the i2c bus and the gpio pins of the bt8xx chipset.
  21 Please see Documentation/dvb/cards.txt => o Cards based on the Conexant Bt8xx PCI bridge:
  22
  23 Compiling kernel please enable:
  24
  25 #) ``Device drivers`` => ``Multimedia devices`` => ``Video For Linux`` => ``Enable Video for Linux API 1 (DEPRECATED)``
  26 #) ``Device drivers`` => ``Multimedia devices`` => ``Video For Linux`` => ``Video Capture Adapters`` => ``BT848 Video For Linux``
  27 #) ``Device drivers`` => ``Multimedia devices`` => ``Digital Video Broadcasting Devices`` => ``DVB for Linux`` ``DVB Core Support`` ``Bt8xx based PCI Cards``
  28
  29   Please use the following options with care as deselection of drivers which are in fact necessary may result in DVB devices that cannot be tuned due to lack of driver support:
  30   You can save RAM by deselecting every frontend module that your DVB card does not need.
  31
  32   First please remove the static dependency of DVB card drivers on all frontend modules for all possible card variants by enabling:
  33
  34 #) ``Device drivers`` => ``Multimedia devices`` => ``Digital Video Broadcasting Devices`` => ``DVB for Linux`` ``DVB Core Support`` ``Load and attach frontend modules as needed``
  35
  36   If you know the frontend driver that your card needs please enable:
  37
  38 #) ``Device drivers`` => ``Multimedia devices`` => ``Digital Video Broadcasting Devices`` => ``DVB for Linux`` ``DVB Core Support`` ``Customise DVB Frontends`` => ``Customise the frontend modules to build``
  39
  40  Then please select your card-specific frontend module.
  41
  42 Loading Modules
  43 ---------------
  44
  45 Regular case: If the bttv driver detects a bt8xx-based DVB card, all frontend and backend modules will be loaded automatically.
  46 Exceptions are:
  47 - Old TwinHan DST cards or clones with or without CA slot and not containing an Eeprom.
  48 People running udev please see Documentation/dvb/udev.txt.
  49
  50 In the following cases overriding the PCI type detection for dvb-bt8xx might be necessary:
  51
  52 Running TwinHan and Clones
  53 ~~~~~~~~~~~~~~~~~~~~~~~~~~
  54
  55 .. code-block:: none
  56
  57         $ modprobe bttv card=113
  58         $ modprobe dst
  59
  60 Useful parameters for verbosity level and debugging the dst module:
  61
  62 .. code-block:: none
  63
  64         verbose=0:              messages are disabled
  65                 1:              only error messages are displayed
  66                 2:              notifications are displayed
  67                 3:              other useful messages are displayed
  68                 4:              debug setting
  69         dst_addons=0:           card is a free to air (FTA) card only
  70                 0x20:   card has a conditional access slot for scrambled channels
  71
  72 The autodetected values are determined by the cards' "response string".
  73 In your logs see f. ex.: dst_get_device_id: Recognize [DSTMCI].
  74 For bug reports please send in a complete log with verbose=4 activated.
  75 Please also see Documentation/dvb/ci.txt.
  76
  77 Running multiple cards
  78 ~~~~~~~~~~~~~~~~~~~~~~
  79
  80 Examples of card ID's:
  81
  82 .. code-block:: none
  83
  84         Pinnacle PCTV Sat:               94
  85         Nebula Electronics Digi TV:     104
  86         pcHDTV HD-2000 TV:              112
  87         Twinhan DST and clones:         113
  88         Avermedia AverTV DVB-T 771:     123
  89         Avermedia AverTV DVB-T 761:     124
  90         DViCO FusionHDTV DVB-T Lite:    128
  91         DViCO FusionHDTV 5 Lite:        135
  92
  93 .. note::
  94
  95    The order of the card ID should be uprising:
  96
  97    Example:
  98
  99    .. code-block:: none
 100
 101         $ modprobe bttv card=113 card=135
 102
 103 For a full list of card ID's please see Documentation/video4linux/CARDLIST.bttv.
 104 In case of further problems please subscribe and send questions to the mailing list: linux-dvb@linuxtv.org.
 105
 106 Probing the cards with broken PCI subsystem ID
 107 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 108
 109 There are some TwinHan cards that the EEPROM has become corrupted for some
 110 reason. The cards do not have correct PCI subsystem ID. But we can force
 111 probing the cards with broken PCI subsystem ID
 112
 113 .. code-block:: none
 114
 115         $ echo 109e 0878 $subvendor $subdevice > \
 116                 /sys/bus/pci/drivers/bt878/new_id
 117
 118 .. code-block:: none
 119
 120         109e: PCI_VENDOR_ID_BROOKTREE
 121         0878: PCI_DEVICE_ID_BROOKTREE_878
 122