[PATCH] dvb: bt8xx: update documentation
[safe/jmp/linux-2.6] / 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" "Nebula/Pinnacle PCTV/TwinHan 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 3b) TwinHan
39 -----------
40
41    $ modprobe bttv i2c_hw=1 card=0x71
42    $ modprobe dvb-bt8xx
43    $ modprobe dst
44
45 The value 0x71 will override the PCI type detection for dvb-bt8xx, which 
46 is necessary for TwinHan cards.#
47
48 If you're having an older card (blue color circuit) and card=0x71 locks your
49 machine, try using 0x68, too. If that does not work, ask on the DVB mailing list.
50
51 The DST module takes a couple of useful parameters, in case the
52 dst drivers fails to detect your type of card correctly.
53
54 dst_type takes values 0 (satellite), 1 (terrestial TV), 2 (cable).
55
56 dst_type_flags takes bit combined values:
57 1 = new tuner type packets. You can use this if your card is detected
58     and you have debug and you continually see the tuner packets not
59     working (make sure not a basic problem like dish alignment etc.)
60
61 2 = TS 204. If your card tunes OK, but the picture is terrible, seemingly
62     breaking up in one half continually, and crc fails a lot, then
63     this is worth a try (or trying to turn off)
64
65 4 = has symdiv. Some cards, mostly without new tuner packets, require
66     a symbol division algorithm. Doesn't apply to terrestial TV.
67
68 You can also specify a value to have the autodetected values turned off
69 (e.g. 0). The autodected values are determined bythe cards 'response
70 string' which you can see in your logs e.g.
71
72 dst_check_ci: recognize DST-MOT
73
74 or 
75
76 dst_check_ci: unable to recognize DSTXCI or STXCI
77
78 --
79 Authors: Richard Walker, Jamie Honan, Michael Hunold