| 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> |
| 14 | This document helps a user setup ALSA on Gentoo Linux. |
14 | This 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 --> |
| … | |
… | |
| 221 | the way to go. |
221 | the way to go. |
| 222 | </p> |
222 | </p> |
| 223 | |
223 | |
| 224 | <note> |
224 | <note> |
| 225 | Since the 2005.0 release, Gentoo Linux uses 2.6 as the default kernel. Unless |
225 | Since the 2005.0 release, Gentoo Linux uses 2.6 as the default kernel. Unless |
| 226 | you are specifically using the 2.4 profile, <c>gentoo-sources</c> will be a |
226 | you are specifically using the 2.4 profile, <c>gentoo-sources</c> will be a |
| 227 | 2.6 kernel on <e>most</e> architectures. Please check that your kernel is a |
227 | 2.6 kernel on <e>most</e> architectures. Please check that your kernel is a |
| 228 | 2.6 series kernel. This method will <e>not</e> work on a 2.4 kernel. |
228 | 2.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> |
| 232 | Let us now configure the kernel to enable ALSA. |
232 | Let 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 |
| 237 | the instructions in <uri link="#doc_chap2_pre3">Kernel Options for ALSA</uri>. |
237 | then follow the instructions in <uri link="#doc_chap2_pre3">Kernel Options for |
|
|
238 | ALSA</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> |
| 246 | The above example assumes that <path>/usr/src/linux</path> symlink points to |
247 | The above example assumes that <path>/usr/src/linux</path> symlink points to |
| 247 | the kernel sources you want to use. Please ensure the same before proceeding. |
248 | the kernel sources you want to use. Please ensure the same before proceeding. |
| 248 | </note> |
249 | </note> |
| 249 | |
250 | |
| 250 | <p> |
251 | <p> |
| 251 | Now we will look at some of the options we will have to enable in the 2.6 |
252 | Now we will look at some of the options we will have to enable in the 2.6 |
| 252 | kernel to ensure proper ALSA support for our sound card. |
253 | kernel to ensure proper ALSA support for our sound card. |
| 253 | </p> |
254 | </p> |
| 254 | |
255 | |
| 255 | <p> |
256 | <p> |
| 256 | Please note that for the sake of ease, all examples show ALSA built as modules. |
257 | Please note that for the sake of ease, all examples show ALSA built as modules. |
| 257 | It is advisable to follow the same as it then allows the use of <c>alsaconf</c> |
258 | It is advisable to follow the same as it then allows the use of <c>alsaconf</c> |
| 258 | which is a boon when you want to configure your card. Please do <e>not</e> skip the <uri |
259 | which is a boon when you want to configure your card. Please do <e>not</e> skip |
| 259 | link="#alsa-config">Configuration</uri> section of this document. If you still |
260 | the <uri link="#alsa-config">Configuration</uri> section of this document. If |
| 260 | like to have options built-in, ensure that you make changes to your config |
261 | you still like to have options built-in, ensure that you make changes to your |
| 261 | accordingly. |
262 | config accordingly. |
| 262 | </p> |
263 | </p> |
| 263 | |
264 | |
| 264 | <pre caption="Kernel Options for ALSA"> |
265 | <pre caption="Kernel Options for ALSA"> |
| 265 | Device Drivers ---> |
266 | Device Drivers ---> |
| 266 | Sound ---> |
267 | Sound ---> |
| 267 | |
268 | |
| 268 | <comment>(This needs to be enabled)</comment> |
269 | <comment>(This needs to be enabled)</comment> |
| 269 | <M> Sound card support |
270 | <M> Sound card support |
| 270 | |
271 | |
| 271 | <comment>(Make sure OSS is disabled)</comment> |
272 | <comment>(Make sure OSS is disabled)</comment> |
| 272 | Open Sound System ---> |
273 | Open Sound System ---> |
| 273 | < > Open Sound System (DEPRECATED) |
274 | < > 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> |
| 276 | Advanced Linux Sound Architecture ---> |
277 | Advanced Linux Sound Architecture ---> |
| … | |
… | |
| 439 | The easiest way to configure your sound card is to run <c>alsaconf</c>. Just |
440 | The easiest way to configure your sound card is to run <c>alsaconf</c>. Just |
| 440 | type <c>alsaconf</c> in a shell as root. |
441 | type <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> |
| 448 | You will now see a neat menu guided interface that will automatically probe |
449 | You will now see a neat menu guided interface that will automatically probe |
| 449 | your devices and try to find out your sound card. You will be asked to pick |
450 | your devices and try to find out your sound card. You will be asked to pick |
| 450 | your sound card from a list. Once that's done, it will ask you permission to |
451 | your sound card from a list. Once that's done, it will ask you permission to |
| 451 | automatically make required changes to <path>/etc/modules.d/alsa</path>. |
452 | automatically make required changes to <path>/etc/modules.d/alsa</path>. |
| 452 | It will then adjust your volume settings to optimum levels, run |
453 | It 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. |
| 454 | Once <c>alsaconf</c> exits, you can proceed with setting up the ALSA initscript. |
455 | Once <c>alsaconf</c> exits, you can proceed with setting up the ALSA |
|
|
456 | initscript. |
| 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> |
| 464 | We're now almost all setup. Whichever method you chose to install ALSA, you'll |
466 | We're now almost all setup. Whichever method you chose to install ALSA, you'll |
| 465 | need to have something load your modules or initialize ALSA and restore your |
467 | need to have something load your modules or initialize ALSA and restore your |
| 466 | volume settings when your system comes up. The ALSA Initscript handles all of |
468 | volume settings when your system comes up. The ALSA Initscript handles all of |
| 467 | this for you and is called <c>alsasound</c>. Add it to the boot runlevel. |
469 | this for you and is called <c>alsasound</c>. Add it to the boot runlevel. |
| 468 | </p> |
470 | </p> |
| 469 | |
471 | |