/[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.8 Revision 1.9
4<guide link = "/doc/en/alsa-guide.xml"> 4<guide link = "/doc/en/alsa-guide.xml">
5<title>Gentoo Linux ALSA Guide</title> 5<title>Gentoo Linux ALSA Guide</title>
6<author title="Author"><mail link="zu@pandora.be"> 6<author title="Author"><mail link="zu@pandora.be">
7 Vincent Verleye</mail> 7 Vincent Verleye</mail>
8</author> 8</author>
9 9
10<author title="Editor"><mail link="zhen@gentoo.org"> 10<author title="Editor"><mail link="zhen@gentoo.org">
11 John P. Davis</mail> 11 John P. Davis</mail>
12</author> 12</author>
13 13
14<abstract> 14<abstract>
15This guide will show you how to set up the Advanced Linux Sound Architecture (ALSA) on Gentoo Linux. 15This guide will show you how to set up the Advanced Linux Sound Architecture (ALSA) on Gentoo Linux.
16In addition to the Gentoo Linux Desktop Configuration Guide, this guide is supposed to give you more information on this subject. </abstract> 16In addition to the Gentoo Linux Desktop Configuration Guide, this guide is supposed to give you more information on this subject. </abstract>
17 17
18<version>1.2</version> 18<version>1.2</version>
19<date>18 February 2003</date> 19<date>8 May 2003</date>
20 20
21<chapter> 21<chapter>
22<title>Introduction</title> 22<title>Introduction</title>
23<section> 23<section>
24 <title>What is ALSA?</title> 24 <title>What is ALSA?</title>
25<body> 25<body>
26<p> 26<p>
27The Advanced Linux Sound Architecture (ALSA) is a project to improve the Linux sound subsystem by rewriting 27The Advanced Linux Sound Architecture (ALSA) is a project to improve the Linux sound subsystem by rewriting
28large chunks of it. 28large chunks of it.
29It is anticipated that ALSA will make it into Linux kernel 2.6.x (or 3.x.x -- whichever comes first) as it becomes ready. 29It is anticipated that ALSA will make it into Linux kernel 2.6.x (or 3.x.x -- whichever comes first) as it becomes ready.
30</p> 30</p>
31 31
32<p> 32<p>
33ALSA provides audio and MIDI functionality for Linux. 33ALSA provides audio and MIDI functionality for Linux.
34</p> 34</p>
190Let's start configuring now to get ALSA working properly. 190Let's start configuring now to get ALSA working properly.
191We'll need to edit some files, to let our system know about the freshly installed ALSA modules. 191We'll need to edit some files, to let our system know about the freshly installed ALSA modules.
192</p> 192</p>
193<p> 193<p>
194First file to edit is <path>/etc/modules.d/alsa</path>. 194First file to edit is <path>/etc/modules.d/alsa</path>.
195</p> 195</p>
196<warn> 196<warn>
197There is no need to edit <path>/etc/modules.conf</path>. Instead, always edit files in <path>/etc/modules.d</path>. 197There is no need to edit <path>/etc/modules.conf</path>. Instead, always edit files in <path>/etc/modules.d</path>.
198</warn> 198</warn>
199<p> 199<p>
200Check the ALSA portion <e>at the bottom of the file</e>. 200Check the ALSA portion <e>at the bottom of the file</e>.
201By tweaking this line you can specify the max number of soundcards you have (generally, just one). 201By tweaking this line you can specify the max number of soundcards you have (generally, just one).
202</p> 202</p>
203<p> 203<p>
204<pre caption="At the bottom of /etc/modules.d/alsa"> 204<pre caption="At the bottom of /etc/modules.d/alsa">
205alias /dev/mixer snd-mixer-oss
206alias /dev/dsp snd-pcm-oss
207alias /dev/midi snd-seq-oss
208
209# Set this to the correct number of cards. 205# Set this to the correct number of cards.
210<c>options snd cards_limit=1</c> 206<c>options snd cards_limit=1</c>
211</pre> 207</pre>
212</p> 208</p>
213<p> 209<p>
214Now we'll specify the sounddriver(s) ALSA should use. In the same file, edit like this: 210Now we'll specify the sounddriver(s) ALSA should use. In the same file, edit like this:
215<pre caption="In /etc/modules.d/alsa"> 211<pre caption="In /etc/modules.d/alsa">
216## and then run `update-modules' command. 212## and then run `update-modules' command.
217## Read alsa-driver's INSTALL file in /usr/share/doc for more info. 213## Read alsa-driver's INSTALL file in /usr/share/doc for more info.
218## 214##
219## ALSA portion 215## ALSA portion
220<c>alias snd-card-0 snd-emu10k1</c> 216<c>alias snd-card-0 snd-emu10k1</c>
221<c>## If you have more than one, add: 217<c>## If you have more than one, add:
222## alias snd-card-1 snd-intel8x0 218## alias snd-card-1 snd-intel8x0
223## alias snd-card-2 snd-ens1370</c> 219## alias snd-card-2 snd-ens1370</c>
311<c>snd-mixer-oss</c> and <c>snd-pcm-oss</c> once. After that run amixer again. 307<c>snd-mixer-oss</c> and <c>snd-pcm-oss</c> once. After that run amixer again.
312</warn> 308</warn>
313</p> 309</p>
314<pre caption="only if you get an error when running amixer"> 310<pre caption="only if you get an error when running amixer">
315# <c>insmod snd-mixer-oss</c> 311# <c>insmod snd-mixer-oss</c>
316# <c>insmod snd-pcm-oss</c> 312# <c>insmod snd-pcm-oss</c>
317# <c>amixer</c> 313# <c>amixer</c>
318</pre> 314</pre>
319<p> 315<p>
320If you got this far, now unmute both Master and PCM channels. 316If you got this far, now unmute both Master and PCM channels.
321</p> 317</p>
322<p> 318<p>
323<pre> 319<pre>
324# <c>amixer set Master 100 unmute</c> 320# <c>amixer set Master 100 unmute</c>
325# <c>amixer set PCM 100 unmute</c> 321# <c>amixer set PCM 100 unmute</c>
326# <c>aplay /usr/kde/3/share/sounds/pop.wav</c> <codenote>(pop.wav is part of KDE)</codenote> 322# <c>aplay $KDEDIR/share/sounds/pop.wav</c> <codenote>(pop.wav is part of KDE)</codenote>
327</pre> 323</pre>
328</p> 324</p>
329We check to see if sound is working by using the aplay (alsa play) command. If you hear a pop, then sound is indeed working. 325We check to see if sound is working by using the aplay (alsa play) command. If you hear a pop, then sound is indeed working.
330Then, adjust the volume settings to your liking; the ncurses-based <c>alsamixer</c> is a great way to get them "just so". 326Then, adjust the volume settings to your liking; the ncurses-based <c>alsamixer</c> is a great way to get them "just so".
331<p> 327<p>
332You may want to emerge <c>alsa-xmms</c> as that will provide ALSA support for XMMS. 328You may want to emerge <c>alsa-xmms</c> as that will provide ALSA support for XMMS.
333</p> 329</p>
334When you reboot your system, the <e>alsasound</e> init script will properly save and restore your volume settings. 330When you reboot your system, the <e>alsasound</e> init script will properly save and restore your volume settings.
335</body> 331</body>
336</section> 332</section>
337</chapter> 333</chapter>
338<chapter> 334<chapter>
339<title>Final Notes</title> 335<title>Final Notes</title>
340<section> 336<section>
341 <title>After kernel-upgrades..</title> 337 <title>After kernel-upgrades..</title>

Legend:
Removed from v.1.8  
changed lines
  Added in v.1.9

  ViewVC Help
Powered by ViewVC 1.1.20