Merge branch 'topic/oxygen' into for-linus
[safe/jmp/linux-2.6] / Documentation / sound / alsa / ALSA-Configuration.txt
index ef33071..012858d 100644 (file)
@@ -57,7 +57,9 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
                - Default: 1
                - For auto-loading more than one card, specify this
                  option together with snd-card-X aliases.
-
+    slots      - Reserve the slot index for the given driver.
+                 This option takes multiple strings.           
+                 See "Module Autoloading Support" section for details.
   
   Module snd-pcm-oss
   ------------------
@@ -148,13 +150,6 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     Module for sound cards based on Analog Devices AD1816A/AD1815 ISA chips.
 
-    port       - port # for AD1816A chip (PnP setup)
-    mpu_port   - port # for MPU-401 UART (PnP setup)
-    fm_port    - port # for OPL3 (PnP setup)
-    irq                - IRQ # for AD1816A chip (PnP setup)
-    mpu_irq    - IRQ # for MPU-401 UART (PnP setup)
-    dma1       - first DMA # for AD1816A chip (PnP setup)
-    dma2       - second DMA # for AD1816A chip (PnP setup)
     clockfreq   - Clock frequency for AD1816A chip (default = 0, 33000Hz)
     
     This module supports multiple cards, autoprobe and PnP.
@@ -201,14 +196,6 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     Module for sound cards based on Avance Logic ALS100/ALS120 ISA chips.
 
-    port       - port # for ALS100 (SB16) chip (PnP setup)
-    irq                - IRQ # for ALS100 (SB16) chip (PnP setup)
-    dma8       - 8-bit DMA # for ALS100 (SB16) chip (PnP setup)
-    dma16      - 16-bit DMA # for ALS100 (SB16) chip (PnP setup)
-    mpu_port   - port # for MPU-401 UART (PnP setup)
-    mpu_irq    - IRQ # for MPU-401 (PnP setup)
-    fm_port    - port # for OPL3 FM (PnP setup)
-    
     This module supports multiple cards, autoprobe and PnP.
 
     The power-management is supported.
@@ -297,20 +284,18 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
            control correctly. If you have problems regarding this, try
            another ALSA compliant mixer (alsamixer works).
 
+  Module snd-aw2
+  --------------
+
+    Module for Audiowerk2 sound card
+
+    This module supports multiple cards.
+
   Module snd-azt2320
   ------------------
 
     Module for sound cards based on Aztech System AZT2320 ISA chip (PnP only).
 
-    port       - port # for AZT2320 chip (PnP setup)
-    wss_port   - port # for WSS (PnP setup)
-    mpu_port   - port # for MPU-401 UART (PnP setup)
-    fm_port    - FM port # for AZT2320 chip (PnP setup)
-    irq                - IRQ # for AZT2320 (WSS) chip (PnP setup)
-    mpu_irq    - IRQ # for MPU-401 UART (PnP setup)
-    dma1       - 1st DMA # for AZT2320 (WSS) chip (PnP setup)
-    dma2       - 2nd DMA # for AZT2320 (WSS) chip (PnP setup)
-    
     This module supports multiple cards, PnP and autoprobe.
     
     The power-management is supported.
@@ -350,6 +335,10 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     Module for sound cards based on C-Media CMI8330 ISA chips.
 
+    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
+
+    with isapnp=0, the following options are available:
+
     wssport    - port # for CMI8330 chip (WSS)
     wssirq     - IRQ # for CMI8330 chip (WSS)
     wssdma     - first DMA # for CMI8330 chip (WSS)
@@ -357,6 +346,9 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     sbirq      - IRQ # for CMI8330 chip (SB16)
     sbdma8     - 8bit DMA # for CMI8330 chip (SB16)
     sbdma16    - 16bit DMA # for CMI8330 chip (SB16)
+    fmport     - (optional) OPL3 I/O port
+    mpuport    - (optional) MPU401 I/O port
+    mpuirq     - (optional) MPU401 irq #
 
     This module supports multiple cards and autoprobe.
 
@@ -399,31 +391,16 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     The power-management is supported.
     
-  Module snd-cs4232
+  Module snd-cs4236
   -----------------
 
-    Module for sound cards based on CS4232/CS4232A ISA chips.
+    Module for sound cards based on CS4232/CS4232A,
+                                  CS4235/CS4236/CS4236B/CS4237B/
+                                   CS4238B/CS4239 ISA chips.
 
-    port       - port # for CS4232 chip (PnP setup - 0x534)
-    cport      - control port # for CS4232 chip (PnP setup - 0x120,0x210,0xf00)
-    mpu_port   - port # for MPU-401 UART (PnP setup - 0x300), -1 = disable
-    fm_port    - FM port # for CS4232 chip (PnP setup - 0x388), -1 = disable
-    irq                - IRQ # for CS4232 chip (5,7,9,11,12,15)
-    mpu_irq    - IRQ # for MPU-401 UART (9,11,12,15)
-    dma1       - first DMA # for CS4232 chip (0,1,3)
-    dma2       - second DMA # for Yamaha CS4232 chip (0,1,3), -1 = disable
     isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
