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>