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 int snd_inited;
35 static snd_pcm_uframes_t buffer_size;
37 static const char *pcmname = NULL;
38 static snd_pcm_t *pcm;
40 qboolean SNDDMA_Init (void)
46 snd_pcm_hw_params_t *hw;
47 snd_pcm_sw_params_t *sw;
48 snd_pcm_uframes_t frag_size;
50 snd_pcm_hw_params_alloca (&hw);
51 snd_pcm_sw_params_alloca (&sw);
53 // COMMANDLINEOPTION: Linux ALSA Sound: -sndbits <number> sets sound precision to 8 or 16 bit (email me if you want others added)
55 if ((i=COM_CheckParm("-sndbits")) != 0)
57 j = atoi(com_argv[i+1]);
58 if (j == 16 || j == 8)
61 Con_Printf("Error: invalid sample bits: %d\n", j);
64 // COMMANDLINEOPTION: Linux ALSA Sound: -sndspeed <hz> chooses 44100 hz, 22100 hz, or 11025 hz sound output rate
66 if ((i=COM_CheckParm("-sndspeed")) != 0)
68 j = atoi(com_argv[i+1]);
72 Con_Printf("Error: invalid sample rate: %d\n", rate);
75 for (channels = 8;channels >= 1;channels--)
77 if ((channels & 1) && channels != 1)
79 // COMMANDLINEOPTION: Linux ALSA Sound: -sndmono sets sound output to mono
80 if ((i=COM_CheckParm("-sndmono")) != 0)
83 // COMMANDLINEOPTION: Linux ALSA Sound: -sndstereo sets sound output to stereo
84 if ((i=COM_CheckParm("-sndstereo")) != 0)
88 // COMMANDLINEOPTION: Linux ALSA Sound: -sndpcm <devicename> selects which pcm device to us, default is "default"
90 pcmname = "surround71";
91 else if (channels == 6)
92 pcmname = "surround51";
93 else if (channels == 4)
94 pcmname = "surround40";
97 if ((i=COM_CheckParm("-sndpcm"))!=0)
98 pcmname = com_argv[i+1];
100 Con_Printf ("ALSA: Trying PCM %s.\n", pcmname);
102 err = snd_pcm_open (&pcm, pcmname, SND_PCM_STREAM_PLAYBACK, SND_PCM_NONBLOCK);
105 Con_Printf ("Error: audio open error: %s\n", snd_strerror (err));
109 err = snd_pcm_hw_params_any (pcm, hw);
112 Con_Printf ("ALSA: error setting hw_params_any. %s\n", snd_strerror (err));
117 err = snd_pcm_hw_params_set_access (pcm, hw, SND_PCM_ACCESS_MMAP_INTERLEAVED);
120 Con_Printf ("ALSA: Failure to set interleaved mmap PCM access. %s\n", snd_strerror (err));
125 err = snd_pcm_hw_params_set_format (pcm, hw, width == 1 ? SND_PCM_FORMAT_U8 : SND_PCM_FORMAT_S16);
128 Con_Printf ("ALSA: desired bits %i not supported by driver. %s\n", width * 8, snd_strerror (err));
133 err = snd_pcm_hw_params_set_channels (pcm, hw, channels);
136 Con_Printf ("ALSA: no usable channels. %s\n", snd_strerror (err));
141 err = snd_pcm_hw_params_set_rate_near (pcm, hw, &rate, 0);
144 Con_Printf ("ALSA: desired rate %i not supported by driver. %s\n", rate, snd_strerror (err));
149 frag_size = 64 * width * rate / 11025;
150 err = snd_pcm_hw_params_set_period_size_near (pcm, hw, &frag_size, 0);
153 Con_Printf ("ALSA: unable to set period size near %i. %s\n", (int) frag_size, snd_strerror (err));
157 err = snd_pcm_hw_params (pcm, hw);
160 Con_Printf ("ALSA: unable to install hw params: %s\n", snd_strerror (err));
164 err = snd_pcm_sw_params_current (pcm, sw);
167 Con_Printf ("ALSA: unable to determine current sw params. %s\n", snd_strerror (err));
171 err = snd_pcm_sw_params_set_start_threshold (pcm, sw, ~0U);
174 Con_Printf ("ALSA: unable to set playback threshold. %s\n", snd_strerror (err));
178 err = snd_pcm_sw_params_set_stop_threshold (pcm, sw, ~0U);
181 Con_Printf ("ALSA: unable to set playback stop threshold. %s\n", snd_strerror (err));
185 err = snd_pcm_sw_params (pcm, sw);
188 Con_Printf ("ALSA: unable to install sw params. %s\n", snd_strerror (err));
193 err = snd_pcm_hw_params_get_buffer_size (hw, &buffer_size);
196 Con_Printf ("ALSA: unable to get buffer size. %s\n", snd_strerror (err));
201 memset( (void*) shm, 0, sizeof(*shm) );
202 shm->format.channels = channels;
203 shm->format.width = width;
204 shm->format.speed = rate;
206 shm->sampleframes = buffer_size;
207 shm->samples = shm->sampleframes * shm->format.channels;
208 SNDDMA_GetDMAPos (); // sets shm->buffer
216 int SNDDMA_GetDMAPos (void)
218 const snd_pcm_channel_area_t *areas;
219 snd_pcm_uframes_t offset;
220 snd_pcm_uframes_t nframes = shm->sampleframes;
225 snd_pcm_avail_update (pcm);
226 snd_pcm_mmap_begin (pcm, &areas, &offset, &nframes);
227 offset *= shm->format.channels;
228 nframes *= shm->format.channels;
229 shm->samplepos = offset;
230 shm->buffer = (unsigned char *)areas->addr;
231 return shm->samplepos;
234 void SNDDMA_Shutdown (void)
245 Send sound to device if buffer isn't really the dma buffer
247 void SNDDMA_Submit (void)
250 int count = paintedtime - soundtime;
251 const snd_pcm_channel_area_t *areas;
252 snd_pcm_uframes_t nframes;
253 snd_pcm_uframes_t offset;
255 nframes = count / shm->format.channels;
257 snd_pcm_avail_update (pcm);
258 snd_pcm_mmap_begin (pcm, &areas, &offset, &nframes);
260 state = snd_pcm_state (pcm);
263 case SND_PCM_STATE_PREPARED:
264 snd_pcm_mmap_commit (pcm, offset, nframes);
267 case SND_PCM_STATE_RUNNING:
268 snd_pcm_mmap_commit (pcm, offset, nframes);
275 void *S_LockBuffer(void)
280 void S_UnlockBuffer(void)