Documentation/media/v4l-drivers/cx88.rst

   1 The cx88 driver
   2 ===============
   3
   4 .. note::
   5
   6    This documentation is outdated.
   7
   8 cx8800 release notes
   9 --------------------
  10
  11 This is a v4l2 device driver for the cx2388x chip.
  12
  13
  14 current status
  15 --------------
  16
  17 video
  18         - Basically works.
  19         - For now, only capture and read(). Overlay isn't supported.
  20
  21 audio
  22         - The chip specs for the on-chip TV sound decoder are next
  23           to useless :-/
  24         - Neverless the builtin TV sound decoder starts working now,
  25           at least for some standards.
  26           FOR ANY REPORTS ON THIS PLEASE MENTION THE TV NORM YOU ARE
  27           USING.
  28         - Most tuner chips do provide mono sound, which may or may not
  29           be useable depending on the board design.  With the Hauppauge
  30           cards it works, so there is mono sound available as fallback.
  31         - audio data dma (i.e. recording without loopback cable to the
  32           sound card) is supported via cx88-alsa.
  33
  34 vbi
  35         - Code present. Works for NTSC closed caption. PAL and other
  36           TV norms may or may not work.
  37
  38
  39 how to add support for new cards
  40 --------------------------------
  41
  42 The driver needs some config info for the TV cards.  This stuff is in
  43 cx88-cards.c.  If the driver doesn't work well you likely need a new
  44 entry for your card in that file.  Check the kernel log (using dmesg)
  45 to see whenever the driver knows your card or not.  There is a line
  46 like this one:
  47
  48 .. code-block:: none
  49
  50         cx8800[0]: subsystem: 0070:3400, board: Hauppauge WinTV \
  51                 34xxx models [card=1,autodetected]
  52
  53 If your card is listed as "board: UNKNOWN/GENERIC" it is unknown to
  54 the driver.  What to do then?
  55
  56  (1) Try upgrading to the latest snapshot, maybe it has been added
  57      meanwhile.
  58  (2) You can try to create a new entry yourself, have a look at
  59      cx88-cards.c.  If that worked, mail me your changes as unified
  60      diff ("diff -u").
  61  (3) Or you can mail me the config information.  I need at least the
  62      following information to add the card:
  63
  64      * the PCI Subsystem ID ("0070:3400" from the line above,
  65        "lspci -v" output is fine too).
  66      * the tuner type used by the card.  You can try to find one by
  67        trial-and-error using the tuner=<n> insmod option.  If you
  68        know which one the card has you can also have a look at the
  69        list in CARDLIST.tuner
  70
  71 Have fun,
  72
  73   Gerd
  74
  75 --
  76 Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]