-    
-    This module supports multiple cards. This module does not support autoprobe
-    thus main port must be specified!!! Other ports are optional.
-
-    The power-management is supported.
-    
-  Module snd-cs4236
-  -----------------
 
-    Module for sound cards based on CS4235/CS4236/CS4236B/CS4237B/
-                                   CS4238B/CS4239 ISA chips.
+    with isapnp=0, the following options are available:
 
     port       - port # for CS4236 chip (PnP setup - 0x534)
     cport      - control port # for CS4236 chip (PnP setup - 0x120,0x210,0xf00)
@@ -433,7 +410,6 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     mpu_irq    - IRQ # for MPU-401 UART (9,11,12,15)
     dma1       - first DMA # for CS4236 chip (0,1,3)
     dma2       - second DMA # for CS4236 chip (0,1,3), -1 = disable
-    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
     
     This module supports multiple cards. This module does not support autoprobe
     (if ISA PnP is not used) thus main port and control port must be
@@ -441,6 +417,9 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     The power-management is supported.
 
+    This module is aliased as snd-cs4232 since it provides the old
+    snd-cs4232 functionality, too.
+
   Module snd-cs4281
   -----------------
 
@@ -503,13 +482,6 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     Module for Diamond Technologies DT-019X / Avance Logic ALS-007 (PnP
     only)
 
-    port       - Port # (PnP setup)
-    mpu_port   - Port # for MPU-401 (PnP setup)
-    fm_port    - Port # for FM OPL-3 (PnP setup)
-    irq                - IRQ # (PnP setup)
-    mpu_irq    - IRQ # for MPU-401 (PnP setup)
-    dma8       - DMA # (PnP setup)
-
     This module supports multiple cards.  This module is enabled only with
     ISA PnP support.
 
@@ -607,10 +579,6 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     Module for sound cards based on ESS ES968 chip (PnP only).
 
-    port       - port # for ES968 (SB8) chip (PnP setup)
-    irq                - IRQ # for ES968 (SB8) chip (PnP setup)
-    dma1       - DMA # for ES968 (SB8) chip (PnP setup)
-    
     This module supports multiple cards, PnP and autoprobe.
     
     The power-management is supported.
@@ -621,6 +589,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     Module for ESS AudioDrive ES-1688 and ES-688 sound cards.
 
     port       - port # for ES-1688 chip (0x220,0x240,0x260)
+    fm_port    - port # for OPL3 (option; share the same port as default)
     mpu_port   - port # for MPU-401 port (0x300,0x310,0x320,0x330), -1 = disable (default)
     irq                - IRQ # for ES-1688 chip (5,7,9,10)
     mpu_irq    - IRQ # for MPU-401 port (5,7,9,10)
@@ -633,13 +602,16 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     Module for ESS AudioDrive ES-18xx sound cards.
 
+    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
+
+    with isapnp=0, the following options are available:
+
     port       - port # for ES-18xx chip (0x220,0x240,0x260)
     mpu_port   - port # for MPU-401 port (0x300,0x310,0x320,0x330), -1 = disable (default)
     fm_port    - port # for FM (optional, not used)
     irq                - IRQ # for ES-18xx chip (5,7,9,10)
     dma1       - first DMA # for ES-18xx chip (0,1,3)
     dma2       - first DMA # for ES-18xx chip (0,1,3)
-    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
 
     This module supports multiple cards, ISA PnP and autoprobe (without MPU-401
     port if native ISA PnP routines are not used).
@@ -758,284 +730,65 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
   Module snd-hda-intel
   --------------------
 
-    Module for Intel HD Audio (ICH6, ICH6M, ESB2, ICH7, ICH8),
-               ATI SB450, SB600, RS600,
+    Module for Intel HD Audio (ICH6, ICH6M, ESB2, ICH7, ICH8, ICH9, ICH10,
+                       PCH, SCH),
+               ATI SB450, SB600, R600, RS600, RS690, RS780, RV610, RV620,
+                       RV630, RV635, RV670, RV770,
                VIA VT8251/VT8237A,
                SIS966, ULI M5461
 
+    [Multiple options for each card instance]
     model      - force the model name
-    position_fix - Fix DMA pointer (0 = auto, 1 = none, 2 = POSBUF, 3 = FIFO size)
+    position_fix - Fix DMA pointer (0 = auto, 1 = use LPIB, 2 = POSBUF)
     probe_mask  - Bitmask to probe codecs (default = -1, meaning all slots)
+                 When the bit 8 (0x100) is set, the lower 8 bits are used
+                 as the "fixed" codec slots; i.e. the driver probes the
+                 slots regardless what hardware reports back
+    probe_only - Only probing and no codec initialization (default=off);
+                 Useful to check the initial codec status for debugging
+    bdl_pos_adj        - Specifies the DMA IRQ timing delay in samples.
+               Passing -1 will make the driver to choose the appropriate
+               value based on the controller chip.
+    
+    [Single (global) options]
     single_cmd  - Use single immediate commands to communicate with
                codecs (for debugging only)
     enable_msi - Enable Message Signaled Interrupt (MSI) (default = off)
     power_save - Automatic power-saving timtout (in second, 0 =
-               disable, default = 10)
+               disable)
     power_save_controller - Reset HD-audio controller in power-saving mode
                (default = on)
 
