Skip to contentSkip to conversation

initial (incomplete) version of ALSA Audio API tutorial

DISCUSSION Paul Davis 3 participants 4 messages Mar 21, 2002 – Mar 22, 2002

lore
Share & tools
lore

Paul Davis

author
#0 lore raw

prompted by phil kerr this morning, i started writing a tutorial on using the ALSA Audio API (the term "PCM" is OK once you get into this stuff, but ...). The following document represents it current state. I would like to ask for feedback even though it is very incomplete. I have not tested any of the programs yet.

Specific things I would like feedback on:

* is this kind of document useful?
* are you totally put off by my low level discussion of how an audio interface works?
* are there design errors in the sample code?
* is my assumption that the default sw params settings will work fine actually correct?
* does the developer need to set period size?
* what material in particular do you want to see covered by such a tutorial? it is not going to be
a reference work, so keep that in mind. but i am happy to extend it so that it describes (not documents) all aspects of the ALSA Audio API.

One thing that has to change in the sample code is that there is currently no error checking for any of the params setting calls. But I would really appreciate it if Jaroslav and/or Abramo could review the code and let me know if these examples are OK as simple cases. I also want to add more comments to the code to make it clear what they are doing at each point.

I would appreciate it if anybody has any ideas on a really simple way to get the playback examples to make a nice noise without burdening the examples with either waveform generating code and/or calls to some kind of audio file library.

Anyway, the URL:

	http://www.op.net/~pbd/alsa-audio.html

Let me know. This complaint about a lack of documentation for ALSA has got to stop soon, and this is my contribution to making that happen ASAP. My goal is to have a first, finished version of this ready by the end of this weekend (march 24th).

--p

_______________________________________________
Alsa-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/alsa-devel

#1 lore raw
Quoted 2 lines · Paul Davis

prompted by phil kerr this morning, i started writing a tutorial on using the ALSA Audio API

Great!

Quoted 2 lines

(the term "PCM" is OK once you get into this
stuff, but ...).

How about adding PCM to your Terminology section then?

Quoted 2 lines

The following document represents it current state. I would like to ask for feedback even though it is very incomplete.

What is the license for this documentation and its examples?

-- Kevin Conder, [email protected]

_______________________________________________
Alsa-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/alsa-devel

author
#2 lore raw
Quoted 4 lines
Quoted 2 lines

(the term "PCM" is OK once you get into this
stuff, but ...).

How about adding PCM to your Terminology section then?

Done.

Quoted 4 lines
Quoted 2 lines

The following document represents it current state. I would like to ask for feedback even though it is very incomplete.

What is the license for this documentation and its examples?

the code is GPL. the text, i am not sure about at this time. i will at least add a copyright message for now.

--p

_______________________________________________
Alsa-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/alsa-devel

#3 lore raw
In reply to Paul Davis
Quoted 6 lines · Paul Davis

prompted by phil kerr this morning, i started writing a tutorial on using the ALSA Audio API (the term "PCM" is OK once you get into this stuff, but ...). The following document represents it current state. I would like to ask for feedback even though it is very incomplete. I have not tested any of the programs yet.

There's some small edits I would make. I'll send a patch when you're done with it. I wish this was a wiki! (there, out of my system, won't say it again, stay calm Kevin...)

The #includes are interpreted as html by Mozilla and don't display.

Line-by-line comments would be a nice way of increasing "tutorial" content.

It's great to see someone who knows what he's doing taking interest in Alsa documentation.

Regards,
Mark

Signature · 9 lines
Mark Rages
[email protected]           
http://mlug.missouri.edu/~markrages
The beginning is near.

_______________________________________________
Alsa-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/alsa-devel