/[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.37 Revision 1.44
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.37 2004/06/15 07:21:07 bennyc Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/alsa-guide.xml,v 1.44 2004/12/02 13:02:18 swift Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide link = "/doc/en/alsa-guide.xml"> 5<guide link="/doc/en/alsa-guide.xml">
6<title>Gentoo Linux ALSA Guide</title> 6<title>Gentoo Linux ALSA Guide</title>
7<author title="Author"> 7<author title="Author">
8 <mail link="zu@pandora.be">Vincent Verleye</mail> 8 <mail link="zu@pandora.be">Vincent Verleye</mail>
9</author> 9</author>
10<author title="Author"> 10<author title="Author">
15</author> 15</author>
16<author title="Author"> 16<author title="Author">
17 <mail link="eradicator@gentoo.org">Jeremy Huddleston</mail> 17 <mail link="eradicator@gentoo.org">Jeremy Huddleston</mail>
18</author> 18</author>
19<author title="Editor"><!-- zhen@gentoo.org --> 19<author title="Editor"><!-- zhen@gentoo.org -->
20 John P. Davis 20 John P. Davis
21</author> 21</author>
22<author title="Editor"> 22<author title="Editor">
23 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 23 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
24</author> 24</author>
25<author title="Editor"> 25<author title="Editor">
31<author title="Editor"> 31<author title="Editor">
32 <mail link="erwin@gentoo.org">Erwin</mail> 32 <mail link="erwin@gentoo.org">Erwin</mail>
33</author> 33</author>
34 34
35<abstract> 35<abstract>
36This guide will show you how to set up the Advanced Linux Sound Architecture 36This guide will show you how to set up the Advanced Linux Sound Architecture
37(ALSA) on Gentoo Linux. In addition to the Gentoo Linux Desktop Configuration 37(ALSA) on Gentoo Linux. In addition to the Gentoo Linux Desktop Configuration
38Guide, this guide is supposed to give you more information on this subject. 38Guide, this guide is supposed to give you more information on this subject.
39</abstract> 39</abstract>
40 40
41<license/> 41<license/>
42 42
43<version>1.5.0</version> 43<version>1.5.6</version>
44<date>May 18, 2004</date> 44<date>2004-12-02</date>
45 45
46<chapter> 46<chapter>
47<title>The Advanced Linux Sound Architecture</title> 47<title>The Advanced Linux Sound Architecture</title>
48<section> 48<section>
49<title>What is ALSA?</title> 49<title>What is ALSA?</title>
71<title>USE Flags</title> 71<title>USE Flags</title>
72<body> 72<body>
73 73
74<p> 74<p>
75Gentoo provides an <c>alsa</c> USE flag which you should set in 75Gentoo provides an <c>alsa</c> USE flag which you should set in
76<path>/etc/make.conf</path> to allow our available packages to compile with 76<path>/etc/make.conf</path> to allow our available packages to compile with
77ALSA support. If you have <c>oss</c> in your USE variable as well, ALSA will 77ALSA support. If you have <c>oss</c> in your USE variable as well, ALSA will
78compile with OSS backward compatibility. 78compile with OSS backward compatibility.
79</p> 79</p>
80 80
81</body> 81</body>
98</p> 98</p>
99 99
100<p> 100<p>
101Users of 2.4 kernel sources will have to install the necessary ALSA drivers for 101Users of 2.4 kernel sources will have to install the necessary ALSA drivers for
102their soundcard. First find out what soundcard you have. An easy trick is to 102their soundcard. First find out what soundcard you have. An easy trick is to
103search for "audio" in <path>/proc/pci</path>: 103search for "audio" in the output of the <c>lspci</c> command. You can install
104it with <c>emerge pciutils</c>.
104</p> 105</p>
105 106
106<pre caption="Finding out the soundcard type"> 107<pre caption="Finding out the soundcard type">
107# <i>grep -i audio /proc/pci</i> 108# <i>lspci | grep -i audio</i>
108Multimedia audio controller: VIA Technologies, Inc. VT82C686 AC97 Audio 109Multimedia audio controller: VIA Technologies, Inc. VT82C686 AC97 Audio Controller (rev 64).
109Controller (rev 64).
110</pre> 110</pre>
111 111
112<p> 112<p>
113Now go to the <uri link="http://www.alsa-project.org/alsa-doc">ALSA Soundcard 113Now go to the <uri link="http://www.alsa-project.org/alsa-doc">ALSA Soundcard
114Matrix</uri> and search for your soundcard. In the above example you should go 114Matrix</uri> and search for your soundcard. In the above example you should go
115to the "VIA" manufacturer. You will receive a table with the known chipsets of 115to the "VIA" manufacturer. You will receive a table with the known chipsets of
116that vendor. The chipset in the above example is "via82c686"; the "Details" link 116that vendor. The chipset in the above example is "via82c686"; the "Details" link
117then informs me that the driver is called <path>via82xx</path>. 117then informs me that the driver is called <path>via82xx</path>. This is all the
118information you need, so you can safely discard the rest of that document.
118</p> 119</p>
119 120
120<p> 121<p>
121Based on this information we can now install the <c>alsa-driver</c> for our 122Based on this information we can now install the <c>alsa-driver</c> for our
122soundcard. First edit <path>/etc/make.conf</path> and <e>add</e> a new option 123soundcard. First edit <path>/etc/make.conf</path> and <e>add</e> a new option
272# <i>amixer set Master 100 unmute</i> 273# <i>amixer set Master 100 unmute</i>
273# <i>amixer set PCM 100 unmute</i> 274# <i>amixer set PCM 100 unmute</i>
274<comment>(Only if the above isn't sufficient:)</comment> 275<comment>(Only if the above isn't sufficient:)</comment>
275# <i>amixer set Center 100 unmute</i> 276# <i>amixer set Center 100 unmute</i>
276# <i>amixer set Surround 100 unmute</i> 277# <i>amixer set Surround 100 unmute</i>
278# <i>amixer set Headphone 100 unmute</i>
277</pre> 279</pre>
278 280
279<p> 281<p>
280To check if your sound works, play a wave file (using <c>aplay</c>), mp3 (using 282To check if your sound works, play a wave file (using <c>aplay</c>), mp3 (using
281<c>mpg123</c> or even <c>mplayer</c>) or any other sound file for that matter. 283<c>mpg123</c> or even <c>mplayer</c>) or any other sound file for that matter.
309<path>/usr/share/sfbank</path>. For instance, the SBLive has a sound font file 311<path>/usr/share/sfbank</path>. For instance, the SBLive has a sound font file
310called <path>8MBGMSFX.SF2</path> or <path>CT4GMSFX.SF2</path>. 312called <path>8MBGMSFX.SF2</path> or <path>CT4GMSFX.SF2</path>.
311</p> 313</p>
312 314
313<p> 315<p>
314After copying over the sound font, select them using <c>sfxload</c>: 316After copying over the sound font, select them using <c>asfxload</c>:
315</p> 317</p>
316 318
317<pre caption="Loading the sound font"> 319<pre caption="Loading the sound font">
318# <i>sfxload /usr/share/sfbank/8MBGMSFX.SF2</i> 320# <i>asfxload /usr/share/sfbank/8MBGMSFX.SF2</i>
319</pre> 321</pre>
320 322
321<p> 323<p>
322You must have this command run every time you boot, so it is adviseable to add 324You must have this command run every time you boot, so it is adviseable to add
323it to <path>/etc/conf.d/local.start</path> as well. 325it to <path>/etc/conf.d/local.start</path> as well.
343<pre caption="Installing Timidity++"> 345<pre caption="Installing Timidity++">
344# <i>emerge timidity++</i> 346# <i>emerge timidity++</i>
345</pre> 347</pre>
346 348
347<p> 349<p>
348A sample configuration file will be installed for you in
349<path>/usr/share/timidity/config/timidity.cfg</path>. If you don't have a
350timidity++ configuration setup yet, you can just use this one.
351</p>
352
353<pre caption="Using the default Timidity++ configuration file">
354# <i>cp /usr/share/timidity/config/timidity.cfg /usr/share/timidity</i>
355</pre>
356
357<p>
358For timidity to play sounds, it needs a soundfont. If you do not have any, 350For timidity to play sounds, it needs a soundfont. If you do not have any,
359install <c>timidity-eawpatches</c> which will give you some soundfonts. 351install <c>timidity-eawpatches</c> which will give you some soundfonts.
360</p> 352</p>
361 353
362<pre caption="Installing timidity-eawpatches"> 354<pre caption="Installing timidity-eawpatches">
377<section> 369<section>
378<title>Testing MIDI Support</title> 370<title>Testing MIDI Support</title>
379<body> 371<body>
380 372
381<p> 373<p>
382You can use <c>pmidi</c> to test your MIDI configuration: 374You can use <c>aplaymidi</c> from the ALSA Utils to test your MIDI
383</p> 375configuration.
384
385<pre caption="Installing pmidi">
386# <i>emerge pmidi</i>
387</pre> 376</p>
388 377
389<p> 378<p>
390To see what MIDI output ports are available on your system, use the <c>-l</c> 379To see what MIDI output ports are available on your system, use the <c>-l</c>
391option: 380option:
392</p> 381</p>
393 382
394<pre caption="Viewing the MIDI output ports"> 383<pre caption="Viewing the MIDI output ports">
395# <i>pmidi -l</i> 384# <i>aplaymidi -l</i>
396</pre> 385</pre>
397 386
398<p> 387<p>
399If all looks fine, try playing a MIDI file to make sure everything works. With 388If all looks fine, try playing a MIDI file to make sure everything works. With
400the <c>-p</c> option you define what MIDI port you want to use. 389the <c>-p</c> option you define what MIDI port you want to use.
401</p> 390</p>
402 391
403<pre caption="Playing a MIDI file"> 392<pre caption="Playing a MIDI file">
404# <i>pmidi -p 65:0 "Final Fantasy 7 - Aerith' Theme.mid"</i> 393# <i>aplaymidi -p 65:0 "Final Fantasy 7 - Aerith' Theme.mid"</i>
405</pre> 394</pre>
406 395
407</body> 396</body>
408</section> 397</section>
409</chapter> 398</chapter>
459 of VIA 82xx bridge." 448 of VIA 82xx bridge."
460parm: mpu_port long array (min = 1, max = 8), description "MPU-401 port. 449parm: mpu_port long array (min = 1, max = 8), description "MPU-401 port.
461 (VT82C686x only)" 450 (VT82C686x only)"
462<i>parm: joystick int array (min = 1, max = 8), description "Enable 451<i>parm: joystick int array (min = 1, max = 8), description "Enable
463 joystick. (VT82C686x only)"</i> 452 joystick. (VT82C686x only)"</i>
464parm: ac97_clock int array (min = 1, max = 8), description "AC'97 codec 453parm: ac97_clock int array (min = 1, max = 8), description "AC'97 codec
465 clock (default 48000Hz)." 454 clock (default 48000Hz)."
466parm: dxs_support int array (min = 1, max = 8), description "Support for 455parm: dxs_support int array (min = 1, max = 8), description "Support for
467 DXS channels (0 = auto, 1 = enable, 2 = disable, 3 = 48k only, 4 = 456 DXS channels (0 = auto, 1 = enable, 2 = disable, 3 = 48k only, 4 =
468 no VRA) 457 no VRA)
469</pre> 458</pre>
470 459
471<p> 460<p>
472If it has the <c>joystick</c> parameter, append <c>joystick=1</c> to your 461If it has the <c>joystick</c> parameter, append <c>joystick=1</c> to your

Legend:
Removed from v.1.37  
changed lines
  Added in v.1.44

  ViewVC Help
Powered by ViewVC 1.1.20