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