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>
33 static int snd_inited;
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)
42 int bps = -1, stereo = -1;
43 unsigned int rate = 0;
44 snd_pcm_hw_params_t *hw;
45 snd_pcm_sw_params_t *sw;
46 snd_pcm_uframes_t frag_size;
48 snd_pcm_hw_params_alloca (&hw);
49 snd_pcm_sw_params_alloca (&sw);
51 // COMMANDLINEOPTION: Linux ALSA Sound: -sndpcm <devicename> selects which pcm device to us, default is "default"
52 if ((i=COM_CheckParm("-sndpcm"))!=0)
53 pcmname=com_argv[i+1];
57 // COMMANDLINEOPTION: Linux ALSA Sound: -sndbits <number> sets sound precision to 8 or 16 bit (email me if you want others added)
58 if ((i=COM_CheckParm("-sndbits")) != 0)
60 bps = atoi(com_argv[i+1]);
61 if (bps != 16 && bps != 8)
63 Con_Printf("Error: invalid sample bits: %d\n", bps);
68 // COMMANDLINEOPTION: Linux ALSA Sound: -sndspeed <hz> chooses 44100 hz, 22100 hz, or 11025 hz sound output rate
69 if ((i=COM_CheckParm("-sndspeed")) != 0)
71 rate = atoi(com_argv[i+1]);
72 if (rate!=44100 && rate!=22050 && rate!=11025)
74 Con_Printf("Error: invalid sample rate: %d\n", rate);
79 // COMMANDLINEOPTION: Linux ALSA Sound: -sndmono sets sound output to mono
80 if ((i=COM_CheckParm("-sndmono")) != 0)
82 // COMMANDLINEOPTION: Linux ALSA Sound: -sndstereo sets sound output to stereo
83 if ((i=COM_CheckParm("-sndstereo")) != 0)
86 err = snd_pcm_open (&pcm, pcmname, SND_PCM_STREAM_PLAYBACK,
89 Sys_Printf ("Error: audio open error: %s\n", snd_strerror (err));
92 Sys_Printf ("ALSA: Using PCM %s.\n", pcmname);
94 err = snd_pcm_hw_params_any (pcm, hw);
96 Sys_Printf ("ALSA: error setting hw_params_any. %s\n",
101 err = snd_pcm_hw_params_set_access (pcm, hw,
102 SND_PCM_ACCESS_MMAP_INTERLEAVED);
104 Sys_Printf ("ALSA: Failure to set noninterleaved PCM access. %s\n"
105 "Note: Interleaved is not supported\n",
112 err = snd_pcm_hw_params_set_format (pcm, hw,
116 } else if (0 <= (err = snd_pcm_hw_params_set_format (pcm, hw,
117 SND_PCM_FORMAT_U8))) {
120 Sys_Printf ("ALSA: no useable formats. %s\n",
127 err = snd_pcm_hw_params_set_format (pcm, hw, bps == 8 ?
131 Sys_Printf ("ALSA: no usable formats. %s\n",
137 Sys_Printf ("ALSA: desired format not supported\n");
143 err = snd_pcm_hw_params_set_channels (pcm, hw, 2);
146 } else if (0 <= (err = snd_pcm_hw_params_set_channels (pcm, hw,
150 Sys_Printf ("ALSA: no usable channels. %s\n",
157 err = snd_pcm_hw_params_set_channels (pcm, hw, stereo ? 2 : 1);
159 Sys_Printf ("ALSA: no usable channels. %s\n",
165 Sys_Printf ("ALSA: desired channels not supported\n");
172 err = snd_pcm_hw_params_set_rate_near (pcm, hw, &rate, 0);
174 frag_size = 32 * bps;
177 err = snd_pcm_hw_params_set_rate_near (pcm, hw, &rate, 0);
179 frag_size = 16 * bps;
182 err = snd_pcm_hw_params_set_rate_near (pcm, hw, &rate,
187 Sys_Printf ("ALSA: no usable rates. %s\n",
197 err = snd_pcm_hw_params_set_rate_near (pcm, hw, &rate, 0);
199 Sys_Printf ("ALSA: desired rate %i not supported. %s\n", rate,
203 frag_size = 8 * bps * rate / 11025;
206 Sys_Printf ("ALSA: desired rate %i not supported.\n", rate);
210 err = snd_pcm_hw_params_set_period_size_near (pcm, hw, &frag_size, 0);
212 Sys_Printf ("ALSA: unable to set period size near %i. %s\n",
213 (int) frag_size, snd_strerror (err));
216 err = snd_pcm_hw_params (pcm, hw);
218 Sys_Printf ("ALSA: unable to install hw params: %s\n",
222 err = snd_pcm_sw_params_current (pcm, sw);
224 Sys_Printf ("ALSA: unable to determine current sw params. %s\n",
228 err = snd_pcm_sw_params_set_start_threshold (pcm, sw, ~0U);
230 Sys_Printf ("ALSA: unable to set playback threshold. %s\n",
234 err = snd_pcm_sw_params_set_stop_threshold (pcm, sw, ~0U);
236 Sys_Printf ("ALSA: unable to set playback stop threshold. %s\n",
240 err = snd_pcm_sw_params (pcm, sw);
242 Sys_Printf ("ALSA: unable to install sw params. %s\n",
247 shm->format.channels = stereo + 1;
249 shm->format.width = bps / 8;
251 err = snd_pcm_hw_params_get_buffer_size (hw, &buffer_size);
253 Sys_Printf ("ALSA: unable to get buffer size. %s\n",
258 shm->samples = buffer_size * shm->format.channels; // mono samples in buffer
259 shm->format.speed = rate;
260 SNDDMA_GetDMAPos (); // sets shm->buffer
270 int SNDDMA_GetDMAPos (void)
272 const snd_pcm_channel_area_t *areas;
273 snd_pcm_uframes_t offset;
274 snd_pcm_uframes_t nframes = shm->samples/shm->format.channels;
279 snd_pcm_avail_update (pcm);
280 snd_pcm_mmap_begin (pcm, &areas, &offset, &nframes);
281 offset *= shm->format.channels;
282 nframes *= shm->format.channels;
283 shm->samplepos = offset;
284 shm->buffer = areas->addr;
285 return shm->samplepos;
288 void SNDDMA_Shutdown (void)
299 Send sound to device if buffer isn't really the dma buffer
301 void SNDDMA_Submit (void)
304 int count = paintedtime - soundtime;
305 const snd_pcm_channel_area_t *areas;
306 snd_pcm_uframes_t nframes;
307 snd_pcm_uframes_t offset;
309 nframes = count / shm->format.channels;
311 snd_pcm_avail_update (pcm);
312 snd_pcm_mmap_begin (pcm, &areas, &offset, &nframes);
314 state = snd_pcm_state (pcm);
317 case SND_PCM_STATE_PREPARED:
318 snd_pcm_mmap_commit (pcm, offset, nframes);
321 case SND_PCM_STATE_RUNNING:
322 snd_pcm_mmap_commit (pcm, offset, nframes);
329 void *S_LockBuffer(void)
334 void S_UnlockBuffer(void)