ALSA is the Advanced Linux Sound Architecture, a project dedicated to the development of a high-quality Linux sound subsystem. It has replaced OSS (Open Sound System) as default sound subsystem in the 2.6 kernel series.

ALSA provides efficient support for all types of audio interfaces, is fully modularized, is SMP and thread-safe and provides a high-quality user space library called alsa-lib to simplify application programming. It also provides a backwards compatibility layer with OSS.

Gentoo provides an alsa USE flag which you should set in /etc/make.conf to allow our available packages to compile with ALSA support. If you have oss in your USE variable as well, ALSA will compile with OSS backward compatibility.

First of all, before continuing, make sure your kernel has Sound Card Support enabled. If you used genkernel to build your kernel, then this is automatically true. Otherwise reconfigure your kernel. Additionally, make sure you disable Open Sound System in your kernel configuration. If you don't, your system may try to use these drivers rather than the alsa ones. If you see a message about 'sound card not detected' and you are sure you have the correct driver, this is probably the reason.

The first step in installing your sound drivers is figuring out what sound card you have. If you don't already know, an easy trick is to search for "audio" in the output of the lspci command. You can install this tool with emerge pciutils.

# lspci | grep -i audio
Multimedia audio controller: VIA Technologies, Inc. VT82C686 AC97 Audio Controller (rev 64).

Now go to the ALSA Soundcard Matrix and search for your soundcard. In the above example you should go to the "VIA" manufacturer. You will receive a table with the known chipsets of that vendor. The chipset in the above example is "via82c686"; the "Details" link then informs me that the driver is called via82xx. This is all the information you need, so you can safely discard the rest of that document.

Based on this information we can now install the alsa-driver for our soundcard. First edit /etc/make.conf and add a new option called ALSA_CARDS to it. Inside this variable you declare the soundcard driver you want to use:

ALSA_CARDS="via82xx"

If you want OSS compatibility (highly recommended), you should add 'oss' to your USE flags in /etc/make.conf. After that, you are ready to install alsa-driver:

# emerge alsa-driver

If the in-kernel OSS compatibility is not sufficient for your needs, you will want to install alsa-oss. This will provide you with the 'aoss' executable which can be used as demonstrated:

# emerge alsa-oss
# aoss mpg123 music.mp3

Now install the ALSA Utils on your system (this is mandatory):

# emerge alsa-utils

Now that the utils are installed, it is time to configure ALSA...

If you use a modular kernel (such as when using genkernel) you have to edit /etc/modules.d/alsa so that it activates the necessary modules at boot time. For the soundcard in our example:

alias snd-card-0 snd-via82xx
# The following is only needed when you want OSS compatibility
alias sound-slot-0 snd-card-0
alias /dev/mixer snd-mixer-oss
alias /dev/dsp snd-pcm-oss
alias /dev/midi snd-seq-oss

Now run modules-update to save the changes you made to the alsa file into /etc/modules.conf:

# modules-update

This should be done automatically for you on recent installs, but if you run into problems, check that your ALSA devices and permissions are set correctly by your /dev manager. If you use DevFS, check /etc/devfsd.conf

# ALSA/OSS stuff
# Comment/change these if you want to change the permissions on
# the audio devices
LOOKUP          snd          MODLOAD ACTION snd
LOOKUP          dsp          MODLOAD
LOOKUP          mixer        MODLOAD
LOOKUP          midi         MODLOAD
REGISTER        sound/.*     PERMISSIONS root.audio 660
REGISTER        snd/.*       PERMISSIONS root.audio 660

To activate ALSA support at boot, add the alsasound init script to the boot runlevel:

# rc-update add alsasound boot
# /etc/init.d/alsasound start

By default, all sound channels are muted. To fix this, run amixer:

# amixer

If amixer produces lots of output then you're ready to unmute the channels. If you receive an error, doublecheck that your soundcard module is started.

Now unmute the Master and PCM channels. If this isn't sufficient, also unmute the Center and Surround channels.

(If you prefer an ncurses method:)

# alsamixer

(or)

