| 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.87 2012/05/27 22:21:53 nightmorph Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/alsa-guide.xml,v 1.88 2012/07/24 12:12:51 swift Exp $ --> |
| 3 | |
3 | |
| 4 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
4 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 5 | |
5 | |
| 6 | <guide> |
6 | <guide> |
| 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> |
| 20 | This document helps a user setup ALSA on Gentoo Linux. |
20 | This 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>4</version> |
27 | <version>5</version> |
| 28 | <date>2012-05-27</date> |
28 | <date>2012-07-24</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> |
| 37 | ALSA, which stands for <e>Advanced Linux Sound Architecture</e>, provides audio |
37 | ALSA, which stands for <e>Advanced Linux Sound Architecture</e>, provides audio |
| 38 | and MIDI (<e>Musical Instrument Digital Interface</e>) functionality to the |
38 | and MIDI (<e>Musical Instrument Digital Interface</e>) functionality to the |
| 39 | Linux operating system. ALSA is the default sound subsystem in the 3.x and 2.6 |
39 | Linux operating system. ALSA is the default sound subsystem in the 3.x and 2.6 |
| 40 | kernels, thereby replacing OSS (<e>Open Sound System</e>), which was used in |
40 | kernels, thereby replacing OSS (<e>Open Sound System</e>), which was used in |
| 41 | the 2.4 kernels. |
41 | the 2.4 kernels. |
| 42 | </p> |
42 | </p> |
| 43 | |
43 | |
| … | |
… | |
| 99 | </pre> |
99 | </pre> |
| 100 | |
100 | |
| 101 | <p> |
101 | <p> |
| 102 | We now know that the sound card on the machine is a Sound Blaster Live! and the |
102 | We now know that the sound card on the machine is a Sound Blaster Live! and the |
| 103 | card manufacturer is Creative Labs. Head over to the <uri |
103 | card manufacturer is Creative Labs. Head over to the <uri |
| 104 | link="http://bugtrack.alsa-project.org/main/index.php/Matrix:Main">ALSA |
104 | link="http://bugtrack.alsa-project.org/main/index.php/Matrix:Main">ALSA |
| 105 | Soundcard Matrix</uri> page and select Creative Labs from the list. You will |
105 | Soundcard Matrix</uri> page and select Creative Labs from the list. You will |
| 106 | be taken to the Creative Labs matrix page where you can see that the SB Live! |
106 | be taken to the Creative Labs matrix page where you can see that the SB Live! |
| 107 | uses the <c>emu10k1</c> module. That is the information we need for now. If |
107 | uses the <c>emu10k1</c> module. That is the information we need for now. If |
| 108 | you are interested in detailed information, you can click on the link next to |
108 | you are interested in detailed information, you can click on the link next to |
| 109 | the "Details" and that will take you to the <c>emu10k1</c> specific page. |
109 | the "Details" and that will take you to the <c>emu10k1</c> specific page. |
| 110 | </p> |
110 | </p> |
| 111 | |
111 | |
| 112 | <p> |
112 | <p> |
| 113 | If you intend to use MIDI, then you should add <c>midi</c> to your USE flags in |
113 | If you intend to use MIDI, then you should add <c>midi</c> to your USE flags in |
| 114 | <path>/etc/make.conf</path> before emerging any ALSA packages. Later in the |
114 | <path>/etc/portage/make.conf</path> before emerging any ALSA packages. Later in the |
| 115 | guide, we will show you how to set up <uri link="#midi">MIDI support</uri>. |
115 | guide, we will show you how to set up <uri link="#midi">MIDI support</uri>. |
| 116 | </p> |
116 | </p> |
| 117 | |
117 | |
| 118 | </body> |
118 | </body> |
| 119 | </section> |
119 | </section> |
| 120 | <section id="kernel"> |
120 | <section id="kernel"> |
| 121 | <title>Configuring the kernel</title> |
121 | <title>Configuring the kernel</title> |
| 122 | <body> |
122 | <body> |
| 123 | |
123 | |
| 124 | <note> |
124 | <note> |
| 125 | Since the 2005.0 release, Gentoo Linux uses 2.6 as the default kernel. Please |
125 | Since the 2005.0 release, Gentoo Linux uses 2.6 as the default kernel. Please |
| 126 | check that your kernel is a 2.6 series kernel. This method will <e>not</e> work |
126 | check that your kernel is a 2.6 series kernel. This method will <e>not</e> work |
| 127 | on a 2.4 kernel. |
127 | on a 2.4 kernel. |
| 128 | </note> |
128 | </note> |
| 129 | |
129 | |
| … | |
… | |
| 448 | Transcoded: mp3;160 |
448 | Transcoded: mp3;160 |
| 449 | Title: Dread Rock |
449 | Title: Dread Rock |
| 450 | Artist: Paul Oakenfold |
450 | Artist: Paul Oakenfold |
| 451 | Date: 2003 |
451 | Date: 2003 |
| 452 | Album: Matrix Reloaded |
452 | Album: Matrix Reloaded |
| 453 | Time: 00:11.31 [04:28.75] of 04:40.06 (200.6 kbps) Output Buffer 96.9% |
453 | Time: 00:11.31 [04:28.75] of 04:40.06 (200.6 kbps) Output Buffer 96.9% |
| 454 | </pre> |
454 | </pre> |
| 455 | |
455 | |
| 456 | </body> |
456 | </body> |
| 457 | </section> |
457 | </section> |
| 458 | <section> |
458 | <section> |
| 459 | <title>ALSA and USE</title> |
459 | <title>ALSA and USE</title> |
| 460 | <body> |
460 | <body> |
| 461 | |
461 | |
| 462 | <p> |
462 | <p> |
| 463 | You can now add the <c>alsa</c> use flag to <path>/etc/make.conf</path> to |
463 | You can now add the <c>alsa</c> use flag to <path>/etc/portage/make.conf</path> to |
| 464 | ensure that your applications that support ALSA get built with it. Some |
464 | ensure that your applications that support ALSA get built with it. Some |
| 465 | architectures like x86 and amd64 have the flag enabled by default. |
465 | architectures like x86 and amd64 have the flag enabled by default. |
| 466 | </p> |
466 | </p> |
| 467 | |
467 | |
| 468 | </body> |
468 | </body> |
| 469 | </section> |
469 | </section> |
| 470 | <section> |
470 | <section> |
| 471 | <title>Issues?</title> |
471 | <title>Issues?</title> |
| 472 | <body> |
472 | <body> |
| 473 | |
473 | |
| 474 | <p> |
474 | <p> |
| 475 | If for some reason you're unable to hear sound, the first thing to do would |
475 | If for some reason you're unable to hear sound, the first thing to do would |
| 476 | be to check your <uri link="#doc_chap3_pre6">alsamixer</uri> settings. 80% of |
476 | be to check your <uri link="#doc_chap3_pre6">alsamixer</uri> settings. 80% of |
| 477 | the issues lie with muted channels or low volume. Also check your Window |
477 | the issues lie with muted channels or low volume. Also check your Window |
| 478 | Manager's sound applet and verify that volumes are set to audible levels. |
478 | Manager's sound applet and verify that volumes are set to audible levels. |
| … | |
… | |
| 616 | |
616 | |
| 617 | <!-- End of removal notice --> |
617 | <!-- End of removal notice --> |
| 618 | |
618 | |
| 619 | </body> |
619 | </body> |
| 620 | </section> |
620 | </section> |
| 621 | </chapter> |
621 | </chapter> |
| 622 | |
622 | |
| 623 | <chapter> |
623 | <chapter> |
| 624 | <title>Other things ALSA</title> |
624 | <title>Other things ALSA</title> |
| 625 | <section id="midi"> |
625 | <section id="midi"> |
| 626 | <title>Setting up MIDI support</title> |
626 | <title>Setting up MIDI support</title> |
| 627 | <body> |
627 | <body> |
| 628 | |
628 | |
| 629 | <p> |
629 | <p> |
| 630 | First, check to make sure that you enabled the <c>midi</c> USE flag in |
630 | First, check to make sure that you enabled the <c>midi</c> USE flag in |
| 631 | <path>/etc/make.conf</path>. If you didn't, go ahead and add it now. You will |
631 | <path>/etc/portage/make.conf</path>. If you didn't, go ahead and add it now. You will |
| 632 | also need to re-emerge any ALSA packages that use the <c>midi</c> flag, such as |
632 | also need to re-emerge any ALSA packages that use the <c>midi</c> flag, such as |
| 633 | <c>alsa-lib</c> and <c>alsa-utils</c>. |
633 | <c>alsa-lib</c> and <c>alsa-utils</c>. |
| 634 | </p> |
634 | </p> |
| 635 | |
635 | |
| 636 | <p> |
636 | <p> |
| 637 | If your sound card is one of those that come with on-board MIDI synthesizers |
637 | If your sound card is one of those that come with on-board MIDI synthesizers |
| 638 | and you would like to listen to some .mid files, you have to install |
638 | and you would like to listen to some .mid files, you have to install |
| 639 | <c>awesfx</c> which is basically a set of utilities for controlling the AWE32 |
639 | <c>awesfx</c> which is basically a set of utilities for controlling the AWE32 |
| 640 | driver. We need to install it first. If you don't have a hardware synthesizer, |
640 | driver. We need to install it first. If you don't have a hardware synthesizer, |
| 641 | you can use a virtual one. Please see the section on |
641 | you can use a virtual one. Please see the section on |
| 642 | <uri link="#vsynth">Virtual Synthesizers</uri> for more information. |
642 | <uri link="#vsynth">Virtual Synthesizers</uri> for more information. |
| 643 | </p> |
643 | </p> |
| 644 | |
644 | |
| 645 | <pre caption="Installing awesfx"> |
645 | <pre caption="Installing awesfx"> |
| 646 | # <i>emerge awesfx</i> |
646 | # <i>emerge awesfx</i> |