alsa-configuration.txt

优龙2410linux2.6.8内核源代码

		Advanced Linux Sound Architecture - Driver
		==========================================
			    Configuration guide


Kernel Configuration
====================

To enable the ALSA support, at least you need to build the kernel with
the primary sound card support (CONFIG_SOUND).  Since ALSA can emulate
the OSS, you don't have to choose any of the OSS/Free modules.  Please
enable "OSS API emulation" (CONFIG_SND_OSSEMUL) and both OSS mixer and
PCM supports if you want to run the OSS application with the ALSA.

When you want to support the WaveTable functionality on some cards
such like SB Live!, you need to enable "Sequencer support"
(CONFIG_SND_SEQUENCER).

For getting more verbose debug messages, turn on "Verbose printk" and
"Debug" options.  For checking the memory leaks, you can turn on
"Debug memory" option, too.  "Debug detection" will put more
additional checks for the detection of cards.

Please note that all the ALSA ISA drivers support Linux isapnp API (if
the card supports).  You don't need to configure the PnP via
isapnptools.


Creating ALSA devices
=====================

Use the /dev/MAKEDEV script to create the nessecary device nodes.


Module parameters
=================

  A user can modify or set parameters at the load time of the module. If
  the module supports more cards and you have got more than one card
  of the same type, you may simply specify more values for the parameter,
  delimited by commas.
  
  Note that module option names were changed in 0.9.0rc4. The 'snd_'
  prefix was removed.

  Module snd
  ----------

    The module snd is the ALSA core module, which is used by all ALSA
    card drivers.  This takes the global options for creating devices,
    etc.

    major	- major # for sound driver
		- default is 116
    cards_limit
		- specifies card limit # for auto-loading (1-8)
		- default is 1
		- for auto-loading more than 1 card, specify this option
		  together with snd-card-X aliases.
    device_mode
		- specifies permission mask for dynamic sound device filesystem
		  (available only when DEVFS is enabled)
		- default value = 0666
		- for example 'device_mode=0660'

  
  Module snd-pcm-oss
  ------------------

    The PCM OSS emulation module.
    This module takes the options to change the mapping of devices.

    dsp_map	- PCM device number maps assigned to the 1st OSS device.
		  (default: 0)
    adsp_map	- PCM device number maps assigned to the 2st OSS device.
		  (default: 1)
    nonblock_open - Don't block opening busy PCM devices.

    For example, when dsp_map=2, /dev/dsp will be mapped to PCM #2 of
    the card #0.  Similarly, when adsp_map=0, /dev/adsp will be mapped
    to PCM #0 of the card #0.
    For changing the second or later card, specify the option with
    commas, such like "dsp_map=0,1".

    nonblock_open option is used to change the behavior of the PCM
    regarding opening the device.  When this option is non-zero,
    opening a busy OSS PCM device won't be blocked but return
    immediately with EAGAIN (just like O_NONBLOCK flag).
    
  Module snd-rawmidi
  ------------------

    This module takes the options to change the mapping of OSS
    devices like snd-pcm-oss module.

    midi_map	- MIDI device number maps assigned to the 1st OSS device.
		  (default: 0)
    amidi_map	- MIDI device number maps assigned to the 2st OSS device.
		  (default: 1)

  Common parameters for top soundcard modules
  -------------------------------------------

    Each of top-level soundcard module takes some general options,

    index	- 0-7 - index (slot #) for soundcard
                - if not set or -1, first free index (slot #) is assigned
    id		- user identification for card (up to 15 chars)
		- default expression is 'card<index>' (for example card1)
		- value is used for /proc/asound filesystem
		- this value can be used by applications for identification
		  of card if user does not want identify card with index number
    enable  	- enable card.  (all cards enabled for PCI and ISA PnP cards
		  as default.)

  Module snd-ad1816a
  ------------------

    Module for soundcards 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)
    
    Module supports up to 8 cards, autoprobe and PnP.
    
  Module snd-ad1848
  -----------------

    Module for soundcards based on AD1848/AD1847/CS4248 ISA chips.

    port	- port # for AD1848 chip
    irq		- IRQ # for AD1848  chip
    dma1	- DMA # for AD1848 chip (0,1,3)
    
    Module supports up to 8 cards. This module does not support autoprobe
    thus main port must be specified!!! Other ports are optional.
    
  Module snd-ali5451
  ------------------

    Module for ALi M5451 PCI chip.

    pcm_channels    - Number of hardware channels assigned for PCM
    spdif           - Support SPDIF I/O (disabled by default)

    Module supports autoprobe and multiple chips (max 8).

    The power-management is supported.

  Module snd-als100
  -----------------

    Module for soundcards 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)
    
    Module supports up to 8 cards, autoprobe and PnP.

  Module snd-als4000
  ------------------

    Module for soundcards based on Avance Logic ALS4000 PCI chip.

    joystick_port - port # for legacy joystick support.
                    0 = disabled (default), 1 = auto-detect
    
    Module supports up to 8 cards, autoprobe and PnP.

  Module snd-atiixp
  -----------------

    Module for ATI IXP 150/200/250 AC97 controllers.

    ac97_clock		- AC'97 clock (defalut = 48000)
    spdif_aclink	- S/PDIF transfer over AC-link (default = 1)

    This module supports up to 8 cards and autoprobe.

  Module snd-au8810, snd-au8820, snd-au8830
  -----------------------------------------

    Module for Aureal Vortex, Vortex2 and Advantage device.

    pcifix	- Control PCI workarounds
		  0 = Disable all workarounds
		  1 = Force the PCI latency of the Aureal card to 0xff
		  2 = Force the Extend PCI#2 Internal Master for Efficient
		      Handling of Dummy Requests on the VIA KT133 AGP Bridge
		  3 = Force both settings
		  255 = Autodetect what is required (default)

    This module supports all ADB PCM channels, ac97 mixer, SPDIF, hardware
    EQ, mpu401, gameport. A3D and wavetable support are still in development.
    Development and reverse engineering work is being coordinated at
    http://savannah.nongnu.org/projects/openvortex/
    SPDIF output has a copy of the AC97 codec output, unless you use the
    "spdif" pcm device, which allows raw data passthru.
    The hardware EQ hardware and SPDIF is only present in the Vortex2 and 
    Advantage.

    Note: Some ALSA mixer applicactions don't handle the SPDIF samplerate 
           control correctly. If you have problems regarding this, try
           another ALSA compliant mixer (alsamixer works).

  Module snd-azt2320
  ------------------

    Module for soundcards 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)
    
    Module supports up to 8 cards, PnP and autoprobe.
    
  Module snd-azt3328
  ------------------

    Module for soundcards based on Aztech AZF3328 PCI chip.

    joystick	- Enable joystick (default off)

    Module supports up to 8 cards.

  Module snd-bt87x
  ----------------

    Module for video cards based on Bt87x chips.

    digital_rate - Override the default digital rate (Hz)

    Module supports up to 8 cards.

  Module snd-cmi8330
  ------------------

    Module for soundcards based on C-Media CMI8330 ISA chips.

    wssport	- port # for CMI8330 chip (WSS)
    wssirq	- IRQ # for CMI8330 chip (WSS)
    wssdma	- first DMA # for CMI8330 chip (WSS)
    sbport	- port # for CMI8330 chip (SB16)
    sbirq	- IRQ # for CMI8330 chip (SB16)
    sbdma8	- 8bit DMA # for CMI8330 chip (SB16)
    sbdma16	- 16bit DMA # for CMI8330 chip (SB16)

    Module supports up to 8 cards and autoprobe.

  Module snd-cmipci
  -----------------

    Module for C-Media CMI8338 and 8738 PCI soundcards.

    mpu_port	- 0x300,0x310,0x320,0x330, 0 = disable (default)
    fm_port     - 0x388 (default), 0 = disable (default)
    soft_ac3    - Sofware-conversion of raw SPDIF packets (model 033 only)
                  (default = 1)
    joystick_port - Joystick port address (0 = disable, 1 = auto-detect)

    Module supports autoprobe and multiple chips (max 8).
    
  Module snd-cs4231
  -----------------

    Module for soundcards based on CS4231 ISA chips.

    port	- port # for CS4231 chip
    mpu_port	- port # for MPU-401 UART (optional), -1 = disable
    irq		- IRQ # for CS4231 chip
    mpu_irq	- IRQ # for MPU-401 UART
    dma1	- first DMA # for CS4231 chip
    dma2	- second DMA # for CS4231 chip
    
    Module supports up to 8 cards. This module does not support autoprobe
    thus main port must be specified!!! Other ports are optional.

    The power-management is supported.
    
  Module snd-cs4232
  -----------------

    Module for soundcards based on CS4232/CS4232A 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)
    
    Module supports up to 8 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 soundcards based on CS4235/CS4236/CS4236B/CS4237B/
                                   CS4238B/CS4239 ISA chips.

    port	- port # for CS4236 chip (PnP setup - 0x534)
    cport	- control port # for CS4236 chip (PnP setup - 0x120,0x210,0xf00)
    mpu_port	- port # for MPU-401 UART (PnP setup - 0x300), -1 = disable
    fm_port	- FM port # for CS4236 chip (PnP setup - 0x388), -1 = disable
    irq		- IRQ # for CS4236 chip (5,7,9,11,12,15)
    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)
    
    Module supports up to 8 cards. This module does not support autoprobe
    (if ISA PnP is not used) thus main port and control port must be
    specified!!! Other ports are optional.

    The power-management is supported.

  Module snd-cs4281
  -----------------

    Module for Cirrus Logic CS4281 soundchip.

    dual_codec	- Secondary codec ID (0 = disable, default)

    Module supports up to 8 cards.

    The power-management is supported.

  Module snd-cs46xx