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)
86 // COMMANDLINEOPTION: Linux ALSA Sound: -sndquad sets sound output to 4 channel surround
87 if ((i=COM_CheckParm("-sndquad")) != 0)
91 // COMMANDLINEOPTION: Linux ALSA Sound: -sndpcm <devicename> selects which pcm device to us, default is "default"
93 pcmname = "surround71";
94 else if (channels == 6)
95 pcmname = "surround51";
96 else if (channels == 4)
97 pcmname = "surround40";
100 if ((i=COM_CheckParm("-sndpcm"))!=0)
101 pcmname = com_argv[i+1];
103 Con_Printf ("ALSA: Trying PCM %s.\n", pcmname);
105 err = snd_pcm_open (&pcm, pcmname, SND_PCM_STREAM_PLAYBACK, SND_PCM_NONBLOCK);
108 Con_Printf ("Error: audio open error: %s\n", snd_strerror (err));
112 err = snd_pcm_hw_params_any (pcm, hw);
115 Con_Printf ("ALSA: error setting hw_params_any. %s\n", snd_strerror (err));
120 err = snd_pcm_hw_params_set_access (pcm, hw, SND_PCM_ACCESS_MMAP_INTERLEAVED);
123 Con_Printf ("ALSA: Failure to set interleaved mmap PCM access. %s\n", snd_strerror (err));
128 err = snd_pcm_hw_params_set_format (pcm, hw, width == 1 ? SND_PCM_FORMAT_U8 : SND_PCM_FORMAT_S16);
131 Con_Printf ("ALSA: desired bits %i not supported by driver. %s\n", width * 8, snd_strerror (err));
136 err = snd_pcm_hw_params_set_channels (pcm, hw, channels);
139 Con_Printf ("ALSA: no usable channels. %s\n", snd_strerror (err));
144 err = snd_pcm_hw_params_set_rate_near (pcm, hw, &rate, 0);
147 Con_Printf ("ALSA: desired rate %i not supported by driver. %s\n", rate, snd_strerror (err));
152 frag_size = 64 * width * rate / 11025;
153 err = snd_pcm_hw_params_set_period_size_near (pcm, hw, &frag_size, 0);
156 Con_Printf ("ALSA: unable to set period size near %i. %s\n", (int) frag_size, snd_strerror (err));
160 err = snd_pcm_hw_params (pcm, hw);
163 Con_Printf ("ALSA: unable to install hw params: %s\n", snd_strerror (err));
167 err = snd_pcm_sw_params_current (pcm, sw);
170 Con_Printf ("ALSA: unable to determine current sw params. %s\n", snd_strerror (err));
174 err = snd_pcm_sw_params_set_start_threshold (pcm, sw, ~0U);
177 Con_Printf ("ALSA: unable to set playback threshold. %s\n", snd_strerror (err));
181 err = snd_pcm_sw_params_set_stop_threshold (pcm, sw, ~0U);
184 Con_Printf ("ALSA: unable to set playback stop threshold. %s\n", snd_strerror (err));
188 err = snd_pcm_sw_params (pcm, sw);
191 Con_Printf ("ALSA: unable to install sw params. %s\n", snd_strerror (err));
196 err = snd_pcm_hw_params_get_buffer_size (hw, &buffer_size);
199 Con_Printf ("ALSA: unable to get buffer size. %s\n", snd_strerror (err));
204 memset( (void*) shm, 0, sizeof(*shm) );
205 shm->format.channels = channels;
206 shm->format.width = width;
207 shm->format.speed = rate;
209 shm->sampleframes = buffer_size;
210 shm->samples = shm->sampleframes * shm->format.channels;
211 SNDDMA_GetDMAPos (); // sets shm->buffer
218 int SNDDMA_GetDMAPos (void)
220 const snd_pcm_channel_area_t *areas;
221 snd_pcm_uframes_t offset;
222 snd_pcm_uframes_t nframes = shm->sampleframes;
227 snd_pcm_avail_update (pcm);
228 snd_pcm_mmap_begin (pcm, &areas, &offset, &nframes);
229 offset *= shm->format.channels;
230 nframes *= shm->format.channels;
231 shm->samplepos = offset;
232 shm->buffer = (unsigned char *)areas->addr;
233 return shm->samplepos;
236 void SNDDMA_Shutdown (void)
244 Send sound to device if buffer isn't really the dma buffer
246 void SNDDMA_Submit (void)
249 int count = paintedtime - soundtime;
250 const snd_pcm_channel_area_t *areas;
251 snd_pcm_uframes_t nframes;
252 snd_pcm_uframes_t offset;
254 nframes = count / shm->format.channels;
256 snd_pcm_avail_update (pcm);
257 snd_pcm_mmap_begin (pcm, &areas, &offset, &nframes);
259 state = snd_pcm_state (pcm);
262 case SND_PCM_STATE_PREPARED:
263 snd_pcm_mmap_commit (pcm, offset, nframes);
266 case SND_PCM_STATE_RUNNING:
267 snd_pcm_mmap_commit (pcm, offset, nframes);
274 void *S_LockBuffer(void)
279 void S_UnlockBuffer(void)