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