AlsaProject - User contributions [en]

Documentation

2007-05-07T23:10:43Z

Soe: /* Developer Info */

== User Info ==

*[[ALSA User Info]]
*[http://www.agnula.info/documentation/dp_tutorials/alsa_jack_ladspa/ Overview of ALSA]
*Hardware Recommendations
*[http://lau.linuxaudio.org/ Linux Audio Users Guide]

== System Maintainers Info ==

*[[System Maintainers documentation]]

*[[Matrix:Main|Sound Card Matrix & INSTALL documentation]]
*[http://alsa.opensrc.org/ The ALSA Wiki]
*The latest [http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/alsa/alsa-driver/INSTALL INSTALL] file
*kerndriv Updating ALSA Kernel drivers
*olddocs Older documents
*[http://www.alsa-project.org/alsa-doc/doc-php/asoundrc.php?company=Generic&card=Generic&chip=Generic&module=Generic .asoundrc]
*Kernel Module overview(snd, virmidi, etc..)

== Tools ==

*alsactl
*amixer, alsamixer
*aplay/arecord
*aconnect, aseqnet
*envy24control
*hdsploader, hdspmixer
*vxloader

== Developer Info ==

*[[ALSA 0.9.x Developer documentation]]
**[[ALSA 0.9.x Developer documentation#Background_Info|Background info]]
**[[ALSA 0.9.x Developer documentation#Developer_tutorials|Tutorials]]
**[[ALSA 0.9.x Developer documentation#ALSA_Library_API|Library]]
**[[ALSA 0.9.x Developer documentation#ALSA_Driver_Documentation|Driver]]
*[http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/alsa/alsa-kernel/ Driver Changelogs]
*[http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/*checkout*/alsa/alsa-driver/doc/SOUNDCARDS?rev=HEAD&content-type=text/plain Driver developers list]
*[[ALSA contributors]]

== Hardware Manufacturers ==

*[[ALSA Soundcard Vendor Information|Getting support for your hardware.]]

ALSA Soundcard Vendor Information

2007-05-07T23:09:45Z

Soe: New page: == Author: The ALSA Development Team == maintained by Christopher David (cdavid at ketl.com) additions by Patrick Shirkey (pshirkey at boosthardware.com) last updated: April 12, 2002...

== Author: The ALSA Development Team ==

maintained by Christopher David (cdavid at ketl.com) 
additions by Patrick Shirkey (pshirkey at boosthardware.com)

last updated: April 12, 2002

== Abstract ==

This document outlines information that soundcard vendors need in
order to be compatible with ALSA and Linux at large. It is targeted
mainly for companies that design and sell soundcard hardware. It may
also be useful to new ALSA developers who desire a background about
information they get from a given soundcard vendor.

== Background ==

ALSA stands for Advanced Linux Sound Architecture. Its main goal is
just what its title says, to create an advanced sound architecture for
Linux. ALSA is committed to being released under the [http://www.gnu.org/copyleft/gpl.html Gnu GPL]. The scope of
the project extends from the low level soundcard drivers, all the way
up to a high level sequencer. This document is mainly concerned with
what is needed to develop the low level soundcard drivers.

ALSA plans to be part of the mainstream Linux kernel when it is
ready. ALSA is fully compatible with OSS/Lite Mixer and PCM
interfaces. ALSA offers better native interfaces that new
applications can use.

== What we need to write good drivers ==

ALSA developers need several things to write good drivers. We need:

*good documentation
*necessary firmware
*a way to get additional information if needed
*example source code is helpful

Good documentation is needed before ALSA developers can write good
drivers. Basically, we need to know everything that anyone else
writing a driver would need to know. Most of the information we need
should be in the data sheets of each chip. We also need to have a
memory map of all the chips, and any additional registers that may not
be included in other data sheets.

It is important that the firmware for a given soundcard is made
available to us. By firmware, we mean code that would be downloaded to
a piece of hardware that is necessary for it to function. i.e. code
running on some DSP chip that is located on the soundcard. This would
not be code that runs on the host system. (Host system is the one
running Linux.) It is important that there are no distribution
restrictions on the firmware. We must be able to freely distribute the
firmware code as part of ALSA. We would like the source code for
firmware. It is not required that it is given to us, but we are
definitely willing to accept it.

We also may need some additional information about how the sound
card works. This varies a lot from card to card. For example, if a
programmable PLL needs to be programmed to a certain frequency before
the card will function, we need to know this. If your company can
appoint a contact person for additional information, that would be
great! Generally, we do not have very many questions. We are used to
developing drivers on our own. We will not be taking up much of that
person's time.

We would also like any example source code that could be given to
us. Obviously this is not as important as the other issues. But
example source code can often be helpful, especially for parts that
are poorly documented.

== Our view of NDAs ==

Unfortunately, ALSA developers generally do not want to sign
non-disclosure agreements, or NDAs. It is possible that a few ALSA
developers could individually sign these types of agreements, but that
would have to be worked out on an individual developer basis. It has
happened in the past. We do not recommend the use of NDAs at all,
because one way or another, they restrict our development effort. It
should be possible to give ALSA developers the information they need
without requiring an NDA. Many companies regularly do this.

Our big problem is with NDAs that restrict the release of our
source code. Since ALSA is released under the Gnu GPL, all of our
source code is made publicly available. Agreeing to an NDA that
requires binary-only distribution of our code conflicts with the Gnu
GPL. Thus we cannot agree at all to NDAs that restrict the release of
our source code. Besides, binary only versions of kernel drivers just
does not work very well in Linux.

Another type of NDA would restrict soundcard documentation to a
small group of people. This type of NDA is at least feasible, but it
still restricts our development effort. The problem is that only those
persons covered under the NDA may be capable of fixing bugs and
providing new features for that card. Often, people from all over the
world send patches to our code. We want all these people to have
access to the documentation. It hurts our project when some people, who
are very capable of sending patches, will not be able to write them in
the first because of lack of documentation.

== Why soundcard documentation should be public ==

There are several reasons why your company would want to give us the
information we request. The most important reason is that it will help
your company sell more cards! Many times Linux users ask us which
cards we support. We tell them, and they go buy these
cards. Obviously, the only cards we can support are those we can get
good documentation for.

Also, by making your soundcard documentation public, you really
have contributed something to the Linux development effort. That
should give you a good, warm, fuzzy feeling inside.

There other reasons too. First, other operating systems will have
an easier time supporting your hardware. Second, many developers will
be able to double check our driver, making it very robust. In the end,
this makes your hardware look good. Also, people interested in doing
custom things with your hardware will be able to, giving you another
venue for sales.

With the user base of Linux growing so rapidly, can your company
really afford not to support ALSA and make your soundcard
documentation public? We are not asking for your corporate secrets
here. We are not asking for the Verilog source code for each chip in
your product. We are not asking for schematics, gerber plots, or
anything like that. We just need basic information that enables us to
write a good sound driver.

== Views on Binary Only drivers ==

ALSA does not stop anybody from releasing binary-only drivers. But
ALSA does not support nor encourage these drivers either. The stance
that ALSA takes on binary-only sound card drivers is similar to
Linus's stance on binary-only drivers in the kernel. There is an
[http://lwn.net/1999/0211/kernel.phtml article in the Linux Weekly News]
about this. There are additional requirements that ALSA places on
binary only drivers beyond Linus's view.

Linus Torvalds, leader of the Linux development effort, has stated
that because binary-only drivers depend so heavily on a given kernel
version, and therefore are so prone to "breaking" when kernel
development proceeds, as it is bound to do, he does not intend to
support nor encourage the use of binary-only loadable drivers.

If Linux developers were to try to maintain compatibility with a given
binary-only driver, it would severely limit the avenues of
development open to Linux. Our goal in Linux development is to
achieve the highest performance, the best stability (in terms of bug
free code), and the most advanced technology possible.

We simply cannot be made subject to the limitations that would be
placed on us by having to maintain compatibility with a third party
binary-only loadable module.

We, the ALSA development team, working as a subset of Linux kernel
developers, agree with Linus Torvalds' reasoning. And this is the very
crux of why we ask you for documentation on your hardware. We truly
want to purchase and use your hardware in our Linux based systems, but
we simply cannot use binary-only drivers; it's just too cumbersome and
frustrating for all involved. Drivers that could be distributed as
source code would eliminate all of those problems.

There is nothing to stop any company from developing a binary only
driver that works with ALSA. But there are several issues and
requirements we want to make clear to anybody attempting to do this.

*Binary-only drivers will not be distributed as part of ALSA, even when ALSA becomes part of the mainstream kernel. That means any company releasing binary only drivers will have to find alternative distribution mechanisms. They cannot rely directly on ALSA for this. The main implication of this is ALSA will work "out of the box" with all sound cards, except for unsupported cards.

*Users of binary only dirvers must be instructed not use ALSA for technical support whatsoever! These users must be notified with the following notice.
"These drivers are not part of the official ALSA distribution. ALSA will
never support these drivers. DO NOT attempt to contact ALSA for support."

*The end user MUST always confirm this notice by downloading, or unpacking the drivers. There must also be some contact listed that is available for technical support. ALSA resources must not be listed anywhere as avenues for support.

*Binary-only drivers cannot be based on any ALSA source code. They must be written from scratch. Binary-only drivers that contain ALSA code are infringing on copyright laws.

*The developer assumes full responsibility for ensuring the driver works accross new versions of ALSA, different kernels, and different platforms. If we change ALSA, and a binary-only driver cease to work because of it, we will not do anything to fix it.

All our drivers are distributed in source form. The single source
file works with all kernel versions, all platforms, and all ALSA
versions. There is only one source for us to maintain and
support. (Elegant, isn't it?) We really like it that way. Drivers
distributed in binary form may require multiple builds, even though
the source does not need to change. Obviously different binaries are
needed for different platforms. In addition, it is possible that
different binaries are even needed for the same platform depending on
the kernel version, or ALSA version.

This may not be as bad as it seems. Once ALSA reaches version 1.0,
the same binary may work across multiple kernel and ALSA releases. But
we are not making any promises. Again, all of these problems go away
when the driver source is released under GPL to the public.

We do understand that sometimes companies feel compelled to hide
their hardware implementations by not releasing the driver source.
The general Linux user base most likely prefers that any driver is
available for a given piece of hardware rather than no driver. So
please do not let ALSA's stance on binary only drivers deter your
company from releasing one. Since ALSA is open source and is
documented, everything you need to write binary only drivers is
available. We are not out to stop you, but we can not make any
promises that your binary driver will work across all future releases
of ALSA.

== Summary ==

ALSA wants to support your soundcard hardware. We have something
really good here that we think should run on all sound cards. It is a
well thought out, open sound architecture that is capable of
supporting the needs of musicians, audiophiles, game players, home and
business users alike. It has easy-to-use APIs. It provides a level of
modularity and flexibility never seen before in a sound
architecture. There are many great minds collaborating on ALSA, and
even though it is currently in the very early stages, so far the
results are outstanding. As a soundcard manufacturer, ask yourself one
question. Do I want to be part of something great?

Thanks, 
The ALSA development team

== Related links ==

*[http://www.alsa-project.org/~cdavid/vendorinfo/call.txt This document in plain text]
*[http://www.alsa-project.org/~cdavid/vendorinfo/call.pdf This document in pdf]
*[http://www.alsa-project.org/~cdavid/vendorinfo/call.ps This document in postscript]
*[http://www.precisioninsight.com/alspaper.html Managing Graphics Hardware Vendor Relationships in the Linux Developer Community]
*[http://www.news.com/News/Item/0,4,30027,00.html Linux shipments up 212 percent]
*[http://www.heise.de/newsticker/data/odi-13.01.99-000/ Microsoft sieht Linux pro Jahr um 960 Prozent wachsen]
*[http://www.alsa-project.org/black.html ALSA blacklist]
*[http://www.gnu.org/copyleft/gpl.html Gnu General Public License]
*[http://lwn.net/1999/0211/kernel.phtml Linux Weekly News article concerning recent binary-only drivers in Linux]

ALSA contributors

2007-05-07T23:08:35Z

Soe: New page: == Thanks == Many thanks are sent to the people below who help with ALSA development, code, documentation, hardware or ideas. People or companies are sorted in the random order. If someo...

== Thanks ==

Many thanks are sent to the people below who help with ALSA development, code, documentation, hardware or ideas. People or companies are sorted in the random order.

If someone is not listed, please, let me (Jaroslav Kysela) know - thank you.

== Contributors ==
'''Jaroslav Kysela''' < perex at suse.cz > 
code: main coder, designer, coordinator 
admin: CVS/WWW/FTP/Mail-List administrator

'''Abramo Bagnara''' < abramo at alsa-project.org > 
code: general hacker, ESS ES-18xx driver, mixer interface

'''Takashi Iwai''' < tiwai at suse.de > 
code: native sequencer hacker, general hacker, EMU8000/10K1 driver, emulator of OSS sequencer

'''Frank van de Pol''' < frank at vande-pol.demon.nl > 
code: ALSA sequencer prototype code and design

'''Jaromir Koutek''' < miri at punknet.cz > 
code: ESS Solo-1 driver

'''Christian Fischbach''' < fishbach at pool.informatik.rwth-aachen.de > 
code: ESS ES-1869 driver

'''Bob Holder''' < bholder at tridentmicro.com > 
code: Trident 4DWave DX/NX driver

'''Steve Ratcliffe''' < steve at parabola.demon.co.uk > 
code: EMU8000 driver, MIDI emulation, native sequencer hacker

'''Paul Davis''' < paul at linuxaudiosystems.com > 
code: WaveFront (Tropez, Tropez+) driver 
code: RME Hammerfall (RME9652) driver 
code: RME HDSP driver

'''Thomas Charbonnel''' < thomas at undata.org > 
code: RME HDSP driver 
code: hdspmixer and hdsploader

'''Anders Torger''' < torger at ludd.luth.se > 
code: RME Digi96 driver

'''Matze Braun''' < MatzeBraun at gmx.de > 
code: ESS Maestro 1/2/2E driver

'''Haroldo Gamal''' < gamal at alternex.com.br > 
code: Korg 1212 IO driver

'''Alan Robinson''' < robinson at vt.edu > 
documentation: corrections for alsa-lib documentation

'''Fred Floberg''' < emng at geocities.com > 
documentation: corrections for alsa-lib documentation

'''Tim Janik''' < timj at gtk.org > 
code: old (up to 0.2.x) alsamixer code

'''Andy Lo A Foe''' < arloafoe at cs.vu.nl > 
code: base amixer code, API testing

'''Paul Winkler''' < zarmzarm at erols.com > 
documentation: manual pages and README for amixer and alsamixer

'''Christopher T. Lansdown''' < lansdoct at screech.cs.alfred.edu > 
code: xamixer

'''Jan ONDREJ''' < ondrejj at salstar.shadow.sk > 
code: alsaconf

'''Thomas Sailer''' < sailer at ife.ee.ethz.ch > 
documentation: for Ensoniq AudioPCI ES1370/1371 and S3 SonicVibes 
demo code: for Ensoniq AudioPCI ES1370/1371 and S3 SonicVibes

'''Chris David''' < cdavid at umich.edu > 
other: information for sound card hardware vendors

'''Anders Semb Hermansen''' < ahermans at vf.telia.no > 
code: soundcard selection code for the ALSA driver 
patches and support: patches for mpg123 and driver, active on mailing lists

'''Christopher Butler''' < chrisb at sandy.force9.co.uk > 
code: Sound Galaxy driver 
patches: SB8 code

'''Massimo Piccioni''' < piccio at caronte.csr.unibo.it > 
code: Opti9xx drivers, Aztech System AZT2320 driver 
code: ALS100 driver, ES968 driver, AD1816A driver

'''Henrik Theiling''' < theiling at absint.de > 
code: Marian/Sek'D Prodif Plus driver

'''Valentijn Sessink''' < Valentyn at dds.nl > 
documentation: HOWTO maintainer

'''John Fulmer''' < jfulmer at appin.org > 
documentation: FAQ maintainer

'''Patrick Shirkey''' < pshirkey at boosthardware.com > 
Website/documentation: webmaster and "online docs" creator

== Donations ==

'''MidiMan''' - www.midiman.com 
soundcard: MidiMan Delta 1010, 44, Dio 2496

'''RME''' - www.rme-audio.com 
soundcard: Hammerfall, 3x Hammerfall Light

'''Claus Riethmueller''' < claus at ridi.com > 
soundcard: Hoontech ST Digital 4DWave NX (Trident NX) 
hardware: Hoontech NX DB-I, NX DB-II, ST DB-III 
soundcard: Hoontech Digital-XG (YMF744) 
soundcard: Hoontech AudioTrack DSP24

'''Steven Tseng''' < stseng at fortemedia.com > 
soundcards: 2x ForteMedia FM801 / STAC9704

'''Bob Holder''' < bholder at tridentmicro.com > 
soundcards: 2x Trident 4DWave NX (STAC9704/STAC9708)

'''Frank Altschuler''' < faa at crystal.cirrus.com > 
soundcards: Sound Fusion CS4614/CS4297, Sound Fusion CS4280/CS4297

'''Hynek Petrak''' < hynek at swac.de > 
soundcard: TerraTec 128iPCI (ESS Solo-1 - ES1938S)

'''Michael Stutz''' < stutz at dsl.org > 
soundcard: Turtle Beach Malibu

'''Horace Demmink''' < horace at pathwaynet.com > 
soundcard: UltraSound 32-Pro (STB) 
These soundcards are OEM products of Compaq.

'''Martins Medens''' < martins at parks.lv > 
soundcard: Gravis UltraSound Extreme

'''Roel De Wit''' < MB164 at hi.fontys.nl > '''& Utopia Sound Division''' 
soundbank: beta & final Utopia Sound Bank for InterWave based soundcards

== Other help ==

'''IC Ensemble''' - www.icensemble.com 
documentation: ICE1712 (Envy24) Datasheet

'''Tony Romero''' < Tony.Romero at amd.com > 
documentation: InterWave (tm) IC Am78C201/202 Programmer's Guide

ALSA 0.9.x Developer documentation

2007-05-07T23:07:50Z

Soe: New page: == Background Info == The Advanced Linux Sound Architecture comes with a driver API & library API. Our aim is to describe hardware as close as possible in drivers, but in userspace, t...

== Background Info ==

The Advanced Linux Sound Architecture comes with a driver API & library API.
Our aim is to describe hardware as close as possible in drivers, but in
userspace, the alsa-lib covers the hardware differences (if required).
It's possible for applications to control all hardware features
(if required).

*Click [http://hg-mirror.alsa-project.org/ here to view the code online] - highlighted syntax
*Extra driver/architecture specific information is available in the http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/alsa/alsa-kernel/Documentation/ alsa-kernel/Documentation dir

'''Q: Why is ALSA more advanced than OSS?'''

*kernel-space supports only h/w-level capabilities
*multi-thread safe design
*transparent use of plugin architecture to handle format,rate,channel cnt and many other conversions
*support for non-interleaved interfaces
*user-space software mixing (dmix)
*user-space "loopback/snoop" capabilities
*merging multiple cards into a single virtual device
*hiding non-ALSA-drivers behind a consistent user-space API (e.g. IEEE1394 drivers, or JACK)
*consistent and generic control API for managing h/w controls
*sufficiently flexible mixer architecture to handle modern audio interfaces fully (rather than reducing them to a simplistic device)
*consistent support for multiple instances of the same card
*linked operations of multiple cards
*and more...

Currently we need developers to write docs on the ctl API. Until then you
will have to read the code and reference other applications for more advanced
info.

== Developer tutorials ==

*[http://www.suse.de/~mana/alsa090_howto.html ALSA 0.9.0 HOWTO] - Dr Matthias Nagorni has writen a comprehensive tutorial for audio application developers.
*[http://equalarea.com/paul/alsa-audio.html Howto use the ALSA API] - Paul Davis has also written a brief explanation.
*[http://www.alsa-project.org/~frank/alsa-sequencer/ ALSA Sequencer (draft)] - Frank van de Pol's draft on programming the alsa sequencer.
*[http://www.alsa-project.org//~iwai/OSS-Emulation.html Kernel OSS-Emulation] - Takashi Iwai has written some notes on how ALSA handles OSS applications.
*[http://www.salleurl.edu/~is04069/Modders/Docs/alsadoc.html Programming ALSA (Espanol)] - David Garcia Garzon has written Spanish docs and tutorials

=== Presentations: ===

*The [http://www.linuxdj.com/audio/lad/eventszkm2003.php LAD meeting] in Karlsruhe, April 2003 provided two presentations (among many) from the core ALSA developers Jaroslav and Takashi. You can view slides and listen to .ogg recordings of the presentations.

== ALSA Library API ==

The ALSA lib api is the interface to the ALSA drivers. Developers need to
use the functions in this api to achieve native ALSA support for their
applications. The ALSA lib documentation is a valuable developer reference
to the available functions. In many ways it is a tutorial. The latest
[http://www.alsa-project.org/alsa-doc/alsa-lib on-line documentation] is generated from
the alsa-lib CVS sources.

You can also generate it yourself. Install the
[http://www.doxygen.org doxygen tool] and type 'make doc' in
the alsa-lib directory.

The currently designed interfaces are listed below:

#Information Interface (/proc/asound)
#Control Interface (/dev/snd/controlCX)
#Mixer Interface (/dev/snd/mixerCXDX)
#PCM Interface (/dev/snd/pcmCXDX)
#Raw MIDI Interface (/dev/snd/midiCXDX)
#Sequencer Interface (/dev/snd/seq)
#Timer Interface (/dev/snd/timer)

== ALSA Driver Documentation ==

Takashi Iwai has written "Writing an ALSA Driver" - a very comprehensive
guide to developing a device driver for ALSA.

The document focuses mainly on the PCI soundcard. In the case of other
device types, the API might be different. However the ALSA kernel API is
consistent so it will be helpful in that context.

*[http://www.alsa-project.org/~iwai/writing-an-alsa-driver/index.html HTML (multiple documents)]
*[http://www.alsa-project.org/~iwai/writing-an-alsa-driver.pdf pdf file]
*[http://www.alsa-project.org/~iwai/alsa-drivers-writing.txt plain text]
*[http://www.alsa-project.org/~iwai/writing-an-alsa-driver.sgml The sgml source] is also available

== ALSA Driver API ==

This document gives a complete rundown of the functions in the alsa-driver API.

*[http://www.alsa-project.org/~iwai/alsa-driver-api/index.html HTML (multiple documents)]
*[http://www.alsa-project.org/~iwai/alsa-driver-api.pdf pdf file]
*[http://www.alsa-project.org/~iwai/alsa-driver-api.sgml The sgml source] is also available

=== Older documents ===

The [http://www.alsa-project.org/alsa-doc/alsa-howto ALSA HOWTO/FAQ documentation] tries
to do the ALSA driver installation easier. If you have any ideas or questions
regarding this documentation, please, leave a message on
the [[Mailing-lists|alsa-devel at lists.sourceforge.net]] mailing list.

The [http://www.alsa-project.org/~valentyn/Alsa-sound-mini-HOWTO.html ALSA-sound-mini-HOWTO]
describes the installation of the ALSA sound
drivers for Linux. This HOWTO is also available from the Linux Documentation Project, take
a look at [http://metalab.unc.edu/LDP/mirrors.html http://metalab.unc.edu/LDP/mirrors.html]
to find your nearest mirror. You can get this HOWTO in various formats:

*[http://www.alsa-project.org/~valentyn/Alsa-sound-mini-HOWTO.html HTML (multiple documents)]
*[http://www.alsa-project.org/~valentyn/other-formats/Alsa-sound-mini-HOWTO.html HTML (one document)]
*[http://www.alsa-project.org/~valentyn/other-formats/Alsa-sound-mini-HOWTO.txt plain text]
*[http://www.alsa-project.org/~valentyn/other-formats/Alsa-sound-mini-HOWTO.sgml sgml source] of the HOWTO is also available.

There is also an old [http://www.alsa-project.org/~jfulmer/alsa-faq.html ALSA FAQ document] from John Fulmer.

== ALSA 0.5.x Developer documentation ==

'''N.B. The 0.5.x series is considered deprecated and is no longer supported by ALSA developers'''

The [http://www.math.tu-berlin.de/~sbartels/alsa/ ALSA 0.4.0 Developer documentation] describes the internals of the ALSA kernel driver.
It is a document for kernel developers and others which want to know more
about ALSA internals. It is '''not''' for application programmers.
Application programmers should use the ALSA library API found in the alsa-lib
package. Incomplete documentation for ALSA 0.5.x API is available in HTML format
on [http://www.alsa-project.org/alsa-doc/alsa-lib-old ALSA WWW server] or you
may get [http://www.alsa-project.org/~perex/alsa-lib-old/alsa-lib.tgz tarball] for off-line
reading.

System Maintainers documentation

2007-05-07T23:06:57Z

Soe: New page: We have an online <a href="alsa-doc/">installation docs</a> with a section for user contributed notes and additions which is accessed through the soundcard matrix. Feel fre...

We have an online <a href="alsa-doc/">installation docs</a> with a section for user contributed notes and additions which is accessed through the [[Matrix:Main|soundcard matrix]]. Feel free to make additions and contributions. This is the official reference for user docs.

We also have an [http://alsa.opensrc.org/ ALSA-HOWTO WIKI]. Feel free to make additions and contributions.

The online alsa-docs (above) have info on using the [http://www.alsa-project.org/alsa-doc/doc-php/asoundrc.php?company=Generic&card=Generic&chip=Generic&module=Generic .asoundrc] file. There is also a basic overview [http://www.alsa-project.org/alsa/library-source/doc/asoundrc.txt here] and you can find more in the [http://alsa.opensrc.org/index.php?page=.asoundrc ALSA WIKI] and the [http://www.alsa-project.org/alsa-doc/alsa-lib/pcm_plugins.html#pcm_plugins alsa-lib documentation].

Take a look at the latest <a href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/alsa/alsa-driver/INSTALL">INSTALL</a> file to read information about the newest drivers and their use. If you have questions ask on the [[Mailing-lists|mailing lists]].

== Updating ALSA Kernel drivers ==

<pre>
12/09/03

> Some queries about the latest 2.6 kernels...
>
> I presume the "alsa" part that comes with a 2.6 kernel is only
> the equiv of the alsa-driver package so do I still need to get
> alsa-lib and alsa-utils from somewhere else ?

Yes, from our main site - http://www.alsa-project.org .

> If so, then do I have to determine which particular version is
> in the kernel and then source the same versioned lib/utils packages ?

Version is available in linux/include/sound/version.h

> What is the difference between /usr/include/sound/* and
> /usr/src/linux/include/sound/* and where might "<asound/asoundlib.h>"
> be that some packages need for compiling ?

ALSA library has a copy of kernel header files and it is backwards
compatible with ALSA code 0.9 final (which is also in the 2.6 kernel
tree). In other words, you can use 1.0 packages without any problems.

> Is there some sane method to intergrate ALSA from CVS into whatever
> is the latest 2.6 kernel source tree... how ?

ftp://ftp.alsa-project.org/pub/kernel-patches .

or (use BitKeeper):

bk pull http://linux-sound.bkbits.net/linux-sound

or

simply copy files from the ALSA's alsa-kernel CVS module to relevant
locations in the 2.6 kernel tree.

Jaroslav

-----
Jaroslav Kysela <perex@suse.cz>
Linux Kernel Sound Maintainer
ALSA Project, SuSE Labs
</pre>

ALSA User Info

2007-05-07T23:06:12Z

Soe: New page: The [http://lau.linuxaudio.org/ Linux Audio Users Guide] provides a quick reference point to many useful documents, tutorials, links and a professional support database for Linux audio. A...

The [http://lau.linuxaudio.org/ Linux Audio Users Guide] provides a quick reference point to many useful documents, tutorials, links and a professional support database for Linux audio.

ALSA MIDI/sequencer tutorial http://www.djcj.org/LAU/webcount/link.php?id=midisynth_howto&url=http://linux-sound.org/quick-toots/4-sequencers_and_softsynths/quick-toot-midisynth_howto.html English, [http://www.salleurl.edu/~is04069/Modders/Docs/alsadoc-sequencer.html Spanish]

The ALSA utils are a collection of small and often extremely powerful
applications designed to allow users to control the various parts of
the ALSA system. The <tt>alsactl</tt> app is a way to save settings for
your device. The <tt>amixer</tt> app is a command line app which allows
adjustments to be made to a devices volume and sound controls.
The <tt>alsamixer</tt> app is an ncurses version of <tt>amixer</tt>.
The <tt>acconnect</tt> and <tt>aseqview</tt> apps are for making MIDI
connections and viewing the list of connected ports. The <tt>aplay/arecord</tt>
apps are for commandline playback and recording of a number of file types
including raw, wave and aiff at all the sample rates, bitdepths and channel
counts known to the ALSA library.

There are a number of apps in the ALSA tools package. They range from
<tt>envy24control</tt> which provides complete control over all devices
with an envy24 chip, to firmware loaders for pcmcia, USB and the hdsp devices.
There is also the <tt>hdspmixer</tt> app which is a carbon copy of
the totalmix app for windows and mac platforms. To use them you need to
build and install them seperately. Make sure you read the README and INSTALL
files for usage instructions.

Documentation

2007-05-07T23:05:45Z

Soe: New page: == User Info == *ALSA User Info *[http://www.agnula.info/documentation/dp_tutorials/alsa_jack_ladspa/ Overview of ALSA] *Hardware Recommendations *[http://lau.linuxaudio.org/ Linux Au...

== User Info ==

*[[ALSA User Info]]
*[http://www.agnula.info/documentation/dp_tutorials/alsa_jack_ladspa/ Overview of ALSA]
*Hardware Recommendations
*[http://lau.linuxaudio.org/ Linux Audio Users Guide]

== System Maintainers Info ==

*[[System Maintainers documentation]]

*[[Matrix:Main|Sound Card Matrix & INSTALL documentation]]
*[http://alsa.opensrc.org/ The ALSA Wiki]
*The latest [http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/alsa/alsa-driver/INSTALL INSTALL] file
*kerndriv Updating ALSA Kernel drivers
*olddocs Older documents
*[http://www.alsa-project.org/alsa-doc/doc-php/asoundrc.php?company=Generic&card=Generic&chip=Generic&module=Generic .asoundrc]
*Kernel Module overview(snd, virmidi, etc..)

== Tools ==

*alsactl
*amixer, alsamixer
*aplay/arecord
*aconnect, aseqnet
*envy24control
*hdsploader, hdspmixer
*vxloader

== Developer Info ==

*[[ALSA 0.9.x Developer documentation]]
**[[ALSA 0.9.x Developer documentation#Background_Info|Background info]]
**[[ALSA 0.9.x Developer documentation#Developer_tutorials|Tutorials]]
**[[ALSA 0.9.x Developer documentation#ALSA_Library_API|Library]]
**[[ALSA 0.9.x Developer documentation#ALSA_Driver_Documentation|Driver]]
*[http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/alsa/alsa-kernel/ Driver Changelogs]
*[http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/*checkout*/alsa/alsa-driver/doc/SOUNDCARDS?rev=HEAD&content-type=text/plain Driver developers list]
*contrib.php [[ALSA contributors]]

== Hardware Manufacturers ==

*[[ALSA Soundcard Vendor Information|Getting support for your hardware.]]

Links

2007-05-06T22:34:09Z

Soe: New page: == Useful Websites == *[http://linux-sound.org/ Linux MIDI & Sound Applications] *[http://www.linuxdj.com/audio/lad/ linux-audio-dev homepage] *[http://www.djcj.org/ Linux Audio User...

== Useful Websites ==

*[http://linux-sound.org/ Linux MIDI & Sound Applications]
*[http://www.linuxdj.com/audio/lad/ linux-audio-dev homepage]
*[http://www.djcj.org/ Linux Audio Users Guide]
*[http://www.multimedia4linux.de Multimedia4Linux (German)]
*[http://www.devolution.com/~slouken/projects/SDL Simple DirectMedia Layer]
*[http://sunsite.auc.dk/penguinplay PenguinPlay GSDK]
*[http://www.perex.cz/~perex/ultra The Linux Ultra Sound Project]
*[http://www.hitsquad.com/smm/linux Shareware Music Machine (Linux section)]
*[http://www.wotsit.org Wotsit's format: The programmer's file formats and data formats resource]
*[http://etv.hshaarlem.nl/~jeroena/thenightingale/enter.htm The Nightingale Project]
*[http://www.utopiasd.com Utopia Sound Division site]
*[http://ccrma-www.stanford.edu/~jos/resample/ Bandlimited Interpolation]
*[http://ccrma-www.stanford.edu/planetccrma/software/ Planet CCRMA at home]

== SoundCards Links ==

The soundcard vendors are present in the random order. It does not imply
that all or any soundcards produced by some vendor are supported inside
the ALSA driver.

*[http://www.midiman.com Midiman]
*[http://www.tbeach.com Voyetra Turtle Beach, Inc.]
*[http://www.s3.com S3 Incorporated]
*[http://www.esstech.com.tw ESS Technology]
*[http://www.yamaha-xg.com Yamaha Corporation - XG]
*[http://www.yamaha.co.jp/english/product/lsi/prod/ Yamaha Corporation - LSIs]
*[http://www.creativelabs.com Creative Labs, Inc.]
*[http://opensource.creative.com Creative Labs, Inc. (open source)]
*[http://www.crystal.com Crystal Semiconductor]
*[http://www.gravis.com Advanced Gravis Computer Technology Ltd.]
*[http://www.amd.com Advanced Micro Devices, Inc. (AMD)]
*[http://www.oaktech.com OAK Technology]
*[http://www.zefiro.com Zefiro Acoustics]
*[http://www.cmedia.com.tw C-Media Electronics, Inc]
*[http://www.digigram.com Digigram Inc.]
*[http://www.tridentmicro.com Trident Microsystems, Inc.]
*[http://www.fortemedia.com Forte Media, Inc.]
*[http://www.avance.com AvanceLogic, Inc.]
*[http://www.rme-audio.com RME Audio]
*[http://www.marian.de MARIAN] | [http://www.sekd.com SEK'D]
*[http://www.asahi-kasei.co.jp/akm/english/ Asahi Kasei Microsystems, co., Ltd.]
*[http://www.wolfson.co.uk Wolfson Microelectronic]

== Other documents ==

*[http://www.alsa-project.org/misc/vgakills.txt VGA Kills Audio?]
*[http://www.alsa-project.org/misc/gus_jumpers.html GUS Classic - full duplex]
*[http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro/docbook-intro.html DocBook intro]
*[http://www.oasis-open.org/docbook/documentation/reference/html/docbook.html DocBook - The definive guide]

Mailing-lists

2007-05-06T22:25:33Z

Soe:

== Big Warning ==

We have continuous problems with e-mail spammers. The ALSA server does not accept an e-mail from open relays. We are using the three databases to determine, if your relay is open or if your relay does not follow our policy. Please, do not complain directly to any ALSA administrator. Your messages will be silently ignored. Complete information is available:

* http://www.mail-abuse.org/rbl/ (spam hosts)
* http://www.mail-abuse.org/dul/ (dialup hosts)
* http://www.mail-abuse.org/rss/ (open relays)

== alsa-announce at alsa-project.org ==

The mailing list for ALSA related announcements of new releases and ALSA software. ''[open, moderated]''

To subscribe use this link: [http://lists.sourceforge.net/lists/listinfo/alsa-announce http://lists.sourceforge.net/lists/listinfo/alsa-announce]

'''Archives'''

*[http://www.mail-archive.com/alsa-announce%40lists.sourceforge.net http://www.mail-archive.com/alsa-announce%40lists.sourceforge.net] (mail-archive.com)
*[http://www.geocrawler.com/redir-sf.php?list=alsa-announce http://www.geocrawler.com/redir-sf.php?list=alsa-announce] (geocrawler)

''To unsubscribe from the old alsa-announce mailing list, send an e-mail to < alsa-announce-request-old at alsa-project.org > with the body 'unsubscribe <email_address>'.''

== alsa-devel at alsa-project.org ==

The mailing list for ALSA developers. ''[open, unmoderated for subscribers, moderated for others]''

To subscribe (if you would like to work on the driver, library or an ALSA application) use this link: [http://mailman.alsa-project.org/mailman/listinfo/alsa-devel http://mailman.alsa-project.org/mailman/listinfo/alsa-devel]

'''Archives'''

*[http://mailman.alsa-project.org/pipermail/alsa-devel/ http://mailman.alsa-project.org/pipermail/alsa-devel/] (mailman.alsa-project.org)
*[http://news.gmane.org/gmane.linux.alsa.devel http://news.gmane.org/gmane.linux.alsa.devel] (gmane.org)
*[http://www.mail-archive.com/alsa-devel%40lists.sourceforge.net http://www.mail-archive.com/alsa-devel%40lists.sourceforge.net] (mail-archive.com)
*[http://www.geocrawler.com/lists/3/SourceForge/12349/0/ http://www.geocrawler.com/lists/3/SourceForge/12349/0/] (geocrawler)
*[http://www.geocrawler.com/redir-sf.php?list=alsa-devel http://www.geocrawler.com/redir-sf.php?list=alsa-devel] (old alsa-devel archive)

== alsa-user at lists.sourceforge.net ==

The mailing list for ALSA users. ''[open, unmoderated for subscribers, moderated for others]''

To subscribe (if you need a help with the installation of ALSA packages) use this link: [http://lists.sourceforge.net/lists/listinfo/alsa-user http://lists.sourceforge.net/lists/listinfo/alsa-user]

'''Archives'''
*[http://news.gmane.org/gmane.linux.alsa.user http://news.gmane.org/gmane.linux.alsa.user] (gmane.org)
*[http://www.mail-archive.com/alsa-user%40lists.sourceforge.net http://www.mail-archive.com/alsa-user%40lists.sourceforge.net] (mail-archive.com)
*[http://www.geocrawler.com/lists/3/SourceForge/12350/0/ http://www.geocrawler.com/lists/3/SourceForge/12350/0/] (geocrawler)
*[http://www.geocrawler.com/redir-sf.php?list=alsa-user http://www.geocrawler.com/redir-sf.php?list=alsa-user] (old alsa-user archive)

''To unsubscribe from the old alsa-user mailing list, send an e-mail to < alsa-user-request-old at alsa-project.org > with the body 'unsubscribe <email_address>'.''

== alsa-cvslog at alsa-project.org ==

The mailing list for anyone. ''[open, receive only]''

To subscribe (if you want to receive the CVS commit information) use this link: [http://lists.sourceforge.net/lists/listinfo/alsa-cvslog http://lists.sourceforge.net/lists/listinfo/alsa-cvslog]

'''Archives'''

*[http://www.mail-archive.com/alsa-cvslog%40lists.sourceforge.net http://www.mail-archive.com/alsa-cvslog%40lists.sourceforge.net] (mail-archive.com)

== alsa-conf at alsa-project.org ==

The mailing list for ALSAconf team members. ''[closed, unmoderated]''

If you want work on the configuration library and application, send message to Jaroslav Kysela < perex at suse.cz >.

'''Archives'''

*[http://www.alsa-project.org/archive/alsa-conf http://www.alsa-project.org/archive/alsa-conf]

== alsa-doc at alsa-project.org ==

The mailing list for ALSA programmer's documentation team members. ''[closed, unmoderated]''

If you have any question about the ALSA programmer's documentation a suggestion to improve the programmer's documents, please, post an e-mail to the alsa-devel mailing list instead. If you want work on ALSA programmer's documentation, send message to Jaroslav Kysela < perex at suse.cz >.

'''Archives'''

*[http://www.alsa-project.org/archive/alsa-doc http://www.alsa-project.org/archive/alsa-doc]

== Archives on other hosts ==

*[http://hyppo.screwdriver.net/list.phtml?archive=alsa-devel alsa-devel at alsa-project.org] Archive for mailing list for ALSA developers at hyppo.screwdriver.net.
*[http://www.mail-archive.com/alsa-devel@alsa-project.org/ alsa-devel at alsa-project.org] Archive for mailing list for ALSA developers at www.mail-archive.com.
*[http://hyppo.screwdriver.net/list.phtml?archive=alsa-user alsa-user at alsa-project.org] Archive for mailing list for ALSA users at hyppo.screwdriver.net.
*[http://www.mail-archive.com/alsa-user@alsa-project.org/ alsa-user at alsa-project.org] Archive for mailing list for ALSA users at www.mail-archive.com.

Mailing-lists

2007-05-06T22:25:05Z

Soe: New page: == Big Warning == We have continuous problems with e-mail spammers. The ALSA server does not accept an e-mail from open relays. We are using the three databases to determine, if your rel...

== Big Warning ==

We have continuous problems with e-mail spammers. The ALSA server does not accept an e-mail from open relays. We are using the three databases to determine, if your relay is open or if your relay does not follow our policy. Please, do not complain directly to any ALSA administrator. Your messages will be silently ignored. Complete information is available:

* http://www.mail-abuse.org/rbl/ (spam hosts)
* http://www.mail-abuse.org/dul/ (dialup hosts)
* http://www.mail-abuse.org/rss/ (open relays)}}

== alsa-announce at alsa-project.org ==

The mailing list for ALSA related announcements of new releases and ALSA software. ''[open, moderated]''

To subscribe use this link: [http://lists.sourceforge.net/lists/listinfo/alsa-announce http://lists.sourceforge.net/lists/listinfo/alsa-announce]

'''Archives'''

*[http://www.mail-archive.com/alsa-announce%40lists.sourceforge.net http://www.mail-archive.com/alsa-announce%40lists.sourceforge.net] (mail-archive.com)
*[http://www.geocrawler.com/redir-sf.php?list=alsa-announce http://www.geocrawler.com/redir-sf.php?list=alsa-announce] (geocrawler)

''To unsubscribe from the old alsa-announce mailing list, send an e-mail to < alsa-announce-request-old at alsa-project.org > with the body 'unsubscribe <email_address>'.''

== alsa-devel at alsa-project.org ==

The mailing list for ALSA developers. ''[open, unmoderated for subscribers, moderated for others]''

To subscribe (if you would like to work on the driver, library or an ALSA application) use this link: [http://mailman.alsa-project.org/mailman/listinfo/alsa-devel http://mailman.alsa-project.org/mailman/listinfo/alsa-devel]

'''Archives'''

*[http://mailman.alsa-project.org/pipermail/alsa-devel/ http://mailman.alsa-project.org/pipermail/alsa-devel/] (mailman.alsa-project.org)
*[http://news.gmane.org/gmane.linux.alsa.devel http://news.gmane.org/gmane.linux.alsa.devel] (gmane.org)
*[http://www.mail-archive.com/alsa-devel%40lists.sourceforge.net http://www.mail-archive.com/alsa-devel%40lists.sourceforge.net] (mail-archive.com)
*[http://www.geocrawler.com/lists/3/SourceForge/12349/0/ http://www.geocrawler.com/lists/3/SourceForge/12349/0/] (geocrawler)
*[http://www.geocrawler.com/redir-sf.php?list=alsa-devel http://www.geocrawler.com/redir-sf.php?list=alsa-devel] (old alsa-devel archive)

== alsa-user at lists.sourceforge.net ==

The mailing list for ALSA users. ''[open, unmoderated for subscribers, moderated for others]''

To subscribe (if you need a help with the installation of ALSA packages) use this link: [http://lists.sourceforge.net/lists/listinfo/alsa-user http://lists.sourceforge.net/lists/listinfo/alsa-user]

'''Archives'''
*[http://news.gmane.org/gmane.linux.alsa.user http://news.gmane.org/gmane.linux.alsa.user] (gmane.org)
*[http://www.mail-archive.com/alsa-user%40lists.sourceforge.net http://www.mail-archive.com/alsa-user%40lists.sourceforge.net] (mail-archive.com)
*[http://www.geocrawler.com/lists/3/SourceForge/12350/0/ http://www.geocrawler.com/lists/3/SourceForge/12350/0/] (geocrawler)
*[http://www.geocrawler.com/redir-sf.php?list=alsa-user http://www.geocrawler.com/redir-sf.php?list=alsa-user] (old alsa-user archive)

''To unsubscribe from the old alsa-user mailing list, send an e-mail to < alsa-user-request-old at alsa-project.org > with the body 'unsubscribe <email_address>'.''

== alsa-cvslog at alsa-project.org ==

The mailing list for anyone. ''[open, receive only]''

To subscribe (if you want to receive the CVS commit information) use this link: [http://lists.sourceforge.net/lists/listinfo/alsa-cvslog http://lists.sourceforge.net/lists/listinfo/alsa-cvslog]

'''Archives'''

*[http://www.mail-archive.com/alsa-cvslog%40lists.sourceforge.net http://www.mail-archive.com/alsa-cvslog%40lists.sourceforge.net] (mail-archive.com)

== alsa-conf at alsa-project.org ==

The mailing list for ALSAconf team members. ''[closed, unmoderated]''

If you want work on the configuration library and application, send message to Jaroslav Kysela < perex at suse.cz >.

'''Archives'''

*[http://www.alsa-project.org/archive/alsa-conf http://www.alsa-project.org/archive/alsa-conf]

== alsa-doc at alsa-project.org ==

The mailing list for ALSA programmer's documentation team members. ''[closed, unmoderated]''

If you have any question about the ALSA programmer's documentation a suggestion to improve the programmer's documents, please, post an e-mail to the alsa-devel mailing list instead. If you want work on ALSA programmer's documentation, send message to Jaroslav Kysela < perex at suse.cz >.

'''Archives'''

*[http://www.alsa-project.org/archive/alsa-doc http://www.alsa-project.org/archive/alsa-doc]

== Archives on other hosts ==

*[http://hyppo.screwdriver.net/list.phtml?archive=alsa-devel alsa-devel at alsa-project.org] Archive for mailing list for ALSA developers at hyppo.screwdriver.net.
*[http://www.mail-archive.com/alsa-devel@alsa-project.org/ alsa-devel at alsa-project.org] Archive for mailing list for ALSA developers at www.mail-archive.com.
*[http://hyppo.screwdriver.net/list.phtml?archive=alsa-user alsa-user at alsa-project.org] Archive for mailing list for ALSA users at hyppo.screwdriver.net.
*[http://www.mail-archive.com/alsa-user@alsa-project.org/ alsa-user at alsa-project.org] Archive for mailing list for ALSA users at www.mail-archive.com.