blob: 22aee1a5dd6e1cf6f548a0a54b2f965935db23df [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001
2 Advanced Linux Sound Architecture - Driver
3 ==========================================
4 Configuration guide
5
6
7Kernel Configuration
8====================
9
10To enable ALSA support you need at least to build the kernel with
11primary sound card support (CONFIG_SOUND). Since ALSA can emulate OSS,
12you don't have to choose any of the OSS modules.
13
14Enable "OSS API emulation" (CONFIG_SND_OSSEMUL) and both OSS mixer and
15PCM supports if you want to run OSS applications with ALSA.
16
17If you want to support the WaveTable functionality on cards such as
18SB Live! then you need to enable "Sequencer support"
19(CONFIG_SND_SEQUENCER).
20
21To make ALSA debug messages more verbose, enable the "Verbose printk"
22and "Debug" options. To check for memory leaks, turn on "Debug memory"
23too. "Debug detection" will add checks for the detection of cards.
24
25Please note that all the ALSA ISA drivers support the Linux isapnp API
26(if the card supports ISA PnP). You don't need to configure the cards
27using isapnptools.
28
29
30Creating ALSA devices
31=====================
32
33This depends on your distribution, but normally you use the /dev/MAKEDEV
34script to create the necessary device nodes. On some systems you use a
35script named 'snddevices'.
36
37
38Module parameters
39=================
40
41The user can load modules with options. If the module supports more than
42one card and you have more than one card of the same type then you can
43specify multiple values for the option separated by commas.
44
45Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
46
47 Module snd
48 ----------
49
50 The core ALSA module. It is used by all ALSA card drivers.
51 It takes the following options which have global effects.
52
53 major - major number for sound driver
54 - Default: 116
55 cards_limit
56 - limiting card index for auto-loading (1-8)
57 - Default: 1
58 - For auto-loading more than one card, specify this
59 option together with snd-card-X aliases.
Takashi Iwai304cd072007-10-26 15:10:15 +020060 slots - Reserve the slot index for the given driver.
61 This option takes multiple strings.
62 See "Module Autoloading Support" section for details.
Linus Torvalds1da177e2005-04-16 15:20:36 -070063
64 Module snd-pcm-oss
65 ------------------
66
67 The PCM OSS emulation module.
68 This module takes options which change the mapping of devices.
69
70 dsp_map - PCM device number maps assigned to the 1st OSS device.
71 - Default: 0
72 adsp_map - PCM device number maps assigned to the 2st OSS device.
73 - Default: 1
74 nonblock_open
Takashi Iwai62430082005-09-05 17:12:29 +020075 - Don't block opening busy PCM devices. Default: 1
Linus Torvalds1da177e2005-04-16 15:20:36 -070076
77 For example, when dsp_map=2, /dev/dsp will be mapped to PCM #2 of
78 the card #0. Similarly, when adsp_map=0, /dev/adsp will be mapped
79 to PCM #0 of the card #0.
80 For changing the second or later card, specify the option with
81 commas, such like "dsp_map=0,1".
82
83 nonblock_open option is used to change the behavior of the PCM
84 regarding opening the device. When this option is non-zero,
85 opening a busy OSS PCM device won't be blocked but return
86 immediately with EAGAIN (just like O_NONBLOCK flag).
87
88 Module snd-rawmidi
89 ------------------
90
91 This module takes options which change the mapping of devices.
92 similar to those of the snd-pcm-oss module.
93
94 midi_map - MIDI device number maps assigned to the 1st OSS device.
95 - Default: 0
96 amidi_map - MIDI device number maps assigned to the 2st OSS device.
97 - Default: 1
98
99 Common parameters for top sound card modules
100 --------------------------------------------
101
102 Each of top level sound card module takes the following options.
103
104 index - index (slot #) of sound card
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100105 - Values: 0 through 31 or negative
Linus Torvalds1da177e2005-04-16 15:20:36 -0700106 - If nonnegative, assign that index number
107 - if negative, interpret as a bitmask of permissible
108 indices; the first free permitted index is assigned
109 - Default: -1
110 id - card ID (identifier or name)
111 - Can be up to 15 characters long
112 - Default: the card type
113 - A directory by this name is created under /proc/asound/
114 containing information about the card
115 - This ID can be used instead of the index number in
116 identifying the card
117 enable - enable card
118 - Default: enabled, for PCI and ISA PnP cards
119
Rene Hermancf40a312006-03-28 12:38:20 +0200120 Module snd-adlib
121 ----------------
122
123 Module for AdLib FM cards.
124
125 port - port # for OPL chip
126
127 This module supports multiple cards. It does not support autoprobe, so
128 the port must be specified. For actual AdLib FM cards it will be 0x388.
129 Note that this card does not have PCM support and no mixer; only FM
130 synthesis.
131
132 Make sure you have "sbiload" from the alsa-tools package available and,
133 after loading the module, find out the assigned ALSA sequencer port
134 number through "sbiload -l". Example output:
135
136 Port Client name Port name
137 64:0 OPL2 FM synth OPL2 FM Port
138
139 Load the std.sb and drums.sb patches also supplied by sbiload:
140
141 sbiload -p 64:0 std.sb drums.sb
142
143 If you use this driver to drive an OPL3, you can use std.o3 and drums.o3
144 instead. To have the card produce sound, use aplaymidi from alsa-utils:
145
146 aplaymidi -p 64:0 foo.mid
147
Linus Torvalds1da177e2005-04-16 15:20:36 -0700148 Module snd-ad1816a
149 ------------------
150
151 Module for sound cards based on Analog Devices AD1816A/AD1815 ISA chips.
152
Takashi Iwai506d4c62005-08-03 14:02:47 +0200153 clockfreq - Clock frequency for AD1816A chip (default = 0, 33000Hz)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700154
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100155 This module supports multiple cards, autoprobe and PnP.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700156
157 Module snd-ad1848
158 -----------------
159
160 Module for sound cards based on AD1848/AD1847/CS4248 ISA chips.
161
162 port - port # for AD1848 chip
163 irq - IRQ # for AD1848 chip
164 dma1 - DMA # for AD1848 chip (0,1,3)
165
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100166 This module supports multiple cards. It does not support autoprobe
Linus Torvalds1da177e2005-04-16 15:20:36 -0700167 thus main port must be specified!!! Other ports are optional.
168
Takashi Iwaia4efc232005-11-17 17:24:26 +0100169 The power-management is supported.
170
Clemens Ladisch84010e62005-09-02 07:57:59 +0200171 Module snd-ad1889
172 -----------------
173
174 Module for Analog Devices AD1889 chips.
175
176 ac97_quirk - AC'97 workaround for strange hardware
177 See the description of intel8x0 module for details.
178
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100179 This module supports multiple cards.
Clemens Ladisch84010e62005-09-02 07:57:59 +0200180
Linus Torvalds1da177e2005-04-16 15:20:36 -0700181 Module snd-ali5451
182 ------------------
183
184 Module for ALi M5451 PCI chip.
185
186 pcm_channels - Number of hardware channels assigned for PCM
187 spdif - Support SPDIF I/O
188 - Default: disabled
189
Takashi Iwai8a3fb4d2005-10-20 17:10:49 +0200190 This module supports one chip and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700191
192 The power-management is supported.
193
194 Module snd-als100
195 -----------------
196
197 Module for sound cards based on Avance Logic ALS100/ALS120 ISA chips.
198
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100199 This module supports multiple cards, autoprobe and PnP.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700200
Takashi Iwaia4efc232005-11-17 17:24:26 +0100201 The power-management is supported.
202
Ash Willisb3a70d52006-03-27 13:20:40 +0200203 Module snd-als300
204 -----------------
205
206 Module for Avance Logic ALS300 and ALS300+
207
208 This module supports multiple cards.
209
210 The power-management is supported.
211
Linus Torvalds1da177e2005-04-16 15:20:36 -0700212 Module snd-als4000
213 ------------------
214
215 Module for sound cards based on Avance Logic ALS4000 PCI chip.
216
217 joystick_port - port # for legacy joystick support.
218 0 = disabled (default), 1 = auto-detect
219
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100220 This module supports multiple cards, autoprobe and PnP.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700221
Takashi Iwaia4efc232005-11-17 17:24:26 +0100222 The power-management is supported.
223
Linus Torvalds1da177e2005-04-16 15:20:36 -0700224 Module snd-atiixp
225 -----------------
226
Takashi Iwai62430082005-09-05 17:12:29 +0200227 Module for ATI IXP 150/200/250/400 AC97 controllers.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700228
Takashi Iwai62430082005-09-05 17:12:29 +0200229 ac97_clock - AC'97 clock (default = 48000)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700230 ac97_quirk - AC'97 workaround for strange hardware
Takashi Iwai62430082005-09-05 17:12:29 +0200231 See "AC97 Quirk Option" section below.
Dan Carpenter14e1d352006-11-20 16:35:18 +0100232 ac97_codec - Workaround to specify which AC'97 codec
233 instead of probing. If this works for you
234 file a bug with your `lspci -vn` output.
235 -2 -- Force probing.
236 -1 -- Default behavior.
237 0-2 -- Use the specified codec.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700238 spdif_aclink - S/PDIF transfer over AC-link (default = 1)
239
Clemens Ladischb7fe4622005-10-04 08:46:51 +0200240 This module supports one card and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700241
Takashi Iwai62430082005-09-05 17:12:29 +0200242 ATI IXP has two different methods to control SPDIF output. One is
243 over AC-link and another is over the "direct" SPDIF output. The
244 implementation depends on the motherboard, and you'll need to
245 choose the correct one via spdif_aclink module option.
246
Takashi Iwaia4efc232005-11-17 17:24:26 +0100247 The power-management is supported.
248
Linus Torvalds1da177e2005-04-16 15:20:36 -0700249 Module snd-atiixp-modem
250 -----------------------
251
252 Module for ATI IXP 150/200/250 AC97 modem controllers.
253
Clemens Ladischb7fe4622005-10-04 08:46:51 +0200254 This module supports one card and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700255
256 Note: The default index value of this module is -2, i.e. the first
257 slot is excluded.
258
Takashi Iwaia4efc232005-11-17 17:24:26 +0100259 The power-management is supported.
260
Linus Torvalds1da177e2005-04-16 15:20:36 -0700261 Module snd-au8810, snd-au8820, snd-au8830
262 -----------------------------------------
263
264 Module for Aureal Vortex, Vortex2 and Advantage device.
265
266 pcifix - Control PCI workarounds
267 0 = Disable all workarounds
268 1 = Force the PCI latency of the Aureal card to 0xff
269 2 = Force the Extend PCI#2 Internal Master for Efficient
270 Handling of Dummy Requests on the VIA KT133 AGP Bridge
271 3 = Force both settings
272 255 = Autodetect what is required (default)
273
274 This module supports all ADB PCM channels, ac97 mixer, SPDIF, hardware
275 EQ, mpu401, gameport. A3D and wavetable support are still in development.
276 Development and reverse engineering work is being coordinated at
277 http://savannah.nongnu.org/projects/openvortex/
278 SPDIF output has a copy of the AC97 codec output, unless you use the
279 "spdif" pcm device, which allows raw data passthru.
280 The hardware EQ hardware and SPDIF is only present in the Vortex2 and
281 Advantage.
282
Takashi Iwai62430082005-09-05 17:12:29 +0200283 Note: Some ALSA mixer applications don't handle the SPDIF sample rate
Linus Torvalds1da177e2005-04-16 15:20:36 -0700284 control correctly. If you have problems regarding this, try
285 another ALSA compliant mixer (alsamixer works).
286
287 Module snd-azt2320
288 ------------------
289
290 Module for sound cards based on Aztech System AZT2320 ISA chip (PnP only).
291
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100292 This module supports multiple cards, PnP and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700293
Takashi Iwaia4efc232005-11-17 17:24:26 +0100294 The power-management is supported.
295
Linus Torvalds1da177e2005-04-16 15:20:36 -0700296 Module snd-azt3328
297 ------------------
298
299 Module for sound cards based on Aztech AZF3328 PCI chip.
300
301 joystick - Enable joystick (default off)
302
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100303 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700304
305 Module snd-bt87x
306 ----------------
307
308 Module for video cards based on Bt87x chips.
309
310 digital_rate - Override the default digital rate (Hz)
311 load_all - Load the driver even if the card model isn't known
312
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100313 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700314
315 Note: The default index value of this module is -2, i.e. the first
316 slot is excluded.
317
318 Module snd-ca0106
319 -----------------
320
321 Module for Creative Audigy LS and SB Live 24bit
322
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100323 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700324
325
326 Module snd-cmi8330
327 ------------------
328
329 Module for sound cards based on C-Media CMI8330 ISA chips.
330
Rene Herman64e0e2d2007-12-13 16:29:33 +0100331 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
332
333 with isapnp=0, the following options are available:
334
Linus Torvalds1da177e2005-04-16 15:20:36 -0700335 wssport - port # for CMI8330 chip (WSS)
336 wssirq - IRQ # for CMI8330 chip (WSS)
337 wssdma - first DMA # for CMI8330 chip (WSS)
338 sbport - port # for CMI8330 chip (SB16)
339 sbirq - IRQ # for CMI8330 chip (SB16)
340 sbdma8 - 8bit DMA # for CMI8330 chip (SB16)
341 sbdma16 - 16bit DMA # for CMI8330 chip (SB16)
342
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100343 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700344
Takashi Iwaia4efc232005-11-17 17:24:26 +0100345 The power-management is supported.
346
Linus Torvalds1da177e2005-04-16 15:20:36 -0700347 Module snd-cmipci
348 -----------------
349
Clemens Ladisch45c41b42007-08-22 09:45:03 +0200350 Module for C-Media CMI8338/8738/8768/8770 PCI sound cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700351
Clemens Ladischc78c9502007-09-03 09:55:49 +0200352 mpu_port - port address of MIDI interface (8338 only):
Clemens Ladisch45c41b42007-08-22 09:45:03 +0200353 0x300,0x310,0x320,0x330 = legacy port,
Takashi Iwaicab5c4c2006-05-04 14:36:08 +0200354 0 = disable (default)
Clemens Ladisch45c41b42007-08-22 09:45:03 +0200355 fm_port - port address of OPL-3 FM synthesizer (8x38 only):
356 0x388 = legacy port,
357 1 = integrated PCI port (default on 8738),
Takashi Iwai2f24d1592007-02-15 18:56:43 +0100358 0 = disable
Takashi Iwai62430082005-09-05 17:12:29 +0200359 soft_ac3 - Software-conversion of raw SPDIF packets (model 033 only)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700360 (default = 1)
361 joystick_port - Joystick port address (0 = disable, 1 = auto-detect)
362
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100363 This module supports autoprobe and multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700364
Takashi Iwaia4efc232005-11-17 17:24:26 +0100365 The power-management is supported.
366
Linus Torvalds1da177e2005-04-16 15:20:36 -0700367 Module snd-cs4231
368 -----------------
369
370 Module for sound cards based on CS4231 ISA chips.
371
372 port - port # for CS4231 chip
373 mpu_port - port # for MPU-401 UART (optional), -1 = disable
374 irq - IRQ # for CS4231 chip
375 mpu_irq - IRQ # for MPU-401 UART
376 dma1 - first DMA # for CS4231 chip
377 dma2 - second DMA # for CS4231 chip
378
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100379 This module supports multiple cards. This module does not support autoprobe
Linus Torvalds1da177e2005-04-16 15:20:36 -0700380 thus main port must be specified!!! Other ports are optional.
381
382 The power-management is supported.
383
384 Module snd-cs4232
385 -----------------
386
387 Module for sound cards based on CS4232/CS4232A ISA chips.
388
Rene Herman64e0e2d2007-12-13 16:29:33 +0100389 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
390
391 with isapnp=0, the following options are available:
392
Linus Torvalds1da177e2005-04-16 15:20:36 -0700393 port - port # for CS4232 chip (PnP setup - 0x534)
394 cport - control port # for CS4232 chip (PnP setup - 0x120,0x210,0xf00)
395 mpu_port - port # for MPU-401 UART (PnP setup - 0x300), -1 = disable
396 fm_port - FM port # for CS4232 chip (PnP setup - 0x388), -1 = disable
397 irq - IRQ # for CS4232 chip (5,7,9,11,12,15)
398 mpu_irq - IRQ # for MPU-401 UART (9,11,12,15)
399 dma1 - first DMA # for CS4232 chip (0,1,3)
400 dma2 - second DMA # for Yamaha CS4232 chip (0,1,3), -1 = disable
Linus Torvalds1da177e2005-04-16 15:20:36 -0700401
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100402 This module supports multiple cards. This module does not support autoprobe
Rene Herman64e0e2d2007-12-13 16:29:33 +0100403 (if ISA PnP is not used) thus main port must be specified!!! Other ports are
404 optional.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700405
406 The power-management is supported.
407
408 Module snd-cs4236
409 -----------------
410
411 Module for sound cards based on CS4235/CS4236/CS4236B/CS4237B/
412 CS4238B/CS4239 ISA chips.
413
Rene Herman64e0e2d2007-12-13 16:29:33 +0100414 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
415
416 with isapnp=0, the following options are available:
417
Linus Torvalds1da177e2005-04-16 15:20:36 -0700418 port - port # for CS4236 chip (PnP setup - 0x534)
419 cport - control port # for CS4236 chip (PnP setup - 0x120,0x210,0xf00)
420 mpu_port - port # for MPU-401 UART (PnP setup - 0x300), -1 = disable
421 fm_port - FM port # for CS4236 chip (PnP setup - 0x388), -1 = disable
422 irq - IRQ # for CS4236 chip (5,7,9,11,12,15)
423 mpu_irq - IRQ # for MPU-401 UART (9,11,12,15)
424 dma1 - first DMA # for CS4236 chip (0,1,3)
425 dma2 - second DMA # for CS4236 chip (0,1,3), -1 = disable
Linus Torvalds1da177e2005-04-16 15:20:36 -0700426
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100427 This module supports multiple cards. This module does not support autoprobe
Linus Torvalds1da177e2005-04-16 15:20:36 -0700428 (if ISA PnP is not used) thus main port and control port must be
429 specified!!! Other ports are optional.
430
431 The power-management is supported.
432
433 Module snd-cs4281
434 -----------------
435
436 Module for Cirrus Logic CS4281 soundchip.
437
438 dual_codec - Secondary codec ID (0 = disable, default)
439
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100440 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700441
442 The power-management is supported.
443
444 Module snd-cs46xx
445 -----------------
446
447 Module for PCI sound cards based on CS4610/CS4612/CS4614/CS4615/CS4622/
448 CS4624/CS4630/CS4280 PCI chips.
449
Takashi Iwai62430082005-09-05 17:12:29 +0200450 external_amp - Force to enable external amplifier.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700451 thinkpad - Force to enable Thinkpad's CLKRUN control.
452 mmap_valid - Support OSS mmap mode (default = 0).
453
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100454 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700455 Usually external amp and CLKRUN controls are detected automatically
456 from PCI sub vendor/device ids. If they don't work, give the options
457 above explicitly.
458
459 The power-management is supported.
Takashi Iwai621887a2007-05-24 18:46:54 +0200460
461 Module snd-cs5530
462 _________________
463
464 Module for Cyrix/NatSemi Geode 5530 chip.
465
Takashi Iwai3e873172005-11-17 10:15:37 +0100466 Module snd-cs5535audio
467 ----------------------
468
469 Module for multifunction CS5535 companion PCI device
470
Takashi Iwaic00bd742006-05-19 19:22:34 +0200471 The power-management is supported.
Takashi Iwai3e873172005-11-17 10:15:37 +0100472
Giuliano Pochinidd7b2542006-06-28 13:53:41 +0200473 Module snd-darla20
474 ------------------
475
476 Module for Echoaudio Darla20
477
478 This module supports multiple cards.
479 The driver requires the firmware loader support on kernel.
480
481 Module snd-darla24
482 ------------------
483
484 Module for Echoaudio Darla24
485
486 This module supports multiple cards.
487 The driver requires the firmware loader support on kernel.
488
Linus Torvalds1da177e2005-04-16 15:20:36 -0700489 Module snd-dt019x
490 -----------------
491
492 Module for Diamond Technologies DT-019X / Avance Logic ALS-007 (PnP
493 only)
494
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100495 This module supports multiple cards. This module is enabled only with
Linus Torvalds1da177e2005-04-16 15:20:36 -0700496 ISA PnP support.
497
Takashi Iwaia4efc232005-11-17 17:24:26 +0100498 The power-management is supported.
499
Linus Torvalds1da177e2005-04-16 15:20:36 -0700500 Module snd-dummy
501 ----------------
502
503 Module for the dummy sound card. This "card" doesn't do any output
504 or input, but you may use this module for any application which
505 requires a sound card (like RealPlayer).
506
Takashi Iwaia4efc232005-11-17 17:24:26 +0100507 The power-management is supported.
508
Giuliano Pochinidd7b2542006-06-28 13:53:41 +0200509 Module snd-echo3g
510 -----------------
511
512 Module for Echoaudio 3G cards (Gina3G/Layla3G)
513
514 This module supports multiple cards.
515 The driver requires the firmware loader support on kernel.
516
Linus Torvalds1da177e2005-04-16 15:20:36 -0700517 Module snd-emu10k1
518 ------------------
519
520 Module for EMU10K1/EMU10k2 based PCI sound cards.
521 * Sound Blaster Live!
522 * Sound Blaster PCI 512
523 * Emu APS (partially supported)
524 * Sound Blaster Audigy
525
526 extin - bitmap of available external inputs for FX8010 (see bellow)
527 extout - bitmap of available external outputs for FX8010 (see bellow)
528 seq_ports - allocated sequencer ports (4 by default)
529 max_synth_voices - limit of voices used for wavetable (64 by default)
530 max_buffer_size - specifies the maximum size of wavetable/pcm buffers
531 given in MB unit. Default value is 128.
532 enable_ir - enable IR
533
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100534 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700535
536 Input & Output configurations [extin/extout]
537 * Creative Card wo/Digital out [0x0003/0x1f03]
538 * Creative Card w/Digital out [0x0003/0x1f0f]
539 * Creative Card w/Digital CD in [0x000f/0x1f0f]
540 * Creative Card wo/Digital out + LiveDrive [0x3fc3/0x1fc3]
541 * Creative Card w/Digital out + LiveDrive [0x3fc3/0x1fcf]
542 * Creative Card w/Digital CD in + LiveDrive [0x3fcf/0x1fcf]
543 * Creative Card wo/Digital out + Digital I/O 2 [0x0fc3/0x1f0f]
544 * Creative Card w/Digital out + Digital I/O 2 [0x0fc3/0x1f0f]
545 * Creative Card w/Digital CD in + Digital I/O 2 [0x0fcf/0x1f0f]
546 * Creative Card 5.1/w Digital out + LiveDrive [0x3fc3/0x1fff]
547 * Creative Card 5.1 (c) 2003 [0x3fc3/0x7cff]
548 * Creative Card all ins and outs [0x3fff/0x7fff]
549
Takashi Iwaia4efc232005-11-17 17:24:26 +0100550 The power-management is supported.
551
Linus Torvalds1da177e2005-04-16 15:20:36 -0700552 Module snd-emu10k1x
553 -------------------
554
555 Module for Creative Emu10k1X (SB Live Dell OEM version)
556
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100557 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700558
559 Module snd-ens1370
560 ------------------
561
562 Module for Ensoniq AudioPCI ES1370 PCI sound cards.
563 * SoundBlaster PCI 64
564 * SoundBlaster PCI 128
565
566 joystick - Enable joystick (default off)
567
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100568 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700569
Takashi Iwaid6ec8942006-01-20 14:05:06 +0100570 The power-management is supported.
571
Linus Torvalds1da177e2005-04-16 15:20:36 -0700572 Module snd-ens1371
573 ------------------
574
575 Module for Ensoniq AudioPCI ES1371 PCI sound cards.
576 * SoundBlaster PCI 64
577 * SoundBlaster PCI 128
578 * SoundBlaster Vibra PCI
579
580 joystick_port - port # for joystick (0x200,0x208,0x210,0x218),
581 0 = disable (default), 1 = auto-detect
582
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100583 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700584
Takashi Iwaid6ec8942006-01-20 14:05:06 +0100585 The power-management is supported.
586
Linus Torvalds1da177e2005-04-16 15:20:36 -0700587 Module snd-es968
588 ----------------
589
590 Module for sound cards based on ESS ES968 chip (PnP only).
591
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100592 This module supports multiple cards, PnP and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700593
Takashi Iwaia4efc232005-11-17 17:24:26 +0100594 The power-management is supported.
595
Linus Torvalds1da177e2005-04-16 15:20:36 -0700596 Module snd-es1688
597 -----------------
598
599 Module for ESS AudioDrive ES-1688 and ES-688 sound cards.
600
601 port - port # for ES-1688 chip (0x220,0x240,0x260)
602 mpu_port - port # for MPU-401 port (0x300,0x310,0x320,0x330), -1 = disable (default)
603 irq - IRQ # for ES-1688 chip (5,7,9,10)
604 mpu_irq - IRQ # for MPU-401 port (5,7,9,10)
605 dma8 - DMA # for ES-1688 chip (0,1,3)
606
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100607 This module supports multiple cards and autoprobe (without MPU-401 port).
Linus Torvalds1da177e2005-04-16 15:20:36 -0700608
609 Module snd-es18xx
610 -----------------
611
612 Module for ESS AudioDrive ES-18xx sound cards.
613
Rene Herman64e0e2d2007-12-13 16:29:33 +0100614 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
615
616 with isapnp=0, the following options are available:
617
Linus Torvalds1da177e2005-04-16 15:20:36 -0700618 port - port # for ES-18xx chip (0x220,0x240,0x260)
619 mpu_port - port # for MPU-401 port (0x300,0x310,0x320,0x330), -1 = disable (default)
620 fm_port - port # for FM (optional, not used)
621 irq - IRQ # for ES-18xx chip (5,7,9,10)
622 dma1 - first DMA # for ES-18xx chip (0,1,3)
623 dma2 - first DMA # for ES-18xx chip (0,1,3)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700624
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100625 This module supports multiple cards, ISA PnP and autoprobe (without MPU-401
626 port if native ISA PnP routines are not used).
Linus Torvalds1da177e2005-04-16 15:20:36 -0700627 When dma2 is equal with dma1, the driver works as half-duplex.
628
629 The power-management is supported.
630
631 Module snd-es1938
632 -----------------
633
634 Module for sound cards based on ESS Solo-1 (ES1938,ES1946) chips.
635
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100636 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700637
Takashi Iwaia4efc232005-11-17 17:24:26 +0100638 The power-management is supported.
639
Linus Torvalds1da177e2005-04-16 15:20:36 -0700640 Module snd-es1968
641 -----------------
642
643 Module for sound cards based on ESS Maestro-1/2/2E (ES1968/ES1978) chips.
644
645 total_bufsize - total buffer size in kB (1-4096kB)
646 pcm_substreams_p - playback channels (1-8, default=2)
647 pcm_substreams_c - capture channels (1-8, default=0)
648 clock - clock (0 = auto-detection)
649 use_pm - support the power-management (0 = off, 1 = on,
650 2 = auto (default))
651 enable_mpu - enable MPU401 (0 = off, 1 = on, 2 = auto (default))
652 joystick - enable joystick (default off)
653
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100654 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700655
656 The power-management is supported.
657
658 Module snd-fm801
659 ----------------
660
661 Module for ForteMedia FM801 based PCI sound cards.
662
663 tea575x_tuner - Enable TEA575x tuner
664 - 1 = MediaForte 256-PCS
665 - 2 = MediaForte 256-PCPR
666 - 3 = MediaForte 64-PCR
667 - High 16-bits are video (radio) device number + 1
668 - example: 0x10002 (MediaForte 256-PCPR, device 1)
669
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100670 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700671
Takashi Iwaia4efc232005-11-17 17:24:26 +0100672 The power-management is supported.
673
Giuliano Pochinidd7b2542006-06-28 13:53:41 +0200674 Module snd-gina20
675 -----------------
676
677 Module for Echoaudio Gina20
678
679 This module supports multiple cards.
680 The driver requires the firmware loader support on kernel.
681
682 Module snd-gina24
683 -----------------
684
685 Module for Echoaudio Gina24
686
687 This module supports multiple cards.
688 The driver requires the firmware loader support on kernel.
689
Linus Torvalds1da177e2005-04-16 15:20:36 -0700690 Module snd-gusclassic
691 ---------------------
692
693 Module for Gravis UltraSound Classic sound card.
694
695 port - port # for GF1 chip (0x220,0x230,0x240,0x250,0x260)
696 irq - IRQ # for GF1 chip (3,5,9,11,12,15)
697 dma1 - DMA # for GF1 chip (1,3,5,6,7)
698 dma2 - DMA # for GF1 chip (1,3,5,6,7,-1=disable)
699 joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
700 voices - GF1 voices limit (14-32)
701 pcm_voices - reserved PCM voices
702
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100703 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700704
705 Module snd-gusextreme
706 ---------------------
707
708 Module for Gravis UltraSound Extreme (Synergy ViperMax) sound card.
709
710 port - port # for ES-1688 chip (0x220,0x230,0x240,0x250,0x260)
711 gf1_port - port # for GF1 chip (0x210,0x220,0x230,0x240,0x250,0x260,0x270)
712 mpu_port - port # for MPU-401 port (0x300,0x310,0x320,0x330), -1 = disable
713 irq - IRQ # for ES-1688 chip (5,7,9,10)
714 gf1_irq - IRQ # for GF1 chip (3,5,9,11,12,15)
715 mpu_irq - IRQ # for MPU-401 port (5,7,9,10)
716 dma8 - DMA # for ES-1688 chip (0,1,3)
717 dma1 - DMA # for GF1 chip (1,3,5,6,7)
718 joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
719 voices - GF1 voices limit (14-32)
720 pcm_voices - reserved PCM voices
721
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100722 This module supports multiple cards and autoprobe (without MPU-401 port).
Linus Torvalds1da177e2005-04-16 15:20:36 -0700723
724 Module snd-gusmax
725 -----------------
726
727 Module for Gravis UltraSound MAX sound card.
728
729 port - port # for GF1 chip (0x220,0x230,0x240,0x250,0x260)
730 irq - IRQ # for GF1 chip (3,5,9,11,12,15)
731 dma1 - DMA # for GF1 chip (1,3,5,6,7)
732 dma2 - DMA # for GF1 chip (1,3,5,6,7,-1=disable)
733 joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
734 voices - GF1 voices limit (14-32)
735 pcm_voices - reserved PCM voices
736
Clemens Ladisch0ef797c2005-11-21 07:30:20 +0100737 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700738
739 Module snd-hda-intel
740 --------------------
741
Takashi Iwai9b878192006-05-17 11:26:39 +0200742 Module for Intel HD Audio (ICH6, ICH6M, ESB2, ICH7, ICH8),
743 ATI SB450, SB600, RS600,
744 VIA VT8251/VT8237A,
745 SIS966, ULI M5461
Linus Torvalds1da177e2005-04-16 15:20:36 -0700746
Takashi Iwai5aba4f82008-01-07 15:16:37 +0100747 [Multiple options for each card instance]
Linus Torvalds1da177e2005-04-16 15:20:36 -0700748 model - force the model name
Takashi Iwai62430082005-09-05 17:12:29 +0200749 position_fix - Fix DMA pointer (0 = auto, 1 = none, 2 = POSBUF, 3 = FIFO size)
Takashi Iwai95904742007-05-19 17:06:42 +0200750 probe_mask - Bitmask to probe codecs (default = -1, meaning all slots)
Takashi Iwai5aba4f82008-01-07 15:16:37 +0100751
752 [Single (global) options]
Takashi Iwai27346162006-01-12 18:28:44 +0100753 single_cmd - Use single immediate commands to communicate with
754 codecs (for debugging only)
Takashi Iwai134a11f2006-11-10 12:08:37 +0100755 enable_msi - Enable Message Signaled Interrupt (MSI) (default = off)
Takashi Iwaidee1b662007-08-13 16:10:30 +0200756 power_save - Automatic power-saving timtout (in second, 0 =
Takashi Iwai3723e2d2007-09-17 19:08:32 +0200757 disable)
Takashi Iwaidee1b662007-08-13 16:10:30 +0200758 power_save_controller - Reset HD-audio controller in power-saving mode
759 (default = on)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700760
Takashi Iwai5aba4f82008-01-07 15:16:37 +0100761 This module supports multiple cards and autoprobe.
762
Linus Torvalds1da177e2005-04-16 15:20:36 -0700763 Each codec may have a model table for different configurations.
764 If your machine isn't listed there, the default (usually minimal)
765 configuration is set up. You can pass "model=<name>" option to
766 specify a certain model in such a case. There are different
767 models depending on the codec chip.
768
769 Model name Description
770 ---------- -----------
771 ALC880
772 3stack 3-jack in back and a headphone out
773 3stack-digout 3-jack in back, a HP out and a SPDIF out
774 5stack 5-jack in back, 2-jack in front
775 5stack-digout 5-jack in back, 2-jack in front, a SPDIF out
Takashi Iwaib6482d42005-06-27 15:32:43 +0200776 6stack 6-jack in back, 2-jack in front
777 6stack-digout 6-jack with a SPDIF out
Linus Torvalds1da177e2005-04-16 15:20:36 -0700778 w810 3-jack
Takashi Iwaidfc0ff62005-05-12 14:31:49 +0200779 z71v 3-jack (HP shared SPDIF)
Takashi Iwai4b146cb2006-07-28 14:42:36 +0200780 asus 3-jack (ASUS Mobo)
781 asus-w1v ASUS W1V
782 asus-dig ASUS with SPDIF out
783 asus-dig2 ASUS with SPDIF out (using GPIO2)
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200784 uniwill 3-jack
Tobin Davis2cf9f0f2007-02-07 16:04:25 +0100785 fujitsu Fujitsu Laptops (Pi1536)
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200786 F1734 2-jack
Takashi Iwaiae6b8132006-03-03 16:47:17 +0100787 lg LG laptop (m1 express dual)
Takashi Iwaicd417d42006-09-06 16:03:11 +0200788 lg-lw LG LW20/LW25 laptop
Takashi Iwai4b146cb2006-07-28 14:42:36 +0200789 tcl TCL S700
Takashi Iwai5a053d02006-07-25 14:51:15 +0200790 clevo Clevo laptops (m520G, m665n)
Takashi Iwaib6482d42005-06-27 15:32:43 +0200791 test for testing/debugging purpose, almost all controls can be
792 adjusted. Appearing only when compiled with
793 $CONFIG_SND_DEBUG=y
Takashi Iwaied345f82006-03-01 14:16:53 +0100794 auto auto-config reading BIOS (default)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700795
Takashi Iwai21be3d12005-09-16 19:18:56 +0200796 ALC260
797 hp HP machines
Takashi Iwai4b146cb2006-07-28 14:42:36 +0200798 hp-3013 HP machines (3013-variant)
Takashi Iwai21be3d12005-09-16 19:18:56 +0200799 fujitsu Fujitsu S7020
Takashi Iwaied345f82006-03-01 14:16:53 +0100800 acer Acer TravelMate
Takashi Iwai940d2442007-07-06 12:24:55 +0200801 will Will laptops (PB V7900)
802 replacer Replacer 672V
Takashi Iwaied345f82006-03-01 14:16:53 +0100803 basic fixed pin assignment (old default model)
Jonathan Woithe86c53bd2008-01-08 12:33:19 +0100804 test for testing/debugging purpose, almost all controls can
805 adjusted. Appearing only when compiled with
806 $CONFIG_SND_DEBUG=y
Takashi Iwaied345f82006-03-01 14:16:53 +0100807 auto auto-config reading BIOS (default)
808
809 ALC262
810 fujitsu Fujitsu Laptop
Takashi Iwai6d177ba72006-07-25 14:51:15 +0200811 hp-bpc HP xw4400/6400/8400/9400 laptops
Kailang Yangcd7509a2007-01-26 18:33:17 +0100812 hp-bpc-d7000 HP BPC D7000
Takashi Iwai61dc35d2007-11-14 12:26:44 +0100813 hp-tc-t5735 HP Thin Client T5735
Takashi Iwai304dcaa2006-07-25 14:51:16 +0200814 benq Benq ED8
Takashi Iwai940d2442007-07-06 12:24:55 +0200815 benq-t31 Benq T31
Takashi Iwaid1f67542006-11-14 12:30:52 +0100816 hippo Hippo (ATI) with jack detection, Sony UX-90s
Kailang Yangccc656c2006-10-17 12:32:26 +0200817 hippo_1 Hippo (Benq) with jack detection
Takashi Iwai940d2442007-07-06 12:24:55 +0200818 sony-assamd Sony ASSAMD
Tobin Davisf651b502007-10-26 12:40:47 +0200819 ultra Samsung Q1 Ultra Vista model
Takashi Iwaied345f82006-03-01 14:16:53 +0100820 basic fixed pin assignment w/o SPDIF
821 auto auto-config reading BIOS (default)
822
Kailang Yanga361d842007-06-05 12:30:55 +0200823 ALC268
824 3stack 3-stack model
Takashi Iwai983f8ae2007-08-15 16:44:04 +0200825 toshiba Toshiba A205
Takashi Iwaid2738092007-08-16 14:59:45 +0200826 acer Acer laptops
Jonathan Woithe86c53bd2008-01-08 12:33:19 +0100827 test for testing/debugging purpose, almost all controls can
828 adjusted. Appearing only when compiled with
829 $CONFIG_SND_DEBUG=y
Kailang Yanga361d842007-06-05 12:30:55 +0200830 auto auto-config reading BIOS (default)
831
Takashi Iwai940d2442007-07-06 12:24:55 +0200832 ALC662
833 3stack-dig 3-stack (2-channel) with SPDIF
834 3stack-6ch 3-stack (6-channel)
835 3stack-6ch-dig 3-stack (6-channel) with SPDIF
836 6stack-dig 6-stack with SPDIF
837 lenovo-101e Lenovo laptop
Takashi Iwaib995d762007-10-17 10:41:06 +0200838 eeepc-p701 ASUS Eeepc
Takashi Iwai940d2442007-07-06 12:24:55 +0200839 auto auto-config reading BIOS (default)
840
Takashi Iwai9c7f8522006-06-28 15:08:22 +0200841 ALC882/885
Takashi Iwaied345f82006-03-01 14:16:53 +0100842 3stack-dig 3-jack with SPDIF I/O
Tobin Davis518f6a62006-12-28 13:55:41 +0100843 6stack-dig 6-jack digital with SPDIF I/O
Takashi Iwai4b146cb2006-07-28 14:42:36 +0200844 arima Arima W820Di1
Takashi Iwai0438a002007-09-06 14:54:11 +0200845 targa Targa T8, MSI-1049 T8
846 asus-a7j ASUS A7J
847 asus-a7m ASUS A7M
Tobin Davis518f6a62006-12-28 13:55:41 +0100848 macpro MacPro support
Takashi Iwai87350ad2007-08-16 18:19:38 +0200849 mbp3 Macbook Pro rev3
Nicola Fagnanic54728d2007-07-19 23:28:52 +0200850 imac24 iMac 24'' with jack detection
Kailang Yangbdd148a2007-05-08 15:19:08 +0200851 w2jc ASUS W2JC
Takashi Iwaied345f82006-03-01 14:16:53 +0100852 auto auto-config reading BIOS (default)
853
Takashi Iwai9c7f8522006-06-28 15:08:22 +0200854 ALC883/888
855 3stack-dig 3-jack with SPDIF I/O
856 6stack-dig 6-jack digital with SPDIF I/O
Takashi Iwai4b146cb2006-07-28 14:42:36 +0200857 3stack-6ch 3-jack 6-channel
858 3stack-6ch-dig 3-jack 6-channel with SPDIF I/O
859 6stack-dig-demo 6-jack digital for Intel demo board
Vladimir Avdoninbab282b2006-08-22 13:31:58 +0200860 acer Acer laptops (Travelmate 3012WTMi, Aspire 5600, etc)
Takashi Iwai983f8ae2007-08-15 16:44:04 +0200861 acer-aspire Acer Aspire 9810
Tobin Davisc07584c2006-10-13 12:32:16 +0200862 medion Medion Laptops
Takashi Iwai940d2442007-07-06 12:24:55 +0200863 medion-md2 Medion MD2
Kailang Yangccc656c2006-10-17 12:32:26 +0200864 targa-dig Targa/MSI
865 targa-2ch-dig Targs/MSI with 2-channel
Andrew L. Neporadab373bde2006-11-07 11:37:08 +0100866 laptop-eapd 3-jack with SPDIF I/O and EAPD (Clevo M540JE, M550JE)
Takashi Iwai940d2442007-07-06 12:24:55 +0200867 lenovo-101e Lenovo 101E
868 lenovo-nb0763 Lenovo NB0763
869 lenovo-ms7195-dig Lenovo MS7195
Kailang Yang189609a2007-08-20 11:31:23 +0200870 haier-w66 Haier W66
Claudio Matsuoka4723c022007-07-13 14:36:19 +0200871 6stack-hp HP machines with 6stack (Nettle boards)
872 3stack-hp HP machines with 3stack (Lucknow, Samba boards)
Andy Shevchenkoa8848bd2007-12-13 17:32:26 +0100873 mitac Mitac 8252D
Takashi Iwai9c7f8522006-06-28 15:08:22 +0200874 auto auto-config reading BIOS (default)
875
876 ALC861/660
Takashi Iwaied345f82006-03-01 14:16:53 +0100877 3stack 3-jack
878 3stack-dig 3-jack with SPDIF I/O
879 6stack-dig 6-jack with SPDIF I/O
Takashi Iwai4b146cb2006-07-28 14:42:36 +0200880 3stack-660 3-jack (for ALC660)
Takashi Iwai22309c32006-08-09 16:57:28 +0200881 uniwill-m31 Uniwill M31 laptop
Tobin Davisa53d1ae2006-10-17 12:00:28 +0200882 toshiba Toshiba laptop support
Mariusz Domanski7cdbff92006-10-23 13:42:56 +0200883 asus Asus laptop support
Takashi Iwai56bb0ca2006-11-22 11:52:52 +0100884 asus-laptop ASUS F2/F3 laptops
Takashi Iwaied345f82006-03-01 14:16:53 +0100885 auto auto-config reading BIOS (default)
Takashi Iwai21be3d12005-09-16 19:18:56 +0200886
Jakub Schmidtkef32610e2007-02-02 18:17:27 +0100887 ALC861VD/660VD
888 3stack 3-jack
889 3stack-dig 3-jack with SPDIF OUT
890 6stack-dig 6-jack with SPDIF OUT
891 3stack-660 3-jack (for ALC660VD)
Mike Crash6963f842007-06-25 12:12:51 +0200892 3stack-660-digout 3-jack with SPDIF OUT (for ALC660VD)
Kailang Yangbdd148a2007-05-08 15:19:08 +0200893 lenovo Lenovo 3000 C200
Takashi Iwai940d2442007-07-06 12:24:55 +0200894 dallas Dallas laptops
Takashi Iwai983f8ae2007-08-15 16:44:04 +0200895 hp HP TX1000
Jakub Schmidtkef32610e2007-02-02 18:17:27 +0100896 auto auto-config reading BIOS (default)
897
Linus Torvalds1da177e2005-04-16 15:20:36 -0700898 CMI9880
899 minimal 3-jack in back
900 min_fp 3-jack in back, 2-jack in front
901 full 6-jack in back, 2-jack in front
902 full_dig 6-jack in back, 2-jack in front, SPDIF I/O
903 allout 5-jack in back, 2-jack in front, SPDIF out
Takashi Iwaie9edcee2005-06-13 14:16:38 +0200904 auto auto-config reading BIOS (default)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700905
Takashi Iwai0ac85512007-06-20 15:46:13 +0200906 AD1882
907 3stack 3-stack mode (default)
908 6stack 6-stack mode
909
Takashi Iwai2bac6472007-05-18 18:21:41 +0200910 AD1884
911 N/A
912
Takashi Iwai9230d212006-03-13 13:49:49 +0100913 AD1981
914 basic 3-jack (default)
915 hp HP nx6320
Takashi Iwai01686c5f2006-04-18 12:54:11 +0200916 thinkpad Lenovo Thinkpad T60/X60/Z60
Tobin Davis18768992007-03-12 22:20:51 +0100917 toshiba Toshiba U205
Takashi Iwai9230d212006-03-13 13:49:49 +0100918
Takashi Iwai2bac6472007-05-18 18:21:41 +0200919 AD1983
920 N/A
921
922 AD1984
923 basic default configuration
924 thinkpad Lenovo Thinkpad T61/X61
925
Takashi Iwai9230d212006-03-13 13:49:49 +0100926 AD1986A
927 6stack 6-jack, separate surrounds (default)
928 3stack 3-stack, shared surrounds
929 laptop 2-channel only (FSC V2060, Samsung M50)
Takashi Iwai825aa9722006-03-17 10:50:49 +0100930 laptop-eapd 2-channel with EAPD (Samsung R65, ASUS A6J)
Takashi Iwai8ab78c72007-09-06 14:29:53 +0200931 laptop-automute 2-channel with EAPD and HP-automute (Lenovo N100)
Tobin Davisf36090f2007-01-08 11:07:12 +0100932 ultra 2-channel with EAPD (Samsung Ultra tablet PC)
Takashi Iwai9230d212006-03-13 13:49:49 +0100933
934 AD1988
935 6stack 6-jack
936 6stack-dig ditto with SPDIF
937 3stack 3-jack
938 3stack-dig ditto with SPDIF
939 laptop 3-jack with hp-jack automute
940 laptop-dig ditto with SPDIF
Guillaume Munch99ccc562006-08-16 19:35:12 +0200941 auto auto-config reading BIOS (default)
Tobin Davisc9b443d2006-11-14 12:13:39 +0100942
943 Conexant 5045
944 laptop Laptop config
945 test for testing/debugging purpose, almost all controls
946 can be adjusted. Appearing only when compiled with
947 $CONFIG_SND_DEBUG=y
948
949 Conexant 5047
950 laptop Basic Laptop config
951 laptop-hp Laptop config for some HP models (subdevice 30A5)
952 laptop-eapd Laptop config with EAPD support
953 test for testing/debugging purpose, almost all controls
954 can be adjusted. Appearing only when compiled with
955 $CONFIG_SND_DEBUG=y
Takashi Iwai9230d212006-03-13 13:49:49 +0100956
Takashi Iwaidfe495d2007-08-23 19:04:28 +0200957 STAC9200
Takashi Iwai3fc24d82007-02-16 13:27:18 +0100958 ref Reference board
Takashi Iwai966a4d52007-09-05 23:48:45 +0200959 dell-d21 Dell (unknown)
960 dell-d22 Dell (unknown)
961 dell-d23 Dell (unknown)
Takashi Iwaidfe495d2007-08-23 19:04:28 +0200962 dell-m21 Dell Inspiron 630m, Dell Inspiron 640m
963 dell-m22 Dell Latitude D620, Dell Latitude D820
964 dell-m23 Dell XPS M1710, Dell Precision M90
965 dell-m24 Dell Latitude 120L
966 dell-m25 Dell Inspiron E1505n
967 dell-m26 Dell Inspiron 1501
968 dell-m27 Dell Inspiron E1705/9400
Takashi Iwai1194b5b2007-10-10 10:04:26 +0200969 gateway Gateway laptops with EAPD control
Takashi Iwaidfe495d2007-08-23 19:04:28 +0200970
971 STAC9205/9254
972 ref Reference board
973 dell-m42 Dell (unknown)
Tobin Davisae0a8ed2007-08-13 15:50:29 +0200974 dell-m43 Dell Precision
975 dell-m44 Dell Inspiron
Takashi Iwai3fc24d82007-02-16 13:27:18 +0100976
977 STAC9220/9221
Tobin Davis93ed1502006-09-01 21:03:12 +0200978 ref Reference board
979 3stack D945 3stack
980 5stack D945 5stack + SPDIF
Ivan N. Zlatev5d5d3bc2007-05-29 16:03:00 +0200981 intel-mac-v1 Intel Mac Type 1
982 intel-mac-v2 Intel Mac Type 2
983 intel-mac-v3 Intel Mac Type 3
984 intel-mac-v4 Intel Mac Type 4
985 intel-mac-v5 Intel Mac Type 5
986 macmini Intel Mac Mini (equivalent with type 3)
987 macbook Intel Mac Book (eq. type 5)
988 macbook-pro-v1 Intel Mac Book Pro 1st generation (eq. type 3)
989 macbook-pro Intel Mac Book Pro 2nd generation (eq. type 3)
990 imac-intel Intel iMac (eq. type 2)
991 imac-intel-20 Intel iMac (newer version) (eq. type 3)
Takashi Iwaidfe495d2007-08-23 19:04:28 +0200992 dell-d81 Dell (unknown)
993 dell-d82 Dell (unknown)
994 dell-m81 Dell (unknown)
995 dell-m82 Dell XPS M1210
Tobin Davis93ed1502006-09-01 21:03:12 +0200996
Tobin Davis8e21c342007-01-08 11:04:17 +0100997 STAC9202/9250/9251
998 ref Reference board, base config
999 m2-2 Some Gateway MX series laptops
1000 m6 Some Gateway NX series laptops
Tobin Davis2c11f952007-05-17 09:36:34 +02001001 pa6 Gateway NX860 series
Tobin Davis8e21c342007-01-08 11:04:17 +01001002
Tobin Davis93ed1502006-09-01 21:03:12 +02001003 STAC9227/9228/9229/927x
1004 ref Reference board
1005 3stack D965 3stack
1006 5stack D965 5stack + SPDIF
Takashi Iwaidfe495d2007-08-23 19:04:28 +02001007 dell-3stack Dell Dimension E520
Tobin Davis93ed1502006-09-01 21:03:12 +02001008
Guillaume Munch6d859062006-08-22 17:15:47 +02001009 STAC9872
1010 vaio Setup for VAIO FE550G/SZ110
1011 vaio-ar Setup for VAIO AR
Takashi Iwaidb064e52006-03-16 16:04:58 +01001012
Takashi Iwai6d7b1d72007-02-26 15:56:46 +01001013 The model name "genric" is treated as a special case. When this
1014 model is given, the driver uses the generic codec parser without
1015 "codec-patch". It's sometimes good for testing and debugging.
1016
Takashi Iwai62430082005-09-05 17:12:29 +02001017 If the default configuration doesn't work and one of the above
1018 matches with your device, report it together with the PCI
1019 subsystem ID (output of "lspci -nv") to ALSA BTS or alsa-devel
1020 ML (see the section "Links and Addresses").
1021
Takashi Iwai3723e2d2007-09-17 19:08:32 +02001022 power_save and power_save_controller options are for power-saving
1023 mode. See powersave.txt for details.
Takashi Iwaidee1b662007-08-13 16:10:30 +02001024
Takashi Iwaic74db862005-05-12 14:26:27 +02001025 Note 2: If you get click noises on output, try the module option
1026 position_fix=1 or 2. position_fix=1 will use the SD_LPIB
1027 register value without FIFO size correction as the current
1028 DMA pointer. position_fix=2 will make the driver to use
1029 the position buffer instead of reading SD_LPIB register.
1030 (Usually SD_LPLIB register is more accurate than the
1031 position buffer.)
1032
Takashi Iwai27346162006-01-12 18:28:44 +01001033 NB: If you get many "azx_get_response timeout" messages at
1034 loading, it's likely a problem of interrupts (e.g. ACPI irq
1035 routing). Try to boot with options like "pci=noacpi". Also, you
1036 can try "single_cmd=1" module option. This will switch the
1037 communication method between HDA controller and codecs to the
1038 single immediate commands instead of CORB/RIRB. Basically, the
1039 single command mode is provided only for BIOS, and you won't get
1040 unsolicited events, too. But, at least, this works independently
1041 from the irq. Remember this is a last resort, and should be
1042 avoided as much as possible...
1043
Takashi Iwai95904742007-05-19 17:06:42 +02001044 MORE NOTES ON "azx_get_response timeout" PROBLEMS:
1045 On some hardwares, you may need to add a proper probe_mask option
1046 to avoid the "azx_get_response timeout" problem above, instead.
1047 This occurs when the access to non-existing or non-working codec slot
1048 (likely a modem one) causes a stall of the communication via HD-audio
1049 bus. You can see which codec slots are probed by enabling
1050 CONFIG_SND_DEBUG_DETECT, or simply from the file name of the codec
1051 proc files. Then limit the slots to probe by probe_mask option.
1052 For example, probe_mask=1 means to probe only the first slot, and
1053 probe_mask=4 means only the third slot.
1054
Takashi Iwaia4efc232005-11-17 17:24:26 +01001055 The power-management is supported.
1056
Linus Torvalds1da177e2005-04-16 15:20:36 -07001057 Module snd-hdsp
1058 ---------------
1059
1060 Module for RME Hammerfall DSP audio interface(s)
1061
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001062 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001063
1064 Note: The firmware data can be automatically loaded via hotplug
1065 when CONFIG_FW_LOADER is set. Otherwise, you need to load
1066 the firmware via hdsploader utility included in alsa-tools
1067 package.
1068 The firmware data is found in alsa-firmware package.
1069
1070 Note: snd-page-alloc module does the job which snd-hammerfall-mem
1071 module did formerly. It will allocate the buffers in advance
1072 when any HDSP cards are found. To make the buffer
1073 allocation sure, load snd-page-alloc module in the early
Takashi Iwaib6a96912005-05-30 18:27:03 +02001074 stage of boot sequence. See "Early Buffer Allocation"
1075 section.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001076
Takashi Iwai54704402005-06-03 11:27:00 +02001077 Module snd-hdspm
1078 ----------------
1079
1080 Module for RME HDSP MADI board.
1081
1082 precise_ptr - Enable precise pointer, or disable.
1083 line_outs_monitor - Send playback streams to analog outs by default.
1084 enable_monitor - Enable Analog Out on Channel 63/64 by default.
1085
1086 See hdspm.txt for details.
1087
Linus Torvalds1da177e2005-04-16 15:20:36 -07001088 Module snd-ice1712
1089 ------------------
1090
1091 Module for Envy24 (ICE1712) based PCI sound cards.
1092 * MidiMan M Audio Delta 1010
1093 * MidiMan M Audio Delta 1010LT
1094 * MidiMan M Audio Delta DiO 2496
1095 * MidiMan M Audio Delta 66
1096 * MidiMan M Audio Delta 44
1097 * MidiMan M Audio Delta 410
1098 * MidiMan M Audio Audiophile 2496
1099 * TerraTec EWS 88MT
1100 * TerraTec EWS 88D
1101 * TerraTec EWX 24/96
1102 * TerraTec DMX 6Fire
Takashi Iwaic9bce912005-05-24 13:41:03 +02001103 * TerraTec Phase 88
Linus Torvalds1da177e2005-04-16 15:20:36 -07001104 * Hoontech SoundTrack DSP 24
1105 * Hoontech SoundTrack DSP 24 Value
1106 * Hoontech SoundTrack DSP 24 Media 7.1
Takashi Iwaic9bce912005-05-24 13:41:03 +02001107 * Event Electronics, EZ8
Linus Torvalds1da177e2005-04-16 15:20:36 -07001108 * Digigram VX442
Takashi Iwaic9bce912005-05-24 13:41:03 +02001109 * Lionstracs, Mediastaton
Linus Torvalds1da177e2005-04-16 15:20:36 -07001110
1111 model - Use the given board model, one of the following:
1112 delta1010, dio2496, delta66, delta44, audiophile, delta410,
1113 delta1010lt, vx442, ewx2496, ews88mt, ews88mt_new, ews88d,
Takashi Iwaic9bce912005-05-24 13:41:03 +02001114 dmx6fire, dsp24, dsp24_value, dsp24_71, ez8,
1115 phase88, mediastation
Linus Torvalds1da177e2005-04-16 15:20:36 -07001116 omni - Omni I/O support for MidiMan M-Audio Delta44/66
Matt LaPlantefa00e7e2006-11-30 04:55:36 +01001117 cs8427_timeout - reset timeout for the CS8427 chip (S/PDIF transceiver)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001118 in msec resolution, default value is 500 (0.5 sec)
1119
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001120 This module supports multiple cards and autoprobe. Note: The consumer part
Linus Torvalds1da177e2005-04-16 15:20:36 -07001121 is not used with all Envy24 based cards (for example in the MidiMan Delta
1122 serie).
1123
Takashi Iwaic9bce912005-05-24 13:41:03 +02001124 Note: The supported board is detected by reading EEPROM or PCI
1125 SSID (if EEPROM isn't available). You can override the
1126 model by passing "model" module option in case that the
1127 driver isn't configured properly or you want to try another
1128 type for testing.
1129
Linus Torvalds1da177e2005-04-16 15:20:36 -07001130 Module snd-ice1724
1131 ------------------
1132
Takashi Iwaic9bce912005-05-24 13:41:03 +02001133 Module for Envy24HT (VT/ICE1724), Envy24PT (VT1720) based PCI sound cards.
Takashi Iwai7a6c8ff2006-01-13 13:56:33 +01001134 * MidiMan M Audio Revolution 5.1
Linus Torvalds1da177e2005-04-16 15:20:36 -07001135 * MidiMan M Audio Revolution 7.1
Takashi Iwai56255062006-11-09 16:47:26 +01001136 * MidiMan M Audio Audiophile 192
Linus Torvalds1da177e2005-04-16 15:20:36 -07001137 * AMP Ltd AUDIO2000
Takashi Iwaic9bce912005-05-24 13:41:03 +02001138 * TerraTec Aureon 5.1 Sky
1139 * TerraTec Aureon 7.1 Space
1140 * TerraTec Aureon 7.1 Universe
1141 * TerraTec Phase 22
1142 * TerraTec Phase 28
1143 * AudioTrak Prodigy 7.1
Takashi Iwai7a6c8ff2006-01-13 13:56:33 +01001144 * AudioTrak Prodigy 7.1LT
Takashi Iwaic9bce912005-05-24 13:41:03 +02001145 * AudioTrak Prodigy 192
1146 * Pontis MS300
1147 * Albatron K8X800 Pro II
1148 * Chaintech ZNF3-150
1149 * Chaintech ZNF3-250
1150 * Chaintech 9CJS
Takashi Iwai8cfbbac2005-05-27 12:10:40 +02001151 * Chaintech AV-710
Takashi Iwaic9bce912005-05-24 13:41:03 +02001152 * Shuttle SN25P
Shin-ya Okadaf31639b2007-10-23 15:08:18 +02001153 * Onkyo SE-90PCI
1154 * Onkyo SE-200PCI
Linus Torvalds1da177e2005-04-16 15:20:36 -07001155
1156 model - Use the given board model, one of the following:
Takashi Iwai7a6c8ff2006-01-13 13:56:33 +01001157 revo51, revo71, amp2000, prodigy71, prodigy71lt,
Takashi Iwai56255062006-11-09 16:47:26 +01001158 prodigy192, aureon51, aureon71, universe, ap192,
Shin-ya Okadaf31639b2007-10-23 15:08:18 +02001159 k8x800, phase22, phase28, ms300, av710, se200pci,
1160 se90pci
Linus Torvalds1da177e2005-04-16 15:20:36 -07001161
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001162 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001163
Takashi Iwaic9bce912005-05-24 13:41:03 +02001164 Note: The supported board is detected by reading EEPROM or PCI
1165 SSID (if EEPROM isn't available). You can override the
1166 model by passing "model" module option in case that the
1167 driver isn't configured properly or you want to try another
1168 type for testing.
1169
Giuliano Pochinidd7b2542006-06-28 13:53:41 +02001170 Module snd-indigo
1171 -----------------
1172
1173 Module for Echoaudio Indigo
1174
1175 This module supports multiple cards.
1176 The driver requires the firmware loader support on kernel.
1177
1178 Module snd-indigodj
1179 -------------------
1180
1181 Module for Echoaudio Indigo DJ
1182
1183 This module supports multiple cards.
1184 The driver requires the firmware loader support on kernel.
1185
1186 Module snd-indigoio
1187 -------------------
1188
1189 Module for Echoaudio Indigo IO
1190
1191 This module supports multiple cards.
1192 The driver requires the firmware loader support on kernel.
1193
Linus Torvalds1da177e2005-04-16 15:20:36 -07001194 Module snd-intel8x0
1195 -------------------
1196
1197 Module for AC'97 motherboards from Intel and compatibles.
1198 * Intel i810/810E, i815, i820, i830, i84x, MX440
Takashi Iwai89ac9c22006-01-24 10:36:57 +01001199 ICH5, ICH6, ICH7, ESB2
Linus Torvalds1da177e2005-04-16 15:20:36 -07001200 * SiS 7012 (SiS 735)
Takashi Iwai89ac9c22006-01-24 10:36:57 +01001201 * NVidia NForce, NForce2, NForce3, MCP04, CK804
1202 CK8, CK8S, MCP501
Linus Torvalds1da177e2005-04-16 15:20:36 -07001203 * AMD AMD768, AMD8111
1204 * ALi m5455
1205
1206 ac97_clock - AC'97 codec clock base (0 = auto-detect)
1207 ac97_quirk - AC'97 workaround for strange hardware
Takashi Iwai62430082005-09-05 17:12:29 +02001208 See "AC97 Quirk Option" section below.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001209 buggy_irq - Enable workaround for buggy interrupts on some
Takashi Iwaia06147d2005-09-08 19:54:17 +02001210 motherboards (default yes on nForce chips,
1211 otherwise off)
1212 buggy_semaphore - Enable workaround for hardwares with buggy
1213 semaphores (e.g. on some ASUS laptops)
1214 (default off)
Takashi Iwai6c5cfd92006-11-28 17:18:25 +01001215 spdif_aclink - Use S/PDIF over AC-link instead of direct connection
1216 from the controller chip
1217 (0 = off, 1 = on, -1 = default)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001218
Clemens Ladischb7fe4622005-10-04 08:46:51 +02001219 This module supports one chip and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001220
1221 Note: the latest driver supports auto-detection of chip clock.
1222 if you still encounter too fast playback, specify the clock
1223 explicitly via the module option "ac97_clock=41194".
1224
1225 Joystick/MIDI ports are not supported by this driver. If your
1226 motherboard has these devices, use the ns558 or snd-mpu401
1227 modules, respectively.
1228
Linus Torvalds1da177e2005-04-16 15:20:36 -07001229 The power-management is supported.
1230
1231 Module snd-intel8x0m
1232 --------------------
1233
1234 Module for Intel ICH (i8x0) chipset MC97 modems.
Takashi Iwai89ac9c22006-01-24 10:36:57 +01001235 * Intel i810/810E, i815, i820, i830, i84x, MX440
1236 ICH5, ICH6, ICH7
1237 * SiS 7013 (SiS 735)
1238 * NVidia NForce, NForce2, NForce2s, NForce3
1239 * AMD AMD8111
1240 * ALi m5455
Linus Torvalds1da177e2005-04-16 15:20:36 -07001241
1242 ac97_clock - AC'97 codec clock base (0 = auto-detect)
1243
Clemens Ladischb7fe4622005-10-04 08:46:51 +02001244 This module supports one card and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001245
1246 Note: The default index value of this module is -2, i.e. the first
1247 slot is excluded.
1248
Takashi Iwaia4efc232005-11-17 17:24:26 +01001249 The power-management is supported.
1250
Linus Torvalds1da177e2005-04-16 15:20:36 -07001251 Module snd-interwave
1252 --------------------
1253
1254 Module for Gravis UltraSound PnP, Dynasonic 3-D/Pro, STB Sound Rage 32
1255 and other sound cards based on AMD InterWave (tm) chip.
1256
Linus Torvalds1da177e2005-04-16 15:20:36 -07001257 joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
1258 midi - 1 = MIDI UART enable, 0 = MIDI UART disable (default)
1259 pcm_voices - reserved PCM voices for the synthesizer (default 2)
1260 effect - 1 = InterWave effects enable (default 0);
1261 requires 8 voices
Rene Herman64e0e2d2007-12-13 16:29:33 +01001262 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1263
1264 with isapnp=0, the following options are available:
1265
1266 port - port # for InterWave chip (0x210,0x220,0x230,0x240,0x250,0x260)
1267 irq - IRQ # for InterWave chip (3,5,9,11,12,15)
1268 dma1 - DMA # for InterWave chip (0,1,3,5,6,7)
1269 dma2 - DMA # for InterWave chip (0,1,3,5,6,7,-1=disable)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001270
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001271 This module supports multiple cards, autoprobe and ISA PnP.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001272
1273 Module snd-interwave-stb
1274 ------------------------
1275
1276 Module for UltraSound 32-Pro (sound card from STB used by Compaq)
1277 and other sound cards based on AMD InterWave (tm) chip with TEA6330T
1278 circuit for extended control of bass, treble and master volume.
1279
Linus Torvalds1da177e2005-04-16 15:20:36 -07001280 joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
1281 midi - 1 = MIDI UART enable, 0 = MIDI UART disable (default)
1282 pcm_voices - reserved PCM voices for the synthesizer (default 2)
1283 effect - 1 = InterWave effects enable (default 0);
1284 requires 8 voices
Rene Herman64e0e2d2007-12-13 16:29:33 +01001285 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1286
1287 with isapnp=0, the following options are available:
1288
1289 port - port # for InterWave chip (0x210,0x220,0x230,0x240,0x250,0x260)
1290 port_tc - tone control (i2c bus) port # for TEA6330T chip (0x350,0x360,0x370,0x380)
1291 irq - IRQ # for InterWave chip (3,5,9,11,12,15)
1292 dma1 - DMA # for InterWave chip (0,1,3,5,6,7)
1293 dma2 - DMA # for InterWave chip (0,1,3,5,6,7,-1=disable)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001294
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001295 This module supports multiple cards, autoprobe and ISA PnP.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001296
1297 Module snd-korg1212
1298 -------------------
1299
1300 Module for Korg 1212 IO PCI card
1301
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001302 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001303
Giuliano Pochinidd7b2542006-06-28 13:53:41 +02001304 Module snd-layla20
1305 ------------------
1306
1307 Module for Echoaudio Layla20
1308
1309 This module supports multiple cards.
1310 The driver requires the firmware loader support on kernel.
1311
1312 Module snd-layla24
1313 ------------------
1314
1315 Module for Echoaudio Layla24
1316
1317 This module supports multiple cards.
1318 The driver requires the firmware loader support on kernel.
1319
Linus Torvalds1da177e2005-04-16 15:20:36 -07001320 Module snd-maestro3
1321 -------------------
1322
1323 Module for Allegro/Maestro3 chips
1324
1325 external_amp - enable external amp (enabled by default)
1326 amp_gpio - GPIO pin number for external amp (0-15) or
1327 -1 for default pin (8 for allegro, 1 for
1328 others)
1329
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001330 This module supports autoprobe and multiple chips.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001331
1332 Note: the binding of amplifier is dependent on hardware.
1333 If there is no sound even though all channels are unmuted, try to
1334 specify other gpio connection via amp_gpio option.
1335 For example, a Panasonic notebook might need "amp_gpio=0x0d"
1336 option.
1337
1338 The power-management is supported.
1339
Giuliano Pochinidd7b2542006-06-28 13:53:41 +02001340 Module snd-mia
1341 ---------------
1342
1343 Module for Echoaudio Mia
1344
1345 This module supports multiple cards.
1346 The driver requires the firmware loader support on kernel.
1347
Martin Langer1841f6132006-03-27 12:41:01 +02001348 Module snd-miro
1349 ---------------
1350
1351 Module for Miro soundcards: miroSOUND PCM 1 pro,
1352 miroSOUND PCM 12,
1353 miroSOUND PCM 20 Radio.
1354
1355 port - Port # (0x530,0x604,0xe80,0xf40)
1356 irq - IRQ # (5,7,9,10,11)
1357 dma1 - 1st dma # (0,1,3)
1358 dma2 - 2nd dma # (0,1)
1359 mpu_port - MPU-401 port # (0x300,0x310,0x320,0x330)
1360 mpu_irq - MPU-401 irq # (5,7,9,10)
1361 fm_port - FM Port # (0x388)
1362 wss - enable WSS mode
1363 ide - enable onboard ide support
1364
Linus Torvalds1da177e2005-04-16 15:20:36 -07001365 Module snd-mixart
1366 -----------------
1367
1368 Module for Digigram miXart8 sound cards.
1369
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001370 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001371 Note: One miXart8 board will be represented as 4 alsa cards.
1372 See MIXART.txt for details.
1373
1374 When the driver is compiled as a module and the hotplug firmware
1375 is supported, the firmware data is loaded via hotplug automatically.
1376 Install the necessary firmware files in alsa-firmware package.
1377 When no hotplug fw loader is available, you need to load the
1378 firmware via mixartloader utility in alsa-tools package.
1379
Giuliano Pochinidd7b2542006-06-28 13:53:41 +02001380 Module snd-mona
1381 ---------------
1382
1383 Module for Echoaudio Mona
1384
1385 This module supports multiple cards.
1386 The driver requires the firmware loader support on kernel.
1387
Linus Torvalds1da177e2005-04-16 15:20:36 -07001388 Module snd-mpu401
1389 -----------------
1390
1391 Module for MPU-401 UART devices.
1392
1393 port - port number or -1 (disable)
1394 irq - IRQ number or -1 (disable)
1395 pnp - PnP detection - 0 = disable, 1 = enable (default)
1396
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001397 This module supports multiple devices and PnP.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001398
1399 Module snd-mtpav
1400 ----------------
1401
1402 Module for MOTU MidiTimePiece AV multiport MIDI (on the parallel
1403 port).
1404
1405 port - I/O port # for MTPAV (0x378,0x278, default=0x378)
1406 irq - IRQ # for MTPAV (7,5, default=7)
1407 hwports - number of supported hardware ports, default=8.
1408
1409 Module supports only 1 card. This module has no enable option.
1410
Matthias Koenig68ab8012006-07-27 16:59:23 +02001411 Module snd-mts64
1412 ----------------
1413
1414 Module for Ego Systems (ESI) Miditerminal 4140
1415
1416 This module supports multiple devices.
1417 Requires parport (CONFIG_PARPORT).
1418
Linus Torvalds1da177e2005-04-16 15:20:36 -07001419 Module snd-nm256
1420 ----------------
1421
1422 Module for NeoMagic NM256AV/ZX chips
1423
1424 playback_bufsize - max playback frame size in kB (4-128kB)
1425 capture_bufsize - max capture frame size in kB (4-128kB)
1426 force_ac97 - 0 or 1 (disabled by default)
1427 buffer_top - specify buffer top address
1428 use_cache - 0 or 1 (disabled by default)
1429 vaio_hack - alias buffer_top=0x25a800
1430 reset_workaround - enable AC97 RESET workaround for some laptops
Takashi Iwaid1f38cf2005-10-19 16:04:27 +02001431 reset_workaround2 - enable extended AC97 RESET workaround for some
1432 other laptops
Linus Torvalds1da177e2005-04-16 15:20:36 -07001433
Takashi Iwai8a3fb4d2005-10-20 17:10:49 +02001434 This module supports one chip and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001435
1436 The power-management is supported.
1437
1438 Note: on some notebooks the buffer address cannot be detected
1439 automatically, or causes hang-up during initialization.
Matt LaPlantefff92892006-10-03 22:47:42 +02001440 In such a case, specify the buffer top address explicitly via
1441 the buffer_top option.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001442 For example,
1443 Sony F250: buffer_top=0x25a800
1444 Sony F270: buffer_top=0x272800
1445 The driver supports only ac97 codec. It's possible to force
1446 to initialize/use ac97 although it's not detected. In such a
1447 case, use force_ac97=1 option - but *NO* guarantee whether it
1448 works!
1449
1450 Note: The NM256 chip can be linked internally with non-AC97
1451 codecs. This driver supports only the AC97 codec, and won't work
1452 with machines with other (most likely CS423x or OPL3SAx) chips,
1453 even though the device is detected in lspci. In such a case, try
1454 other drivers, e.g. snd-cs4232 or snd-opl3sa2. Some has ISA-PnP
Takashi Iwai62430082005-09-05 17:12:29 +02001455 but some doesn't have ISA PnP. You'll need to specify isapnp=0
Linus Torvalds1da177e2005-04-16 15:20:36 -07001456 and proper hardware parameters in the case without ISA PnP.
1457
1458 Note: some laptops need a workaround for AC97 RESET. For the
1459 known hardware like Dell Latitude LS and Sony PCG-F305, this
1460 workaround is enabled automatically. For other laptops with a
1461 hard freeze, you can try reset_workaround=1 option.
1462
Takashi Iwaid1f38cf2005-10-19 16:04:27 +02001463 Note: Dell Latitude CSx laptops have another problem regarding
1464 AC97 RESET. On these laptops, reset_workaround2 option is
1465 turned on as default. This option is worth to try if the
1466 previous reset_workaround option doesn't help.
1467
Linus Torvalds1da177e2005-04-16 15:20:36 -07001468 Note: This driver is really crappy. It's a porting from the
1469 OSS driver, which is a result of black-magic reverse engineering.
1470 The detection of codec will fail if the driver is loaded *after*
1471 X-server as described above. You might be able to force to load
1472 the module, but it may result in hang-up. Hence, make sure that
1473 you load this module *before* X if you encounter this kind of
1474 problem.
1475
1476 Module snd-opl3sa2
1477 ------------------
1478
1479 Module for Yamaha OPL3-SA2/SA3 sound cards.
1480
Rene Herman64e0e2d2007-12-13 16:29:33 +01001481 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1482
1483 with isapnp=0, the following options are available:
1484
Linus Torvalds1da177e2005-04-16 15:20:36 -07001485 port - control port # for OPL3-SA chip (0x370)
1486 sb_port - SB port # for OPL3-SA chip (0x220,0x240)
1487 wss_port - WSS port # for OPL3-SA chip (0x530,0xe80,0xf40,0x604)
1488 midi_port - port # for MPU-401 UART (0x300,0x330), -1 = disable
1489 fm_port - FM port # for OPL3-SA chip (0x388), -1 = disable
1490 irq - IRQ # for OPL3-SA chip (5,7,9,10)
1491 dma1 - first DMA # for Yamaha OPL3-SA chip (0,1,3)
1492 dma2 - second DMA # for Yamaha OPL3-SA chip (0,1,3), -1 = disable
Linus Torvalds1da177e2005-04-16 15:20:36 -07001493
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001494 This module supports multiple cards and ISA PnP. It does not support
Linus Torvalds1da177e2005-04-16 15:20:36 -07001495 autoprobe (if ISA PnP is not used) thus all ports must be specified!!!
1496
1497 The power-management is supported.
1498
1499 Module snd-opti92x-ad1848
1500 -------------------------
1501
1502 Module for sound cards based on OPTi 82c92x and Analog Devices AD1848 chips.
1503 Module works with OAK Mozart cards as well.
1504
Rene Herman64e0e2d2007-12-13 16:29:33 +01001505 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1506
1507 with isapnp=0, the following options are available:
1508
Linus Torvalds1da177e2005-04-16 15:20:36 -07001509 port - port # for WSS chip (0x530,0xe80,0xf40,0x604)
1510 mpu_port - port # for MPU-401 UART (0x300,0x310,0x320,0x330)
1511 fm_port - port # for OPL3 device (0x388)
1512 irq - IRQ # for WSS chip (5,7,9,10,11)
1513 mpu_irq - IRQ # for MPU-401 UART (5,7,9,10)
1514 dma1 - first DMA # for WSS chip (0,1,3)
1515
1516 This module supports only one card, autoprobe and PnP.
1517
1518 Module snd-opti92x-cs4231
1519 -------------------------
1520
1521 Module for sound cards based on OPTi 82c92x and Crystal CS4231 chips.
1522
Rene Herman64e0e2d2007-12-13 16:29:33 +01001523 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1524
1525 with isapnp=0, the following options are available:
1526
Linus Torvalds1da177e2005-04-16 15:20:36 -07001527 port - port # for WSS chip (0x530,0xe80,0xf40,0x604)
1528 mpu_port - port # for MPU-401 UART (0x300,0x310,0x320,0x330)
1529 fm_port - port # for OPL3 device (0x388)
1530 irq - IRQ # for WSS chip (5,7,9,10,11)
1531 mpu_irq - IRQ # for MPU-401 UART (5,7,9,10)
1532 dma1 - first DMA # for WSS chip (0,1,3)
1533 dma2 - second DMA # for WSS chip (0,1,3)
1534
1535 This module supports only one card, autoprobe and PnP.
1536
1537 Module snd-opti93x
1538 ------------------
1539
1540 Module for sound cards based on OPTi 82c93x chips.
1541
Rene Herman64e0e2d2007-12-13 16:29:33 +01001542 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1543
1544 with isapnp=0, the following options are available:
1545
Linus Torvalds1da177e2005-04-16 15:20:36 -07001546 port - port # for WSS chip (0x530,0xe80,0xf40,0x604)
1547 mpu_port - port # for MPU-401 UART (0x300,0x310,0x320,0x330)
1548 fm_port - port # for OPL3 device (0x388)
1549 irq - IRQ # for WSS chip (5,7,9,10,11)
1550 mpu_irq - IRQ # for MPU-401 UART (5,7,9,10)
1551 dma1 - first DMA # for WSS chip (0,1,3)
1552 dma2 - second DMA # for WSS chip (0,1,3)
1553
1554 This module supports only one card, autoprobe and PnP.
1555
Markus Bollingere12229b2005-12-06 13:55:26 +01001556 Module snd-pcxhr
1557 ----------------
1558
1559 Module for Digigram PCXHR boards
1560
1561 This module supports multiple cards.
1562
Matthias Koenig757e1192007-01-25 13:15:05 +01001563 Module snd-portman2x4
1564 ---------------------
1565
1566 Module for Midiman Portman 2x4 parallel port MIDI interface
1567
1568 This module supports multiple cards.
1569
Linus Torvalds1da177e2005-04-16 15:20:36 -07001570 Module snd-powermac (on ppc only)
1571 ---------------------------------
1572
1573 Module for PowerMac, iMac and iBook on-board soundchips
1574
1575 enable_beep - enable beep using PCM (enabled as default)
1576
1577 Module supports autoprobe a chip.
1578
1579 Note: the driver may have problems regarding endianess.
1580
1581 The power-management is supported.
1582
Takashi Iwai2c484df2005-06-30 18:54:04 +02001583 Module snd-pxa2xx-ac97 (on arm only)
1584 ------------------------------------
1585
1586 Module for AC97 driver for the Intel PXA2xx chip
1587
1588 For ARM architecture only.
1589
Takashi Iwaia4efc232005-11-17 17:24:26 +01001590 The power-management is supported.
1591
Peter Gruber109a9632006-03-27 13:10:28 +02001592 Module snd-riptide
1593 ------------------
1594
1595 Module for Conexant Riptide chip
1596
1597 joystick_port - Joystick port # (default: 0x200)
1598 mpu_port - MPU401 port # (default: 0x330)
1599 opl3_port - OPL3 port # (default: 0x388)
1600
1601 This module supports multiple cards.
1602 The driver requires the firmware loader support on kernel.
1603 You need to install the firmware file "riptide.hex" to the standard
1604 firmware path (e.g. /lib/firmware).
1605
Linus Torvalds1da177e2005-04-16 15:20:36 -07001606 Module snd-rme32
1607 ----------------
1608
1609 Module for RME Digi32, Digi32 Pro and Digi32/8 (Sek'd Prodif32,
1610 Prodif96 and Prodif Gold) sound cards.
1611
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001612 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001613
1614 Module snd-rme96
1615 ----------------
1616
1617 Module for RME Digi96, Digi96/8 and Digi96/8 PRO/PAD/PST sound cards.
1618
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001619 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001620
1621 Module snd-rme9652
1622 ------------------
1623
1624 Module for RME Digi9652 (Hammerfall, Hammerfall-Light) sound cards.
1625
1626 precise_ptr - Enable precise pointer (doesn't work reliably).
1627 (default = 0)
1628
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001629 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001630
1631 Note: snd-page-alloc module does the job which snd-hammerfall-mem
1632 module did formerly. It will allocate the buffers in advance
1633 when any RME9652 cards are found. To make the buffer
1634 allocation sure, load snd-page-alloc module in the early
Takashi Iwaib6a96912005-05-30 18:27:03 +02001635 stage of boot sequence. See "Early Buffer Allocation"
1636 section.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001637
1638 Module snd-sa11xx-uda1341 (on arm only)
1639 ---------------------------------------
1640
1641 Module for Philips UDA1341TS on Compaq iPAQ H3600 sound card.
1642
1643 Module supports only one card.
1644 Module has no enable and index options.
1645
Takashi Iwaia4efc232005-11-17 17:24:26 +01001646 The power-management is supported.
1647
Linus Torvalds1da177e2005-04-16 15:20:36 -07001648 Module snd-sb8
1649 --------------
1650
1651 Module for 8-bit SoundBlaster cards: SoundBlaster 1.0,
1652 SoundBlaster 2.0,
1653 SoundBlaster Pro
1654
1655 port - port # for SB DSP chip (0x220,0x240,0x260)
1656 irq - IRQ # for SB DSP chip (5,7,9,10)
1657 dma8 - DMA # for SB DSP chip (1,3)
1658
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001659 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001660
Takashi Iwaia4efc232005-11-17 17:24:26 +01001661 The power-management is supported.
1662
Linus Torvalds1da177e2005-04-16 15:20:36 -07001663 Module snd-sb16 and snd-sbawe
1664 -----------------------------
1665
1666 Module for 16-bit SoundBlaster cards: SoundBlaster 16 (PnP),
1667 SoundBlaster AWE 32 (PnP),
1668 SoundBlaster AWE 64 PnP
1669
Rene Herman64e0e2d2007-12-13 16:29:33 +01001670 mic_agc - Mic Auto-Gain-Control - 0 = disable, 1 = enable (default)
1671 csp - ASP/CSP chip support - 0 = disable (default), 1 = enable
1672 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1673
1674 with isapnp=0, the following options are available:
1675
Linus Torvalds1da177e2005-04-16 15:20:36 -07001676 port - port # for SB DSP 4.x chip (0x220,0x240,0x260)
1677 mpu_port - port # for MPU-401 UART (0x300,0x330), -1 = disable
1678 awe_port - base port # for EMU8000 synthesizer (0x620,0x640,0x660)
1679 (snd-sbawe module only)
1680 irq - IRQ # for SB DSP 4.x chip (5,7,9,10)
1681 dma8 - 8-bit DMA # for SB DSP 4.x chip (0,1,3)
1682 dma16 - 16-bit DMA # for SB DSP 4.x chip (5,6,7)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001683
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001684 This module supports multiple cards, autoprobe and ISA PnP.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001685
1686 Note: To use Vibra16X cards in 16-bit half duplex mode, you must
1687 disable 16bit DMA with dma16 = -1 module parameter.
1688 Also, all Sound Blaster 16 type cards can operate in 16-bit
1689 half duplex mode through 8-bit DMA channel by disabling their
1690 16-bit DMA channel.
1691
Takashi Iwaia4efc232005-11-17 17:24:26 +01001692 The power-management is supported.
1693
Takashi Iwai074a6e92007-09-11 22:10:14 +02001694 Module snd-sc6000
1695 -----------------
1696
1697 Module for Gallant SC-6000 soundcard.
1698
1699 port - Port # (0x220 or 0x240)
1700 mss_port - MSS Port # (0x530 or 0xe80)
1701 irq - IRQ # (5,7,9,10,11)
Krzysztof Helt7b758d22007-09-17 14:42:49 +02001702 mpu_irq - MPU-401 IRQ # (5,7,9,10) ,0 - no MPU-401 irq
Takashi Iwai074a6e92007-09-11 22:10:14 +02001703 dma - DMA # (1,3,0)
1704
1705 This module supports multiple cards.
1706
1707 This card is also known as Audio Excel DSP 16 or Zoltrix AV302.
1708
Linus Torvalds1da177e2005-04-16 15:20:36 -07001709 Module snd-sgalaxy
1710 ------------------
1711
1712 Module for Aztech Sound Galaxy sound card.
1713
1714 sbport - Port # for SB16 interface (0x220,0x240)
1715 wssport - Port # for WSS interface (0x530,0xe80,0xf40,0x604)
1716 irq - IRQ # (7,9,10,11)
1717 dma1 - DMA #
1718
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001719 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001720
Takashi Iwaia4efc232005-11-17 17:24:26 +01001721 The power-management is supported.
1722
Linus Torvalds1da177e2005-04-16 15:20:36 -07001723 Module snd-sscape
1724 -----------------
1725
1726 Module for ENSONIQ SoundScape PnP cards.
1727
1728 port - Port # (PnP setup)
Takashi Iwaiadf12952007-09-17 16:26:16 +02001729 wss_port - WSS Port # (PnP setup)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001730 irq - IRQ # (PnP setup)
1731 mpu_irq - MPU-401 IRQ # (PnP setup)
1732 dma - DMA # (PnP setup)
Takashi Iwaiadf12952007-09-17 16:26:16 +02001733 dma2 - 2nd DMA # (PnP setup, -1 to disable)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001734
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001735 This module supports multiple cards. ISA PnP must be enabled.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001736 You need sscape_ctl tool in alsa-tools package for loading
1737 the microcode.
1738
1739 Module snd-sun-amd7930 (on sparc only)
1740 --------------------------------------
1741
1742 Module for AMD7930 sound chips found on Sparcs.
1743
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001744 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001745
1746 Module snd-sun-cs4231 (on sparc only)
1747 -------------------------------------
1748
1749 Module for CS4231 sound chips found on Sparcs.
1750
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001751 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001752
Takashi Iwai1bd9deb2005-06-30 18:26:20 +02001753 Module snd-sun-dbri (on sparc only)
1754 -----------------------------------
1755
1756 Module for DBRI sound chips found on Sparcs.
1757
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001758 This module supports multiple cards.
Takashi Iwai1bd9deb2005-06-30 18:26:20 +02001759
Linus Torvalds1da177e2005-04-16 15:20:36 -07001760 Module snd-wavefront
1761 --------------------
1762
1763 Module for Turtle Beach Maui, Tropez and Tropez+ sound cards.
1764
Rene Herman64e0e2d2007-12-13 16:29:33 +01001765 use_cs4232_midi - Use CS4232 MPU-401 interface
1766 (inaccessibly located inside your computer)
1767 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1768
1769 with isapnp=0, the following options are available:
1770
Linus Torvalds1da177e2005-04-16 15:20:36 -07001771 cs4232_pcm_port - Port # for CS4232 PCM interface.
1772 cs4232_pcm_irq - IRQ # for CS4232 PCM interface (5,7,9,11,12,15).
1773 cs4232_mpu_port - Port # for CS4232 MPU-401 interface.
1774 cs4232_mpu_irq - IRQ # for CS4232 MPU-401 interface (9,11,12,15).
Linus Torvalds1da177e2005-04-16 15:20:36 -07001775 ics2115_port - Port # for ICS2115
1776 ics2115_irq - IRQ # for ICS2115
1777 fm_port - FM OPL-3 Port #
1778 dma1 - DMA1 # for CS4232 PCM interface.
1779 dma2 - DMA2 # for CS4232 PCM interface.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001780
Takashi Iwaic2b12392007-08-21 15:20:26 +02001781 The below are options for wavefront_synth features:
1782 wf_raw - Assume that we need to boot the OS (default:no)
1783 If yes, then during driver loading, the state of the board is
1784 ignored, and we reset the board and load the firmware anyway.
1785 fx_raw - Assume that the FX process needs help (default:yes)
1786 If false, we'll leave the FX processor in whatever state it is
1787 when the driver is loaded. The default is to download the
1788 microprogram and associated coefficients to set it up for
1789 "default" operation, whatever that means.
1790 debug_default - Debug parameters for card initialization
1791 wait_usecs - How long to wait without sleeping, usecs
1792 (default:150)
1793 This magic number seems to give pretty optimal throughput
1794 based on my limited experimentation.
1795 If you want to play around with it and find a better value, be
1796 my guest. Remember, the idea is to get a number that causes us
1797 to just busy wait for as many WaveFront commands as possible,
1798 without coming up with a number so large that we hog the whole
1799 CPU.
1800 Specifically, with this number, out of about 134,000 status
1801 waits, only about 250 result in a sleep.
1802 sleep_interval - How long to sleep when waiting for reply
1803 (default: 100)
1804 sleep_tries - How many times to try sleeping during a wait
1805 (default: 50)
1806 ospath - Pathname to processed ICS2115 OS firmware
1807 (default:wavefront.os)
1808 The path name of the ISC2115 OS firmware. In the recent
1809 version, it's handled via firmware loader framework, so it
1810 must be installed in the proper path, typically,
1811 /lib/firmware.
1812 reset_time - How long to wait for a reset to take effect
1813 (default:2)
1814 ramcheck_time - How many seconds to wait for the RAM test
1815 (default:20)
1816 osrun_time - How many seconds to wait for the ICS2115 OS
1817 (default:10)
1818
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001819 This module supports multiple cards and ISA PnP.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001820
Takashi Iwaic2b12392007-08-21 15:20:26 +02001821 Note: the firmware file "wavefront.os" was located in the earlier
1822 version in /etc. Now it's loaded via firmware loader, and
1823 must be in the proper firmware path, such as /lib/firmware.
1824 Copy (or symlink) the file appropriately if you get an error
1825 regarding firmware downloading after upgrading the kernel.
1826
Linus Torvalds1da177e2005-04-16 15:20:36 -07001827 Module snd-sonicvibes
1828 ---------------------
1829
1830 Module for S3 SonicVibes PCI sound cards.
1831 * PINE Schubert 32 PCI
1832
1833 reverb - Reverb Enable - 1 = enable, 0 = disable (default)
1834 - SoundCard must have onboard SRAM for this.
1835 mge - Mic Gain Enable - 1 = enable, 0 = disable (default)
1836
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001837 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001838
1839 Module snd-serial-u16550
1840 ------------------------
1841
1842 Module for UART16550A serial MIDI ports.
1843
1844 port - port # for UART16550A chip
1845 irq - IRQ # for UART16550A chip, -1 = poll mode
1846 speed - speed in bauds (9600,19200,38400,57600,115200)
1847 38400 = default
1848 base - base for divisor in bauds (57600,115200,230400,460800)
1849 115200 = default
1850 outs - number of MIDI ports in a serial port (1-4)
1851 1 = default
1852 adaptor - Type of adaptor.
1853 0 = Soundcanvas, 1 = MS-124T, 2 = MS-124W S/A,
1854 3 = MS-124W M/B, 4 = Generic
1855
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001856 This module supports multiple cards. This module does not support autoprobe
Linus Torvalds1da177e2005-04-16 15:20:36 -07001857 thus the main port must be specified!!! Other options are optional.
1858
1859 Module snd-trident
1860 ------------------
1861
1862 Module for Trident 4DWave DX/NX sound cards.
1863 * Best Union Miss Melody 4DWave PCI
1864 * HIS 4DWave PCI
1865 * Warpspeed ONSpeed 4DWave PCI
1866 * AzTech PCI 64-Q3D
1867 * Addonics SV 750
1868 * CHIC True Sound 4Dwave
1869 * Shark Predator4D-PCI
1870 * Jaton SonicWave 4D
1871
1872 pcm_channels - max channels (voices) reserved for PCM
1873 wavetable_size - max wavetable size in kB (4-?kb)
1874
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001875 This module supports multiple cards and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001876
1877 The power-management is supported.
1878
1879 Module snd-usb-audio
1880 --------------------
1881
1882 Module for USB audio and USB MIDI devices.
1883
1884 vid - Vendor ID for the device (optional)
1885 pid - Product ID for the device (optional)
Thibault LE MEURe3113342006-03-14 11:44:53 +01001886 device_setup - Device specific magic number (optional)
1887 - Influence depends on the device
1888 - Default: 0x0000
Linus Torvalds1da177e2005-04-16 15:20:36 -07001889
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001890 This module supports multiple devices, autoprobe and hotplugging.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001891
Daniel Mack523f1dc2007-03-26 19:11:24 +02001892 Module snd-usb-caiaq
1893 --------------------
1894
1895 Module for caiaq UB audio interfaces,
1896 * Native Instruments RigKontrol2
1897 * Native Instruments Kore Controller
1898 * Native Instruments Audio Kontrol 1
1899 * Native Instruments Audio 8 DJ
1900
1901 This module supports multiple devices, autoprobe and hotplugging.
1902
Linus Torvalds1da177e2005-04-16 15:20:36 -07001903 Module snd-usb-usx2y
1904 --------------------
1905
1906 Module for Tascam USB US-122, US-224 and US-428 devices.
1907
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001908 This module supports multiple devices, autoprobe and hotplugging.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001909
1910 Note: you need to load the firmware via usx2yloader utility included
1911 in alsa-tools and alsa-firmware packages.
1912
1913 Module snd-via82xx
1914 ------------------
1915
1916 Module for AC'97 motherboards based on VIA 82C686A/686B, 8233,
Sergey Vlasov2d7eb7c2005-04-11 15:04:33 +02001917 8233A, 8233C, 8235, 8237 (south) bridge.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001918
1919 mpu_port - 0x300,0x310,0x320,0x330, otherwise obtain BIOS setup
1920 [VIA686A/686B only]
1921 joystick - Enable joystick (default off) [VIA686A/686B only]
1922 ac97_clock - AC'97 codec clock base (default 48000Hz)
1923 dxs_support - support DXS channels,
Sergey Vlasov2d7eb7c2005-04-11 15:04:33 +02001924 0 = auto (default), 1 = enable, 2 = disable,
1925 3 = 48k only, 4 = no VRA, 5 = enable any sample
1926 rate and different sample rates on different
1927 channels
1928 [VIA8233/C, 8235, 8237 only]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001929 ac97_quirk - AC'97 workaround for strange hardware
Takashi Iwai62430082005-09-05 17:12:29 +02001930 See "AC97 Quirk Option" section below.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001931
Clemens Ladischb7fe4622005-10-04 08:46:51 +02001932 This module supports one chip and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001933
1934 Note: on some SMP motherboards like MSI 694D the interrupts might
1935 not be generated properly. In such a case, please try to
1936 set the SMP (or MPS) version on BIOS to 1.1 instead of
1937 default value 1.4. Then the interrupt number will be
1938 assigned under 15. You might also upgrade your BIOS.
1939
Sergey Vlasov2d7eb7c2005-04-11 15:04:33 +02001940 Note: VIA8233/5/7 (not VIA8233A) can support DXS (direct sound)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001941 channels as the first PCM. On these channels, up to 4
Sergey Vlasov2d7eb7c2005-04-11 15:04:33 +02001942 streams can be played at the same time, and the controller
1943 can perform sample rate conversion with separate rates for
1944 each channel.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001945 As default (dxs_support = 0), 48k fixed rate is chosen
1946 except for the known devices since the output is often
1947 noisy except for 48k on some mother boards due to the
1948 bug of BIOS.
Sergey Vlasov2d7eb7c2005-04-11 15:04:33 +02001949 Please try once dxs_support=5 and if it works on other
Linus Torvalds1da177e2005-04-16 15:20:36 -07001950 sample rates (e.g. 44.1kHz of mp3 playback), please let us
1951 know the PCI subsystem vendor/device id's (output of
1952 "lspci -nv").
Takashi Iwaicdc27f32005-05-27 11:11:02 +02001953 If dxs_support=5 does not work, try dxs_support=4; if it
1954 doesn't work too, try dxs_support=1. (dxs_support=1 is
Takashi Iwai62430082005-09-05 17:12:29 +02001955 usually for old motherboards. The correct implemented
Takashi Iwaicdc27f32005-05-27 11:11:02 +02001956 board should work with 4 or 5.) If it still doesn't
Linus Torvalds1da177e2005-04-16 15:20:36 -07001957 work and the default setting is ok, dxs_support=3 is the
1958 right choice. If the default setting doesn't work at all,
1959 try dxs_support=2 to disable the DXS channels.
1960 In any cases, please let us know the result and the
Takashi Iwai62430082005-09-05 17:12:29 +02001961 subsystem vendor/device ids. See "Links and Addresses"
1962 below.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001963
1964 Note: for the MPU401 on VIA823x, use snd-mpu401 driver
Takashi Iwai62430082005-09-05 17:12:29 +02001965 additionally. The mpu_port option is for VIA686 chips only.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001966
Takashi Iwaia4efc232005-11-17 17:24:26 +01001967 The power-management is supported.
1968
Linus Torvalds1da177e2005-04-16 15:20:36 -07001969 Module snd-via82xx-modem
1970 ------------------------
1971
1972 Module for VIA82xx AC97 modem
1973
1974 ac97_clock - AC'97 codec clock base (default 48000Hz)
1975
Clemens Ladischb7fe4622005-10-04 08:46:51 +02001976 This module supports one card and autoprobe.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001977
1978 Note: The default index value of this module is -2, i.e. the first
1979 slot is excluded.
1980
Takashi Iwaia4efc232005-11-17 17:24:26 +01001981 The power-management is supported.
1982
Linus Torvalds1da177e2005-04-16 15:20:36 -07001983 Module snd-virmidi
1984 ------------------
1985
1986 Module for virtual rawmidi devices.
1987 This module creates virtual rawmidi devices which communicate
1988 to the corresponding ALSA sequencer ports.
1989
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001990 midi_devs - MIDI devices # (1-4, default=4)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001991
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01001992 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001993
1994 Module snd-vx222
1995 ----------------
1996
1997 Module for Digigram VX-Pocket VX222, V222 v2 and Mic cards.
1998
1999 mic - Enable Microphone on V222 Mic (NYI)
2000 ibl - Capture IBL size. (default = 0, minimum size)
2001
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01002002 This module supports multiple cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002003
2004 When the driver is compiled as a module and the hotplug firmware
2005 is supported, the firmware data is loaded via hotplug automatically.
2006 Install the necessary firmware files in alsa-firmware package.
2007 When no hotplug fw loader is available, you need to load the
2008 firmware via vxloader utility in alsa-tools package. To invoke
2009 vxloader automatically, add the following to /etc/modprobe.conf
2010
2011 install snd-vx222 /sbin/modprobe --first-time -i snd-vx222 && /usr/bin/vxloader
2012
2013 (for 2.2/2.4 kernels, add "post-install /usr/bin/vxloader" to
2014 /etc/modules.conf, instead.)
2015 IBL size defines the interrupts period for PCM. The smaller size
2016 gives smaller latency but leads to more CPU consumption, too.
2017 The size is usually aligned to 126. As default (=0), the smallest
2018 size is chosen. The possible IBL values can be found in
2019 /proc/asound/cardX/vx-status proc file.
2020
Takashi Iwaia4efc232005-11-17 17:24:26 +01002021 The power-management is supported.
2022
Linus Torvalds1da177e2005-04-16 15:20:36 -07002023 Module snd-vxpocket
2024 -------------------
2025
Takashi Iwai6d00a312005-06-30 13:40:51 +02002026 Module for Digigram VX-Pocket VX2 and 440 PCMCIA cards.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002027
2028 ibl - Capture IBL size. (default = 0, minimum size)
2029
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01002030 This module supports multiple cards. The module is compiled only when
Linus Torvalds1da177e2005-04-16 15:20:36 -07002031 PCMCIA is supported on kernel.
2032
Takashi Iwai62430082005-09-05 17:12:29 +02002033 With the older 2.6.x kernel, to activate the driver via the card
2034 manager, you'll need to set up /etc/pcmcia/vxpocket.conf. See the
2035 sound/pcmcia/vx/vxpocket.c. 2.6.13 or later kernel requires no
2036 longer require a config file.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002037
2038 When the driver is compiled as a module and the hotplug firmware
2039 is supported, the firmware data is loaded via hotplug automatically.
2040 Install the necessary firmware files in alsa-firmware package.
2041 When no hotplug fw loader is available, you need to load the
2042 firmware via vxloader utility in alsa-tools package.
2043
2044 About capture IBL, see the description of snd-vx222 module.
2045
Takashi Iwaied7cbe32006-05-11 11:30:10 +02002046 Note: snd-vxp440 driver is merged to snd-vxpocket driver since
Takashi Iwai62430082005-09-05 17:12:29 +02002047 ALSA 1.0.10.
2048
Takashi Iwaia4efc232005-11-17 17:24:26 +01002049 The power-management is supported.
2050
Linus Torvalds1da177e2005-04-16 15:20:36 -07002051 Module snd-ymfpci
2052 -----------------
2053
2054 Module for Yamaha PCI chips (YMF72x, YMF74x & YMF75x).
2055
2056 mpu_port - 0x300,0x330,0x332,0x334, 0 (disable) by default,
2057 1 (auto-detect for YMF744/754 only)
2058 fm_port - 0x388,0x398,0x3a0,0x3a8, 0 (disable) by default
2059 1 (auto-detect for YMF744/754 only)
2060 joystick_port - 0x201,0x202,0x204,0x205, 0 (disable) by default,
2061 1 (auto-detect)
2062 rear_switch - enable shared rear/line-in switch (bool)
2063
Clemens Ladisch0ef797c2005-11-21 07:30:20 +01002064 This module supports autoprobe and multiple chips.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002065
2066 The power-management is supported.
2067
2068 Module snd-pdaudiocf
2069 --------------------
2070
2071 Module for Sound Core PDAudioCF sound card.
2072
Takashi Iwaia4efc232005-11-17 17:24:26 +01002073 The power-management is supported.
2074
Linus Torvalds1da177e2005-04-16 15:20:36 -07002075
Takashi Iwai62430082005-09-05 17:12:29 +02002076AC97 Quirk Option
2077=================
2078
2079The ac97_quirk option is used to enable/override the workaround for
2080specific devices on drivers for on-board AC'97 controllers like
2081snd-intel8x0. Some hardware have swapped output pins between Master
2082and Headphone, or Surround (thanks to confusion of AC'97
2083specifications from version to version :-)
2084
2085The driver provides the auto-detection of known problematic devices,
2086but some might be unknown or wrongly detected. In such a case, pass
2087the proper value with this option.
2088
2089The following strings are accepted:
2090 - default Don't override the default setting
Takashi Iwai10e4097f2005-11-17 11:04:55 +01002091 - none Disable the quirk
Takashi Iwai62430082005-09-05 17:12:29 +02002092 - hp_only Bind Master and Headphone controls as a single control
2093 - swap_hp Swap headphone and master controls
2094 - swap_surround Swap master and surround controls
2095 - ad_sharing For AD1985, turn on OMS bit and use headphone
2096 - alc_jack For ALC65x, turn on the jack sense mode
2097 - inv_eapd Inverted EAPD implementation
2098 - mute_led Bind EAPD bit for turning on/off mute LED
2099
2100For backward compatibility, the corresponding integer value -1, 0,
2101... are accepted, too.
2102
2103For example, if "Master" volume control has no effect on your device
2104but only "Headphone" does, pass ac97_quirk=hp_only module option.
2105
2106
Linus Torvalds1da177e2005-04-16 15:20:36 -07002107Configuring Non-ISAPNP Cards
2108============================
2109
2110When the kernel is configured with ISA-PnP support, the modules
2111supporting the isapnp cards will have module options "isapnp".
2112If this option is set, *only* the ISA-PnP devices will be probed.
2113For probing the non ISA-PnP cards, you have to pass "isapnp=0" option
2114together with the proper i/o and irq configuration.
2115
2116When the kernel is configured without ISA-PnP support, isapnp option
2117will be not built in.
2118
2119
2120Module Autoloading Support
2121==========================
2122
2123The ALSA drivers can be loaded automatically on demand by defining
2124module aliases. The string 'snd-card-%1' is requested for ALSA native
2125devices where %i is sound card number from zero to seven.
2126
2127To auto-load an ALSA driver for OSS services, define the string
2128'sound-slot-%i' where %i means the slot number for OSS, which
2129corresponds to the card index of ALSA. Usually, define this
Tobias Klauserd533f672005-09-10 00:26:46 -07002130as the same card module.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002131
2132An example configuration for a single emu10k1 card is like below:
2133----- /etc/modprobe.conf
2134alias snd-card-0 snd-emu10k1
2135alias sound-slot-0 snd-emu10k1
2136----- /etc/modprobe.conf
2137
2138The available number of auto-loaded sound cards depends on the module
2139option "cards_limit" of snd module. As default it's set to 1.
2140To enable the auto-loading of multiple cards, specify the number of
2141sound cards in that option.
2142
2143When multiple cards are available, it'd better to specify the index
2144number for each card via module option, too, so that the order of
2145cards is kept consistent.
2146
2147An example configuration for two sound cards is like below:
2148
2149----- /etc/modprobe.conf
2150# ALSA portion
2151options snd cards_limit=2
2152alias snd-card-0 snd-interwave
2153alias snd-card-1 snd-ens1371
2154options snd-interwave index=0
2155options snd-ens1371 index=1
2156# OSS/Free portion
2157alias sound-slot-0 snd-interwave
2158alias sound-slot-1 snd-ens1371
Matt LaPlante2fe0ae72006-10-03 22:50:39 +02002159----- /etc/modprobe.conf
Linus Torvalds1da177e2005-04-16 15:20:36 -07002160
2161In this example, the interwave card is always loaded as the first card
2162(index 0) and ens1371 as the second (index 1).
2163
Takashi Iwai304cd072007-10-26 15:10:15 +02002164Alternative (and new) way to fixate the slot assignment is to use
2165"slots" option of snd module. In the case above, specify like the
2166following:
2167
2168options snd slots=snd-interwave,snd-ens1371
2169
2170Then, the first slot (#0) is reserved for snd-interwave driver, and
2171the second (#1) for snd-ens1371. You can omit index option in each
2172driver if slots option is used (although you can still have them at
2173the same time as long as they don't conflict).
2174
2175The slots option is especially useful for avoiding the possible
2176hot-plugging and the resultant slot conflict. For example, in the
2177case above again, the first two slots are already reserved. If any
2178other driver (e.g. snd-usb-audio) is loaded before snd-interwave or
2179snd-ens1371, it will be assigned to the third or later slot.
2180
Linus Torvalds1da177e2005-04-16 15:20:36 -07002181
2182ALSA PCM devices to OSS devices mapping
2183=======================================
2184
2185/dev/snd/pcmC0D0[c|p] -> /dev/audio0 (/dev/audio) -> minor 4
2186/dev/snd/pcmC0D0[c|p] -> /dev/dsp0 (/dev/dsp) -> minor 3
2187/dev/snd/pcmC0D1[c|p] -> /dev/adsp0 (/dev/adsp) -> minor 12
2188/dev/snd/pcmC1D0[c|p] -> /dev/audio1 -> minor 4+16 = 20
2189/dev/snd/pcmC1D0[c|p] -> /dev/dsp1 -> minor 3+16 = 19
2190/dev/snd/pcmC1D1[c|p] -> /dev/adsp1 -> minor 12+16 = 28
2191/dev/snd/pcmC2D0[c|p] -> /dev/audio2 -> minor 4+32 = 36
2192/dev/snd/pcmC2D0[c|p] -> /dev/dsp2 -> minor 3+32 = 39
2193/dev/snd/pcmC2D1[c|p] -> /dev/adsp2 -> minor 12+32 = 44
2194
2195The first number from /dev/snd/pcmC{X}D{Y}[c|p] expression means
2196sound card number and second means device number. The ALSA devices
2197have either 'c' or 'p' suffix indicating the direction, capture and
2198playback, respectively.
2199
2200Please note that the device mapping above may be varied via the module
2201options of snd-pcm-oss module.
2202
2203
Linus Torvalds1da177e2005-04-16 15:20:36 -07002204Proc interfaces (/proc/asound)
2205==============================
2206
2207/proc/asound/card#/pcm#[cp]/oss
2208-------------------------------
2209 String "erase" - erase all additional informations about OSS applications
2210 String "<app_name> <fragments> <fragment_size> [<options>]"
2211
2212 <app_name> - name of application with (higher priority) or without path
2213 <fragments> - number of fragments or zero if auto
2214 <fragment_size> - size of fragment in bytes or zero if auto
2215 <options> - optional parameters
2216 - disable the application tries to open a pcm device for
2217 this channel but does not want to use it.
2218 (Cause a bug or mmap needs)
2219 It's good for Quake etc...
2220 - direct don't use plugins
2221 - block force block mode (rvplayer)
2222 - non-block force non-block mode
2223 - whole-frag write only whole fragments (optimization affecting
2224 playback only)
2225 - no-silence do not fill silence ahead to avoid clicks
Takashi Iwai10f69f92005-09-08 13:48:34 +02002226 - buggy-ptr Returns the whitespace blocks in GETOPTR ioctl
2227 instead of filled blocks
Linus Torvalds1da177e2005-04-16 15:20:36 -07002228
2229 Example: echo "x11amp 128 16384" > /proc/asound/card0/pcm0p/oss
2230 echo "squake 0 0 disable" > /proc/asound/card0/pcm0c/oss
2231 echo "rvplayer 0 0 block" > /proc/asound/card0/pcm0p/oss
2232
2233
Takashi Iwaib6a96912005-05-30 18:27:03 +02002234Early Buffer Allocation
2235=======================
2236
2237Some drivers (e.g. hdsp) require the large contiguous buffers, and
2238sometimes it's too late to find such spaces when the driver module is
2239actually loaded due to memory fragmentation. You can pre-allocate the
2240PCM buffers by loading snd-page-alloc module and write commands to its
2241proc file in prior, for example, in the early boot stage like
2242/etc/init.d/*.local scripts.
2243
2244Reading the proc file /proc/drivers/snd-page-alloc shows the current
2245usage of page allocation. In writing, you can send the following
2246commands to the snd-page-alloc driver:
2247
2248 - add VENDOR DEVICE MASK SIZE BUFFERS
2249
2250 VENDOR and DEVICE are PCI vendor and device IDs. They take
2251 integer numbers (0x prefix is needed for the hex).
2252 MASK is the PCI DMA mask. Pass 0 if not restricted.
2253 SIZE is the size of each buffer to allocate. You can pass
2254 k and m suffix for KB and MB. The max number is 16MB.
2255 BUFFERS is the number of buffers to allocate. It must be greater
2256 than 0. The max number is 4.
2257
2258 - erase
2259
2260 This will erase the all pre-allocated buffers which are not in
2261 use.
2262
2263
Takashi Iwai62430082005-09-05 17:12:29 +02002264Links and Addresses
2265===================
Linus Torvalds1da177e2005-04-16 15:20:36 -07002266
2267 ALSA project homepage
2268 http://www.alsa-project.org
2269
Takashi Iwai62430082005-09-05 17:12:29 +02002270 ALSA Bug Tracking System
2271 https://bugtrack.alsa-project.org/bugs/
2272
2273 ALSA Developers ML
Rene Herman45051792007-03-21 12:05:06 +01002274 mailto:alsa-devel@alsa-project.org