diff src/audio/alsa/SDL_alsa_audio.c @ 0:74212992fb08

Initial revision
author Sam Lantinga <slouken@lokigames.com>
date Thu, 26 Apr 2001 16:45:43 +0000
parents
children e8157fcb3114
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/audio/alsa/SDL_alsa_audio.c	Thu Apr 26 16:45:43 2001 +0000
@@ -0,0 +1,521 @@
+/*
+    SDL - Simple DirectMedia Layer
+    Copyright (C) 1997, 1998, 1999, 2000, 2001  Sam Lantinga
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Library General Public
+    License as published by the Free Software Foundation; either
+    version 2 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Library General Public License for more details.
+
+    You should have received a copy of the GNU Library General Public
+    License along with this library; if not, write to the Free
+    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+    Sam Lantinga
+    slouken@devolution.com
+*/
+
+
+
+/* Allow access to a raw mixing buffer */
+
+#include <stdlib.h>
+#include <stdio.h>
+#include <string.h>
+#include <errno.h>
+#include <unistd.h>
+#include <fcntl.h>
+#include <signal.h>
+#include <sys/types.h>
+#include <sys/time.h>
+
+#include "SDL_audio.h"
+#include "SDL_error.h"
+#include "SDL_audiomem.h"
+#include "SDL_audio_c.h"
+#include "SDL_timer.h"
+#include "SDL_alsa_audio.h"
+
+/* The tag name used by ALSA audio */
+#define DRIVER_NAME         "alsa"
+
+/* default card and device numbers as listed in dev/snd */
+static int card_no = 0;
+static int device_no = 0;
+
+/* default channel communication parameters */
+#define DEFAULT_CPARAMS_RATE 22050
+#define DEFAULT_CPARAMS_VOICES 1
+#define DEFAULT_CPARAMS_FRAG_SIZE 512
+#define DEFAULT_CPARAMS_FRAGS_MIN 1
+#define DEFAULT_CPARAMS_FRAGS_MAX -1
+
+/* Open the audio device for playback, and don't block if busy */
+#define OPEN_FLAGS	(SND_PCM_OPEN_PLAYBACK|SND_PCM_OPEN_NONBLOCK)
+
+/* Audio driver functions */
+static int PCM_OpenAudio(_THIS, SDL_AudioSpec *spec);
+static void PCM_WaitAudio(_THIS);
+static void PCM_PlayAudio(_THIS);
+static Uint8 *PCM_GetAudioBuf(_THIS);
+static void PCM_CloseAudio(_THIS);
+
+/* PCM transfer channel parameters initialize function */
+static void init_pcm_cparams(snd_pcm_channel_params_t* cparams)
+{
+	memset(cparams,0,sizeof(snd_pcm_channel_params_t));
+
+	cparams->channel = SND_PCM_CHANNEL_PLAYBACK;
+	cparams->mode = SND_PCM_MODE_BLOCK;
+	cparams->start_mode = SND_PCM_START_DATA; //_FULL
+	cparams->stop_mode  = SND_PCM_STOP_STOP;
+	cparams->format.format = SND_PCM_SFMT_S16_LE;
+	cparams->format.interleave = 1;
+	cparams->format.rate = DEFAULT_CPARAMS_RATE;
+	cparams->format.voices = DEFAULT_CPARAMS_VOICES;
+	cparams->buf.block.frag_size = DEFAULT_CPARAMS_FRAG_SIZE;
+	cparams->buf.block.frags_min = DEFAULT_CPARAMS_FRAGS_MIN;
+	cparams->buf.block.frags_max = DEFAULT_CPARAMS_FRAGS_MAX;
+}
+
+/* Audio driver bootstrap functions */
+
+static int Audio_Available(void)
+/*
+	See if we can open a nonblocking channel.
+	Return value '1' means we can.
+	Return value '0' means we cannot.
+*/
+{
+	int available;
+	int rval;
+	snd_pcm_t *handle;
+	snd_pcm_channel_params_t cparams;
+#ifdef DEBUG_AUDIO
+	snd_pcm_channel_status_t cstatus;
+#endif
+
+	available = 0;
+	handle = NULL;
+
+	init_pcm_cparams(&cparams);
+	
+	rval = snd_pcm_open(&handle, card_no, device_no, OPEN_FLAGS);
+	if (rval >= 0)
+	{
+		rval = snd_pcm_plugin_params(handle, &cparams);
+
+#ifdef DEBUG_AUDIO
+		snd_pcm_plugin_status(handle, &cstatus);
+		printf("status after snd_pcm_plugin_params call = %d\n",cstatus.status);
+#endif
+		if (rval >= 0)
+		{
+			available = 1;
+		}
+		else
+		{
+	        	SDL_SetError("snd_pcm_channel_params failed: %s\n", snd_strerror (rval));
+		}
+
+        if ((rval = snd_pcm_close(handle)) < 0)
+        {
+            SDL_SetError("snd_pcm_close failed: %s\n",snd_strerror(rval));
+			available = 0;
+        }
+	}
+	else
+	{
+       SDL_SetError("snd_pcm_open failed: %s\n", snd_strerror(rval));
+	}
+
+	return(available);
+}
+
+static void Audio_DeleteDevice(SDL_AudioDevice *device)
+{
+	free(device->hidden);
+	free(device);
+}
+
+static SDL_AudioDevice *Audio_CreateDevice(int devindex)
+{
+	SDL_AudioDevice *this;
+
+	/* Initialize all variables that we clean on shutdown */
+	this = (SDL_AudioDevice *)malloc(sizeof(SDL_AudioDevice));
+	if ( this ) {
+		memset(this, 0, (sizeof *this));
+		this->hidden = (struct SDL_PrivateAudioData *)
+				malloc((sizeof *this->hidden));
+	}
+	if ( (this == NULL) || (this->hidden == NULL) ) {
+		SDL_OutOfMemory();
+		if ( this ) {
+			free(this);
+		}
+		return(0);
+	}
+	memset(this->hidden, 0, (sizeof *this->hidden));
+	audio_handle = NULL;
+
+	/* Set the function pointers */
+	this->OpenAudio = PCM_OpenAudio;
+	this->WaitAudio = PCM_WaitAudio;
+	this->PlayAudio = PCM_PlayAudio;
+	this->GetAudioBuf = PCM_GetAudioBuf;
+	this->CloseAudio = PCM_CloseAudio;
+
+	this->free = Audio_DeleteDevice;
+
+	return this;
+}
+
+AudioBootStrap ALSA_bootstrap = {
+	DRIVER_NAME, "ALSA PCM audio",
+	Audio_Available, Audio_CreateDevice
+};
+
+/* This function waits until it is possible to write a full sound buffer */
+static void PCM_WaitAudio(_THIS)
+{
+
+	/* Check to see if the thread-parent process is still alive */
+	{ static int cnt = 0;
+		/* Note that this only works with thread implementations 
+		   that use a different process id for each thread.
+		*/
+		if (parent && (((++cnt)%10) == 0)) { /* Check every 10 loops */
+			if ( kill(parent, 0) < 0 ) {
+				this->enabled = 0;
+			}
+		}
+	}
+
+	/* See if we need to use timed audio synchronization */
+	if ( frame_ticks ) 
+	{
+		/* Use timer for general audio synchronization */
+		Sint32 ticks;
+
+		ticks = ((Sint32)(next_frame - SDL_GetTicks()))-FUDGE_TICKS;
+		if ( ticks > 0 ) 
+		{
+			SDL_Delay(ticks);
+		}
+	}
+    else 
+	{
+    	/* Use select() for audio synchronization */
+		fd_set fdset;
+	    struct timeval timeout;
+    	FD_ZERO(&fdset);
+	    FD_SET(audio_fd, &fdset);
+    	timeout.tv_sec = 10;
+	    timeout.tv_usec = 0;
+#ifdef DEBUG_AUDIO
+    	fprintf(stderr, "Waiting for audio to get ready\n");
+#endif
+	    if ( select(audio_fd+1, NULL, &fdset, NULL, &timeout) <= 0 ) 
+		{
+            const char *message =
+            "Audio timeout - buggy audio driver? (disabled)";
+	        /* In general we should never print to the screen,
+       	       but in this case we have no other way of letting
+               the user know what happened.
+            */
+       	    fprintf(stderr, "SDL: %s\n", message);
+   	        this->enabled = 0;
+            /* Don't try to close - may hang */
+            audio_fd = -1;
+#ifdef DEBUG_AUDIO
+       	    fprintf(stderr, "Done disabling audio\n");
+#endif
+    	    }
+#ifdef DEBUG_AUDIO
+        fprintf(stderr, "Ready!\n");
+#endif
+    }
+}
+
+static snd_pcm_channel_status_t cstatus;
+
+static void PCM_PlayAudio(_THIS)
+{
+    int written, rval;
+
+    /* Write the audio data, checking for EAGAIN (buffer full) and underrun */
+    do {
+		written = snd_pcm_plugin_write(audio_handle, pcm_buf, pcm_len);
+#ifdef DEBUG_AUDIO
+		fprintf(stderr, "written = %d pcm_len = %d\n",written,pcm_len);
+#endif
+		if (written != pcm_len)
+		{
+	        if (errno == EAGAIN) 
+			{
+            	SDL_Delay(1);   /* Let a little CPU time go by and try to write again */
+#ifdef DEBUG_AUDIO
+				fprintf(stderr, "errno == EAGAIN\n");
+#endif
+        	}
+			else
+			{
+		        if( (rval = snd_pcm_plugin_status(audio_handle, &cstatus)) < 0 )
+        		{
+		            SDL_SetError("snd_pcm_plugin_status failed: %s\n", snd_strerror(rval));
+        		    return;
+		        }
+				if ( (cstatus.status == SND_PCM_STATUS_UNDERRUN)
+					||(cstatus.status == SND_PCM_STATUS_READY) )
+				{
+#ifdef DEBUG_AUDIO
+					fprintf(stderr, "buffer underrun\n");
+#endif
+					if ( (rval = snd_pcm_plugin_prepare (audio_handle,SND_PCM_CHANNEL_PLAYBACK)) < 0 )
+					{
+						SDL_SetError("snd_pcm_plugin_prepare failed: %s\n",snd_strerror(rval) );
+						return;
+					}
+					/* if we reach here, try to write again */
+				}
+			}
+		}
+    } while ( (written < 0) && ((errno == 0) || (errno == EAGAIN)) );
+
+    /* Set the next write frame */
+   if ( frame_ticks ) {
+	    next_frame += frame_ticks;
+	}
+
+    /* If we couldn't write, assume fatal error for now */
+    if ( written < 0 ) {
+        this->enabled = 0;
+    }
+	return;
+}
+
+static Uint8 *PCM_GetAudioBuf(_THIS)
+{
+	return(pcm_buf);
+}
+
+static void PCM_CloseAudio(_THIS)
+{
+	int rval;
+
+	if ( pcm_buf != NULL ) {
+		free(pcm_buf);
+		pcm_buf = NULL;
+	}
+	if ( audio_handle != NULL ) {
+		if ((rval = snd_pcm_plugin_flush(audio_handle,SND_PCM_CHANNEL_PLAYBACK)) < 0)
+		{
+        	SDL_SetError("snd_pcm_plugin_flush failed: %s\n",snd_strerror(rval));
+			return;
+		}
+		if ((rval = snd_pcm_close(audio_handle)) < 0)
+		{
+			SDL_SetError("snd_pcm_close failed: %s\n",snd_strerror(rval));
+			return;
+		}
+		audio_handle = NULL;
+	}
+}
+
+static int PCM_OpenAudio(_THIS, SDL_AudioSpec *spec)
+{
+	int rval;
+	snd_pcm_channel_params_t cparams;
+	snd_pcm_channel_setup_t  csetup;
+	int format;
+	Uint16 test_format;
+	int twidth;
+
+	/* initialize channel transfer parameters to default */
+	init_pcm_cparams(&cparams);
+
+	/* Reset the timer synchronization flag */
+	frame_ticks = 0.0;
+
+	/* Open the audio device */
+	
+	rval = snd_pcm_open(&audio_handle, card_no, device_no, OPEN_FLAGS);
+	if ( rval < 0 ) {
+		SDL_SetError("snd_pcm_open failed: %s\n", snd_strerror(rval));
+		return(-1);
+	}
+
+#ifdef PLUGIN_DISABLE_MMAP /* This is gone in newer versions of ALSA? */
+    /* disable count status parameter */
+    if ((rval = snd_plugin_set_disable(audio_handle, PLUGIN_DISABLE_MMAP))<0)
+    {
+        SDL_SetError("snd_plugin_set_disable failed: %s\n", snd_strerror(rval));
+        return(-1);
+    }
+#endif
+
+	pcm_buf = NULL;
+
+	/* Try for a closest match on audio format */
+	format = 0;
+	for ( test_format = SDL_FirstAudioFormat(spec->format);
+						! format && test_format; ) 
+	{
+#ifdef DEBUG_AUDIO
+		fprintf(stderr, "Trying format 0x%4.4x spec->samples %d\n", test_format,spec->samples);
+#endif
+			/* if match found set format to equivalent ALSA format */
+        switch ( test_format ) {
+			case AUDIO_U8:
+				format = SND_PCM_SFMT_U8;
+				cparams.buf.block.frag_size = spec->samples * spec->channels;
+				break;
+			case AUDIO_S8:
+				format = SND_PCM_SFMT_S8;
+				cparams.buf.block.frag_size = spec->samples * spec->channels;
+				break;
+			case AUDIO_S16LSB:
+				format = SND_PCM_SFMT_S16_LE;
+				cparams.buf.block.frag_size = spec->samples*2 * spec->channels;
+				break;
+			case AUDIO_S16MSB:
+				format = SND_PCM_SFMT_S16_BE;
+				cparams.buf.block.frag_size = spec->samples*2 * spec->channels;
+				break;
+			case AUDIO_U16LSB:
+				format = SND_PCM_SFMT_U16_LE;
+				cparams.buf.block.frag_size = spec->samples*2 * spec->channels;
+				break;
+			case AUDIO_U16MSB:
+				format = SND_PCM_SFMT_U16_BE;
+				cparams.buf.block.frag_size = spec->samples*2 * spec->channels;
+				break;
+			default:
+				break;
+		}
+		if ( ! format ) {
+			test_format = SDL_NextAudioFormat();
+		}
+	}
+	if ( format == 0 ) {
+		SDL_SetError("Couldn't find any hardware audio formats");
+		return(-1);
+	}
+	spec->format = test_format;
+
+	/* Set the audio format */
+	cparams.format.format = format;
+
+	/* Set mono or stereo audio (currently only two channels supported) */
+	cparams.format.voices = spec->channels;
+	
+	#ifdef DEBUG_AUDIO
+	printf("intializing channels %d\n", cparams.format.voices);
+	#endif
+	
+	/* Set rate */
+	cparams.format.rate = spec->freq ;
+
+	/* Setup the transfer parameters according to cparams */
+	rval = snd_pcm_plugin_params(audio_handle, &cparams);
+	if (rval < 0) {
+		SDL_SetError("snd_pcm_channel_params failed: %s\n", snd_strerror (rval));
+		return(-1);
+	}
+
+    /*  Make sure channel is setup right one last time */
+    memset( &csetup, 0, sizeof( csetup ) );
+    csetup.channel = SND_PCM_CHANNEL_PLAYBACK;
+    if ( snd_pcm_plugin_setup( audio_handle, &csetup ) < 0 )
+    {
+        SDL_SetError("Unable to setup playback channel\n" );
+        return(-1);
+    }
+
+#ifdef DEBUG_AUDIO
+    else
+    {
+        fprintf(stderr,"requested format: %d\n",cparams.format.format);
+        fprintf(stderr,"requested frag size: %d\n",cparams.buf.block.frag_size);
+        fprintf(stderr,"requested max frags: %d\n\n",cparams.buf.block.frags_max);
+
+        fprintf(stderr,"real format: %d\n", csetup.format.format );
+        fprintf(stderr,"real frag size : %d\n", csetup.buf.block.frag_size );
+		fprintf(stderr,"real max frags : %d\n", csetup.buf.block.frags_max );
+    }
+#endif // DEBUG_AUDIO
+
+    /*  Allocate memory to the audio buffer and initialize with silence
+        (Note that buffer size must be a multiple of fragment size, so find closest multiple)
+    */
+    
+    twidth = snd_pcm_format_width(format);
+    if (twidth < 0) {
+        printf("snd_pcm_format_width failed\n");
+        twidth = 0;
+    }
+#ifdef DEBUG_AUDIO
+    printf("format is %d bits wide\n",twidth);
+#endif      
+    
+    pcm_len = csetup.buf.block.frag_size * (twidth/8) * csetup.format.voices ;
+    
+#ifdef DEBUG_AUDIO    
+    printf("pcm_len set to %d\n", pcm_len);
+#endif
+    
+    if (pcm_len == 0)
+    {
+        pcm_len = csetup.buf.block.frag_size;
+    }
+    
+    pcm_buf = (Uint8*)malloc(pcm_len);
+    if (pcm_buf == NULL) {
+        SDL_SetError("pcm_buf malloc failed\n");
+        return(-1);
+    }
+    memset(pcm_buf,spec->silence,pcm_len);
+
+#ifdef DEBUG_AUDIO
+	fprintf(stderr,"pcm_buf malloced and silenced.\n");
+#endif
+
+    /* get the file descriptor */
+    if( (audio_fd = snd_pcm_file_descriptor(audio_handle, device_no)) < 0)
+    {
+       fprintf(stderr, "snd_pcm_file_descriptor failed with error code: %d\n", audio_fd);
+    }
+
+	/* Trigger audio playback */
+	rval = snd_pcm_plugin_prepare( audio_handle, SND_PCM_CHANNEL_PLAYBACK);
+	if (rval < 0) {
+       SDL_SetError("snd_pcm_plugin_prepare failed: %s\n", snd_strerror (rval));
+       return(-1);
+	}
+	rval =  snd_pcm_playback_go(audio_handle);
+    if (rval < 0) {
+       SDL_SetError("snd_pcm_playback_go failed: %s\n", snd_strerror (rval));
+       return(-1);
+    }
+
+    /* Check to see if we need to use select() workaround */
+    { char *workaround;
+        workaround = getenv("SDL_DSP_NOSELECT");
+        if ( workaround ) {
+            frame_ticks = (float)(spec->samples*1000)/spec->freq;
+            next_frame = SDL_GetTicks()+frame_ticks;
+        }
+    }
+
+	/* Get the parent process id (we're the parent of the audio thread) */
+	parent = getpid();
+
+	/* We're ready to rock and roll. :-) */
+	return(0);
+}