1How to get the bt8xx cards working 2================================== 3 4Authors: 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 16General information 17------------------- 18 19This class of cards has a bt878a as the PCI interface, and require the bttv driver 20for accessing the i2c bus and the gpio pins of the bt8xx chipset. 21Please see Documentation/media/dvb-drivers/cards.rst => o Cards based on the Conexant Bt8xx PCI bridge: 22 23Compiling 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 42Loading Modules 43--------------- 44 45Regular case: If the bttv driver detects a bt8xx-based DVB card, all frontend and backend modules will be loaded automatically. 46Exceptions are: 47- Old TwinHan DST cards or clones with or without CA slot and not containing an Eeprom. 48People running udev please see Documentation/media/dvb-drivers/udev.rst. 49 50In the following cases overriding the PCI type detection for dvb-bt8xx might be necessary: 51 52Running TwinHan and Clones 53~~~~~~~~~~~~~~~~~~~~~~~~~~ 54 55.. code-block:: none 56 57 $ modprobe bttv card=113 58 $ modprobe dst 59 60Useful 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 72The autodetected values are determined by the cards' "response string". 73In your logs see f. ex.: dst_get_device_id: Recognize [DSTMCI]. 74For bug reports please send in a complete log with verbose=4 activated. 75Please also see Documentation/media/dvb-drivers/ci.rst. 76 77Running multiple cards 78~~~~~~~~~~~~~~~~~~~~~~ 79 80Examples 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 103For a full list of card ID's please see Documentation/media/v4l-drivers/bttv-cardlist.rst. 104In case of further problems please subscribe and send questions to the mailing list: linux-dvb@linuxtv.org. 105 106Probing the cards with broken PCI subsystem ID 107~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 108 109There are some TwinHan cards that the EEPROM has become corrupted for some 110reason. The cards do not have correct PCI subsystem ID. But we can force 111probing 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 123