Annotation of dvb-kernel/README.bt8xx, revision 1.4
1.4 ! hunold 1: How to get the Nebula, PCTV and Twinhan DST cards working
! 2: =========================================================
1.1 holger 3:
1.2 honan 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:
1.3 honan 10: For 2.4, make sure you are using an uptodate kernel 2.4.23 and above.
1.4 ! hunold 11: For 2.6, shuffle down to the 2.6 section below.
! 12:
! 13: 1) 2.4
! 14: ======
1.2 honan 15:
1.3 honan 16: For 2.4, make sure you are using an uptodate kernel 2.4.23 and above.
1.2 honan 17: This is the *only* way to go when you are experimenting with
1.4 ! hunold 18: bleeding-edge stuff like DVB. Do the usual to build your kernel.
! 19: (remember to enable the V4L functionality)
1.2 honan 20:
1.4 ! hunold 21: I'd recommend you install and test your kernel, rather than diving
! 22: straight into the bt878 stuff.
1.1 holger 23:
1.4 ! hunold 24: Download http://bytesex.org/snapshot/video4linux-xxxxyyzz.tar.gz, where
! 25: xxxxyyzz is the date of the release.
1.1 holger 26:
1.4 ! hunold 27: Extract it and do the usual "make" and "make install".
! 28: $ tar xzfv video4linux-xxxxyyzz.tar.gz
! 29: $ make
! 30: $ make install
! 31:
! 32: Now grab "dvb-kernel" from CVS:
1.1 holger 33:
34: $ cvs -d :pserver:anonymous@linuxtv.org:/cvs/linuxtv login
35: $ cvs -d :pserver:anonymous@linuxtv.org:/cvs/linuxtv co dvb-kernel
36:
1.4 ! hunold 37: ... and build the driver:
1.2 honan 38:
39: $ cd dvb-kernel/build-2.4
40: $ ./getlinks
41: $ make
42: $ make install
43:
1.4 ! hunold 44: 2) 2.6
! 45: ======
1.1 holger 46:
1.4 ! hunold 47: For 2.6, you don't need the latest bttv driver, everything is in
! 48: the kernel drivers. Please use 2.6.0-test10 and above.
1.1 holger 49:
1.4 ! hunold 50: Checkout dvb-kernel as mentionen above, but then do everything as per
! 51: the README in dvb-kernel.
1.1 holger 52:
1.4 ! hunold 53: 3) Loading Modules
! 54: ==================
1.1 holger 55:
1.4 ! hunold 56: You can either modify and use the "insmod-bt8xx.sh" script in the build-2.4
! 57: directory or simply do everything by hand.
1.1 holger 58:
1.4 ! hunold 59: In general you need to load the bttv driver, which will handle the gpio and
! 60: i2c communication for us. Next you need the common dvb-bt8xx device driver
! 61: and one frontend driver.
1.1 holger 62:
1.4 ! hunold 63: The bttv driver will HANG YOUR SYSTEM IF YOU DO NOT SPECIFY THE COORECT
! 64: CARD ID! A list of possible card ids can be found inside "bttv-cards.c" inside
! 65: the bttv driver package.
1.1 holger 66:
1.2 honan 67: Pay attention to failures to load these frontends.
68: (E.g. dmesg, /var/log/messages).
1.3 honan 69:
1.4 ! hunold 70: 3a) Nebula / Pinnacle PCTV
! 71: --------------------------
! 72:
! 73: $ modprobe bttv i2c_hw=1 card=0x68
! 74: $ modprobe dvb-bt8xx
! 75:
! 76: For Nebula cards use the "nxt6000" frontend driver:
! 77: $ modprobe nxt6000
! 78:
! 79: For Pinnacle PCTV cards use the "cx24110" frontend driver:
! 80: $ modprobe cx24110
! 81:
! 82: 3b) TwinHan
! 83: -----------
! 84:
! 85: $ modprobe bttv i2c_hw=1 card=0x71
! 86: $ modprobe dvb-bt8xx
! 87: $ modprobe dst
1.3 honan 88:
1.4 ! hunold 89: The value 0x71 will override the PCI type detection for dvb-bt8xx, which
! 90: is necessary for TwinHan cards.
1.3 honan 91:
92: The DST module takes a couple of useful parameters, in case the
93: dst drivers fails to detect your type of card correctly.
94:
95: dst_type takes values 0 (satellite), 1 (terrestial TV), 2 (cable).
96:
97: dst_type_flags takes bit combined values:
98: 1 = new tuner type packets. You can use this if your card is detected
99: and you have debug and you continually see the tuner packets not
100: working (make sure not a basic problem like dish alignment etc.)
101:
102: 2 = TS 204. If your card tunes OK, but the picture is terrible, seemingly
103: breaking up in one half continually, and crc fails a lot, then
104: this is worth a try (or trying to turn off)
105:
106: 4 = has symdiv. Some cards, mostly without new tuner packets, require
107: a symbol division algorithm. Doesn't apply to terrestial TV.
108:
109: You can also specify a value to have the autodetected values turned off
110: (e.g. 0). The autodected values are determined bythe cards 'response
111: string' which you can see in your logs e.g.
112:
113: dst_check_ci: recognize DST-MOT
114:
115: or
116:
117: dst_check_ci: unable to recognize DSTXCI or STXCI
1.1 holger 118:
1.4 ! hunold 119: 4) The rest
! 120: ===========
1.2 honan 121:
1.4 ! hunold 122: That's it. Have fun. Report problems to the mailing list. Thanks!
1.1 holger 123:
1.4 ! hunold 124: --
! 125: Authors:
! 126: Richard Walker (Original)
! 127: Jamie Honan (13 Oct 2003)
! 128: Michael Hunold (25 Nov 2003)
LinuxTV legacy CVS <linuxtv.org/cvs>