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>