/[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.62 Revision 1.63
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.62 2005/09/10 18:02:53 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/alsa-guide.xml,v 1.63 2005/10/30 16:02:55 fox2mike Exp $ -->
3 3
4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5 5
6<guide link="/doc/en/alsa-guide.xml"> 6<guide link="/doc/en/alsa-guide.xml">
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 12
13<abstract> 13<abstract>
14This document helps a user setup ALSA on Gentoo Linux. 14This document helps a user setup ALSA on Gentoo Linux.
15</abstract> 15</abstract>
16 16
17<!-- The content of this document is licensed under the CC-BY-SA license --> 17<!-- The content of this document is licensed under the CC-BY-SA license -->
221the way to go. 221the way to go.
222</p> 222</p>
223 223
224<note> 224<note>
225Since the 2005.0 release, Gentoo Linux uses 2.6 as the default kernel. Unless 225Since the 2005.0 release, Gentoo Linux uses 2.6 as the default kernel. Unless
226you are specifically using the 2.4 profile, <c>gentoo-sources</c> will be a 226you are specifically using the 2.4 profile, <c>gentoo-sources</c> will be a
2272.6 kernel on <e>most</e> architectures. Please check that your kernel is a 2272.6 kernel on <e>most</e> architectures. Please check that your kernel is a
2282.6 series kernel. This method will <e>not</e> work on a 2.4 kernel. 2282.6 series kernel. This method will <e>not</e> work on a 2.4 kernel.
229</note> 229</note>
230 230
231<p> 231<p>
232Let us now configure the kernel to enable ALSA. 232Let us now configure the kernel to enable ALSA.
233</p> 233</p>
234 234
235<impo> 235<impo>
236<c>genkernel</c> users should now run <c>genkernel --menuconfig all</c> and then follow 236<c>genkernel</c> users should now run <c>genkernel --menuconfig all</c> and
237the instructions in <uri link="#doc_chap2_pre3">Kernel Options for ALSA</uri>. 237then follow the instructions in <uri link="#doc_chap2_pre3">Kernel Options for
238ALSA</uri>.
238</impo> 239</impo>
239 240
240<pre caption="Heading over to the source"> 241<pre caption="Heading over to the source">
241# <i>cd /usr/src/linux</i> 242# <i>cd /usr/src/linux</i>
242# <i>make menuconfig</i> 243# <i>make menuconfig</i>
243</pre> 244</pre>
244 245
245<note> 246<note>
246The above example assumes that <path>/usr/src/linux</path> symlink points to 247The above example assumes that <path>/usr/src/linux</path> symlink points to
247the kernel sources you want to use. Please ensure the same before proceeding. 248the kernel sources you want to use. Please ensure the same before proceeding.
248</note> 249</note>
249 250
250<p> 251<p>
251Now we will look at some of the options we will have to enable in the 2.6 252Now we will look at some of the options we will have to enable in the 2.6
252kernel to ensure proper ALSA support for our sound card. 253kernel to ensure proper ALSA support for our sound card.
253</p> 254</p>
254 255
255<p> 256<p>
256Please note that for the sake of ease, all examples show ALSA built as modules. 257Please note that for the sake of ease, all examples show ALSA built as modules.
257It is advisable to follow the same as it then allows the use of <c>alsaconf</c> 258It is advisable to follow the same as it then allows the use of <c>alsaconf</c>
258which is a boon when you want to configure your card. Please do <e>not</e> skip the <uri 259which is a boon when you want to configure your card. Please do <e>not</e> skip
259link="#alsa-config">Configuration</uri> section of this document. If you still 260the <uri link="#alsa-config">Configuration</uri> section of this document. If
260like to have options built-in, ensure that you make changes to your config 261you still like to have options built-in, ensure that you make changes to your
261accordingly. 262config accordingly.
262</p> 263</p>
263 264
264<pre caption="Kernel Options for ALSA"> 265<pre caption="Kernel Options for ALSA">
265Device Drivers ---&gt; 266Device Drivers ---&gt;
266 Sound ---&gt; 267 Sound ---&gt;
267 268
268<comment>(This needs to be enabled)</comment> 269<comment>(This needs to be enabled)</comment>
269&lt;M&gt; Sound card support 270&lt;M&gt; Sound card support
270 271
271<comment>(Make sure OSS is disabled)</comment> 272<comment>(Make sure OSS is disabled)</comment>
272Open Sound System ---&gt; 273Open Sound System ---&gt;
273 &lt; &gt; Open Sound System (DEPRECATED) 274 &lt; &gt; Open Sound System (DEPRECATED)
274 275
275<comment>(Move one step back and enter ALSA)</comment> 276<comment>(Move one step back and enter ALSA)</comment>
276Advanced Linux Sound Architecture ---&gt; 277Advanced Linux Sound Architecture ---&gt;
439The easiest way to configure your sound card is to run <c>alsaconf</c>. Just 440The easiest way to configure your sound card is to run <c>alsaconf</c>. Just
440type <c>alsaconf</c> in a shell as root. 441type <c>alsaconf</c> in a shell as root.
441</p> 442</p>
442 443
443<pre caption="Invoking alsaconf"> 444<pre caption="Invoking alsaconf">
444# <i>alsaconf</i> 445# <i>alsaconf</i>
445</pre> 446</pre>
446 447
447<p> 448<p>
448You will now see a neat menu guided interface that will automatically probe 449You will now see a neat menu guided interface that will automatically probe
449your devices and try to find out your sound card. You will be asked to pick 450your devices and try to find out your sound card. You will be asked to pick
450your sound card from a list. Once that's done, it will ask you permission to 451your sound card from a list. Once that's done, it will ask you permission to
451automatically make required changes to <path>/etc/modules.d/alsa</path>. 452automatically make required changes to <path>/etc/modules.d/alsa</path>.
452It will then adjust your volume settings to optimum levels, run 453It will then adjust your volume settings to optimum levels, run
453<c>modules-update</c> and start the <path>/etc/init.d/alsasound</path> service. 454<c>modules-update</c> and start the <path>/etc/init.d/alsasound</path> service.
454Once <c>alsaconf</c> exits, you can proceed with setting up the ALSA initscript. 455Once <c>alsaconf</c> exits, you can proceed with setting up the ALSA
456initscript.
455</p> 457</p>
456 458
457</body> 459</body>
458</section> 460</section>
459<section id="initscript"> 461<section id="initscript">
460<title>ALSA Initscript</title> 462<title>ALSA Initscript</title>
461<body> 463<body>
462 464
463<p> 465<p>
464We're now almost all setup. Whichever method you chose to install ALSA, you'll 466We're now almost all setup. Whichever method you chose to install ALSA, you'll
465need to have something load your modules or initialize ALSA and restore your 467need to have something load your modules or initialize ALSA and restore your
466volume settings when your system comes up. The ALSA Initscript handles all of 468volume settings when your system comes up. The ALSA Initscript handles all of
467this for you and is called <c>alsasound</c>. Add it to the boot runlevel. 469this for you and is called <c>alsasound</c>. Add it to the boot runlevel.
468</p> 470</p>
469 471

Legend:
Removed from v.1.62  
changed lines
  Added in v.1.63

  ViewVC Help
Powered by ViewVC 1.1.20