Advanced Linux Sound Architecture - Driver
==========================================
    Installation guide


The ALSA driver replaces the OSS/Free driver. The OSS/Free driver is
present in current Linux kernels (2.2).  Since version 0.4.0, ALSA has
supported only 2.2+ kernels. The 2.0 kernels are no longer supported. You
must compile the kernel with sound support (you do not need to select
any of the other sound modules apart from sound support).

Before installing this driver, it will be helpful to read carefully
the documentation for insmod, modprobe, kmod and for the isapnp
module if you have an ISA PnP soundcard.

Module option name change after 0.9.0rc3
========================================

Note that module option names were changed in 0.9.0rc4. The 'snd_' prefix
was removed. You may use script in utils directory (module-options) to
convert your older /etc/modules.conf to newer one.

Quick install
=============

1) You must have full configured source for the Linux kernel which you
   want to use for the ALSA drivers. Note that ALSA drivers are part
   of the kernel, so there is necessary to resolve all symbol dependencies
   between the used kernel and ALSA driver code. Partly installed kernels
   (for example from distributor makers) can be unuseable for this action.
2) You must turn on sound support (soundcore module).
3) Run './configure' script.
   If you have ISA Plug & Play soundcard, use --with-isapnp=yes switch.
   If you want sequencer support, use --with-sequencer=yes switch.
   If you do not want OSS/Free emulation, use --with-oss=no switch.
   If you want turn on debug mode use --with-debug=full switch.
   If you want debug soundcard detection try --with-debug=detect switch.
   If you have kernel source code in another directory than /usr/src/linux,
   use --with-kernel=<kernel_directory>.
   Example: ./configure --with-isapnp=yes --with-debug=full
4) Run 'make install'.
5) Run the './snddevices' script to create new sound devices in /dev directory.
   Skip this step, if you have a kernel with the DEVFS support.
6) Edit your /etc/modules.conf (see the kmod support section below).
7) Run 'modprobe snd-xxxx' where xxxx is the name of your card.
   Note: If you have a ISA PnP soundcard you need to first run the isapnp
         program from isapnptools package to initialize your
         soundcard. You can also use the native ISA PnP support by
         using the --with-isapnp=yes configuration switch, in which
 case you do not need the isapnptools package.

You can also look at the utils/alsasound file. This script is designed for
the RedHat distribution, but it can be used with other distributions which
use System V style rc init scripts.

Note: All mixer channels are muted by default. You must use a native
      or OSS mixer program to unmute appropriate channels (for example a
      mixer from the alsa-utils package).

Note: This document notices the /etc/modules.conf file. Many current
      distributions uses the old /etc/conf.modules file. Both names are
      valid.


Driver cannot be activated?
===========================

1) You can check your soundcard setup again and read this install file
   (module parameters) carefully.
2) If you have got ISA PnP soundcard:
   - native ISA PnP support: is your setup in /proc/isapnp correct?
   - isapnptools: is configuration on isapnp.conf same as for the driver?
3) The driver is not still working: remake driver with:
     ./configure --with-debug=detect; make clean; make
   Reinsert new driver modules to kernel and look to /var/log/messages if
   there are some messages. If these messages do not help you, please
   create a new ticket in our bug reporting system.


Compilation from CVS sources
============================

You need GNU packages autoconf and automake installed in your system
to compile CVS sources of alsa-driver package.

For compilation you can use these commands:

make ALSAKERNELDIR=../alsa-kernel all-deps
(if the alsa-kernel-dir is really there)
aclocal
autoconf
./configure
make dep
make

The included cvscompile script does this job for you.

Note: Some automake packages have missing aclocal program. Use newer version
      in the case.


Cross-compiling
===============

Use '--with-cross=prefix' parameter for the configure script.

Example:
  './configure --with-cross=arm-linux- --with-kernel=/home/ipaq/kernel/linux'.


Bug reporting system
====================

http://www.alsa-project.org/cgi-bin/bugs


Module parameters
=================

For the drivers already integrated into 2.5 kernel tree, please see
alsa-kernel/Documentation/ALSA-Configuration.txt


