/[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.16 Revision 1.17
19 Sven Vermeulen</mail> 19 Sven Vermeulen</mail>
20</author> 20</author>
21<author title="Editor"><mail link="bennyc@gentoo.org"> 21<author title="Editor"><mail link="bennyc@gentoo.org">
22 Benny Chuang</mail> 22 Benny Chuang</mail>
23</author> 23</author>
24<author title="Editor"><mail link="blubber@gentoo.org"> 24<author title="Editor"><mail link="blubber@gentoo.org">
25 Tiemo Kieft</mail> 25 Tiemo Kieft</mail>
26</author> 26</author>
27 27
28<license/> 28<license/>
29 29
30<abstract> 30<abstract>
31This guide will show you how to set up the Advanced Linux Sound Architecture (ALSA) on Gentoo Linux. 31This guide will show you how to set up the Advanced Linux Sound Architecture (ALSA) on Gentoo Linux.
32In addition to the Gentoo Linux Desktop Configuration Guide, this guide is supposed to give you more information on this subject. </abstract> 32In addition to the Gentoo Linux Desktop Configuration Guide, this guide is supposed to give you more information on this subject. </abstract>
33 33
34<version>1.3.2</version> 34<version>1.3.3</version>
35<date>September 25, 2003</date> 35<date>October 9, 2003</date>
36 36
37<chapter> 37<chapter>
38<title>Introduction</title> 38<title>Introduction</title>
39<section> 39<section>
40 <title>What is ALSA?</title> 40 <title>What is ALSA?</title>
41<body> 41<body>
42<p> 42<p>
43The Advanced Linux Sound Architecture (ALSA) is a project to improve the Linux sound subsystem by rewriting 43The Advanced Linux Sound Architecture (ALSA) is a project to improve the Linux sound subsystem by rewriting
44large chunks of it. 44large chunks of it.
45It is anticipated that ALSA will make it into Linux kernel 2.6.x (or 3.x.x -- whichever comes first) as it becomes ready. 45It is anticipated that ALSA will make it into Linux kernel 2.6.x (or 3.x.x -- whichever comes first) as it becomes ready.
46</p> 46</p>
47 47
48<p> 48<p>
49ALSA provides audio and MIDI functionality for Linux. 49ALSA provides audio and MIDI functionality for Linux.
50</p> 50</p>
82 <title>What cards does ALSA support?</title> 82 <title>What cards does ALSA support?</title>
83<body> 83<body>
84<p> 84<p>
85ALSA tries to support as many (new) cards as possible by providing open-source drivers. 85ALSA tries to support as many (new) cards as possible by providing open-source drivers.
86However, some vendors may provide binary-only packages. 86However, some vendors may provide binary-only packages.
87</p> 87</p>
88<p>To know if your card is supported, you can find a Soundcard Matrix of supported and not-supported cards here: 88<p>To know if your card is supported, you can find a Soundcard Matrix of supported and not-supported cards here:
89<uri>http://www.alsa-project.org/alsa-doc/</uri>. 89<uri>http://www.alsa-project.org/alsa-doc/</uri>.
90</p> 90</p>
91</body> 91</body>
92</section> 92</section>
93</chapter> 93</chapter>
94 94
95<chapter> 95<chapter>
96<title>Installation</title> 96<title>Installation</title>
97<section>
98<title>Gentoo USE flags</title>
99<body>
100
101<p>
102To compile programs with ALSA-support, be sure to add <e>alsa</e> to
103your USE-variable. However, several tools don't support alsa yet, and
104require OSS. ALSA provides OSS-emulation if you define <e>oss</e> in your
105USE-variable before you start.
106</p>
107
108</body>
109</section>
110
97<section> 111<section>
98 <title>Kernel modules</title> 112 <title>Kernel modules</title>
99<body> 113<body>
100<p> 114<p>
101Since we're still using 2.4.x kernel sources, we'll have to compile kernel modules and ALSA modules separately. People who are using a 2.5.x kernel can do this from within their kernel configuration, since the ALSA modules are included in the kernel sources and should be built there. 115Since we're still using 2.4.x kernel sources, we'll have to compile kernel modules and ALSA modules separately. People who are using a 2.5.x kernel can do this from within their kernel configuration, since the ALSA modules are included in the kernel sources and should be built there.
102</p> 116</p>
103<p> 117<p>
104First we'll make sure that our kernel configuration is ready for use with ALSA. 118First we'll make sure that our kernel configuration is ready for use with ALSA.
105All you need in your kernel configuration is having Sound Card Support set to be built as a module (M). 119All you need in your kernel configuration is having Sound Card Support set to be built as a module (M).
106This will build <c>soundcore.o</c>. 120This will build <c>soundcore.o</c>.
107</p> 121</p>
108<p> 122<p>
109<note> 123<note>
110Possibly, this will also work when you built Sound Card Support in the kernel (Y) instead of building it as a module (M). 124Possibly, this will also work when you built Sound Card Support in the kernel (Y) instead of building it as a module (M).
111However, the official ALSA documentation suggests building it as a module, since ALSA will try loading it. 125However, the official ALSA documentation suggests building it as a module, since ALSA will try loading it.
373<path>/lib/modules/*/kernel/sound/pci/</path>.</p> 387<path>/lib/modules/*/kernel/sound/pci/</path>.</p>
374<pre caption="needed after each kernel compile"> 388<pre caption="needed after each kernel compile">
375# <i>emerge alsa-driver</i> 389# <i>emerge alsa-driver</i>
376</pre> 390</pre>
377</body> 391</body>
378</section> 392</section>
379<section> 393<section>
380 <title>/etc/modules.autoload</title> 394 <title>/etc/modules.autoload</title>
381<body> 395<body>
382<p>You won't have to edit this file for use with ALSA. After our <c>rc-update add alsasound boot</c>, our system will 396<p>You won't have to edit this file for use with ALSA. After our <c>rc-update add alsasound boot</c>, our system will
383load the correct modules at startup.</p> 397load the correct modules at startup.</p>
384<p>It's not necessary to add <c>snd-pcm-oss</c> or <c>snd-mixer-oss</c> in this file. 398<p>It's not necessary to add <c>snd-pcm-oss</c> or <c>snd-mixer-oss</c> in this file.
385Check the <uri link="http://www.djcj.org/LAU/guide/alsbook/faq1.html">this FAQ</uri> for more info.</p> 399Check the <uri link="http://www.djcj.org/LAU/guide/alsbook/faq1.html">this FAQ</uri> for more info.</p>
386</body> 400</body>
387</section> 401</section>
402
403<section>
404<title>Known bugs</title>
405<body>
406
407<note>
408This guide lags behind on the alsa-development. Chances are these bugs
409are already fixed when you read this.
410</note>
411
412<ul>
413<li>
414If you have <b>lots of noise</b> when using <b>oss</b> emulation, add
415<e>options snd-pcm-oss dsp_map=1</e> to
416<path>/etc/modules.d/alsa</path>.
417</li>
418</ul>
419
420</body>
421</section>
422
388<section> 423<section>
389 <title>More links..</title> 424 <title>More links..</title>
390<body> 425<body>
391<p> 426<p>
392You could check these for additional info: 427You could check these for additional info:
393</p> 428</p>
394<p> 429<p>
395<ul> 430<ul>
396<li><uri link="http://www.gentoo.org/doc/en/desktop.xml">The Gentoo Linux Desktop Configuration Guide</uri></li> 431<li><uri link="http://www.gentoo.org/doc/en/desktop.xml">The Gentoo Linux Desktop Configuration Guide</uri></li>
397<li><uri link="http://www.alsa-project.org">ALSA Project Homepage</uri></li> 432<li><uri link="http://www.alsa-project.org">ALSA Project Homepage</uri></li>
398<li><uri link="http://www.alsa-project.org/documentation.php3">ALSA Users Documentation</uri></li> 433<li><uri link="http://www.alsa-project.org/documentation.php3">ALSA Users Documentation</uri></li>
399<li><uri link="http://www.djcj.org">ALSA Howto's and FAQ's</uri></li> 434<li><uri link="http://www.djcj.org">ALSA Howto's and FAQ's</uri></li>
400<li><uri link="http://tldp.org/HOWTO/Sound-HOWTO/index.html">Linux Sound HOWTO</uri></li> 435<li><uri link="http://tldp.org/HOWTO/Sound-HOWTO/index.html">Linux Sound HOWTO</uri></li>
401<li><uri link="http://linux-sound.org/">Sound and MIDI Software For Linux</uri></li> 436<li><uri link="http://linux-sound.org/">Sound and MIDI Software For Linux</uri></li>
402</ul> 437</ul>

Legend:
Removed from v.1.16  
changed lines
  Added in v.1.17

  ViewVC Help
Powered by ViewVC 1.1.20