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