Additional Modules
==================

  Module snd-mixart
  -----------------

    Module for Digigram miXart8 soundcards.

    Module supports multiple cards.
    Note: One miXart8 board will be represented as 4 alsa cards.
          See doc/MIXART.txt for details.

  Module snd-msnd-pinnacle
  ------------------------

    Module for Turtle Beach MultiSound Pinnacle/Fiji soundcards.

    io - Port # for pinnacle/fiji card
    irq - IRQ # for pinnalce/fiji card
    mem - Memory address (0xb0000, 0xc8000, 0xd0000, 0xd8000,
  0xe0000 or 0xe8000)
    write_ndelay - enable write ndelay
    calibrate_signal - calibrate signal (?)

    Module supports only one card.

  Module snd-pdplus
  -----------------

    Module for Sek'D/Marian Prodif Plus soundcards.

    silent_exit - Do not reset when driver is unloaded.
    init_adat - Initialise the card in ADAT mode (instead of in digital stereo).

    Module supports up to 8 cards.

  Module snd-serialmidi
  ---------------------

    Module for generic serial MIDI adapters.

    sdev - Device file string for serial device
  (default = "/dev/ttyS0")
    speed - Speed in bauds. (9600,19200,38400,57600,115200)
  (default = 38400)
    adaptor - Type of adaptor.
                  0 = Soundcanvas, 1 = MS-124T, 2 = MS-124W S/A,
  3 = MS-124W M/B

    Module supports up to 8 cards.

alsa est déjà installé d'après apt-get

checking for gcc... gcc
checking for C compiler default output... a.out
checking whether the C compiler works... yes
checking whether we are cross compiling... no
checking for executable suffix...
checking for object suffix... o
checking whether we are using the GNU C compiler... yes
checking whether gcc accepts -g... yes
checking for ranlib... ranlib
checking for a BSD compatible install... /usr/bin/install -c
checking how to run the C preprocessor... gcc -E
checking for ANSI C header files... yes
checking for gcc option to accept ANSI C... none needed
checking for an ANSI C-conforming const... yes
checking for inline... inline
checking whether time.h and sys/time.h may both be included... yes
checking whether gcc needs -traditional... no
checking for current directory... /home/olivier/Linux/alsa-driver-0.9.6
checking cross compile...
checking for directory with kernel source... /lib/modules/2.6.17-10-generic/build
checking for kernel version... 2.6.17-10-generic
checking for GCC version... Kernel compiler: gcc 4.1.2 20060928 (prerelease) (Ubuntu 4.1.1-13ubuntu5) Used compiler: gcc (GCC) 4.1.2 20060928 (prerelease) (Ubuntu 4.1.1-13ubuntu5)
checking for kernel linux/compiler.h... "yes"
Removing a dummy linux/compiler.h.
checking for kernel linux/pm.h... "yes"
checking for kernel linux/spinlock.h... "yes"
checking for kernel linux/irq.h... "yes"
Removing a dummy linux/irq.h.
checking for kernel linux/threads.h... "yes"
Removing a dummy linux/threads.h.
checking for kernel linux/rwsem.h... "yes"
Removing a dummy linux/rwsem.h.
checking for kernel linux/gameport.h... "yes"
Removing a dummy linux/gameport.h.
checking for kernel linux/devfs_fs_kernel.h... "yes"
checking for kernel linux/highmem.h... "yes"
Removing a dummy linux/highmem.h.
checking for kernel linux/workqueue.h... "yes"
Removing a dummy linux/workqueue.h.
checking for kernel asm/hw_irq.h... "yes"
checking for kernel linux/jiffies.h... "yes"
Removing a dummy linux/jiffies.h.
checking for kernel linux/compat.h... "yes"
Removing a dummy linux/compat.h.
checking for kernel linux/adb.h... "yes"
Removing a dummy linux/adb.h.
checking for kernel linux/cuda.h... "yes"
Removing a dummy linux/cuda.h.
checking for kernel linux/pmu.h... "yes"
Removing a dummy linux/pmu.h.
checking for kernel module symbol versions... "yes"
checking for PCI support in kernel... "yes"
checking for SGI/MIPS (HAL2) architecture... "no"
checking for directory to store kernel modules... /lib/modules/2.6.17-10-generic/kernel/sound
checking for verbose printk... on
checking for debug level... none
checking for ISA support in kernel... "yes"
checking for processor type... i586
checking for i386 machine type... default
checking for SMP... "yes"
checking for ISA PnP driver in kernel... yes
checking for PnP driver in kernel... yes
checking for Kernel ISA-PnP support... "yes"
checking for strlcpy... "no"
checking for snprintf... "yes"
checking for vmalloc_to_page... "no"
checking for old kmod... "no"
Removing local linux/isapnp.h.
Removing local linux/pnp.h.
checking for driver version... 0.9.6
checking for sequencer support... yes
checking for OSS/Free emulation... yes
checking for RTC callback support in kernel... "no"
checking for USB support... "no"
checking for USB module support... "yes"
checking for kernel PCMCIA
checking for PCMCIA support... "no"
checking for PCMCIA module support... "yes"
checking for PC9800 support in kernel... "no"
checking for which soundcards to compile driver for... all
configure: creating ./config.status
config.status: creating version
config.status: creating Makefile.conf
config.status: creating snddevices
config.status: creating utils/alsa-driver.spec
config.status: creating utils/buildrpm
config.status: creating toplevel.config
config.status: creating include/config.h
config.status: creating include/config1.h
config.status: creating include/version.h
config.status: include/version.h is unchanged
olivier@olivier:~/Linux/alsa-driver-0.9.6$ make all
if [ ! -d include/sound -a ! -L include/sound ]; then \
          ln -sf ../alsa-kernel/include include/sound ; \
        fi
