--- dvb-kernel/README.bt8xx 2003/10/28 22:53:10 1.3 +++ dvb-kernel/README.bt8xx 2003/11/25 12:27:33 1.4 @@ -1,7 +1,5 @@ -Original Richard Walker -Modified Jamie Honan, 13 Oct 2003 - -How to get the Nebula, PCTV and Twinhan DST cards working, +How to get the Nebula, PCTV and Twinhan DST cards working +========================================================= This class of cards has a bt878a as the PCI interface, and require the bttv driver. @@ -10,92 +8,86 @@ Please pay close attention to the warnin options below for the DST card. 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 -because of it's multimedia latency support, and ease of build. +For 2.6, shuffle down to the 2.6 section below. + +1) 2.4 +====== -2.4 -=== 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 -bleeding-edge stuff like DVB and Dxr3. Do the usual to build your kernel. -(remember to enable the V4L functionality) I'd recommend you install and -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 +bleeding-edge stuff like DVB. Do the usual to build your kernel. +(remember to enable the V4L functionality) -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 -you are using kernel 2.5.x (or 2.6.x) then V4L2 is built-in. +Download http://bytesex.org/snapshot/video4linux-xxxxyyzz.tar.gz, where +xxxxyyzz is the date of the release. -You need to use 'dvb-kernel', along with 'bttv' to talk to your card. - -Download http://bytesex.org/bttv/bttv-0.9.12.tar.gz or above and unpack it. -This is the first version that will not hang your card. -You may find this in the http://bytesex.org/snapshots directory. - -Using this version of - -Grab dvb-kernel from CVS: +Extract it and do the usual "make" and "make install". + $ tar xzfv video4linux-xxxxyyzz.tar.gz + $ make + $ make install + +Now grab "dvb-kernel" from CVS: $ cvs -d :pserver:anonymous@linuxtv.org:/cvs/linuxtv login $ cvs -d :pserver:anonymous@linuxtv.org:/cvs/linuxtv co dvb-kernel -No patching of bttv is required from any patches in the dvb-kernel -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: +... and build the driver: $ cd dvb-kernel/build-2.4 $ ./getlinks $ make $ make install -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. +2) 2.6 +====== -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 -to start and stop your drivers. +Checkout dvb-kernel as mentionen above, but then do everything as per +the README in dvb-kernel. -The insmod script should be modified so that one of: +3) Loading Modules +================== - # Nebula - insmod nxt6000.o - # or Pinnacle PCTV - insmod cx24110.o - # or DST - insmod dst.o +You can either modify and use the "insmod-bt8xx.sh" script in the build-2.4 +directory or simply do everything by hand. -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 - - insmod bttv.o i2c_hw=1 card=0x68 - -The bttv driver will HANG YOUR SYSTEM IF YOU DO NOT SPECIFY THE CARD -FOR THE DST! +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 +the bttv driver package. Pay attention to failures to load these frontends. (E.g. dmesg, /var/log/messages). -For DST cards, you can also use card type 0x71 for bttv module params, -providing the bttv version supports this. (The ones from bytesex/snapshots do). +3a) Nebula / Pinnacle PCTV +-------------------------- + + $ 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 -for dvb-bt8xx. +The value 0x71 will override the PCI type detection for dvb-bt8xx, which +is necessary for TwinHan cards. The DST module takes a couple of useful parameters, in case the dst drivers fails to detect your type of card correctly. @@ -124,9 +116,13 @@ or dst_check_ci: unable to recognize DSTXCI or STXCI -Cheers, -Richard Walker, +4) The rest +=========== -addendum (without permission: mistakes are therefore mine) -Jamie Honan +That's it. Have fun. Report problems to the mailing list. Thanks! +-- +Authors: +Richard Walker (Original) +Jamie Honan (13 Oct 2003) +Michael Hunold (25 Nov 2003)