/[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.41 Revision 1.42
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.41 2004/08/29 14:15:34 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/alsa-guide.xml,v 1.42 2004/10/31 18:57:00 cam 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">
11 <mail link="g2boojum@gentoo.org">Grant Goodyear</mail> 11 <mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
12</author> 12</author>
13<author title="Author"> 13<author title="Author">
14 <mail link="agenkin@gentoo.org">Arcady Genkin</mail> 14 <mail link="agenkin@gentoo.org">Arcady Genkin</mail>
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">
26 <mail link="bennyc@gentoo.org">Benny Chuang</mail> 26 <mail link="bennyc@gentoo.org">Benny Chuang</mail>
27</author> 27</author>
28<author title="Editor"> 28<author title="Editor">
29 <mail link="blubber@gentoo.org">Tiemo Kieft</mail> 29 <mail link="blubber@gentoo.org">Tiemo Kieft</mail>
30</author> 30</author>
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.4</version> 43<version>1.5.5</version>
44<date>August 29, 2004</date> 44<date>October 31, 2004</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>
50<body> 50<body>
51 51
52<p> 52<p>
53ALSA is the <e>Advanced Linux Sound Architecture</e>, a project dedicated to the 53ALSA is the <e>Advanced Linux Sound Architecture</e>, a project dedicated to the
54development of a high-quality Linux sound subsystem. It has replaced OSS 54development of a high-quality Linux sound subsystem. It has replaced OSS
55(<e>Open Sound System</e>) as default sound subsystem in the 2.6 kernel series. 55(<e>Open Sound System</e>) as default sound subsystem in the 2.6 kernel series.
56</p> 56</p>
57 57
58<p> 58<p>
59ALSA provides efficient support for all types of audio interfaces, is fully 59ALSA provides efficient support for all types of audio interfaces, is fully
61library called <e>alsa-lib</e> to simplify application programming. It also 61library called <e>alsa-lib</e> to simplify application programming. It also
62provides a backwards compatibility layer with OSS. 62provides a backwards compatibility layer with OSS.
63</p> 63</p>
64 64
65</body> 65</body>
66</section> 66</section>
67</chapter> 67</chapter>
68<chapter> 68<chapter>
69<title>Installing ALSA</title> 69<title>Installing ALSA</title>
70<section> 70<section>
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>
82</section> 82</section>
83<section> 83<section>
84<title>Kernel Modules</title> 84<title>Kernel Modules</title>
85<body> 85<body>
86 86
87<p> 87<p>
88First of all, before continuing, make sure your kernel has <e>Sound Card 88First of all, before continuing, make sure your kernel has <e>Sound Card
89Support</e> enabled. If you used <c>genkernel</c> to build your kernel, then 89Support</e> enabled. If you used <c>genkernel</c> to build your kernel, then
90this is automatically true. Otherwise reconfigure your kernel. 90this is automatically true. Otherwise reconfigure your kernel.
91</p> 91</p>
358Don't forget to add <c>timidity</c> to the default runlevel. 358Don't forget to add <c>timidity</c> to the default runlevel.
359</p> 359</p>
360 360
361<pre caption="Adding timidity to the default runlevel"> 361<pre caption="Adding timidity to the default runlevel">
362# <i>rc-update add timidity default</i> 362# <i>rc-update add timidity default</i>
363# <i>/etc/init.d/timidity start</i> 363# <i>/etc/init.d/timidity start</i>
364</pre> 364</pre>
365 365
366</body> 366</body>
367</section> 367</section>
368<section> 368<section>
369<title>Testing MIDI Support</title> 369<title>Testing MIDI Support</title>
370<body> 370<body>
371 371
372<p> 372<p>
373You can use <c>pmidi</c> to test your MIDI configuration: 373You can use <c>aplaymidi</c> from the ALSA Utils to test your MIDI
374</p> 374configuration.
375
376<pre caption="Installing pmidi">
377# <i>emerge pmidi</i>
378</pre> 375</p>
379 376
380<p> 377<p>
381To see what MIDI output ports are available on your system, use the <c>-l</c> 378To see what MIDI output ports are available on your system, use the <c>-l</c>
382option: 379option:
383</p> 380</p>
384 381
385<pre caption="Viewing the MIDI output ports"> 382<pre caption="Viewing the MIDI output ports">
386# <i>pmidi -l</i> 383# <i>aplaymidi -l</i>
387</pre> 384</pre>
388 385
389<p> 386<p>
390If all looks fine, try playing a MIDI file to make sure everything works. With 387If all looks fine, try playing a MIDI file to make sure everything works. With
391the <c>-p</c> option you define what MIDI port you want to use. 388the <c>-p</c> option you define what MIDI port you want to use.
392</p> 389</p>
393 390
394<pre caption="Playing a MIDI file"> 391<pre caption="Playing a MIDI file">
395# <i>pmidi -p 65:0 "Final Fantasy 7 - Aerith' Theme.mid"</i> 392# <i>aplaymidi -p 65:0 "Final Fantasy 7 - Aerith' Theme.mid"</i>
396</pre> 393</pre>
397 394
398</body> 395</body>
399</section> 396</section>
400</chapter> 397</chapter>
401<chapter> 398<chapter>
402<title>Final Remarks</title> 399<title>Final Remarks</title>
403<section> 400<section>
404<title>Tools and Firmware</title> 401<title>Tools and Firmware</title>
405<body> 402<body>
406 403
407<p> 404<p>
408Some specific sound cards can benefit from certain tools provided by the 405Some specific sound cards can benefit from certain tools provided by the
409<c>alsa-tools</c> and <c>alsa-firmware</c> packages. If you need 406<c>alsa-tools</c> and <c>alsa-firmware</c> packages. If you need
410<c>alsa-tools</c>, be sure to define the ALSA_TOOLS variable in 407<c>alsa-tools</c>, be sure to define the ALSA_TOOLS variable in
440# <i>modinfo snd-via82xx</i> 437# <i>modinfo snd-via82xx</i>
441filename: /lib/modules/2.4.22-ck2/snd-via82xx.o 438filename: /lib/modules/2.4.22-ck2/snd-via82xx.o
442description: "VIA VT82xx audio" 439description: "VIA VT82xx audio"
443author: "Jaroslav Kysela &lt;perex@suse.cz&gt;" 440author: "Jaroslav Kysela &lt;perex@suse.cz&gt;"
444license: "GPL" 441license: "GPL"
445parm: index int array (min = 1, max = 8), description "Index value for 442parm: index int array (min = 1, max = 8), description "Index value for
446 VIA 82xx bridge." 443 VIA 82xx bridge."
447parm: id string array (min = 1, max = 8), description "ID string for VIA 444parm: id string array (min = 1, max = 8), description "ID string for VIA
448 82xx bridge." 445 82xx bridge."
449parm: enable int array (min = 1, max = 8), description "Enable audio part 446parm: enable int array (min = 1, max = 8), description "Enable audio part
450 of VIA 82xx bridge." 447 of VIA 82xx bridge."
451parm: mpu_port long array (min = 1, max = 8), description "MPU-401 port. 448parm: mpu_port long array (min = 1, max = 8), description "MPU-401 port.
452 (VT82C686x only)" 449 (VT82C686x only)"
453<i>parm: joystick int array (min = 1, max = 8), description "Enable 450<i>parm: joystick int array (min = 1, max = 8), description "Enable
454 joystick. (VT82C686x only)"</i> 451 joystick. (VT82C686x only)"</i>
455parm: ac97_clock int array (min = 1, max = 8), description "AC'97 codec 452parm: ac97_clock int array (min = 1, max = 8), description "AC'97 codec
456 clock (default 48000Hz)." 453 clock (default 48000Hz)."
457parm: dxs_support int array (min = 1, max = 8), description "Support for 454parm: dxs_support int array (min = 1, max = 8), description "Support for
458 DXS channels (0 = auto, 1 = enable, 2 = disable, 3 = 48k only, 4 = 455 DXS channels (0 = auto, 1 = enable, 2 = disable, 3 = 48k only, 4 =
459 no VRA) 456 no VRA)
460</pre> 457</pre>
461 458
462<p> 459<p>
463If it has the <c>joystick</c> parameter, append <c>joystick=1</c> to your 460If it has the <c>joystick</c> parameter, append <c>joystick=1</c> to your
464<c>options</c> line in <path>/etc/modules.d/alsa</path>. For instance: 461<c>options</c> line in <path>/etc/modules.d/alsa</path>. For instance:
465</p> 462</p>
466 463
467<pre caption="Adding the joystick parameter"> 464<pre caption="Adding the joystick parameter">
468alias snd-card-0 snd-via82xx 465alias snd-card-0 snd-via82xx
469options snd-via82xx joystick=1 466options snd-via82xx joystick=1
470</pre> 467</pre>
471 468
472</body> 469</body>
473</section> 470</section>

Legend:
Removed from v.1.41  
changed lines
  Added in v.1.42

  ViewVC Help
Powered by ViewVC 1.1.20