projects / GitHub / mt8127 / android_kernel_alcatel_ttab.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Merge branch 'topic/hda-doc' into topic/hda
[GitHub/mt8127/android_kernel_alcatel_ttab.git] / Documentation / sound / alsa / ALSA-Configuration.txt
CommitLineData
1da177e4
LT		 1
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.
304cd07f
TI		 60 slots - Reserve the slot index for the given driver.
61 This option takes multiple strings.
62 See "Module Autoloading Support" section for details.
1da177e4
LT		 63
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
6243008b 75 - Don't block opening busy PCM devices. Default: 1
1da177e4
LT		 76
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
0ef797c5 105 - Values: 0 through 31 or negative
1da177e4
LT		 106 - 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
cf40a310
RH		 120 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
1da177e4
LT		 148 Module snd-ad1816a
149 ------------------
150
151 Module for sound cards based on Analog Devices AD1816A/AD1815 ISA chips.
152
506d4c6a 153 clockfreq - Clock frequency for AD1816A chip (default = 0, 33000Hz)
1da177e4 154
0ef797c5 155 This module supports multiple cards, autoprobe and PnP.
1da177e4
LT		 156
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
0ef797c5 166 This module supports multiple cards. It does not support autoprobe
1da177e4
LT		 167 thus main port must be specified!!! Other ports are optional.
168
a4efc230
TI		 169 The power-management is supported.
170
84010e6f
CL		 171 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
0ef797c5 179 This module supports multiple cards.
84010e6f 180
1da177e4
LT		 181 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
8a3fb4d0 190 This module supports one chip and autoprobe.
1da177e4
LT		 191
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
0ef797c5 199 This module supports multiple cards, autoprobe and PnP.
1da177e4 200
a4efc230
TI		 201 The power-management is supported.
202
b3a70d5e
AW		 203 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
1da177e4
LT		 212 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
0ef797c5 220 This module supports multiple cards, autoprobe and PnP.
1da177e4 221
a4efc230
TI		 222 The power-management is supported.
223
1da177e4
LT		 224 Module snd-atiixp
225 -----------------
226
6243008b 227 Module for ATI IXP 150/200/250/400 AC97 controllers.
1da177e4 228
6243008b 229 ac97_clock - AC'97 clock (default = 48000)
1da177e4 230 ac97_quirk - AC'97 workaround for strange hardware
6243008b 231 See "AC97 Quirk Option" section below.
14e1d357
DC		 232 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.
1da177e4
LT		 238 spdif_aclink - S/PDIF transfer over AC-link (default = 1)
239
b7fe4622 240 This module supports one card and autoprobe.
1da177e4 241
6243008b
TI		 242 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
a4efc230
TI		 247 The power-management is supported.
248
1da177e4
LT		 249 Module snd-atiixp-modem
250 -----------------------
251
252 Module for ATI IXP 150/200/250 AC97 modem controllers.
253
b7fe4622 254 This module supports one card and autoprobe.
1da177e4
LT		 255
256 Note: The default index value of this module is -2, i.e. the first
257 slot is excluded.
258
a4efc230
TI		 259 The power-management is supported.
260
1da177e4
LT		 261 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
6243008b 283 Note: Some ALSA mixer applications don't handle the SPDIF sample rate
1da177e4
LT		 284 control correctly. If you have problems regarding this, try
285 another ALSA compliant mixer (alsamixer works).
286
9e235323
TI		 287 Module snd-aw2
288 --------------
289
290 Module for Audiowerk2 sound card
291
292 This module supports multiple cards.
293
1da177e4
LT		 294 Module snd-azt2320
295 ------------------
296
297 Module for sound cards based on Aztech System AZT2320 ISA chip (PnP only).
298
0ef797c5 299 This module supports multiple cards, PnP and autoprobe.
1da177e4 300
a4efc230
TI		 301 The power-management is supported.
302
1da177e4
LT		 303 Module snd-azt3328
304 ------------------
305
306 Module for sound cards based on Aztech AZF3328 PCI chip.
307
308 joystick - Enable joystick (default off)
309
0ef797c5 310 This module supports multiple cards.
1da177e4
LT		 311
312 Module snd-bt87x
313 ----------------
314
315 Module for video cards based on Bt87x chips.
316
317 digital_rate - Override the default digital rate (Hz)
318 load_all - Load the driver even if the card model isn't known
319
0ef797c5 320 This module supports multiple cards.
1da177e4
LT		 321
322 Note: The default index value of this module is -2, i.e. the first
323 slot is excluded.
324
325 Module snd-ca0106
326 -----------------
327
328 Module for Creative Audigy LS and SB Live 24bit
329
0ef797c5 330 This module supports multiple cards.
1da177e4
LT		 331
332
333 Module snd-cmi8330
334 ------------------
335
336 Module for sound cards based on C-Media CMI8330 ISA chips.
337
64e0e2d9
RH		 338 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
339
340 with isapnp=0, the following options are available:
341
1da177e4
LT		 342 wssport - port # for CMI8330 chip (WSS)
343 wssirq - IRQ # for CMI8330 chip (WSS)
344 wssdma - first DMA # for CMI8330 chip (WSS)
345 sbport - port # for CMI8330 chip (SB16)
346 sbirq - IRQ # for CMI8330 chip (SB16)
347 sbdma8 - 8bit DMA # for CMI8330 chip (SB16)
348 sbdma16 - 16bit DMA # for CMI8330 chip (SB16)
349
0ef797c5 350 This module supports multiple cards and autoprobe.
1da177e4 351
a4efc230
TI		 352 The power-management is supported.
353
1da177e4
LT		 354 Module snd-cmipci
355 -----------------
356
45c41b48 357 Module for C-Media CMI8338/8738/8768/8770 PCI sound cards.
1da177e4 358
c78c950d 359 mpu_port - port address of MIDI interface (8338 only):
45c41b48 360 0x300,0x310,0x320,0x330 = legacy port,
cab5c4c9 361 0 = disable (default)
45c41b48
CL		 362 fm_port - port address of OPL-3 FM synthesizer (8x38 only):
363 0x388 = legacy port,
364 1 = integrated PCI port (default on 8738),
2f24d159 365 0 = disable
6243008b 366 soft_ac3 - Software-conversion of raw SPDIF packets (model 033 only)
1da177e4
LT		 367 (default = 1)
368 joystick_port - Joystick port address (0 = disable, 1 = auto-detect)
369
0ef797c5 370 This module supports autoprobe and multiple cards.
1da177e4 371
a4efc230
TI		 372 The power-management is supported.
373
1da177e4
LT		 374 Module snd-cs4231
375 -----------------
376
377 Module for sound cards based on CS4231 ISA chips.
378
379 port - port # for CS4231 chip
380 mpu_port - port # for MPU-401 UART (optional), -1 = disable
381 irq - IRQ # for CS4231 chip
382 mpu_irq - IRQ # for MPU-401 UART
383 dma1 - first DMA # for CS4231 chip
384 dma2 - second DMA # for CS4231 chip
385
0ef797c5 386 This module supports multiple cards. This module does not support autoprobe
1da177e4
LT		 387 thus main port must be specified!!! Other ports are optional.
388
389 The power-management is supported.
390
391 Module snd-cs4232
392 -----------------
393
394 Module for sound cards based on CS4232/CS4232A ISA chips.
395
64e0e2d9
RH		 396 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
397
398 with isapnp=0, the following options are available:
399
1da177e4
LT		 400 port - port # for CS4232 chip (PnP setup - 0x534)
401 cport - control port # for CS4232 chip (PnP setup - 0x120,0x210,0xf00)
402 mpu_port - port # for MPU-401 UART (PnP setup - 0x300), -1 = disable
403 fm_port - FM port # for CS4232 chip (PnP setup - 0x388), -1 = disable
404 irq - IRQ # for CS4232 chip (5,7,9,11,12,15)
405 mpu_irq - IRQ # for MPU-401 UART (9,11,12,15)
406 dma1 - first DMA # for CS4232 chip (0,1,3)
407 dma2 - second DMA # for Yamaha CS4232 chip (0,1,3), -1 = disable
1da177e4 408
0ef797c5 409 This module supports multiple cards. This module does not support autoprobe
64e0e2d9
RH		 410 (if ISA PnP is not used) thus main port must be specified!!! Other ports are
411 optional.
1da177e4
LT		 412
413 The power-management is supported.
414
415 Module snd-cs4236
416 -----------------
417
418 Module for sound cards based on CS4235/CS4236/CS4236B/CS4237B/
419 CS4238B/CS4239 ISA chips.
420
64e0e2d9
RH		 421 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
422
423 with isapnp=0, the following options are available:
424
1da177e4
LT		 425 port - port # for CS4236 chip (PnP setup - 0x534)
426 cport - control port # for CS4236 chip (PnP setup - 0x120,0x210,0xf00)
427 mpu_port - port # for MPU-401 UART (PnP setup - 0x300), -1 = disable
428 fm_port - FM port # for CS4236 chip (PnP setup - 0x388), -1 = disable
429 irq - IRQ # for CS4236 chip (5,7,9,11,12,15)
430 mpu_irq - IRQ # for MPU-401 UART (9,11,12,15)
431 dma1 - first DMA # for CS4236 chip (0,1,3)
432 dma2 - second DMA # for CS4236 chip (0,1,3), -1 = disable
1da177e4 433
0ef797c5 434 This module supports multiple cards. This module does not support autoprobe
1da177e4
LT		 435 (if ISA PnP is not used) thus main port and control port must be
436 specified!!! Other ports are optional.
437
438 The power-management is supported.
439
440 Module snd-cs4281
441 -----------------
442
443 Module for Cirrus Logic CS4281 soundchip.
444
445 dual_codec - Secondary codec ID (0 = disable, default)
446
0ef797c5 447 This module supports multiple cards.
1da177e4
LT		 448
449 The power-management is supported.
450
451 Module snd-cs46xx
452 -----------------
453
454 Module for PCI sound cards based on CS4610/CS4612/CS4614/CS4615/CS4622/
455 CS4624/CS4630/CS4280 PCI chips.
456
6243008b 457 external_amp - Force to enable external amplifier.
1da177e4
LT		 458 thinkpad - Force to enable Thinkpad's CLKRUN control.
459 mmap_valid - Support OSS mmap mode (default = 0).
460
0ef797c5 461 This module supports multiple cards and autoprobe.
1da177e4
LT		 462 Usually external amp and CLKRUN controls are detected automatically
463 from PCI sub vendor/device ids. If they don't work, give the options
464 above explicitly.
465
466 The power-management is supported.
621887ae
TI		 467
468 Module snd-cs5530
469 _________________
470
471 Module for Cyrix/NatSemi Geode 5530 chip.
472
3e873174
TI		 473 Module snd-cs5535audio
474 ----------------------
475
476 Module for multifunction CS5535 companion PCI device
477
c00bd74a 478 The power-management is supported.
3e873174 479
dd7b254d
GP		 480 Module snd-darla20
481 ------------------
482
483 Module for Echoaudio Darla20
484
485 This module supports multiple cards.
486 The driver requires the firmware loader support on kernel.
487
488 Module snd-darla24
489 ------------------
490
491 Module for Echoaudio Darla24
492
493 This module supports multiple cards.
494 The driver requires the firmware loader support on kernel.
495
1da177e4
LT		 496 Module snd-dt019x
497 -----------------
498
499 Module for Diamond Technologies DT-019X / Avance Logic ALS-007 (PnP
500 only)
501
0ef797c5 502 This module supports multiple cards. This module is enabled only with
1da177e4
LT		 503 ISA PnP support.
504
a4efc230
TI		 505 The power-management is supported.
506
1da177e4
LT		 507 Module snd-dummy
508 ----------------
509
510 Module for the dummy sound card. This "card" doesn't do any output
511 or input, but you may use this module for any application which
512 requires a sound card (like RealPlayer).
513
a4efc230
TI		 514 The power-management is supported.
515
dd7b254d
GP		 516 Module snd-echo3g
517 -----------------
518
519 Module for Echoaudio 3G cards (Gina3G/Layla3G)
520
521 This module supports multiple cards.
522 The driver requires the firmware loader support on kernel.
523
1da177e4
LT		 524 Module snd-emu10k1
525 ------------------
526
527 Module for EMU10K1/EMU10k2 based PCI sound cards.
528 * Sound Blaster Live!
529 * Sound Blaster PCI 512
530 * Emu APS (partially supported)
531 * Sound Blaster Audigy
532
533 extin - bitmap of available external inputs for FX8010 (see bellow)
534 extout - bitmap of available external outputs for FX8010 (see bellow)
535 seq_ports - allocated sequencer ports (4 by default)
536 max_synth_voices - limit of voices used for wavetable (64 by default)
537 max_buffer_size - specifies the maximum size of wavetable/pcm buffers
538 given in MB unit. Default value is 128.
539 enable_ir - enable IR
540
0ef797c5 541 This module supports multiple cards and autoprobe.
1da177e4
LT		 542
543 Input & Output configurations [extin/extout]
544 * Creative Card wo/Digital out [0x0003/0x1f03]
545 * Creative Card w/Digital out [0x0003/0x1f0f]
546 * Creative Card w/Digital CD in [0x000f/0x1f0f]
547 * Creative Card wo/Digital out + LiveDrive [0x3fc3/0x1fc3]
548 * Creative Card w/Digital out + LiveDrive [0x3fc3/0x1fcf]
549 * Creative Card w/Digital CD in + LiveDrive [0x3fcf/0x1fcf]
550 * Creative Card wo/Digital out + Digital I/O 2 [0x0fc3/0x1f0f]
551 * Creative Card w/Digital out + Digital I/O 2 [0x0fc3/0x1f0f]
552 * Creative Card w/Digital CD in + Digital I/O 2 [0x0fcf/0x1f0f]
553 * Creative Card 5.1/w Digital out + LiveDrive [0x3fc3/0x1fff]
554 * Creative Card 5.1 (c) 2003 [0x3fc3/0x7cff]
555 * Creative Card all ins and outs [0x3fff/0x7fff]
556
a4efc230
TI		 557 The power-management is supported.
558
1da177e4
LT		 559 Module snd-emu10k1x
560 -------------------
561
562 Module for Creative Emu10k1X (SB Live Dell OEM version)
563
0ef797c5 564 This module supports multiple cards.
1da177e4
LT		 565
566 Module snd-ens1370
567 ------------------
568
569 Module for Ensoniq AudioPCI ES1370 PCI sound cards.
570 * SoundBlaster PCI 64
571 * SoundBlaster PCI 128
572
573 joystick - Enable joystick (default off)
574
0ef797c5 575 This module supports multiple cards and autoprobe.
1da177e4 576
d6ec894b
TI		 577 The power-management is supported.
578
1da177e4
LT		 579 Module snd-ens1371
580 ------------------
581
582 Module for Ensoniq AudioPCI ES1371 PCI sound cards.
583 * SoundBlaster PCI 64
584 * SoundBlaster PCI 128
585 * SoundBlaster Vibra PCI
586
587 joystick_port - port # for joystick (0x200,0x208,0x210,0x218),
588 0 = disable (default), 1 = auto-detect
589
0ef797c5 590 This module supports multiple cards and autoprobe.
1da177e4 591
d6ec894b
TI		 592 The power-management is supported.
593
1da177e4
LT		 594 Module snd-es968
595 ----------------
596
597 Module for sound cards based on ESS ES968 chip (PnP only).
598
0ef797c5 599 This module supports multiple cards, PnP and autoprobe.
1da177e4 600
a4efc230
TI		 601 The power-management is supported.
602
1da177e4
LT		 603 Module snd-es1688
604 -----------------
605
606 Module for ESS AudioDrive ES-1688 and ES-688 sound cards.
607
608 port - port # for ES-1688 chip (0x220,0x240,0x260)
609 mpu_port - port # for MPU-401 port (0x300,0x310,0x320,0x330), -1 = disable (default)
610 irq - IRQ # for ES-1688 chip (5,7,9,10)
611 mpu_irq - IRQ # for MPU-401 port (5,7,9,10)
612 dma8 - DMA # for ES-1688 chip (0,1,3)
613
0ef797c5 614 This module supports multiple cards and autoprobe (without MPU-401 port).
1da177e4
LT		 615
616 Module snd-es18xx
617 -----------------
618
619 Module for ESS AudioDrive ES-18xx sound cards.
620
64e0e2d9
RH		 621 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
622
623 with isapnp=0, the following options are available:
624
1da177e4
LT		 625 port - port # for ES-18xx chip (0x220,0x240,0x260)
626 mpu_port - port # for MPU-401 port (0x300,0x310,0x320,0x330), -1 = disable (default)
627 fm_port - port # for FM (optional, not used)
628 irq - IRQ # for ES-18xx chip (5,7,9,10)
629 dma1 - first DMA # for ES-18xx chip (0,1,3)
630 dma2 - first DMA # for ES-18xx chip (0,1,3)
1da177e4 631
0ef797c5
CL		 632 This module supports multiple cards, ISA PnP and autoprobe (without MPU-401
633 port if native ISA PnP routines are not used).
1da177e4
LT		 634 When dma2 is equal with dma1, the driver works as half-duplex.
635
636 The power-management is supported.
637
638 Module snd-es1938
639 -----------------
640
641 Module for sound cards based on ESS Solo-1 (ES1938,ES1946) chips.
642
0ef797c5 643 This module supports multiple cards and autoprobe.
1da177e4 644
a4efc230
TI		 645 The power-management is supported.
646
1da177e4
LT		 647 Module snd-es1968
648 -----------------
649
650 Module for sound cards based on ESS Maestro-1/2/2E (ES1968/ES1978) chips.
651
652 total_bufsize - total buffer size in kB (1-4096kB)
653 pcm_substreams_p - playback channels (1-8, default=2)
654 pcm_substreams_c - capture channels (1-8, default=0)
655 clock - clock (0 = auto-detection)
656 use_pm - support the power-management (0 = off, 1 = on,
657 2 = auto (default))
658 enable_mpu - enable MPU401 (0 = off, 1 = on, 2 = auto (default))
659 joystick - enable joystick (default off)
660
0ef797c5 661 This module supports multiple cards and autoprobe.
1da177e4
LT		 662
663 The power-management is supported.
664
665 Module snd-fm801
666 ----------------
667
668 Module for ForteMedia FM801 based PCI sound cards.
669
670 tea575x_tuner - Enable TEA575x tuner
671 - 1 = MediaForte 256-PCS
672 - 2 = MediaForte 256-PCPR
673 - 3 = MediaForte 64-PCR
674 - High 16-bits are video (radio) device number + 1
675 - example: 0x10002 (MediaForte 256-PCPR, device 1)
676
0ef797c5 677 This module supports multiple cards and autoprobe.
1da177e4 678
a4efc230
TI		 679 The power-management is supported.
680
dd7b254d
GP		 681 Module snd-gina20
682 -----------------
683
684 Module for Echoaudio Gina20
685
686 This module supports multiple cards.
687 The driver requires the firmware loader support on kernel.
688
689 Module snd-gina24
690 -----------------
691
692 Module for Echoaudio Gina24
693
694 This module supports multiple cards.
695 The driver requires the firmware loader support on kernel.
696
1da177e4
LT		 697 Module snd-gusclassic
698 ---------------------
699
700 Module for Gravis UltraSound Classic sound card.
701
702 port - port # for GF1 chip (0x220,0x230,0x240,0x250,0x260)
703 irq - IRQ # for GF1 chip (3,5,9,11,12,15)
704 dma1 - DMA # for GF1 chip (1,3,5,6,7)
705 dma2 - DMA # for GF1 chip (1,3,5,6,7,-1=disable)
706 joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
707 voices - GF1 voices limit (14-32)
708 pcm_voices - reserved PCM voices
709
0ef797c5 710 This module supports multiple cards and autoprobe.
1da177e4
LT		 711
712 Module snd-gusextreme
713 ---------------------
714
715 Module for Gravis UltraSound Extreme (Synergy ViperMax) sound card.
716
717 port - port # for ES-1688 chip (0x220,0x230,0x240,0x250,0x260)
718 gf1_port - port # for GF1 chip (0x210,0x220,0x230,0x240,0x250,0x260,0x270)
719 mpu_port - port # for MPU-401 port (0x300,0x310,0x320,0x330), -1 = disable
720 irq - IRQ # for ES-1688 chip (5,7,9,10)
721 gf1_irq - IRQ # for GF1 chip (3,5,9,11,12,15)
722 mpu_irq - IRQ # for MPU-401 port (5,7,9,10)
723 dma8 - DMA # for ES-1688 chip (0,1,3)
724 dma1 - DMA # for GF1 chip (1,3,5,6,7)
725 joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
726 voices - GF1 voices limit (14-32)
727 pcm_voices - reserved PCM voices
728
0ef797c5 729 This module supports multiple cards and autoprobe (without MPU-401 port).
1da177e4
LT		 730
731 Module snd-gusmax
732 -----------------
733
734 Module for Gravis UltraSound MAX sound card.
735
736 port - port # for GF1 chip (0x220,0x230,0x240,0x250,0x260)
737 irq - IRQ # for GF1 chip (3,5,9,11,12,15)
738 dma1 - DMA # for GF1 chip (1,3,5,6,7)
739 dma2 - DMA # for GF1 chip (1,3,5,6,7,-1=disable)
740 joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
741 voices - GF1 voices limit (14-32)
742 pcm_voices - reserved PCM voices
743
0ef797c5 744 This module supports multiple cards and autoprobe.
1da177e4
LT		 745
746 Module snd-hda-intel
747 --------------------
748
6ef10905
AB		 749 Module for Intel HD Audio (ICH6, ICH6M, ESB2, ICH7, ICH8, ICH9, ICH10,
750 PCH, SCH),
751 ATI SB450, SB600, R600, RS600, RS690, RS780, RV610, RV620,
752 RV630, RV635, RV670, RV770,
9b87819b
TI		 753 VIA VT8251/VT8237A,
754 SIS966, ULI M5461
1da177e4 755
5aba4f8e 756 [Multiple options for each card instance]
1da177e4 757 model - force the model name
d2e1c973 758 position_fix - Fix DMA pointer (0 = auto, 1 = use LPIB, 2 = POSBUF)
95904743 759 probe_mask - Bitmask to probe codecs (default = -1, meaning all slots)
8c53b96f
TI		 760 bdl_pos_adj - Specifies the DMA IRQ timing delay in samples.
761 Passing -1 will make the driver to choose the appropriate
762 value based on the controller chip.
5aba4f8e
TI		 763
764 [Single (global) options]
27346166
TI		 765 single_cmd - Use single immediate commands to communicate with
766 codecs (for debugging only)
134a11f0 767 enable_msi - Enable Message Signaled Interrupt (MSI) (default = off)
dee1b66c 768 power_save - Automatic power-saving timtout (in second, 0 =
3723e2d2 769 disable)
dee1b66c
TI		 770 power_save_controller - Reset HD-audio controller in power-saving mode
771 (default = on)
1da177e4 772
5aba4f8e
TI		 773 This module supports multiple cards and autoprobe.
774
1da177e4
LT		 775 Each codec may have a model table for different configurations.
776 If your machine isn't listed there, the default (usually minimal)
777 configuration is set up. You can pass "model=<name>" option to
778 specify a certain model in such a case. There are different
779 models depending on the codec chip.
780
4e7c4d7b
TI		 781 See Documentation/sound/alsa/HD-Audio.txt for some details.
782
1da177e4
LT		 783 Model name Description
784 ---------- -----------
785 ALC880
786 3stack 3-jack in back and a headphone out
787 3stack-digout 3-jack in back, a HP out and a SPDIF out
788 5stack 5-jack in back, 2-jack in front
789 5stack-digout 5-jack in back, 2-jack in front, a SPDIF out
b6482d48
TI		 790 6stack 6-jack in back, 2-jack in front
791 6stack-digout 6-jack with a SPDIF out
1da177e4 792 w810 3-jack
dfc0ff62 793 z71v 3-jack (HP shared SPDIF)
4b146cb0
TI		 794 asus 3-jack (ASUS Mobo)
795 asus-w1v ASUS W1V
796 asus-dig ASUS with SPDIF out
797 asus-dig2 ASUS with SPDIF out (using GPIO2)
e9edcee0 798 uniwill 3-jack
2cf9f0fc 799 fujitsu Fujitsu Laptops (Pi1536)
e9edcee0 800 F1734 2-jack
ae6b813a 801 lg LG laptop (m1 express dual)
cd417d4f 802 lg-lw LG LW20/LW25 laptop
4b146cb0 803 tcl TCL S700
5a053d01 804 clevo Clevo laptops (m520G, m665n)
df99cd33 805 medion Medion Rim 2150
b6482d48
TI		 806 test for testing/debugging purpose, almost all controls can be
807 adjusted. Appearing only when compiled with
808 $CONFIG_SND_DEBUG=y
ed345f8f 809 auto auto-config reading BIOS (default)
1da177e4 810
21be3d16
TI		 811 ALC260
812 hp HP machines
4b146cb0 813 hp-3013 HP machines (3013-variant)
2922c9af 814 hp-dc7600 HP DC7600
21be3d16 815 fujitsu Fujitsu S7020
ed345f8f 816 acer Acer TravelMate
940d2448
TI		 817 will Will laptops (PB V7900)
818 replacer Replacer 672V
ed345f8f 819 basic fixed pin assignment (old default model)
86c53bd2
JW		 820 test for testing/debugging purpose, almost all controls can
821 adjusted. Appearing only when compiled with
822 $CONFIG_SND_DEBUG=y
ed345f8f
TI		 823 auto auto-config reading BIOS (default)
824
825 ALC262
826 fujitsu Fujitsu Laptop
6d177ba7 827 hp-bpc HP xw4400/6400/8400/9400 laptops
cd7509a4 828 hp-bpc-d7000 HP BPC D7000
61dc35de 829 hp-tc-t5735 HP Thin Client T5735
8c427226 830 hp-rp5700 HP RP5700
304dcaac 831 benq Benq ED8
940d2448 832 benq-t31 Benq T31
d1f67547 833 hippo Hippo (ATI) with jack detection, Sony UX-90s
ccc656ce 834 hippo_1 Hippo (Benq) with jack detection
940d2448 835 sony-assamd Sony ASSAMD
2922c9af 836 toshiba-s06 Toshiba S06
9f99a638 837 toshiba-rx1 Toshiba RX1
f651b50b 838 ultra Samsung Q1 Ultra Vista model
cd97f47d 839 lenovo-3000 Lenovo 3000 y410
2922c9af 840 nec NEC Versa S9100
ed345f8f
TI		 841 basic fixed pin assignment w/o SPDIF
842 auto auto-config reading BIOS (default)
843
eb5a6621
HRK		 844 ALC267/268
845 quanta-il1 Quanta IL1 mini-notebook
a361d84b 846 3stack 3-stack model
983f8ae4 847 toshiba Toshiba A205
d273809e 848 acer Acer laptops
c238b4f4 849 acer-dmic Acer laptops with digital-mic
2922c9af 850 acer-aspire Acer Aspire One
3866f0b0 851 dell Dell OEM laptops (Vostro 1200)
f12462c5 852 zepto Zepto laptops
86c53bd2
JW		 853 test for testing/debugging purpose, almost all controls can
854 adjusted. Appearing only when compiled with
855 $CONFIG_SND_DEBUG=y
a361d84b
KY		 856 auto auto-config reading BIOS (default)
857
cd97f47d
TI		 858 ALC269
859 basic Basic preset
2922c9af
TI		 860 quanta Quanta FL1
861 eeepc-p703 ASUS Eeepc P703 P900A
862 eeepc-p901 ASUS Eeepc P901 S101
26f5df26
TI		 863 fujitsu FSC Amilo
864 auto auto-config reading BIOS (default)
cd97f47d 865
6dda9f4a 866 ALC662/663
940d2448
TI		 867 3stack-dig 3-stack (2-channel) with SPDIF
868 3stack-6ch 3-stack (6-channel)
869 3stack-6ch-dig 3-stack (6-channel) with SPDIF
870 6stack-dig 6-stack with SPDIF
871 lenovo-101e Lenovo laptop
8c427226
KY		 872 eeepc-p701 ASUS Eeepc P701
873 eeepc-ep20 ASUS Eeepc EP20
2922c9af 874 ecs ECS/Foxconn mobo
6dda9f4a
KY		 875 m51va ASUS M51VA
876 g71v ASUS G71V
877 h13 ASUS H13
878 g50v ASUS G50V
2922c9af
TI		 879 asus-mode1 ASUS
880 asus-mode2 ASUS
881 asus-mode3 ASUS
882 asus-mode4 ASUS
883 asus-mode5 ASUS
884 asus-mode6 ASUS
940d2448
TI		 885 auto auto-config reading BIOS (default)
886
9c7f852e 887 ALC882/885
ed345f8f 888 3stack-dig 3-jack with SPDIF I/O
518f6a61 889 6stack-dig 6-jack digital with SPDIF I/O
4b146cb0 890 arima Arima W820Di1
0438a00e
TI		 891 targa Targa T8, MSI-1049 T8
892 asus-a7j ASUS A7J
893 asus-a7m ASUS A7M
518f6a61 894 macpro MacPro support
87350ad0 895 mbp3 Macbook Pro rev3
c54728d8 896 imac24 iMac 24'' with jack detection
bdd148a3 897 w2jc ASUS W2JC
ed345f8f
TI		 898 auto auto-config reading BIOS (default)
899
9c7f852e
TI		 900 ALC883/888
901 3stack-dig 3-jack with SPDIF I/O
902 6stack-dig 6-jack digital with SPDIF I/O
4b146cb0
TI		 903 3stack-6ch 3-jack 6-channel
904 3stack-6ch-dig 3-jack 6-channel with SPDIF I/O
905 6stack-dig-demo 6-jack digital for Intel demo board
bab282b9 906 acer Acer laptops (Travelmate 3012WTMi, Aspire 5600, etc)
983f8ae4 907 acer-aspire Acer Aspire 9810
5b2d1eca 908 acer-aspire-4930g Acer Aspire 4930G
c07584c8 909 medion Medion Laptops
940d2448 910 medion-md2 Medion MD2
ccc656ce
KY		 911 targa-dig Targa/MSI
912 targa-2ch-dig Targs/MSI with 2-channel
b373bdeb 913 laptop-eapd 3-jack with SPDIF I/O and EAPD (Clevo M540JE, M550JE)
940d2448
TI		 914 lenovo-101e Lenovo 101E
915 lenovo-nb0763 Lenovo NB0763
916 lenovo-ms7195-dig Lenovo MS7195
2922c9af 917 lenovo-sky Lenovo Sky
189609ae 918 haier-w66 Haier W66
4723c022 919 3stack-hp HP machines with 3stack (Lucknow, Samba boards)
5795b9e6 920 6stack-dell Dell machines with 6stack (Inspiron 530)
a8848bd6 921 mitac Mitac 8252D
0c4cc443 922 clevo-m720 Clevo M720 laptop series
cd97f47d 923 fujitsu-pi2515 Fujitsu AMILO Pi2515
ef8ef5fb 924 fujitsu-xa3530 Fujitsu AMILO XA3530
2922c9af 925 3stack-6ch-intel Intel DG33* boards
9c7f852e
TI		 926 auto auto-config reading BIOS (default)
927
928 ALC861/660
ed345f8f
TI		 929 3stack 3-jack
930 3stack-dig 3-jack with SPDIF I/O
931 6stack-dig 6-jack with SPDIF I/O
4b146cb0 932 3stack-660 3-jack (for ALC660)
22309c3e 933 uniwill-m31 Uniwill M31 laptop
a53d1aec 934 toshiba Toshiba laptop support
7cdbff94 935 asus Asus laptop support
56bb0cab 936 asus-laptop ASUS F2/F3 laptops
ed345f8f 937 auto auto-config reading BIOS (default)
21be3d16 938
f32610ed
JS		 939 ALC861VD/660VD
940 3stack 3-jack
941 3stack-dig 3-jack with SPDIF OUT
942 6stack-dig 6-jack with SPDIF OUT
943 3stack-660 3-jack (for ALC660VD)
6963f84c 944 3stack-660-digout 3-jack with SPDIF OUT (for ALC660VD)
bdd148a3 945 lenovo Lenovo 3000 C200
940d2448 946 dallas Dallas laptops
983f8ae4 947 hp HP TX1000
13c94744 948 asus-v1s ASUS V1Sn
f32610ed
JS		 949 auto auto-config reading BIOS (default)
950
1da177e4
LT		 951 CMI9880
952 minimal 3-jack in back
953 min_fp 3-jack in back, 2-jack in front
954 full 6-jack in back, 2-jack in front
955 full_dig 6-jack in back, 2-jack in front, SPDIF I/O
956 allout 5-jack in back, 2-jack in front, SPDIF out
e9edcee0 957 auto auto-config reading BIOS (default)
1da177e4 958
9e44c6e4 959 AD1882 / AD1882A
0ac8551e
TI		 960 3stack 3-stack mode (default)
961 6stack 6-stack mode
962
c5059259
TI		 963 AD1884A / AD1883 / AD1984A / AD1984B
964 desktop 3-stack desktop (default)
965 laptop laptop with HP jack sensing
b40b04ad 966 mobile mobile devices with HP jack sensing
f081374b 967 thinkpad Lenovo Thinkpad X300
c5059259 968
2bac647c
TI		 969 AD1884
970 N/A
971
9230d214
TI		 972 AD1981
973 basic 3-jack (default)
974 hp HP nx6320
01686c5f 975 thinkpad Lenovo Thinkpad T60/X60/Z60
18768991 976 toshiba Toshiba U205
9230d214 977
2bac647c
TI		 978 AD1983
979 N/A
980
981 AD1984
982 basic default configuration
983 thinkpad Lenovo Thinkpad T61/X61
0aaa22e5 984 dell Dell T3400
2bac647c 985
9230d214
TI		 986 AD1986A
987 6stack 6-jack, separate surrounds (default)
988 3stack 3-stack, shared surrounds
989 laptop 2-channel only (FSC V2060, Samsung M50)
1725b82a 990 laptop-eapd 2-channel with EAPD (ASUS A6J)
8ab78c74 991 laptop-automute 2-channel with EAPD and HP-automute (Lenovo N100)
f36090fe 992 ultra 2-channel with EAPD (Samsung Ultra tablet PC)
1725b82a 993 samsung 2-channel with EAPD (Samsung R65)
9230d214 994
3adb8abc 995 AD1988/AD1988B/AD1989A/AD1989B
9230d214
TI		 996 6stack 6-jack
997 6stack-dig ditto with SPDIF
998 3stack 3-jack
999 3stack-dig ditto with SPDIF
1000 laptop 3-jack with hp-jack automute
1001 laptop-dig ditto with SPDIF
99ccc560 1002 auto auto-config reading BIOS (default)
c9b443d4
TD		 1003
1004 Conexant 5045
15908c36
MB		 1005 laptop-hpsense Laptop with HP sense (old model laptop)
1006 laptop-micsense Laptop with Mic sense (old model fujitsu)
1007 laptop-hpmicsense Laptop with HP and Mic senses
5218c892 1008 benq Benq R55E
c9b443d4
TD		 1009 test for testing/debugging purpose, almost all controls
1010 can be adjusted. Appearing only when compiled with
1011 $CONFIG_SND_DEBUG=y
1012
1013 Conexant 5047
1014 laptop Basic Laptop config
1015 laptop-hp Laptop config for some HP models (subdevice 30A5)
1016 laptop-eapd Laptop config with EAPD support
1017 test for testing/debugging purpose, almost all controls
1018 can be adjusted. Appearing only when compiled with
1019 $CONFIG_SND_DEBUG=y
9230d214 1020
461e2c78
TI		 1021 Conexant 5051
1022 laptop Basic Laptop config (default)
1023 hp HP Spartan laptop
1024
dfe495d0 1025 STAC9200
3fc24d85 1026 ref Reference board
966a4d59
TI		 1027 dell-d21 Dell (unknown)
1028 dell-d22 Dell (unknown)
1029 dell-d23 Dell (unknown)
dfe495d0
TI		 1030 dell-m21 Dell Inspiron 630m, Dell Inspiron 640m
1031 dell-m22 Dell Latitude D620, Dell Latitude D820
1032 dell-m23 Dell XPS M1710, Dell Precision M90
1033 dell-m24 Dell Latitude 120L
1034 dell-m25 Dell Inspiron E1505n
1035 dell-m26 Dell Inspiron 1501
1036 dell-m27 Dell Inspiron E1705/9400
1194b5b7 1037 gateway Gateway laptops with EAPD control
117f257d 1038 panasonic Panasonic CF-74
dfe495d0
TI		 1039
1040 STAC9205/9254
1041 ref Reference board
1042 dell-m42 Dell (unknown)
ae0a8ed8
TD		 1043 dell-m43 Dell Precision
1044 dell-m44 Dell Inspiron
3fc24d85
TI		 1045
1046 STAC9220/9221
93ed1503
TD		 1047 ref Reference board
1048 3stack D945 3stack
1049 5stack D945 5stack + SPDIF
5d5d3bc3
IZ		 1050 intel-mac-v1 Intel Mac Type 1
1051 intel-mac-v2 Intel Mac Type 2
1052 intel-mac-v3 Intel Mac Type 3
1053 intel-mac-v4 Intel Mac Type 4
1054 intel-mac-v5 Intel Mac Type 5
536319af 1055 intel-mac-auto Intel Mac (detect type according to subsystem id)
5d5d3bc3
IZ		 1056 macmini Intel Mac Mini (equivalent with type 3)
1057 macbook Intel Mac Book (eq. type 5)
1058 macbook-pro-v1 Intel Mac Book Pro 1st generation (eq. type 3)
1059 macbook-pro Intel Mac Book Pro 2nd generation (eq. type 3)
1060 imac-intel Intel iMac (eq. type 2)
1061 imac-intel-20 Intel iMac (newer version) (eq. type 3)
dfe495d0
TI		 1062 dell-d81 Dell (unknown)
1063 dell-d82 Dell (unknown)
1064 dell-m81 Dell (unknown)
1065 dell-m82 Dell XPS M1210
93ed1503 1066
8e21c34c
TD		 1067 STAC9202/9250/9251
1068 ref Reference board, base config
1069 m2-2 Some Gateway MX series laptops
1070 m6 Some Gateway NX series laptops
2c11f955 1071 pa6 Gateway NX860 series
8e21c34c 1072
93ed1503
TD		 1073 STAC9227/9228/9229/927x
1074 ref Reference board
e28d8322 1075 ref-no-jd Reference board without HP/Mic jack detection
93ed1503
TD		 1076 3stack D965 3stack
1077 5stack D965 5stack + SPDIF
dfe495d0 1078 dell-3stack Dell Dimension E520
88d18ea2
TI		 1079 dell-bios Fixes with Dell BIOS setup
1080
1081 STAC92HD71B*
1082 ref Reference board
1083 dell-m4-1 Dell desktops
1084 dell-m4-2 Dell desktops
3a7abfd2 1085 dell-m4-3 Dell desktops
88d18ea2
TI		 1086
1087 STAC92HD73*
1088 ref Reference board
9e43f0de 1089 no-jd BIOS setup but without jack-detection
661cd8fb
TI		 1090 dell-m6-amic Dell desktops/laptops with analog mics
1091 dell-m6-dmic Dell desktops/laptops with digital mics
1092 dell-m6 Dell desktops/laptops with both type of mics
93ed1503 1093
6d859065
GM		 1094 STAC9872
1095 vaio Setup for VAIO FE550G/SZ110
1096 vaio-ar Setup for VAIO AR
db064e50 1097
6d7b1d7d
TI		 1098 The model name "genric" is treated as a special case. When this
1099 model is given, the driver uses the generic codec parser without
1100 "codec-patch". It's sometimes good for testing and debugging.
1101
6243008b 1102 If the default configuration doesn't work and one of the above
30bc4481
TI		 1103 matches with your device, report it together with alsa-info.sh
1104 output (with --no-upload option) to kernel bugzilla or alsa-devel
6243008b
TI		 1105 ML (see the section "Links and Addresses").
1106
3723e2d2
TI		 1107 power_save and power_save_controller options are for power-saving
1108 mode. See powersave.txt for details.
dee1b66c 1109
c74db86b
TI		 1110 Note 2: If you get click noises on output, try the module option
1111 position_fix=1 or 2. position_fix=1 will use the SD_LPIB
1112 register value without FIFO size correction as the current
1113 DMA pointer. position_fix=2 will make the driver to use
1114 the position buffer instead of reading SD_LPIB register.
90f31e38 1115 (Usually SD_LPIB register is more accurate than the
c74db86b
TI		 1116 position buffer.)
1117
27346166
TI		 1118 NB: If you get many "azx_get_response timeout" messages at
1119 loading, it's likely a problem of interrupts (e.g. ACPI irq
1120 routing). Try to boot with options like "pci=noacpi". Also, you
1121 can try "single_cmd=1" module option. This will switch the
1122 communication method between HDA controller and codecs to the
1123 single immediate commands instead of CORB/RIRB. Basically, the
1124 single command mode is provided only for BIOS, and you won't get
1125 unsolicited events, too. But, at least, this works independently
1126 from the irq. Remember this is a last resort, and should be
1127 avoided as much as possible...
1128
95904743
TI		 1129 MORE NOTES ON "azx_get_response timeout" PROBLEMS:
1130 On some hardwares, you may need to add a proper probe_mask option
1131 to avoid the "azx_get_response timeout" problem above, instead.
1132 This occurs when the access to non-existing or non-working codec slot
1133 (likely a modem one) causes a stall of the communication via HD-audio
1134 bus. You can see which codec slots are probed by enabling
62cf872a 1135 CONFIG_SND_DEBUG_VERBOSE, or simply from the file name of the codec
95904743
TI		 1136 proc files. Then limit the slots to probe by probe_mask option.
1137 For example, probe_mask=1 means to probe only the first slot, and
1138 probe_mask=4 means only the third slot.
1139
a4efc230
TI		 1140 The power-management is supported.
1141
1da177e4
LT		 1142 Module snd-hdsp
1143 ---------------
1144
1145 Module for RME Hammerfall DSP audio interface(s)
1146
0ef797c5 1147 This module supports multiple cards.
1da177e4
LT		 1148
1149 Note: The firmware data can be automatically loaded via hotplug
1150 when CONFIG_FW_LOADER is set. Otherwise, you need to load
1151 the firmware via hdsploader utility included in alsa-tools
1152 package.
1153 The firmware data is found in alsa-firmware package.
1154
1155 Note: snd-page-alloc module does the job which snd-hammerfall-mem
1156 module did formerly. It will allocate the buffers in advance
1157 when any HDSP cards are found. To make the buffer
1158 allocation sure, load snd-page-alloc module in the early
b6a96915
TI		 1159 stage of boot sequence. See "Early Buffer Allocation"
1160 section.
1da177e4 1161
5470440a
TI		 1162 Module snd-hdspm
1163 ----------------
1164
1165 Module for RME HDSP MADI board.
1166
1167 precise_ptr - Enable precise pointer, or disable.
1168 line_outs_monitor - Send playback streams to analog outs by default.
1169 enable_monitor - Enable Analog Out on Channel 63/64 by default.
1170
1171 See hdspm.txt for details.
1172
c626026d
CL		 1173 Module snd-hifier
1174 -----------------
1175
1176 Module for the MediaTek/TempoTec HiFier Fantasia sound card.
1177
1178 This module supports autoprobe and multiple cards.
1179
1da177e4
LT		 1180 Module snd-ice1712
1181 ------------------
1182
1183 Module for Envy24 (ICE1712) based PCI sound cards.
1184 * MidiMan M Audio Delta 1010
1185 * MidiMan M Audio Delta 1010LT
1186 * MidiMan M Audio Delta DiO 2496
1187 * MidiMan M Audio Delta 66
1188 * MidiMan M Audio Delta 44
1189 * MidiMan M Audio Delta 410
1190 * MidiMan M Audio Audiophile 2496
1191 * TerraTec EWS 88MT
1192 * TerraTec EWS 88D
1193 * TerraTec EWX 24/96
1194 * TerraTec DMX 6Fire
c9bce91f 1195 * TerraTec Phase 88
1da177e4
LT		 1196 * Hoontech SoundTrack DSP 24
1197 * Hoontech SoundTrack DSP 24 Value
1198 * Hoontech SoundTrack DSP 24 Media 7.1
c9bce91f 1199 * Event Electronics, EZ8
1da177e4 1200 * Digigram VX442
c9bce91f 1201 * Lionstracs, Mediastaton
6ef10905 1202 * Terrasoniq TS 88
1da177e4
LT		 1203
1204 model - Use the given board model, one of the following:
1205 delta1010, dio2496, delta66, delta44, audiophile, delta410,
1206 delta1010lt, vx442, ewx2496, ews88mt, ews88mt_new, ews88d,
c9bce91f
TI		 1207 dmx6fire, dsp24, dsp24_value, dsp24_71, ez8,
1208 phase88, mediastation
1da177e4 1209 omni - Omni I/O support for MidiMan M-Audio Delta44/66
fa00e7e1 1210 cs8427_timeout - reset timeout for the CS8427 chip (S/PDIF transceiver)
1da177e4
LT		 1211 in msec resolution, default value is 500 (0.5 sec)
1212
0ef797c5 1213 This module supports multiple cards and autoprobe. Note: The consumer part
1da177e4
LT		 1214 is not used with all Envy24 based cards (for example in the MidiMan Delta
1215 serie).
1216
c9bce91f
TI		 1217 Note: The supported board is detected by reading EEPROM or PCI
1218 SSID (if EEPROM isn't available). You can override the
1219 model by passing "model" module option in case that the
1220 driver isn't configured properly or you want to try another
1221 type for testing.
1222
1da177e4
LT		 1223 Module snd-ice1724
1224 ------------------
1225
c9bce91f 1226 Module for Envy24HT (VT/ICE1724), Envy24PT (VT1720) based PCI sound cards.
7a6c8ff1 1227 * MidiMan M Audio Revolution 5.1
1da177e4 1228 * MidiMan M Audio Revolution 7.1
56255060 1229 * MidiMan M Audio Audiophile 192
1da177e4 1230 * AMP Ltd AUDIO2000
c9bce91f
TI		 1231 * TerraTec Aureon 5.1 Sky
1232 * TerraTec Aureon 7.1 Space
1233 * TerraTec Aureon 7.1 Universe
1234 * TerraTec Phase 22
1235 * TerraTec Phase 28
1236 * AudioTrak Prodigy 7.1
6ef10905
AB		 1237 * AudioTrak Prodigy 7.1 LT
1238 * AudioTrak Prodigy 7.1 XT
1239 * AudioTrak Prodigy 7.1 HIFI
1240 * AudioTrak Prodigy 7.1 HD2
c9bce91f
TI		 1241 * AudioTrak Prodigy 192
1242 * Pontis MS300
1243 * Albatron K8X800 Pro II
1244 * Chaintech ZNF3-150
1245 * Chaintech ZNF3-250
1246 * Chaintech 9CJS
8cfbbac6 1247 * Chaintech AV-710
c9bce91f 1248 * Shuttle SN25P
f31639b8
SO		 1249 * Onkyo SE-90PCI
1250 * Onkyo SE-200PCI
6ef10905
AB		 1251 * ESI Juli@
1252 * Hercules Fortissimo IV
1253 * EGO-SYS WaveTerminal 192M
1da177e4
LT		 1254
1255 model - Use the given board model, one of the following:
7a6c8ff1 1256 revo51, revo71, amp2000, prodigy71, prodigy71lt,
6ef10905
AB		 1257 prodigy71xt, prodigy71hifi, prodigyhd2, prodigy192,
1258 juli, aureon51, aureon71, universe, ap192, k8x800,
1259 phase22, phase28, ms300, av710, se200pci, se90pci,
1260 fortissimo4, sn25p, WT192M
1da177e4 1261
0ef797c5 1262 This module supports multiple cards and autoprobe.
1da177e4 1263
c9bce91f
TI		 1264 Note: The supported board is detected by reading EEPROM or PCI
1265 SSID (if EEPROM isn't available). You can override the
1266 model by passing "model" module option in case that the
1267 driver isn't configured properly or you want to try another
1268 type for testing.
1269
dd7b254d
GP		 1270 Module snd-indigo
1271 -----------------
1272
1273 Module for Echoaudio Indigo
1274
1275 This module supports multiple cards.
1276 The driver requires the firmware loader support on kernel.
1277
1278 Module snd-indigodj
1279 -------------------
1280
1281 Module for Echoaudio Indigo DJ
1282
1283 This module supports multiple cards.
1284 The driver requires the firmware loader support on kernel.
1285
1286 Module snd-indigoio
1287 -------------------
1288
1289 Module for Echoaudio Indigo IO
1290
1291 This module supports multiple cards.
1292 The driver requires the firmware loader support on kernel.
1293
1da177e4
LT		 1294 Module snd-intel8x0
1295 -------------------
1296
1297 Module for AC'97 motherboards from Intel and compatibles.
1298 * Intel i810/810E, i815, i820, i830, i84x, MX440
6ef10905 1299 ICH5, ICH6, ICH7, 6300ESB, ESB2
1da177e4 1300 * SiS 7012 (SiS 735)
89ac9c25
TI		 1301 * NVidia NForce, NForce2, NForce3, MCP04, CK804
1302 CK8, CK8S, MCP501
1da177e4
LT		 1303 * AMD AMD768, AMD8111
1304 * ALi m5455
1305
1306 ac97_clock - AC'97 codec clock base (0 = auto-detect)
1307 ac97_quirk - AC'97 workaround for strange hardware
6243008b 1308 See "AC97 Quirk Option" section below.
1da177e4 1309 buggy_irq - Enable workaround for buggy interrupts on some
a06147d2
TI		 1310 motherboards (default yes on nForce chips,
1311 otherwise off)
1312 buggy_semaphore - Enable workaround for hardwares with buggy
1313 semaphores (e.g. on some ASUS laptops)
1314 (default off)
6c5cfd9d
TI		 1315 spdif_aclink - Use S/PDIF over AC-link instead of direct connection
1316 from the controller chip
1317 (0 = off, 1 = on, -1 = default)
1da177e4 1318
b7fe4622 1319 This module supports one chip and autoprobe.
1da177e4
LT		 1320
1321 Note: the latest driver supports auto-detection of chip clock.
1322 if you still encounter too fast playback, specify the clock
1323 explicitly via the module option "ac97_clock=41194".
1324
1325 Joystick/MIDI ports are not supported by this driver. If your
1326 motherboard has these devices, use the ns558 or snd-mpu401
1327 modules, respectively.
1328
1da177e4
LT		 1329 The power-management is supported.
1330
1331 Module snd-intel8x0m
1332 --------------------
1333
1334 Module for Intel ICH (i8x0) chipset MC97 modems.
89ac9c25
TI		 1335 * Intel i810/810E, i815, i820, i830, i84x, MX440
1336 ICH5, ICH6, ICH7
1337 * SiS 7013 (SiS 735)
1338 * NVidia NForce, NForce2, NForce2s, NForce3
1339 * AMD AMD8111
1340 * ALi m5455
1da177e4
LT		 1341
1342 ac97_clock - AC'97 codec clock base (0 = auto-detect)
1343
b7fe4622 1344 This module supports one card and autoprobe.
1da177e4
LT		 1345
1346 Note: The default index value of this module is -2, i.e. the first
1347 slot is excluded.
1348
a4efc230
TI		 1349 The power-management is supported.
1350
1da177e4
LT		 1351 Module snd-interwave
1352 --------------------
1353
1354 Module for Gravis UltraSound PnP, Dynasonic 3-D/Pro, STB Sound Rage 32
1355 and other sound cards based on AMD InterWave (tm) chip.
1356
1da177e4
LT		 1357 joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
1358 midi - 1 = MIDI UART enable, 0 = MIDI UART disable (default)
1359 pcm_voices - reserved PCM voices for the synthesizer (default 2)
1360 effect - 1 = InterWave effects enable (default 0);
1361 requires 8 voices
64e0e2d9
RH		 1362 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1363
1364 with isapnp=0, the following options are available:
1365
1366 port - port # for InterWave chip (0x210,0x220,0x230,0x240,0x250,0x260)
1367 irq - IRQ # for InterWave chip (3,5,9,11,12,15)
1368 dma1 - DMA # for InterWave chip (0,1,3,5,6,7)
1369 dma2 - DMA # for InterWave chip (0,1,3,5,6,7,-1=disable)
1da177e4 1370
0ef797c5 1371 This module supports multiple cards, autoprobe and ISA PnP.
1da177e4
LT		 1372
1373 Module snd-interwave-stb
1374 ------------------------
1375
1376 Module for UltraSound 32-Pro (sound card from STB used by Compaq)
1377 and other sound cards based on AMD InterWave (tm) chip with TEA6330T
1378 circuit for extended control of bass, treble and master volume.
1379
1da177e4
LT		 1380 joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
1381 midi - 1 = MIDI UART enable, 0 = MIDI UART disable (default)
1382 pcm_voices - reserved PCM voices for the synthesizer (default 2)
1383 effect - 1 = InterWave effects enable (default 0);
1384 requires 8 voices
64e0e2d9
RH		 1385 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1386
1387 with isapnp=0, the following options are available:
1388
1389 port - port # for InterWave chip (0x210,0x220,0x230,0x240,0x250,0x260)
1390 port_tc - tone control (i2c bus) port # for TEA6330T chip (0x350,0x360,0x370,0x380)
1391 irq - IRQ # for InterWave chip (3,5,9,11,12,15)
1392 dma1 - DMA # for InterWave chip (0,1,3,5,6,7)
1393 dma2 - DMA # for InterWave chip (0,1,3,5,6,7,-1=disable)
1da177e4 1394
0ef797c5 1395 This module supports multiple cards, autoprobe and ISA PnP.
1da177e4
LT		 1396
1397 Module snd-korg1212
1398 -------------------
1399
1400 Module for Korg 1212 IO PCI card
1401
0ef797c5 1402 This module supports multiple cards.
1da177e4 1403
dd7b254d
GP		 1404 Module snd-layla20
1405 ------------------
1406
1407 Module for Echoaudio Layla20
1408
1409 This module supports multiple cards.
1410 The driver requires the firmware loader support on kernel.
1411
1412 Module snd-layla24
1413 ------------------
1414
1415 Module for Echoaudio Layla24
1416
1417 This module supports multiple cards.
1418 The driver requires the firmware loader support on kernel.
1419
1da177e4
LT		 1420 Module snd-maestro3
1421 -------------------
1422
1423 Module for Allegro/Maestro3 chips
1424
1425 external_amp - enable external amp (enabled by default)
1426 amp_gpio - GPIO pin number for external amp (0-15) or
1427 -1 for default pin (8 for allegro, 1 for
1428 others)
1429
0ef797c5 1430 This module supports autoprobe and multiple chips.
1da177e4
LT		 1431
1432 Note: the binding of amplifier is dependent on hardware.
1433 If there is no sound even though all channels are unmuted, try to
1434 specify other gpio connection via amp_gpio option.
1435 For example, a Panasonic notebook might need "amp_gpio=0x0d"
1436 option.
1437
1438 The power-management is supported.
1439
dd7b254d
GP		 1440 Module snd-mia
1441 ---------------
1442
1443 Module for Echoaudio Mia
1444
1445 This module supports multiple cards.
1446 The driver requires the firmware loader support on kernel.
1447
1841f613
ML		 1448 Module snd-miro
1449 ---------------
1450
1451 Module for Miro soundcards: miroSOUND PCM 1 pro,
1452 miroSOUND PCM 12,
1453 miroSOUND PCM 20 Radio.
1454
1455 port - Port # (0x530,0x604,0xe80,0xf40)
1456 irq - IRQ # (5,7,9,10,11)
1457 dma1 - 1st dma # (0,1,3)
1458 dma2 - 2nd dma # (0,1)
1459 mpu_port - MPU-401 port # (0x300,0x310,0x320,0x330)
1460 mpu_irq - MPU-401 irq # (5,7,9,10)
1461 fm_port - FM Port # (0x388)
1462 wss - enable WSS mode
1463 ide - enable onboard ide support
1464
1da177e4
LT		 1465 Module snd-mixart
1466 -----------------
1467
1468 Module for Digigram miXart8 sound cards.
1469
0ef797c5 1470 This module supports multiple cards.
1da177e4
LT		 1471 Note: One miXart8 board will be represented as 4 alsa cards.
1472 See MIXART.txt for details.
1473
1474 When the driver is compiled as a module and the hotplug firmware
1475 is supported, the firmware data is loaded via hotplug automatically.
1476 Install the necessary firmware files in alsa-firmware package.
1477 When no hotplug fw loader is available, you need to load the
1478 firmware via mixartloader utility in alsa-tools package.
1479
dd7b254d
GP		 1480 Module snd-mona
1481 ---------------
1482
1483 Module for Echoaudio Mona
1484
1485 This module supports multiple cards.
1486 The driver requires the firmware loader support on kernel.
1487
1da177e4
LT		 1488 Module snd-mpu401
1489 -----------------
1490
1491 Module for MPU-401 UART devices.
1492
1493 port - port number or -1 (disable)
1494 irq - IRQ number or -1 (disable)
1495 pnp - PnP detection - 0 = disable, 1 = enable (default)
1496
0ef797c5 1497 This module supports multiple devices and PnP.
1da177e4
LT		 1498
1499 Module snd-mtpav
1500 ----------------
1501
1502 Module for MOTU MidiTimePiece AV multiport MIDI (on the parallel
1503 port).
1504
1505 port - I/O port # for MTPAV (0x378,0x278, default=0x378)
1506 irq - IRQ # for MTPAV (7,5, default=7)
1507 hwports - number of supported hardware ports, default=8.
1508
1509 Module supports only 1 card. This module has no enable option.
1510
68ab801e
MK		 1511 Module snd-mts64
1512 ----------------
1513
1514 Module for Ego Systems (ESI) Miditerminal 4140
1515
1516 This module supports multiple devices.
1517 Requires parport (CONFIG_PARPORT).
1518
1da177e4
LT		 1519 Module snd-nm256
1520 ----------------
1521
1522 Module for NeoMagic NM256AV/ZX chips
1523
1524 playback_bufsize - max playback frame size in kB (4-128kB)
1525 capture_bufsize - max capture frame size in kB (4-128kB)
1526 force_ac97 - 0 or 1 (disabled by default)
1527 buffer_top - specify buffer top address
1528 use_cache - 0 or 1 (disabled by default)
1529 vaio_hack - alias buffer_top=0x25a800
1530 reset_workaround - enable AC97 RESET workaround for some laptops
d1f38cf9
TI		 1531 reset_workaround2 - enable extended AC97 RESET workaround for some
1532 other laptops
1da177e4 1533
8a3fb4d0 1534 This module supports one chip and autoprobe.
1da177e4
LT		 1535
1536 The power-management is supported.
1537
1538 Note: on some notebooks the buffer address cannot be detected
1539 automatically, or causes hang-up during initialization.
fff9289b
ML		 1540 In such a case, specify the buffer top address explicitly via
1541 the buffer_top option.
1da177e4
LT		 1542 For example,
1543 Sony F250: buffer_top=0x25a800
1544 Sony F270: buffer_top=0x272800
1545 The driver supports only ac97 codec. It's possible to force
1546 to initialize/use ac97 although it's not detected. In such a
1547 case, use force_ac97=1 option - but *NO* guarantee whether it
1548 works!
1549
1550 Note: The NM256 chip can be linked internally with non-AC97
1551 codecs. This driver supports only the AC97 codec, and won't work
1552 with machines with other (most likely CS423x or OPL3SAx) chips,
1553 even though the device is detected in lspci. In such a case, try
1554 other drivers, e.g. snd-cs4232 or snd-opl3sa2. Some has ISA-PnP
6243008b 1555 but some doesn't have ISA PnP. You'll need to specify isapnp=0
1da177e4
LT		 1556 and proper hardware parameters in the case without ISA PnP.
1557
1558 Note: some laptops need a workaround for AC97 RESET. For the
1559 known hardware like Dell Latitude LS and Sony PCG-F305, this
1560 workaround is enabled automatically. For other laptops with a
1561 hard freeze, you can try reset_workaround=1 option.
1562
d1f38cf9
TI		 1563 Note: Dell Latitude CSx laptops have another problem regarding
1564 AC97 RESET. On these laptops, reset_workaround2 option is
1565 turned on as default. This option is worth to try if the
1566 previous reset_workaround option doesn't help.
1567
1da177e4
LT		 1568 Note: This driver is really crappy. It's a porting from the
1569 OSS driver, which is a result of black-magic reverse engineering.
1570 The detection of codec will fail if the driver is loaded *after*
1571 X-server as described above. You might be able to force to load
1572 the module, but it may result in hang-up. Hence, make sure that
1573 you load this module *before* X if you encounter this kind of
1574 problem.
1575
1576 Module snd-opl3sa2
1577 ------------------
1578
1579 Module for Yamaha OPL3-SA2/SA3 sound cards.
1580
64e0e2d9
RH		 1581 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1582
1583 with isapnp=0, the following options are available:
1584
1da177e4
LT		 1585 port - control port # for OPL3-SA chip (0x370)
1586 sb_port - SB port # for OPL3-SA chip (0x220,0x240)
1587 wss_port - WSS port # for OPL3-SA chip (0x530,0xe80,0xf40,0x604)
1588 midi_port - port # for MPU-401 UART (0x300,0x330), -1 = disable
1589 fm_port - FM port # for OPL3-SA chip (0x388), -1 = disable
1590 irq - IRQ # for OPL3-SA chip (5,7,9,10)
1591 dma1 - first DMA # for Yamaha OPL3-SA chip (0,1,3)
1592 dma2 - second DMA # for Yamaha OPL3-SA chip (0,1,3), -1 = disable
1da177e4 1593
0ef797c5 1594 This module supports multiple cards and ISA PnP. It does not support
1da177e4
LT		 1595 autoprobe (if ISA PnP is not used) thus all ports must be specified!!!
1596
1597 The power-management is supported.
1598
1599 Module snd-opti92x-ad1848
1600 -------------------------
1601
1602 Module for sound cards based on OPTi 82c92x and Analog Devices AD1848 chips.
1603 Module works with OAK Mozart cards as well.
1604
64e0e2d9
RH		 1605 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1606
1607 with isapnp=0, the following options are available:
1608
1da177e4
LT		 1609 port - port # for WSS chip (0x530,0xe80,0xf40,0x604)
1610 mpu_port - port # for MPU-401 UART (0x300,0x310,0x320,0x330)
1611 fm_port - port # for OPL3 device (0x388)
1612 irq - IRQ # for WSS chip (5,7,9,10,11)
1613 mpu_irq - IRQ # for MPU-401 UART (5,7,9,10)
1614 dma1 - first DMA # for WSS chip (0,1,3)
1615
1616 This module supports only one card, autoprobe and PnP.
1617
1618 Module snd-opti92x-cs4231
1619 -------------------------
1620
1621 Module for sound cards based on OPTi 82c92x and Crystal CS4231 chips.
1622
64e0e2d9
RH		 1623 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1624
1625 with isapnp=0, the following options are available:
1626
1da177e4
LT		 1627 port - port # for WSS chip (0x530,0xe80,0xf40,0x604)
1628 mpu_port - port # for MPU-401 UART (0x300,0x310,0x320,0x330)
1629 fm_port - port # for OPL3 device (0x388)
1630 irq - IRQ # for WSS chip (5,7,9,10,11)
1631 mpu_irq - IRQ # for MPU-401 UART (5,7,9,10)
1632 dma1 - first DMA # for WSS chip (0,1,3)
1633 dma2 - second DMA # for WSS chip (0,1,3)
1634
1635 This module supports only one card, autoprobe and PnP.
1636
1637 Module snd-opti93x
1638 ------------------
1639
1640 Module for sound cards based on OPTi 82c93x chips.
1641
64e0e2d9
RH		 1642 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1643
1644 with isapnp=0, the following options are available:
1645
1da177e4
LT		 1646 port - port # for WSS chip (0x530,0xe80,0xf40,0x604)
1647 mpu_port - port # for MPU-401 UART (0x300,0x310,0x320,0x330)
1648 fm_port - port # for OPL3 device (0x388)
1649 irq - IRQ # for WSS chip (5,7,9,10,11)
1650 mpu_irq - IRQ # for MPU-401 UART (5,7,9,10)
1651 dma1 - first DMA # for WSS chip (0,1,3)
1652 dma2 - second DMA # for WSS chip (0,1,3)
1653
1654 This module supports only one card, autoprobe and PnP.
1655
48a8a26d
CL		 1656 Module snd-oxygen
1657 -----------------
1658
1659 Module for sound cards based on the C-Media CMI8788 chip:
1660 * Asound A-8788
1661 * AuzenTech X-Meridian
1662 * Bgears b-Enspirer
1663 * Club3D Theatron DTS
1664 * HT-Omega Claro
1665 * Razer Barracuda AC-1
1666 * Sondigo Inferno
48a8a26d
CL		 1667
1668 This module supports autoprobe and multiple cards.
1669
d08cd58d
SS		 1670 Module snd-pcsp
1671 -----------------
1672
1673 Module for internal PC-Speaker.
1674
1675 nforce_wa - enable NForce chipset workaround. Expect bad sound.
1676
1677 This module supports system beeps, some kind of PCM playback and
1678 even a few mixer controls.
1679
e12229b4
MB		 1680 Module snd-pcxhr
1681 ----------------
1682
1683 Module for Digigram PCXHR boards
1684
1685 This module supports multiple cards.
1686
757e119b
MK		 1687 Module snd-portman2x4
1688 ---------------------
1689
1690 Module for Midiman Portman 2x4 parallel port MIDI interface
1691
1692 This module supports multiple cards.
1693
1da177e4
LT		 1694 Module snd-powermac (on ppc only)
1695 ---------------------------------
1696
1697 Module for PowerMac, iMac and iBook on-board soundchips
1698
1699 enable_beep - enable beep using PCM (enabled as default)
1700
1701 Module supports autoprobe a chip.
1702
1703 Note: the driver may have problems regarding endianess.
1704
1705 The power-management is supported.
1706
2c484df0
TI		 1707 Module snd-pxa2xx-ac97 (on arm only)
1708 ------------------------------------
1709
1710 Module for AC97 driver for the Intel PXA2xx chip
1711
1712 For ARM architecture only.
1713
a4efc230
TI		 1714 The power-management is supported.
1715
109a9638
PG		 1716 Module snd-riptide
1717 ------------------
1718
1719 Module for Conexant Riptide chip
1720
1721 joystick_port - Joystick port # (default: 0x200)
1722 mpu_port - MPU401 port # (default: 0x330)
1723 opl3_port - OPL3 port # (default: 0x388)
1724
1725 This module supports multiple cards.
1726 The driver requires the firmware loader support on kernel.
1727 You need to install the firmware file "riptide.hex" to the standard
1728 firmware path (e.g. /lib/firmware).
1729
1da177e4
LT		 1730 Module snd-rme32
1731 ----------------
1732
1733 Module for RME Digi32, Digi32 Pro and Digi32/8 (Sek'd Prodif32,
1734 Prodif96 and Prodif Gold) sound cards.
1735
0ef797c5 1736 This module supports multiple cards.
1da177e4
LT		 1737
1738 Module snd-rme96
1739 ----------------
1740
1741 Module for RME Digi96, Digi96/8 and Digi96/8 PRO/PAD/PST sound cards.
1742
0ef797c5 1743 This module supports multiple cards.
1da177e4
LT		 1744
1745 Module snd-rme9652
1746 ------------------
1747
1748 Module for RME Digi9652 (Hammerfall, Hammerfall-Light) sound cards.
1749
1750 precise_ptr - Enable precise pointer (doesn't work reliably).
1751 (default = 0)
1752
0ef797c5 1753 This module supports multiple cards.
1da177e4
LT		 1754
1755 Note: snd-page-alloc module does the job which snd-hammerfall-mem
1756 module did formerly. It will allocate the buffers in advance
1757 when any RME9652 cards are found. To make the buffer
1758 allocation sure, load snd-page-alloc module in the early
b6a96915
TI		 1759 stage of boot sequence. See "Early Buffer Allocation"
1760 section.
1da177e4
LT		 1761
1762 Module snd-sa11xx-uda1341 (on arm only)
1763 ---------------------------------------
1764
1765 Module for Philips UDA1341TS on Compaq iPAQ H3600 sound card.
1766
1767 Module supports only one card.
1768 Module has no enable and index options.
1769
a4efc230
TI		 1770 The power-management is supported.
1771
1da177e4
LT		 1772 Module snd-sb8
1773 --------------
1774
1775 Module for 8-bit SoundBlaster cards: SoundBlaster 1.0,
1776 SoundBlaster 2.0,
1777 SoundBlaster Pro
1778
1779 port - port # for SB DSP chip (0x220,0x240,0x260)
1780 irq - IRQ # for SB DSP chip (5,7,9,10)
1781 dma8 - DMA # for SB DSP chip (1,3)
1782
0ef797c5 1783 This module supports multiple cards and autoprobe.
1da177e4 1784
a4efc230
TI		 1785 The power-management is supported.
1786
1da177e4
LT		 1787 Module snd-sb16 and snd-sbawe
1788 -----------------------------
1789
1790 Module for 16-bit SoundBlaster cards: SoundBlaster 16 (PnP),
1791 SoundBlaster AWE 32 (PnP),
1792 SoundBlaster AWE 64 PnP
1793
64e0e2d9
RH		 1794 mic_agc - Mic Auto-Gain-Control - 0 = disable, 1 = enable (default)
1795 csp - ASP/CSP chip support - 0 = disable (default), 1 = enable
1796 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1797
1798 with isapnp=0, the following options are available:
1799
1da177e4
LT		 1800 port - port # for SB DSP 4.x chip (0x220,0x240,0x260)
1801 mpu_port - port # for MPU-401 UART (0x300,0x330), -1 = disable
1802 awe_port - base port # for EMU8000 synthesizer (0x620,0x640,0x660)
1803 (snd-sbawe module only)
1804 irq - IRQ # for SB DSP 4.x chip (5,7,9,10)
1805 dma8 - 8-bit DMA # for SB DSP 4.x chip (0,1,3)
1806 dma16 - 16-bit DMA # for SB DSP 4.x chip (5,6,7)
1da177e4 1807
0ef797c5 1808 This module supports multiple cards, autoprobe and ISA PnP.
1da177e4
LT		 1809
1810 Note: To use Vibra16X cards in 16-bit half duplex mode, you must
1811 disable 16bit DMA with dma16 = -1 module parameter.
1812 Also, all Sound Blaster 16 type cards can operate in 16-bit
1813 half duplex mode through 8-bit DMA channel by disabling their
1814 16-bit DMA channel.
1815
a4efc230
TI		 1816 The power-management is supported.
1817
074a6e9f
TI		 1818 Module snd-sc6000
1819 -----------------
1820
1821 Module for Gallant SC-6000 soundcard.
1822
1823 port - Port # (0x220 or 0x240)
1824 mss_port - MSS Port # (0x530 or 0xe80)
1825 irq - IRQ # (5,7,9,10,11)
7b758d2f 1826 mpu_irq - MPU-401 IRQ # (5,7,9,10) ,0 - no MPU-401 irq
074a6e9f
TI		 1827 dma - DMA # (1,3,0)
1828
1829 This module supports multiple cards.
1830
1831 This card is also known as Audio Excel DSP 16 or Zoltrix AV302.
1832
1da177e4
LT		 1833 Module snd-sgalaxy
1834 ------------------
1835
1836 Module for Aztech Sound Galaxy sound card.
1837
1838 sbport - Port # for SB16 interface (0x220,0x240)
1839 wssport - Port # for WSS interface (0x530,0xe80,0xf40,0x604)
1840 irq - IRQ # (7,9,10,11)
1841 dma1 - DMA #
1842
0ef797c5 1843 This module supports multiple cards.
1da177e4 1844
a4efc230
TI		 1845 The power-management is supported.
1846
1da177e4
LT		 1847 Module snd-sscape
1848 -----------------
1849
1850 Module for ENSONIQ SoundScape PnP cards.
1851
1852 port - Port # (PnP setup)
adf1295b 1853 wss_port - WSS Port # (PnP setup)
1da177e4
LT		 1854 irq - IRQ # (PnP setup)
1855 mpu_irq - MPU-401 IRQ # (PnP setup)
1856 dma - DMA # (PnP setup)
adf1295b 1857 dma2 - 2nd DMA # (PnP setup, -1 to disable)
1da177e4 1858
0ef797c5 1859 This module supports multiple cards. ISA PnP must be enabled.
1da177e4
LT		 1860 You need sscape_ctl tool in alsa-tools package for loading
1861 the microcode.
1862
1863 Module snd-sun-amd7930 (on sparc only)
1864 --------------------------------------
1865
1866 Module for AMD7930 sound chips found on Sparcs.
1867
0ef797c5 1868 This module supports multiple cards.
1da177e4
LT		 1869
1870 Module snd-sun-cs4231 (on sparc only)
1871 -------------------------------------
1872
1873 Module for CS4231 sound chips found on Sparcs.
1874
0ef797c5 1875 This module supports multiple cards.
1da177e4 1876
1bd9debf
TI		 1877 Module snd-sun-dbri (on sparc only)
1878 -----------------------------------
1879
1880 Module for DBRI sound chips found on Sparcs.
1881
0ef797c5 1882 This module supports multiple cards.
1bd9debf 1883
1da177e4
LT		 1884 Module snd-wavefront
1885 --------------------
1886
1887 Module for Turtle Beach Maui, Tropez and Tropez+ sound cards.
1888
64e0e2d9
RH		 1889 use_cs4232_midi - Use CS4232 MPU-401 interface
1890 (inaccessibly located inside your computer)
1891 isapnp - ISA PnP detection - 0 = disable, 1 = enable (default)
1892
1893 with isapnp=0, the following options are available:
1894
1da177e4
LT		 1895 cs4232_pcm_port - Port # for CS4232 PCM interface.
1896 cs4232_pcm_irq - IRQ # for CS4232 PCM interface (5,7,9,11,12,15).
1897 cs4232_mpu_port - Port # for CS4232 MPU-401 interface.
1898 cs4232_mpu_irq - IRQ # for CS4232 MPU-401 interface (9,11,12,15).
1da177e4
LT		 1899 ics2115_port - Port # for ICS2115
1900 ics2115_irq - IRQ # for ICS2115
1901 fm_port - FM OPL-3 Port #
1902 dma1 - DMA1 # for CS4232 PCM interface.
1903 dma2 - DMA2 # for CS4232 PCM interface.
1da177e4 1904
c2b1239a
TI		 1905 The below are options for wavefront_synth features:
1906 wf_raw - Assume that we need to boot the OS (default:no)
1907 If yes, then during driver loading, the state of the board is
1908 ignored, and we reset the board and load the firmware anyway.
1909 fx_raw - Assume that the FX process needs help (default:yes)
1910 If false, we'll leave the FX processor in whatever state it is
1911 when the driver is loaded. The default is to download the
1912 microprogram and associated coefficients to set it up for
1913 "default" operation, whatever that means.
1914 debug_default - Debug parameters for card initialization
1915 wait_usecs - How long to wait without sleeping, usecs
1916 (default:150)
1917 This magic number seems to give pretty optimal throughput
1918 based on my limited experimentation.
1919 If you want to play around with it and find a better value, be
1920 my guest. Remember, the idea is to get a number that causes us
1921 to just busy wait for as many WaveFront commands as possible,
1922 without coming up with a number so large that we hog the whole
1923 CPU.
1924 Specifically, with this number, out of about 134,000 status
1925 waits, only about 250 result in a sleep.
1926 sleep_interval - How long to sleep when waiting for reply
1927 (default: 100)
1928 sleep_tries - How many times to try sleeping during a wait
1929 (default: 50)
1930 ospath - Pathname to processed ICS2115 OS firmware
1931 (default:wavefront.os)
1932 The path name of the ISC2115 OS firmware. In the recent
1933 version, it's handled via firmware loader framework, so it
1934 must be installed in the proper path, typically,
1935 /lib/firmware.
1936 reset_time - How long to wait for a reset to take effect
1937 (default:2)
1938 ramcheck_time - How many seconds to wait for the RAM test
1939 (default:20)
1940 osrun_time - How many seconds to wait for the ICS2115 OS
1941 (default:10)
1942
0ef797c5 1943 This module supports multiple cards and ISA PnP.
1da177e4 1944
c2b1239a
TI		 1945 Note: the firmware file "wavefront.os" was located in the earlier
1946 version in /etc. Now it's loaded via firmware loader, and
1947 must be in the proper firmware path, such as /lib/firmware.
1948 Copy (or symlink) the file appropriately if you get an error
1949 regarding firmware downloading after upgrading the kernel.
1950
1da177e4
LT		 1951 Module snd-sonicvibes
1952 ---------------------
1953
1954 Module for S3 SonicVibes PCI sound cards.
1955 * PINE Schubert 32 PCI
1956
1957 reverb - Reverb Enable - 1 = enable, 0 = disable (default)
1958 - SoundCard must have onboard SRAM for this.
1959 mge - Mic Gain Enable - 1 = enable, 0 = disable (default)
1960
0ef797c5 1961 This module supports multiple cards and autoprobe.
1da177e4
LT		 1962
1963 Module snd-serial-u16550
1964 ------------------------
1965
1966 Module for UART16550A serial MIDI ports.
1967
1968 port - port # for UART16550A chip
1969 irq - IRQ # for UART16550A chip, -1 = poll mode
1970 speed - speed in bauds (9600,19200,38400,57600,115200)
1971 38400 = default
1972 base - base for divisor in bauds (57600,115200,230400,460800)
1973 115200 = default
1974 outs - number of MIDI ports in a serial port (1-4)
1975 1 = default
1976 adaptor - Type of adaptor.
1977 0 = Soundcanvas, 1 = MS-124T, 2 = MS-124W S/A,
1978 3 = MS-124W M/B, 4 = Generic
1979
0ef797c5 1980 This module supports multiple cards. This module does not support autoprobe
1da177e4
LT		 1981 thus the main port must be specified!!! Other options are optional.
1982
1983 Module snd-trident
1984 ------------------
1985
1986 Module for Trident 4DWave DX/NX sound cards.
1987 * Best Union Miss Melody 4DWave PCI
1988 * HIS 4DWave PCI
1989 * Warpspeed ONSpeed 4DWave PCI
1990 * AzTech PCI 64-Q3D
1991 * Addonics SV 750
1992 * CHIC True Sound 4Dwave
1993 * Shark Predator4D-PCI
1994 * Jaton SonicWave 4D
6ef10905
AB		 1995 * SiS SI7018 PCI Audio
1996 * Hoontech SoundTrack Digital 4DWave NX
1da177e4
LT		 1997
1998 pcm_channels - max channels (voices) reserved for PCM
1999 wavetable_size - max wavetable size in kB (4-?kb)
2000
0ef797c5 2001 This module supports multiple cards and autoprobe.
1da177e4
LT		 2002
2003 The power-management is supported.
2004
2005 Module snd-usb-audio
2006 --------------------
2007
2008 Module for USB audio and USB MIDI devices.
2009
2010 vid - Vendor ID for the device (optional)
2011 pid - Product ID for the device (optional)
8a8f2662
TI		 2012 nrpacks - Max. number of packets per URB (default: 8)
2013 async_unlink - Use async unlink mode (default: yes)
e311334e
TLM		 2014 device_setup - Device specific magic number (optional)
2015 - Influence depends on the device
2016 - Default: 0x0000
7a9b8063
TI		 2017 ignore_ctl_error - Ignore any USB-controller regarding mixer
2018 interface (default: no)
1da177e4 2019
0ef797c5 2020 This module supports multiple devices, autoprobe and hotplugging.
1da177e4 2021
8a8f2662
TI		 2022 NB: nrpacks parameter can be modified dynamically via sysfs.
2023 Don't put the value over 20. Changing via sysfs has no sanity
2024 check.
2025 NB: async_unlink=0 would cause Oops. It remains just for
2026 debugging purpose (if any).
7a9b8063
TI		 2027 NB: ignore_ctl_error=1 may help when you get an error at accessing
2028 the mixer element such as URB error -22. This happens on some
2029 buggy USB device or the controller.
8a8f2662 2030
523f1dce
DM		 2031 Module snd-usb-caiaq
2032 --------------------
2033
2034 Module for caiaq UB audio interfaces,
2035 * Native Instruments RigKontrol2
2036 * Native Instruments Kore Controller
2037 * Native Instruments Audio Kontrol 1
2038 * Native Instruments Audio 8 DJ
2039
2040 This module supports multiple devices, autoprobe and hotplugging.
2041
1da177e4
LT		 2042 Module snd-usb-usx2y
2043 --------------------
2044
2045 Module for Tascam USB US-122, US-224 and US-428 devices.
2046
0ef797c5 2047 This module supports multiple devices, autoprobe and hotplugging.
1da177e4
LT		 2048
2049 Note: you need to load the firmware via usx2yloader utility included
2050 in alsa-tools and alsa-firmware packages.
2051
2052 Module snd-via82xx
2053 ------------------
2054
2055 Module for AC'97 motherboards based on VIA 82C686A/686B, 8233,
2d7eb7cb 2056 8233A, 8233C, 8235, 8237 (south) bridge.
1da177e4
LT		 2057
2058 mpu_port - 0x300,0x310,0x320,0x330, otherwise obtain BIOS setup
2059 [VIA686A/686B only]
2060 joystick - Enable joystick (default off) [VIA686A/686B only]
2061 ac97_clock - AC'97 codec clock base (default 48000Hz)
2062 dxs_support - support DXS channels,
2d7eb7cb
SV		 2063 0 = auto (default), 1 = enable, 2 = disable,
2064 3 = 48k only, 4 = no VRA, 5 = enable any sample
2065 rate and different sample rates on different
2066 channels
2067 [VIA8233/C, 8235, 8237 only]
1da177e4 2068 ac97_quirk - AC'97 workaround for strange hardware
6243008b 2069 See "AC97 Quirk Option" section below.
1da177e4 2070
b7fe4622 2071 This module supports one chip and autoprobe.
1da177e4
LT		 2072
2073 Note: on some SMP motherboards like MSI 694D the interrupts might
2074 not be generated properly. In such a case, please try to
2075 set the SMP (or MPS) version on BIOS to 1.1 instead of
2076 default value 1.4. Then the interrupt number will be
2077 assigned under 15. You might also upgrade your BIOS.
2078
2d7eb7cb 2079 Note: VIA8233/5/7 (not VIA8233A) can support DXS (direct sound)
1da177e4 2080 channels as the first PCM. On these channels, up to 4
2d7eb7cb
SV		 2081 streams can be played at the same time, and the controller
2082 can perform sample rate conversion with separate rates for
2083 each channel.
1da177e4
LT		 2084 As default (dxs_support = 0), 48k fixed rate is chosen
2085 except for the known devices since the output is often
2086 noisy except for 48k on some mother boards due to the
2087 bug of BIOS.
2d7eb7cb 2088 Please try once dxs_support=5 and if it works on other
1da177e4
LT		 2089 sample rates (e.g. 44.1kHz of mp3 playback), please let us
2090 know the PCI subsystem vendor/device id's (output of
2091 "lspci -nv").
cdc27f3a
TI		 2092 If dxs_support=5 does not work, try dxs_support=4; if it
2093 doesn't work too, try dxs_support=1. (dxs_support=1 is
6243008b 2094 usually for old motherboards. The correct implemented
cdc27f3a 2095 board should work with 4 or 5.) If it still doesn't
1da177e4
LT		 2096 work and the default setting is ok, dxs_support=3 is the
2097 right choice. If the default setting doesn't work at all,
2098 try dxs_support=2 to disable the DXS channels.
2099 In any cases, please let us know the result and the
6243008b
TI		 2100 subsystem vendor/device ids. See "Links and Addresses"
2101 below.
1da177e4
LT		 2102
2103 Note: for the MPU401 on VIA823x, use snd-mpu401 driver
6243008b 2104 additionally. The mpu_port option is for VIA686 chips only.
1da177e4 2105
a4efc230
TI		 2106 The power-management is supported.
2107
1da177e4
LT		 2108 Module snd-via82xx-modem
2109 ------------------------
2110
2111 Module for VIA82xx AC97 modem
2112
2113 ac97_clock - AC'97 codec clock base (default 48000Hz)
2114
b7fe4622 2115 This module supports one card and autoprobe.
1da177e4
LT		 2116
2117 Note: The default index value of this module is -2, i.e. the first
2118 slot is excluded.
2119
a4efc230
TI		 2120 The power-management is supported.
2121
1da177e4
LT		 2122 Module snd-virmidi
2123 ------------------
2124
2125 Module for virtual rawmidi devices.
2126 This module creates virtual rawmidi devices which communicate
2127 to the corresponding ALSA sequencer ports.
2128
0ef797c5 2129 midi_devs - MIDI devices # (1-4, default=4)
1da177e4 2130
0ef797c5 2131 This module supports multiple cards.
1da177e4 2132
48a8a26d
CL		 2133 Module snd-virtuoso
2134 -------------------
2135
5430c72b 2136 Module for sound cards based on the Asus AV100/AV200 chips,
7407a2e4 2137 i.e., Xonar D1, DX, D2, D2X and HDAV1.3 (Deluxe).
48a8a26d
CL		 2138
2139 This module supports autoprobe and multiple cards.
2140
1da177e4
LT		 2141 Module snd-vx222
2142 ----------------
2143
2144 Module for Digigram VX-Pocket VX222, V222 v2 and Mic cards.
2145
2146 mic - Enable Microphone on V222 Mic (NYI)
2147 ibl - Capture IBL size. (default = 0, minimum size)
2148
0ef797c5 2149 This module supports multiple cards.
1da177e4
LT		 2150
2151 When the driver is compiled as a module and the hotplug firmware
2152 is supported, the firmware data is loaded via hotplug automatically.
2153 Install the necessary firmware files in alsa-firmware package.
2154 When no hotplug fw loader is available, you need to load the
2155 firmware via vxloader utility in alsa-tools package. To invoke
2156 vxloader automatically, add the following to /etc/modprobe.conf
2157
2158 install snd-vx222 /sbin/modprobe --first-time -i snd-vx222 && /usr/bin/vxloader
2159
2160 (for 2.2/2.4 kernels, add "post-install /usr/bin/vxloader" to
2161 /etc/modules.conf, instead.)
2162 IBL size defines the interrupts period for PCM. The smaller size
2163 gives smaller latency but leads to more CPU consumption, too.
2164 The size is usually aligned to 126. As default (=0), the smallest
2165 size is chosen. The possible IBL values can be found in
2166 /proc/asound/cardX/vx-status proc file.
2167
a4efc230
TI		 2168 The power-management is supported.
2169
1da177e4
LT		 2170 Module snd-vxpocket
2171 -------------------
2172
6d00a312 2173 Module for Digigram VX-Pocket VX2 and 440 PCMCIA cards.
1da177e4
LT		 2174
2175 ibl - Capture IBL size. (default = 0, minimum size)
2176
0ef797c5 2177 This module supports multiple cards. The module is compiled only when
1da177e4
LT		 2178 PCMCIA is supported on kernel.
2179
6243008b
TI		 2180 With the older 2.6.x kernel, to activate the driver via the card
2181 manager, you'll need to set up /etc/pcmcia/vxpocket.conf. See the
2182 sound/pcmcia/vx/vxpocket.c. 2.6.13 or later kernel requires no
2183 longer require a config file.
1da177e4
LT		 2184
2185 When the driver is compiled as a module and the hotplug firmware
2186 is supported, the firmware data is loaded via hotplug automatically.
2187 Install the necessary firmware files in alsa-firmware package.
2188 When no hotplug fw loader is available, you need to load the
2189 firmware via vxloader utility in alsa-tools package.
2190
2191 About capture IBL, see the description of snd-vx222 module.
2192
ed7cbe3e 2193 Note: snd-vxp440 driver is merged to snd-vxpocket driver since
6243008b
TI		 2194 ALSA 1.0.10.
2195
a4efc230
TI		 2196 The power-management is supported.
2197
1da177e4
LT		 2198 Module snd-ymfpci
2199 -----------------
2200
2201 Module for Yamaha PCI chips (YMF72x, YMF74x & YMF75x).
2202
2203 mpu_port - 0x300,0x330,0x332,0x334, 0 (disable) by default,
2204 1 (auto-detect for YMF744/754 only)
2205 fm_port - 0x388,0x398,0x3a0,0x3a8, 0 (disable) by default
2206 1 (auto-detect for YMF744/754 only)
2207 joystick_port - 0x201,0x202,0x204,0x205, 0 (disable) by default,
2208 1 (auto-detect)
2209 rear_switch - enable shared rear/line-in switch (bool)
2210
0ef797c5 2211 This module supports autoprobe and multiple chips.
1da177e4
LT		 2212
2213 The power-management is supported.
2214
2215 Module snd-pdaudiocf
2216 --------------------
2217
2218 Module for Sound Core PDAudioCF sound card.
2219
a4efc230
TI		 2220 The power-management is supported.
2221
1da177e4 2222
6243008b
TI		 2223AC97 Quirk Option
2224=================
2225
2226The ac97_quirk option is used to enable/override the workaround for
2227specific devices on drivers for on-board AC'97 controllers like
2228snd-intel8x0. Some hardware have swapped output pins between Master
2229and Headphone, or Surround (thanks to confusion of AC'97
2230specifications from version to version :-)
2231
2232The driver provides the auto-detection of known problematic devices,
2233but some might be unknown or wrongly detected. In such a case, pass
2234the proper value with this option.
2235
2236The following strings are accepted:
2237 - default Don't override the default setting
10e4097f 2238 - none Disable the quirk
6243008b
TI		 2239 - hp_only Bind Master and Headphone controls as a single control
2240 - swap_hp Swap headphone and master controls
2241 - swap_surround Swap master and surround controls
2242 - ad_sharing For AD1985, turn on OMS bit and use headphone
2243 - alc_jack For ALC65x, turn on the jack sense mode
2244 - inv_eapd Inverted EAPD implementation
2245 - mute_led Bind EAPD bit for turning on/off mute LED
2246
2247For backward compatibility, the corresponding integer value -1, 0,
2248... are accepted, too.
2249
2250For example, if "Master" volume control has no effect on your device
2251but only "Headphone" does, pass ac97_quirk=hp_only module option.
2252
2253
1da177e4
LT		 2254Configuring Non-ISAPNP Cards
2255============================
2256
2257When the kernel is configured with ISA-PnP support, the modules
2258supporting the isapnp cards will have module options "isapnp".
2259If this option is set, *only* the ISA-PnP devices will be probed.
2260For probing the non ISA-PnP cards, you have to pass "isapnp=0" option
2261together with the proper i/o and irq configuration.
2262
2263When the kernel is configured without ISA-PnP support, isapnp option
2264will be not built in.
2265
2266
2267Module Autoloading Support
2268==========================
2269
2270The ALSA drivers can be loaded automatically on demand by defining
2271module aliases. The string 'snd-card-%1' is requested for ALSA native
2272devices where %i is sound card number from zero to seven.
2273
2274To auto-load an ALSA driver for OSS services, define the string
2275'sound-slot-%i' where %i means the slot number for OSS, which
2276corresponds to the card index of ALSA. Usually, define this
d533f671 2277as the same card module.
1da177e4
LT		 2278
2279An example configuration for a single emu10k1 card is like below:
2280----- /etc/modprobe.conf
2281alias snd-card-0 snd-emu10k1
2282alias sound-slot-0 snd-emu10k1
2283----- /etc/modprobe.conf
2284
2285The available number of auto-loaded sound cards depends on the module
2286option "cards_limit" of snd module. As default it's set to 1.
2287To enable the auto-loading of multiple cards, specify the number of
2288sound cards in that option.
2289
2290When multiple cards are available, it'd better to specify the index
2291number for each card via module option, too, so that the order of
2292cards is kept consistent.
2293
2294An example configuration for two sound cards is like below:
2295
2296----- /etc/modprobe.conf
2297# ALSA portion
2298options snd cards_limit=2
2299alias snd-card-0 snd-interwave
2300alias snd-card-1 snd-ens1371
2301options snd-interwave index=0
2302options snd-ens1371 index=1
2303# OSS/Free portion
2304alias sound-slot-0 snd-interwave
2305alias sound-slot-1 snd-ens1371
2fe0ae78 2306----- /etc/modprobe.conf
1da177e4
LT		 2307
2308In this example, the interwave card is always loaded as the first card
2309(index 0) and ens1371 as the second (index 1).
2310
304cd07f
TI		 2311Alternative (and new) way to fixate the slot assignment is to use
2312"slots" option of snd module. In the case above, specify like the
2313following:
2314
2315options snd slots=snd-interwave,snd-ens1371
2316
2317Then, the first slot (#0) is reserved for snd-interwave driver, and
2318the second (#1) for snd-ens1371. You can omit index option in each
2319driver if slots option is used (although you can still have them at
2320the same time as long as they don't conflict).
2321
2322The slots option is especially useful for avoiding the possible
2323hot-plugging and the resultant slot conflict. For example, in the
2324case above again, the first two slots are already reserved. If any
2325other driver (e.g. snd-usb-audio) is loaded before snd-interwave or
2326snd-ens1371, it will be assigned to the third or later slot.
2327
a93bbaa7
TI		 2328When a module name is given with '!', the slot will be given for any
2329modules but that name. For example, "slots=!snd-pcsp" will reserve
2330the first slot for any modules but snd-pcsp.
2331
1da177e4
LT		 2332
2333ALSA PCM devices to OSS devices mapping
2334=======================================
2335
2336/dev/snd/pcmC0D0[c|p] -> /dev/audio0 (/dev/audio) -> minor 4
2337/dev/snd/pcmC0D0[c|p] -> /dev/dsp0 (/dev/dsp) -> minor 3
2338/dev/snd/pcmC0D1[c|p] -> /dev/adsp0 (/dev/adsp) -> minor 12
2339/dev/snd/pcmC1D0[c|p] -> /dev/audio1 -> minor 4+16 = 20
2340/dev/snd/pcmC1D0[c|p] -> /dev/dsp1 -> minor 3+16 = 19
2341/dev/snd/pcmC1D1[c|p] -> /dev/adsp1 -> minor 12+16 = 28
2342/dev/snd/pcmC2D0[c|p] -> /dev/audio2 -> minor 4+32 = 36
2343/dev/snd/pcmC2D0[c|p] -> /dev/dsp2 -> minor 3+32 = 39
2344/dev/snd/pcmC2D1[c|p] -> /dev/adsp2 -> minor 12+32 = 44
2345
2346The first number from /dev/snd/pcmC{X}D{Y}[c|p] expression means
2347sound card number and second means device number. The ALSA devices
2348have either 'c' or 'p' suffix indicating the direction, capture and
2349playback, respectively.
2350
2351Please note that the device mapping above may be varied via the module
2352options of snd-pcm-oss module.
2353
2354
1da177e4
LT		 2355Proc interfaces (/proc/asound)
2356==============================
2357
2358/proc/asound/card#/pcm#[cp]/oss
2359-------------------------------
2360 String "erase" - erase all additional informations about OSS applications
2361 String "<app_name> <fragments> <fragment_size> [<options>]"
2362
2363 <app_name> - name of application with (higher priority) or without path
2364 <fragments> - number of fragments or zero if auto
2365 <fragment_size> - size of fragment in bytes or zero if auto
2366 <options> - optional parameters
2367 - disable the application tries to open a pcm device for
2368 this channel but does not want to use it.
2369 (Cause a bug or mmap needs)
2370 It's good for Quake etc...
2371 - direct don't use plugins
2372 - block force block mode (rvplayer)
2373 - non-block force non-block mode
2374 - whole-frag write only whole fragments (optimization affecting
2375 playback only)
2376 - no-silence do not fill silence ahead to avoid clicks
10f69f9e
TI		 2377 - buggy-ptr Returns the whitespace blocks in GETOPTR ioctl
2378 instead of filled blocks
1da177e4
LT		 2379
2380 Example: echo "x11amp 128 16384" > /proc/asound/card0/pcm0p/oss
2381 echo "squake 0 0 disable" > /proc/asound/card0/pcm0c/oss
2382 echo "rvplayer 0 0 block" > /proc/asound/card0/pcm0p/oss
2383
2384
b6a96915
TI		 2385Early Buffer Allocation
2386=======================
2387
2388Some drivers (e.g. hdsp) require the large contiguous buffers, and
2389sometimes it's too late to find such spaces when the driver module is
2390actually loaded due to memory fragmentation. You can pre-allocate the
2391PCM buffers by loading snd-page-alloc module and write commands to its
2392proc file in prior, for example, in the early boot stage like
2393/etc/init.d/*.local scripts.
2394
2395Reading the proc file /proc/drivers/snd-page-alloc shows the current
2396usage of page allocation. In writing, you can send the following
2397commands to the snd-page-alloc driver:
2398
2399 - add VENDOR DEVICE MASK SIZE BUFFERS
2400
2401 VENDOR and DEVICE are PCI vendor and device IDs. They take
2402 integer numbers (0x prefix is needed for the hex).
2403 MASK is the PCI DMA mask. Pass 0 if not restricted.
2404 SIZE is the size of each buffer to allocate. You can pass
2405 k and m suffix for KB and MB. The max number is 16MB.
2406 BUFFERS is the number of buffers to allocate. It must be greater
2407 than 0. The max number is 4.
2408
2409 - erase
2410
2411 This will erase the all pre-allocated buffers which are not in
2412 use.
2413
2414
6243008b
TI		 2415Links and Addresses
2416===================
1da177e4
LT		 2417
2418 ALSA project homepage
2419 http://www.alsa-project.org
2420
30bc4481
TI		 2421 Kernel Bugzilla
2422 http://bugzilla.kernel.org/
6243008b
TI		 2423
2424 ALSA Developers ML
4505179c 2425 mailto:alsa-devel@alsa-project.org
30bc4481
TI		 2426
2427 alsa-info.sh script
2428 http://www.alsa-project.org/alsa-info.sh
kernel source for telekom puls (alcatel/mediatek)