[linux-2.6-block.git] / Documentation / video4linux / bttv / Insmod-options


Note: "modinfo <module>" prints various informations about a kernel
module, among them a complete and up-to-date list of insmod options.
This list tends to be outdated because it is updated manually ...

==========================================================================

bttv.o
	the bt848/878 (grabber chip) driver

	insmod args:
		card=n		card type, see CARDLIST for a list.
		tuner=n		tuner type, see CARDLIST for a list.
		radio=0/1	card supports radio
		pll=0/1/2	pll settings
			0: don't use PLL
			1: 28 MHz crystal installed
			2: 35 MHz crystal installed

		triton1=0/1     for Triton1 (+others) compatibility
		vsfx=0/1	yet another chipset bug compatibility bit
				see README.quirks for details on these two.

		bigendian=n	Set the endianness of the gfx framebuffer.
				Default is native endian.
		fieldnr=0/1	Count fields.  Some TV descrambling software
				needs this, for others it only generates
				50 useless IRQs/sec.  default is 0 (off).
		autoload=0/1	autoload helper modules (tuner, audio).
				default is 1 (on).
		bttv_verbose=0/1/2  verbose level (at insmod time, while
				looking at the hardware).  default is 1.
		bttv_debug=0/1	debug messages (for capture).
				default is 0 (off).
		irq_debug=0/1	irq handler debug messages.
				default is 0 (off).
		gbuffers=2-32	number of capture buffers for mmap'ed capture.
				default is 4.
		gbufsize=	size of capture buffers. default and
				maximum value is 0x208000 (~2MB)
		no_overlay=0	Enable overlay on broken hardware.  There
				are some chipsets (SIS for example) which
				are known to have problems with the PCI DMA
				push used by bttv.  bttv will disable overlay
				by default on this hardware to avoid crashes.
				With this insmod option you can override this.
		automute=0/1	Automatically mutes the sound if there is
				no TV signal, on by default.  You might try
				to disable this if you have bad input signal
				quality which leading to unwanted sound
				dropouts.
		chroma_agc=0/1	AGC of chroma signal, off by default.
		adc_crush=0/1	Luminance ADC crush, on by default.

		bttv_gpio=0/1
		gpiomask=
		audioall=
		audiomux=
				See Sound-FAQ for a detailed description.

	remap, card, radio and pll accept up to four comma-separated arguments
	(for multiple boards).

tuner.o
	The tuner driver.  You need this unless you want to use only
	with a camera or external tuner ...

	insmod args:
		debug=1		print some debug info to the syslog
		type=n		type of the tuner chip. n as follows:
				see CARDLIST for a complete list.
		pal=[bdgil]	select PAL variant (used for some tuners
				only, important for the audio carrier).

tvmixer.o
	registers a mixer device for the TV card's volume/bass/treble
	controls (requires a i2c audio control chip like the msp3400).

	insmod args:
		debug=1		print some debug info to the syslog.
		devnr=n		allocate device #n (0 == /dev/mixer,
				1 = /dev/mixer1, ...), default is to
				use the first free one.

tvaudio.o
	new, experimental module which is supported to provide a single
	driver for all simple i2c audio control chips (tda/tea*).

	insmod args:
		tda8425  = 1	enable/disable the support for the
		tda9840  = 1	various chips.
		tda9850  = 1	The tea6300 can't be autodetected and is
		tda9855  = 1	therefore off by default, if you have
		tda9873  = 1	this one on your card (STB uses these)
		tda9874a = 1	you have to enable it explicitly.
		tea6300  = 0	The two tda985x chips use the same i2c
		tea6420  = 1	address and can't be disturgished from
		pic16c54 = 1	each other, you might have to disable
				the wrong one.
		debug = 1	print debug messages

	insmod args for tda9874a:
		tda9874a_SIF=1/2	select sound IF input pin (1 or 2)
					(default is pin 1)
		tda9874a_AMSEL=0/1	auto-mute select for NICAM (default=0)
					Please read note 3 below!
		tda9874a_STD=n		select TV sound standard (0..8):
					0 - A2, B/G
					1 - A2, M (Korea)
					2 - A2, D/K (1)
					3 - A2, D/K (2)
					4 - A2, D/K (3)
					5 - NICAM, I
					6 - NICAM, B/G
					7 - NICAM, D/K (default)
					8 - NICAM, L

	Note 1: tda9874a supports both tda9874h (old) and tda9874a (new) chips.
	Note 2: tda9874h/a and tda9875 (which is supported separately by
	tda9875.o) use the same i2c address so both modules should not be
	used at the same time.
	Note 3: Using tda9874a_AMSEL option depends on your TV card design!
		AMSEL=0: auto-mute will switch between NICAM sound
			 and the sound on 1st carrier (i.e. FM mono or AM).
		AMSEL=1: auto-mute will switch between NICAM sound
			 and the analog mono input (MONOIN pin).
	If tda9874a decoder on your card has MONOIN pin not connected, then
	use only tda9874_AMSEL=0 or don't specify this option at all.
	For example:
	  card=65 (FlyVideo 2000S) - set AMSEL=1 or AMSEL=0
	  card=72 (Prolink PV-BT878P rev.9B) - set AMSEL=0 only

msp3400.o
	The driver for the msp34xx sound processor chips. If you have a
	stereo card, you probably want to insmod this one.

	insmod args:
		debug=1/2	print some debug info to the syslog,
				2 is more verbose.
		simple=1	Use the "short programming" method.  Newer
				msp34xx versions support this.  You need this
				for dbx stereo.  Default is on if supported by
				the chip.
		once=1		Don't check the TV-stations Audio mode
				every few seconds, but only once after
				channel switches.
		amsound=1	Audio carrier is AM/NICAM at 6.5 Mhz.  This
				should improve things for french people, the
				carrier autoscan seems to work with FM only...

tea6300.o - OBSOLETE (use tvaudio instead)
	The driver for the tea6300 fader chip.  If you have a stereo
	card and the msp3400.o doesn't work, you might want to try this
	one.  This chip is seen on most STB TV/FM cards (usually from
	Gateway OEM sold surplus on auction sites).

	insmod args:
		debug=1		print some debug info to the syslog.

tda8425.o - OBSOLETE (use tvaudio instead)
	The driver for the tda8425 fader chip.  This driver used to be
	part of bttv.c, so if your sound used to work but does not
	anymore, try loading this module.

	insmod args:
		debug=1		print some debug info to the syslog.

tda985x.o - OBSOLETE (use tvaudio instead)
	The driver for the tda9850/55 audio chips.

	insmod args:
		debug=1		print some debug info to the syslog.
		chip=9850/9855	set the chip type.
Commit	Line	Data
1da177e4 LT	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.