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