1
2Release notes for bttv
3======================
4
5You'll need at least these config options for bttv:
6	CONFIG_I2C=m
7	CONFIG_I2C_ALGOBIT=m
8	CONFIG_VIDEO_DEV=m
9
10The latest bttv version is available from http://bytesex.org/bttv/
11
12
13Make bttv work with your card
14-----------------------------
15
16Just try "modprobe bttv" and see if that works.
17
18If it doesn't bttv likely could not autodetect your card and needs some
19insmod options.  The most important insmod option for bttv is "card=n"
20to select the correct card type.  If you get video but no sound you've
21very likely specified the wrong (or no) card type.  A list of supported
22cards is in CARDLIST.bttv
23
24If bttv takes very long to load (happens sometimes with the cheap
25cards which have no tuner), try adding this to your modules.conf:
26	options i2c-algo-bit bit_test=1
27
28For the WinTV/PVR you need one firmware file from the driver CD:
29hcwamc.rbf.  The file is in the pvr45xxx.exe archive (self-extracting
30zip file, unzip can unpack it).  Put it into the /etc/pvr directory or
31use the firm_altera=<path> insmod option to point the driver to the
32location of the file.
33
34If your card isn't listed in CARDLIST.bttv or if you have trouble making
35audio work, you should read the Sound-FAQ.
36
37
38Autodetecting cards
39-------------------
40
41bttv uses the PCI Subsystem ID to autodetect the card type.  lspci lists
42the Subsystem ID in the second line, looks like this:
43
4400:0a.0 Multimedia video controller: Brooktree Corporation Bt878 (rev 02)
45	Subsystem: Hauppauge computer works Inc. WinTV/GO
46	Flags: bus master, medium devsel, latency 32, IRQ 5
47	Memory at e2000000 (32-bit, prefetchable) [size=4K]
48
49only bt878-based cards can have a subsystem ID (which does not mean
50that every card really has one).  bt848 cards can't have a Subsystem
51ID and therefore can't be autodetected.  There is a list with the ID's
52in bttv-cards.c (in case you are intrested or want to mail patches
53with updates).
54
55
56Still doesn't work?
57-------------------
58
59I do NOT have a lab with 30+ different grabber boards and a
60PAL/NTSC/SECAM test signal generator at home, so I often can't
61reproduce your problems.  This makes debugging very difficult for me.
62If you have some knowledge and spare time, please try to fix this
63yourself (patches very welcome of course...)  You know: The linux
64slogan is "Do it yourself".
65
66There is a mailing list: linux-media@vger.kernel.org
67http://vger.kernel.org/vger-lists.html#linux-media
68
69If you have trouble with some specific TV card, try to ask there
70instead of mailing me directly.  The chance that someone with the
71same card listens there is much higher...
72
73For problems with sound:  There are a lot of different systems used
74for TV sound all over the world.  And there are also different chips
75which decode the audio signal.  Reports about sound problems ("stereo
76does'nt work") are pretty useless unless you include some details
77about your hardware and the TV sound scheme used in your country (or
78at least the country you are living in).
79
80
81Finally: If you mail some patches for bttv around the world (to
82linux-kernel/Alan/Linus/...), please Cc: me.
83
84
85Have fun with bttv,
86
87  Gerd
88
89--
90Gerd Knorr <kraxel@bytesex.org>
91