-    This module supports one card and autoprobe.
+    This module supports multiple cards and autoprobe.
+    
+    See Documentation/sound/alsa/HD-Audio.txt for more details about
+    HD-audio driver.
 
     Each codec may have a model table for different configurations.
     If your machine isn't listed there, the default (usually minimal)
     configuration is set up.  You can pass "model=<name>" option to
     specify a certain model in such a case.  There are different
-    models depending on the codec chip.
-
-         Model name    Description
-         ----------    -----------
-       ALC880
-         3stack        3-jack in back and a headphone out
-         3stack-digout 3-jack in back, a HP out and a SPDIF out
-         5stack        5-jack in back, 2-jack in front
-         5stack-digout 5-jack in back, 2-jack in front, a SPDIF out
-         6stack        6-jack in back, 2-jack in front
-         6stack-digout 6-jack with a SPDIF out
-         w810          3-jack
-         z71v          3-jack (HP shared SPDIF)
-         asus          3-jack (ASUS Mobo)
-         asus-w1v      ASUS W1V
-         asus-dig      ASUS with SPDIF out
-         asus-dig2     ASUS with SPDIF out (using GPIO2)
-         uniwill       3-jack
-         fujitsu       Fujitsu Laptops (Pi1536)
-         F1734         2-jack
-         lg            LG laptop (m1 express dual)
-         lg-lw         LG LW20/LW25 laptop
-         tcl           TCL S700
-         clevo         Clevo laptops (m520G, m665n)
-         test          for testing/debugging purpose, almost all controls can be
-                       adjusted.  Appearing only when compiled with
-                       $CONFIG_SND_DEBUG=y
-         auto          auto-config reading BIOS (default)
-
-       ALC260
-         hp            HP machines
-         hp-3013       HP machines (3013-variant)
-         fujitsu       Fujitsu S7020
-         acer          Acer TravelMate
-         will          Will laptops (PB V7900)
-         replacer      Replacer 672V
-         basic         fixed pin assignment (old default model)
-         auto          auto-config reading BIOS (default)
-
-       ALC262
-         fujitsu       Fujitsu Laptop
-         hp-bpc        HP xw4400/6400/8400/9400 laptops
-         hp-bpc-d7000  HP BPC D7000
-         benq          Benq ED8
-         benq-t31      Benq T31
-         hippo         Hippo (ATI) with jack detection, Sony UX-90s
-         hippo_1       Hippo (Benq) with jack detection
-         sony-assamd   Sony ASSAMD
-         basic         fixed pin assignment w/o SPDIF
-         auto          auto-config reading BIOS (default)
-
-       ALC268
-         3stack        3-stack model
-         toshiba       Toshiba A205
-         acer          Acer laptops
-         auto          auto-config reading BIOS (default)
-
-       ALC662
-         3stack-dig    3-stack (2-channel) with SPDIF
-         3stack-6ch     3-stack (6-channel)
-         3stack-6ch-dig 3-stack (6-channel) with SPDIF
-         6stack-dig     6-stack with SPDIF
-         lenovo-101e    Lenovo laptop
-         auto          auto-config reading BIOS (default)
-
-       ALC882/885
-         3stack-dig    3-jack with SPDIF I/O
-         6stack-dig    6-jack digital with SPDIF I/O
-         arima         Arima W820Di1
-         targa         Targa T8, MSI-1049 T8
-         asus-a7j      ASUS A7J
-         asus-a7m      ASUS A7M
-         macpro        MacPro support
-         mbp3          Macbook Pro rev3
-         imac24        iMac 24'' with jack detection
-         w2jc          ASUS W2JC
-         auto          auto-config reading BIOS (default)
-
-       ALC883/888
-         3stack-dig    3-jack with SPDIF I/O
-         6stack-dig    6-jack digital with SPDIF I/O
-         3stack-6ch    3-jack 6-channel
-         3stack-6ch-dig 3-jack 6-channel with SPDIF I/O
-         6stack-dig-demo  6-jack digital for Intel demo board
-         acer          Acer laptops (Travelmate 3012WTMi, Aspire 5600, etc)
-         acer-aspire   Acer Aspire 9810
-         medion        Medion Laptops
-         medion-md2    Medion MD2
-         targa-dig     Targa/MSI
-         targa-2ch-dig Targs/MSI with 2-channel
-         laptop-eapd   3-jack with SPDIF I/O and EAPD (Clevo M540JE, M550JE)
-         lenovo-101e   Lenovo 101E
-         lenovo-nb0763 Lenovo NB0763
-         lenovo-ms7195-dig Lenovo MS7195
-         haier-w66     Haier W66
-         6stack-hp     HP machines with 6stack (Nettle boards)
-         3stack-hp     HP machines with 3stack (Lucknow, Samba boards)
-         auto          auto-config reading BIOS (default)
-
-       ALC861/660
-         3stack        3-jack
-         3stack-dig    3-jack with SPDIF I/O
-         6stack-dig    6-jack with SPDIF I/O
-         3stack-660    3-jack (for ALC660)
-         uniwill-m31   Uniwill M31 laptop
-         toshiba       Toshiba laptop support
-         asus          Asus laptop support
-         asus-laptop   ASUS F2/F3 laptops
-         auto          auto-config reading BIOS (default)
-
-       ALC861VD/660VD
-         3stack        3-jack
-         3stack-dig    3-jack with SPDIF OUT
-         6stack-dig    6-jack with SPDIF OUT
-         3stack-660    3-jack (for ALC660VD)
-         3stack-660-digout 3-jack with SPDIF OUT (for ALC660VD)
-         lenovo        Lenovo 3000 C200
-         dallas        Dallas laptops
-         hp            HP TX1000
-         auto          auto-config reading BIOS (default)
-
-       CMI9880
-         minimal       3-jack in back
-         min_fp        3-jack in back, 2-jack in front
-         full          6-jack in back, 2-jack in front
-         full_dig      6-jack in back, 2-jack in front, SPDIF I/O
-         allout        5-jack in back, 2-jack in front, SPDIF out
-         auto          auto-config reading BIOS (default)
-
-       AD1882
-         3stack        3-stack mode (default)
-         6stack        6-stack mode
-
-       AD1884
-         N/A
-
-       AD1981
-         basic         3-jack (default)
-         hp            HP nx6320
-         thinkpad      Lenovo Thinkpad T60/X60/Z60
-         toshiba       Toshiba U205
-
-       AD1983
-         N/A
-
-       AD1984
-         basic         default configuration
-         thinkpad      Lenovo Thinkpad T61/X61
-
-       AD1986A
-         6stack        6-jack, separate surrounds (default)
-         3stack        3-stack, shared surrounds
-         laptop        2-channel only (FSC V2060, Samsung M50)
-         laptop-eapd   2-channel with EAPD (Samsung R65, ASUS A6J)
-         laptop-automute 2-channel with EAPD and HP-automute (Lenovo N100)
-         ultra         2-channel with EAPD (Samsung Ultra tablet PC)
-
-       AD1988
-         6stack        6-jack
-         6stack-dig    ditto with SPDIF
-         3stack        3-jack
-         3stack-dig    ditto with SPDIF
-         laptop        3-jack with hp-jack automute
-         laptop-dig    ditto with SPDIF
-         auto          auto-config reading BIOS (default)
-       
-       Conexant 5045
-         laptop        Laptop config 
-         test          for testing/debugging purpose, almost all controls
-                       can be adjusted.  Appearing only when compiled with
-                       $CONFIG_SND_DEBUG=y
-
-       Conexant 5047
-         laptop        Basic Laptop config 
-         laptop-hp     Laptop config for some HP models (subdevice 30A5)
-         laptop-eapd   Laptop config with EAPD support
-         test          for testing/debugging purpose, almost all controls
-                       can be adjusted.  Appearing only when compiled with
-                       $CONFIG_SND_DEBUG=y
-
-       STAC9200
-         ref           Reference board
-         dell-d21      Dell (unknown)
-         dell-d22      Dell (unknown)
-         dell-d23      Dell (unknown)
-         dell-m21      Dell Inspiron 630m, Dell Inspiron 640m
-         dell-m22      Dell Latitude D620, Dell Latitude D820
-         dell-m23      Dell XPS M1710, Dell Precision M90
-         dell-m24      Dell Latitude 120L
-         dell-m25      Dell Inspiron E1505n
-         dell-m26      Dell Inspiron 1501
-         dell-m27      Dell Inspiron E1705/9400
-
-       STAC9205/9254
-         ref           Reference board
-         dell-m42      Dell (unknown)
-         dell-m43      Dell Precision
-         dell-m44      Dell Inspiron
-
-       STAC9220/9221
-         ref           Reference board
-         3stack        D945 3stack
-         5stack        D945 5stack + SPDIF
-         intel-mac-v1  Intel Mac Type 1
-         intel-mac-v2  Intel Mac Type 2
-         intel-mac-v3  Intel Mac Type 3
-         intel-mac-v4  Intel Mac Type 4
-         intel-mac-v5  Intel Mac Type 5
-         macmini       Intel Mac Mini (equivalent with type 3)
-         macbook       Intel Mac Book (eq. type 5)
-         macbook-pro-v1 Intel Mac Book Pro 1st generation (eq. type 3)
-         macbook-pro   Intel Mac Book Pro 2nd generation (eq. type 3)
-         imac-intel    Intel iMac (eq. type 2)
-         imac-intel-20 Intel iMac (newer version) (eq. type 3)
-         dell-d81      Dell (unknown)
-         dell-d82      Dell (unknown)
-         dell-m81      Dell (unknown)
-         dell-m82      Dell XPS M1210
-
-       STAC9202/9250/9251
-         ref           Reference board, base config
-         m2-2          Some Gateway MX series laptops
-         m6            Some Gateway NX series laptops
-         pa6           Gateway NX860 series
-
-       STAC9227/9228/9229/927x
-         ref           Reference board
-         3stack        D965 3stack
-         5stack        D965 5stack + SPDIF
-         dell-3stack   Dell Dimension E520
-
-       STAC9872
-         vaio          Setup for VAIO FE550G/SZ110
-         vaio-ar Setup for VAIO AR
+    models depending on the codec chip.  The list of available models
+    is found in HD-Audio-Models.txt
 
     The model name "genric" is treated as a special case.  When this
     model is given, the driver uses the generic codec parser without
     "codec-patch".  It's sometimes good for testing and debugging.
 
     If the default configuration doesn't work and one of the above
