[deliverable/linux.git] / Documentation / media / dvb-drivers / bt8xx.rst

How to get the bt8xx cards working
==================================

Authors: Richard Walker,
	 Jamie Honan,
	 Michael Hunold,
	 Manu Abraham,
	 Uwe Bugla,
	 Michael Krufky

.. note::

   This documentation is outdated. Please check at the DVB wiki
   at https://linuxtv.org/wiki for more updated info.

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:

Compiling kernel please enable:

#) ``Device drivers`` => ``Multimedia devices`` => ``Video For Linux`` => ``Enable Video for Linux API 1 (DEPRECATED)``
#) ``Device drivers`` => ``Multimedia devices`` => ``Video For Linux`` => ``Video Capture Adapters`` => ``BT848 Video For Linux``
#) ``Device drivers`` => ``Multimedia devices`` => ``Digital Video Broadcasting Devices`` => ``DVB for Linux`` ``DVB Core Support`` ``Bt8xx based PCI Cards``

  Please use the following options with care as deselection of drivers which are in fact necessary may result in DVB devices that cannot be tuned due to lack of driver support:
  You can save RAM by deselecting every frontend module that your DVB card does not need.

  First please remove the static dependency of DVB card drivers on all frontend modules for all possible card variants by enabling:

#) ``Device drivers`` => ``Multimedia devices`` => ``Digital Video Broadcasting Devices`` => ``DVB for Linux`` ``DVB Core Support`` ``Load and attach frontend modules as needed``

  If you know the frontend driver that your card needs please enable:

#) ``Device drivers`` => ``Multimedia devices`` => ``Digital Video Broadcasting Devices`` => ``DVB for Linux`` ``DVB Core Support`` ``Customise DVB Frontends`` => ``Customise the frontend modules to build``

 Then please select your card-specific frontend module.

Loading Modules
---------------

Regular case: If the bttv driver detects a bt8xx-based DVB card, all frontend and backend modules will be loaded automatically.
Exceptions are:
- Old TwinHan DST cards or clones with or without CA slot and not containing an Eeprom.
People running udev please see Documentation/dvb/udev.txt.

In the following cases overriding the PCI type detection for dvb-bt8xx might be necessary:

Running TwinHan and Clones
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code-block:: none

	$ modprobe bttv card=113
	$ modprobe dst

Useful parameters for verbosity level and debugging the dst module:

.. code-block:: none

	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

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.

Running multiple cards
~~~~~~~~~~~~~~~~~~~~~~

Examples of card ID's:

.. code-block:: none

	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

.. note::

   The order of the card ID should be uprising:

   Example:

   .. code-block:: none

	$ modprobe bttv card=113 card=135

For a full list of card ID's please see Documentation/video4linux/CARDLIST.bttv.
In case of further problems please subscribe and send questions to the mailing list: linux-dvb@linuxtv.org.

Probing the cards with broken PCI subsystem ID
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

There are some TwinHan cards that the EEPROM has become corrupted for some
reason. The cards do not have correct PCI subsystem ID. But we can force
probing the cards with broken PCI subsystem ID

.. code-block:: none

	$ echo 109e 0878 $subvendor $subdevice > \
		/sys/bus/pci/drivers/bt878/new_id

.. code-block:: none

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