cp -auvf include/version.h include/sound/version.h
`include/version.h' -> `include/sound/version.h'
make dep
make[1]: entrant dans le répertoire « /home/olivier/Linux/alsa-driver-0.9.6 »
make[2]: entrant dans le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/support »
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h was updated
make[2]: quittant le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/support »
make[2]: entrant dans le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/acore »
make  -C ioctl32 fastdep
make[3]: entrant dans le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/acore/ioctl32 »
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h was not updated
make[3]: quittant le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/acore/ioctl32 »
make  -C oss fastdep
make[3]: entrant dans le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/acore/oss »
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h was not updated
copying file alsa-kernel/core/oss/mixer_oss.c
patching file mixer_oss.c
copying file alsa-kernel/core/oss/pcm_oss.c
patching file pcm_oss.c
Hunk #1 succeeded at 2092 (offset 11 lines).
Hunk #2 succeeded at 2268 (offset 17 lines).
Hunk #3 succeeded at 2416 (offset 17 lines).
gcc -D__KERNEL__ -DMODULE=1 -I/home/olivier/Linux/alsa-driver-0.9.6/include  -I/lib/modules/2.6.17-10-generic/build/include -O2 -mpreferred-stack-boundary=2 -march=i586 -I/lib/modules/2.6.17-10-generic/build/include/asm-i386/mach-default -D__SMP__ -DCONFIG_SMP -DLINUX -Wall -Wstrict-prototypes -fomit-frame-pointer -Wno-trigraphs -O2 -fno-strict-aliasing -fno-common -pipe -DALSA_BUILD -I/home/olivier/Linux/alsa-driver-0.9.6/alsa-kernel/core/oss -E -D__GENKSYMS__ mixer_oss.c
| /sbin/genksyms -k 2.6.17 -p smp_  > /home/olivier/Linux/alsa-driver-0.9.6/include/modules/acore-oss__mixer_oss.ver.tmp
/bin/sh: /sbin/genksyms: not found
mv /home/olivier/Linux/alsa-driver-0.9.6/include/modules/acore-oss__mixer_oss.ver.tmp /home/olivier/Linux/alsa-driver-0.9.6/include/modules/acore-oss__mixer_oss.ver
gcc -M -D__KERNEL__ -D__isapnp_now__ -DMODULE=1 -I/home/olivier/Linux/alsa-driver-0.9.6/include  -I/lib/modules/2.6.17-10-generic/build/include -O2 -mpreferred-stack-boundary=2 -march=i586 -I/lib/modules/2.6.17-10-generic/build/include/asm-i386/mach-default -D__SMP__ -DCONFIG_SMP -DLINUX -Wall -Wstrict-prototypes -fomit-frame-pointer -Wno-trigraphs -O2 -fno-strict-aliasing -fno-common -pipe -DALSA_BUILD -I/home/olivier/Linux/alsa-driver-0.9.6/alsa-kernel/core/oss mixer_oss.c pcm_oss.c pcm_plugin.c io.c copy.c linear.c mulaw.c route.c rate.c > .depend
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from mixer_oss.c:22:
/home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:42:31: error: linux/modversions.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:43,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from mixer_oss.c:22:
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h:3:29: error: linux/modsetver.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from pcm_oss.c:29:
/home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:42:31: error: linux/modversions.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:43,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from pcm_oss.c:29:
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h:3:29: error: linux/modsetver.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/pcm_plugin.c:27,
                 from pcm_plugin.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:42:31: error: linux/modversions.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:43,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/pcm_plugin.c:27,
                 from pcm_plugin.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h:3:29: error: linux/modsetver.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/io.c:22,
                 from io.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:42:31: error: linux/modversions.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:43,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/io.c:22,
                 from io.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h:3:29: error: linux/modsetver.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/copy.c:22,
                 from copy.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:42:31: error: linux/modversions.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:43,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/copy.c:22,
                 from copy.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h:3:29: error: linux/modsetver.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/linear.c:23,
                 from linear.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:42:31: error: linux/modversions.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:43,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/linear.c:23,
                 from linear.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h:3:29: error: linux/modsetver.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/mulaw.c:24,
                 from mulaw.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:42:31: error: linux/modversions.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:43,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/mulaw.c:24,
                 from mulaw.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h:3:29: error: linux/modsetver.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/route.c:22,
                 from route.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:42:31: error: linux/modversions.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:43,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/route.c:22,
                 from route.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h:3:29: error: linux/modsetver.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/rate.c:22,
                 from rate.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:42:31: error: linux/modversions.h: Aucun fichier ou répertoire de ce type
