Merge ../torvalds-2.6/
[pandora-kernel.git] / 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 (or just place dvb-bt8xx in /etc/modules for automatic loading)
37
38
39 3b) TwinHan and Clones
40 --------------------------
41
42    $ modprobe bttv i2c_hw=1 card=0x71
43    $ modprobe dvb-bt8xx
44    $ modprobe dst
45
46 The value 0x71 will override the PCI type detection for dvb-bt8xx,
47 which  is necessary for TwinHan cards.
48
49 If you're having an older card (blue color circuit) and card=0x71 locks
50 your machine, try using 0x68, too. If that does not work, ask on the
51 mailing list.
52
53 The DST module takes a couple of useful parameters.
54
55 verbose takes values 0 to 4. These values control the verbosity level,
56 and can be used to debug also.
57
58 verbose=0 means complete disabling of messages
59         1 only error messages are displayed
60         2 notifications are also displayed
61         3 informational messages are also displayed
62         4 debug setting
63
64 dst_addons takes values 0 and 0x20. A value of 0 means it is a FTA card.
65 0x20 means it has a Conditional Access slot.
66
67 The autodected values are determined bythe cards 'response
68 string' which you can see in your logs e.g.
69
70 dst_get_device_id: Recognise [DSTMCI]
71
72
73 --
74 Authors: Richard Walker, Jamie Honan, Michael Hunold, Manu Abraham