aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/sound
diff options
context:
space:
mode:
authorAndrea Bastoni <bastoni@cs.unc.edu>2010-05-30 19:16:45 -0400
committerAndrea Bastoni <bastoni@cs.unc.edu>2010-05-30 19:16:45 -0400
commitada47b5fe13d89735805b566185f4885f5a3f750 (patch)
tree644b88f8a71896307d71438e9b3af49126ffb22b /Documentation/sound
parent43e98717ad40a4ae64545b5ba047c7b86aa44f4f (diff)
parent3280f21d43ee541f97f8cda5792150d2dbec20d5 (diff)
Merge branch 'wip-2.6.34' into old-private-masterarchived-private-master
Diffstat (limited to 'Documentation/sound')
-rw-r--r--Documentation/sound/alsa/ALSA-Configuration.txt40
-rw-r--r--Documentation/sound/alsa/ControlNames.txt3
-rw-r--r--Documentation/sound/alsa/HD-Audio-Models.txt8
-rw-r--r--Documentation/sound/alsa/HD-Audio.txt49
-rw-r--r--Documentation/sound/alsa/Procfile.txt2
5 files changed, 89 insertions, 13 deletions
diff --git a/Documentation/sound/alsa/ALSA-Configuration.txt b/Documentation/sound/alsa/ALSA-Configuration.txt
index fd9a2f67edf2..bfcbbf88c44d 100644
--- a/Documentation/sound/alsa/ALSA-Configuration.txt
+++ b/Documentation/sound/alsa/ALSA-Configuration.txt
@@ -482,6 +482,9 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
482 482
483 reference_rate - reference sample rate, 44100 or 48000 (default) 483 reference_rate - reference sample rate, 44100 or 48000 (default)
484 multiple - multiple to ref. sample rate, 1 or 2 (default) 484 multiple - multiple to ref. sample rate, 1 or 2 (default)
485 subsystem - override the PCI SSID for probing; the value
486 consists of SSVID << 16 | SSDID. The default is
487 zero, which means no override.
485 488
486 This module supports multiple cards. 489 This module supports multiple cards.
487 490
@@ -798,6 +801,9 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
798 setup before initializing the codecs. This option is 801 setup before initializing the codecs. This option is
799 available only when CONFIG_SND_HDA_PATCH_LOADER=y is set. 802 available only when CONFIG_SND_HDA_PATCH_LOADER=y is set.
800 See HD-Audio.txt for details. 803 See HD-Audio.txt for details.
804 beep_mode - Selects the beep registration mode (0=off, 1=on, 2=
805 dynamic registration via mute switch on/off); the default
806 value is set via CONFIG_SND_HDA_INPUT_BEEP_MODE kconfig.
801 807
802 [Single (global) options] 808 [Single (global) options]
803 single_cmd - Use single immediate commands to communicate with 809 single_cmd - Use single immediate commands to communicate with
@@ -1120,6 +1126,21 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
1120 1126
1121 This module supports multiple cards, autoprobe and ISA PnP. 1127 This module supports multiple cards, autoprobe and ISA PnP.
1122 1128
1129 Module snd-jazz16
1130 -------------------
1131
1132 Module for Media Vision Jazz16 chipset. The chipset consists of 3 chips:
1133 MVD1216 + MVA416 + MVA514.
1134
1135 port - port # for SB DSP chip (0x210,0x220,0x230,0x240,0x250,0x260)
1136 irq - IRQ # for SB DSP chip (3,5,7,9,10,15)
1137 dma8 - DMA # for SB DSP chip (1,3)
1138 dma16 - DMA # for SB DSP chip (5,7)
1139 mpu_port - MPU-401 port # (0x300,0x310,0x320,0x330)
1140 mpu_irq - MPU-401 irq # (2,3,5,7)
1141
1142 This module supports multiple cards.
1143
1123 Module snd-korg1212 1144 Module snd-korg1212
1124 ------------------- 1145 -------------------
1125 1146
@@ -1454,6 +1475,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
1454 1475
1455 Module for internal PC-Speaker. 1476 Module for internal PC-Speaker.
1456 1477
1478 nopcm - Disable PC-Speaker PCM sound. Only beeps remain.
1457 nforce_wa - enable NForce chipset workaround. Expect bad sound. 1479 nforce_wa - enable NForce chipset workaround. Expect bad sound.
1458 1480
1459 This module supports system beeps, some kind of PCM playback and 1481 This module supports system beeps, some kind of PCM playback and
@@ -1631,7 +1653,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
1631 Module snd-sscape 1653 Module snd-sscape
1632 ----------------- 1654 -----------------
1633 1655
1634 Module for ENSONIQ SoundScape PnP cards. 1656 Module for ENSONIQ SoundScape cards.
1635 1657
1636 port - Port # (PnP setup) 1658 port - Port # (PnP setup)
1637 wss_port - WSS Port # (PnP setup) 1659 wss_port - WSS Port # (PnP setup)
@@ -1639,10 +1661,11 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
1639 mpu_irq - MPU-401 IRQ # (PnP setup) 1661 mpu_irq - MPU-401 IRQ # (PnP setup)
1640 dma - DMA # (PnP setup) 1662 dma - DMA # (PnP setup)
1641 dma2 - 2nd DMA # (PnP setup, -1 to disable) 1663 dma2 - 2nd DMA # (PnP setup, -1 to disable)
1664 joystick - Enable gameport - 0 = disable (default), 1 = enable
1642 1665
1643 This module supports multiple cards. ISA PnP must be enabled. 1666 This module supports multiple cards.
1644 You need sscape_ctl tool in alsa-tools package for loading 1667
1645 the microcode. 1668 The driver requires the firmware loader support on kernel.
1646 1669
1647 Module snd-sun-amd7930 (on sparc only) 1670 Module snd-sun-amd7930 (on sparc only)
1648 -------------------------------------- 1671 --------------------------------------
@@ -1786,6 +1809,13 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
1786 1809
1787 The power-management is supported. 1810 The power-management is supported.
1788 1811
1812 Module snd-ua101
1813 ----------------
1814
1815 Module for the Edirol UA-101/UA-1000 audio/MIDI interfaces.
1816
1817 This module supports multiple devices, autoprobe and hotplugging.
1818
1789 Module snd-usb-audio 1819 Module snd-usb-audio
1790 -------------------- 1820 --------------------
1791 1821
@@ -1918,7 +1948,7 @@ Prior to version 0.9.0rc4 options had a 'snd_' prefix. This was removed.
1918 ------------------- 1948 -------------------
1919 1949
1920 Module for sound cards based on the Asus AV100/AV200 chips, 1950 Module for sound cards based on the Asus AV100/AV200 chips,
1921 i.e., Xonar D1, DX, D2, D2X, HDAV1.3 (Deluxe), Essence ST 1951 i.e., Xonar D1, DX, D2, D2X, DS, HDAV1.3 (Deluxe), Essence ST
1922 (Deluxe) and Essence STX. 1952 (Deluxe) and Essence STX.
1923 1953
1924 This module supports autoprobe and multiple cards. 1954 This module supports autoprobe and multiple cards.
diff --git a/Documentation/sound/alsa/ControlNames.txt b/Documentation/sound/alsa/ControlNames.txt
index 5b18298e9495..fea65bb6269e 100644
--- a/Documentation/sound/alsa/ControlNames.txt
+++ b/Documentation/sound/alsa/ControlNames.txt
@@ -18,8 +18,9 @@ SOURCE:
18 Master 18 Master
19 Master Mono 19 Master Mono
20 Hardware Master 20 Hardware Master
21 Speaker (internal speaker)
21 Headphone 22 Headphone
22 PC Speaker 23 Beep (beep generator)
23 Phone 24 Phone
24 Phone Input 25 Phone Input
25 Phone Output 26 Phone Output
diff --git a/Documentation/sound/alsa/HD-Audio-Models.txt b/Documentation/sound/alsa/HD-Audio-Models.txt
index 4c7f9aee5c4e..1d38b0dfba95 100644
--- a/Documentation/sound/alsa/HD-Audio-Models.txt
+++ b/Documentation/sound/alsa/HD-Audio-Models.txt
@@ -124,8 +124,11 @@ ALC882/883/885/888/889
124 asus-a7m ASUS A7M 124 asus-a7m ASUS A7M
125 macpro MacPro support 125 macpro MacPro support
126 mb5 Macbook 5,1 126 mb5 Macbook 5,1
127 macmini3 Macmini 3,1
128 mba21 Macbook Air 2,1
127 mbp3 Macbook Pro rev3 129 mbp3 Macbook Pro rev3
128 imac24 iMac 24'' with jack detection 130 imac24 iMac 24'' with jack detection
131 imac91 iMac 9,1
129 w2jc ASUS W2JC 132 w2jc ASUS W2JC
130 3stack-2ch-dig 3-jack with SPDIF I/O (ALC883) 133 3stack-2ch-dig 3-jack with SPDIF I/O (ALC883)
131 alc883-6stack-dig 6-jack digital with SPDIF I/O (ALC883) 134 alc883-6stack-dig 6-jack digital with SPDIF I/O (ALC883)
@@ -278,13 +281,16 @@ Conexant 5051
278 laptop Basic Laptop config (default) 281 laptop Basic Laptop config (default)
279 hp HP Spartan laptop 282 hp HP Spartan laptop
280 hp-dv6736 HP dv6736 283 hp-dv6736 HP dv6736
284 hp-f700 HP Compaq Presario F700
281 lenovo-x200 Lenovo X200 laptop 285 lenovo-x200 Lenovo X200 laptop
286 toshiba Toshiba Satellite M300
282 287
283Conexant 5066 288Conexant 5066
284============= 289=============
285 laptop Basic Laptop config (default) 290 laptop Basic Laptop config (default)
286 dell-laptop Dell laptops 291 dell-laptop Dell laptops
287 olpc-xo-1_5 OLPC XO 1.5 292 olpc-xo-1_5 OLPC XO 1.5
293 ideapad Lenovo IdeaPad U150
288 294
289STAC9200 295STAC9200
290======== 296========
@@ -391,6 +397,7 @@ STAC92HD83*
391 ref Reference board 397 ref Reference board
392 mic-ref Reference board with power management for ports 398 mic-ref Reference board with power management for ports
393 dell-s14 Dell laptop 399 dell-s14 Dell laptop
400 hp HP laptops with (inverted) mute-LED
394 auto BIOS setup (default) 401 auto BIOS setup (default)
395 402
396STAC9872 403STAC9872
@@ -401,4 +408,5 @@ STAC9872
401Cirrus Logic CS4206/4207 408Cirrus Logic CS4206/4207
402======================== 409========================
403 mbp55 MacBook Pro 5,5 410 mbp55 MacBook Pro 5,5
411 imac27 IMac 27 Inch
404 auto BIOS setup (default) 412 auto BIOS setup (default)
diff --git a/Documentation/sound/alsa/HD-Audio.txt b/Documentation/sound/alsa/HD-Audio.txt
index 7b8a5f947d1d..98d14cb8a85d 100644
--- a/Documentation/sound/alsa/HD-Audio.txt
+++ b/Documentation/sound/alsa/HD-Audio.txt
@@ -119,10 +119,18 @@ the codec slots 0 and 1 no matter what the hardware reports.
119 119
120Interrupt Handling 120Interrupt Handling
121~~~~~~~~~~~~~~~~~~ 121~~~~~~~~~~~~~~~~~~
122In rare but some cases, the interrupt isn't properly handled as 122HD-audio driver uses MSI as default (if available) since 2.6.33
123default. You would notice this by the DMA transfer error reported by 123kernel as MSI works better on some machines, and in general, it's
124ALSA PCM core, for example. Using MSI might help in such a case. 124better for performance. However, Nvidia controllers showed bad
125Pass `enable_msi=1` option for enabling MSI. 125regressions with MSI (especially in a combination with AMD chipset),
126thus we disabled MSI for them.
127
128There seem also still other devices that don't work with MSI. If you
129see a regression wrt the sound quality (stuttering, etc) or a lock-up
130in the recent kernel, try to pass `enable_msi=0` option to disable
131MSI. If it works, you can add the known bad device to the blacklist
132defined in hda_intel.c. In such a case, please report and give the
133patch back to the upstream developer.
126 134
127 135
128HD-AUDIO CODEC 136HD-AUDIO CODEC
@@ -452,6 +460,33 @@ Similarly, the lines after `[verb]` are parsed as `init_verbs`
452sysfs entries, and the lines after `[hint]` are parsed as `hints` 460sysfs entries, and the lines after `[hint]` are parsed as `hints`
453sysfs entries, respectively. 461sysfs entries, respectively.
454 462
463Another example to override the codec vendor id from 0x12345678 to
4640xdeadbeef is like below:
465------------------------------------------------------------------------
466 [codec]
467 0x12345678 0xabcd1234 2
468
469 [vendor_id]
470 0xdeadbeef
471------------------------------------------------------------------------
472
473In the similar way, you can override the codec subsystem_id via
474`[subsystem_id]`, the revision id via `[revision_id]` line.
475Also, the codec chip name can be rewritten via `[chip_name]` line.
476------------------------------------------------------------------------
477 [codec]
478 0x12345678 0xabcd1234 2
479
480 [subsystem_id]
481 0xffff1111
482
483 [revision_id]
484 0x10
485
486 [chip_name]
487 My-own NEWS-0002
488------------------------------------------------------------------------
489
455The hd-audio driver reads the file via request_firmware(). Thus, 490The hd-audio driver reads the file via request_firmware(). Thus,
456a patch file has to be located on the appropriate firmware path, 491a patch file has to be located on the appropriate firmware path,
457typically, /lib/firmware. For example, when you pass the option 492typically, /lib/firmware. For example, when you pass the option
@@ -624,11 +659,13 @@ hda-verb. The program gives you an easy-to-use GUI stuff for showing
624the widget information and adjusting the amp values, as well as the 659the widget information and adjusting the amp values, as well as the
625proc-compatible output. 660proc-compatible output.
626 661
627The hda-analyzer is a part of alsa.git repository in 662The hda-analyzer:
628alsa-project.org:
629 663
630- http://git.alsa-project.org/?p=alsa.git;a=tree;f=hda-analyzer 664- http://git.alsa-project.org/?p=alsa.git;a=tree;f=hda-analyzer
631 665
666is a part of alsa.git repository in alsa-project.org:
667
668- git://git.alsa-project.org/alsa.git
632 669
633Codecgraph 670Codecgraph
634~~~~~~~~~~ 671~~~~~~~~~~
diff --git a/Documentation/sound/alsa/Procfile.txt b/Documentation/sound/alsa/Procfile.txt
index 719a819f8cc2..07301de12cc4 100644
--- a/Documentation/sound/alsa/Procfile.txt
+++ b/Documentation/sound/alsa/Procfile.txt
@@ -95,7 +95,7 @@ card*/pcm*/xrun_debug
95 It takes an integer value, can be changed by writing to this 95 It takes an integer value, can be changed by writing to this
96 file, such as 96 file, such as
97 97
98 # cat 5 > /proc/asound/card0/pcm0p/xrun_debug 98 # echo 5 > /proc/asound/card0/pcm0p/xrun_debug
99 99
100 The value consists of the following bit flags: 100 The value consists of the following bit flags:
101 bit 0 = Enable XRUN/jiffies debug messages 101 bit 0 = Enable XRUN/jiffies debug messages