/[gentoo]/xml/htdocs/doc/en/alsa-guide.xml
Gentoo

Diff of /xml/htdocs/doc/en/alsa-guide.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.82 Revision 1.83
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/alsa-guide.xml,v 1.82 2009/01/26 09:13:56 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/alsa-guide.xml,v 1.83 2009/08/05 15:43:12 nightmorph Exp $ -->
3 3
4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5 5
6<guide link="/doc/en/alsa-guide.xml"> 6<guide link="/doc/en/alsa-guide.xml">
7<title>Gentoo Linux ALSA Guide</title> 7<title>Gentoo Linux ALSA Guide</title>
8 8
9<author title="Author"> 9<author title="Author">
10 <mail link="fox2mike@gentoo.org">Shyam Mani</mail> 10 <mail link="fox2mike@gentoo.org">Shyam Mani</mail>
11</author> 11</author>
12<author title="Author"> 12<author title="Author">
13 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail> 13 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
14</author> 14</author>
15<author title="Contributor"> 15<author title="Contributor">
16 <mail link="flameeyes@gentoo.org">Diego Pettenò</mail> 16 <mail link="flameeyes@gentoo.org">Diego Pettenò</mail>
17</author> 17</author>
18 18
19<abstract> 19<abstract>
20This document helps a user setup ALSA on Gentoo Linux. 20This document helps a user setup ALSA on Gentoo Linux.
21</abstract> 21</abstract>
22 22
23<!-- The content of this document is licensed under the CC-BY-SA license --> 23<!-- The content of this document is licensed under the CC-BY-SA license -->
24<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 24<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25<license/> 25<license/>
26 26
27<version>2.24</version> 27<version>2.25</version>
28<date>2009-01-26</date> 28<date>2009-08-05</date>
29 29
30<chapter> 30<chapter>
31<title>Introduction</title> 31<title>Introduction</title>
32<section> 32<section>
33<title>What is ALSA?</title> 33<title>What is ALSA?</title>
34<body> 34<body>
35 35
36<p> 36<p>
37ALSA, which stands for <e>Advanced Linux Sound Architecture</e>, provides 37ALSA, which stands for <e>Advanced Linux Sound Architecture</e>, provides
38audio and MIDI (<e>Musical Instrument Digital Interface</e>) functionality to 38audio and MIDI (<e>Musical Instrument Digital Interface</e>) functionality to
39the Linux operating system. ALSA is the default sound subsystem in the 2.6 39the Linux operating system. ALSA is the default sound subsystem in the 2.6
40kernel thereby replacing OSS (<e>Open Sound System</e>), which was used in the 40kernel thereby replacing OSS (<e>Open Sound System</e>), which was used in the
412.4 kernels. 412.4 kernels.
42</p> 42</p>
43 43
283running <c>alsaconf</c>. 283running <c>alsaconf</c>.
284</note> 284</note>
285 285
286<p> 286<p>
287To configure your sound card just type <c>alsaconf</c> in a shell as root. 287To configure your sound card just type <c>alsaconf</c> in a shell as root.
288</p> 288</p>
289 289
290<pre caption="Invoking alsaconf"> 290<pre caption="Invoking alsaconf">
291# <i>alsaconf</i> 291# <i>alsaconf</i>
292</pre> 292</pre>
293 293
294<p> 294<p>
295You will now see a neat menu guided interface that will automatically probe 295You will now see a neat menu guided interface that will automatically probe
296your devices and try to find out your sound card. You will be asked to pick 296your devices and try to find out your sound card. You will be asked to pick
297your sound card from a list. Once that's done, it will ask you permission to 297your sound card from a list. Once that's done, it will ask you permission to
298automatically make required changes to <path>/etc/modules.d/alsa</path>. 298automatically make required changes to <path>/etc/modprobe.d/alsa.conf</path>.
299It will then adjust your volume settings to optimum levels, run 299It will then adjust your volume settings to optimum levels, run
300<c>update-modules</c> and start the <path>/etc/init.d/alsasound</path> service. 300<c>update-modules</c> and start the <path>/etc/init.d/alsasound</path> service.
301Once <c>alsaconf</c> exits, you can proceed with setting up the ALSA 301Once <c>alsaconf</c> exits, you can proceed with setting up the ALSA
302initscript. 302initscript.
303</p> 303</p>
304 304
305</body> 305</body>
306</section> 306</section>
307<section id="initscript"> 307<section id="initscript">
308<title>ALSA Initscript</title> 308<title>ALSA Initscript</title>
309<body> 309<body>
310 310
311<p> 311<p>
312We're now almost all setup. Whichever method you chose to install ALSA, you'll 312We're now almost all setup. Whichever method you chose to install ALSA, you'll
313need to have something load your modules or initialize ALSA and restore your 313need to have something load your modules or initialize ALSA and restore your
605in-kernel modules thus causing the above errors. 605in-kernel modules thus causing the above errors.
606</p> 606</p>
607 607
608<p> 608<p>
609The solution is quite easy. We just need to manually remove the problem causing 609The solution is quite easy. We just need to manually remove the problem causing
610directory after you unmerge <c>alsa-driver</c>. Be sure to remove the correct 610directory after you unmerge <c>alsa-driver</c>. Be sure to remove the correct
611kernel version and not the current one! 611kernel version and not the current one!
612</p> 612</p>
613 613
614<pre caption="Removing the alsa-driver modules"> 614<pre caption="Removing the alsa-driver modules">
615# <i>rm -rf /lib/modules/$(uname -r)/alsa-driver</i> 615# <i>rm -rf /lib/modules/$(uname -r)/alsa-driver</i>
616</pre> 616</pre>
617 617
618<p> 618<p>
619Another reason for error messages similar to the ones above could be a file in 619Another reason for error messages similar to the ones above could be a file in
620<path>/etc/modules.d</path> supplying a <c>device_mode</c> parameter when it 620<path>/etc/modprobe.d</path> supplying a <c>device_mode</c> parameter when it
621isn't required. Confirm that this is indeed the issue and find out which file 621isn't required. Confirm that this is indeed the issue and find out which file
622is the culprit. 622is the culprit.
623</p> 623</p>
624 624
625<pre caption="Confirming and searching for device_mode"> 625<pre caption="Confirming and searching for device_mode">
626<comment>(Check dmesg to confirm)</comment> 626<comment>(Check dmesg to confirm)</comment>
627# <i>dmesg | grep device_mode</i> 627# <i>dmesg | grep device_mode</i>
628snd: Unknown parameter `device_mode' 628snd: Unknown parameter `device_mode'
629<comment>(Now, to get to the source of the issue)</comment> 629<comment>(Now, to get to the source of the issue)</comment>
630# <i>grep device_mode /etc/modules.d/*</i> 630# <i>grep device_mode /etc/modprobe.d/*</i>
631</pre> 631</pre>
632 632
633<p> 633<p>
634Usually it is a file called <path>alsa</path> with the line <c>options snd 634Usually it is a file called <path>alsa</path> with the line <c>options snd
635device_mode=0666</c>. Remove this line and restart the <c>alsasound</c> service 635device_mode=0666</c>. Remove this line and restart the <c>alsasound</c> service
636and that should take care of this issue. 636and that should take care of this issue.
637</p> 637</p>
638 638
639<!-- End of removal notice --> 639<!-- End of removal notice -->
640 640
641</body> 641</body>
642</section> 642</section>
643</chapter> 643</chapter>
644 644
645<chapter> 645<chapter>
771</p> 771</p>
772 772
773<pre caption="Installing ALSA Tools"> 773<pre caption="Installing ALSA Tools">
774# <i>emerge alsa-tools</i> 774# <i>emerge alsa-tools</i>
775</pre> 775</pre>
776 776
777</body> 777</body>
778</section> 778</section>
779<section> 779<section>
780<title>Multiple sound cards</title> 780<title>Multiple sound cards</title>
781<body> 781<body>
782 782
783<p> 783<p>
784You can have more than one sound card in your system simultaneously, provided 784You can have more than one sound card in your system simultaneously, provided
785that you have built ALSA as modules in your kernel. You just need to specify 785that you have built ALSA as modules in your kernel. You just need to specify
786which should be started first in <path>/etc/modules.d/alsa</path>. Your cards 786which should be started first in <path>/etc/modprobe.d/alsa.conf</path>. Your cards
787are identified by their driver names inside this file. 0 is the first card, 1 is 787are identified by their driver names inside this file. 0 is the first card, 1 is
788the second, and so on. Here's an example for a system with two sound cards. 788the second, and so on. Here's an example for a system with two sound cards.
789</p> 789</p>
790 790
791<pre caption="Two sound cards in /etc/modules.d/alsa"> 791<pre caption="Two sound cards in /etc/modprobe.d/alsa.conf">
792options snd-emu10k1 index=0 792options snd-emu10k1 index=0
793options snd-via82xx index=1 793options snd-via82xx index=1
794</pre> 794</pre>
795 795
796<p> 796<p>
797Or, if you have two cards that use the same driver, you specify them on the same 797Or, if you have two cards that use the same driver, you specify them on the same
798line, using comma-separated numbers. Here's an example for a system with three 798line, using comma-separated numbers. Here's an example for a system with three
799sound cards, two of which are the same Intel High Definition Audio card. 799sound cards, two of which are the same Intel High Definition Audio card.
800</p> 800</p>
801 801
802<pre caption="Multiple sound cards in /etc/modules.d/alsa"> 802<pre caption="Multiple sound cards in /etc/modprobe.d/alsa.conf">
803options snd-ymfpci index=0 803options snd-ymfpci index=0
804options snd-hda-intel index=1,2 804options snd-hda-intel index=1,2
805</pre> 805</pre>
806 806
807</body> 807</body>
808</section> 808</section>
809<section> 809<section>
810<title>Plugins</title> 810<title>Plugins</title>
811<body> 811<body>
812 812
813<p> 813<p>
814You may want to install some plugins for extra functionality. 814You may want to install some plugins for extra functionality.
815<c>alsa-plugins</c> is a collection of useful plugins, which include: PulseAudio 815<c>alsa-plugins</c> is a collection of useful plugins, which include: PulseAudio
816output, a sample rate converter, jack (a low-latency audio server), and an 816output, a sample rate converter, jack (a low-latency audio server), and an
817encoder that lets you output 6-channel audio through digital S/PDIF connections 817encoder that lets you output 6-channel audio through digital S/PDIF connections

Legend:
Removed from v.1.82  
changed lines
  Added in v.1.83

  ViewVC Help
Powered by ViewVC 1.1.20