Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/ieee1394...
[pandora-kernel.git] / Documentation / video4linux / bttv / Insmod-options
1
2 Note: "modinfo <module>" prints various informations about a kernel
3 module, among them a complete and up-to-date list of insmod options.
4 This list tends to be outdated because it is updated manually ...
5
6 ==========================================================================
7
8 bttv.o
9         the bt848/878 (grabber chip) driver
10
11         insmod args:
12                 card=n          card type, see CARDLIST for a list.
13                 tuner=n         tuner type, see CARDLIST for a list.
14                 radio=0/1       card supports radio
15                 pll=0/1/2       pll settings
16                         0: don't use PLL
17                         1: 28 MHz crystal installed
18                         2: 35 MHz crystal installed
19
20                 triton1=0/1     for Triton1 (+others) compatibility
21                 vsfx=0/1        yet another chipset bug compatibility bit
22                                 see README.quirks for details on these two.
23
24                 bigendian=n     Set the endianness of the gfx framebuffer.
25                                 Default is native endian.
26                 fieldnr=0/1     Count fields.  Some TV descrambling software
27                                 needs this, for others it only generates
28                                 50 useless IRQs/sec.  default is 0 (off).
29                 autoload=0/1    autoload helper modules (tuner, audio).
30                                 default is 1 (on).
31                 bttv_verbose=0/1/2  verbose level (at insmod time, while
32                                 looking at the hardware).  default is 1.
33                 bttv_debug=0/1  debug messages (for capture).
34                                 default is 0 (off).
35                 irq_debug=0/1   irq handler debug messages.
36                                 default is 0 (off).
37                 gbuffers=2-32   number of capture buffers for mmap'ed capture.
38                                 default is 4.
39                 gbufsize=       size of capture buffers. default and
40                                 maximum value is 0x208000 (~2MB)
41                 no_overlay=0    Enable overlay on broken hardware.  There
42                                 are some chipsets (SIS for example) which
43                                 are known to have problems with the PCI DMA
44                                 push used by bttv.  bttv will disable overlay
45                                 by default on this hardware to avoid crashes.
46                                 With this insmod option you can override this.
47                 no_overlay=1    Disable overlay. It should be used by broken
48                                 hardware that doesn't support PCI2PCI direct
49                                 transfers.
50                 automute=0/1    Automatically mutes the sound if there is
51                                 no TV signal, on by default.  You might try
52                                 to disable this if you have bad input signal
53                                 quality which leading to unwanted sound
54                                 dropouts.
55                 chroma_agc=0/1  AGC of chroma signal, off by default.
56                 adc_crush=0/1   Luminance ADC crush, on by default.
57                 i2c_udelay=     Allow reduce I2C speed. Default is 5 usecs
58                                 (meaning 66,67 Kbps). The default is the
59                                 maximum supported speed by kernel bitbang
60                                 algorithm. You may use lower numbers, if I2C
61                                 messages are lost (16 is known to work on
62                                 all supported cards).
63
64                 bttv_gpio=0/1
65                 gpiomask=
66                 audioall=
67                 audiomux=
68                                 See Sound-FAQ for a detailed description.
69
70         remap, card, radio and pll accept up to four comma-separated arguments
71         (for multiple boards).
72
73 tuner.o
74         The tuner driver.  You need this unless you want to use only
75         with a camera or external tuner ...
76
77         insmod args:
78                 debug=1         print some debug info to the syslog
79                 type=n          type of the tuner chip. n as follows:
80                                 see CARDLIST for a complete list.
81                 pal=[bdgil]     select PAL variant (used for some tuners
82                                 only, important for the audio carrier).
83
84 tvaudio.o
85         new, experimental module which is supported to provide a single
86         driver for all simple i2c audio control chips (tda/tea*).
87
88         insmod args:
89                 tda8425  = 1    enable/disable the support for the
90                 tda9840  = 1    various chips.
91                 tda9850  = 1    The tea6300 can't be autodetected and is
92                 tda9855  = 1    therefore off by default, if you have
93                 tda9873  = 1    this one on your card (STB uses these)
94                 tda9874a = 1    you have to enable it explicitly.
95                 tea6300  = 0    The two tda985x chips use the same i2c
96                 tea6420  = 1    address and can't be disturgished from
97                 pic16c54 = 1    each other, you might have to disable
98                                 the wrong one.
99                 debug = 1       print debug messages
100
101         insmod args for tda9874a:
102                 tda9874a_SIF=1/2        select sound IF input pin (1 or 2)
103                                         (default is pin 1)
104                 tda9874a_AMSEL=0/1      auto-mute select for NICAM (default=0)
105                                         Please read note 3 below!
106                 tda9874a_STD=n          select TV sound standard (0..8):
107                                         0 - A2, B/G
108                                         1 - A2, M (Korea)
109                                         2 - A2, D/K (1)
110                                         3 - A2, D/K (2)
111                                         4 - A2, D/K (3)
112                                         5 - NICAM, I
113                                         6 - NICAM, B/G
114                                         7 - NICAM, D/K (default)
115                                         8 - NICAM, L
116
117         Note 1: tda9874a supports both tda9874h (old) and tda9874a (new) chips.
118         Note 2: tda9874h/a and tda9875 (which is supported separately by
119         tda9875.o) use the same i2c address so both modules should not be
120         used at the same time.
121         Note 3: Using tda9874a_AMSEL option depends on your TV card design!
122                 AMSEL=0: auto-mute will switch between NICAM sound
123                          and the sound on 1st carrier (i.e. FM mono or AM).
124                 AMSEL=1: auto-mute will switch between NICAM sound
125                          and the analog mono input (MONOIN pin).
126         If tda9874a decoder on your card has MONOIN pin not connected, then
127         use only tda9874_AMSEL=0 or don't specify this option at all.
128         For example:
129           card=65 (FlyVideo 2000S) - set AMSEL=1 or AMSEL=0
130           card=72 (Prolink PV-BT878P rev.9B) - set AMSEL=0 only
131
132 msp3400.o
133         The driver for the msp34xx sound processor chips. If you have a
134         stereo card, you probably want to insmod this one.
135
136         insmod args:
137                 debug=1/2       print some debug info to the syslog,
138                                 2 is more verbose.
139                 simple=1        Use the "short programming" method.  Newer
140                                 msp34xx versions support this.  You need this
141                                 for dbx stereo.  Default is on if supported by
142                                 the chip.
143                 once=1          Don't check the TV-stations Audio mode
144                                 every few seconds, but only once after
145                                 channel switches.
146                 amsound=1       Audio carrier is AM/NICAM at 6.5 Mhz.  This
147                                 should improve things for french people, the
148                                 carrier autoscan seems to work with FM only...
149
150 tea6300.o - OBSOLETE (use tvaudio instead)
151         The driver for the tea6300 fader chip.  If you have a stereo
152         card and the msp3400.o doesn't work, you might want to try this
153         one.  This chip is seen on most STB TV/FM cards (usually from
154         Gateway OEM sold surplus on auction sites).
155
156         insmod args:
157                 debug=1         print some debug info to the syslog.
158
159 tda8425.o - OBSOLETE (use tvaudio instead)
160         The driver for the tda8425 fader chip.  This driver used to be
161         part of bttv.c, so if your sound used to work but does not
162         anymore, try loading this module.
163
164         insmod args:
165                 debug=1         print some debug info to the syslog.
166
167 tda985x.o - OBSOLETE (use tvaudio instead)
168         The driver for the tda9850/55 audio chips.
169
170         insmod args:
171                 debug=1         print some debug info to the syslog.
172                 chip=9850/9855  set the chip type.