Annotation of dvb-kernel/README.bt8xx, revision 1.7
1.4 hunold 1: How to get the Nebula, PCTV and Twinhan DST cards working
2: =========================================================
1.1 holger 3:
1.6 hunold 4: This class of cards has a bt878a as the PCI interface, and require the
5: bttv driver.
1.2 honan 6:
1.6 hunold 7: Please pay close attention to the warning about the bttv module options
8: below for the DST card.
1.2 honan 9:
1.7 ! hunold 10: 2) 2.6
! 11: ======
! 12:
! 13: For 2.6, you don't need the latest bttv driver, everything is in
! 14: the kernel drivers. Please use 2.6.1 and above.
! 15:
! 16: Build and intsall the driver like described in README.
1.4 hunold 17:
18: 1) 2.4
19: ======
1.2 honan 20:
1.3 honan 21: For 2.4, make sure you are using an uptodate kernel 2.4.23 and above.
1.2 honan 22: This is the *only* way to go when you are experimenting with
1.5 hunold 23: bleeding-edge stuff like DVB.
24:
1.6 hunold 25: You need an up-to-date bttv driver for the bt8xx-based cards to work.
1.2 honan 26:
1.6 hunold 27: Two methods to get a recent version:
28: a) Patch your kernel (and possibly recompile it)
29: b) Compile an external package
30:
31: Method a)
32: The most recent patches for 2.4.23 so far are at
33: http://bytesex.org/patches/2.4.23-4/
34:
35: You need to fetch at least the following patches:
36: 20_v4l2-2.4.23.diff.gz
37: 30_video-buf-2.4.23.diff.gz
38: 31_ir-input-2.4.23.diff
39: 31_tuner-2.4.23.diff.gz
40: 32_bttv-2.4.23.diff.gz
41:
42: Decompress them with "gzip -d *.gz" and the apply them one after
43: another to your 2.4.23 kernel tree via "patch -p1 < [...]"
44:
45: Then select the bttv driver and recompile your kernel and modules.
46: Remeber to enable the V4L functionality. For the 'BT848 Video For
47: Linux' in the 'Video for Linux' section to show up you need to enable
48: 'I2C support' and 'I2C bit-banging interfaces' in the charcter devices
49: section, as well as 'Sound' => 'Sound card support'.
50:
51: Method b)
1.1 holger 52:
1.4 hunold 53: Download http://bytesex.org/snapshot/video4linux-xxxxyyzz.tar.gz, where
54: xxxxyyzz is the date of the release.
1.1 holger 55:
1.4 hunold 56: Extract it and do the usual "make" and "make install".
57: $ tar xzfv video4linux-xxxxyyzz.tar.gz
58: $ make
59: $ make install
1.6 hunold 60:
61: This will give you (amongst other stuff) a recent bttv driver.
62:
1.7 ! hunold 63: Now build and install the driver like described in README.
1.5 hunold 64:
1.4 hunold 65: 3) Loading Modules
66: ==================
1.1 holger 67:
1.6 hunold 68: You can either modify and use the "insmod-bt8xx.sh" script in the
69: build-2.4 directory or simply do everything by hand.
1.1 holger 70:
1.6 hunold 71: In general you need to load the bttv driver, which will handle the gpio
72: and i2c communication for us. Next you need the common dvb-bt8xx device
73: driver and one frontend driver.
74:
75: The bttv driver will HANG YOUR SYSTEM IF YOU DO NOT SPECIFY THE
76: COORECT CARD ID! A list of possible card ids can be found inside
1.7 ! hunold 77: "bttv-cards.c" inside the bttv driver package.
1.1 holger 78:
1.2 honan 79: Pay attention to failures to load these frontends.
80: (E.g. dmesg, /var/log/messages).
1.3 honan 81:
1.4 hunold 82: 3a) Nebula / Pinnacle PCTV
83: --------------------------
84:
85: $ modprobe bttv i2c_hw=1 card=0x68
86: $ modprobe dvb-bt8xx
87:
88: For Nebula cards use the "nxt6000" frontend driver:
89: $ modprobe nxt6000
90:
91: For Pinnacle PCTV cards use the "cx24110" frontend driver:
92: $ modprobe cx24110
93:
94: 3b) TwinHan
95: -----------
96:
97: $ modprobe bttv i2c_hw=1 card=0x71
98: $ modprobe dvb-bt8xx
99: $ modprobe dst
1.3 honan 100:
1.6 hunold 101: The value 0x71 will override the PCI type detection for dvb-bt8xx,
1.7 ! hunold 102: which is necessary for TwinHan cards.
1.6 hunold 103:
104: If you're having an older card (blue color circuit) and card=0x71 locks
105: your machine, try using 0x68, too. If that does not work, ask on the
106: mailing list.
1.3 honan 107:
1.6 hunold 108: The DST module takes a couple of useful parameters, in case the dst
109: drivers fails to detect your type of card correctly.
1.3 honan 110:
111: dst_type takes values 0 (satellite), 1 (terrestial TV), 2 (cable).
112:
113: dst_type_flags takes bit combined values:
114: 1 = new tuner type packets. You can use this if your card is detected
115: and you have debug and you continually see the tuner packets not
116: working (make sure not a basic problem like dish alignment etc.)
117:
118: 2 = TS 204. If your card tunes OK, but the picture is terrible, seemingly
119: breaking up in one half continually, and crc fails a lot, then
120: this is worth a try (or trying to turn off)
121:
122: 4 = has symdiv. Some cards, mostly without new tuner packets, require
123: a symbol division algorithm. Doesn't apply to terrestial TV.
124:
125: You can also specify a value to have the autodetected values turned off
126: (e.g. 0). The autodected values are determined bythe cards 'response
127: string' which you can see in your logs e.g.
128:
129: dst_check_ci: recognize DST-MOT
130:
131: or
132:
133: dst_check_ci: unable to recognize DSTXCI or STXCI
LinuxTV legacy CVS <linuxtv.org/cvs>