# amixer set Master 100 unmute
# amixer set PCM 100 unmute
(Only if the above isn't sufficient:)
# amixer set Center 100 unmute
# amixer set Surround 100 unmute
# amixer set Headphone 100 unmute

To check if your sound works, play a wave file (using aplay), mp3 (using mpg123 or even mplayer) or any other sound file for that matter.

Some soundcards come with onboard MIDI synthesizers. To use them, you must first install the awesfx package:

# emerge awesfx

If you have a collection of sound fonts somewhere, place them in /usr/share/sfbank. For instance, the SBLive has a sound font file called 8MBGMSFX.SF2 or CT4GMSFX.SF2.

After copying over the sound font, select them using asfxload:

# asfxload /usr/share/sfbank/8MBGMSFX.SF2

You must have this command run every time you boot, so it is adviseable to add it to /etc/conf.d/local.start as well.

If you can't find soundfonts on your driver CD you can download some online from http://www.parabola.demon.co.uk/alsa/awe64.html.

If your sound card does not come with a hardware synthesizer (or you don't want to use it), you can use timidity++ to provide you with a virtual synthesizer. Start by emerging this package:

# emerge timidity++

For timidity to play sounds, it needs a soundfont. If you do not have any, install timidity-eawpatches or timidity-shompatches which will give you some soundfonts. You can have multiple soundfont configurations installed, and you can place your own in /usr/share/timidity/. To switch between different timidity configurations, you should use the timidity-update tool provided in the timidity++ package.

# emerge timidity-eawpatches
# timidity-update -g -s eawpatches

(or)

# emerge timidity-shompatches
# timidity-update -g -s shompatches

Don't forget to add timidity to the default runlevel.

# rc-update add timidity default
# /etc/init.d/timidity start

You can use aplaymidi from the ALSA Utils to test your MIDI configuration.

To see what MIDI output ports are available on your system, use the -l option:

# aplaymidi -l

If all looks fine, try playing a MIDI file to make sure everything works. With the -p option you define what MIDI port you want to use.

# aplaymidi -p 65:0 "Final Fantasy 7 - Aerith' Theme.mid"

Some specific sound cards can benefit from certain tools provided by the alsa-tools and alsa-firmware packages. If you need alsa-tools, be sure to define the ALSA_TOOLS variable in /etc/make.conf with the tools you require. For instance:

ALSA_TOOLS="as10k1 ac3dec"

Then install the alsa-tools (and/or alsa-firmware) package(s):

# emerge alsa-tools

If your soundcard has a joystick plug, you might be interested in activating joystick support for your soundcard. If so, start by verifying if your soundcard driver has a joystick parameter. You can verify this by running modinfo against your kernel module. For instance, for the snd-via82xx:

# modinfo snd-via82xx
filename:    /lib/modules/2.4.22-ck2/snd-via82xx.o
description: "VIA VT82xx audio"
author:      "Jaroslav Kysela <perex@suse.cz>"
license:     "GPL"
parm:        index int array (min = 1, max = 8), description "Index value for
             VIA 82xx bridge."
parm:        id string array (min = 1, max = 8), description "ID string for VIA
             82xx bridge."
parm:        enable int array (min = 1, max = 8), description "Enable audio part
             of VIA 82xx bridge."
parm:        mpu_port long array (min = 1, max = 8), description "MPU-401 port.
             (VT82C686x only)"
parm:        joystick int array (min = 1, max = 8), description "Enable
             joystick. (VT82C686x only)"
parm:        ac97_clock int array (min = 1, max = 8), description "AC'97 codec
             clock (default 48000Hz)."
parm:        dxs_support int array (min = 1, max = 8), description "Support for
             DXS channels (0 = auto, 1 = enable, 2 = disable, 3 = 48k only, 4 =
             no VRA)

If it has the joystick parameter, append joystick=1 to your options line in /etc/modules.d/alsa. For instance:

alias snd-card-0 snd-via82xx
options snd-via82xx joystick=1

• The ALSA Project
• ALSA Howto's and FAQs
• Linux Sound/MIDI Software