[linux-dvb] Patch for /Documentation/dvb/bt8xx.txt, Revision 2

[Uwe Bugla]

Changes:
- rewrote document from scratch
- reduced the card ID reference to one proven exception (TwinHan)
- added cross references (=>)
- added a date to show actual state of development
- short, precise, compact info now
- no more endless author list

Applies against: Kernel 2.6.16-mm1
Signed-off-by: Uwe Bugla <uwe.bugla at gmx.de>

--- /Documentation/dvb/bt8xx.txt Wed Mar 23 19:37:00 2006
+++ /Documentation/dvb/bt8xx.txt Mon Mar 27 12:51:00 2006
@@ -4,75 +4,44 @@
 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 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:
+Compiling 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
+Load backend: a) put dvb-bt8xx in etc/modules or b) apply manually:
 
 	$ 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
 
+Parameters for dst:
-Useful parameters for verbosity level and debugging the dst module:
-
-verbose=0:		messages are disabled
-	1:		only error messages are displayed
+verbose=1:		only error messages
-	2:		notifications are displayed
-	3:		other useful messages are displayed
-	4:		debug setting
+	2:		notifications
+	3:		other useful messages
+	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
+dst_addons=0x20:	card owns conditional access slot for scrambled channels
-
+- Unscramble channels? => Documentation/dvb/ci.txt
+
+b) >= 2 cards in a box: Card ID order should be uprising: Example:
+
+	$ modprobe bttv card=113 card=135
+
+- Card ID list? => Documentation/video4linux/CARDLIST.bttv
+- Questions? Suscribe to mailing list: www.linuxdvb.org
+
+Uwe Bugla, March 27th, 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

-- 
Bis zu 70% Ihrer Onlinekosten sparen: GMX SmartSurfer!
Kostenlos downloaden: http://www.gmx.net/de/go/smartsurfer