SAFE public projects git trees. - safe/jmp/linux-2.6/blob - Documentation/dvb/bt8xx.txt

   1 How to get the Nebula, PCTV and Twinhan DST cards working
   2 =========================================================
   3
   4 This class of cards has a bt878a as the PCI interface, and
   5 require the bttv driver.
   6
   7 Please pay close attention to the warning about the bttv module
   8 options below for the DST card.
   9
  10 1) General informations
  11 =======================
  12
  13 These drivers require the bttv driver to provide the means to access
  14 the i2c bus and the gpio pins of the bt8xx chipset.
  15
  16 Because of this, you need to enable
  17 "Device drivers" => "Multimedia devices"
  18   => "Video For Linux" => "BT848 Video For Linux"
  19
  20 Furthermore you need to enable
  21 "Device drivers" => "Multimedia devices" => "Digital Video Broadcasting Devices"
  22   => "DVB for Linux" "DVB Core Support" "BT8xx based PCI cards"
  23
  24 2) Loading Modules
  25 ==================
  26
  27 In general you need to load the bttv driver, which will handle the gpio and
  28 i2c communication for us, plus the common dvb-bt8xx device driver.
  29 The frontends for Nebula (nxt6000), Pinnacle PCTV (cx24110) and
  30 TwinHan (dst) are loaded automatically by the dvb-bt8xx device driver.
  31
  32 3a) Nebula / Pinnacle PCTV
  33 --------------------------
  34
  35    $ modprobe bttv (normally bttv is being loaded automatically by kmod)
  36    $ modprobe dvb-bt8xx
  37
  38 (or just place dvb-bt8xx in /etc/modules for automatic loading)
  39
  40
  41 3b) TwinHan and Clones
  42 --------------------------
  43
  44    $ modprobe bttv card=0x71
  45    $ modprobe dvb-bt8xx
  46    $ modprobe dst
  47
  48 The value 0x71 will override the PCI type detection for dvb-bt8xx,
  49 which  is necessary for TwinHan cards. Omission of this parameter might result
  50 in a system lockup.
  51
  52 If you're having an older card (blue color PCB) and card=0x71 locks up
  53 your machine, try using 0x68, too. If that does not work, ask on the
  54 mailing list.
  55
  56 The DST module takes a couple of useful parameters.
  57
  58 verbose takes values 0 to 4. These values control the verbosity level,
  59 and can be used to debug also.
  60
  61 verbose=0 means complete disabling of messages
  62         1 only error messages are displayed
  63         2 notifications are also displayed
  64         3 informational messages are also displayed
  65         4 debug setting
  66
  67 dst_addons takes values 0 and 0x20. A value of 0 means it is a FTA card.
  68 0x20 means it has a Conditional Access slot.
  69
  70 The autodected values are determined bythe cards 'response
  71 string' which you can see in your logs e.g.
  72
  73 dst_get_device_id: Recognise [DSTMCI]
  74
  75 If you need to sent in bug reports on the dst, please do send in a complete
  76 log with the verbose=4 module parameter. For general usage, the default setting
  77 of verbose=1 is ideal.
  78
  79
  80 4) Multiple cards
  81 --------------------------
  82
  83 If you happen to be running multiple cards, it would be advisable to load
  84 the bttv module with the card id. This would help to solve any module loading
  85 problems that you might face.
  86
  87 for example, if you happen to have a Twinhan and clones alongwith a FusionHDTV5
  88 card
  89
  90         $ modprobe bttv card=0x71 card=0x87
  91
  92 Here the order of the card id is important and should be the same as that of the
  93 physical order of the cards. Here card=0x71 represents the Twinhan and clones
  94 and card=0x87 represents Fusion HDTV5.
  95
  96 Some examples of card-id's
  97
  98 Pinnacle Sat            0x5e
  99 Nebula Digi TV          0x68
 100 PC HDTV                 0x70
 101 Twinhan                 0x71
 102 Fusion HDTV5            0x87
 103
 104 For a full list of card-id's, you can see the exported card-id's from
 105 bttv-cards.c in linux-2.6.x/drivers/media/video/bttv.h
 106 If you have problems with this please do ask on the mailing list.
 107
 108 --
 109 Authors: Richard Walker, Jamie Honan, Michael Hunold, Manu Abraham