Documentation/sound/alsa-configuration.rst

29 Module parameters
32 The user can load modules with options. If the module supports more than
37 Module snd
40 The core ALSA module.  It is used by all ALSA card drivers.
54     See `Module Autoloading Support`_ section for details.
63 Module snd-pcm-oss
66 The PCM OSS emulation module.
67 This module takes options which change the mapping of devices.
90 Module snd-rawmidi
93 This module takes options which change the mapping of devices.
94 similar to those of the snd-pcm-oss module.
106 Each of top level sound card module takes the following options.
127 Module snd-adlib
130 Module for AdLib FM cards.
135 This module supports multiple cards. It does not support autoprobe, so
141 after loading the module, find out the assigned ALSA sequencer port
161 Module snd-ad1816a
164 Module for sound cards based on Analog Devices AD1816A/AD1815 ISA chips.
169 This module supports multiple cards, autoprobe and PnP.
171 Module snd-ad1848
174 Module for sound cards based on AD1848/AD1847/CS4248 ISA chips.
183 This module supports multiple cards.  It does not support autoprobe
188 Module snd-ad1889
191 Module for Analog Devices AD1889 chips.
195     See the description of intel8x0 module for details.
197 This module supports multiple cards.
199 Module snd-ali5451
202 Module for ALi M5451 PCI chip.
210 This module supports one chip and autoprobe.
214 Module snd-als100
217 Module for sound cards based on Avance Logic ALS100/ALS120 ISA chips.
219 This module supports multiple cards, autoprobe and PnP.
223 Module snd-als300
226 Module for Avance Logic ALS300 and ALS300+
228 This module supports multiple cards.
232 Module snd-als4000
235 Module for sound cards based on Avance Logic ALS4000 PCI chip.
241 This module supports multiple cards, autoprobe and PnP.
245 Module snd-asihpi
248 Module for AudioScience ASI soundcards
253 This module supports multiple cards.
256 Module snd-atiixp
259 Module for ATI IXP 150/200/250/400 AC97 controllers.
274 This module supports one card and autoprobe.
279 choose the correct one via spdif_aclink module option.
283 Module snd-atiixp-modem
286 Module for ATI IXP 150/200/250 AC97 modem controllers.
288 This module supports one card and autoprobe.
290 Note: The default index value of this module is -2, i.e. the first
295 Module snd-au8810, snd-au8820, snd-au8830
298 Module for Aureal Vortex, Vortex2 and Advantage device.
309 This module supports all ADB PCM channels, ac97 mixer, SPDIF, hardware
322 Module snd-azt1605
325 Module for Aztech Sound Galaxy soundcards based on the Aztech AZT1605
345 This module supports multiple cards. It does not support autoprobe:
364 Module snd-azt2316
367 Module for Aztech Sound Galaxy soundcards based on the Aztech AZT2316
387 This module supports multiple cards. It does not support autoprobe:
406 Module snd-aw2
409 Module for Audiowerk2 sound card
411 This module supports multiple cards.
413 Module snd-azt2320
416 Module for sound cards based on Aztech System AZT2320 ISA chip (PnP only).
418 This module supports multiple cards, PnP and autoprobe.
422 Module snd-azt3328
425 Module for sound cards based on Aztech AZF3328 PCI chip.
430 This module supports multiple cards.
432 Module snd-bt87x
435 Module for video cards based on Bt87x chips.
442 This module supports multiple cards.
444 Note: The default index value of this module is -2, i.e. the first
447 Module snd-ca0106
450 Module for Creative Audigy LS and SB Live 24bit
452 This module supports multiple cards.
455 Module snd-cmi8330
458 Module for sound cards based on C-Media CMI8330 ISA chips.
486 This module supports multiple cards and autoprobe.
490 Module snd-cmipci
493 Module for C-Media CMI8338/8738/8768/8770 PCI sound cards.
510 This module supports autoprobe and multiple cards.
514 Module snd-cs4231
517 Module for sound cards based on CS4231 ISA chips.
532 This module supports multiple cards. This module does not support autoprobe
537 Module snd-cs4236
540 Module for sound cards based on CS4232/CS4232A,
565 This module supports multiple cards. This module does not support autoprobe
571 This module is aliased as snd-cs4232 since it provides the old
574 Module snd-cs4281
577 Module for Cirrus Logic CS4281 soundchip.
582 This module supports multiple cards.
586 Module snd-cs46xx
589 Module for PCI sound cards based on CS4610/CS4612/CS4614/CS4615/CS4622/
599 This module supports multiple cards and autoprobe.
606 Module snd-cs5530
609 Module for Cyrix/NatSemi Geode 5530 chip.
611 Module snd-cs5535audio
614 Module for multifunction CS5535 companion PCI device
618 Module snd-ctxfi
621 Module for Creative Sound Blaster X-Fi boards (20k1 / 20k2 chips)
642 This module supports multiple cards.
644 Module snd-darla20
647 Module for Echoaudio Darla20
649 This module supports multiple cards.
652 Module snd-darla24
655 Module for Echoaudio Darla24
657 This module supports multiple cards.
660 Module snd-dt019x
663 Module for Diamond Technologies DT-019X / Avance Logic ALS-007 (PnP
666 This module supports multiple cards.  This module is enabled only with
671 Module snd-dummy
674 Module for the dummy sound card. This "card" doesn't do any output
675 or input, but you may use this module for any application which
702 Module snd-echo3g
705 Module for Echoaudio 3G cards (Gina3G/Layla3G)
707 This module supports multiple cards.
710 Module snd-emu10k1
713 Module for EMU10K1/EMU10k2 based PCI sound cards.
734 This module supports multiple cards and autoprobe.
752 Module snd-emu10k1x
755 Module for Creative Emu10k1X (SB Live Dell OEM version)
757 This module supports multiple cards.
759 Module snd-ens1370
762 Module for Ensoniq AudioPCI ES1370 PCI sound cards.
770 This module supports multiple cards and autoprobe.
774 Module snd-ens1371
777 Module for Ensoniq AudioPCI ES1371 PCI sound cards.
787 This module supports multiple cards and autoprobe.
791 Module snd-es1688
794 Module for ESS AudioDrive ES-1688 and ES-688 sound cards.
814 This module supports multiple cards and autoprobe (without MPU-401 port)
817 Module snd-es18xx
820 Module for ESS AudioDrive ES-18xx sound cards.
840 This module supports multiple cards, ISA PnP and autoprobe (without MPU-401
846 Module snd-es1938
849 Module for sound cards based on ESS Solo-1 (ES1938,ES1946) chips.
851 This module supports multiple cards and autoprobe.
855 Module snd-es1968
858 Module for sound cards based on ESS Maestro-1/2/2E (ES1968/ES1978) chips.
875 This module supports multiple cards and autoprobe.
879 Module snd-fm801
882 Module for ForteMedia FM801 based PCI sound cards.
892 This module supports multiple cards and autoprobe.
896 Module snd-gina20
899 Module for Echoaudio Gina20
901 This module supports multiple cards.
904 Module snd-gina24
907 Module for Echoaudio Gina24
909 This module supports multiple cards.
912 Module snd-gusclassic
915 Module for Gravis UltraSound Classic sound card.
932 This module supports multiple cards and autoprobe.
934 Module snd-gusextreme
937 Module for Gravis UltraSound Extreme (Synergy ViperMax) sound card.
962 This module supports multiple cards and autoprobe (without MPU-401 port).
964 Module snd-gusmax
967 Module for Gravis UltraSound MAX sound card.
984 This module supports multiple cards and autoprobe.
986 Module snd-hda-intel
989 Module for Intel HD Audio (ICH6, ICH6M, ESB2, ICH7, ICH8, ICH9, ICH10,
1047 This module supports multiple cards and autoprobe.
1070 Note 2: If you get click noises on output, try the module option
1086 can try ``single_cmd=1`` module option.  This will switch the
1107 Module snd-hdsp
1110 Module for RME Hammerfall DSP audio interface(s)
1112 This module supports multiple cards.
1120 Note: snd-page-alloc module does the job which snd-hammerfall-mem
1121 module did formerly.  It will allocate the buffers in advance
1123 allocation sure, load snd-page-alloc module in the early
1127 Module snd-hdspm
1130 Module for RME HDSP MADI board.
1141 Module snd-ice1712
1144 Module for Envy24 (ICE1712) based PCI sound cards.
1178 This module supports multiple cards and autoprobe.
1184 model by passing ``model`` module option in case that the
1188 Module snd-ice1724
1191 Module for Envy24HT (VT/ICE1724), Envy24PT (VT1720) based PCI sound cards.
1230 This module supports multiple cards and autoprobe.
1234 model by passing ``model`` module option in case that the
1238 Module snd-indigo
1241 Module for Echoaudio Indigo
1243 This module supports multiple cards.
1246 Module snd-indigodj
1249 Module for Echoaudio Indigo DJ
1251 This module supports multiple cards.
1254 Module snd-indigoio
1257 Module for Echoaudio Indigo IO
1259 This module supports multiple cards.
1262 Module snd-intel8x0
1265 Module for AC'97 motherboards from Intel and compatibles.
1289 This module supports one chip and autoprobe.
1293 explicitly via the module option ``ac97_clock=41194``.
1301 Module snd-intel8x0m
1304 Module for Intel ICH (i8x0) chipset MC97 modems.
1315 This module supports one card and autoprobe.
1317 Note: The default index value of this module is -2, i.e. the first
1322 Module snd-interwave
1325 Module for Gravis UltraSound PnP, Dynasonic 3-D/Pro, STB Sound Rage 32
1350 This module supports multiple cards, autoprobe and ISA PnP.
1352 Module snd-interwave-stb
1355 Module for UltraSound 32-Pro (sound card from STB used by Compaq)
1383 This module supports multiple cards, autoprobe and ISA PnP.
1385 Module snd-jazz16
1388 Module for Media Vision Jazz16 chipset. The chipset consists of 3 chips:
1404 This module supports multiple cards.
1406 Module snd-korg1212
1409 Module for Korg 1212 IO PCI card
1411 This module supports multiple cards.
1413 Module snd-layla20
1416 Module for Echoaudio Layla20
1418 This module supports multiple cards.
1421 Module snd-layla24
1424 Module for Echoaudio Layla24
1426 This module supports multiple cards.
1429 Module snd-lola
1432 Module for Digigram Lola PCI-e boards
1434 This module supports multiple cards.
1436 Module snd-lx6464es
1439 Module for Digigram LX6464ES boards
1441 This module supports multiple cards.
1443 Module snd-maestro3
1446 Module for Allegro/Maestro3 chips
1454 This module supports autoprobe and multiple chips.
1464 Module snd-mia
1467 Module for Echoaudio Mia
1469 This module supports multiple cards.
1472 Module snd-miro
1475 Module for Miro soundcards: miroSOUND PCM 1 pro, miroSOUND PCM 12,
1497 Module snd-mixart
1500 Module for Digigram miXart8 sound cards.
1502 This module supports multiple cards.
1506 When the driver is compiled as a module and the hotplug firmware
1512 Module snd-mona
1515 Module for Echoaudio Mona
1517 This module supports multiple cards.
1520 Module snd-mpu401
1523 Module for MPU-401 UART devices.
1532 This module supports multiple devices and PnP.
1534 Module snd-msnd-classic
1537 Module for Turtle Beach MultiSound Classic, Tahiti or Monterey
1580 Module snd-msnd-pinnacle
1583 Module for Turtle Beach MultiSound Pinnacle/Fiji soundcards.
1601 Module snd-mtpav
1604 Module for MOTU MidiTimePiece AV multiport MIDI (on the parallel
1614 Module supports only 1 card.  This module has no enable option.
1616 Module snd-mts64
1619 Module for Ego Systems (ESI) Miditerminal 4140
1621 This module supports multiple devices.
1624 Module snd-nm256
1627 Module for NeoMagic NM256AV/ZX chips
1646 This module supports one chip and autoprobe.
1684 the module, but it may result in hang-up.   Hence, make sure that
1685 you load this module *before* X if you encounter this kind of
1688 Module snd-opl3sa2
1691 Module for Yamaha OPL3-SA2/SA3 sound cards.
1715 This module supports multiple cards and ISA PnP.  It does not support
1720 Module snd-opti92x-ad1848
1723 Module for sound cards based on OPTi 82c92x and Analog Devices AD1848 chips.
1724 Module works with OAK Mozart cards as well.
1744 This module supports only one card, autoprobe and PnP.
1746 Module snd-opti92x-cs4231
1749 Module for sound cards based on OPTi 82c92x and Crystal CS4231 chips.
1771 This module supports only one card, autoprobe and PnP.
1773 Module snd-opti93x
1776 Module for sound cards based on OPTi 82c93x chips.
1798 This module supports only one card, autoprobe and PnP.
1800 Module snd-oxygen
1803 Module for sound cards based on the C-Media CMI8786/8787/8788 chip:
1819 This module supports autoprobe and multiple cards.
1821 Module snd-pcsp
1824 Module for internal PC-Speaker.
1831 This module supports system beeps, some kind of PCM playback and
1834 Module snd-pcxhr
1837 Module for Digigram PCXHR boards
1839 This module supports multiple cards.
1841 Module snd-portman2x4
1844 Module for Midiman Portman 2x4 parallel port MIDI interface
1846 This module supports multiple cards.
1848 Module snd-powermac (on ppc only)
1851 Module for PowerMac, iMac and iBook on-board soundchips
1856 Module supports autoprobe a chip.
1862 Module snd-pxa2xx-ac97 (on arm only)
1865 Module for AC97 driver for the Intel PXA2xx chip
1871 Module snd-riptide
1874 Module for Conexant Riptide chip
1883 This module supports multiple cards.
1888 Module snd-rme32
1891 Module for RME Digi32, Digi32 Pro and Digi32/8 (Sek'd Prodif32,
1894 This module supports multiple cards.
1896 Module snd-rme96
1899 Module for RME Digi96, Digi96/8 and Digi96/8 PRO/PAD/PST sound cards.
1901 This module supports multiple cards.
1903 Module snd-rme9652
1906 Module for RME Digi9652 (Hammerfall, Hammerfall-Light) sound cards.
1911 This module supports multiple cards.
1913 Note: snd-page-alloc module does the job which snd-hammerfall-mem
1914 module did formerly.  It will allocate the buffers in advance
1916 allocation sure, load snd-page-alloc module in the early
1920 Module snd-sa11xx-uda1341 (on arm only)
1923 Module for Philips UDA1341TS on Compaq iPAQ H3600 sound card.
1925 Module supports only one card.
1926 Module has no enable and index options.
1930 Module snd-sb8
1933 Module for 8-bit SoundBlaster cards: SoundBlaster 1.0, SoundBlaster 2.0,
1943 This module supports multiple cards and autoprobe.
1947 Module snd-sb16 and snd-sbawe
1950 Module for 16-bit SoundBlaster cards: SoundBlaster 16 (PnP),
1968     module only)
1976 This module supports multiple cards, autoprobe and ISA PnP.
1979 disable 16bit DMA with dma16 = -1 module parameter.
1986 Module snd-sc6000
1989 Module for Gallant SC-6000 soundcard and later models: SC-6600 and
2005 This module supports multiple cards.
2009 Module snd-sscape
2012 Module for ENSONIQ SoundScape cards.
2029 This module supports multiple cards.
2033 Module snd-sun-amd7930 (on sparc only)
2036 Module for AMD7930 sound chips found on Sparcs.
2038 This module supports multiple cards.
2040 Module snd-sun-cs4231 (on sparc only)
2043 Module for CS4231 sound chips found on Sparcs.
2045 This module supports multiple cards.
2047 Module snd-sun-dbri (on sparc only)
2050 Module for DBRI sound chips found on Sparcs.
2052 This module supports multiple cards.
2054 Module snd-wavefront
2057 Module for Turtle Beach Maui, Tropez and Tropez+ sound cards.
2128 This module supports multiple cards and ISA PnP.
2136 Module snd-sonicvibes
2139 Module for S3 SonicVibes PCI sound cards.
2148 This module supports multiple cards and autoprobe.
2150 Module snd-serial-u16550
2153 Module for UART16550A serial MIDI ports.
2173 This module supports multiple cards. This module does not support autoprobe
2176 Module snd-trident
2179 Module for Trident 4DWave DX/NX sound cards.
2196 This module supports multiple cards and autoprobe.
2200 Module snd-ua101
2203 Module for the Edirol UA-101/UA-1000 audio/MIDI interfaces.
2205 This module supports multiple devices, autoprobe and hotplugging.
2207 Module snd-usb-audio
2210 Module for USB audio and USB MIDI devices.
2251 This module supports multiple devices, autoprobe and hotplugging.
2265 Module snd-usb-caiaq
2268 Module for caiaq UB audio interfaces,
2275 This module supports multiple devices, autoprobe and hotplugging.
2277 Module snd-usb-usx2y
2280 Module for Tascam USB US-122, US-224 and US-428 devices.
2282 This module supports multiple devices, autoprobe and hotplugging.
2287 Module snd-via82xx
2290 Module for AC'97 motherboards based on VIA 82C686A/686B, 8233, 8233A,
2308 This module supports one chip and autoprobe.
2345 Module snd-via82xx-modem
2348 Module for VIA82xx AC97 modem
2353 This module supports one card and autoprobe.
2355 Note: The default index value of this module is -2, i.e. the first
2360 Module snd-virmidi
2363 Module for virtual rawmidi devices.
2364 This module creates virtual rawmidi devices which communicate
2370 This module supports multiple cards.
2372 Module snd-virtuoso
2375 Module for sound cards based on the Asus AV66/AV100/AV200 chips,
2379 This module supports autoprobe and multiple cards.
2381 Module snd-vx222
2384 Module for Digigram VX-Pocket VX222, V222 v2 and Mic cards.
2391 This module supports multiple cards.
2393 When the driver is compiled as a module and the hotplug firmware
2415 Module snd-vxpocket
2418 Module for Digigram VX-Pocket VX2 and 440 PCMCIA cards.
2423 This module supports multiple cards.  The module is compiled only when
2431 When the driver is compiled as a module and the hotplug firmware
2437 About capture IBL, see the description of snd-vx222 module.
2444 Module snd-ymfpci
2447 Module for Yamaha PCI chips (YMF72x, YMF74x & YMF75x).
2461 This module supports autoprobe and multiple chips.
2465 Module snd-pdaudiocf
2468 Module for Sound Core PDAudioCF sound card.
2511 but only ``Headphone`` does, pass ac97_quirk=hp_only module option.
2518 supporting the isapnp cards will have module options ``isapnp``.
2527 Module Autoloading Support
2531 module aliases.  The string ``snd-card-%1`` is requested for ALSA native
2537 as the same card module.
2547 The available number of auto-loaded sound cards depends on the module
2548 option ``cards_limit`` of snd module.  As default it's set to 1.
2553 number for each card via module option, too, so that the order of
2575 ``slots`` option of snd module.  In the case above, specify like the
2592 When a module name is given with '!', the slot will be given for any
2616 Please note that the device mapping above may be varied via the module
2617 options of snd-pcm-oss module.
2670 sometimes it's too late to find such spaces when the driver module is
2672 PCM buffers by loading snd-page-alloc module and write commands to its