Documentation/admin-guide/media/cx88.rst

   1 .. SPDX-License-Identifier: GPL-2.0
   2
   3 The cx88 driver
   4 ===============
   5
   6 Author:  Gerd Hoffmann
   7
   8 This is a v4l2 device driver for the cx2388x chip.
   9
  10
  11 Current status
  12 --------------
  13
  14 video
  15         - Works.
  16         - Overlay isn't supported.
  17
  18 audio
  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
  24 vbi
  25         - Works.
  26
  27
  28 How to add support for new cards
  29 --------------------------------
  30
  31 The driver needs some config info for the TV cards.  This stuff is in
  32 cx88-cards.c.  If the driver doesn't work well you likely need a new
  33 entry for your card in that file.  Check the kernel log (using dmesg)
  34 to see whenever the driver knows your card or not.  There is a line
  35 like this one:
  36
  37 .. code-block:: none
  38
  39         cx8800[0]: subsystem: 0070:3400, board: Hauppauge WinTV \
  40                 34xxx models [card=1,autodetected]
  41
  42 If your card is listed as "board: UNKNOWN/GENERIC" it is unknown to
  43 the driver.  What to do then?
  44
  45 1) Try upgrading to the latest snapshot, maybe it has been added
  46    meanwhile.
  47 2) 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").
  50 3) 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