In file included from /home/olivier/Linux/alsa-driver-0.9.6/include/adriver.h:43,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/sound/driver.h:42,
                 from /home/olivier/Linux/alsa-driver-0.9.6/include/../alsa-kernel/core/oss/rate.c:22,
                 from rate.c:2:
/home/olivier/Linux/alsa-driver-0.9.6/include/sndversions.h:3:29: error: linux/modsetver.h: Aucun fichier ou répertoire de ce type
make[3]: *** [fastdep] Erreur 1
make[3]: quittant le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/acore/oss »
make[2]: *** [_sfdep_oss] Erreur 2
make[2]: quittant le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/acore »
make[1]: *** [dep] Erreur 1
make[1]: quittant le répertoire « /home/olivier/Linux/alsa-driver-0.9.6 »
make: *** [include/sndversions.h] Erreur 2
olivier@olivier:~/Linux/alsa-driver-0.9.6$ sudo make install
Password:
rm -rf /lib/modules/2.6.17-10-generic/kernel/sound
make[1]: entrant dans le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/support »
make[1]: Rien à faire pour « modules_install ».
make[1]: quittant le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/support »
make[1]: entrant dans le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/acore »
mkdir -p /lib/modules/2.6.17-10-generic/kernel/sound/acore
cp snd-hwdep.o snd-page-alloc.o snd-pcm.o snd-rawmidi.o snd-timer.o snd.o /lib/modules/2.6.17-10-generic/kernel/sound/acore
cp: ne peut évaluer `snd-hwdep.o': Aucun fichier ou répertoire de ce type
cp: ne peut évaluer `snd-page-alloc.o': Aucun fichier ou répertoire de ce type
cp: ne peut évaluer `snd-pcm.o': Aucun fichier ou répertoire de ce type
cp: ne peut évaluer `snd-rawmidi.o': Aucun fichier ou répertoire de ce type
cp: ne peut évaluer `snd-timer.o': Aucun fichier ou répertoire de ce type
cp: ne peut évaluer `snd.o': Aucun fichier ou répertoire de ce type
make[1]: *** [_modinst__] Erreur 1
make[1]: quittant le répertoire « /home/olivier/Linux/alsa-driver-0.9.6/acore »
make: *** [install-modules] Erreur 1
olivier@olivier:~/Linux/alsa-driver-0.9.6$