4 Support for the ALSA 1.0.1 sound driver
6 Copyright (C) 1999,2000 contributors of the QuakeForge project
7 Please see the file "AUTHORS" for a list of contributors
9 This program is free software; you can redistribute it and/or
10 modify it under the terms of the GNU General Public License
11 as published by the Free Software Foundation; either version 2
12 of the License, or (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
18 See the GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program; if not, write to:
23 Free Software Foundation, Inc.
24 59 Temple Place - Suite 330
25 Boston, MA 02111-1307, USA
29 #include <alsa/asoundlib.h>
34 static snd_pcm_uframes_t buffer_size;
36 static const char *pcmname = NULL;
37 static snd_pcm_t *pcm;
39 qboolean SNDDMA_Init (void)
45 snd_pcm_hw_params_t *hw;
46 snd_pcm_sw_params_t *sw;
47 snd_pcm_uframes_t frag_size;
49 snd_pcm_hw_params_alloca (&hw);
50 snd_pcm_sw_params_alloca (&sw);
52 // COMMANDLINEOPTION: Linux ALSA Sound: -sndbits <number> sets sound precision to 8 or 16 bit (email me if you want others added)
54 if ((i=COM_CheckParm("-sndbits")) != 0)
56 j = atoi(com_argv[i+1]);
57 if (j == 16 || j == 8)
60 Con_Printf("Error: invalid sample bits: %d\n", j);
63 // COMMANDLINEOPTION: Linux ALSA Sound: -sndspeed <hz> chooses 44100 hz, 22100 hz, or 11025 hz sound output rate
65 if ((i=COM_CheckParm("-sndspeed")) != 0)
67 j = atoi(com_argv[i+1]);
71 Con_Printf("Error: invalid sample rate: %d\n", rate);
74 for (channels = 8;channels >= 1;channels--)
76 if ((channels & 1) && channels != 1)
78 // COMMANDLINEOPTION: Linux ALSA Sound: -sndmono sets sound output to mono
79 if ((i=COM_CheckParm("-sndmono")) != 0)
82 // COMMANDLINEOPTION: Linux ALSA Sound: -sndstereo sets sound output to stereo
83 if ((i=COM_CheckParm("-sndstereo")) != 0)
87 // COMMANDLINEOPTION: Linux ALSA Sound: -sndpcm <devicename> selects which pcm device to us, default is "default"
89 pcmname = "surround71";
90 else if (channels == 6)
91 pcmname = "surround51";
92 else if (channels == 4)
93 pcmname = "surround40";
96 if ((i=COM_CheckParm("-sndpcm"))!=0)
97 pcmname = com_argv[i+1];
99 Con_Printf ("ALSA: Trying PCM %s.\n", pcmname);
101 err = snd_pcm_open (&pcm, pcmname, SND_PCM_STREAM_PLAYBACK, SND_PCM_NONBLOCK);
104 Con_Printf ("Error: audio open error: %s\n", snd_strerror (err));
108 err = snd_pcm_hw_params_any (pcm, hw);
111 Con_Printf ("ALSA: error setting hw_params_any. %s\n", snd_strerror (err));
116 err = snd_pcm_hw_params_set_access (pcm, hw, SND_PCM_ACCESS_MMAP_INTERLEAVED);
119 Con_Printf ("ALSA: Failure to set interleaved mmap PCM access. %s\n", snd_strerror (err));
124 err = snd_pcm_hw_params_set_format (pcm, hw, width == 1 ? SND_PCM_FORMAT_U8 : SND_PCM_FORMAT_S16);
127 Con_Printf ("ALSA: desired bits %i not supported by driver. %s\n", width * 8, snd_strerror (err));
132 err = snd_pcm_hw_params_set_channels (pcm, hw, channels);
135 Con_Printf ("ALSA: no usable channels. %s\n", snd_strerror (err));
140 err = snd_pcm_hw_params_set_rate_near (pcm, hw, &rate, 0);
143 Con_Printf ("ALSA: desired rate %i not supported by driver. %s\n", rate, snd_strerror (err));
148 frag_size = 64 * width * rate / 11025;
149 err = snd_pcm_hw_params_set_period_size_near (pcm, hw, &frag_size, 0);
152 Con_Printf ("ALSA: unable to set period size near %i. %s\n", (int) frag_size, snd_strerror (err));
156 err = snd_pcm_hw_params (pcm, hw);
159 Con_Printf ("ALSA: unable to install hw params: %s\n", snd_strerror (err));
163 err = snd_pcm_sw_params_current (pcm, sw);
166 Con_Printf ("ALSA: unable to determine current sw params. %s\n", snd_strerror (err));
170 err = snd_pcm_sw_params_set_start_threshold (pcm, sw, ~0U);
173 Con_Printf ("ALSA: unable to set playback threshold. %s\n", snd_strerror (err));
177 err = snd_pcm_sw_params_set_stop_threshold (pcm, sw, ~0U);
180 Con_Printf ("ALSA: unable to set playback stop threshold. %s\n", snd_strerror (err));
184 err = snd_pcm_sw_params (pcm, sw);
187 Con_Printf ("ALSA: unable to install sw params. %s\n", snd_strerror (err));
192 err = snd_pcm_hw_params_get_buffer_size (hw, &buffer_size);
195 Con_Printf ("ALSA: unable to get buffer size. %s\n", snd_strerror (err));
200 memset( (void*) shm, 0, sizeof(*shm) );
201 shm->format.channels = channels;
202 shm->format.width = width;
203 shm->format.speed = rate;
205 shm->sampleframes = buffer_size;
206 shm->samples = shm->sampleframes * shm->format.channels;
207 SNDDMA_GetDMAPos (); // sets shm->buffer
214 int SNDDMA_GetDMAPos (void)
216 const snd_pcm_channel_area_t *areas;
217 snd_pcm_uframes_t offset;
218 snd_pcm_uframes_t nframes = shm->sampleframes;
223 snd_pcm_avail_update (pcm);
224 snd_pcm_mmap_begin (pcm, &areas, &offset, &nframes);
225 offset *= shm->format.channels;
226 nframes *= shm->format.channels;
227 shm->samplepos = offset;
228 shm->buffer = (unsigned char *)areas->addr;
229 return shm->samplepos;
232 void SNDDMA_Shutdown (void)
240 Send sound to device if buffer isn't really the dma buffer
242 void SNDDMA_Submit (void)
245 int count = paintedtime - soundtime;
246 const snd_pcm_channel_area_t *areas;
247 snd_pcm_uframes_t nframes;
248 snd_pcm_uframes_t offset;
250 nframes = count / shm->format.channels;
252 snd_pcm_avail_update (pcm);
253 snd_pcm_mmap_begin (pcm, &areas, &offset, &nframes);
255 state = snd_pcm_state (pcm);
258 case SND_PCM_STATE_PREPARED:
259 snd_pcm_mmap_commit (pcm, offset, nframes);
262 case SND_PCM_STATE_RUNNING:
263 snd_pcm_mmap_commit (pcm, offset, nframes);
270 void *S_LockBuffer(void)
275 void S_UnlockBuffer(void)