[PATCH] v4l: oopsfix for BTTV on badly behaved PCI chipsets
[linux-3.10.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
58                 bttv_gpio=0/1
59                 gpiomask=
60                 audioall=
61                 audiomux=
62                                 See Sound-FAQ for a detailed description.
63
64         remap, card, radio and pll accept up to four comma-separated arguments
65         (for multiple boards).
66
67 tuner.o
68         The tuner driver.  You need this unless you want to use only
69         with a camera or external tuner ...
70
71         insmod args:
72                 debug=1         print some debug info to the syslog
73                 type=n          type of the tuner chip. n as follows:
74                                 see CARDLIST for a complete list.
75                 pal=[bdgil]     select PAL variant (used for some tuners
76                                 only, important for the audio carrier).
77
78 tvmixer.o
79         registers a mixer device for the TV card's volume/bass/treble
80         controls (requires a i2c audio control chip like the msp3400).
81
82         insmod args:
83                 debug=1         print some debug info to the syslog.
84                 devnr=n         allocate device #n (0 == /dev/mixer,
85                                 1 = /dev/mixer1, ...), default is to
86                                 use the first free one.
87
88 tvaudio.o
89         new, experimental module which is supported to provide a single
90         driver for all simple i2c audio control chips (tda/tea*).
91
92         insmod args:
93                 tda8425  = 1    enable/disable the support for the
94                 tda9840  = 1    various chips.
95                 tda9850  = 1    The tea6300 can't be autodetected and is
96                 tda9855  = 1    therefore off by default, if you have
97                 tda9873  = 1    this one on your card (STB uses these)
98                 tda9874a = 1    you have to enable it explicitly.
99                 tea6300  = 0    The two tda985x chips use the same i2c
100                 tea6420  = 1    address and can't be disturgished from
101                 pic16c54 = 1    each other, you might have to disable
102                                 the wrong one.
103                 debug = 1       print debug messages
104
105         insmod args for tda9874a:
106                 tda9874a_SIF=1/2        select sound IF input pin (1 or 2)
107                                         (default is pin 1)
108                 tda9874a_AMSEL=0/1      auto-mute select for NICAM (default=0)
109                                         Please read note 3 below!
110                 tda9874a_STD=n          select TV sound standard (0..8):
111                                         0 - A2, B/G
112                                         1 - A2, M (Korea)
113                                         2 - A2, D/K (1)
114                                         3 - A2, D/K (2)
115                                         4 - A2, D/K (3)
116                                         5 - NICAM, I
117                                         6 - NICAM, B/G
118                                         7 - NICAM, D/K (default)
119                                         8 - NICAM, L
120
121         Note 1: tda9874a supports both tda9874h (old) and tda9874a (new) chips.
122         Note 2: tda9874h/a and tda9875 (which is supported separately by
123         tda9875.o) use the same i2c address so both modules should not be
124         used at the same time.
125         Note 3: Using tda9874a_AMSEL option depends on your TV card design!
126                 AMSEL=0: auto-mute will switch between NICAM sound
127                          and the sound on 1st carrier (i.e. FM mono or AM).
128                 AMSEL=1: auto-mute will switch between NICAM sound
129                          and the analog mono input (MONOIN pin).
130         If tda9874a decoder on your card has MONOIN pin not connected, then
131         use only tda9874_AMSEL=0 or don't specify this option at all.
132         For example:
133           card=65 (FlyVideo 2000S) - set AMSEL=1 or AMSEL=0
134           card=72 (Prolink PV-BT878P rev.9B) - set AMSEL=0 only
135
136 msp3400.o
137         The driver for the msp34xx sound processor chips. If you have a
138         stereo card, you probably want to insmod this one.
139
140         insmod args:
141                 debug=1/2       print some debug info to the syslog,
142                                 2 is more verbose.
143                 simple=1        Use the "short programming" method.  Newer
144                                 msp34xx versions support this.  You need this
145                                 for dbx stereo.  Default is on if supported by
146                                 the chip.
147                 once=1          Don't check the TV-stations Audio mode
148                                 every few seconds, but only once after
149                                 channel switches.
150                 amsound=1       Audio carrier is AM/NICAM at 6.5 Mhz.  This
151                                 should improve things for french people, the
152                                 carrier autoscan seems to work with FM only...
153
154 tea6300.o - OBSOLETE (use tvaudio instead)
155         The driver for the tea6300 fader chip.  If you have a stereo
156         card and the msp3400.o doesn't work, you might want to try this
157         one.  This chip is seen on most STB TV/FM cards (usually from
158         Gateway OEM sold surplus on auction sites).
159
160         insmod args:
161                 debug=1         print some debug info to the syslog.
162
163 tda8425.o - OBSOLETE (use tvaudio instead)
164         The driver for the tda8425 fader chip.  This driver used to be
165         part of bttv.c, so if your sound used to work but does not
166         anymore, try loading this module.
167
168         insmod args:
169                 debug=1         print some debug info to the syslog.
170
171 tda985x.o - OBSOLETE (use tvaudio instead)
172         The driver for the tda9850/55 audio chips.
173
174         insmod args:
175                 debug=1         print some debug info to the syslog.
176                 chip=9850/9855  set the chip type.