Fix typos in Documentation/: 'B'-'C'
[safe/jmp/linux-2.6] / Documentation / dvb / bt8xx.txt
index e6b8d05..4e7614e 100644 (file)
@@ -1,55 +1,78 @@
-How to get the Nebula Electronics DigiTV, Pinnacle PCTV Sat, Twinhan DST + clones working
-=========================================================================================
+How to get the bt8xx cards working
+==================================
 
 1) General information
 ======================
 
-This class of cards has a bt878a chip as the PCI interface.
-The different card drivers require the bttv driver to provide the means
-to access the i2c bus and the gpio pins of the bt8xx chipset.
+This class of cards has a bt878a as the PCI interface, and require the bttv driver
+for accessing the i2c bus and the gpio pins of the bt8xx chipset.
+Please see Documentation/dvb/cards.txt => o Cards based on the Conexant Bt8xx PCI bridge:
 
-2) Compilation rules for Kernel >= 2.6.12
-=========================================
+Compiling kernel please enable:
+a.)"Device drivers" => "Multimedia devices" => "Video For Linux" => "BT848 Video For Linux"
+b.)"Device drivers" => "Multimedia devices" => "Digital Video Broadcasting Devices"
+ => "DVB for Linux" "DVB Core Support" "Bt8xx based PCI Cards"
 
-Enable the following options:
+2) Loading Modules
+==================
 
-"Device drivers" => "Multimedia devices"
- => "Video For Linux" => "BT848 Video For Linux"
-"Device drivers" => "Multimedia devices" => "Digital Video Broadcasting Devices"
- => "DVB for Linux" "DVB Core Support" "Nebula/Pinnacle PCTV/TwinHan PCI Cards"
+In default cases bttv is loaded automatically.
+To load the backend either place dvb-bt8xx in etc/modules, or apply manually:
 
-3) Loading Modules, described by two approaches
-===============================================
+       $ modprobe dvb-bt8xx
 
-In general you need to load the bttv driver, which will handle the gpio and
-i2c communication for us, plus the common dvb-bt8xx device driver,
-which is called the backend.
-The frontends for Nebula DigiTV (nxt6000), Pinnacle PCTV Sat (cx24110),
-TwinHan DST + clones (dst and dst-ca) are loaded automatically by the backend.
-For further details about TwinHan DST + clones see /Documentation/dvb/ci.txt.
+All frontends will be loaded automatically.
+People running udev please see Documentation/dvb/udev.txt.
 
-3a) The manual approach
------------------------
+In the following cases overriding the PCI type detection for dvb-bt8xx might be necessary:
 
-Loading modules:
-modprobe bttv
-modprobe dvb-bt8xx
+2a) Running TwinHan and Clones
+------------------------------
 
-Unloading modules:
-modprobe -r dvb-bt8xx
-modprobe -r bttv
+       $ modprobe bttv card=113
+       $ modprobe dvb-bt8xx
+       $ modprobe dst
 
-3b) The automatic approach
+Useful parameters for verbosity level and debugging the dst module:
+
+verbose=0:             messages are disabled
+       1:              only error messages are displayed
+       2:              notifications are displayed
+       3:              other useful messages are displayed
+       4:              debug setting
+dst_addons=0:          card is a free to air (FTA) card only
+          0x20:        card has a conditional access slot for scrambled channels
+
+The autodetected values are determined by the cards' "response string".
+In your logs see f. ex.: dst_get_device_id: Recognize [DSTMCI].
+For bug reports please send in a complete log with verbose=4 activated.
+Please also see Documentation/dvb/ci.txt.
+
+2b) Running multiple cards
 --------------------------
 
-If not already done by installation, place a line either in
-/etc/modules.conf or in /etc/modprobe.conf containing this text:
-alias char-major-81    bttv
+Examples of card ID's:
+
+Pinnacle PCTV Sat:              94
+Nebula Electronics Digi TV:    104
+pcHDTV HD-2000 TV:             112
+Twinhan DST and clones:                113
+Avermedia AverTV DVB-T 771:    123
+Avermedia AverTV DVB-T 761:    124
+DViCO FusionHDTV DVB-T Lite:   128
+DViCO FusionHDTV 5 Lite:       135
 
-Then place a line in /etc/modules containing this text:
-dvb-bt8xx
+Notice: The order of the card ID should be uprising:
+Example:
+       $ modprobe bttv card=113 card=135
+       $ modprobe dvb-bt8xx
 
-Reboot your system and have fun!
+For a full list of card ID's please see Documentation/video4linux/CARDLIST.bttv.
+In case of further problems send questions to the mailing list: www.linuxdvb.org.
 
---
-Authors: Richard Walker, Jamie Honan, Michael Hunold, Manu Abraham, Uwe Bugla
+Authors: Richard Walker,
+        Jamie Honan,
+        Michael Hunold,
+        Manu Abraham,
+        Uwe Bugla,
+        Michael Krufky