patch-2.4.2 linux/Documentation/video4linux/bttv/README

Next file: linux/Documentation/video4linux/bttv/Sound-FAQ
Previous file: linux/Documentation/video4linux/bttv/Insmod-options
Back to the patch index
Back to the overall index

diff -u --recursive --new-file v2.4.1/linux/Documentation/video4linux/bttv/README linux/Documentation/video4linux/bttv/README
@@ -16,9 +16,10 @@
 kernel, download it from:
 	http://www2.lm-sensors.nu/~lm78/download.html
 
-You'll need at least these i2c config options for bttv:
+You'll need at least these config options for bttv:
 CONFIG_I2C=m
 CONFIG_I2C_ALGOBIT=m
+CONFIG_VIDEO_DEV=m
 
 The latest bttv version is available here:
 	http://www.strusel007.de/linux/bttv/
@@ -50,12 +51,8 @@
 Make bttv work with your card
 -----------------------------
 
-Of course you have to load the modules as very first thing.  The
-separate bttv bundle comes with a script called "update".  I use this
-one to load a new version while doing driver hacking.  You can use it
-too, but check the module arguments first.  They work for my setup,
-and probably do *not* for yours.  Another way is to setup your
-/etc/modules.conf file and let kmod load the modules.  See also:
+Setup your /etc/modules.conf file and let kmod load the modules.
+See also:
 
 Modules.conf:	some sample entries for /etc/modules.conf
 Insmod-options:	list of all insmod options available for bttv and
@@ -68,15 +65,45 @@
 to load them automagically by calling request_module() now, but this
 obviously works only with kmod enabled.
 
+If bttv takes very long to load (happens sometimes with the cheap
+cards which have no tuner), try adding this to your modules.conf:
+	options i2c-algo-bit bit_test=1
+
 The most important insmod option for bttv is "card=n" to select the
-correct card type.  If you get video but no sound you've very likely
-specified the wrong (or no) card type.  A list of supported cards is
-in CARDLIST.
+correct card type in case the autodetection does'nt work. If you get
+video but no sound you've very likely specified the wrong (or no)
+card type.  A list of supported cards is in CARDLIST.
 
 If your card isn't listed in CARDLIST or if you have trouble making
 audio work, you should read the Sound-FAQ.
 
 
+Autodetecting cards
+-------------------
+
+bttv uses the PCI Subsystem ID to autodetect the card type.  lspci lists
+the Subsystem ID in the second line, looks like this:
+
+00:0a.0 Multimedia video controller: Brooktree Corporation Bt878 (rev 02)
+        Subsystem: Hauppauge computer works Inc. WinTV/GO
+        Flags: bus master, medium devsel, latency 32, IRQ 5
+        Memory at e2000000 (32-bit, prefetchable) [size=4K]
+
+only bt878-based cards can have a subsystem ID (which does not mean
+that every card really has one).  bt848 cards can't have a Subsystem
+ID and therefore can't be autodetected.  There is a list with the ID's
+in bttv-cards.c (in case you are intrested or want to mail patches
+with updates).
+
+Old driver versions used to have a heuristic which could identify some
+bt848-based cards.  It worked for Hauppauge and Miro cards in most
+cases (simply because these where the first cards available on the
+market), but misdetected other bt848 cards.  That code is gone now for
+exactly this reason, the misdetection confused lots of people.  If you
+have a old Hauppauge or Miro card, you'll have to load the driver with
+card=1 or card=2 these days.
+
+
 Still doesn't work?
 -------------------
 
@@ -87,10 +114,12 @@
 yourself (patches very welcome of course...)  You know: The linux
 slogan is "Do it yourself".
 
-There is a mailing list: video4linux-list@redhat.com.  If you have
-trouble with some specific TV card, try to ask there instead of
-mailing me directly.  The chance that someone with the same card
-listens there is much higher...
+There is a mailing list: video4linux-list@redhat.com.
+https://listman.redhat.com/mailman/listinfo/video4linux-list
+
+If you have trouble with some specific TV card, try to ask there
+instead of mailing me directly.  The chance that someone with the
+same card listens there is much higher...
 
 For problems with sound:  There are alot of different systems used
 for TV sound all over the world.  And there are also different chips

FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen (who was at: slshen@lbl.gov)