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