xref: /linux/Documentation/admin-guide/media/cx88.rst (revision e7d759f31ca295d589f7420719c311870bb3166f)
1.. SPDX-License-Identifier: GPL-2.0
2
3The cx88 driver
4===============
5
6Author:  Gerd Hoffmann
7
8This is a v4l2 device driver for the cx2388x chip.
9
10
11Current status
12--------------
13
14video
15	- Works.
16	- Overlay isn't supported.
17
18audio
19	- Works. The TV standard detection is made by the driver, as the
20	  hardware has bugs to auto-detect.
21	- audio data dma (i.e. recording without loopback cable to the
22	  sound card) is supported via cx88-alsa.
23
24vbi
25	- Works.
26
27
28How to add support for new cards
29--------------------------------
30
31The driver needs some config info for the TV cards.  This stuff is in
32cx88-cards.c.  If the driver doesn't work well you likely need a new
33entry for your card in that file.  Check the kernel log (using dmesg)
34to see whenever the driver knows your card or not.  There is a line
35like this one:
36
37.. code-block:: none
38
39	cx8800[0]: subsystem: 0070:3400, board: Hauppauge WinTV \
40		34xxx models [card=1,autodetected]
41
42If your card is listed as "board: UNKNOWN/GENERIC" it is unknown to
43the driver.  What to do then?
44
451) Try upgrading to the latest snapshot, maybe it has been added
46   meanwhile.
472) You can try to create a new entry yourself, have a look at
48   cx88-cards.c.  If that worked, mail me your changes as unified
49   diff ("diff -u").
503) Or you can mail me the config information.  We need at least the
51   following information to add the card:
52
53     - the PCI Subsystem ID ("0070:3400" from the line above,
54       "lspci -v" output is fine too).
55     - the tuner type used by the card.  You can try to find one by
56       trial-and-error using the tuner=<n> insmod option.  If you
57       know which one the card has you can also have a look at the
58       list in CARDLIST.tuner
59