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>