-    matches with your device, report it together with the PCI
-    subsystem ID (output of "lspci -nv") to ALSA BTS or alsa-devel
+    matches with your device, report it together with alsa-info.sh
+    output (with --no-upload option) to kernel bugzilla or alsa-devel
     ML (see the section "Links and Addresses").
 
-    When CONFIG_SND_HDA_POWER_SAVE is set, two options, power_save and
-    power_save_controller become available.  power_save specifies the
-    time to turn off the power automatically at idle status.  When
-    power_save_controller is true, the controller is also turned off.
-    This might result in more obvious click noise at turning on/off.
+    power_save and power_save_controller options are for power-saving
+    mode.  See powersave.txt for details.
 
     Note 2: If you get click noises on output, try the module option
            position_fix=1 or 2.  position_fix=1 will use the SD_LPIB
            register value without FIFO size correction as the current
            DMA pointer.  position_fix=2 will make the driver to use
            the position buffer instead of reading SD_LPIB register.
-           (Usually SD_LPLIB register is more accurate than the
+           (Usually SD_LPIB register is more accurate than the
            position buffer.)
 
     NB: If you get many "azx_get_response timeout" messages at
@@ -1055,7 +808,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     This occurs when the access to non-existing or non-working codec slot
     (likely a modem one) causes a stall of the communication via HD-audio
     bus.  You can see which codec slots are probed by enabling
-    CONFIG_SND_DEBUG_DETECT, or simply from the file name of the codec
+    CONFIG_SND_DEBUG_VERBOSE, or simply from the file name of the codec
     proc files.  Then limit the slots to probe by probe_mask option.
     For example, probe_mask=1 means to probe only the first slot, and
     probe_mask=4 means only the third slot.
@@ -1093,6 +846,13 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     See hdspm.txt for details.
 
+  Module snd-hifier
+  -----------------
+
+    Module for the MediaTek/TempoTec HiFier Fantasia sound card.
+
+    This module supports autoprobe and multiple cards.
+
   Module snd-ice1712
   ------------------
 
@@ -1115,6 +875,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
                        * Event Electronics, EZ8
                         * Digigram VX442
                        * Lionstracs, Mediastaton
+                       * Terrasoniq TS 88
 
     model       - Use the given board model, one of the following:
                  delta1010, dio2496, delta66, delta44, audiophile, delta410,
@@ -1149,7 +910,10 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
                        * TerraTec Phase 22
                        * TerraTec Phase 28
                        * AudioTrak Prodigy 7.1
-                       * AudioTrak Prodigy 7.1LT
+                       * AudioTrak Prodigy 7.1 LT
+                       * AudioTrak Prodigy 7.1 XT
+                       * AudioTrak Prodigy 7.1 HIFI
+                       * AudioTrak Prodigy 7.1 HD2
                        * AudioTrak Prodigy 192
                        * Pontis MS300
                        * Albatron K8X800 Pro II 
@@ -1158,11 +922,18 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
                        * Chaintech 9CJS
                        * Chaintech AV-710
                        * Shuttle SN25P
+                       * Onkyo SE-90PCI
+                       * Onkyo SE-200PCI
+                       * ESI Juli@
+                       * Hercules Fortissimo IV
+                       * EGO-SYS WaveTerminal 192M
 
     model       - Use the given board model, one of the following:
                  revo51, revo71, amp2000, prodigy71, prodigy71lt,
-                 prodigy192, aureon51, aureon71, universe, ap192,
-                 k8x800, phase22, phase28, ms300, av710
+                 prodigy71xt, prodigy71hifi, prodigyhd2, prodigy192,
+                 juli, aureon51, aureon71, universe, ap192, k8x800,
+                 phase22, phase28, ms300, av710, se200pci, se90pci,
+                 fortissimo4, sn25p, WT192M
 
     This module supports multiple cards and autoprobe.
 
@@ -1201,7 +972,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     Module for AC'97 motherboards from Intel and compatibles.
                        * Intel i810/810E, i815, i820, i830, i84x, MX440
-                               ICH5, ICH6, ICH7, ESB2
+                               ICH5, ICH6, ICH7, 6300ESB, ESB2
                        * SiS 7012 (SiS 735)
                        * NVidia NForce, NForce2, NForce3, MCP04, CK804
                                 CK8, CK8S, MCP501
@@ -1259,15 +1030,19 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     Module for Gravis UltraSound PnP, Dynasonic 3-D/Pro, STB Sound Rage 32
     and other sound cards based on AMD InterWave (tm) chip.
   
-    port       - port # for InterWave chip (0x210,0x220,0x230,0x240,0x250,0x260)
-    irq                - IRQ # for InterWave chip (3,5,9,11,12,15)
-    dma1       - DMA # for InterWave chip (0,1,3,5,6,7)
-    dma2       - DMA # for InterWave chip (0,1,3,5,6,7,-1=disable)
     joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
     midi       - 1 = MIDI UART enable, 0 = MIDI UART disable (default)
     pcm_voices - reserved PCM voices for the synthesizer (default 2)
     effect     - 1 = InterWave effects enable (default 0);
                   requires 8 voices
+    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
+
+    with isapnp=0, the following options are available:
+
+    port       - port # for InterWave chip (0x210,0x220,0x230,0x240,0x250,0x260)
+    irq                - IRQ # for InterWave chip (3,5,9,11,12,15)
+    dma1       - DMA # for InterWave chip (0,1,3,5,6,7)
+    dma2       - DMA # for InterWave chip (0,1,3,5,6,7,-1=disable)
 
     This module supports multiple cards, autoprobe and ISA PnP.
 
@@ -1278,16 +1053,20 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     and other sound cards based on AMD InterWave (tm) chip with TEA6330T
     circuit for extended control of bass, treble and master volume.
   
-    port       - port # for InterWave chip (0x210,0x220,0x230,0x240,0x250,0x260)
-    port_tc    - tone control (i2c bus) port # for TEA6330T chip (0x350,0x360,0x370,0x380)
-    irq                - IRQ # for InterWave chip (3,5,9,11,12,15)
-    dma1       - DMA # for InterWave chip (0,1,3,5,6,7)
-    dma2       - DMA # for InterWave chip (0,1,3,5,6,7,-1=disable)
     joystick_dac - 0 to 31, (0.59V-4.52V or 0.389V-2.98V)
     midi       - 1 = MIDI UART enable, 0 = MIDI UART disable (default)
     pcm_voices - reserved PCM voices for the synthesizer (default 2)
     effect     - 1 = InterWave effects enable (default 0);
                   requires 8 voices
+    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
+
+    with isapnp=0, the following options are available:
+
+    port       - port # for InterWave chip (0x210,0x220,0x230,0x240,0x250,0x260)
+    port_tc    - tone control (i2c bus) port # for TEA6330T chip (0x350,0x360,0x370,0x380)
+    irq                - IRQ # for InterWave chip (3,5,9,11,12,15)
+    dma1       - DMA # for InterWave chip (0,1,3,5,6,7)
+    dma2       - DMA # for InterWave chip (0,1,3,5,6,7,-1=disable)
 
     This module supports multiple cards, autoprobe and ISA PnP.
 
@@ -1390,10 +1169,57 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     port       - port number or -1 (disable)
     irq                - IRQ number or -1 (disable)
     pnp                - PnP detection - 0 = disable, 1 = enable (default)
-    uart_enter - Issue UART_ENTER command at open - bool, default = on
 
     This module supports multiple devices and PnP.
     
+  Module snd-msnd-classic
+  -----------------------
+
+    Module for Turtle Beach MultiSound Classic, Tahiti or Monterey
+    soundcards.
+
+    io         - Port # for msnd-classic card
+    irq                - IRQ # for msnd-classic card
+    mem                - Memory address (0xb0000, 0xc8000, 0xd0000, 0xd8000,
+                 0xe0000 or 0xe8000)
+    write_ndelay - enable write ndelay (default = 1)
+    calibrate_signal - calibrate signal (default = 0)
+    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
+    digital    - Digital daughterboard present (default = 0)
+    cfg                - Config port (0x250, 0x260 or 0x270) default = PnP
+    reset      - Reset all devices
+    mpu_io     - MPU401 I/O port
+    mpu_irq    - MPU401 irq#
+    ide_io0    - IDE port #0
+    ide_io1    - IDE port #1
+    ide_irq    - IDE irq#
+    joystick_io        - Joystick I/O port
+
+    The driver requires firmware files "turtlebeach/msndinit.bin" and
+    "turtlebeach/msndperm.bin" in the proper firmware directory.
+
+    See Documentation/sound/oss/MultiSound for important information
+    about this driver.  Note that it has been discontinued, but the 
+    Voyetra Turtle Beach knowledge base entry for it is still available
+    at
+       http://www.turtlebeach.com/site/kb_ftp/790.asp
+
+  Module snd-msnd-pinnacle
+  ------------------------
+
+    Module for Turtle Beach MultiSound Pinnacle/Fiji soundcards.
+
+    io         - Port # for pinnacle/fiji card
+    irq                - IRQ # for pinnalce/fiji card
+    mem                - Memory address (0xb0000, 0xc8000, 0xd0000, 0xd8000,
+                 0xe0000 or 0xe8000)
+    write_ndelay - enable write ndelay (default = 1)
+    calibrate_signal - calibrate signal (default = 0)
+    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
+
+    The driver requires firmware files "turtlebeach/pndspini.bin" and
+    "turtlebeach/pndsperm.bin" in the proper firmware directory.
+
   Module snd-mtpav
   ----------------
 
@@ -1476,6 +1302,10 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     Module for Yamaha OPL3-SA2/SA3 sound cards.
 
+    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
+
+    with isapnp=0, the following options are available:
+
     port       - control port # for OPL3-SA chip (0x370)
     sb_port    - SB port # for OPL3-SA chip (0x220,0x240)
     wss_port   - WSS port # for OPL3-SA chip (0x530,0xe80,0xf40,0x604)
@@ -1484,7 +1314,6 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     irq                - IRQ # for OPL3-SA chip (5,7,9,10)
     dma1       - first DMA # for Yamaha OPL3-SA chip (0,1,3)
     dma2       - second DMA # for Yamaha OPL3-SA chip (0,1,3), -1 = disable
-    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
     
     This module supports multiple cards and ISA PnP.  It does not support
     autoprobe (if ISA PnP is not used) thus all ports must be specified!!!
@@ -1497,6 +1326,10 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     Module for sound cards based on OPTi 82c92x and Analog Devices AD1848 chips.
     Module works with OAK Mozart cards as well.
     
+    isapnp    - ISA PnP detection - 0 = disable, 1 = enable (default)
+
+    with isapnp=0, the following options are available:
+
     port      - port # for WSS chip (0x530,0xe80,0xf40,0x604)
     mpu_port  - port # for MPU-401 UART (0x300,0x310,0x320,0x330)
     fm_port   - port # for OPL3 device (0x388)
@@ -1511,6 +1344,10 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     Module for sound cards based on OPTi 82c92x and Crystal CS4231 chips.
     
+    isapnp    - ISA PnP detection - 0 = disable, 1 = enable (default)
+
+    with isapnp=0, the following options are available:
+
     port      - port # for WSS chip (0x530,0xe80,0xf40,0x604)
     mpu_port  - port # for MPU-401 UART (0x300,0x310,0x320,0x330)
     fm_port   - port # for OPL3 device (0x388)
@@ -1526,6 +1363,10 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     Module for sound cards based on OPTi 82c93x chips.
     
+    isapnp    - ISA PnP detection - 0 = disable, 1 = enable (default)
+
+    with isapnp=0, the following options are available:
+
     port      - port # for WSS chip (0x530,0xe80,0xf40,0x604)
     mpu_port  - port # for MPU-401 UART (0x300,0x310,0x320,0x330)
     fm_port   - port # for OPL3 device (0x388)
@@ -1536,6 +1377,31 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     This module supports only one card, autoprobe and PnP.
 
+  Module snd-oxygen
+  -----------------
+
+    Module for sound cards based on the C-Media CMI8788 chip:
+    * Asound A-8788
+    * AuzenTech X-Meridian
+    * Bgears b-Enspirer
+    * Club3D Theatron DTS
+    * HT-Omega Claro (plus)
+    * HT-Omega Claro halo (XT)
+    * Razer Barracuda AC-1
+    * Sondigo Inferno
+
+    This module supports autoprobe and multiple cards.
+
+  Module snd-pcsp
+  -----------------
+
+    Module for internal PC-Speaker.
+
+    nforce_wa  - enable NForce chipset workaround. Expect bad sound.
+
+    This module supports system beeps, some kind of PCM playback and
+    even a few mixer controls.
+
   Module snd-pcxhr
   ----------------
 
@@ -1650,6 +1516,12 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
                                          SoundBlaster AWE 32 (PnP),
                                          SoundBlaster AWE 64 PnP
 
+    mic_agc    - Mic Auto-Gain-Control - 0 = disable, 1 = enable (default)
+    csp                - ASP/CSP chip support - 0 = disable (default), 1 = enable
+    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
+
+    with isapnp=0, the following options are available:
+
     port       - port # for SB DSP 4.x chip (0x220,0x240,0x260)
     mpu_port   - port # for MPU-401 UART (0x300,0x330), -1 = disable
     awe_port   - base port # for EMU8000 synthesizer (0x620,0x640,0x660)
@@ -1657,9 +1529,6 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     irq                - IRQ # for SB DSP 4.x chip (5,7,9,10)
     dma8       - 8-bit DMA # for SB DSP 4.x chip (0,1,3)
     dma16      - 16-bit DMA # for SB DSP 4.x chip (5,6,7)
-    mic_agc    - Mic Auto-Gain-Control - 0 = disable, 1 = enable (default)
-    csp                - ASP/CSP chip support - 0 = disable (default), 1 = enable
-    isapnp     - ISA PnP detection - 0 = disable, 1 = enable (default)
     
     This module supports multiple cards, autoprobe and ISA PnP.
 
@@ -1742,18 +1611,21 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     Module for Turtle Beach Maui, Tropez and Tropez+ sound cards.
 
+    use_cs4232_midi - Use CS4232 MPU-401 interface
+                      (inaccessibly located inside your computer)
+    isapnp          - ISA PnP detection - 0 = disable, 1 = enable (default)
+
+    with isapnp=0, the following options are available:
+
     cs4232_pcm_port - Port # for CS4232 PCM interface.
     cs4232_pcm_irq  - IRQ # for CS4232 PCM interface (5,7,9,11,12,15).
     cs4232_mpu_port - Port # for CS4232 MPU-401 interface.
     cs4232_mpu_irq  - IRQ # for CS4232 MPU-401 interface (9,11,12,15).
-    use_cs4232_midi - Use CS4232 MPU-401 interface
-                      (inaccessibly located inside your computer)
     ics2115_port    - Port # for ICS2115
     ics2115_irq     - IRQ # for ICS2115
     fm_port         - FM OPL-3 Port #
     dma1            - DMA1 # for CS4232 PCM interface.
     dma2            - DMA2 # for CS4232 PCM interface.
-    isapnp          - ISA PnP detection - 0 = disable, 1 = enable (default)
 
     The below are options for wavefront_synth features:
     wf_raw         - Assume that we need to boot the OS (default:no)
@@ -1845,6 +1717,8 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
                        * CHIC  True Sound 4Dwave
                        * Shark  Predator4D-PCI
                        * Jaton  SonicWave 4D
+                       * SiS SI7018 PCI Audio
+                       * Hoontech SoundTrack Digital 4DWave NX
 
     pcm_channels   - max channels (voices) reserved for PCM
     wavetable_size - max wavetable size in kB (4-?kb)
@@ -1860,12 +1734,25 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
 
     vid             - Vendor ID for the device (optional)
     pid             - Product ID for the device (optional)
+    nrpacks        - Max. number of packets per URB (default: 8)
+    async_unlink    - Use async unlink mode (default: yes)
     device_setup    - Device specific magic number (optional)
                     - Influence depends on the device
                     - Default: 0x0000 
+    ignore_ctl_error - Ignore any USB-controller regarding mixer
+                      interface (default: no)
 
     This module supports multiple devices, autoprobe and hotplugging.
 
+    NB: nrpacks parameter can be modified dynamically via sysfs.
+        Don't put the value over 20.  Changing via sysfs has no sanity
+       check.
+    NB: async_unlink=0 would cause Oops.  It remains just for
+        debugging purpose (if any).
+    NB: ignore_ctl_error=1 may help when you get an error at accessing
+        the mixer element such as URB error -22.  This happens on some
+        buggy USB device or the controller.
+
   Module snd-usb-caiaq
   --------------------
 
@@ -1968,6 +1855,14 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
     
     This module supports multiple cards.
 
+  Module snd-virtuoso
+  -------------------
+
+    Module for sound cards based on the Asus AV100/AV200 chips,
+    i.e., Xonar D1, DX, D2, D2X, HDAV1.3 (Deluxe), and Essence STX.
+
+    This module supports autoprobe and multiple cards.
+
   Module snd-vx222
   ----------------
 
@@ -2138,6 +2033,27 @@ alias sound-slot-1 snd-ens1371
 In this example, the interwave card is always loaded as the first card
 (index 0) and ens1371 as the second (index 1).
 
+Alternative (and new) way to fixate the slot assignment is to use
+"slots" option of snd module.  In the case above, specify like the
+following: 
+
+options snd slots=snd-interwave,snd-ens1371
+
+Then, the first slot (#0) is reserved for snd-interwave driver, and
+the second (#1) for snd-ens1371.  You can omit index option in each
+driver if slots option is used (although you can still have them at
+the same time as long as they don't conflict).
+
+The slots option is especially useful for avoiding the possible
+hot-plugging and the resultant slot conflict.  For example, in the
+case above again, the first two slots are already reserved.  If any
+other driver (e.g. snd-usb-audio) is loaded before snd-interwave or
+snd-ens1371, it will be assigned to the third or later slot.
+
+When a module name is given with '!', the slot will be given for any
+modules but that name.  For example, "slots=!snd-pcsp" will reserve
+the first slot for any modules but snd-pcsp. 
+
 
 ALSA PCM devices to OSS devices mapping
 =======================================
@@ -2227,8 +2143,11 @@ Links and Addresses
   ALSA project homepage
        http://www.alsa-project.org
 
-  ALSA Bug Tracking System
-       https://bugtrack.alsa-project.org/bugs/
+  Kernel Bugzilla
+       http://bugzilla.kernel.org/
 
   ALSA Developers ML
        mailto:alsa-devel@alsa-project.org
+
+  alsa-info.sh script
+       http://www.alsa-project.org/alsa-info.sh