Merge branch 'master'
[pandora-kernel.git] / Documentation / dvb / bt8xx.txt
1 How to get the Nebula, PCTV, FusionHDTV Lite 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), TwinHan (dst),
30 FusionHDTV DVB-T Lite (mt352) and FusionHDTV5 Lite (lgdt330x) are loaded
31 automatically by the dvb-bt8xx device driver.
32
33 3a) Nebula / Pinnacle PCTV / FusionHDTV Lite
34 ---------------------------------------------
35
36    $ modprobe bttv (normally bttv is being loaded automatically by kmod)
37    $ modprobe dvb-bt8xx
38
39 (or just place dvb-bt8xx in /etc/modules for automatic loading)
40
41
42 3b) TwinHan and Clones
43 --------------------------
44
45    $ modprobe bttv card=0x71
46    $ modprobe dvb-bt8xx
47    $ modprobe dst
48
49 The value 0x71 will override the PCI type detection for dvb-bt8xx,
50 which  is necessary for TwinHan cards. Omission of this parameter might result
51 in a system lockup.
52
53 If you're having an older card (blue color PCB) and card=0x71 locks up
54 your machine, try using 0x68, too. If that does not work, ask on the
55 mailing list.
56
57 The DST module takes a couple of useful parameters.
58
59 verbose takes values 0 to 4. These values control the verbosity level,
60 and can be used to debug also.
61
62 verbose=0 means complete disabling of messages
63         1 only error messages are displayed
64         2 notifications are also displayed
65         3 informational messages are also displayed
66         4 debug setting
67
68 dst_addons takes values 0 and 0x20. A value of 0 means it is a FTA card.
69 0x20 means it has a Conditional Access slot.
70
71 The autodetected values are determined by the cards 'response string'
72 which you can see in your logs e.g.
73
74 dst_get_device_id: Recognise [DSTMCI]
75
76 If you need to sent in bug reports on the dst, please do send in a complete
77 log with the verbose=4 module parameter. For general usage, the default setting
78 of verbose=1 is ideal.
79
80
81 4) Multiple cards
82 --------------------------
83
84 If you happen to be running multiple cards, it would be advisable to load
85 the bttv module with the card id. This would help to solve any module loading
86 problems that you might face.
87
88 For example, if you have a Twinhan and Clones card along with a FusionHDTV5 Lite
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 Lite. These arguments can also be
95 specified in decimal, rather than hex:
96
97         $ modprobe bttv card=113 card=135
98
99 Some examples of card-id's
100
101 Pinnacle Sat            0x5e  (94)
102 Nebula Digi TV          0x68  (104)
103 PC HDTV                 0x70  (112)
104 Twinhan                 0x71  (113)
105 FusionHDTV DVB-T Lite   0x80  (128)
106 FusionHDTV5 Lite        0x87  (135)
107
108 For a full list of card-id's, see the V4L Documentation within the kernel
109 source:  linux/Documentation/video4linux/CARDLIST.bttv
110
111 If you have problems with this please do ask on the mailing list.
112
113 --
114 Authors: Richard Walker,
115          Jamie Honan,
116          Michael Hunold,
117          Manu Abraham,
118          Michael Krufky