alsa: don't pass non-constant strings as printf format strings
[platform/upstream/gstreamer.git] / ext / alsa / gstalsasrc.c
1 /* GStreamer
2  * Copyright (C) 2005 Wim Taymans <wim@fluendo.com>
3  *
4  * gstalsasrc.c:
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Library General Public
8  * License as published by the Free Software Foundation; either
9  * version 2 of the License, or (at your option) any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Library General Public License for more details.
15  *
16  * You should have received a copy of the GNU Library General Public
17  * License along with this library; if not, write to the
18  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19  * Boston, MA 02111-1307, USA.
20  */
21
22 /**
23  * SECTION:element-alsasrc
24  * @see_also: alsasink, alsamixer
25  *
26  * This element reads data from an audio card using the ALSA API.
27  *
28  * <refsect2>
29  * <title>Example pipelines</title>
30  * |[
31  * gst-launch -v alsasrc ! audioconvert ! vorbisenc ! oggmux ! filesink location=alsasrc.ogg
32  * ]| Record from a sound card using ALSA and encode to Ogg/Vorbis.
33  * </refsect2>
34  *
35  * Last reviewed on 2006-03-01 (0.10.4)
36  */
37
38 #ifdef HAVE_CONFIG_H
39 #include "config.h"
40 #endif
41 #include <sys/ioctl.h>
42 #include <fcntl.h>
43 #include <errno.h>
44 #include <unistd.h>
45 #include <string.h>
46 #include <getopt.h>
47 #include <alsa/asoundlib.h>
48
49 #include "gstalsasrc.h"
50 #include "gstalsadeviceprobe.h"
51
52 #include <gst/gst-i18n-plugin.h>
53
54 #define DEFAULT_PROP_DEVICE             "default"
55 #define DEFAULT_PROP_DEVICE_NAME        ""
56
57 enum
58 {
59   PROP_0,
60   PROP_DEVICE,
61   PROP_DEVICE_NAME,
62 };
63
64 static void gst_alsasrc_init_interfaces (GType type);
65
66 GST_BOILERPLATE_FULL (GstAlsaSrc, gst_alsasrc, GstAudioSrc,
67     GST_TYPE_AUDIO_SRC, gst_alsasrc_init_interfaces);
68
69 GST_IMPLEMENT_ALSA_MIXER_METHODS (GstAlsaSrc, gst_alsasrc_mixer);
70
71 static void gst_alsasrc_finalize (GObject * object);
72 static void gst_alsasrc_set_property (GObject * object,
73     guint prop_id, const GValue * value, GParamSpec * pspec);
74 static void gst_alsasrc_get_property (GObject * object,
75     guint prop_id, GValue * value, GParamSpec * pspec);
76
77 static GstCaps *gst_alsasrc_getcaps (GstBaseSrc * bsrc);
78
79 static gboolean gst_alsasrc_open (GstAudioSrc * asrc);
80 static gboolean gst_alsasrc_prepare (GstAudioSrc * asrc,
81     GstRingBufferSpec * spec);
82 static gboolean gst_alsasrc_unprepare (GstAudioSrc * asrc);
83 static gboolean gst_alsasrc_close (GstAudioSrc * asrc);
84 static guint gst_alsasrc_read (GstAudioSrc * asrc, gpointer data, guint length);
85 static guint gst_alsasrc_delay (GstAudioSrc * asrc);
86 static void gst_alsasrc_reset (GstAudioSrc * asrc);
87
88 /* AlsaSrc signals and args */
89 enum
90 {
91   LAST_SIGNAL
92 };
93
94 #if (G_BYTE_ORDER == G_LITTLE_ENDIAN)
95 # define ALSA_SRC_FACTORY_ENDIANNESS   "LITTLE_ENDIAN, BIG_ENDIAN"
96 #else
97 # define ALSA_SRC_FACTORY_ENDIANNESS   "BIG_ENDIAN, LITTLE_ENDIAN"
98 #endif
99
100 static GstStaticPadTemplate alsasrc_src_factory =
101     GST_STATIC_PAD_TEMPLATE ("src",
102     GST_PAD_SRC,
103     GST_PAD_ALWAYS,
104     GST_STATIC_CAPS ("audio/x-raw-int, "
105         "endianness = (int) { " ALSA_SRC_FACTORY_ENDIANNESS " }, "
106         "signed = (boolean) { TRUE, FALSE }, "
107         "width = (int) 32, "
108         "depth = (int) 32, "
109         "rate = (int) [ 1, MAX ], " "channels = (int) [ 1, MAX ]; "
110         "audio/x-raw-int, "
111         "endianness = (int) { " ALSA_SRC_FACTORY_ENDIANNESS " }, "
112         "signed = (boolean) { TRUE, FALSE }, "
113         "width = (int) 32, "
114         "depth = (int) 24, "
115         "rate = (int) [ 1, MAX ], " "channels = (int) [ 1, MAX ]; "
116         "audio/x-raw-int, "
117         "endianness = (int) { " ALSA_SRC_FACTORY_ENDIANNESS " }, "
118         "signed = (boolean) { TRUE, FALSE }, "
119         "width = (int) 24, "
120         "depth = (int) 24, "
121         "rate = (int) [ 1, MAX ], " "channels = (int) [ 1, MAX ]; "
122         "audio/x-raw-int, "
123         "endianness = (int) { " ALSA_SRC_FACTORY_ENDIANNESS " }, "
124         "signed = (boolean) { TRUE, FALSE }, "
125         "width = (int) 16, "
126         "depth = (int) 16, "
127         "rate = (int) [ 1, MAX ], " "channels = (int) [ 1, MAX ]; "
128         "audio/x-raw-int, "
129         "signed = (boolean) { TRUE, FALSE }, "
130         "width = (int) 8, "
131         "depth = (int) 8, "
132         "rate = (int) [ 1, MAX ], " "channels = (int) [ 1, MAX ]")
133     );
134
135 static void
136 gst_alsasrc_finalize (GObject * object)
137 {
138   GstAlsaSrc *src = GST_ALSA_SRC (object);
139
140   g_free (src->device);
141   g_mutex_free (src->alsa_lock);
142
143   G_OBJECT_CLASS (parent_class)->finalize (object);
144 }
145
146 static gboolean
147 gst_alsasrc_interface_supported (GstAlsaSrc * this, GType interface_type)
148 {
149   /* only support this one interface (wrapped by GstImplementsInterface) */
150   g_assert (interface_type == GST_TYPE_MIXER);
151
152   return gst_alsasrc_mixer_supported (this, interface_type);
153 }
154
155 static void
156 gst_implements_interface_init (GstImplementsInterfaceClass * klass)
157 {
158   klass->supported = (gpointer) gst_alsasrc_interface_supported;
159 }
160
161 static void
162 gst_alsasrc_init_interfaces (GType type)
163 {
164   static const GInterfaceInfo implements_iface_info = {
165     (GInterfaceInitFunc) gst_implements_interface_init,
166     NULL,
167     NULL,
168   };
169   static const GInterfaceInfo mixer_iface_info = {
170     (GInterfaceInitFunc) gst_alsasrc_mixer_interface_init,
171     NULL,
172     NULL,
173   };
174
175   g_type_add_interface_static (type, GST_TYPE_IMPLEMENTS_INTERFACE,
176       &implements_iface_info);
177   g_type_add_interface_static (type, GST_TYPE_MIXER, &mixer_iface_info);
178
179   gst_alsa_type_add_device_property_probe_interface (type);
180 }
181
182 static void
183 gst_alsasrc_base_init (gpointer g_class)
184 {
185   GstElementClass *element_class = GST_ELEMENT_CLASS (g_class);
186
187   gst_element_class_set_details_simple (element_class,
188       "Audio source (ALSA)", "Source/Audio",
189       "Read from a sound card via ALSA", "Wim Taymans <wim@fluendo.com>");
190
191   gst_element_class_add_pad_template (element_class,
192       gst_static_pad_template_get (&alsasrc_src_factory));
193 }
194
195 static void
196 gst_alsasrc_class_init (GstAlsaSrcClass * klass)
197 {
198   GObjectClass *gobject_class;
199   GstBaseSrcClass *gstbasesrc_class;
200   GstAudioSrcClass *gstaudiosrc_class;
201
202   gobject_class = (GObjectClass *) klass;
203   gstbasesrc_class = (GstBaseSrcClass *) klass;
204   gstaudiosrc_class = (GstAudioSrcClass *) klass;
205
206   gobject_class->finalize = gst_alsasrc_finalize;
207   gobject_class->get_property = gst_alsasrc_get_property;
208   gobject_class->set_property = gst_alsasrc_set_property;
209
210   gstbasesrc_class->get_caps = GST_DEBUG_FUNCPTR (gst_alsasrc_getcaps);
211
212   gstaudiosrc_class->open = GST_DEBUG_FUNCPTR (gst_alsasrc_open);
213   gstaudiosrc_class->prepare = GST_DEBUG_FUNCPTR (gst_alsasrc_prepare);
214   gstaudiosrc_class->unprepare = GST_DEBUG_FUNCPTR (gst_alsasrc_unprepare);
215   gstaudiosrc_class->close = GST_DEBUG_FUNCPTR (gst_alsasrc_close);
216   gstaudiosrc_class->read = GST_DEBUG_FUNCPTR (gst_alsasrc_read);
217   gstaudiosrc_class->delay = GST_DEBUG_FUNCPTR (gst_alsasrc_delay);
218   gstaudiosrc_class->reset = GST_DEBUG_FUNCPTR (gst_alsasrc_reset);
219
220   g_object_class_install_property (gobject_class, PROP_DEVICE,
221       g_param_spec_string ("device", "Device",
222           "ALSA device, as defined in an asound configuration file",
223           DEFAULT_PROP_DEVICE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
224
225   g_object_class_install_property (gobject_class, PROP_DEVICE_NAME,
226       g_param_spec_string ("device-name", "Device name",
227           "Human-readable name of the sound device",
228           DEFAULT_PROP_DEVICE_NAME, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
229 }
230
231 static void
232 gst_alsasrc_set_property (GObject * object, guint prop_id,
233     const GValue * value, GParamSpec * pspec)
234 {
235   GstAlsaSrc *src;
236
237   src = GST_ALSA_SRC (object);
238
239   switch (prop_id) {
240     case PROP_DEVICE:
241       g_free (src->device);
242       src->device = g_value_dup_string (value);
243       if (src->device == NULL) {
244         src->device = g_strdup (DEFAULT_PROP_DEVICE);
245       }
246       break;
247     default:
248       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
249       break;
250   }
251 }
252
253 static void
254 gst_alsasrc_get_property (GObject * object, guint prop_id,
255     GValue * value, GParamSpec * pspec)
256 {
257   GstAlsaSrc *src;
258
259   src = GST_ALSA_SRC (object);
260
261   switch (prop_id) {
262     case PROP_DEVICE:
263       g_value_set_string (value, src->device);
264       break;
265     case PROP_DEVICE_NAME:
266       g_value_take_string (value,
267           gst_alsa_find_device_name (GST_OBJECT_CAST (src),
268               src->device, src->handle, SND_PCM_STREAM_CAPTURE));
269       break;
270     default:
271       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
272       break;
273   }
274 }
275
276 static void
277 gst_alsasrc_init (GstAlsaSrc * alsasrc, GstAlsaSrcClass * g_class)
278 {
279   GST_DEBUG_OBJECT (alsasrc, "initializing");
280
281   alsasrc->device = g_strdup (DEFAULT_PROP_DEVICE);
282   alsasrc->cached_caps = NULL;
283
284   alsasrc->alsa_lock = g_mutex_new ();
285 }
286
287 #define CHECK(call, error) \
288 G_STMT_START {                  \
289 if ((err = call) < 0)           \
290   goto error;                   \
291 } G_STMT_END;
292
293
294 static GstCaps *
295 gst_alsasrc_getcaps (GstBaseSrc * bsrc)
296 {
297   GstElementClass *element_class;
298   GstPadTemplate *pad_template;
299   GstAlsaSrc *src;
300   GstCaps *caps;
301
302   src = GST_ALSA_SRC (bsrc);
303
304   if (src->handle == NULL) {
305     GST_DEBUG_OBJECT (src, "device not open, using template caps");
306     return NULL;                /* base class will get template caps for us */
307   }
308
309   if (src->cached_caps) {
310     GST_LOG_OBJECT (src, "Returning cached caps");
311     return gst_caps_ref (src->cached_caps);
312   }
313
314   element_class = GST_ELEMENT_GET_CLASS (src);
315   pad_template = gst_element_class_get_pad_template (element_class, "src");
316   g_return_val_if_fail (pad_template != NULL, NULL);
317
318   caps = gst_alsa_probe_supported_formats (GST_OBJECT (src), src->handle,
319       gst_pad_template_get_caps (pad_template));
320
321   if (caps) {
322     src->cached_caps = gst_caps_ref (caps);
323   }
324
325   GST_INFO_OBJECT (src, "returning caps %" GST_PTR_FORMAT, caps);
326
327   return caps;
328 }
329
330 static int
331 set_hwparams (GstAlsaSrc * alsa)
332 {
333   guint rrate;
334   gint err, dir;
335   snd_pcm_hw_params_t *params;
336
337   snd_pcm_hw_params_malloc (&params);
338
339   /* choose all parameters */
340   CHECK (snd_pcm_hw_params_any (alsa->handle, params), no_config);
341   /* set the interleaved read/write format */
342   CHECK (snd_pcm_hw_params_set_access (alsa->handle, params, alsa->access),
343       wrong_access);
344   /* set the sample format */
345   CHECK (snd_pcm_hw_params_set_format (alsa->handle, params, alsa->format),
346       no_sample_format);
347   /* set the count of channels */
348   CHECK (snd_pcm_hw_params_set_channels (alsa->handle, params, alsa->channels),
349       no_channels);
350   /* set the stream rate */
351   rrate = alsa->rate;
352   CHECK (snd_pcm_hw_params_set_rate_near (alsa->handle, params, &rrate, NULL),
353       no_rate);
354   if (rrate != alsa->rate)
355     goto rate_match;
356
357   if (alsa->buffer_time != -1) {
358     /* set the buffer time */
359     CHECK (snd_pcm_hw_params_set_buffer_time_near (alsa->handle, params,
360             &alsa->buffer_time, &dir), buffer_time);
361   }
362   if (alsa->period_time != -1) {
363     /* set the period time */
364     CHECK (snd_pcm_hw_params_set_period_time_near (alsa->handle, params,
365             &alsa->period_time, &dir), period_time);
366   }
367
368   /* write the parameters to device */
369   CHECK (snd_pcm_hw_params (alsa->handle, params), set_hw_params);
370
371   CHECK (snd_pcm_hw_params_get_buffer_size (params, &alsa->buffer_size),
372       buffer_size);
373
374   CHECK (snd_pcm_hw_params_get_period_size (params, &alsa->period_size, &dir),
375       period_size);
376
377   snd_pcm_hw_params_free (params);
378   return 0;
379
380   /* ERRORS */
381 no_config:
382   {
383     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
384         ("Broken configuration for recording: no configurations available: %s",
385             snd_strerror (err)));
386     snd_pcm_hw_params_free (params);
387     return err;
388   }
389 wrong_access:
390   {
391     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
392         ("Access type not available for recording: %s", snd_strerror (err)));
393     snd_pcm_hw_params_free (params);
394     return err;
395   }
396 no_sample_format:
397   {
398     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
399         ("Sample format not available for recording: %s", snd_strerror (err)));
400     snd_pcm_hw_params_free (params);
401     return err;
402   }
403 no_channels:
404   {
405     gchar *msg = NULL;
406
407     if ((alsa->channels) == 1)
408       msg = g_strdup (_("Could not open device for recording in mono mode."));
409     if ((alsa->channels) == 2)
410       msg = g_strdup (_("Could not open device for recording in stereo mode."));
411     if ((alsa->channels) > 2)
412       msg =
413           g_strdup_printf (_
414           ("Could not open device for recording in %d-channel mode"),
415           alsa->channels);
416     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, ("%s", msg),
417         ("%s", snd_strerror (err)));
418     g_free (msg);
419     snd_pcm_hw_params_free (params);
420     return err;
421   }
422 no_rate:
423   {
424     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
425         ("Rate %iHz not available for recording: %s",
426             alsa->rate, snd_strerror (err)));
427     snd_pcm_hw_params_free (params);
428     return err;
429   }
430 rate_match:
431   {
432     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
433         ("Rate doesn't match (requested %iHz, get %iHz)", alsa->rate, err));
434     snd_pcm_hw_params_free (params);
435     return -EINVAL;
436   }
437 buffer_time:
438   {
439     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
440         ("Unable to set buffer time %i for recording: %s",
441             alsa->buffer_time, snd_strerror (err)));
442     snd_pcm_hw_params_free (params);
443     return err;
444   }
445 buffer_size:
446   {
447     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
448         ("Unable to get buffer size for recording: %s", snd_strerror (err)));
449     snd_pcm_hw_params_free (params);
450     return err;
451   }
452 period_time:
453   {
454     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
455         ("Unable to set period time %i for recording: %s", alsa->period_time,
456             snd_strerror (err)));
457     snd_pcm_hw_params_free (params);
458     return err;
459   }
460 period_size:
461   {
462     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
463         ("Unable to get period size for recording: %s", snd_strerror (err)));
464     snd_pcm_hw_params_free (params);
465     return err;
466   }
467 set_hw_params:
468   {
469     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
470         ("Unable to set hw params for recording: %s", snd_strerror (err)));
471     snd_pcm_hw_params_free (params);
472     return err;
473   }
474 }
475
476 static int
477 set_swparams (GstAlsaSrc * alsa)
478 {
479   int err;
480   snd_pcm_sw_params_t *params;
481
482   snd_pcm_sw_params_malloc (&params);
483
484   /* get the current swparams */
485   CHECK (snd_pcm_sw_params_current (alsa->handle, params), no_config);
486   /* allow the transfer when at least period_size samples can be processed */
487   CHECK (snd_pcm_sw_params_set_avail_min (alsa->handle, params,
488           alsa->period_size), set_avail);
489   /* start the transfer on first read */
490   CHECK (snd_pcm_sw_params_set_start_threshold (alsa->handle, params,
491           0), start_threshold);
492
493 #if GST_CHECK_ALSA_VERSION(1,0,16)
494   /* snd_pcm_sw_params_set_xfer_align() is deprecated, alignment is always 1 */
495 #else
496   /* align all transfers to 1 sample */
497   CHECK (snd_pcm_sw_params_set_xfer_align (alsa->handle, params, 1), set_align);
498 #endif
499
500   /* write the parameters to the recording device */
501   CHECK (snd_pcm_sw_params (alsa->handle, params), set_sw_params);
502
503   snd_pcm_sw_params_free (params);
504   return 0;
505
506   /* ERRORS */
507 no_config:
508   {
509     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
510         ("Unable to determine current swparams for playback: %s",
511             snd_strerror (err)));
512     snd_pcm_sw_params_free (params);
513     return err;
514   }
515 start_threshold:
516   {
517     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
518         ("Unable to set start threshold mode for playback: %s",
519             snd_strerror (err)));
520     snd_pcm_sw_params_free (params);
521     return err;
522   }
523 set_avail:
524   {
525     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
526         ("Unable to set avail min for playback: %s", snd_strerror (err)));
527     snd_pcm_sw_params_free (params);
528     return err;
529   }
530 #if !GST_CHECK_ALSA_VERSION(1,0,16)
531 set_align:
532   {
533     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
534         ("Unable to set transfer align for playback: %s", snd_strerror (err)));
535     snd_pcm_sw_params_free (params);
536     return err;
537   }
538 #endif
539 set_sw_params:
540   {
541     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
542         ("Unable to set sw params for playback: %s", snd_strerror (err)));
543     snd_pcm_sw_params_free (params);
544     return err;
545   }
546 }
547
548 static gboolean
549 alsasrc_parse_spec (GstAlsaSrc * alsa, GstRingBufferSpec * spec)
550 {
551   switch (spec->type) {
552     case GST_BUFTYPE_LINEAR:
553       alsa->format = snd_pcm_build_linear_format (spec->depth, spec->width,
554           spec->sign ? 0 : 1, spec->bigend ? 1 : 0);
555       break;
556     case GST_BUFTYPE_FLOAT:
557       switch (spec->format) {
558         case GST_FLOAT32_LE:
559           alsa->format = SND_PCM_FORMAT_FLOAT_LE;
560           break;
561         case GST_FLOAT32_BE:
562           alsa->format = SND_PCM_FORMAT_FLOAT_BE;
563           break;
564         case GST_FLOAT64_LE:
565           alsa->format = SND_PCM_FORMAT_FLOAT64_LE;
566           break;
567         case GST_FLOAT64_BE:
568           alsa->format = SND_PCM_FORMAT_FLOAT64_BE;
569           break;
570         default:
571           goto error;
572       }
573       break;
574     case GST_BUFTYPE_A_LAW:
575       alsa->format = SND_PCM_FORMAT_A_LAW;
576       break;
577     case GST_BUFTYPE_MU_LAW:
578       alsa->format = SND_PCM_FORMAT_MU_LAW;
579       break;
580     default:
581       goto error;
582
583   }
584   alsa->rate = spec->rate;
585   alsa->channels = spec->channels;
586   alsa->buffer_time = spec->buffer_time;
587   alsa->period_time = spec->latency_time;
588   alsa->access = SND_PCM_ACCESS_RW_INTERLEAVED;
589
590   return TRUE;
591
592   /* ERRORS */
593 error:
594   {
595     return FALSE;
596   }
597 }
598
599 static gboolean
600 gst_alsasrc_open (GstAudioSrc * asrc)
601 {
602   GstAlsaSrc *alsa;
603   gint err;
604
605   alsa = GST_ALSA_SRC (asrc);
606
607   CHECK (snd_pcm_open (&alsa->handle, alsa->device, SND_PCM_STREAM_CAPTURE,
608           SND_PCM_NONBLOCK), open_error);
609
610   if (!alsa->mixer)
611     alsa->mixer = gst_alsa_mixer_new (alsa->device, GST_ALSA_MIXER_CAPTURE);
612
613   return TRUE;
614
615   /* ERRORS */
616 open_error:
617   {
618     if (err == -EBUSY) {
619       GST_ELEMENT_ERROR (alsa, RESOURCE, BUSY,
620           (_("Could not open audio device for recording. "
621                   "Device is being used by another application.")),
622           ("Device '%s' is busy", alsa->device));
623     } else {
624       GST_ELEMENT_ERROR (alsa, RESOURCE, OPEN_READ,
625           (_("Could not open audio device for recording.")),
626           ("Recording open error on device '%s': %s", alsa->device,
627               snd_strerror (err)));
628     }
629     return FALSE;
630   }
631 }
632
633 static gboolean
634 gst_alsasrc_prepare (GstAudioSrc * asrc, GstRingBufferSpec * spec)
635 {
636   GstAlsaSrc *alsa;
637   gint err;
638
639   alsa = GST_ALSA_SRC (asrc);
640
641   if (!alsasrc_parse_spec (alsa, spec))
642     goto spec_parse;
643
644   CHECK (snd_pcm_nonblock (alsa->handle, 0), non_block);
645
646   CHECK (set_hwparams (alsa), hw_params_failed);
647   CHECK (set_swparams (alsa), sw_params_failed);
648   CHECK (snd_pcm_prepare (alsa->handle), prepare_failed);
649
650   alsa->bytes_per_sample = spec->bytes_per_sample;
651   spec->segsize = alsa->period_size * spec->bytes_per_sample;
652   spec->segtotal = alsa->buffer_size / alsa->period_size;
653   spec->silence_sample[0] = 0;
654   spec->silence_sample[1] = 0;
655   spec->silence_sample[2] = 0;
656   spec->silence_sample[3] = 0;
657
658   return TRUE;
659
660   /* ERRORS */
661 spec_parse:
662   {
663     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
664         ("Error parsing spec"));
665     return FALSE;
666   }
667 non_block:
668   {
669     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
670         ("Could not set device to blocking: %s", snd_strerror (err)));
671     return FALSE;
672   }
673 hw_params_failed:
674   {
675     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
676         ("Setting of hwparams failed: %s", snd_strerror (err)));
677     return FALSE;
678   }
679 sw_params_failed:
680   {
681     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
682         ("Setting of swparams failed: %s", snd_strerror (err)));
683     return FALSE;
684   }
685 prepare_failed:
686   {
687     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
688         ("Prepare failed: %s", snd_strerror (err)));
689     return FALSE;
690   }
691 }
692
693 static gboolean
694 gst_alsasrc_unprepare (GstAudioSrc * asrc)
695 {
696   GstAlsaSrc *alsa;
697
698   alsa = GST_ALSA_SRC (asrc);
699
700   snd_pcm_drop (alsa->handle);
701   snd_pcm_hw_free (alsa->handle);
702   snd_pcm_nonblock (alsa->handle, 1);
703
704   return TRUE;
705 }
706
707 static gboolean
708 gst_alsasrc_close (GstAudioSrc * asrc)
709 {
710   GstAlsaSrc *alsa = GST_ALSA_SRC (asrc);
711
712   snd_pcm_close (alsa->handle);
713   alsa->handle = NULL;
714
715   if (alsa->mixer) {
716     gst_alsa_mixer_free (alsa->mixer);
717     alsa->mixer = NULL;
718   }
719
720   gst_caps_replace (&alsa->cached_caps, NULL);
721
722   return TRUE;
723 }
724
725 /*
726  *   Underrun and suspend recovery
727  */
728 static gint
729 xrun_recovery (GstAlsaSrc * alsa, snd_pcm_t * handle, gint err)
730 {
731   GST_DEBUG_OBJECT (alsa, "xrun recovery %d", err);
732
733   if (err == -EPIPE) {          /* under-run */
734     err = snd_pcm_prepare (handle);
735     if (err < 0)
736       GST_WARNING_OBJECT (alsa,
737           "Can't recovery from underrun, prepare failed: %s",
738           snd_strerror (err));
739     return 0;
740   } else if (err == -ESTRPIPE) {
741     while ((err = snd_pcm_resume (handle)) == -EAGAIN)
742       g_usleep (100);           /* wait until the suspend flag is released */
743
744     if (err < 0) {
745       err = snd_pcm_prepare (handle);
746       if (err < 0)
747         GST_WARNING_OBJECT (alsa,
748             "Can't recovery from suspend, prepare failed: %s",
749             snd_strerror (err));
750     }
751     return 0;
752   }
753   return err;
754 }
755
756 static guint
757 gst_alsasrc_read (GstAudioSrc * asrc, gpointer data, guint length)
758 {
759   GstAlsaSrc *alsa;
760   gint err;
761   gint cptr;
762   gint16 *ptr;
763
764   alsa = GST_ALSA_SRC (asrc);
765
766   cptr = length / alsa->bytes_per_sample;
767   ptr = data;
768
769   GST_ALSA_SRC_LOCK (asrc);
770   while (cptr > 0) {
771     if ((err = snd_pcm_readi (alsa->handle, ptr, cptr)) < 0) {
772       if (err == -EAGAIN) {
773         GST_DEBUG_OBJECT (asrc, "Read error: %s", snd_strerror (err));
774         continue;
775       } else if (xrun_recovery (alsa, alsa->handle, err) < 0) {
776         goto read_error;
777       }
778       continue;
779     }
780
781     ptr += err * alsa->channels;
782     cptr -= err;
783   }
784   GST_ALSA_SRC_UNLOCK (asrc);
785
786   return length - (cptr * alsa->bytes_per_sample);
787
788 read_error:
789   {
790     GST_ALSA_SRC_UNLOCK (asrc);
791     return length;              /* skip one period */
792   }
793 }
794
795 static guint
796 gst_alsasrc_delay (GstAudioSrc * asrc)
797 {
798   GstAlsaSrc *alsa;
799   snd_pcm_sframes_t delay;
800   int res;
801
802   alsa = GST_ALSA_SRC (asrc);
803
804   res = snd_pcm_delay (alsa->handle, &delay);
805   if (G_UNLIKELY (res < 0)) {
806     GST_DEBUG_OBJECT (alsa, "snd_pcm_delay returned %d", res);
807     delay = 0;
808   }
809
810   return CLAMP (delay, 0, alsa->buffer_size);
811 }
812
813 static void
814 gst_alsasrc_reset (GstAudioSrc * asrc)
815 {
816   GstAlsaSrc *alsa;
817   gint err;
818
819   alsa = GST_ALSA_SRC (asrc);
820
821   GST_ALSA_SRC_LOCK (asrc);
822   GST_DEBUG_OBJECT (alsa, "drop");
823   CHECK (snd_pcm_drop (alsa->handle), drop_error);
824   GST_DEBUG_OBJECT (alsa, "prepare");
825   CHECK (snd_pcm_prepare (alsa->handle), prepare_error);
826   GST_DEBUG_OBJECT (alsa, "reset done");
827   GST_ALSA_SRC_UNLOCK (asrc);
828
829   return;
830
831   /* ERRORS */
832 drop_error:
833   {
834     GST_ERROR_OBJECT (alsa, "alsa-reset: pcm drop error: %s",
835         snd_strerror (err));
836     GST_ALSA_SRC_UNLOCK (asrc);
837     return;
838   }
839 prepare_error:
840   {
841     GST_ERROR_OBJECT (alsa, "alsa-reset: pcm prepare error: %s",
842         snd_strerror (err));
843     GST_ALSA_SRC_UNLOCK (asrc);
844     return;
845   }
846 }