[linux-dvb] Patch 1 / 50: code reverse for bt8xx.txt

[Uwe Bugla]

#Applies against: 2.6.17
#Signed-off-by: Uwe Bugla <uwe.bugla at gmx.de>
#Changes: reduces information to a minimum, wipes out names that ontributed #nothing for documentation writing, but only for module writing (BIG 
#DIFFERENCE!), reduces documented cards who are not being autodetected in #all cases to one proven example (TwinHan)
--- a/Documentation/dvb/bt8xx.txt	2006-05-27 14:02:00
+++ b/Documentation/dvb/bt8xx.txt	2006-05-30 13:10:00
@@ -4,75 +4,39 @@
 1) General information
 ======================
 
-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:
+- the bt878a chip is the interface
+- the bttv driver accesses the i2c bus and the gpio pins of the bt8xx chipset
+- card types? => Documentation/dvb/cards.txt => o Cards based on the Conexant Bt8xx PCI bridge
+- creating device nodes? => Documentation/dvb/udev.txt
-
-Compiling kernel please enable:
+- compile kernel:
 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"
+   => "DVB for Linux" "DVB Core Support" "Bt8xx based PCI Cards"
 
 2) Loading Modules
 ==================
 
-In default cases bttv is loaded automatically.
-To load the backend either place dvb-bt8xx in etc/modules, or apply manually:
+- default cases: bttv and all frontends are loaded automatically
+- add to etc/modules: dvb-bt8xx
 
-	$ modprobe dvb-bt8xx
-
-All frontends will be loaded automatically.
-People running udev please see Documentation/dvb/udev.txt.
-
-In the following cases overriding the PCI type detection for dvb-bt8xx might be necessary:
-
-2a) Running TwinHan and Clones
-------------------------------
+Exception:
+----------
+- TwinHan and Clones: overriding autodetection might be necessary
+
+a) standalone:
-
-	$ modprobe bttv card=113
-	$ modprobe dvb-bt8xx
-	$ modprobe dst
+- add to etc/modules: dvb-bt8xx
+		      dst
+- add to etc/modules.conf or etc/modprobe.conf: options bttv card=113
+- optionally add to etc/modules.conf or etc/modprobe.conf: options dst verbose=(1-4) dst_addons=0x20
+- verbose=1: only error messages, 2: notifications, 3: other messages, 4: debug setting
+- dst_addons=0x20: card owns conditional access slot for scrambled channels
-
-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
-
+- unscramble channels? => Documentation/dvb/ci.txt
+- technical info about the dst module? => Documentation/dvb/dst.txt
+
+b) >= 2 cards in a box:
+- card ID order should be uprising:
+- add to etc/modules.conf or etc/modprobe.conf f. ex.: options bttv card=113 card=135
+- card ID list? => Documentation/video4linux/CARDLIST.bttv
+- questions? Subscribe to mailing list: www.linuxdvb.org
+
+- Uwe Bugla, May 30th, 2006
-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
---------------------------
-
-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
-
-Notice: The order of the card ID should be uprising:
-Example:
-	$ modprobe bttv card=113 card=135
-	$ modprobe dvb-bt8xx
-
-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,
-	 Michael Krufky


-- 


Der GMX SmartSurfer hilft bis zu 70% Ihrer Onlinekosten zu sparen!
Ideal für Modem und ISDN: http://www.gmx.net/de/go/smartsurfer