aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorTakashi Iwai <tiwai@suse.de>2005-09-05 11:12:29 -0400
committerJaroslav Kysela <perex@suse.cz>2005-09-12 04:41:43 -0400
commit6243008b82222d6244b055beeeba94b14f23b7e2 (patch)
treed390cbdaa701221b1815c276d02b7df20ceaeb7e /Documentation
parent0be3b5d3fb94c36c517655d18a936681d7108667 (diff)
[ALSA] Update/fix ALSA document
Documentation Update/fix ALSA document. Signed-off-by: Takashi Iwai <tiwai@suse.de>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/sound/alsa/ALSA-Configuration.txt106
1 files changed, 70 insertions, 36 deletions
diff --git a/Documentation/sound/alsa/ALSA-Configuration.txt b/Documentation/sound/alsa/ALSA-Configuration.txt
index f626f4a9a61c..a7fc75f53bbe 100644
--- a/Documentation/sound/alsa/ALSA-Configuration.txt
+++ b/Documentation/sound/alsa/ALSA-Configuration.txt
@@ -75,7 +75,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
75 adsp_map - PCM device number maps assigned to the 2st OSS device. 75 adsp_map - PCM device number maps assigned to the 2st OSS device.
76 - Default: 1 76 - Default: 1
77 nonblock_open 77 nonblock_open
78 - Don't block opening busy PCM devices. 78 - Don't block opening busy PCM devices. Default: 1
79 79
80 For example, when dsp_map=2, /dev/dsp will be mapped to PCM #2 of 80 For example, when dsp_map=2, /dev/dsp will be mapped to PCM #2 of
81 the card #0. Similarly, when adsp_map=0, /dev/adsp will be mapped 81 the card #0. Similarly, when adsp_map=0, /dev/adsp will be mapped
@@ -199,15 +199,20 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
199 Module snd-atiixp 199 Module snd-atiixp
200 ----------------- 200 -----------------
201 201
202 Module for ATI IXP 150/200/250 AC97 controllers. 202 Module for ATI IXP 150/200/250/400 AC97 controllers.
203 203
204 ac97_clock - AC'97 clock (defalut = 48000) 204 ac97_clock - AC'97 clock (default = 48000)
205 ac97_quirk - AC'97 workaround for strange hardware 205 ac97_quirk - AC'97 workaround for strange hardware
206 See the description of intel8x0 module for details. 206 See "AC97 Quirk Option" section below.
207 spdif_aclink - S/PDIF transfer over AC-link (default = 1) 207 spdif_aclink - S/PDIF transfer over AC-link (default = 1)
208 208
209 This module supports up to 8 cards and autoprobe. 209 This module supports up to 8 cards and autoprobe.
210 210
211 ATI IXP has two different methods to control SPDIF output. One is
212 over AC-link and another is over the "direct" SPDIF output. The
213 implementation depends on the motherboard, and you'll need to
214 choose the correct one via spdif_aclink module option.
215
211 Module snd-atiixp-modem 216 Module snd-atiixp-modem
212 ----------------------- 217 -----------------------
213 218
@@ -240,7 +245,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
240 The hardware EQ hardware and SPDIF is only present in the Vortex2 and 245 The hardware EQ hardware and SPDIF is only present in the Vortex2 and
241 Advantage. 246 Advantage.
242 247
243 Note: Some ALSA mixer applicactions don't handle the SPDIF samplerate 248 Note: Some ALSA mixer applications don't handle the SPDIF sample rate
244 control correctly. If you have problems regarding this, try 249 control correctly. If you have problems regarding this, try
245 another ALSA compliant mixer (alsamixer works). 250 another ALSA compliant mixer (alsamixer works).
246 251
@@ -312,7 +317,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
312 317
313 mpu_port - 0x300,0x310,0x320,0x330, 0 = disable (default) 318 mpu_port - 0x300,0x310,0x320,0x330, 0 = disable (default)
314 fm_port - 0x388 (default), 0 = disable (default) 319 fm_port - 0x388 (default), 0 = disable (default)
315 soft_ac3 - Sofware-conversion of raw SPDIF packets (model 033 only) 320 soft_ac3 - Software-conversion of raw SPDIF packets (model 033 only)
316 (default = 1) 321 (default = 1)
317 joystick_port - Joystick port address (0 = disable, 1 = auto-detect) 322 joystick_port - Joystick port address (0 = disable, 1 = auto-detect)
318 323
@@ -394,7 +399,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
394 Module for PCI sound cards based on CS4610/CS4612/CS4614/CS4615/CS4622/ 399 Module for PCI sound cards based on CS4610/CS4612/CS4614/CS4615/CS4622/
395 CS4624/CS4630/CS4280 PCI chips. 400 CS4624/CS4630/CS4280 PCI chips.
396 401
397 external_amp - Force to enable external amplifer. 402 external_amp - Force to enable external amplifier.
398 thinkpad - Force to enable Thinkpad's CLKRUN control. 403 thinkpad - Force to enable Thinkpad's CLKRUN control.
399 mmap_valid - Support OSS mmap mode (default = 0). 404 mmap_valid - Support OSS mmap mode (default = 0).
400 405
@@ -630,7 +635,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
630 VIA VT8251/VT8237A 635 VIA VT8251/VT8237A
631 636
632 model - force the model name 637 model - force the model name
633 position_fix - Fix DMA pointer (0 = FIFO size, 1 = none, 2 = POSBUF) 638 position_fix - Fix DMA pointer (0 = auto, 1 = none, 2 = POSBUF, 3 = FIFO size)
634 639
635 Module supports up to 8 cards. 640 Module supports up to 8 cards.
636 641
@@ -666,6 +671,11 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
666 allout 5-jack in back, 2-jack in front, SPDIF out 671 allout 5-jack in back, 2-jack in front, SPDIF out
667 auto auto-config reading BIOS (default) 672 auto auto-config reading BIOS (default)
668 673
674 If the default configuration doesn't work and one of the above
675 matches with your device, report it together with the PCI
676 subsystem ID (output of "lspci -nv") to ALSA BTS or alsa-devel
677 ML (see the section "Links and Addresses").
678
669 Note 2: If you get click noises on output, try the module option 679 Note 2: If you get click noises on output, try the module option
670 position_fix=1 or 2. position_fix=1 will use the SD_LPIB 680 position_fix=1 or 2. position_fix=1 will use the SD_LPIB
671 register value without FIFO size correction as the current 681 register value without FIFO size correction as the current
@@ -793,18 +803,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
793 803
794 ac97_clock - AC'97 codec clock base (0 = auto-detect) 804 ac97_clock - AC'97 codec clock base (0 = auto-detect)
795 ac97_quirk - AC'97 workaround for strange hardware 805 ac97_quirk - AC'97 workaround for strange hardware
796 The following strings are accepted: 806 See "AC97 Quirk Option" section below.
797 default = don't override the default setting
798 disable = disable the quirk
799 hp_only = use headphone control as master
800 swap_hp = swap headphone and master controls
801 swap_surround = swap master and surround controls
802 ad_sharing = for AD1985, turn on OMS bit and use headphone
803 alc_jack = for ALC65x, turn on the jack sense mode
804 inv_eapd = inverted EAPD implementation
805 mute_led = bind EAPD bit for turning on/off mute LED
806 For backward compatibility, the corresponding integer
807 value -1, 0, ... are accepted, too.
808 buggy_irq - Enable workaround for buggy interrupts on some 807 buggy_irq - Enable workaround for buggy interrupts on some
809 motherboards (default off) 808 motherboards (default off)
810 809
@@ -818,13 +817,6 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
818 motherboard has these devices, use the ns558 or snd-mpu401 817 motherboard has these devices, use the ns558 or snd-mpu401
819 modules, respectively. 818 modules, respectively.
820 819
821 The ac97_quirk option is used to enable/override the workaround
822 for specific devices. Some hardware have swapped output pins
823 between Master and Headphone, or Surround. The driver provides
824 the auto-detection of known problematic devices, but some might
825 be unknown or wrongly detected. In such a case, pass the proper
826 value with this option.
827
828 The power-management is supported. 820 The power-management is supported.
829 821
830 Module snd-intel8x0m 822 Module snd-intel8x0m
@@ -976,7 +968,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
976 with machines with other (most likely CS423x or OPL3SAx) chips, 968 with machines with other (most likely CS423x or OPL3SAx) chips,
977 even though the device is detected in lspci. In such a case, try 969 even though the device is detected in lspci. In such a case, try
978 other drivers, e.g. snd-cs4232 or snd-opl3sa2. Some has ISA-PnP 970 other drivers, e.g. snd-cs4232 or snd-opl3sa2. Some has ISA-PnP
979 but some doesn't have ISA PnP. You'll need to speicfy isapnp=0 971 but some doesn't have ISA PnP. You'll need to specify isapnp=0
980 and proper hardware parameters in the case without ISA PnP. 972 and proper hardware parameters in the case without ISA PnP.
981 973
982 Note: some laptops need a workaround for AC97 RESET. For the 974 Note: some laptops need a workaround for AC97 RESET. For the
@@ -1312,7 +1304,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
1312 channels 1304 channels
1313 [VIA8233/C, 8235, 8237 only] 1305 [VIA8233/C, 8235, 8237 only]
1314 ac97_quirk - AC'97 workaround for strange hardware 1306 ac97_quirk - AC'97 workaround for strange hardware
1315 See the description of intel8x0 module for details. 1307 See "AC97 Quirk Option" section below.
1316 1308
1317 Module supports autoprobe and multiple bus-master chips (max 8). 1309 Module supports autoprobe and multiple bus-master chips (max 8).
1318 1310
@@ -1337,16 +1329,17 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
1337 "lspci -nv"). 1329 "lspci -nv").
1338 If dxs_support=5 does not work, try dxs_support=4; if it 1330 If dxs_support=5 does not work, try dxs_support=4; if it
1339 doesn't work too, try dxs_support=1. (dxs_support=1 is 1331 doesn't work too, try dxs_support=1. (dxs_support=1 is
1340 usually for old motherboards. The correct implementated 1332 usually for old motherboards. The correct implemented
1341 board should work with 4 or 5.) If it still doesn't 1333 board should work with 4 or 5.) If it still doesn't
1342 work and the default setting is ok, dxs_support=3 is the 1334 work and the default setting is ok, dxs_support=3 is the
1343 right choice. If the default setting doesn't work at all, 1335 right choice. If the default setting doesn't work at all,
1344 try dxs_support=2 to disable the DXS channels. 1336 try dxs_support=2 to disable the DXS channels.
1345 In any cases, please let us know the result and the 1337 In any cases, please let us know the result and the
1346 subsystem vendor/device ids. 1338 subsystem vendor/device ids. See "Links and Addresses"
1339 below.
1347 1340
1348 Note: for the MPU401 on VIA823x, use snd-mpu401 driver 1341 Note: for the MPU401 on VIA823x, use snd-mpu401 driver
1349 additonally. The mpu_port option is for VIA686 chips only. 1342 additionally. The mpu_port option is for VIA686 chips only.
1350 1343
1351 Module snd-via82xx-modem 1344 Module snd-via82xx-modem
1352 ------------------------ 1345 ------------------------
@@ -1408,8 +1401,10 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
1408 Module supports up to 8 cards. The module is compiled only when 1401 Module supports up to 8 cards. The module is compiled only when
1409 PCMCIA is supported on kernel. 1402 PCMCIA is supported on kernel.
1410 1403
1411 To activate the driver via the card manager, you'll need to set 1404 With the older 2.6.x kernel, to activate the driver via the card
1412 up /etc/pcmcia/vxpocket.conf. See the sound/pcmcia/vx/vxpocket.c. 1405 manager, you'll need to set up /etc/pcmcia/vxpocket.conf. See the
1406 sound/pcmcia/vx/vxpocket.c. 2.6.13 or later kernel requires no
1407 longer require a config file.
1413 1408
1414 When the driver is compiled as a module and the hotplug firmware 1409 When the driver is compiled as a module and the hotplug firmware
1415 is supported, the firmware data is loaded via hotplug automatically. 1410 is supported, the firmware data is loaded via hotplug automatically.
@@ -1421,6 +1416,9 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
1421 1416
1422 Note: the driver is build only when CONFIG_ISA is set. 1417 Note: the driver is build only when CONFIG_ISA is set.
1423 1418
1419 Note2: snd-vxp440 driver is merged to snd-vxpocket driver since
1420 ALSA 1.0.10.
1421
1424 Module snd-ymfpci 1422 Module snd-ymfpci
1425 ----------------- 1423 -----------------
1426 1424
@@ -1446,6 +1444,37 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
1446 Note: the driver is build only when CONFIG_ISA is set. 1444 Note: the driver is build only when CONFIG_ISA is set.
1447 1445
1448 1446
1447AC97 Quirk Option
1448=================
1449
1450The ac97_quirk option is used to enable/override the workaround for
1451specific devices on drivers for on-board AC'97 controllers like
1452snd-intel8x0. Some hardware have swapped output pins between Master
1453and Headphone, or Surround (thanks to confusion of AC'97
1454specifications from version to version :-)
1455
1456The driver provides the auto-detection of known problematic devices,
1457but some might be unknown or wrongly detected. In such a case, pass
1458the proper value with this option.
1459
1460The following strings are accepted:
1461 - default Don't override the default setting
1462 - disable Disable the quirk
1463 - hp_only Bind Master and Headphone controls as a single control
1464 - swap_hp Swap headphone and master controls
1465 - swap_surround Swap master and surround controls
1466 - ad_sharing For AD1985, turn on OMS bit and use headphone
1467 - alc_jack For ALC65x, turn on the jack sense mode
1468 - inv_eapd Inverted EAPD implementation
1469 - mute_led Bind EAPD bit for turning on/off mute LED
1470
1471For backward compatibility, the corresponding integer value -1, 0,
1472... are accepted, too.
1473
1474For example, if "Master" volume control has no effect on your device
1475but only "Headphone" does, pass ac97_quirk=hp_only module option.
1476
1477
1449Configuring Non-ISAPNP Cards 1478Configuring Non-ISAPNP Cards
1450============================ 1479============================
1451 1480
@@ -1599,9 +1628,14 @@ commands to the snd-page-alloc driver:
1599 use. 1628 use.
1600 1629
1601 1630
1602Links 1631Links and Addresses
1603===== 1632===================
1604 1633
1605 ALSA project homepage 1634 ALSA project homepage
1606 http://www.alsa-project.org 1635 http://www.alsa-project.org
1607 1636
1637 ALSA Bug Tracking System
1638 https://bugtrack.alsa-project.org/bugs/
1639
1640 ALSA Developers ML
1641 mailto:alsa-devel@lists.sourceforge.net