1 .. SPDX-License-Identifier: GPL-2.0
2
3 ==================================
4 How to get the bt8xx cards working
5 ==================================
6
7 Authors:
8 Richard Walker,
9 Jamie Honan,
10 Michael Hunold,
11 Manu Abraham,
12 Uwe Bugla,
13 Michael Krufky
14
15 General information
16 -------------------
17
18 This class of cards has a bt878a as the PCI in
19 driver for accessing the i2c bus and the gpio
20
21 Please see Documentation/admin-guide/media/btt
22 list of Cards based on the Conexant Bt8xx PCI
23 Linux Kernel.
24
25 In order to be able to compile the kernel, som
26 enabled::
27
28 ./scripts/config -e PCI
29 ./scripts/config -e INPUT
30 ./scripts/config -m I2C
31 ./scripts/config -m MEDIA_SUPPORT
32 ./scripts/config -e MEDIA_PCI_SUPPORT
33 ./scripts/config -e MEDIA_ANALOG_TV_SUPPOR
34 ./scripts/config -e MEDIA_DIGITAL_TV_SUPPO
35 ./scripts/config -e MEDIA_RADIO_SUPPORT
36 ./scripts/config -e RC_CORE
37 ./scripts/config -m VIDEO_BT848
38 ./scripts/config -m DVB_BT8XX
39
40 If you want to automatically support all possi
41 cards, you should also do::
42
43 ./scripts/config -e MEDIA_SUBDRV_AUTOSELEC
44
45 .. note::
46
47 Please use the following options with care
48 are in fact necessary may result in DVB dev
49 to lack of driver support.
50
51 If your goal is to just support an specific bo
52 disable MEDIA_SUBDRV_AUTOSELECT and manually s
53 required by your board. With that, you can sav
54
55 You can do that by calling make xconfig/qconfi
56 the options on those menu options (only enable
57 ``Autoselect ancillary drivers`` is disabled:
58
59 #) ``Device drivers`` => ``Multimedia support`
60 #) ``Device drivers`` => ``Multimedia support`
61
62 Then, on each of the above menu, please select
63 frontend and tuner modules.
64
65
66 Loading Modules
67 ---------------
68
69 Regular case: If the bttv driver detects a bt8
70 frontend and backend modules will be loaded au
71
72 Exceptions are:
73
74 - Old TV cards without EEPROMs, sharing a comm
75 - Old TwinHan DST cards or clones with or with
76 containing an Eeprom.
77
78 In the following cases overriding the PCI type
79 for dvb-bt8xx drivers by passing modprobe para
80
81 Running TwinHan and Clones
82 ~~~~~~~~~~~~~~~~~~~~~~~~~~
83
84 As shown at Documentation/admin-guide/media/bt
85 clones use ``card=113`` modprobe parameter. So
86 detect it for devices without EEPROM, you shou
87
88 $ modprobe bttv card=113
89 $ modprobe dst
90
91 Useful parameters for verbosity level and debu
92
93 verbose=0: messages are d
94 1: only error mes
95 2: notifications
96 3: other useful m
97 4: debug setting
98 dst_addons=0: card is a free
99 0x20: card has a conditional
100 dst_algo=0: (default) Soft
101 1: Hardware tunin
102
103
104 The autodetected values are determined by the
105
106 In your logs see f. ex.: dst_get_device_id: Re
107
108 For bug reports please send in a complete log
109 Please also see Documentation/admin-guide/medi
110
111 Running multiple cards
112 ~~~~~~~~~~~~~~~~~~~~~~
113
114 See Documentation/admin-guide/media/bttv-cardl
115 Card ID. Some examples:
116
117 =========================== ===
118 Brand name ID
119 =========================== ===
120 Pinnacle PCTV Sat 94
121 Nebula Electronics Digi TV 104
122 pcHDTV HD-2000 TV 112
123 Twinhan DST and clones 113
124 Avermedia AverTV DVB-T 77: 123
125 Avermedia AverTV DVB-T 761 124
126 DViCO FusionHDTV DVB-T Lite 128
127 DViCO FusionHDTV 5 Lite 135
128 =========================== ===
129
130 .. note::
131
132 When you have multiple cards, the order of
133 match the order where they're detected by t
134 that removing/inserting other PCI cards may
135 order.
136
137 Example::
138
139 $ modprobe bttv card=113 card=135
140
141 In case of further problems please subscribe a
142 the mailing list: linux-media@vger.kernel.org.
143
144 Probing the cards with broken PCI subsystem ID
145 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
146
147 There are some TwinHan cards whose EEPROM has
148 reason. The cards do not have a correct PCI su
149 Still, it is possible to force probing the car
150
151 $ echo 109e 0878 $subvendor $subdevice
152 /sys/bus/pci/drivers/bt878/new
153
154 The two numbers there are::
155
156 109e: PCI_VENDOR_ID_BROOKTREE
157 0878: PCI_DEVICE_ID_BROOKTREE_878
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.