1How to get the bt8xx cards working
2==================================
3
41) General information
5======================
6
7This class of cards has a bt878a as the PCI interface, and require the bttv driver
8for accessing the i2c bus and the gpio pins of the bt8xx chipset.
9Please see Documentation/dvb/cards.txt => o Cards based on the Conexant Bt8xx PCI bridge:
10
11Compiling kernel please enable:
12a.)"Device drivers" => "Multimedia devices" => "Video For Linux" => "Enable Video for Linux API 1 (DEPRECATED)"
13b.)"Device drivers" => "Multimedia devices" => "Video For Linux" => "Video Capture Adapters" => "BT848 Video For Linux"
14c.)"Device drivers" => "Multimedia devices" => "Digital Video Broadcasting Devices" => "DVB for Linux" "DVB Core Support" "Bt8xx based PCI Cards"
15
16Please use the following options with care as deselection of drivers which are in fact necessary
17may result in DVB devices that cannot be tuned due to lack of driver support:
18You can save RAM by deselecting every frontend module that your DVB card does not need.
19
20First please remove the static dependency of DVB card drivers on all frontend modules for all possible card variants by enabling:
21d.) "Device drivers" => "Multimedia devices" => "Digital Video Broadcasting Devices"
22 => "DVB for Linux" "DVB Core Support" "Load and attach frontend modules as needed"
23
24If you know the frontend driver that your card needs please enable:
25e.)"Device drivers" => "Multimedia devices" => "Digital Video Broadcasting Devices"
26 => "DVB for Linux" "DVB Core Support" "Customise DVB Frontends" => "Customise the frontend modules to build"
27 Then please select your card-specific frontend module.
28
292) Loading Modules
30==================
31
32Regular case: If the bttv driver detects a bt8xx-based DVB card, all frontend and backend modules will be loaded automatically.
33Exceptions are:
34- Old TwinHan DST cards or clones with or without CA slot and not containing an Eeprom.
35People running udev please see Documentation/dvb/udev.txt.
36
37In the following cases overriding the PCI type detection for dvb-bt8xx might be necessary:
38
392a) Running TwinHan and Clones
40------------------------------
41
42	$ modprobe bttv card=113
43	$ modprobe dst
44
45Useful parameters for verbosity level and debugging the dst module:
46
47verbose=0:		messages are disabled
48	1:		only error messages are displayed
49	2:		notifications are displayed
50	3:		other useful messages are displayed
51	4:		debug setting
52dst_addons=0:		card is a free to air (FTA) card only
53	   0x20:	card has a conditional access slot for scrambled channels
54
55The autodetected values are determined by the cards' "response string".
56In your logs see f. ex.: dst_get_device_id: Recognize [DSTMCI].
57For bug reports please send in a complete log with verbose=4 activated.
58Please also see Documentation/dvb/ci.txt.
59
602b) Running multiple cards
61--------------------------
62
63Examples of card ID's:
64
65Pinnacle PCTV Sat:		 94
66Nebula Electronics Digi TV:	104
67pcHDTV HD-2000 TV:		112
68Twinhan DST and clones:		113
69Avermedia AverTV DVB-T 771:	123
70Avermedia AverTV DVB-T 761:	124
71DViCO FusionHDTV DVB-T Lite:	128
72DViCO FusionHDTV 5 Lite:	135
73
74Notice: The order of the card ID should be uprising:
75Example:
76	$ modprobe bttv card=113 card=135
77
78For a full list of card ID's please see Documentation/video4linux/CARDLIST.bttv.
79In case of further problems please subscribe and send questions to the mailing list: linux-dvb@linuxtv.org.
80
812c) Probing the cards with broken PCI subsystem ID
82--------------------------------------------------
83There are some TwinHan cards that the EEPROM has become corrupted for some
84reason. The cards do not have correct PCI subsystem ID. But we can force
85probing the cards with broken PCI subsystem ID
86
87	$ echo 109e 0878 $subvendor $subdevice > \
88		/sys/bus/pci/drivers/bt878/new_id
89
90109e: PCI_VENDOR_ID_BROOKTREE
910878: PCI_DEVICE_ID_BROOKTREE_878
92
93Authors: Richard Walker,
94	 Jamie Honan,
95	 Michael Hunold,
96	 Manu Abraham,
97	 Uwe Bugla,
98	 Michael Krufky
99