]> git.sesse.net Git - vlc/blob - modules/access/alsa.c
b37b380983c0bfba54cb7eb90cfda98154826223
[vlc] / modules / access / alsa.c
1 /*****************************************************************************
2  * alsa.c : Alsa input module for vlc
3  *****************************************************************************
4  * Copyright (C) 2002-2009 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Benjamin Pracht <bigben at videolan dot org>
8  *          Richard Hosking <richard at hovis dot net>
9  *          Antoine Cellerier <dionoea at videolan d.t org>
10  *          Dennis Lou <dlou99 at yahoo dot com>
11  *
12  * This program is free software; you can redistribute it and/or modify
13  * it under the terms of the GNU General Public License as published by
14  * the Free Software Foundation; either version 2 of the License, or
15  * (at your option) any later version.
16  *
17  * This program is distributed in the hope that it will be useful,
18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20  * GNU General Public License for more details.
21  *
22  * You should have received a copy of the GNU General Public License
23  * along with this program; if not, write to the Free Software
24  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
25  *****************************************************************************/
26
27 /*
28  * ALSA support based on parts of
29  * http://www.equalarea.com/paul/alsa-audio.html
30  * and hints taken from alsa-utils (aplay/arecord)
31  * http://www.alsa-project.org
32  */
33
34 /*****************************************************************************
35  * Preamble
36  *****************************************************************************/
37
38 #ifdef HAVE_CONFIG_H
39 # include "config.h"
40 #endif
41
42 #include <vlc_common.h>
43 #include <vlc_plugin.h>
44 #include <vlc_access.h>
45 #include <vlc_demux.h>
46 #include <vlc_input.h>
47
48 #include <ctype.h>
49 #include <fcntl.h>
50 #include <unistd.h>
51 #include <sys/ioctl.h>
52 #include <sys/mman.h>
53
54 #include <sys/soundcard.h>
55
56 #define ALSA_PCM_NEW_HW_PARAMS_API
57 #define ALSA_PCM_NEW_SW_PARAMS_API
58 #include <alsa/asoundlib.h>
59
60 #include <poll.h>
61
62 /*****************************************************************************
63  * Module descriptior
64  *****************************************************************************/
65
66 static int  DemuxOpen ( vlc_object_t * );
67 static void DemuxClose( vlc_object_t * );
68
69 #define STEREO_TEXT N_( "Stereo" )
70 #define STEREO_LONGTEXT N_( \
71     "Capture the audio stream in stereo." )
72
73 #define SAMPLERATE_TEXT N_( "Samplerate" )
74 #define SAMPLERATE_LONGTEXT N_( \
75     "Samplerate of the captured audio stream, in Hz (eg: 11025, 22050, 44100, 48000)" )
76
77 #define CACHING_TEXT N_("Caching value in ms")
78 #define CACHING_LONGTEXT N_( \
79     "Caching value for Alsa captures. This " \
80     "value should be set in milliseconds." )
81
82 #define ALSA_DEFAULT "hw"
83 #define CFG_PREFIX "alsa-"
84
85 vlc_module_begin()
86     set_shortname( N_("Alsa") )
87     set_description( N_("Alsa audio capture input") )
88     set_category( CAT_INPUT )
89     set_subcategory( SUBCAT_INPUT_ACCESS )
90
91     add_shortcut( "alsa" )
92     set_capability( "access_demux", 10 )
93     set_callbacks( DemuxOpen, DemuxClose )
94
95     add_bool( CFG_PREFIX "stereo", true, NULL, STEREO_TEXT, STEREO_LONGTEXT,
96                 true )
97     add_integer( CFG_PREFIX "samplerate", 48000, NULL, SAMPLERATE_TEXT,
98                 SAMPLERATE_LONGTEXT, true )
99     add_integer( CFG_PREFIX "caching", DEFAULT_PTS_DELAY / 1000, NULL,
100                 CACHING_TEXT, CACHING_LONGTEXT, true )
101 vlc_module_end()
102
103 /*****************************************************************************
104  * Access: local prototypes
105  *****************************************************************************/
106
107 static int DemuxControl( demux_t *, int, va_list );
108
109 static int Demux( demux_t * );
110
111 static block_t* GrabAudio( demux_t *p_demux );
112
113 static int OpenAudioDev( demux_t * );
114 static bool ProbeAudioDevAlsa( demux_t *, const char *psz_device );
115
116 struct demux_sys_t
117 {
118     const char *psz_device;  /* Alsa device from MRL */
119
120     /* Audio */
121     int i_cache;
122     unsigned int i_sample_rate;
123     bool b_stereo;
124     size_t i_max_frame_size;
125     block_t *p_block;
126     es_out_id_t *p_es;
127
128     /* ALSA Audio */
129     snd_pcm_t *p_alsa_pcm;
130     size_t i_alsa_frame_size;
131     int i_alsa_chunk_size;
132
133     int64_t i_next_demux_date; /* Used to handle alsa:// as input-slave properly */
134 };
135
136 static int FindMainDevice( demux_t *p_demux )
137 {
138     /* TODO: if using default device, loop through all alsa devices until
139      * one works. */
140     msg_Dbg( p_demux, "opening device '%s'", p_demux->p_sys->psz_device );
141     if( ProbeAudioDevAlsa( p_demux, p_demux->p_sys->psz_device ) )
142     {
143         msg_Dbg( p_demux, "'%s' is an audio device",
144                  p_demux->p_sys->psz_device );
145         OpenAudioDev( p_demux );
146     }
147
148     if( p_demux->p_sys->p_alsa_pcm == NULL )
149         return VLC_EGENERIC;
150     return VLC_SUCCESS;
151 }
152
153 static void ListAvailableDevices( demux_t *p_demux )
154 {
155     snd_ctl_card_info_t *p_info = NULL;
156     snd_ctl_card_info_alloca( &p_info );
157
158     snd_pcm_info_t *p_pcminfo = NULL;
159     snd_pcm_info_alloca( &p_pcminfo );
160
161     msg_Dbg( p_demux, "Available alsa capture devices:" );
162     int i_card = -1;
163     while( !snd_card_next( &i_card ) && i_card >= 0 )
164     {
165         char psz_devname[10];
166         snprintf( psz_devname, 10, "hw:%d", i_card );
167
168         snd_ctl_t *p_ctl = NULL;
169         if( snd_ctl_open( &p_ctl, psz_devname, 0 ) < 0 ) continue;
170
171         snd_ctl_card_info( p_ctl, p_info );
172         msg_Dbg( p_demux, "  %s (%s)",
173                  snd_ctl_card_info_get_id( p_info ),
174                  snd_ctl_card_info_get_name( p_info ) );
175
176         int i_dev = -1;
177         while( !snd_ctl_pcm_next_device( p_ctl, &i_dev ) && i_dev >= 0 )
178         {
179             snd_pcm_info_set_device( p_pcminfo, i_dev );
180             snd_pcm_info_set_subdevice( p_pcminfo, 0 );
181             snd_pcm_info_set_stream( p_pcminfo, SND_PCM_STREAM_CAPTURE );
182             if( snd_ctl_pcm_info( p_ctl, p_pcminfo ) < 0 ) continue;
183
184             msg_Dbg( p_demux, "    hw:%d,%d : %s (%s)", i_card, i_dev,
185                      snd_pcm_info_get_id( p_pcminfo ),
186                      snd_pcm_info_get_name( p_pcminfo ) );
187         }
188
189         snd_ctl_close( p_ctl );
190     }
191 }
192
193 /*****************************************************************************
194  * DemuxOpen: opens alsa device, access_demux callback
195  *****************************************************************************
196  *
197  * url: <alsa device>::::
198  *
199  *****************************************************************************/
200 static int DemuxOpen( vlc_object_t *p_this )
201 {
202     demux_t     *p_demux = (demux_t*)p_this;
203     demux_sys_t *p_sys;
204
205     /* Only when selected */
206     if( *p_demux->psz_access == '\0' ) return VLC_EGENERIC;
207
208     /* Set up p_demux */
209     p_demux->pf_control = DemuxControl;
210     p_demux->pf_demux = Demux;
211     p_demux->info.i_update = 0;
212     p_demux->info.i_title = 0;
213     p_demux->info.i_seekpoint = 0;
214
215     p_demux->p_sys = p_sys = calloc( 1, sizeof( demux_sys_t ) );
216     if( p_sys == NULL ) return VLC_ENOMEM;
217
218     p_sys->i_sample_rate = var_CreateGetInteger( p_demux, CFG_PREFIX "samplerate" );
219     p_sys->b_stereo = var_CreateGetBool( p_demux, CFG_PREFIX "stereo" );
220     p_sys->i_cache = var_CreateGetInteger( p_demux, CFG_PREFIX "caching" );
221     p_sys->p_es = NULL;
222     p_sys->p_block = NULL;
223     p_sys->i_next_demux_date = -1;
224
225     if( p_demux->psz_path && *p_demux->psz_path )
226         p_sys->psz_device = p_demux->psz_path;
227     else
228     {
229         p_sys->psz_device = ALSA_DEFAULT;
230         ListAvailableDevices( p_demux );
231     }
232
233     if( FindMainDevice( p_demux ) != VLC_SUCCESS )
234     {
235         DemuxClose( p_this );
236         return VLC_EGENERIC;
237     }
238
239     return VLC_SUCCESS;
240 }
241
242 /*****************************************************************************
243  * Close: close device, free resources
244  *****************************************************************************/
245 static void DemuxClose( vlc_object_t *p_this )
246 {
247     demux_t     *p_demux = (demux_t *)p_this;
248     demux_sys_t *p_sys   = p_demux->p_sys;
249
250     if( p_sys->p_alsa_pcm )
251     {
252         snd_pcm_close( p_sys->p_alsa_pcm );
253     }
254
255     if( p_sys->p_block ) block_Release( p_sys->p_block );
256
257     free( p_sys );
258 }
259
260 /*****************************************************************************
261  * DemuxControl:
262  *****************************************************************************/
263 static int DemuxControl( demux_t *p_demux, int i_query, va_list args )
264 {
265     demux_sys_t *p_sys = p_demux->p_sys;
266
267     switch( i_query )
268     {
269         /* Special for access_demux */
270         case DEMUX_CAN_PAUSE:
271         case DEMUX_CAN_SEEK:
272         case DEMUX_SET_PAUSE_STATE:
273         case DEMUX_CAN_CONTROL_PACE:
274             *va_arg( args, bool * ) = false;
275             return VLC_SUCCESS;
276
277         case DEMUX_GET_PTS_DELAY:
278             *va_arg( args, int64_t * ) = (int64_t)p_sys->i_cache * 1000;
279             return VLC_SUCCESS;
280
281         case DEMUX_GET_TIME:
282             *va_arg( args, int64_t * ) = mdate();
283             return VLC_SUCCESS;
284
285         case DEMUX_SET_NEXT_DEMUX_TIME:
286             p_sys->i_next_demux_date = va_arg( args, int64_t );
287             return VLC_SUCCESS;
288
289         /* TODO implement others */
290         default:
291             return VLC_EGENERIC;
292     }
293
294     return VLC_EGENERIC;
295 }
296
297 /*****************************************************************************
298  * Demux: Processes the audio frame
299  *****************************************************************************/
300 static int Demux( demux_t *p_demux )
301 {
302     demux_sys_t *p_sys = p_demux->p_sys;
303
304     block_t *p_block = NULL;
305
306     do
307     {
308         if( p_block )
309         {
310             es_out_Send( p_demux->out, p_sys->p_es, p_block );
311             p_block = NULL;
312         }
313
314         /* Wait for data */
315         int i_wait = snd_pcm_wait( p_sys->p_alsa_pcm, 10 ); /* See poll() comment in oss.c */
316         switch( i_wait )
317         {
318             case 1:
319             {
320                 p_block = GrabAudio( p_demux );
321                 if( p_block )
322                     es_out_Control( p_demux->out, ES_OUT_SET_PCR, p_block->i_pts );
323             }
324
325             /* FIXME: this is a copy paste from below. Shouldn't be needed
326              * twice. */
327             case -EPIPE:
328                 /* xrun */
329                 snd_pcm_prepare( p_sys->p_alsa_pcm );
330                 break;
331             case -ESTRPIPE:
332             {
333                 /* suspend */
334                 int i_resume = snd_pcm_resume( p_sys->p_alsa_pcm );
335                 if( i_resume < 0 && i_resume != -EAGAIN ) snd_pcm_prepare( p_sys->p_alsa_pcm );
336                 break;
337             }
338             /* </FIXME> */
339         }
340     } while( p_block && p_sys->i_next_demux_date > 0 &&
341              p_block->i_pts < p_sys->i_next_demux_date );
342
343     if( p_block )
344         es_out_Send( p_demux->out, p_sys->p_es, p_block );
345
346     return 1;
347 }
348
349
350 /*****************************************************************************
351  * GrabAudio: Grab an audio frame
352  *****************************************************************************/
353 static block_t* GrabAudio( demux_t *p_demux )
354 {
355     demux_sys_t *p_sys = p_demux->p_sys;
356     int i_read, i_correct;
357     block_t *p_block;
358
359     if( p_sys->p_block ) p_block = p_sys->p_block;
360     else p_block = block_New( p_demux, p_sys->i_max_frame_size );
361
362     if( !p_block )
363     {
364         msg_Warn( p_demux, "cannot get block" );
365         return 0;
366     }
367
368     p_sys->p_block = p_block;
369
370     /* ALSA */
371     i_read = snd_pcm_readi( p_sys->p_alsa_pcm, p_block->p_buffer, p_sys->i_alsa_chunk_size );
372     if( i_read <= 0 )
373     {
374         int i_resume;
375         switch( i_read )
376         {
377             case -EAGAIN:
378                 break;
379             case -EPIPE:
380                 /* xrun */
381                 snd_pcm_prepare( p_sys->p_alsa_pcm );
382                 break;
383             case -ESTRPIPE:
384                 /* suspend */
385                 i_resume = snd_pcm_resume( p_sys->p_alsa_pcm );
386                 if( i_resume < 0 && i_resume != -EAGAIN ) snd_pcm_prepare( p_sys->p_alsa_pcm );
387                 break;
388             default:
389                 msg_Err( p_demux, "Failed to read alsa frame (%s)", snd_strerror( i_read ) );
390                 return 0;
391         }
392     }
393     else
394     {
395         /* convert from frames to bytes */
396         i_read *= p_sys->i_alsa_frame_size;
397     }
398
399     if( i_read <= 0 ) return 0;
400
401     p_block->i_buffer = i_read;
402     p_sys->p_block = 0;
403
404     /* Correct the date because of kernel buffering */
405     i_correct = i_read;
406     /* ALSA */
407     int i_err;
408     snd_pcm_sframes_t delay = 0;
409     if( ( i_err = snd_pcm_delay( p_sys->p_alsa_pcm, &delay ) ) >= 0 )
410     {
411         size_t i_correction_delta = delay * p_sys->i_alsa_frame_size;
412         /* Test for overrun */
413         if( i_correction_delta > p_sys->i_max_frame_size )
414         {
415             msg_Warn( p_demux, "ALSA read overrun (%zu > %zu)",
416                       i_correction_delta, p_sys->i_max_frame_size );
417             i_correction_delta = p_sys->i_max_frame_size;
418             snd_pcm_prepare( p_sys->p_alsa_pcm );
419         }
420         i_correct += i_correction_delta;
421     }
422     else
423     {
424         /* delay failed so reset */
425         msg_Warn( p_demux, "ALSA snd_pcm_delay failed (%s)", snd_strerror( i_err ) );
426         snd_pcm_prepare( p_sys->p_alsa_pcm );
427     }
428
429     /* Timestamp */
430     p_block->i_pts = p_block->i_dts =
431         mdate() - INT64_C(1000000) * (mtime_t)i_correct /
432         2 / ( p_sys->b_stereo ? 2 : 1) / p_sys->i_sample_rate;
433
434     return p_block;
435 }
436
437 /*****************************************************************************
438  * OpenAudioDev: open and set up the audio device and probe for capabilities
439  *****************************************************************************/
440 static int OpenAudioDevAlsa( demux_t *p_demux )
441 {
442     demux_sys_t *p_sys = p_demux->p_sys;
443     const char *psz_device = p_sys->psz_device;
444     p_sys->p_alsa_pcm = NULL;
445     snd_pcm_hw_params_t *p_hw_params = NULL;
446     snd_pcm_uframes_t buffer_size;
447     snd_pcm_uframes_t chunk_size;
448
449     /* ALSA */
450     int i_err;
451
452     if( ( i_err = snd_pcm_open( &p_sys->p_alsa_pcm, psz_device,
453         SND_PCM_STREAM_CAPTURE, SND_PCM_NONBLOCK ) ) < 0)
454     {
455         msg_Err( p_demux, "Cannot open ALSA audio device %s (%s)",
456                  psz_device, snd_strerror( i_err ) );
457         goto adev_fail;
458     }
459
460     if( ( i_err = snd_pcm_nonblock( p_sys->p_alsa_pcm, 1 ) ) < 0)
461     {
462         msg_Err( p_demux, "Cannot set ALSA nonblock (%s)",
463                  snd_strerror( i_err ) );
464         goto adev_fail;
465     }
466
467     /* Begin setting hardware parameters */
468
469     if( ( i_err = snd_pcm_hw_params_malloc( &p_hw_params ) ) < 0 )
470     {
471         msg_Err( p_demux,
472                  "ALSA: cannot allocate hardware parameter structure (%s)",
473                  snd_strerror( i_err ) );
474         goto adev_fail;
475     }
476
477     if( ( i_err = snd_pcm_hw_params_any( p_sys->p_alsa_pcm, p_hw_params ) ) < 0 )
478     {
479         msg_Err( p_demux,
480                 "ALSA: cannot initialize hardware parameter structure (%s)",
481                  snd_strerror( i_err ) );
482         goto adev_fail;
483     }
484
485     /* Set Interleaved access */
486     if( ( i_err = snd_pcm_hw_params_set_access( p_sys->p_alsa_pcm, p_hw_params, SND_PCM_ACCESS_RW_INTERLEAVED ) ) < 0 )
487     {
488         msg_Err( p_demux, "ALSA: cannot set access type (%s)",
489                  snd_strerror( i_err ) );
490         goto adev_fail;
491     }
492
493     /* Set 16 bit little endian */
494     if( ( i_err = snd_pcm_hw_params_set_format( p_sys->p_alsa_pcm, p_hw_params, SND_PCM_FORMAT_S16_LE ) ) < 0 )
495     {
496         msg_Err( p_demux, "ALSA: cannot set sample format (%s)",
497                  snd_strerror( i_err ) );
498         goto adev_fail;
499     }
500
501     /* Set sample rate */
502     i_err = snd_pcm_hw_params_set_rate_near( p_sys->p_alsa_pcm, p_hw_params, &p_sys->i_sample_rate, NULL );
503     if( i_err < 0 )
504     {
505         msg_Err( p_demux, "ALSA: cannot set sample rate (%s)",
506                  snd_strerror( i_err ) );
507         goto adev_fail;
508     }
509
510     /* Set channels */
511     unsigned int channels = p_sys->b_stereo ? 2 : 1;
512     if( ( i_err = snd_pcm_hw_params_set_channels( p_sys->p_alsa_pcm, p_hw_params, channels ) ) < 0 )
513     {
514         channels = ( channels==1 ) ? 2 : 1;
515         msg_Warn( p_demux, "ALSA: cannot set channel count (%s). "
516                   "Trying with channels=%d",
517                   snd_strerror( i_err ),
518                   channels );
519         if( ( i_err = snd_pcm_hw_params_set_channels( p_sys->p_alsa_pcm, p_hw_params, channels ) ) < 0 )
520         {
521             msg_Err( p_demux, "ALSA: cannot set channel count (%s)",
522                      snd_strerror( i_err ) );
523             goto adev_fail;
524         }
525         p_sys->b_stereo = ( channels == 2 );
526     }
527
528     /* Set metrics for buffer calculations later */
529     unsigned int buffer_time;
530     if( ( i_err = snd_pcm_hw_params_get_buffer_time_max(p_hw_params, &buffer_time, 0) ) < 0 )
531     {
532         msg_Err( p_demux, "ALSA: cannot get buffer time max (%s)",
533                  snd_strerror( i_err ) );
534         goto adev_fail;
535     }
536     if( buffer_time > 500000 ) buffer_time = 500000;
537
538     /* Set period time */
539     unsigned int period_time = buffer_time / 4;
540     i_err = snd_pcm_hw_params_set_period_time_near( p_sys->p_alsa_pcm, p_hw_params, &period_time, 0 );
541     if( i_err < 0 )
542     {
543         msg_Err( p_demux, "ALSA: cannot set period time (%s)",
544                  snd_strerror( i_err ) );
545         goto adev_fail;
546     }
547
548     /* Set buffer time */
549     i_err = snd_pcm_hw_params_set_buffer_time_near( p_sys->p_alsa_pcm, p_hw_params, &buffer_time, 0 );
550     if( i_err < 0 )
551     {
552         msg_Err( p_demux, "ALSA: cannot set buffer time (%s)",
553                  snd_strerror( i_err ) );
554         goto adev_fail;
555     }
556
557     /* Apply new hardware parameters */
558     if( ( i_err = snd_pcm_hw_params( p_sys->p_alsa_pcm, p_hw_params ) ) < 0 )
559     {
560         msg_Err( p_demux, "ALSA: cannot set hw parameters (%s)",
561                  snd_strerror( i_err ) );
562         goto adev_fail;
563     }
564
565     /* Get various buffer metrics */
566     snd_pcm_hw_params_get_period_size( p_hw_params, &chunk_size, 0 );
567     snd_pcm_hw_params_get_buffer_size( p_hw_params, &buffer_size );
568     if( chunk_size == buffer_size )
569     {
570         msg_Err( p_demux,
571                  "ALSA: period cannot equal buffer size (%lu == %lu)",
572                  chunk_size, buffer_size);
573         goto adev_fail;
574     }
575
576     int bits_per_sample = snd_pcm_format_physical_width(SND_PCM_FORMAT_S16_LE);
577     int bits_per_frame = bits_per_sample * channels;
578
579     p_sys->i_alsa_chunk_size = chunk_size;
580     p_sys->i_alsa_frame_size = bits_per_frame / 8;
581     p_sys->i_max_frame_size = chunk_size * bits_per_frame / 8;
582
583     snd_pcm_hw_params_free( p_hw_params );
584     p_hw_params = NULL;
585
586     /* Prep device */
587     if( ( i_err = snd_pcm_prepare( p_sys->p_alsa_pcm ) ) < 0 )
588     {
589         msg_Err( p_demux,
590                  "ALSA: cannot prepare audio interface for use (%s)",
591                  snd_strerror( i_err ) );
592         goto adev_fail;
593     }
594
595     snd_pcm_start( p_sys->p_alsa_pcm );
596
597     return VLC_SUCCESS;
598
599  adev_fail:
600
601     if( p_hw_params ) snd_pcm_hw_params_free( p_hw_params );
602     if( p_sys->p_alsa_pcm ) snd_pcm_close( p_sys->p_alsa_pcm );
603     p_sys->p_alsa_pcm = NULL;
604
605     return VLC_EGENERIC;
606
607 }
608
609 static int OpenAudioDev( demux_t *p_demux )
610 {
611     demux_sys_t *p_sys = p_demux->p_sys;
612     if( OpenAudioDevAlsa( p_demux ) != VLC_SUCCESS )
613         return VLC_EGENERIC;
614
615     msg_Dbg( p_demux, "opened adev=`%s' %s %dHz",
616              p_sys->psz_device, p_sys->b_stereo ? "stereo" : "mono",
617              p_sys->i_sample_rate );
618
619     es_format_t fmt;
620     es_format_Init( &fmt, AUDIO_ES, VLC_FOURCC('a','r','a','w') );
621
622     fmt.audio.i_channels = p_sys->b_stereo ? 2 : 1;
623     fmt.audio.i_rate = p_sys->i_sample_rate;
624     fmt.audio.i_bitspersample = 16;
625     fmt.audio.i_blockalign = fmt.audio.i_channels * fmt.audio.i_bitspersample / 8;
626     fmt.i_bitrate = fmt.audio.i_channels * fmt.audio.i_rate * fmt.audio.i_bitspersample;
627
628     msg_Dbg( p_demux, "new audio es %d channels %dHz",
629              fmt.audio.i_channels, fmt.audio.i_rate );
630
631     p_sys->p_es = es_out_Add( p_demux->out, &fmt );
632
633     return VLC_SUCCESS;
634 }
635
636 /*****************************************************************************
637  * ProbeAudioDevAlsa: probe audio for capabilities
638  *****************************************************************************/
639 static bool ProbeAudioDevAlsa( demux_t *p_demux, const char *psz_device )
640 {
641     int i_err;
642     snd_pcm_t *p_alsa_pcm;
643
644     if( ( i_err = snd_pcm_open( &p_alsa_pcm, psz_device, SND_PCM_STREAM_CAPTURE, SND_PCM_NONBLOCK ) ) < 0 )
645     {
646         msg_Err( p_demux, "cannot open device %s for ALSA audio (%s)", psz_device, snd_strerror( i_err ) );
647         return false;
648     }
649
650     snd_pcm_close( p_alsa_pcm );
651
652     return true;
653 }