EliotBlennerhassett: copy and edit from Matrix:Soundcard, ?include this instead of template?

2007-08-09T03:26:21Z

copy and edit from Matrix:Soundcard, ?include this instead of template?

New page

{| align="right"
| __TOC__
|}

==Introduction==

There are two ways of getting Linux drivers to work, you can either compile them into the kernel or build them separately as modules. Read the [http://www.tldp.org/ Kernel-HOWTO] for details of how to compile a kernel.

'''You must turn on the sound support soundcore module.''' This is in the kernel. Look in the sound drivers directory and it should be the first option. Most people enable the module setting. That way you can load and unload the module manually if you have multiple soundcards/devices or if you intend to debug or use cutting edge software which may cause your drivers to halt sometimes. Of course it also means you have more control of your system.

Most modern distros come with <tt>soundcore</tt> compiled as a module. You can check this in numerous ways. The easiest way is to type:

modinfo soundcore

If this command returns that you have this module, then you don't need to recompile your kernel.

==Quick installation==

In the following, you need to replace '''yourmodule''' with the name of the module for your soundcard.

[[:Category:Module|The module list]] links to pages for each module where you can find out more about '''yourmodule'''.

Type the following commands in the shell of your choice.

{{Note|
''If you are using Hg ([http://www.selenic.com/mercurial/ Mercurial]) then you need to type:''

<nowiki>./hgcompile "or" make build</nowiki>

''instead of:''

<nowiki>./configure</nowiki>
|NB}}

Make a directory to store the alsa source code in:

cd ~/src
mkdir ~/src/alsa
cd ~/src/alsa
cp ~/downloads/alsa-* .

Now unzip and install the <tt>alsa-driver</tt> package:

bunzip2 alsa-driver-xxx
tar -xf alsa-driver-xxx
cd alsa-driver-xxx
./configure --with-cards='''yourmodule''' --with-sequencer=yes ; make ; make install

Now unzip and install the <tt>alsa-lib</tt> package:

cd ..
bunzip2 alsa-lib-xxx
tar -xf alsa-lib-xxx
cd alsa-lib-xxx
./configure ; make ; make install

Now unzip and install the <tt>alsa-utils</tt> package:

cd ..
bunzip2 alsa-utils-xxx
tar -xf alsa-utils-xxx
cd alsa-utils-xxx
./configure ; make ; make install

Now insert the modules into the kernel:

modprobe snd-'''yourmodule'''

Now adjust your soundcard's volume levels. All mixer channels are muted by default. You must use a native mixer program to unmute appropriate channels, for example <tt>alsamixer</tt> from the <tt>alsa-utils</tt> package. Note that some usb-audio devices do not have internal mixer controls. Run:

alsamixer

You can also look at the utils/alsasound file. This script is designed for the ''RedHat Linux'' distribution, but it can also be used with other distributions which use SystemV style rc init scripts. This will allow you to load your modules at boot time. If you don't want to do this you can of course compile them into the kernel instead and save yourself the hassle of coming to terms with the rc init scripts.

===Setting up modprobe and kmod support===

Before you send a mail complaining that "I don't have <tt>/etc/modules.conf</tt>, where do I find it ……" ‒ the <tt>/etc/conf.modules</tt> has been deprecated with a few distro's, but in your case it may still be <tt>/etc/conf.modules</tt>. Basically they are both the same, but recent version of <tt>modutils</tt> use <tt>/etc/modules.conf</tt> instead. Nothing to worry about as such, optionally please update to the latest version of <tt>modutils</tt>. This should solve your problem.

Here's the example for this card. Copy and paste this to the bottom of your <tt>/etc/modules.conf</tt> file.

{{Note|'''Debian GNU/Linux users''' need to save this information into a file in the <tt>/etc/modutils/</tt> directory (eg. <tt>/etc/modutils/alsa</tt>) and run <tt>update-modules</tt>.}}

# ALSA portion
alias char-major-116 snd
alias snd-card-0 snd-'''yourmodule'''
# module options should go here

# OSS/Free portion
alias char-major-14 soundcore
alias sound-slot-0 snd-card-0

# card #1
alias sound-service-0-0 snd-mixer-oss
alias sound-service-0-1 snd-seq-oss
alias sound-service-0-3 snd-pcm-oss
alias sound-service-0-8 snd-seq-oss
alias sound-service-0-12 snd-pcm-oss

To copy and paste the above to your <tt>/etc/modules.conf</tt> file follow these [http://www.alsa-project.org/alsa-doc/doc-php/file-edit.php instructions].

==modules.conf==

This is a short explanation of what happens in the <tt>/etc/modules.conf</tt> file.

===Native devices===

After the main multiplexer is loaded, its code automatically requests the top level sound card module. String <tt>snd-card-''%i''</tt> is requested for native devices where ''%i'' is the sound card number, counted from zero (the first sound card) to seven (the eighth sound card). String <tt>sound-slot-''%i''</tt> is requested for native devices where ''%i'' is slot number for the corresponding ALSA owner (which is basically the sound card number). The options line allows you to set various configuration options before the module is loaded. String <tt>id</tt> (or <tt>snd_id</tt>) lets you set the name of the card which is then returned in the <tt>/proc/asound/cards</tt> file, i.e. to user space applications. Other options may be available depending on the specific card. Options for these cards are found in the <tt>INSTALL</tt> file or above.

username@hostname# pico /etc/modules.conf

# ALSA portion
alias snd-card-0 snd-hda-intel
alias snd-card-1 snd-cmipci
options snd-cmipci id="first" mpu_port=0x330

# OSS/Free portion
alias sound-slot-0 snd-card-0
alias sound-slot-1 snd-card-1

===Autoloading OSS/free emulation===

At this point we are finished with the configuration for ALSA native devices, but you may also need autoloading for the OSS/Free emulation modules, an ALSA add-on. At this time only one module does not depend on any others, thus must be loaded separately: <tt>snd-pcm1-oss</tt>. String <tt>sound-service-''%i''-''%i''</tt> is required for OSS/Free service where the first ''%i'' is the slot number/sound card number and the second ''%i'' is the service number.

username@hostname# pico /etc/modules.conf

# OSS/Free portion - card #1
alias sound-slot-0 snd-card-0
alias sound-service-0-0 snd-mixer-oss
alias sound-service-0-1 snd-seq-oss
alias sound-service-0-3 snd-pcm-oss
alias sound-service-0-8 snd-seq-oss
alias sound-service-0-12 snd-pcm-oss

# OSS/Free portion - card #2 (cmipci)
alias sound-slot-1 snd-card-1
alias sound-service-1-0 snd-mixer-oss
alias sound-service-1-3 snd-pcm-oss
alias sound-service-1-12 snd-pcm-oss

The alias for <tt>snd-seq-oss</tt> is not necessary on the second device, because there is only one <tt>/dev/sequencer</tt> regardless how many devices you have.

==Further information==
<!-- Need to put some relevant links here --
*

----
Copied and edited from [[Matrix:Soundcard]]

[[Category:Module]]

Matrix:GenericInstructions - Revision history

EliotBlennerhassett: copy and edit from Matrix:Soundcard, ?include this instead of template?