Annotation of dvb-kernel/README.bt8xx, revision 1.3
1.2 honan 1: Original Richard Walker
2: Modified Jamie Honan, 13 Oct 2003
1.1 holger 3:
1.2 honan 4: How to get the Nebula, PCTV and Twinhan DST cards working,
1.1 holger 5:
1.2 honan 6: This class of cards has a bt878a as the PCI interface, and
7: require the bttv driver.
8:
9: Please pay close attention to the warning about the bttv module
10: options below for the DST card.
11:
1.3 ! honan 12: For 2.4, make sure you are using an uptodate kernel 2.4.23 and above.
1.2 honan 13: For 2.6, shuffle down to the 2.6 section below. 2.6 is recommended
14: because of it's multimedia latency support, and ease of build.
15:
16: 2.4
17: ===
1.3 ! honan 18: For 2.4, make sure you are using an uptodate kernel 2.4.23 and above.
1.2 honan 19: This is the *only* way to go when you are experimenting with
20: bleeding-edge stuff like DVB and Dxr3. Do the usual to build your kernel.
21: (remember to enable the V4L functionality) I'd recommend you install and
22: test your kernel, rather than diving straight into the bt878 stuff.
23:
24: Download http://bytesex.org/patches/2.4.xxx/11-v4l2-api-2.4.xxxxxx.diff.gz and
1.1 holger 25: apply this to your kernel source tree. For example:
26:
27: $ cd /usr/src
1.3 ! honan 28: $ patch -p0 < ~/11-v4l2-api-2.4.xxxx-rc4.diff
1.1 holger 29:
30: This will patch your kernel to include support for VideoForLinux 2.
31:
32: For those who don't know, kernels < 2.5 only support V4L 1 out-of-the-box. If
33: you are using kernel 2.5.x (or 2.6.x) then V4L2 is built-in.
34:
1.2 honan 35: You need to use 'dvb-kernel', along with 'bttv' to talk to your card.
36:
37: Download http://bytesex.org/bttv/bttv-0.9.12.tar.gz or above and unpack it.
38: This is the first version that will not hang your card.
1.3 ! honan 39: You may find this in the http://bytesex.org/snapshots directory.
1.1 holger 40:
1.2 honan 41: Using this version of
1.1 holger 42:
43: Grab dvb-kernel from CVS:
44:
45: $ cvs -d :pserver:anonymous@linuxtv.org:/cvs/linuxtv login
46: $ cvs -d :pserver:anonymous@linuxtv.org:/cvs/linuxtv co dvb-kernel
47:
1.2 honan 48: No patching of bttv is required from any patches in the dvb-kernel
49: tree. (You do have to do the v4l stuff above).
50:
51: Not, at last, the DVB stuff can be built! Just do it the usual way:
52:
53: $ cd dvb-kernel/build-2.4
54: $ ./getlinks
55: $ make
56: $ make install
57:
58: 2.6
59: ===
60: For 2.6, life is a lot easier, assuming you use 2.6.0-test7 and above.
61: The bttv does not need to be patched.
62:
63: Checkout dvb-kernel.
1.1 holger 64:
1.2 honan 65: Do everything as per the README in dvb-kernel.
1.1 holger 66:
1.2 honan 67: Loading Modules
68: ===============
1.1 holger 69:
1.2 honan 70: Use and modify the insmod-bt8xx.sh script in the build-2.4 directory
71: to start and stop your drivers.
1.1 holger 72:
1.2 honan 73: The insmod script should be modified so that one of:
1.1 holger 74:
1.2 honan 75: # Nebula
76: insmod nxt6000.o
77: # or Pinnacle PCTV
78: insmod cx24110.o
79: # or DST
80: insmod dst.o
1.1 holger 81:
1.2 honan 82: is selected as a frontend.
1.1 holger 83:
1.2 honan 84: Note well. The
1.1 holger 85:
1.2 honan 86: insmod bttv.o i2c_hw=1 card=0x68
1.1 holger 87:
1.2 honan 88: The bttv driver will HANG YOUR SYSTEM IF YOU DO NOT SPECIFY THE CARD
89: FOR THE DST!
1.1 holger 90:
1.2 honan 91: Pay attention to failures to load these frontends.
92: (E.g. dmesg, /var/log/messages).
1.3 ! honan 93:
! 94: For DST cards, you can also use card type 0x71 for bttv module params,
! 95: providing the bttv version supports this. (The ones from bytesex/snapshots do).
! 96:
! 97: If you use this value, 0x71, it will override the PCI type detection
! 98: for dvb-bt8xx.
! 99:
! 100: The DST module takes a couple of useful parameters, in case the
! 101: dst drivers fails to detect your type of card correctly.
! 102:
! 103: dst_type takes values 0 (satellite), 1 (terrestial TV), 2 (cable).
! 104:
! 105: dst_type_flags takes bit combined values:
! 106: 1 = new tuner type packets. You can use this if your card is detected
! 107: and you have debug and you continually see the tuner packets not
! 108: working (make sure not a basic problem like dish alignment etc.)
! 109:
! 110: 2 = TS 204. If your card tunes OK, but the picture is terrible, seemingly
! 111: breaking up in one half continually, and crc fails a lot, then
! 112: this is worth a try (or trying to turn off)
! 113:
! 114: 4 = has symdiv. Some cards, mostly without new tuner packets, require
! 115: a symbol division algorithm. Doesn't apply to terrestial TV.
! 116:
! 117: You can also specify a value to have the autodetected values turned off
! 118: (e.g. 0). The autodected values are determined bythe cards 'response
! 119: string' which you can see in your logs e.g.
! 120:
! 121: dst_check_ci: recognize DST-MOT
! 122:
! 123: or
! 124:
! 125: dst_check_ci: unable to recognize DSTXCI or STXCI
1.1 holger 126:
127: Cheers,
1.2 honan 128: Richard Walker,
129:
130: addendum (without permission: mistakes are therefore mine)
131: Jamie Honan
1.1 holger 132:
LinuxTV legacy CVS <linuxtv.org/cvs>