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