Diff for /dvb-kernel/README.bt8xx between versions 1.3 and 1.4

version 1.3, 2003/10/28 22:53:10 version 1.4, 2003/11/25 12:27:33
Line 1 Line 1
 Original Richard Walker  How to get the Nebula, PCTV and Twinhan DST cards working
 Modified Jamie Honan, 13 Oct 2003  =========================================================
   
 How to get the Nebula, PCTV and Twinhan DST cards working,  
   
 This class of cards has a bt878a as the PCI interface, and  This class of cards has a bt878a as the PCI interface, and
 require the bttv driver.  require the bttv driver.
Line 10  Please pay close attention to the warnin Line 8  Please pay close attention to the warnin
 options below for the DST card.  options below for the DST card.
   
 For 2.4, make sure you are using an uptodate kernel 2.4.23 and above.  For 2.4, make sure you are using an uptodate kernel 2.4.23 and above.
 For 2.6, shuffle down to the 2.6 section below. 2.6 is recommended  For 2.6, shuffle down to the 2.6 section below.
 because of it's multimedia latency support, and ease of build.  
   1) 2.4
   ======
   
 2.4  
 ===  
 For 2.4, make sure you are using an uptodate kernel 2.4.23 and above.  For 2.4, make sure you are using an uptodate kernel 2.4.23 and above.
 This is the *only* way to go when you are experimenting with   This is the *only* way to go when you are experimenting with 
 bleeding-edge stuff like DVB and Dxr3.  Do the usual to build your kernel.    bleeding-edge stuff like DVB. Do the usual to build your kernel.  
 (remember to enable the V4L functionality)  I'd recommend you install and   (remember to enable the V4L functionality) 
 test your kernel, rather than diving straight into the bt878 stuff.  
   
 Download http://bytesex.org/patches/2.4.xxx/11-v4l2-api-2.4.xxxxxx.diff.gz and   
 apply this to your kernel source tree.  For example:  
   
   $ cd /usr/src  
   $ patch -p0 < ~/11-v4l2-api-2.4.xxxx-rc4.diff  
   
 This will patch your kernel to include support for VideoForLinux 2.  I'd recommend you install and  test your kernel, rather than diving
   straight into the bt878 stuff.
   
 For those who don't know, kernels < 2.5 only support V4L 1 out-of-the-box. If   Download http://bytesex.org/snapshot/video4linux-xxxxyyzz.tar.gz, where
 you are using kernel 2.5.x (or 2.6.x) then V4L2 is built-in.  xxxxyyzz is the date of the release.
   
 You need to use 'dvb-kernel', along with 'bttv' to talk to your card.  Extract it and do the usual "make" and "make install".
     $ tar xzfv video4linux-xxxxyyzz.tar.gz
 Download http://bytesex.org/bttv/bttv-0.9.12.tar.gz or above and unpack it.    $ make
 This is the first version that will not hang your card.    $ make install
 You may find this in the http://bytesex.org/snapshots directory.    
   Now grab "dvb-kernel" from CVS:
 Using this version of  
   
 Grab dvb-kernel from CVS:  
   
   $ cvs -d :pserver:anonymous@linuxtv.org:/cvs/linuxtv login    $ cvs -d :pserver:anonymous@linuxtv.org:/cvs/linuxtv login
   $ cvs -d :pserver:anonymous@linuxtv.org:/cvs/linuxtv co dvb-kernel    $ cvs -d :pserver:anonymous@linuxtv.org:/cvs/linuxtv co dvb-kernel
   
 No patching of bttv is required from any patches in the dvb-kernel  ... and build the driver:
 tree. (You do have to do the v4l stuff above).  
   
 Not, at last, the DVB stuff can be built!  Just do it the usual way:  
   
   $ cd dvb-kernel/build-2.4    $ cd dvb-kernel/build-2.4
   $ ./getlinks    $ ./getlinks
   $ make    $ make
   $ make install    $ make install
   
 2.6  2) 2.6
 ===  ======
 For 2.6, life is a lot easier, assuming you use 2.6.0-test7 and above.  
 The bttv does not need to be patched.   
   
 Checkout dvb-kernel.  
   
 Do everything as per the README in dvb-kernel.  
   
 Loading Modules  For 2.6, you don't need the latest bttv driver, everything is in
 ===============  the kernel drivers. Please use 2.6.0-test10 and above.
   
 Use and modify the insmod-bt8xx.sh script in the build-2.4 directory   Checkout dvb-kernel as mentionen above, but then do everything as per
 to start and stop your drivers.    the README in dvb-kernel.
   
 The insmod script should be modified so that one of:  3) Loading Modules
   ==================
   
         # Nebula  You can either modify and use the "insmod-bt8xx.sh" script in the build-2.4
         insmod nxt6000.o  directory or simply do everything by hand.
         # or Pinnacle PCTV  
         insmod cx24110.o  
         # or DST  
         insmod dst.o  
   
 is selected as a frontend.  In general you need to load the bttv driver, which will handle the gpio and
   i2c communication for us. Next you need the common dvb-bt8xx device driver
   and one frontend driver.
   
 Note well. The   The bttv driver will HANG YOUR SYSTEM IF YOU DO NOT SPECIFY THE COORECT 
   CARD ID! A list of possible card ids can be found inside "bttv-cards.c" inside
         insmod bttv.o i2c_hw=1 card=0x68  the bttv driver package. 
   
 The bttv driver will HANG YOUR SYSTEM IF YOU DO NOT SPECIFY THE CARD  
 FOR THE DST!  
   
 Pay attention to failures to load these frontends.   Pay attention to failures to load these frontends. 
 (E.g. dmesg, /var/log/messages).  (E.g. dmesg, /var/log/messages).
   
 For DST cards, you can also use card type 0x71 for bttv module params,   3a) Nebula / Pinnacle PCTV
 providing the bttv version supports this. (The ones from bytesex/snapshots do).  --------------------------
   
      $ modprobe bttv i2c_hw=1 card=0x68
      $ modprobe dvb-bt8xx
      
   For Nebula cards use the "nxt6000" frontend driver:
      $ modprobe nxt6000
   
   For Pinnacle PCTV cards use the "cx24110" frontend driver:
      $ modprobe cx24110
   
   3b) TwinHan
   -----------
   
      $ modprobe bttv i2c_hw=1 card=0x71
      $ modprobe dvb-bt8xx
      $ modprobe dst
   
 If you use this value, 0x71, it will override the PCI type detection  The value 0x71 will override the PCI type detection for dvb-bt8xx, which 
 for dvb-bt8xx.  is necessary for TwinHan cards. 
   
 The DST module takes a couple of useful parameters, in case the  The DST module takes a couple of useful parameters, in case the
 dst drivers fails to detect your type of card correctly.  dst drivers fails to detect your type of card correctly.
Line 124  or Line 116  or
   
 dst_check_ci: unable to recognize DSTXCI or STXCI  dst_check_ci: unable to recognize DSTXCI or STXCI
   
 Cheers,  4) The rest
 Richard Walker,   ===========
   
 addendum (without permission: mistakes are therefore mine)   That's it. Have fun. Report problems to the mailing list. Thanks!
 Jamie Honan  
   
   --
   Authors:
   Richard Walker (Original)
   Jamie Honan (13 Oct 2003)
   Michael Hunold (25 Nov 2003)

Removed from v.1.3  
changed lines
  Added in v.1.4


LinuxTV legacy CVS <linuxtv.org/cvs>