162306a36Sopenharmony_ci.. SPDX-License-Identifier: GPL-2.0
262306a36Sopenharmony_ci
362306a36Sopenharmony_ciThe cx88 driver
462306a36Sopenharmony_ci===============
562306a36Sopenharmony_ci
662306a36Sopenharmony_ciAuthor:  Gerd Hoffmann
762306a36Sopenharmony_ci
862306a36Sopenharmony_ciThis is a v4l2 device driver for the cx2388x chip.
962306a36Sopenharmony_ci
1062306a36Sopenharmony_ci
1162306a36Sopenharmony_ciCurrent status
1262306a36Sopenharmony_ci--------------
1362306a36Sopenharmony_ci
1462306a36Sopenharmony_civideo
1562306a36Sopenharmony_ci	- Works.
1662306a36Sopenharmony_ci	- Overlay isn't supported.
1762306a36Sopenharmony_ci
1862306a36Sopenharmony_ciaudio
1962306a36Sopenharmony_ci	- Works. The TV standard detection is made by the driver, as the
2062306a36Sopenharmony_ci	  hardware has bugs to auto-detect.
2162306a36Sopenharmony_ci	- audio data dma (i.e. recording without loopback cable to the
2262306a36Sopenharmony_ci	  sound card) is supported via cx88-alsa.
2362306a36Sopenharmony_ci
2462306a36Sopenharmony_civbi
2562306a36Sopenharmony_ci	- Works.
2662306a36Sopenharmony_ci
2762306a36Sopenharmony_ci
2862306a36Sopenharmony_ciHow to add support for new cards
2962306a36Sopenharmony_ci--------------------------------
3062306a36Sopenharmony_ci
3162306a36Sopenharmony_ciThe driver needs some config info for the TV cards.  This stuff is in
3262306a36Sopenharmony_cicx88-cards.c.  If the driver doesn't work well you likely need a new
3362306a36Sopenharmony_cientry for your card in that file.  Check the kernel log (using dmesg)
3462306a36Sopenharmony_cito see whenever the driver knows your card or not.  There is a line
3562306a36Sopenharmony_cilike this one:
3662306a36Sopenharmony_ci
3762306a36Sopenharmony_ci.. code-block:: none
3862306a36Sopenharmony_ci
3962306a36Sopenharmony_ci	cx8800[0]: subsystem: 0070:3400, board: Hauppauge WinTV \
4062306a36Sopenharmony_ci		34xxx models [card=1,autodetected]
4162306a36Sopenharmony_ci
4262306a36Sopenharmony_ciIf your card is listed as "board: UNKNOWN/GENERIC" it is unknown to
4362306a36Sopenharmony_cithe driver.  What to do then?
4462306a36Sopenharmony_ci
4562306a36Sopenharmony_ci1) Try upgrading to the latest snapshot, maybe it has been added
4662306a36Sopenharmony_ci   meanwhile.
4762306a36Sopenharmony_ci2) You can try to create a new entry yourself, have a look at
4862306a36Sopenharmony_ci   cx88-cards.c.  If that worked, mail me your changes as unified
4962306a36Sopenharmony_ci   diff ("diff -u").
5062306a36Sopenharmony_ci3) Or you can mail me the config information.  We need at least the
5162306a36Sopenharmony_ci   following information to add the card:
5262306a36Sopenharmony_ci
5362306a36Sopenharmony_ci     - the PCI Subsystem ID ("0070:3400" from the line above,
5462306a36Sopenharmony_ci       "lspci -v" output is fine too).
5562306a36Sopenharmony_ci     - the tuner type used by the card.  You can try to find one by
5662306a36Sopenharmony_ci       trial-and-error using the tuner=<n> insmod option.  If you
5762306a36Sopenharmony_ci       know which one the card has you can also have a look at the
5862306a36Sopenharmony_ci       list in CARDLIST.tuner
59