Skip to content

Latest commit

 

History

History
999 lines (861 loc) · 31.9 KB

SDL_alsa_audio.c

File metadata and controls

999 lines (861 loc) · 31.9 KB
 
1
2
/*
Simple DirectMedia Layer
Jan 5, 2019
Jan 5, 2019
3
Copyright (C) 1997-2019 Sam Lantinga <slouken@libsdl.org>
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
*/
#include "../../SDL_internal.h"
#if SDL_AUDIO_DRIVER_ALSA
Aug 7, 2018
Aug 7, 2018
25
26
27
28
#ifndef SDL_ALSA_NON_BLOCKING
#define SDL_ALSA_NON_BLOCKING 0
#endif
29
30
31
32
33
34
/* Allow access to a raw mixing buffer */
#include <sys/types.h>
#include <signal.h> /* For kill() */
#include <string.h>
Aug 28, 2016
Aug 28, 2016
35
#include "SDL_assert.h"
36
37
38
39
40
41
42
43
44
45
46
47
#include "SDL_timer.h"
#include "SDL_audio.h"
#include "../SDL_audio_c.h"
#include "SDL_alsa_audio.h"
#ifdef SDL_AUDIO_DRIVER_ALSA_DYNAMIC
#include "SDL_loadso.h"
#endif
static int (*ALSA_snd_pcm_open)
(snd_pcm_t **, const char *, snd_pcm_stream_t, int);
static int (*ALSA_snd_pcm_close) (snd_pcm_t * pcm);
Aug 2, 2016
Aug 2, 2016
48
static snd_pcm_sframes_t (*ALSA_snd_pcm_writei)
49
(snd_pcm_t *, const void *, snd_pcm_uframes_t);
Aug 2, 2016
Aug 2, 2016
50
51
static snd_pcm_sframes_t (*ALSA_snd_pcm_readi)
(snd_pcm_t *, void *, snd_pcm_uframes_t);
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
static int (*ALSA_snd_pcm_recover) (snd_pcm_t *, int, int);
static int (*ALSA_snd_pcm_prepare) (snd_pcm_t *);
static int (*ALSA_snd_pcm_drain) (snd_pcm_t *);
static const char *(*ALSA_snd_strerror) (int);
static size_t(*ALSA_snd_pcm_hw_params_sizeof) (void);
static size_t(*ALSA_snd_pcm_sw_params_sizeof) (void);
static void (*ALSA_snd_pcm_hw_params_copy)
(snd_pcm_hw_params_t *, const snd_pcm_hw_params_t *);
static int (*ALSA_snd_pcm_hw_params_any) (snd_pcm_t *, snd_pcm_hw_params_t *);
static int (*ALSA_snd_pcm_hw_params_set_access)
(snd_pcm_t *, snd_pcm_hw_params_t *, snd_pcm_access_t);
static int (*ALSA_snd_pcm_hw_params_set_format)
(snd_pcm_t *, snd_pcm_hw_params_t *, snd_pcm_format_t);
static int (*ALSA_snd_pcm_hw_params_set_channels)
(snd_pcm_t *, snd_pcm_hw_params_t *, unsigned int);
static int (*ALSA_snd_pcm_hw_params_get_channels)
(const snd_pcm_hw_params_t *, unsigned int *);
static int (*ALSA_snd_pcm_hw_params_set_rate_near)
(snd_pcm_t *, snd_pcm_hw_params_t *, unsigned int *, int *);
static int (*ALSA_snd_pcm_hw_params_set_period_size_near)
(snd_pcm_t *, snd_pcm_hw_params_t *, snd_pcm_uframes_t *, int *);
static int (*ALSA_snd_pcm_hw_params_get_period_size)
(const snd_pcm_hw_params_t *, snd_pcm_uframes_t *, int *);
Jul 7, 2019
Jul 7, 2019
75
76
77
static int (*ALSA_snd_pcm_hw_params_set_periods_min)
(snd_pcm_t *, snd_pcm_hw_params_t *, unsigned int *, int *);
static int (*ALSA_snd_pcm_hw_params_set_periods_first)
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
(snd_pcm_t *, snd_pcm_hw_params_t *, unsigned int *, int *);
static int (*ALSA_snd_pcm_hw_params_get_periods)
(const snd_pcm_hw_params_t *, unsigned int *, int *);
static int (*ALSA_snd_pcm_hw_params_set_buffer_size_near)
(snd_pcm_t *pcm, snd_pcm_hw_params_t *, snd_pcm_uframes_t *);
static int (*ALSA_snd_pcm_hw_params_get_buffer_size)
(const snd_pcm_hw_params_t *, snd_pcm_uframes_t *);
static int (*ALSA_snd_pcm_hw_params) (snd_pcm_t *, snd_pcm_hw_params_t *);
static int (*ALSA_snd_pcm_sw_params_current) (snd_pcm_t *,
snd_pcm_sw_params_t *);
static int (*ALSA_snd_pcm_sw_params_set_start_threshold)
(snd_pcm_t *, snd_pcm_sw_params_t *, snd_pcm_uframes_t);
static int (*ALSA_snd_pcm_sw_params) (snd_pcm_t *, snd_pcm_sw_params_t *);
static int (*ALSA_snd_pcm_nonblock) (snd_pcm_t *, int);
static int (*ALSA_snd_pcm_wait)(snd_pcm_t *, int);
static int (*ALSA_snd_pcm_sw_params_set_avail_min)
(snd_pcm_t *, snd_pcm_sw_params_t *, snd_pcm_uframes_t);
Aug 2, 2016
Aug 2, 2016
95
static int (*ALSA_snd_pcm_reset)(snd_pcm_t *);
Mar 6, 2016
Mar 6, 2016
96
97
98
static int (*ALSA_snd_device_name_hint) (int, const char *, void ***);
static char* (*ALSA_snd_device_name_get_hint) (const void *, const char *);
static int (*ALSA_snd_device_name_free_hint) (void **);
Aug 7, 2018
Aug 7, 2018
99
static snd_pcm_sframes_t (*ALSA_snd_pcm_avail)(snd_pcm_t *);
Oct 29, 2016
Oct 29, 2016
100
#ifdef SND_CHMAP_API_VERSION
Oct 28, 2016
Oct 28, 2016
101
102
static snd_pcm_chmap_t* (*ALSA_snd_pcm_get_chmap) (snd_pcm_t *);
static int (*ALSA_snd_pcm_chmap_print) (const snd_pcm_chmap_t *map, size_t maxlen, char *buf);
Oct 29, 2016
Oct 29, 2016
103
#endif
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
#ifdef SDL_AUDIO_DRIVER_ALSA_DYNAMIC
#define snd_pcm_hw_params_sizeof ALSA_snd_pcm_hw_params_sizeof
#define snd_pcm_sw_params_sizeof ALSA_snd_pcm_sw_params_sizeof
static const char *alsa_library = SDL_AUDIO_DRIVER_ALSA_DYNAMIC;
static void *alsa_handle = NULL;
static int
load_alsa_sym(const char *fn, void **addr)
{
*addr = SDL_LoadFunction(alsa_handle, fn);
if (*addr == NULL) {
/* Don't call SDL_SetError(): SDL_LoadFunction already did. */
return 0;
}
return 1;
}
/* cast funcs to char* first, to please GCC's strict aliasing rules. */
#define SDL_ALSA_SYM(x) \
if (!load_alsa_sym(#x, (void **) (char *) &ALSA_##x)) return -1
#else
#define SDL_ALSA_SYM(x) ALSA_##x = x
#endif
static int
load_alsa_syms(void)
{
SDL_ALSA_SYM(snd_pcm_open);
SDL_ALSA_SYM(snd_pcm_close);
SDL_ALSA_SYM(snd_pcm_writei);
Aug 2, 2016
Aug 2, 2016
137
SDL_ALSA_SYM(snd_pcm_readi);
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
SDL_ALSA_SYM(snd_pcm_recover);
SDL_ALSA_SYM(snd_pcm_prepare);
SDL_ALSA_SYM(snd_pcm_drain);
SDL_ALSA_SYM(snd_strerror);
SDL_ALSA_SYM(snd_pcm_hw_params_sizeof);
SDL_ALSA_SYM(snd_pcm_sw_params_sizeof);
SDL_ALSA_SYM(snd_pcm_hw_params_copy);
SDL_ALSA_SYM(snd_pcm_hw_params_any);
SDL_ALSA_SYM(snd_pcm_hw_params_set_access);
SDL_ALSA_SYM(snd_pcm_hw_params_set_format);
SDL_ALSA_SYM(snd_pcm_hw_params_set_channels);
SDL_ALSA_SYM(snd_pcm_hw_params_get_channels);
SDL_ALSA_SYM(snd_pcm_hw_params_set_rate_near);
SDL_ALSA_SYM(snd_pcm_hw_params_set_period_size_near);
SDL_ALSA_SYM(snd_pcm_hw_params_get_period_size);
Jul 7, 2019
Jul 7, 2019
153
154
SDL_ALSA_SYM(snd_pcm_hw_params_set_periods_min);
SDL_ALSA_SYM(snd_pcm_hw_params_set_periods_first);
155
156
157
158
159
160
161
162
163
164
SDL_ALSA_SYM(snd_pcm_hw_params_get_periods);
SDL_ALSA_SYM(snd_pcm_hw_params_set_buffer_size_near);
SDL_ALSA_SYM(snd_pcm_hw_params_get_buffer_size);
SDL_ALSA_SYM(snd_pcm_hw_params);
SDL_ALSA_SYM(snd_pcm_sw_params_current);
SDL_ALSA_SYM(snd_pcm_sw_params_set_start_threshold);
SDL_ALSA_SYM(snd_pcm_sw_params);
SDL_ALSA_SYM(snd_pcm_nonblock);
SDL_ALSA_SYM(snd_pcm_wait);
SDL_ALSA_SYM(snd_pcm_sw_params_set_avail_min);
Aug 2, 2016
Aug 2, 2016
165
SDL_ALSA_SYM(snd_pcm_reset);
Mar 6, 2016
Mar 6, 2016
166
167
168
SDL_ALSA_SYM(snd_device_name_hint);
SDL_ALSA_SYM(snd_device_name_get_hint);
SDL_ALSA_SYM(snd_device_name_free_hint);
Aug 7, 2018
Aug 7, 2018
169
SDL_ALSA_SYM(snd_pcm_avail);
Oct 29, 2016
Oct 29, 2016
170
#ifdef SND_CHMAP_API_VERSION
Oct 28, 2016
Oct 28, 2016
171
172
SDL_ALSA_SYM(snd_pcm_get_chmap);
SDL_ALSA_SYM(snd_pcm_chmap_print);
Oct 29, 2016
Oct 29, 2016
173
#endif
Mar 6, 2016
Mar 6, 2016
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
return 0;
}
#undef SDL_ALSA_SYM
#ifdef SDL_AUDIO_DRIVER_ALSA_DYNAMIC
static void
UnloadALSALibrary(void)
{
if (alsa_handle != NULL) {
SDL_UnloadObject(alsa_handle);
alsa_handle = NULL;
}
}
static int
LoadALSALibrary(void)
{
int retval = 0;
if (alsa_handle == NULL) {
alsa_handle = SDL_LoadObject(alsa_library);
if (alsa_handle == NULL) {
retval = -1;
/* Don't call SDL_SetError(): SDL_LoadObject already did. */
} else {
retval = load_alsa_syms();
if (retval < 0) {
UnloadALSALibrary();
}
}
}
return retval;
}
#else
static void
UnloadALSALibrary(void)
{
}
static int
LoadALSALibrary(void)
{
load_alsa_syms();
return 0;
}
#endif /* SDL_AUDIO_DRIVER_ALSA_DYNAMIC */
static const char *
Mar 6, 2016
Mar 6, 2016
227
get_audio_device(void *handle, const int channels)
228
229
230
{
const char *device;
Mar 6, 2016
Mar 6, 2016
231
232
233
234
235
if (handle != NULL) {
return (const char *) handle;
}
/* !!! FIXME: we also check "SDL_AUDIO_DEVICE_NAME" at the higher level. */
236
device = SDL_getenv("AUDIODEV"); /* Is there a standard variable name? */
Mar 6, 2016
Mar 6, 2016
237
238
239
240
241
242
243
244
if (device != NULL) {
return device;
}
if (channels == 6) {
return "plug:surround51";
} else if (channels == 4) {
return "plug:surround40";
Mar 6, 2016
Mar 6, 2016
246
247
return "default";
248
249
250
251
252
253
254
}
/* This function waits until it is possible to write a full sound buffer */
static void
ALSA_WaitDevice(_THIS)
{
Aug 7, 2018
Aug 7, 2018
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
#if SDL_ALSA_NON_BLOCKING
const snd_pcm_sframes_t needed = (snd_pcm_sframes_t) this->spec.samples;
while (SDL_AtomicGet(&this->enabled)) {
const snd_pcm_sframes_t rc = ALSA_snd_pcm_avail(this->hidden->pcm_handle);
if ((rc < 0) && (rc != -EAGAIN)) {
/* Hmm, not much we can do - abort */
fprintf(stderr, "ALSA snd_pcm_avail failed (unrecoverable): %s\n",
ALSA_snd_strerror(rc));
SDL_OpenedAudioDeviceDisconnected(this);
return;
} else if (rc < needed) {
const Uint32 delay = ((needed - (SDL_max(rc, 0))) * 1000) / this->spec.freq;
SDL_Delay(SDL_max(delay, 10));
} else {
break; /* ready to go! */
}
}
#endif
273
274
275
276
277
278
279
280
281
}
/* !!! FIXME: is there a channel swizzler in alsalib instead? */
/*
* http://bugzilla.libsdl.org/show_bug.cgi?id=110
* "For Linux ALSA, this is FL-FR-RL-RR-C-LFE
* and for Windows DirectX [and CoreAudio], this is FL-FR-C-LFE-RL-RR"
*/
Aug 2, 2016
Aug 2, 2016
282
283
#define SWIZ6(T, buf, numframes) \
T *ptr = (T *) buf; \
Aug 2, 2016
Aug 2, 2016
285
for (i = 0; i < numframes; i++, ptr += 6) { \
286
287
288
289
290
T tmp; \
tmp = ptr[2]; ptr[2] = ptr[4]; ptr[4] = tmp; \
tmp = ptr[3]; ptr[3] = ptr[5]; ptr[5] = tmp; \
}
Oct 28, 2016
Oct 28, 2016
291
static void
Aug 2, 2016
Aug 2, 2016
292
swizzle_alsa_channels_6_64bit(void *buffer, Uint32 bufferlen)
Aug 2, 2016
Aug 2, 2016
294
SWIZ6(Uint64, buffer, bufferlen);
Oct 28, 2016
Oct 28, 2016
297
static void
Aug 2, 2016
Aug 2, 2016
298
swizzle_alsa_channels_6_32bit(void *buffer, Uint32 bufferlen)
Aug 2, 2016
Aug 2, 2016
300
SWIZ6(Uint32, buffer, bufferlen);
Oct 28, 2016
Oct 28, 2016
303
static void
Aug 2, 2016
Aug 2, 2016
304
swizzle_alsa_channels_6_16bit(void *buffer, Uint32 bufferlen)
Aug 2, 2016
Aug 2, 2016
306
SWIZ6(Uint16, buffer, bufferlen);
Oct 28, 2016
Oct 28, 2016
309
static void
Aug 2, 2016
Aug 2, 2016
310
swizzle_alsa_channels_6_8bit(void *buffer, Uint32 bufferlen)
Aug 2, 2016
Aug 2, 2016
312
SWIZ6(Uint8, buffer, bufferlen);
313
314
315
316
317
318
319
320
321
}
#undef SWIZ6
/*
* Called right before feeding this->hidden->mixbuf to the hardware. Swizzle
* channels from Windows/Mac order to the format alsalib will want.
*/
Oct 28, 2016
Oct 28, 2016
322
static void
Aug 2, 2016
Aug 2, 2016
323
swizzle_alsa_channels(_THIS, void *buffer, Uint32 bufferlen)
324
325
{
if (this->spec.channels == 6) {
Aug 2, 2016
Aug 2, 2016
326
327
328
329
330
331
332
switch (SDL_AUDIO_BITSIZE(this->spec.format)) {
case 8: swizzle_alsa_channels_6_8bit(buffer, bufferlen); break;
case 16: swizzle_alsa_channels_6_16bit(buffer, bufferlen); break;
case 32: swizzle_alsa_channels_6_32bit(buffer, bufferlen); break;
case 64: swizzle_alsa_channels_6_64bit(buffer, bufferlen); break;
default: SDL_assert(!"unhandled bitsize"); break;
}
333
334
335
336
337
}
/* !!! FIXME: update this for 7.1 if needed, later. */
}
Nov 5, 2016
Nov 5, 2016
338
#ifdef SND_CHMAP_API_VERSION
Oct 28, 2016
Oct 28, 2016
339
340
341
342
343
344
/* Some devices have the right channel map, no swizzling necessary */
static void
no_swizzle(_THIS, void *buffer, Uint32 bufferlen)
{
return;
}
Nov 5, 2016
Nov 5, 2016
345
#endif /* SND_CHMAP_API_VERSION */
Oct 28, 2016
Oct 28, 2016
346
347
348
349
350
351
static void
ALSA_PlayDevice(_THIS)
{
const Uint8 *sample_buf = (const Uint8 *) this->hidden->mixbuf;
Aug 2, 2016
Aug 2, 2016
352
const int frame_size = (((int) SDL_AUDIO_BITSIZE(this->spec.format)) / 8) *
353
354
355
this->spec.channels;
snd_pcm_uframes_t frames_left = ((snd_pcm_uframes_t) this->spec.samples);
Oct 28, 2016
Oct 28, 2016
356
this->hidden->swizzle_func(this, this->hidden->mixbuf, frames_left);
Aug 2, 2016
Aug 2, 2016
358
while ( frames_left > 0 && SDL_AtomicGet(&this->enabled) ) {
Sep 10, 2017
Sep 10, 2017
359
int status = ALSA_snd_pcm_writei(this->hidden->pcm_handle,
Aug 2, 2016
Aug 2, 2016
360
sample_buf, frames_left);
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
if (status < 0) {
if (status == -EAGAIN) {
/* Apparently snd_pcm_recover() doesn't handle this case -
does it assume snd_pcm_wait() above? */
SDL_Delay(1);
continue;
}
status = ALSA_snd_pcm_recover(this->hidden->pcm_handle, status, 0);
if (status < 0) {
/* Hmm, not much we can do - abort */
fprintf(stderr, "ALSA write failed (unrecoverable): %s\n",
ALSA_snd_strerror(status));
SDL_OpenedAudioDeviceDisconnected(this);
return;
}
continue;
}
Mar 14, 2017
Mar 14, 2017
379
380
381
382
383
384
385
else if (status == 0) {
/* No frames were written (no available space in pcm device).
Allow other threads to catch up. */
Uint32 delay = (frames_left / 2 * 1000) / this->spec.freq;
SDL_Delay(delay);
}
386
387
388
389
390
391
392
393
394
395
396
sample_buf += status * frame_size;
frames_left -= status;
}
}
static Uint8 *
ALSA_GetDeviceBuf(_THIS)
{
return (this->hidden->mixbuf);
}
Aug 2, 2016
Aug 2, 2016
397
398
399
400
401
402
403
404
static int
ALSA_CaptureFromDevice(_THIS, void *buffer, int buflen)
{
Uint8 *sample_buf = (Uint8 *) buffer;
const int frame_size = (((int) SDL_AUDIO_BITSIZE(this->spec.format)) / 8) *
this->spec.channels;
const int total_frames = buflen / frame_size;
snd_pcm_uframes_t frames_left = total_frames;
Mar 14, 2017
Mar 14, 2017
405
snd_pcm_uframes_t wait_time = frame_size / 2;
Aug 2, 2016
Aug 2, 2016
406
407
408
409
SDL_assert((buflen % frame_size) == 0);
while ( frames_left > 0 && SDL_AtomicGet(&this->enabled) ) {
Mar 14, 2017
Mar 14, 2017
410
411
412
int status;
status = ALSA_snd_pcm_readi(this->hidden->pcm_handle,
Aug 2, 2016
Aug 2, 2016
413
414
sample_buf, frames_left);
Mar 14, 2017
Mar 14, 2017
415
416
417
418
419
if (status == -EAGAIN) {
ALSA_snd_pcm_wait(this->hidden->pcm_handle, wait_time);
status = 0;
}
else if (status < 0) {
Aug 2, 2016
Aug 2, 2016
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
/*printf("ALSA: capture error %d\n", status);*/
status = ALSA_snd_pcm_recover(this->hidden->pcm_handle, status, 0);
if (status < 0) {
/* Hmm, not much we can do - abort */
fprintf(stderr, "ALSA read failed (unrecoverable): %s\n",
ALSA_snd_strerror(status));
return -1;
}
continue;
}
/*printf("ALSA: captured %d bytes\n", status * frame_size);*/
sample_buf += status * frame_size;
frames_left -= status;
}
Oct 28, 2016
Oct 28, 2016
436
this->hidden->swizzle_func(this, buffer, total_frames - frames_left);
Aug 2, 2016
Aug 2, 2016
437
438
439
440
441
442
443
444
445
446
return (total_frames - frames_left) * frame_size;
}
static void
ALSA_FlushCapture(_THIS)
{
ALSA_snd_pcm_reset(this->hidden->pcm_handle);
}
447
448
449
static void
ALSA_CloseDevice(_THIS)
{
Aug 5, 2016
Aug 5, 2016
450
if (this->hidden->pcm_handle) {
Sep 24, 2018
Sep 24, 2018
451
/* Wait for the submitted audio to drain
Oct 8, 2016
Oct 8, 2016
452
453
454
455
456
ALSA_snd_pcm_drop() can hang, so don't use that.
*/
Uint32 delay = ((this->spec.samples * 1000) / this->spec.freq) * 2;
SDL_Delay(delay);
Aug 5, 2016
Aug 5, 2016
457
ALSA_snd_pcm_close(this->hidden->pcm_handle);
Aug 5, 2016
Aug 5, 2016
459
SDL_free(this->hidden->mixbuf);
Aug 5, 2016
Aug 5, 2016
460
SDL_free(this->hidden);
May 5, 2018
May 5, 2018
464
ALSA_set_buffer_size(_THIS, snd_pcm_hw_params_t *params)
May 5, 2018
May 5, 2018
467
468
snd_pcm_hw_params_t *hwparams;
snd_pcm_uframes_t persize;
Jul 7, 2019
Jul 7, 2019
469
unsigned int periods;
May 5, 2018
May 5, 2018
471
472
473
474
/* Copy the hardware parameters for this setup */
snd_pcm_hw_params_alloca(&hwparams);
ALSA_snd_pcm_hw_params_copy(hwparams, params);
Jul 7, 2019
Jul 7, 2019
475
/* Attempt to match the period size to the requested buffer size */
May 5, 2018
May 5, 2018
476
477
478
persize = this->spec.samples;
status = ALSA_snd_pcm_hw_params_set_period_size_near(
this->hidden->pcm_handle, hwparams, &persize, NULL);
479
480
481
482
if ( status < 0 ) {
return(-1);
}
Jul 7, 2019
Jul 7, 2019
483
484
485
486
487
488
489
490
491
492
/* Need to at least double buffer */
periods = 2;
status = ALSA_snd_pcm_hw_params_set_periods_min(
this->hidden->pcm_handle, hwparams, &periods, NULL);
if ( status < 0 ) {
return(-1);
}
status = ALSA_snd_pcm_hw_params_set_periods_first(
this->hidden->pcm_handle, hwparams, &periods, NULL);
493
494
495
if ( status < 0 ) {
return(-1);
}
May 5, 2018
May 5, 2018
496
497
498
499
/* "set" the hardware with the desired parameters */
status = ALSA_snd_pcm_hw_params(this->hidden->pcm_handle, hwparams);
if ( status < 0 ) {
500
501
502
return(-1);
}
May 5, 2018
May 5, 2018
503
this->spec.samples = persize;
504
505
506
/* This is useful for debugging */
if ( SDL_getenv("SDL_AUDIO_ALSA_DEBUG") ) {
Jul 7, 2019
Jul 7, 2019
507
snd_pcm_uframes_t bufsize;
Jul 7, 2019
Jul 7, 2019
509
ALSA_snd_pcm_hw_params_get_buffer_size(hwparams, &bufsize);
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
fprintf(stderr,
"ALSA: period size = %ld, periods = %u, buffer size = %lu\n",
persize, periods, bufsize);
}
return(0);
}
static int
ALSA_OpenDevice(_THIS, void *handle, const char *devname, int iscapture)
{
int status = 0;
snd_pcm_t *pcm_handle = NULL;
snd_pcm_hw_params_t *hwparams = NULL;
snd_pcm_sw_params_t *swparams = NULL;
snd_pcm_format_t format = 0;
SDL_AudioFormat test_format = 0;
unsigned int rate = 0;
unsigned int channels = 0;
Oct 29, 2016
Oct 29, 2016
530
#ifdef SND_CHMAP_API_VERSION
Oct 28, 2016
Oct 28, 2016
531
532
snd_pcm_chmap_t *chmap;
char chmap_str[64];
Oct 29, 2016
Oct 29, 2016
533
#endif
534
535
536
537
538
539
540
/* Initialize all variables that we clean on shutdown */
this->hidden = (struct SDL_PrivateAudioData *)
SDL_malloc((sizeof *this->hidden));
if (this->hidden == NULL) {
return SDL_OutOfMemory();
}
Aug 5, 2016
Aug 5, 2016
541
SDL_zerop(this->hidden);
542
543
544
545
/* Open the audio device */
/* Name of device should depend on # channels in spec */
status = ALSA_snd_pcm_open(&pcm_handle,
Aug 2, 2016
Aug 2, 2016
546
547
548
get_audio_device(handle, this->spec.channels),
iscapture ? SND_PCM_STREAM_CAPTURE : SND_PCM_STREAM_PLAYBACK,
SND_PCM_NONBLOCK);
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
if (status < 0) {
return SDL_SetError("ALSA: Couldn't open audio device: %s",
ALSA_snd_strerror(status));
}
this->hidden->pcm_handle = pcm_handle;
/* Figure out what the hardware is capable of */
snd_pcm_hw_params_alloca(&hwparams);
status = ALSA_snd_pcm_hw_params_any(pcm_handle, hwparams);
if (status < 0) {
return SDL_SetError("ALSA: Couldn't get hardware config: %s",
ALSA_snd_strerror(status));
}
/* SDL only uses interleaved sample output */
status = ALSA_snd_pcm_hw_params_set_access(pcm_handle, hwparams,
SND_PCM_ACCESS_RW_INTERLEAVED);
if (status < 0) {
return SDL_SetError("ALSA: Couldn't set interleaved access: %s",
ALSA_snd_strerror(status));
}
/* Try for a closest match on audio format */
status = -1;
for (test_format = SDL_FirstAudioFormat(this->spec.format);
test_format && (status < 0);) {
status = 0; /* if we can't support a format, it'll become -1. */
switch (test_format) {
case AUDIO_U8:
format = SND_PCM_FORMAT_U8;
break;
case AUDIO_S8:
format = SND_PCM_FORMAT_S8;
break;
case AUDIO_S16LSB:
format = SND_PCM_FORMAT_S16_LE;
break;
case AUDIO_S16MSB:
format = SND_PCM_FORMAT_S16_BE;
break;
case AUDIO_U16LSB:
format = SND_PCM_FORMAT_U16_LE;
break;
case AUDIO_U16MSB:
format = SND_PCM_FORMAT_U16_BE;
break;
case AUDIO_S32LSB:
format = SND_PCM_FORMAT_S32_LE;
break;
case AUDIO_S32MSB:
format = SND_PCM_FORMAT_S32_BE;
break;
case AUDIO_F32LSB:
format = SND_PCM_FORMAT_FLOAT_LE;
break;
case AUDIO_F32MSB:
format = SND_PCM_FORMAT_FLOAT_BE;
break;
default:
status = -1;
break;
}
if (status >= 0) {
status = ALSA_snd_pcm_hw_params_set_format(pcm_handle,
hwparams, format);
}
if (status < 0) {
test_format = SDL_NextAudioFormat();
}
}
if (status < 0) {
return SDL_SetError("ALSA: Couldn't find any hardware audio formats");
}
this->spec.format = test_format;
Oct 28, 2016
Oct 28, 2016
626
627
628
629
/* Validate number of channels and determine if swizzling is necessary
* Assume original swizzling, until proven otherwise.
*/
this->hidden->swizzle_func = swizzle_alsa_channels;
Oct 29, 2016
Oct 29, 2016
630
#ifdef SND_CHMAP_API_VERSION
Oct 28, 2016
Oct 28, 2016
631
632
633
634
635
636
637
638
639
chmap = ALSA_snd_pcm_get_chmap(pcm_handle);
if (chmap) {
ALSA_snd_pcm_chmap_print(chmap, sizeof(chmap_str), chmap_str);
if (SDL_strcmp("FL FR FC LFE RL RR", chmap_str) == 0 ||
SDL_strcmp("FL FR FC LFE SL SR", chmap_str) == 0) {
this->hidden->swizzle_func = no_swizzle;
}
free(chmap);
}
Oct 29, 2016
Oct 29, 2016
640
#endif /* SND_CHMAP_API_VERSION */
Oct 28, 2016
Oct 28, 2016
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
/* Set the number of channels */
status = ALSA_snd_pcm_hw_params_set_channels(pcm_handle, hwparams,
this->spec.channels);
channels = this->spec.channels;
if (status < 0) {
status = ALSA_snd_pcm_hw_params_get_channels(hwparams, &channels);
if (status < 0) {
return SDL_SetError("ALSA: Couldn't set audio channels");
}
this->spec.channels = channels;
}
/* Set the audio rate */
rate = this->spec.freq;
status = ALSA_snd_pcm_hw_params_set_rate_near(pcm_handle, hwparams,
&rate, NULL);
if (status < 0) {
return SDL_SetError("ALSA: Couldn't set audio frequency: %s",
ALSA_snd_strerror(status));
}
this->spec.freq = rate;
/* Set the buffer size, in samples */
May 5, 2018
May 5, 2018
665
666
667
status = ALSA_set_buffer_size(this, hwparams);
if (status < 0) {
return SDL_SetError("Couldn't set hardware audio parameters: %s", ALSA_snd_strerror(status));
May 5, 2018
May 5, 2018
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
/* Set the software parameters */
snd_pcm_sw_params_alloca(&swparams);
status = ALSA_snd_pcm_sw_params_current(pcm_handle, swparams);
if (status < 0) {
return SDL_SetError("ALSA: Couldn't get software config: %s",
ALSA_snd_strerror(status));
}
status = ALSA_snd_pcm_sw_params_set_avail_min(pcm_handle, swparams, this->spec.samples);
if (status < 0) {
return SDL_SetError("Couldn't set minimum available samples: %s",
ALSA_snd_strerror(status));
}
status =
ALSA_snd_pcm_sw_params_set_start_threshold(pcm_handle, swparams, 1);
if (status < 0) {
return SDL_SetError("ALSA: Couldn't set start threshold: %s",
ALSA_snd_strerror(status));
}
status = ALSA_snd_pcm_sw_params(pcm_handle, swparams);
if (status < 0) {
return SDL_SetError("Couldn't set software audio parameters: %s",
ALSA_snd_strerror(status));
}
/* Calculate the final parameters for this audio specification */
SDL_CalculateAudioSpec(&this->spec);
/* Allocate mixing buffer */
Aug 3, 2016
Aug 3, 2016
698
699
if (!iscapture) {
this->hidden->mixlen = this->spec.size;
Aug 5, 2016
Aug 5, 2016
700
this->hidden->mixbuf = (Uint8 *) SDL_malloc(this->hidden->mixlen);
Aug 3, 2016
Aug 3, 2016
701
702
703
704
if (this->hidden->mixbuf == NULL) {
return SDL_OutOfMemory();
}
SDL_memset(this->hidden->mixbuf, this->spec.silence, this->hidden->mixlen);
Aug 7, 2018
Aug 7, 2018
707
#if !SDL_ALSA_NON_BLOCKING
Mar 14, 2017
Mar 14, 2017
708
709
710
if (!iscapture) {
ALSA_snd_pcm_nonblock(pcm_handle, 0);
}
Aug 7, 2018
Aug 7, 2018
711
#endif
712
713
714
715
716
/* We're ready to rock and roll. :-) */
return 0;
}
Aug 28, 2016
Aug 28, 2016
717
typedef struct ALSA_Device
Aug 28, 2016
Aug 28, 2016
719
720
721
722
char *name;
SDL_bool iscapture;
struct ALSA_Device *next;
} ALSA_Device;
Mar 6, 2016
Mar 6, 2016
724
static void
Aug 28, 2016
Aug 28, 2016
725
add_device(const int iscapture, const char *name, void *hint, ALSA_Device **pSeen)
Mar 6, 2016
Mar 6, 2016
726
{
Aug 28, 2016
Aug 28, 2016
727
ALSA_Device *dev = SDL_malloc(sizeof (ALSA_Device));
Mar 14, 2017
Mar 14, 2017
728
char *desc;
Mar 6, 2016
Mar 6, 2016
729
char *handle = NULL;
Aug 28, 2016
Aug 28, 2016
730
char *ptr;
Apr 5, 2016
Apr 5, 2016
731
Mar 14, 2017
Mar 14, 2017
732
if (!dev) {
Aug 28, 2016
Aug 28, 2016
733
return;
Mar 6, 2016
Mar 6, 2016
734
735
}
Mar 14, 2017
Mar 14, 2017
736
737
738
739
740
741
742
743
744
745
746
747
748
749
/* Not all alsa devices are enumerable via snd_device_name_get_hint
(i.e. bluetooth devices). Therefore if hint is passed in to this
function as NULL, assume name contains desc.
Make sure not to free the storage associated with desc in this case */
if (hint) {
desc = ALSA_snd_device_name_get_hint(hint, "DESC");
if (!desc) {
SDL_free(dev);
return;
}
} else {
desc = (char *) name;
}
Aug 28, 2016
Aug 28, 2016
750
751
752
753
754
755
756
SDL_assert(name != NULL);
/* some strings have newlines, like "HDA NVidia, HDMI 0\nHDMI Audio Output".
just chop the extra lines off, this seems to get a reasonable device
name without extra details. */
if ((ptr = strchr(desc, '\n')) != NULL) {
*ptr = '\0';
Mar 6, 2016
Mar 6, 2016
757
758
}
Aug 28, 2016
Aug 28, 2016
759
760
/*printf("ALSA: adding %s device '%s' (%s)\n", iscapture ? "capture" : "output", name, desc);*/
Mar 6, 2016
Mar 6, 2016
761
handle = SDL_strdup(name);
Aug 28, 2016
Aug 28, 2016
762
if (!handle) {
Mar 14, 2017
Mar 14, 2017
763
764
765
if (hint) {
free(desc);
}
Aug 28, 2016
Aug 28, 2016
766
767
SDL_free(dev);
return;
Mar 6, 2016
Mar 6, 2016
768
769
}
Aug 28, 2016
Aug 28, 2016
770
SDL_AddAudioDevice(iscapture, desc, handle);
Mar 14, 2017
Mar 14, 2017
771
772
if (hint)
free(desc);
Aug 28, 2016
Aug 28, 2016
773
774
775
776
dev->name = handle;
dev->iscapture = iscapture;
dev->next = *pSeen;
*pSeen = dev;
Mar 6, 2016
Mar 6, 2016
777
778
779
}
Aug 28, 2016
Aug 28, 2016
780
781
static SDL_atomic_t ALSA_hotplug_shutdown;
static SDL_Thread *ALSA_hotplug_thread;
Mar 6, 2016
Mar 6, 2016
782
Aug 28, 2016
Aug 28, 2016
783
784
785
786
787
788
789
790
791
static int SDLCALL
ALSA_HotplugThread(void *arg)
{
SDL_sem *first_run_semaphore = (SDL_sem *) arg;
ALSA_Device *devices = NULL;
ALSA_Device *next;
ALSA_Device *dev;
Uint32 ticks;
Mar 14, 2017
Mar 14, 2017
792
793
SDL_SetThreadPriority(SDL_THREAD_PRIORITY_LOW);
Aug 28, 2016
Aug 28, 2016
794
795
while (!SDL_AtomicGet(&ALSA_hotplug_shutdown)) {
void **hints = NULL;
Mar 14, 2017
Mar 14, 2017
796
797
798
799
ALSA_Device *unseen;
ALSA_Device *seen;
ALSA_Device *prev;
Mar 17, 2019
Mar 17, 2019
800
if (ALSA_snd_device_name_hint(-1, "pcm", &hints) == 0) {
Oct 10, 2016
Oct 10, 2016
801
802
803
804
805
806
807
808
809
int i, j;
const char *match = NULL;
int bestmatch = 0xFFFF;
size_t match_len = 0;
int defaultdev = -1;
static const char * const prefixes[] = {
"hw:", "sysdefault:", "default:", NULL
};
Mar 14, 2017
Mar 14, 2017
810
811
unseen = devices;
seen = NULL;
Oct 10, 2016
Oct 10, 2016
812
813
814
815
/* Apparently there are several different ways that ALSA lists
actual hardware. It could be prefixed with "hw:" or "default:"
or "sysdefault:" and maybe others. Go through the list and see
if we can find a preferred prefix for the system. */
Oct 7, 2016
Oct 7, 2016
816
817
818
819
820
821
for (i = 0; hints[i]; i++) {
char *name = ALSA_snd_device_name_get_hint(hints[i], "NAME");
if (!name) {
continue;
}
Oct 10, 2016
Oct 10, 2016
822
823
824
825
826
827
828
/* full name, not a prefix */
if ((defaultdev == -1) && (SDL_strcmp(name, "default") == 0)) {
defaultdev = i;
}
for (j = 0; prefixes[j]; j++) {
const char *prefix = prefixes[j];
Oct 11, 2016
Oct 11, 2016
829
const size_t prefixlen = SDL_strlen(prefix);
Oct 10, 2016
Oct 10, 2016
830
831
832
833
834
835
836
if (SDL_strncmp(name, prefix, prefixlen) == 0) {
if (j < bestmatch) {
bestmatch = j;
match = prefix;
match_len = prefixlen;
}
}
Oct 7, 2016
Oct 7, 2016
837
838
839
840
841
842
}
free(name);
}
/* look through the list of device names to find matches */
Aug 28, 2016
Aug 28, 2016
843
for (i = 0; hints[i]; i++) {
Oct 10, 2016
Oct 10, 2016
844
845
846
847
848
849
850
851
char *name;
/* if we didn't find a device name prefix we like at all... */
if ((!match) && (defaultdev != i)) {
continue; /* ...skip anything that isn't the default device. */
}
name = ALSA_snd_device_name_get_hint(hints[i], "NAME");
Aug 28, 2016
Aug 28, 2016
852
853
854
855
856
if (!name) {
continue;
}
/* only want physical hardware interfaces */
Oct 10, 2016
Oct 10, 2016
857
if (!match || (SDL_strncmp(name, match, match_len) == 0)) {
Aug 28, 2016
Aug 28, 2016
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
char *ioid = ALSA_snd_device_name_get_hint(hints[i], "IOID");
const SDL_bool isoutput = (ioid == NULL) || (SDL_strcmp(ioid, "Output") == 0);
const SDL_bool isinput = (ioid == NULL) || (SDL_strcmp(ioid, "Input") == 0);
SDL_bool have_output = SDL_FALSE;
SDL_bool have_input = SDL_FALSE;
free(ioid);
if (!isoutput && !isinput) {
free(name);
continue;
}
prev = NULL;
for (dev = unseen; dev; dev = next) {
next = dev->next;
if ( (SDL_strcmp(dev->name, name) == 0) && (((isinput) && dev->iscapture) || ((isoutput) && !dev->iscapture)) ) {
if (prev) {
prev->next = next;
} else {
unseen = next;
}
dev->next = seen;
seen = dev;
if (isinput) have_input = SDL_TRUE;
if (isoutput) have_output = SDL_TRUE;
} else {
prev = dev;
}
}
if (isinput && !have_input) {
add_device(SDL_TRUE, name, hints[i], &seen);
}
if (isoutput && !have_output) {
add_device(SDL_FALSE, name, hints[i], &seen);
}
}
free(name);
Aug 15, 2016
Aug 15, 2016
898
}
Mar 6, 2016
Mar 6, 2016
899
Aug 28, 2016
Aug 28, 2016
900
901
902
903
904
905
ALSA_snd_device_name_free_hint(hints);
devices = seen; /* now we have a known-good list of attached devices. */
/* report anything still in unseen as removed. */
for (dev = unseen; dev; dev = next) {
Mar 14, 2017
Mar 14, 2017
906
/*printf("ALSA: removing usb %s device '%s'\n", dev->iscapture ? "capture" : "output", dev->name);*/
Aug 28, 2016
Aug 28, 2016
907
908
909
910
next = dev->next;
SDL_RemoveAudioDevice(dev->iscapture, dev->name);
SDL_free(dev->name);
SDL_free(dev);
Aug 15, 2016
Aug 15, 2016
911
}
Mar 6, 2016
Mar 6, 2016
912
913
}
Aug 28, 2016
Aug 28, 2016
914
915
916
917
918
919
920
921
/* On first run, tell ALSA_DetectDevices() that we have a complete device list so it can return. */
if (first_run_semaphore) {
SDL_SemPost(first_run_semaphore);
first_run_semaphore = NULL; /* let other thread clean it up. */
}
/* Block awhile before checking again, unless we're told to stop. */
ticks = SDL_GetTicks() + 5000;
Aug 28, 2016
Aug 28, 2016
922
while (!SDL_AtomicGet(&ALSA_hotplug_shutdown) && !SDL_TICKS_PASSED(SDL_GetTicks(), ticks)) {
Aug 28, 2016
Aug 28, 2016
923
924
SDL_Delay(100);
}
Mar 6, 2016
Mar 6, 2016
925
926
}
Aug 28, 2016
Aug 28, 2016
927
928
929
930
931
932
933
934
935
/* Shutting down! Clean up any data we've gathered. */
for (dev = devices; dev; dev = next) {
/*printf("ALSA: at shutdown, removing %s device '%s'\n", dev->iscapture ? "capture" : "output", dev->name);*/
next = dev->next;
SDL_free(dev->name);
SDL_free(dev);
}
return 0;
Mar 6, 2016
Mar 6, 2016
936
937
938
}
static void
Aug 28, 2016
Aug 28, 2016
939
ALSA_DetectDevices(void)
Mar 6, 2016
Mar 6, 2016
940
{
Aug 28, 2016
Aug 28, 2016
941
942
943
944
945
946
947
948
949
950
951
952
953
954
/* Start the device detection thread here, wait for an initial iteration to complete. */
SDL_sem *semaphore = SDL_CreateSemaphore(0);
if (!semaphore) {
return; /* oh well. */
}
SDL_AtomicSet(&ALSA_hotplug_shutdown, 0);
ALSA_hotplug_thread = SDL_CreateThread(ALSA_HotplugThread, "SDLHotplugALSA", semaphore);
if (ALSA_hotplug_thread) {
SDL_SemWait(semaphore); /* wait for the first iteration to finish. */
}
SDL_DestroySemaphore(semaphore);
Mar 6, 2016
Mar 6, 2016
955
956
}
Aug 28, 2016
Aug 28, 2016
957
958
959
960
961
962
963
964
965
966
967
static void
ALSA_Deinitialize(void)
{
if (ALSA_hotplug_thread != NULL) {
SDL_AtomicSet(&ALSA_hotplug_shutdown, 1);
SDL_WaitThread(ALSA_hotplug_thread, NULL);
ALSA_hotplug_thread = NULL;
}
UnloadALSALibrary();
}
Mar 6, 2016
Mar 6, 2016
968
969
970
971
972
973
974
975
976
static int
ALSA_Init(SDL_AudioDriverImpl * impl)
{
if (LoadALSALibrary() < 0) {
return 0;
}
/* Set the function pointers */
Mar 6, 2016
Mar 6, 2016
977
impl->DetectDevices = ALSA_DetectDevices;
978
979
980
981
982
983
impl->OpenDevice = ALSA_OpenDevice;
impl->WaitDevice = ALSA_WaitDevice;
impl->GetDeviceBuf = ALSA_GetDeviceBuf;
impl->PlayDevice = ALSA_PlayDevice;
impl->CloseDevice = ALSA_CloseDevice;
impl->Deinitialize = ALSA_Deinitialize;
Aug 2, 2016
Aug 2, 2016
984
985
986
987
impl->CaptureFromDevice = ALSA_CaptureFromDevice;
impl->FlushCapture = ALSA_FlushCapture;
impl->HasCaptureSupport = SDL_TRUE;
988
989
990
991
992
993
994
995
996
997
998
999
return 1; /* this audio target is available. */
}
AudioBootStrap ALSA_bootstrap = {
"alsa", "ALSA PCM audio", ALSA_Init, 0
};
#endif /* SDL_AUDIO_DRIVER_ALSA */
/* vi: set ts=4 sw=4 expandtab: */