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 #define DEFAULT_PROP_CARD_NAME          ""
  57
  58 enum
  59 {
  60   PROP_0,
  61   PROP_DEVICE,
  62   PROP_DEVICE_NAME,
  63   PROP_CARD_NAME,
  64   PROP_LAST
  65 };
  66
  67 static void gst_alsasrc_init_interfaces (GType type);
  68
  69 GST_BOILERPLATE_FULL (GstAlsaSrc, gst_alsasrc, GstAudioSrc,
  70     GST_TYPE_AUDIO_SRC, gst_alsasrc_init_interfaces);
  71
  72 GST_IMPLEMENT_ALSA_MIXER_METHODS (GstAlsaSrc, gst_alsasrc_mixer);
  73
  74 static void gst_alsasrc_finalize (GObject * object);
  75 static void gst_alsasrc_set_property (GObject * object,
  76     guint prop_id, const GValue * value, GParamSpec * pspec);
  77 static void gst_alsasrc_get_property (GObject * object,
  78     guint prop_id, GValue * value, GParamSpec * pspec);
  79
  80 static GstCaps *gst_alsasrc_getcaps (GstBaseSrc * bsrc);
  81
  82 static gboolean gst_alsasrc_open (GstAudioSrc * asrc);
  83 static gboolean gst_alsasrc_prepare (GstAudioSrc * asrc,
  84     GstRingBufferSpec * spec);
  85 static gboolean gst_alsasrc_unprepare (GstAudioSrc * asrc);
  86 static gboolean gst_alsasrc_close (GstAudioSrc * asrc);
  87 static guint gst_alsasrc_read (GstAudioSrc * asrc, gpointer data, guint length);
  88 static guint gst_alsasrc_delay (GstAudioSrc * asrc);
  89 static void gst_alsasrc_reset (GstAudioSrc * asrc);
  90 static GstStateChangeReturn gst_alsasrc_change_state (GstElement * element,
  91     GstStateChange transition);
  92 static GstFlowReturn gst_alsasrc_create (GstBaseSrc * bsrc, guint64 offset,
  93     guint length, GstBuffer ** outbuf);
  94 static GstClockTime gst_alsasrc_get_timestamp (GstAlsaSrc * src);
  95
  96
  97 /* AlsaSrc signals and args */
  98 enum
  99 {
 100   LAST_SIGNAL
 101 };
 102
 103 #if (G_BYTE_ORDER == G_LITTLE_ENDIAN)
 104 # define ALSA_SRC_FACTORY_ENDIANNESS   "LITTLE_ENDIAN, BIG_ENDIAN"
 105 #else
 106 # define ALSA_SRC_FACTORY_ENDIANNESS   "BIG_ENDIAN, LITTLE_ENDIAN"
 107 #endif
 108
 109 static GstStaticPadTemplate alsasrc_src_factory =
 110     GST_STATIC_PAD_TEMPLATE ("src",
 111     GST_PAD_SRC,
 112     GST_PAD_ALWAYS,
 113     GST_STATIC_CAPS ("audio/x-raw-int, "
 114         "endianness = (int) { " ALSA_SRC_FACTORY_ENDIANNESS " }, "
 115         "signed = (boolean) { TRUE, FALSE }, "
 116         "width = (int) 32, "
 117         "depth = (int) 32, "
 118         "rate = (int) [ 1, MAX ], " "channels = (int) [ 1, MAX ]; "
 119         "audio/x-raw-int, "
 120         "endianness = (int) { " ALSA_SRC_FACTORY_ENDIANNESS " }, "
 121         "signed = (boolean) { TRUE, FALSE }, "
 122         "width = (int) 32, "
 123         "depth = (int) 24, "
 124         "rate = (int) [ 1, MAX ], " "channels = (int) [ 1, MAX ]; "
 125         "audio/x-raw-int, "
 126         "endianness = (int) { " ALSA_SRC_FACTORY_ENDIANNESS " }, "
 127         "signed = (boolean) { TRUE, FALSE }, "
 128         "width = (int) 24, "
 129         "depth = (int) 24, "
 130         "rate = (int) [ 1, MAX ], " "channels = (int) [ 1, MAX ]; "
 131         "audio/x-raw-int, "
 132         "endianness = (int) { " ALSA_SRC_FACTORY_ENDIANNESS " }, "
 133         "signed = (boolean) { TRUE, FALSE }, "
 134         "width = (int) 16, "
 135         "depth = (int) 16, "
 136         "rate = (int) [ 1, MAX ], " "channels = (int) [ 1, MAX ]; "
 137         "audio/x-raw-int, "
 138         "signed = (boolean) { TRUE, FALSE }, "
 139         "width = (int) 8, "
 140         "depth = (int) 8, "
 141         "rate = (int) [ 1, MAX ], " "channels = (int) [ 1, MAX ]")
 142     );
 143
 144 static void
 145 gst_alsasrc_finalize (GObject * object)
 146 {
 147   GstAlsaSrc *src = GST_ALSA_SRC (object);
 148
 149   g_free (src->device);
 150   g_mutex_free (src->alsa_lock);
 151
 152   G_OBJECT_CLASS (parent_class)->finalize (object);
 153 }
 154
 155 static gboolean
 156 gst_alsasrc_interface_supported (GstAlsaSrc * this, GType interface_type)
 157 {
 158   /* only support this one interface (wrapped by GstImplementsInterface) */
 159   g_assert (interface_type == GST_TYPE_MIXER);
 160
 161   return gst_alsasrc_mixer_supported (this, interface_type);
 162 }
 163
 164 static void
 165 gst_implements_interface_init (GstImplementsInterfaceClass * klass)
 166 {
 167   klass->supported = (gpointer) gst_alsasrc_interface_supported;
 168 }
 169
 170 static void
 171 gst_alsasrc_init_interfaces (GType type)
 172 {
 173   static const GInterfaceInfo implements_iface_info = {
 174     (GInterfaceInitFunc) gst_implements_interface_init,
 175     NULL,
 176     NULL,
 177   };
 178   static const GInterfaceInfo mixer_iface_info = {
 179     (GInterfaceInitFunc) gst_alsasrc_mixer_interface_init,
 180     NULL,
 181     NULL,
 182   };
 183
 184   g_type_add_interface_static (type, GST_TYPE_IMPLEMENTS_INTERFACE,
 185       &implements_iface_info);
 186   g_type_add_interface_static (type, GST_TYPE_MIXER, &mixer_iface_info);
 187
 188   gst_alsa_type_add_device_property_probe_interface (type);
 189 }
 190
 191 static void
 192 gst_alsasrc_base_init (gpointer g_class)
 193 {
 194   GstElementClass *element_class = GST_ELEMENT_CLASS (g_class);
 195
 196   gst_element_class_set_details_simple (element_class,
 197       "Audio source (ALSA)", "Source/Audio",
 198       "Read from a sound card via ALSA", "Wim Taymans <wim@fluendo.com>");
 199
 200   gst_element_class_add_pad_template (element_class,
 201       gst_static_pad_template_get (&alsasrc_src_factory));
 202 }
 203
 204 static void
 205 gst_alsasrc_class_init (GstAlsaSrcClass * klass)
 206 {
 207   GObjectClass *gobject_class;
 208   GstElementClass *gstelement_class;
 209   GstBaseSrcClass *gstbasesrc_class;
 210   GstAudioSrcClass *gstaudiosrc_class;
 211
 212   gobject_class = (GObjectClass *) klass;
 213   gstelement_class = (GstElementClass *) klass;
 214   gstbasesrc_class = (GstBaseSrcClass *) klass;
 215   gstaudiosrc_class = (GstAudioSrcClass *) klass;
 216
 217   gobject_class->finalize = gst_alsasrc_finalize;
 218   gobject_class->get_property = gst_alsasrc_get_property;
 219   gobject_class->set_property = gst_alsasrc_set_property;
 220
 221   gstelement_class->change_state = GST_DEBUG_FUNCPTR (gst_alsasrc_change_state);
 222
 223   gstbasesrc_class->get_caps = GST_DEBUG_FUNCPTR (gst_alsasrc_getcaps);
 224   gstbasesrc_class->create = GST_DEBUG_FUNCPTR (gst_alsasrc_create);
 225
 226   gstaudiosrc_class->open = GST_DEBUG_FUNCPTR (gst_alsasrc_open);
 227   gstaudiosrc_class->prepare = GST_DEBUG_FUNCPTR (gst_alsasrc_prepare);
 228   gstaudiosrc_class->unprepare = GST_DEBUG_FUNCPTR (gst_alsasrc_unprepare);
 229   gstaudiosrc_class->close = GST_DEBUG_FUNCPTR (gst_alsasrc_close);
 230   gstaudiosrc_class->read = GST_DEBUG_FUNCPTR (gst_alsasrc_read);
 231   gstaudiosrc_class->delay = GST_DEBUG_FUNCPTR (gst_alsasrc_delay);
 232   gstaudiosrc_class->reset = GST_DEBUG_FUNCPTR (gst_alsasrc_reset);
 233
 234   g_object_class_install_property (gobject_class, PROP_DEVICE,
 235       g_param_spec_string ("device", "Device",
 236           "ALSA device, as defined in an asound configuration file",
 237           DEFAULT_PROP_DEVICE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 238
 239   g_object_class_install_property (gobject_class, PROP_DEVICE_NAME,
 240       g_param_spec_string ("device-name", "Device name",
 241           "Human-readable name of the sound device",
 242           DEFAULT_PROP_DEVICE_NAME, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 243
 244   g_object_class_install_property (gobject_class, PROP_CARD_NAME,
 245       g_param_spec_string ("card-name", "Card name",
 246           "Human-readable name of the sound card",
 247           DEFAULT_PROP_CARD_NAME, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 248 }
 249
 250 static GstClockTime
 251 gst_alsasrc_get_timestamp (GstAlsaSrc * src)
 252 {
 253   snd_pcm_status_t *status;
 254   snd_htimestamp_t tstamp;
 255   GstClockTime timestamp;
 256   snd_pcm_uframes_t availmax;
 257
 258   GST_DEBUG_OBJECT (src, "Getting alsa timestamp!");
 259
 260   if (!src) {
 261     GST_ERROR_OBJECT (src, "No alsa handle created yet !");
 262     return 0;
 263   }
 264
 265   if (snd_pcm_status_malloc (&status) != 0) {
 266     GST_ERROR_OBJECT (src, "snd_pcm_status_malloc failed");
 267   }
 268
 269   if (snd_pcm_status (src->handle, status) != 0) {
 270     GST_ERROR_OBJECT (src, "snd_pcm_status failed");
 271   }
 272
 273   /* get high resolution time stamp from driver */
 274   snd_pcm_status_get_htstamp (status, &tstamp);
 275   timestamp = GST_TIMESPEC_TO_TIME (tstamp);
 276
 277   /* Max available frames sets the depth of the buffer */
 278   availmax = snd_pcm_status_get_avail_max (status);
 279
 280   /* Compensate the fact that the timestamp references the last sample */
 281   timestamp -= gst_util_uint64_scale_int (availmax * 2, GST_SECOND, src->rate);
 282   /* Compensate for the delay until the package is available */
 283   timestamp += gst_util_uint64_scale_int (snd_pcm_status_get_delay (status),
 284       GST_SECOND, src->rate);
 285
 286   snd_pcm_status_free (status);
 287
 288   GST_DEBUG_OBJECT (src, "ALSA timestamp : %" GST_TIME_FORMAT,
 289       GST_TIME_ARGS (timestamp));
 290   return timestamp;
 291 }
 292
 293 static void
 294 gst_alsasrc_set_property (GObject * object, guint prop_id,
 295     const GValue * value, GParamSpec * pspec)
 296 {
 297   GstAlsaSrc *src;
 298
 299   src = GST_ALSA_SRC (object);
 300
 301   switch (prop_id) {
 302     case PROP_DEVICE:
 303       g_free (src->device);
 304       src->device = g_value_dup_string (value);
 305       if (src->device == NULL) {
 306         src->device = g_strdup (DEFAULT_PROP_DEVICE);
 307       }
 308       break;
 309     default:
 310       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 311       break;
 312   }
 313 }
 314
 315 static void
 316 gst_alsasrc_get_property (GObject * object, guint prop_id,
 317     GValue * value, GParamSpec * pspec)
 318 {
 319   GstAlsaSrc *src;
 320
 321   src = GST_ALSA_SRC (object);
 322
 323   switch (prop_id) {
 324     case PROP_DEVICE:
 325       g_value_set_string (value, src->device);
 326       break;
 327     case PROP_DEVICE_NAME:
 328       g_value_take_string (value,
 329           gst_alsa_find_device_name (GST_OBJECT_CAST (src),
 330               src->device, src->handle, SND_PCM_STREAM_CAPTURE));
 331       break;
 332     case PROP_CARD_NAME:
 333       g_value_take_string (value,
 334           gst_alsa_find_card_name (GST_OBJECT_CAST (src),
 335               src->device, SND_PCM_STREAM_CAPTURE));
 336       break;
 337     default:
 338       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 339       break;
 340   }
 341 }
 342
 343 static GstStateChangeReturn
 344 gst_alsasrc_change_state (GstElement * element, GstStateChange transition)
 345 {
 346   GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
 347   GstBaseAudioSrc *src = GST_BASE_AUDIO_SRC (element);
 348   GstAlsaSrc *asrc = GST_ALSA_SRC (element);
 349   GstClock *clk;
 350
 351   switch (transition) {
 352       /* Show the compiler that we care */
 353     case GST_STATE_CHANGE_NULL_TO_READY:
 354     case GST_STATE_CHANGE_READY_TO_PAUSED:
 355     case GST_STATE_CHANGE_PLAYING_TO_PAUSED:
 356     case GST_STATE_CHANGE_PAUSED_TO_READY:
 357     case GST_STATE_CHANGE_READY_TO_NULL:
 358       break;
 359
 360     case GST_STATE_CHANGE_PAUSED_TO_PLAYING:
 361       clk = src->clock;
 362       asrc->driver_timestamps = FALSE;
 363       if (GST_IS_SYSTEM_CLOCK (clk)) {
 364         gint clocktype;
 365         g_object_get (clk, "clock-type", &clocktype, NULL);
 366         if (clocktype == GST_CLOCK_TYPE_MONOTONIC) {
 367           asrc->driver_timestamps = TRUE;
 368         }
 369       }
 370       break;
 371   }
 372   ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
 373
 374   return ret;
 375 }
 376
 377 static GstFlowReturn
 378 gst_alsasrc_create (GstBaseSrc * bsrc, guint64 offset, guint length,
 379     GstBuffer ** outbuf)
 380 {
 381   GstFlowReturn ret = GST_FLOW_OK;
 382   GstAlsaSrc *asrc = GST_ALSA_SRC (bsrc);
 383
 384   ret =
 385       GST_BASE_SRC_CLASS (parent_class)->create (bsrc, offset, length, outbuf);
 386   if (asrc->driver_timestamps == TRUE && *outbuf) {
 387     GST_BUFFER_TIMESTAMP (*outbuf) =
 388         gst_alsasrc_get_timestamp ((GstAlsaSrc *) bsrc);
 389   }
 390
 391   return ret;
 392 }
 393
 394 static void
 395 gst_alsasrc_init (GstAlsaSrc * alsasrc, GstAlsaSrcClass * g_class)
 396 {
 397   GST_DEBUG_OBJECT (alsasrc, "initializing");
 398
 399   alsasrc->device = g_strdup (DEFAULT_PROP_DEVICE);
 400   alsasrc->cached_caps = NULL;
 401   alsasrc->driver_timestamps = FALSE;
 402
 403   alsasrc->alsa_lock = g_mutex_new ();
 404 }
 405
 406 #define CHECK(call, error) \
 407 G_STMT_START {                  \
 408 if ((err = call) < 0)           \
 409   goto error;                   \
 410 } G_STMT_END;
 411
 412
 413 static GstCaps *
 414 gst_alsasrc_getcaps (GstBaseSrc * bsrc)
 415 {
 416   GstElementClass *element_class;
 417   GstPadTemplate *pad_template;
 418   GstAlsaSrc *src;
 419   GstCaps *caps;
 420
 421   src = GST_ALSA_SRC (bsrc);
 422
 423   if (src->handle == NULL) {
 424     GST_DEBUG_OBJECT (src, "device not open, using template caps");
 425     return NULL;                /* base class will get template caps for us */
 426   }
 427
 428   if (src->cached_caps) {
 429     GST_LOG_OBJECT (src, "Returning cached caps");
 430     return gst_caps_ref (src->cached_caps);
 431   }
 432
 433   element_class = GST_ELEMENT_GET_CLASS (src);
 434   pad_template = gst_element_class_get_pad_template (element_class, "src");
 435   g_return_val_if_fail (pad_template != NULL, NULL);
 436
 437   caps = gst_alsa_probe_supported_formats (GST_OBJECT (src), src->handle,
 438       gst_pad_template_get_caps (pad_template));
 439
 440   if (caps) {
 441     src->cached_caps = gst_caps_ref (caps);
 442   }
 443
 444   GST_INFO_OBJECT (src, "returning caps %" GST_PTR_FORMAT, caps);
 445
 446   return caps;
 447 }
 448
 449 static int
 450 set_hwparams (GstAlsaSrc * alsa)
 451 {
 452   guint rrate;
 453   gint err;
 454   snd_pcm_hw_params_t *params;
 455
 456   snd_pcm_hw_params_malloc (&params);
 457
 458   /* choose all parameters */
 459   CHECK (snd_pcm_hw_params_any (alsa->handle, params), no_config);
 460   /* set the interleaved read/write format */
 461   CHECK (snd_pcm_hw_params_set_access (alsa->handle, params, alsa->access),
 462       wrong_access);
 463   /* set the sample format */
 464   CHECK (snd_pcm_hw_params_set_format (alsa->handle, params, alsa->format),
 465       no_sample_format);
 466   /* set the count of channels */
 467   CHECK (snd_pcm_hw_params_set_channels (alsa->handle, params, alsa->channels),
 468       no_channels);
 469   /* set the stream rate */
 470   rrate = alsa->rate;
 471   CHECK (snd_pcm_hw_params_set_rate_near (alsa->handle, params, &rrate, NULL),
 472       no_rate);
 473   if (rrate != alsa->rate)
 474     goto rate_match;
 475
 476   if (alsa->buffer_time != -1) {
 477     /* set the buffer time */
 478     CHECK (snd_pcm_hw_params_set_buffer_time_near (alsa->handle, params,
 479             &alsa->buffer_time, NULL), buffer_time);
 480   }
 481   if (alsa->period_time != -1) {
 482     /* set the period time */
 483     CHECK (snd_pcm_hw_params_set_period_time_near (alsa->handle, params,
 484             &alsa->period_time, NULL), period_time);
 485   }
 486
 487   /* write the parameters to device */
 488   CHECK (snd_pcm_hw_params (alsa->handle, params), set_hw_params);
 489
 490   CHECK (snd_pcm_hw_params_get_buffer_size (params, &alsa->buffer_size),
 491       buffer_size);
 492
 493   CHECK (snd_pcm_hw_params_get_period_size (params, &alsa->period_size, NULL),
 494       period_size);
 495
 496   snd_pcm_hw_params_free (params);
 497   return 0;
 498
 499   /* ERRORS */
 500 no_config:
 501   {
 502     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 503         ("Broken configuration for recording: no configurations available: %s",
 504             snd_strerror (err)));
 505     snd_pcm_hw_params_free (params);
 506     return err;
 507   }
 508 wrong_access:
 509   {
 510     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 511         ("Access type not available for recording: %s", snd_strerror (err)));
 512     snd_pcm_hw_params_free (params);
 513     return err;
 514   }
 515 no_sample_format:
 516   {
 517     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 518         ("Sample format not available for recording: %s", snd_strerror (err)));
 519     snd_pcm_hw_params_free (params);
 520     return err;
 521   }
 522 no_channels:
 523   {
 524     gchar *msg = NULL;
 525
 526     if ((alsa->channels) == 1)
 527       msg = g_strdup (_("Could not open device for recording in mono mode."));
 528     if ((alsa->channels) == 2)
 529       msg = g_strdup (_("Could not open device for recording in stereo mode."));
 530     if ((alsa->channels) > 2)
 531       msg =
 532           g_strdup_printf (_
 533           ("Could not open device for recording in %d-channel mode"),
 534           alsa->channels);
 535     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, ("%s", msg),
 536         ("%s", snd_strerror (err)));
 537     g_free (msg);
 538     snd_pcm_hw_params_free (params);
 539     return err;
 540   }
 541 no_rate:
 542   {
 543     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 544         ("Rate %iHz not available for recording: %s",
 545             alsa->rate, snd_strerror (err)));
 546     snd_pcm_hw_params_free (params);
 547     return err;
 548   }
 549 rate_match:
 550   {
 551     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 552         ("Rate doesn't match (requested %iHz, get %iHz)", alsa->rate, err));
 553     snd_pcm_hw_params_free (params);
 554     return -EINVAL;
 555   }
 556 buffer_time:
 557   {
 558     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 559         ("Unable to set buffer time %i for recording: %s",
 560             alsa->buffer_time, snd_strerror (err)));
 561     snd_pcm_hw_params_free (params);
 562     return err;
 563   }
 564 buffer_size:
 565   {
 566     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 567         ("Unable to get buffer size for recording: %s", snd_strerror (err)));
 568     snd_pcm_hw_params_free (params);
 569     return err;
 570   }
 571 period_time:
 572   {
 573     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 574         ("Unable to set period time %i for recording: %s", alsa->period_time,
 575             snd_strerror (err)));
 576     snd_pcm_hw_params_free (params);
 577     return err;
 578   }
 579 period_size:
 580   {
 581     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 582         ("Unable to get period size for recording: %s", snd_strerror (err)));
 583     snd_pcm_hw_params_free (params);
 584     return err;
 585   }
 586 set_hw_params:
 587   {
 588     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 589         ("Unable to set hw params for recording: %s", snd_strerror (err)));
 590     snd_pcm_hw_params_free (params);
 591     return err;
 592   }
 593 }
 594
 595 static int
 596 set_swparams (GstAlsaSrc * alsa)
 597 {
 598   int err;
 599   snd_pcm_sw_params_t *params;
 600
 601   snd_pcm_sw_params_malloc (&params);
 602
 603   /* get the current swparams */
 604   CHECK (snd_pcm_sw_params_current (alsa->handle, params), no_config);
 605   /* allow the transfer when at least period_size samples can be processed */
 606   CHECK (snd_pcm_sw_params_set_avail_min (alsa->handle, params,
 607           alsa->period_size), set_avail);
 608   /* start the transfer on first read */
 609   CHECK (snd_pcm_sw_params_set_start_threshold (alsa->handle, params,
 610           0), start_threshold);
 611
 612 #if GST_CHECK_ALSA_VERSION(1,0,16)
 613   /* snd_pcm_sw_params_set_xfer_align() is deprecated, alignment is always 1 */
 614 #else
 615   /* align all transfers to 1 sample */
 616   CHECK (snd_pcm_sw_params_set_xfer_align (alsa->handle, params, 1), set_align);
 617 #endif
 618
 619   /* write the parameters to the recording device */
 620   CHECK (snd_pcm_sw_params (alsa->handle, params), set_sw_params);
 621
 622   snd_pcm_sw_params_free (params);
 623   return 0;
 624
 625   /* ERRORS */
 626 no_config:
 627   {
 628     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 629         ("Unable to determine current swparams for playback: %s",
 630             snd_strerror (err)));
 631     snd_pcm_sw_params_free (params);
 632     return err;
 633   }
 634 start_threshold:
 635   {
 636     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 637         ("Unable to set start threshold mode for playback: %s",
 638             snd_strerror (err)));
 639     snd_pcm_sw_params_free (params);
 640     return err;
 641   }
 642 set_avail:
 643   {
 644     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 645         ("Unable to set avail min for playback: %s", snd_strerror (err)));
 646     snd_pcm_sw_params_free (params);
 647     return err;
 648   }
 649 #if !GST_CHECK_ALSA_VERSION(1,0,16)
 650 set_align:
 651   {
 652     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 653         ("Unable to set transfer align for playback: %s", snd_strerror (err)));
 654     snd_pcm_sw_params_free (params);
 655     return err;
 656   }
 657 #endif
 658 set_sw_params:
 659   {
 660     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 661         ("Unable to set sw params for playback: %s", snd_strerror (err)));
 662     snd_pcm_sw_params_free (params);
 663     return err;
 664   }
 665 }
 666
 667 static gboolean
 668 alsasrc_parse_spec (GstAlsaSrc * alsa, GstRingBufferSpec * spec)
 669 {
 670   switch (spec->type) {
 671     case GST_BUFTYPE_LINEAR:
 672       alsa->format = snd_pcm_build_linear_format (spec->depth, spec->width,
 673           spec->sign ? 0 : 1, spec->bigend ? 1 : 0);
 674       break;
 675     case GST_BUFTYPE_FLOAT:
 676       switch (spec->format) {
 677         case GST_FLOAT32_LE:
 678           alsa->format = SND_PCM_FORMAT_FLOAT_LE;
 679           break;
 680         case GST_FLOAT32_BE:
 681           alsa->format = SND_PCM_FORMAT_FLOAT_BE;
 682           break;
 683         case GST_FLOAT64_LE:
 684           alsa->format = SND_PCM_FORMAT_FLOAT64_LE;
 685           break;
 686         case GST_FLOAT64_BE:
 687           alsa->format = SND_PCM_FORMAT_FLOAT64_BE;
 688           break;
 689         default:
 690           goto error;
 691       }
 692       break;
 693     case GST_BUFTYPE_A_LAW:
 694       alsa->format = SND_PCM_FORMAT_A_LAW;
 695       break;
 696     case GST_BUFTYPE_MU_LAW:
 697       alsa->format = SND_PCM_FORMAT_MU_LAW;
 698       break;
 699     default:
 700       goto error;
 701
 702   }
 703   alsa->rate = spec->rate;
 704   alsa->channels = spec->channels;
 705   alsa->buffer_time = spec->buffer_time;
 706   alsa->period_time = spec->latency_time;
 707   alsa->access = SND_PCM_ACCESS_RW_INTERLEAVED;
 708
 709   return TRUE;
 710
 711   /* ERRORS */
 712 error:
 713   {
 714     return FALSE;
 715   }
 716 }
 717
 718 static gboolean
 719 gst_alsasrc_open (GstAudioSrc * asrc)
 720 {
 721   GstAlsaSrc *alsa;
 722   gint err;
 723
 724   alsa = GST_ALSA_SRC (asrc);
 725
 726   CHECK (snd_pcm_open (&alsa->handle, alsa->device, SND_PCM_STREAM_CAPTURE,
 727           SND_PCM_NONBLOCK), open_error);
 728
 729   if (!alsa->mixer)
 730     alsa->mixer = gst_alsa_mixer_new (alsa->device, GST_ALSA_MIXER_CAPTURE);
 731
 732   return TRUE;
 733
 734   /* ERRORS */
 735 open_error:
 736   {
 737     if (err == -EBUSY) {
 738       GST_ELEMENT_ERROR (alsa, RESOURCE, BUSY,
 739           (_("Could not open audio device for recording. "
 740                   "Device is being used by another application.")),
 741           ("Device '%s' is busy", alsa->device));
 742     } else {
 743       GST_ELEMENT_ERROR (alsa, RESOURCE, OPEN_READ,
 744           (_("Could not open audio device for recording.")),
 745           ("Recording open error on device '%s': %s", alsa->device,
 746               snd_strerror (err)));
 747     }
 748     return FALSE;
 749   }
 750 }
 751
 752 static gboolean
 753 gst_alsasrc_prepare (GstAudioSrc * asrc, GstRingBufferSpec * spec)
 754 {
 755   GstAlsaSrc *alsa;
 756   gint err;
 757
 758   alsa = GST_ALSA_SRC (asrc);
 759
 760   if (!alsasrc_parse_spec (alsa, spec))
 761     goto spec_parse;
 762
 763   CHECK (snd_pcm_nonblock (alsa->handle, 0), non_block);
 764
 765   CHECK (set_hwparams (alsa), hw_params_failed);
 766   CHECK (set_swparams (alsa), sw_params_failed);
 767   CHECK (snd_pcm_prepare (alsa->handle), prepare_failed);
 768
 769   alsa->bytes_per_sample = spec->bytes_per_sample;
 770   spec->segsize = alsa->period_size * spec->bytes_per_sample;
 771   spec->segtotal = alsa->buffer_size / alsa->period_size;
 772   spec->silence_sample[0] = 0;
 773   spec->silence_sample[1] = 0;
 774   spec->silence_sample[2] = 0;
 775   spec->silence_sample[3] = 0;
 776
 777   return TRUE;
 778
 779   /* ERRORS */
 780 spec_parse:
 781   {
 782     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 783         ("Error parsing spec"));
 784     return FALSE;
 785   }
 786 non_block:
 787   {
 788     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 789         ("Could not set device to blocking: %s", snd_strerror (err)));
 790     return FALSE;
 791   }
 792 hw_params_failed:
 793   {
 794     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 795         ("Setting of hwparams failed: %s", snd_strerror (err)));
 796     return FALSE;
 797   }
 798 sw_params_failed:
 799   {
 800     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 801         ("Setting of swparams failed: %s", snd_strerror (err)));
 802     return FALSE;
 803   }
 804 prepare_failed:
 805   {
 806     GST_ELEMENT_ERROR (alsa, RESOURCE, SETTINGS, (NULL),
 807         ("Prepare failed: %s", snd_strerror (err)));
 808     return FALSE;
 809   }
 810 }
 811
 812 static gboolean
 813 gst_alsasrc_unprepare (GstAudioSrc * asrc)
 814 {
 815   GstAlsaSrc *alsa;
 816
 817   alsa = GST_ALSA_SRC (asrc);
 818
 819   snd_pcm_drop (alsa->handle);
 820   snd_pcm_hw_free (alsa->handle);
 821   snd_pcm_nonblock (alsa->handle, 1);
 822
 823   return TRUE;
 824 }
 825
 826 static gboolean
 827 gst_alsasrc_close (GstAudioSrc * asrc)
 828 {
 829   GstAlsaSrc *alsa = GST_ALSA_SRC (asrc);
 830
 831   snd_pcm_close (alsa->handle);
 832   alsa->handle = NULL;
 833
 834   if (alsa->mixer) {
 835     gst_alsa_mixer_free (alsa->mixer);
 836     alsa->mixer = NULL;
 837   }
 838
 839   gst_caps_replace (&alsa->cached_caps, NULL);
 840
 841   return TRUE;
 842 }
 843
 844 /*
 845  *   Underrun and suspend recovery
 846  */
 847 static gint
 848 xrun_recovery (GstAlsaSrc * alsa, snd_pcm_t * handle, gint err)
 849 {
 850   GST_DEBUG_OBJECT (alsa, "xrun recovery %d", err);
 851
 852   if (err == -EPIPE) {          /* under-run */
 853     err = snd_pcm_prepare (handle);
 854     if (err < 0)
 855       GST_WARNING_OBJECT (alsa,
 856           "Can't recovery from underrun, prepare failed: %s",
 857           snd_strerror (err));
 858     return 0;
 859   } else if (err == -ESTRPIPE) {
 860     while ((err = snd_pcm_resume (handle)) == -EAGAIN)
 861       g_usleep (100);           /* wait until the suspend flag is released */
 862
 863     if (err < 0) {
 864       err = snd_pcm_prepare (handle);
 865       if (err < 0)
 866         GST_WARNING_OBJECT (alsa,
 867             "Can't recovery from suspend, prepare failed: %s",
 868             snd_strerror (err));
 869     }
 870     return 0;
 871   }
 872   return err;
 873 }
 874
 875 static guint
 876 gst_alsasrc_read (GstAudioSrc * asrc, gpointer data, guint length)
 877 {
 878   GstAlsaSrc *alsa;
 879   gint err;
 880   gint cptr;
 881   gint16 *ptr;
 882
 883   alsa = GST_ALSA_SRC (asrc);
 884
 885   cptr = length / alsa->bytes_per_sample;
 886   ptr = data;
 887
 888   GST_ALSA_SRC_LOCK (asrc);
 889   while (cptr > 0) {
 890     if ((err = snd_pcm_readi (alsa->handle, ptr, cptr)) < 0) {
 891       if (err == -EAGAIN) {
 892         GST_DEBUG_OBJECT (asrc, "Read error: %s", snd_strerror (err));
 893         continue;
 894       } else if (xrun_recovery (alsa, alsa->handle, err) < 0) {
 895         goto read_error;
 896       }
 897       continue;
 898     }
 899
 900     ptr += err * alsa->channels;
 901     cptr -= err;
 902   }
 903   GST_ALSA_SRC_UNLOCK (asrc);
 904
 905   return length - (cptr * alsa->bytes_per_sample);
 906
 907 read_error:
 908   {
 909     GST_ALSA_SRC_UNLOCK (asrc);
 910     return length;              /* skip one period */
 911   }
 912 }
 913
 914 static guint
 915 gst_alsasrc_delay (GstAudioSrc * asrc)
 916 {
 917   GstAlsaSrc *alsa;
 918   snd_pcm_sframes_t delay;
 919   int res;
 920
 921   alsa = GST_ALSA_SRC (asrc);
 922
 923   res = snd_pcm_delay (alsa->handle, &delay);
 924   if (G_UNLIKELY (res < 0)) {
 925     GST_DEBUG_OBJECT (alsa, "snd_pcm_delay returned %d", res);
 926     delay = 0;
 927   }
 928
 929   return CLAMP (delay, 0, alsa->buffer_size);
 930 }
 931
 932 static void
 933 gst_alsasrc_reset (GstAudioSrc * asrc)
 934 {
 935   GstAlsaSrc *alsa;
 936   gint err;
 937
 938   alsa = GST_ALSA_SRC (asrc);
 939
 940   GST_ALSA_SRC_LOCK (asrc);
 941   GST_DEBUG_OBJECT (alsa, "drop");
 942   CHECK (snd_pcm_drop (alsa->handle), drop_error);
 943   GST_DEBUG_OBJECT (alsa, "prepare");
 944   CHECK (snd_pcm_prepare (alsa->handle), prepare_error);
 945   GST_DEBUG_OBJECT (alsa, "reset done");
 946   GST_ALSA_SRC_UNLOCK (asrc);
 947
 948   return;
 949
 950   /* ERRORS */
 951 drop_error:
 952   {
 953     GST_ERROR_OBJECT (alsa, "alsa-reset: pcm drop error: %s",
 954         snd_strerror (err));
 955     GST_ALSA_SRC_UNLOCK (asrc);
 956     return;
 957   }
 958 prepare_error:
 959   {
 960     GST_ERROR_OBJECT (alsa, "alsa-reset: pcm prepare error: %s",
 961         snd_strerror (err));
 962     GST_ALSA_SRC_UNLOCK (asrc);
 963     return;
 964   }
 965 }