Doxygen Cleanup
[asterisk/asterisk.git] / channels / chan_alsa.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2005, Digium, Inc.
5  *
6  * By Matthew Fredrickson <creslin@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*! \file 
20  * \brief ALSA sound card channel driver 
21  *
22  * \author Matthew Fredrickson <creslin@digium.com>
23  *
24  * \ingroup channel_drivers
25  */
26
27 /*!
28  * \li The channel chan_alsa uses the configuration file \ref alsa.conf
29  * \addtogroup configuration_file
30  */
31
32 /*! \page alsa.conf alsa.conf
33  * \verbinclude alsa.conf.sample
34  */
35
36 /*** MODULEINFO
37         <depend>alsa</depend>
38         <support_level>extended</support_level>
39  ***/
40
41 #include "asterisk.h"
42
43 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
44
45 #include <fcntl.h>
46 #include <sys/ioctl.h>
47 #include <sys/time.h>
48
49 #define ALSA_PCM_NEW_HW_PARAMS_API
50 #define ALSA_PCM_NEW_SW_PARAMS_API
51 #include <alsa/asoundlib.h>
52
53 #include "asterisk/frame.h"
54 #include "asterisk/channel.h"
55 #include "asterisk/module.h"
56 #include "asterisk/pbx.h"
57 #include "asterisk/config.h"
58 #include "asterisk/cli.h"
59 #include "asterisk/utils.h"
60 #include "asterisk/causes.h"
61 #include "asterisk/endian.h"
62 #include "asterisk/stringfields.h"
63 #include "asterisk/abstract_jb.h"
64 #include "asterisk/musiconhold.h"
65 #include "asterisk/poll-compat.h"
66
67 /*! Global jitterbuffer configuration - by default, jb is disabled
68  *  \note Values shown here match the defaults shown in alsa.conf.sample */
69 static struct ast_jb_conf default_jbconf = {
70         .flags = 0,
71         .max_size = 200,
72         .resync_threshold = 1000,
73         .impl = "fixed",
74         .target_extra = 40,
75 };
76 static struct ast_jb_conf global_jbconf;
77
78 #define DEBUG 0
79 /* Which device to use */
80 #define ALSA_INDEV "default"
81 #define ALSA_OUTDEV "default"
82 #define DESIRED_RATE 8000
83
84 /* Lets use 160 sample frames, just like GSM.  */
85 #define FRAME_SIZE 160
86 #define PERIOD_FRAMES 80                /* 80 Frames, at 2 bytes each */
87
88 /* When you set the frame size, you have to come up with
89    the right buffer format as well. */
90 /* 5 64-byte frames = one frame */
91 #define BUFFER_FMT ((buffersize * 10) << 16) | (0x0006);
92
93 /* Don't switch between read/write modes faster than every 300 ms */
94 #define MIN_SWITCH_TIME 600
95
96 #if __BYTE_ORDER == __LITTLE_ENDIAN
97 static snd_pcm_format_t format = SND_PCM_FORMAT_S16_LE;
98 #else
99 static snd_pcm_format_t format = SND_PCM_FORMAT_S16_BE;
100 #endif
101
102 static char indevname[50] = ALSA_INDEV;
103 static char outdevname[50] = ALSA_OUTDEV;
104
105 static int silencesuppression = 0;
106 static int silencethreshold = 1000;
107
108 AST_MUTEX_DEFINE_STATIC(alsalock);
109
110 static const char tdesc[] = "ALSA Console Channel Driver";
111 static const char config[] = "alsa.conf";
112
113 static char context[AST_MAX_CONTEXT] = "default";
114 static char language[MAX_LANGUAGE] = "";
115 static char exten[AST_MAX_EXTENSION] = "s";
116 static char mohinterpret[MAX_MUSICCLASS];
117
118 static int hookstate = 0;
119
120 static struct chan_alsa_pvt {
121         /* We only have one ALSA structure -- near sighted perhaps, but it
122            keeps this driver as simple as possible -- as it should be. */
123         struct ast_channel *owner;
124         char exten[AST_MAX_EXTENSION];
125         char context[AST_MAX_CONTEXT];
126         snd_pcm_t *icard, *ocard;
127
128 } alsa;
129
130 /* Number of buffers...  Each is FRAMESIZE/8 ms long.  For example
131    with 160 sample frames, and a buffer size of 3, we have a 60ms buffer, 
132    usually plenty. */
133
134 #define MAX_BUFFER_SIZE 100
135
136 /* File descriptors for sound device */
137 static int readdev = -1;
138 static int writedev = -1;
139
140 static int autoanswer = 1;
141 static int mute = 0;
142 static int noaudiocapture = 0;
143
144 static struct ast_channel *alsa_request(const char *type, struct ast_format_cap *cap, const struct ast_channel *requestor, const char *data, int *cause);
145 static int alsa_digit(struct ast_channel *c, char digit, unsigned int duration);
146 static int alsa_text(struct ast_channel *c, const char *text);
147 static int alsa_hangup(struct ast_channel *c);
148 static int alsa_answer(struct ast_channel *c);
149 static struct ast_frame *alsa_read(struct ast_channel *chan);
150 static int alsa_call(struct ast_channel *c, const char *dest, int timeout);
151 static int alsa_write(struct ast_channel *chan, struct ast_frame *f);
152 static int alsa_indicate(struct ast_channel *chan, int cond, const void *data, size_t datalen);
153 static int alsa_fixup(struct ast_channel *oldchan, struct ast_channel *newchan);
154
155 static struct ast_channel_tech alsa_tech = {
156         .type = "Console",
157         .description = tdesc,
158         .requester = alsa_request,
159         .send_digit_end = alsa_digit,
160         .send_text = alsa_text,
161         .hangup = alsa_hangup,
162         .answer = alsa_answer,
163         .read = alsa_read,
164         .call = alsa_call,
165         .write = alsa_write,
166         .indicate = alsa_indicate,
167         .fixup = alsa_fixup,
168 };
169
170 static snd_pcm_t *alsa_card_init(char *dev, snd_pcm_stream_t stream)
171 {
172         int err;
173         int direction;
174         snd_pcm_t *handle = NULL;
175         snd_pcm_hw_params_t *hwparams = NULL;
176         snd_pcm_sw_params_t *swparams = NULL;
177         struct pollfd pfd;
178         snd_pcm_uframes_t period_size = PERIOD_FRAMES * 4;
179         snd_pcm_uframes_t buffer_size = 0;
180         unsigned int rate = DESIRED_RATE;
181         snd_pcm_uframes_t start_threshold, stop_threshold;
182
183         err = snd_pcm_open(&handle, dev, stream, SND_PCM_NONBLOCK);
184         if (err < 0) {
185                 ast_log(LOG_ERROR, "snd_pcm_open failed: %s\n", snd_strerror(err));
186                 return NULL;
187         } else {
188                 ast_debug(1, "Opening device %s in %s mode\n", dev, (stream == SND_PCM_STREAM_CAPTURE) ? "read" : "write");
189         }
190
191         hwparams = ast_alloca(snd_pcm_hw_params_sizeof());
192         memset(hwparams, 0, snd_pcm_hw_params_sizeof());
193         snd_pcm_hw_params_any(handle, hwparams);
194
195         err = snd_pcm_hw_params_set_access(handle, hwparams, SND_PCM_ACCESS_RW_INTERLEAVED);
196         if (err < 0)
197                 ast_log(LOG_ERROR, "set_access failed: %s\n", snd_strerror(err));
198
199         err = snd_pcm_hw_params_set_format(handle, hwparams, format);
200         if (err < 0)
201                 ast_log(LOG_ERROR, "set_format failed: %s\n", snd_strerror(err));
202
203         err = snd_pcm_hw_params_set_channels(handle, hwparams, 1);
204         if (err < 0)
205                 ast_log(LOG_ERROR, "set_channels failed: %s\n", snd_strerror(err));
206
207         direction = 0;
208         err = snd_pcm_hw_params_set_rate_near(handle, hwparams, &rate, &direction);
209         if (rate != DESIRED_RATE)
210                 ast_log(LOG_WARNING, "Rate not correct, requested %d, got %d\n", DESIRED_RATE, rate);
211
212         direction = 0;
213         err = snd_pcm_hw_params_set_period_size_near(handle, hwparams, &period_size, &direction);
214         if (err < 0)
215                 ast_log(LOG_ERROR, "period_size(%ld frames) is bad: %s\n", period_size, snd_strerror(err));
216         else {
217                 ast_debug(1, "Period size is %d\n", err);
218         }
219
220         buffer_size = 4096 * 2;         /* period_size * 16; */
221         err = snd_pcm_hw_params_set_buffer_size_near(handle, hwparams, &buffer_size);
222         if (err < 0)
223                 ast_log(LOG_WARNING, "Problem setting buffer size of %ld: %s\n", buffer_size, snd_strerror(err));
224         else {
225                 ast_debug(1, "Buffer size is set to %d frames\n", err);
226         }
227
228         err = snd_pcm_hw_params(handle, hwparams);
229         if (err < 0)
230                 ast_log(LOG_ERROR, "Couldn't set the new hw params: %s\n", snd_strerror(err));
231
232         swparams = ast_alloca(snd_pcm_sw_params_sizeof());
233         memset(swparams, 0, snd_pcm_sw_params_sizeof());
234         snd_pcm_sw_params_current(handle, swparams);
235
236         if (stream == SND_PCM_STREAM_PLAYBACK)
237                 start_threshold = period_size;
238         else
239                 start_threshold = 1;
240
241         err = snd_pcm_sw_params_set_start_threshold(handle, swparams, start_threshold);
242         if (err < 0)
243                 ast_log(LOG_ERROR, "start threshold: %s\n", snd_strerror(err));
244
245         if (stream == SND_PCM_STREAM_PLAYBACK)
246                 stop_threshold = buffer_size;
247         else
248                 stop_threshold = buffer_size;
249
250         err = snd_pcm_sw_params_set_stop_threshold(handle, swparams, stop_threshold);
251         if (err < 0)
252                 ast_log(LOG_ERROR, "stop threshold: %s\n", snd_strerror(err));
253
254         err = snd_pcm_sw_params(handle, swparams);
255         if (err < 0)
256                 ast_log(LOG_ERROR, "sw_params: %s\n", snd_strerror(err));
257
258         err = snd_pcm_poll_descriptors_count(handle);
259         if (err <= 0)
260                 ast_log(LOG_ERROR, "Unable to get a poll descriptors count, error is %s\n", snd_strerror(err));
261         if (err != 1) {
262                 ast_debug(1, "Can't handle more than one device\n");
263         }
264
265         snd_pcm_poll_descriptors(handle, &pfd, err);
266         ast_debug(1, "Acquired fd %d from the poll descriptor\n", pfd.fd);
267
268         if (stream == SND_PCM_STREAM_CAPTURE)
269                 readdev = pfd.fd;
270         else
271                 writedev = pfd.fd;
272
273         return handle;
274 }
275
276 static int soundcard_init(void)
277 {
278         if (!noaudiocapture) {
279                 alsa.icard = alsa_card_init(indevname, SND_PCM_STREAM_CAPTURE);
280                 if (!alsa.icard) {
281                         ast_log(LOG_ERROR, "Problem opening alsa capture device\n");
282                         return -1;
283                 }
284         }
285
286         alsa.ocard = alsa_card_init(outdevname, SND_PCM_STREAM_PLAYBACK);
287
288         if (!alsa.ocard) {
289                 ast_log(LOG_ERROR, "Problem opening ALSA playback device\n");
290                 return -1;
291         }
292
293         return writedev;
294 }
295
296 static int alsa_digit(struct ast_channel *c, char digit, unsigned int duration)
297 {
298         ast_mutex_lock(&alsalock);
299         ast_verbose(" << Console Received digit %c of duration %u ms >> \n", 
300                 digit, duration);
301         ast_mutex_unlock(&alsalock);
302
303         return 0;
304 }
305
306 static int alsa_text(struct ast_channel *c, const char *text)
307 {
308         ast_mutex_lock(&alsalock);
309         ast_verbose(" << Console Received text %s >> \n", text);
310         ast_mutex_unlock(&alsalock);
311
312         return 0;
313 }
314
315 static void grab_owner(void)
316 {
317         while (alsa.owner && ast_channel_trylock(alsa.owner)) {
318                 DEADLOCK_AVOIDANCE(&alsalock);
319         }
320 }
321
322 static int alsa_call(struct ast_channel *c, const char *dest, int timeout)
323 {
324         struct ast_frame f = { AST_FRAME_CONTROL };
325
326         ast_mutex_lock(&alsalock);
327         ast_verbose(" << Call placed to '%s' on console >> \n", dest);
328         if (autoanswer) {
329                 ast_verbose(" << Auto-answered >> \n");
330                 if (mute) {
331                         ast_verbose( " << Muted >> \n" );
332                 }
333                 grab_owner();
334                 if (alsa.owner) {
335                         f.subclass.integer = AST_CONTROL_ANSWER;
336                         ast_queue_frame(alsa.owner, &f);
337                         ast_channel_unlock(alsa.owner);
338                 }
339         } else {
340                 ast_verbose(" << Type 'answer' to answer, or use 'autoanswer' for future calls >> \n");
341                 grab_owner();
342                 if (alsa.owner) {
343                         f.subclass.integer = AST_CONTROL_RINGING;
344                         ast_queue_frame(alsa.owner, &f);
345                         ast_channel_unlock(alsa.owner);
346                         ast_indicate(alsa.owner, AST_CONTROL_RINGING);
347                 }
348         }
349         if (!noaudiocapture) {
350                 snd_pcm_prepare(alsa.icard);
351                 snd_pcm_start(alsa.icard);
352         }
353         ast_mutex_unlock(&alsalock);
354
355         return 0;
356 }
357
358 static int alsa_answer(struct ast_channel *c)
359 {
360         ast_mutex_lock(&alsalock);
361         ast_verbose(" << Console call has been answered >> \n");
362         ast_setstate(c, AST_STATE_UP);
363         if (!noaudiocapture) {
364                 snd_pcm_prepare(alsa.icard);
365                 snd_pcm_start(alsa.icard);
366         }
367         ast_mutex_unlock(&alsalock);
368
369         return 0;
370 }
371
372 static int alsa_hangup(struct ast_channel *c)
373 {
374         ast_mutex_lock(&alsalock);
375         ast_channel_tech_pvt_set(c, NULL);
376         alsa.owner = NULL;
377         ast_verbose(" << Hangup on console >> \n");
378         ast_module_unref(ast_module_info->self);
379         hookstate = 0;
380         if (!noaudiocapture) {
381                 snd_pcm_drop(alsa.icard);
382         }
383         ast_mutex_unlock(&alsalock);
384
385         return 0;
386 }
387
388 static int alsa_write(struct ast_channel *chan, struct ast_frame *f)
389 {
390         static char sizbuf[8000];
391         static int sizpos = 0;
392         int len = sizpos;
393         int res = 0;
394         /* size_t frames = 0; */
395         snd_pcm_state_t state;
396
397         ast_mutex_lock(&alsalock);
398
399         /* We have to digest the frame in 160-byte portions */
400         if (f->datalen > sizeof(sizbuf) - sizpos) {
401                 ast_log(LOG_WARNING, "Frame too large\n");
402                 res = -1;
403         } else {
404                 memcpy(sizbuf + sizpos, f->data.ptr, f->datalen);
405                 len += f->datalen;
406                 state = snd_pcm_state(alsa.ocard);
407                 if (state == SND_PCM_STATE_XRUN)
408                         snd_pcm_prepare(alsa.ocard);
409                 while ((res = snd_pcm_writei(alsa.ocard, sizbuf, len / 2)) == -EAGAIN) {
410                         usleep(1);
411                 }
412                 if (res == -EPIPE) {
413 #if DEBUG
414                         ast_debug(1, "XRUN write\n");
415 #endif
416                         snd_pcm_prepare(alsa.ocard);
417                         while ((res = snd_pcm_writei(alsa.ocard, sizbuf, len / 2)) == -EAGAIN) {
418                                 usleep(1);
419                         }
420                         if (res != len / 2) {
421                                 ast_log(LOG_ERROR, "Write error: %s\n", snd_strerror(res));
422                                 res = -1;
423                         } else if (res < 0) {
424                                 ast_log(LOG_ERROR, "Write error %s\n", snd_strerror(res));
425                                 res = -1;
426                         }
427                 } else {
428                         if (res == -ESTRPIPE)
429                                 ast_log(LOG_ERROR, "You've got some big problems\n");
430                         else if (res < 0)
431                                 ast_log(LOG_NOTICE, "Error %d on write\n", res);
432                 }
433         }
434         ast_mutex_unlock(&alsalock);
435
436         return res >= 0 ? 0 : res;
437 }
438
439
440 static struct ast_frame *alsa_read(struct ast_channel *chan)
441 {
442         static struct ast_frame f;
443         static short __buf[FRAME_SIZE + AST_FRIENDLY_OFFSET / 2];
444         short *buf;
445         static int readpos = 0;
446         static int left = FRAME_SIZE;
447         snd_pcm_state_t state;
448         int r = 0;
449
450         ast_mutex_lock(&alsalock);
451         f.frametype = AST_FRAME_NULL;
452         f.subclass.integer = 0;
453         f.samples = 0;
454         f.datalen = 0;
455         f.data.ptr = NULL;
456         f.offset = 0;
457         f.src = "Console";
458         f.mallocd = 0;
459         f.delivery.tv_sec = 0;
460         f.delivery.tv_usec = 0;
461
462         if (noaudiocapture) {
463                 /* Return null frame to asterisk*/
464                 ast_mutex_unlock(&alsalock);
465                 return &f;
466         }
467
468         state = snd_pcm_state(alsa.icard);
469         if ((state != SND_PCM_STATE_PREPARED) && (state != SND_PCM_STATE_RUNNING)) {
470                 snd_pcm_prepare(alsa.icard);
471         }
472
473         buf = __buf + AST_FRIENDLY_OFFSET / 2;
474
475         r = snd_pcm_readi(alsa.icard, buf + readpos, left);
476         if (r == -EPIPE) {
477 #if DEBUG
478                 ast_log(LOG_ERROR, "XRUN read\n");
479 #endif
480                 snd_pcm_prepare(alsa.icard);
481         } else if (r == -ESTRPIPE) {
482                 ast_log(LOG_ERROR, "-ESTRPIPE\n");
483                 snd_pcm_prepare(alsa.icard);
484         } else if (r < 0) {
485                 ast_log(LOG_ERROR, "Read error: %s\n", snd_strerror(r));
486         }
487         /* Update positions */
488         readpos += r;
489         left -= r;
490
491         if (readpos >= FRAME_SIZE) {
492                 /* A real frame */
493                 readpos = 0;
494                 left = FRAME_SIZE;
495                 if (ast_channel_state(chan) != AST_STATE_UP) {
496                         /* Don't transmit unless it's up */
497                         ast_mutex_unlock(&alsalock);
498                         return &f;
499                 }
500                 if (mute) {
501                         /* Don't transmit if muted */
502                         ast_mutex_unlock(&alsalock);
503                         return &f;
504                 }
505
506                 f.frametype = AST_FRAME_VOICE;
507                 ast_format_set(&f.subclass.format, AST_FORMAT_SLINEAR, 0);
508                 f.samples = FRAME_SIZE;
509                 f.datalen = FRAME_SIZE * 2;
510                 f.data.ptr = buf;
511                 f.offset = AST_FRIENDLY_OFFSET;
512                 f.src = "Console";
513                 f.mallocd = 0;
514
515         }
516         ast_mutex_unlock(&alsalock);
517
518         return &f;
519 }
520
521 static int alsa_fixup(struct ast_channel *oldchan, struct ast_channel *newchan)
522 {
523         struct chan_alsa_pvt *p = ast_channel_tech_pvt(newchan);
524
525         ast_mutex_lock(&alsalock);
526         p->owner = newchan;
527         ast_mutex_unlock(&alsalock);
528
529         return 0;
530 }
531
532 static int alsa_indicate(struct ast_channel *chan, int cond, const void *data, size_t datalen)
533 {
534         int res = 0;
535
536         ast_mutex_lock(&alsalock);
537
538         switch (cond) {
539         case AST_CONTROL_BUSY:
540         case AST_CONTROL_CONGESTION:
541         case AST_CONTROL_RINGING:
542         case AST_CONTROL_INCOMPLETE:
543         case AST_CONTROL_PVT_CAUSE_CODE:
544         case -1:
545                 res = -1;  /* Ask for inband indications */
546                 break;
547         case AST_CONTROL_PROGRESS:
548         case AST_CONTROL_PROCEEDING:
549         case AST_CONTROL_VIDUPDATE:
550         case AST_CONTROL_SRCUPDATE:
551                 break;
552         case AST_CONTROL_HOLD:
553                 ast_verbose(" << Console Has Been Placed on Hold >> \n");
554                 ast_moh_start(chan, data, mohinterpret);
555                 break;
556         case AST_CONTROL_UNHOLD:
557                 ast_verbose(" << Console Has Been Retrieved from Hold >> \n");
558                 ast_moh_stop(chan);
559                 break;
560         default:
561                 ast_log(LOG_WARNING, "Don't know how to display condition %d on %s\n", cond, ast_channel_name(chan));
562                 res = -1;
563         }
564
565         ast_mutex_unlock(&alsalock);
566
567         return res;
568 }
569
570 static struct ast_channel *alsa_new(struct chan_alsa_pvt *p, int state, const char *linkedid)
571 {
572         struct ast_channel *tmp = NULL;
573
574         if (!(tmp = ast_channel_alloc(1, state, 0, 0, "", p->exten, p->context, linkedid, 0, "ALSA/%s", indevname)))
575                 return NULL;
576
577         ast_channel_tech_set(tmp, &alsa_tech);
578         ast_channel_set_fd(tmp, 0, readdev);
579         ast_format_set(ast_channel_readformat(tmp), AST_FORMAT_SLINEAR, 0);
580         ast_format_set(ast_channel_writeformat(tmp), AST_FORMAT_SLINEAR, 0);
581         ast_format_cap_add(ast_channel_nativeformats(tmp), ast_channel_writeformat(tmp));
582
583         ast_channel_tech_pvt_set(tmp, p);
584         if (!ast_strlen_zero(p->context))
585                 ast_channel_context_set(tmp, p->context);
586         if (!ast_strlen_zero(p->exten))
587                 ast_channel_exten_set(tmp, p->exten);
588         if (!ast_strlen_zero(language))
589                 ast_channel_language_set(tmp, language);
590         p->owner = tmp;
591         ast_module_ref(ast_module_info->self);
592         ast_jb_configure(tmp, &global_jbconf);
593         if (state != AST_STATE_DOWN) {
594                 if (ast_pbx_start(tmp)) {
595                         ast_log(LOG_WARNING, "Unable to start PBX on %s\n", ast_channel_name(tmp));
596                         ast_hangup(tmp);
597                         tmp = NULL;
598                 }
599         }
600
601         return tmp;
602 }
603
604 static struct ast_channel *alsa_request(const char *type, struct ast_format_cap *cap, const struct ast_channel *requestor, const char *data, int *cause)
605 {
606         struct ast_format tmpfmt;
607         char buf[256];
608         struct ast_channel *tmp = NULL;
609
610         ast_format_set(&tmpfmt, AST_FORMAT_SLINEAR, 0);
611
612         if (!(ast_format_cap_iscompatible(cap, &tmpfmt))) {
613                 ast_log(LOG_NOTICE, "Asked to get a channel of format '%s'\n", ast_getformatname_multiple(buf, sizeof(buf), cap));
614                 return NULL;
615         }
616
617         ast_mutex_lock(&alsalock);
618
619         if (alsa.owner) {
620                 ast_log(LOG_NOTICE, "Already have a call on the ALSA channel\n");
621                 *cause = AST_CAUSE_BUSY;
622         } else if (!(tmp = alsa_new(&alsa, AST_STATE_DOWN, requestor ? ast_channel_linkedid(requestor) : NULL))) {
623                 ast_log(LOG_WARNING, "Unable to create new ALSA channel\n");
624         }
625
626         ast_mutex_unlock(&alsalock);
627
628         return tmp;
629 }
630
631 static char *autoanswer_complete(const char *line, const char *word, int pos, int state)
632 {
633         switch (state) {
634                 case 0:
635                         if (!ast_strlen_zero(word) && !strncasecmp(word, "on", MIN(strlen(word), 2)))
636                                 return ast_strdup("on");
637                 case 1:
638                         if (!ast_strlen_zero(word) && !strncasecmp(word, "off", MIN(strlen(word), 3)))
639                                 return ast_strdup("off");
640                 default:
641                         return NULL;
642         }
643
644         return NULL;
645 }
646
647 static char *console_autoanswer(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
648 {
649         char *res = CLI_SUCCESS;
650
651         switch (cmd) {
652         case CLI_INIT:
653                 e->command = "console autoanswer";
654                 e->usage =
655                         "Usage: console autoanswer [on|off]\n"
656                         "       Enables or disables autoanswer feature.  If used without\n"
657                         "       argument, displays the current on/off status of autoanswer.\n"
658                         "       The default value of autoanswer is in 'alsa.conf'.\n";
659                 return NULL;
660         case CLI_GENERATE:
661                 return autoanswer_complete(a->line, a->word, a->pos, a->n);
662         }
663
664         if ((a->argc != 2) && (a->argc != 3))
665                 return CLI_SHOWUSAGE;
666
667         ast_mutex_lock(&alsalock);
668         if (a->argc == 2) {
669                 ast_cli(a->fd, "Auto answer is %s.\n", autoanswer ? "on" : "off");
670         } else {
671                 if (!strcasecmp(a->argv[2], "on"))
672                         autoanswer = -1;
673                 else if (!strcasecmp(a->argv[2], "off"))
674                         autoanswer = 0;
675                 else
676                         res = CLI_SHOWUSAGE;
677         }
678         ast_mutex_unlock(&alsalock);
679
680         return res;
681 }
682
683 static char *console_answer(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
684 {
685         char *res = CLI_SUCCESS;
686
687         switch (cmd) {
688         case CLI_INIT:
689                 e->command = "console answer";
690                 e->usage =
691                         "Usage: console answer\n"
692                         "       Answers an incoming call on the console (ALSA) channel.\n";
693
694                 return NULL;
695         case CLI_GENERATE:
696                 return NULL; 
697         }
698
699         if (a->argc != 2)
700                 return CLI_SHOWUSAGE;
701
702         ast_mutex_lock(&alsalock);
703
704         if (!alsa.owner) {
705                 ast_cli(a->fd, "No one is calling us\n");
706                 res = CLI_FAILURE;
707         } else {
708                 if (mute) {
709                         ast_verbose( " << Muted >> \n" );
710                 }
711                 hookstate = 1;
712                 grab_owner();
713                 if (alsa.owner) {
714                         ast_queue_control(alsa.owner, AST_CONTROL_ANSWER);
715                         ast_channel_unlock(alsa.owner);
716                 }
717         }
718
719         if (!noaudiocapture) {
720                 snd_pcm_prepare(alsa.icard);
721                 snd_pcm_start(alsa.icard);
722         }
723
724         ast_mutex_unlock(&alsalock);
725
726         return res;
727 }
728
729 static char *console_sendtext(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
730 {
731         int tmparg = 3;
732         char *res = CLI_SUCCESS;
733
734         switch (cmd) {
735         case CLI_INIT:
736                 e->command = "console send text";
737                 e->usage =
738                         "Usage: console send text <message>\n"
739                         "       Sends a text message for display on the remote terminal.\n";
740                 return NULL;
741         case CLI_GENERATE:
742                 return NULL; 
743         }
744
745         if (a->argc < 3)
746                 return CLI_SHOWUSAGE;
747
748         ast_mutex_lock(&alsalock);
749
750         if (!alsa.owner) {
751                 ast_cli(a->fd, "No channel active\n");
752                 res = CLI_FAILURE;
753         } else {
754                 struct ast_frame f = { AST_FRAME_TEXT };
755                 char text2send[256] = "";
756
757                 while (tmparg < a->argc) {
758                         strncat(text2send, a->argv[tmparg++], sizeof(text2send) - strlen(text2send) - 1);
759                         strncat(text2send, " ", sizeof(text2send) - strlen(text2send) - 1);
760                 }
761
762                 text2send[strlen(text2send) - 1] = '\n';
763                 f.data.ptr = text2send;
764                 f.datalen = strlen(text2send) + 1;
765                 grab_owner();
766                 if (alsa.owner) {
767                         ast_queue_frame(alsa.owner, &f);
768                         ast_queue_control(alsa.owner, AST_CONTROL_ANSWER);
769                         ast_channel_unlock(alsa.owner);
770                 }
771         }
772
773         ast_mutex_unlock(&alsalock);
774
775         return res;
776 }
777
778 static char *console_hangup(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
779 {
780         char *res = CLI_SUCCESS;
781
782         switch (cmd) {
783         case CLI_INIT:
784                 e->command = "console hangup";
785                 e->usage =
786                         "Usage: console hangup\n"
787                         "       Hangs up any call currently placed on the console.\n";
788                 return NULL;
789         case CLI_GENERATE:
790                 return NULL; 
791         }
792  
793
794         if (a->argc != 2)
795                 return CLI_SHOWUSAGE;
796
797         ast_mutex_lock(&alsalock);
798
799         if (!alsa.owner && !hookstate) {
800                 ast_cli(a->fd, "No call to hangup\n");
801                 res = CLI_FAILURE;
802         } else {
803                 hookstate = 0;
804                 grab_owner();
805                 if (alsa.owner) {
806                         ast_queue_hangup_with_cause(alsa.owner, AST_CAUSE_NORMAL_CLEARING);
807                         ast_channel_unlock(alsa.owner);
808                 }
809         }
810
811         ast_mutex_unlock(&alsalock);
812
813         return res;
814 }
815
816 static char *console_dial(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
817 {
818         char tmp[256], *tmp2;
819         char *mye, *myc;
820         const char *d;
821         char *res = CLI_SUCCESS;
822
823         switch (cmd) {
824         case CLI_INIT:
825                 e->command = "console dial";
826                 e->usage =
827                         "Usage: console dial [extension[@context]]\n"
828                         "       Dials a given extension (and context if specified)\n";
829                 return NULL;
830         case CLI_GENERATE:
831                 return NULL;
832         }
833
834         if ((a->argc != 2) && (a->argc != 3))
835                 return CLI_SHOWUSAGE;
836
837         ast_mutex_lock(&alsalock);
838
839         if (alsa.owner) {
840                 if (a->argc == 3) {
841                         if (alsa.owner) {
842                                 for (d = a->argv[2]; *d; d++) {
843                                         struct ast_frame f = { .frametype = AST_FRAME_DTMF, .subclass.integer = *d };
844
845                                         ast_queue_frame(alsa.owner, &f);
846                                 }
847                         }
848                 } else {
849                         ast_cli(a->fd, "You're already in a call.  You can use this only to dial digits until you hangup\n");
850                         res = CLI_FAILURE;
851                 }
852         } else {
853                 mye = exten;
854                 myc = context;
855                 if (a->argc == 3) {
856                         char *stringp = NULL;
857
858                         ast_copy_string(tmp, a->argv[2], sizeof(tmp));
859                         stringp = tmp;
860                         strsep(&stringp, "@");
861                         tmp2 = strsep(&stringp, "@");
862                         if (!ast_strlen_zero(tmp))
863                                 mye = tmp;
864                         if (!ast_strlen_zero(tmp2))
865                                 myc = tmp2;
866                 }
867                 if (ast_exists_extension(NULL, myc, mye, 1, NULL)) {
868                         ast_copy_string(alsa.exten, mye, sizeof(alsa.exten));
869                         ast_copy_string(alsa.context, myc, sizeof(alsa.context));
870                         hookstate = 1;
871                         alsa_new(&alsa, AST_STATE_RINGING, NULL);
872                 } else
873                         ast_cli(a->fd, "No such extension '%s' in context '%s'\n", mye, myc);
874         }
875
876         ast_mutex_unlock(&alsalock);
877
878         return res;
879 }
880
881 static char *console_mute(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
882 {
883         int toggle = 0;
884         char *res = CLI_SUCCESS;
885
886         switch (cmd) {
887         case CLI_INIT:
888                 e->command = "console {mute|unmute} [toggle]";
889                 e->usage =
890                         "Usage: console {mute|unmute} [toggle]\n"
891                         "       Mute/unmute the microphone.\n";
892                 return NULL;
893         case CLI_GENERATE:
894                 return NULL;
895         }
896
897
898         if (a->argc > 3) {
899                 return CLI_SHOWUSAGE;
900         }
901
902         if (a->argc == 3) {
903                 if (strcasecmp(a->argv[2], "toggle"))
904                         return CLI_SHOWUSAGE;
905                 toggle = 1;
906         }
907
908         if (a->argc < 2) {
909                 return CLI_SHOWUSAGE;
910         }
911
912         if (!strcasecmp(a->argv[1], "mute")) {
913                 mute = toggle ? !mute : 1;
914         } else if (!strcasecmp(a->argv[1], "unmute")) {
915                 mute = toggle ? !mute : 0;
916         } else {
917                 return CLI_SHOWUSAGE;
918         }
919
920         ast_cli(a->fd, "Console mic is %s\n", mute ? "off" : "on");
921
922         return res;
923 }
924
925 static struct ast_cli_entry cli_alsa[] = {
926         AST_CLI_DEFINE(console_answer, "Answer an incoming console call"),
927         AST_CLI_DEFINE(console_hangup, "Hangup a call on the console"),
928         AST_CLI_DEFINE(console_dial, "Dial an extension on the console"),
929         AST_CLI_DEFINE(console_sendtext, "Send text to the remote device"),
930         AST_CLI_DEFINE(console_autoanswer, "Sets/displays autoanswer"),
931         AST_CLI_DEFINE(console_mute, "Disable/Enable mic input"),
932 };
933
934 /*!
935  * \brief Load the module
936  *
937  * Module loading including tests for configuration or dependencies.
938  * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE,
939  * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails
940  * tests return AST_MODULE_LOAD_FAILURE. If the module can not load the 
941  * configuration file or other non-critical problem return 
942  * AST_MODULE_LOAD_DECLINE. On success return AST_MODULE_LOAD_SUCCESS.
943  */
944 static int load_module(void)
945 {
946         struct ast_config *cfg;
947         struct ast_variable *v;
948         struct ast_flags config_flags = { 0 };
949         struct ast_format tmpfmt;
950
951         if (!(alsa_tech.capabilities = ast_format_cap_alloc())) {
952                 return AST_MODULE_LOAD_DECLINE;
953         }
954         ast_format_cap_add(alsa_tech.capabilities, ast_format_set(&tmpfmt, AST_FORMAT_SLINEAR, 0));
955
956         /* Copy the default jb config over global_jbconf */
957         memcpy(&global_jbconf, &default_jbconf, sizeof(struct ast_jb_conf));
958
959         strcpy(mohinterpret, "default");
960
961         if (!(cfg = ast_config_load(config, config_flags))) {
962                 ast_log(LOG_ERROR, "Unable to read ALSA configuration file %s.  Aborting.\n", config);
963                 return AST_MODULE_LOAD_DECLINE;
964         } else if (cfg == CONFIG_STATUS_FILEINVALID) {
965                 ast_log(LOG_ERROR, "%s is in an invalid format.  Aborting.\n", config);
966                 return AST_MODULE_LOAD_DECLINE;
967         }
968
969         v = ast_variable_browse(cfg, "general");
970         for (; v; v = v->next) {
971                 /* handle jb conf */
972                 if (!ast_jb_read_conf(&global_jbconf, v->name, v->value)) {
973                         continue;
974                 }
975
976                 if (!strcasecmp(v->name, "autoanswer")) {
977                         autoanswer = ast_true(v->value);
978                 } else if (!strcasecmp(v->name, "mute")) {
979                         mute = ast_true(v->value);
980                 } else if (!strcasecmp(v->name, "noaudiocapture")) {
981                         noaudiocapture = ast_true(v->value);
982                 } else if (!strcasecmp(v->name, "silencesuppression")) {
983                         silencesuppression = ast_true(v->value);
984                 } else if (!strcasecmp(v->name, "silencethreshold")) {
985                         silencethreshold = atoi(v->value);
986                 } else if (!strcasecmp(v->name, "context")) {
987                         ast_copy_string(context, v->value, sizeof(context));
988                 } else if (!strcasecmp(v->name, "language")) {
989                         ast_copy_string(language, v->value, sizeof(language));
990                 } else if (!strcasecmp(v->name, "extension")) {
991                         ast_copy_string(exten, v->value, sizeof(exten));
992                 } else if (!strcasecmp(v->name, "input_device")) {
993                         ast_copy_string(indevname, v->value, sizeof(indevname));
994                 } else if (!strcasecmp(v->name, "output_device")) {
995                         ast_copy_string(outdevname, v->value, sizeof(outdevname));
996                 } else if (!strcasecmp(v->name, "mohinterpret")) {
997                         ast_copy_string(mohinterpret, v->value, sizeof(mohinterpret));
998                 }
999         }
1000         ast_config_destroy(cfg);
1001
1002         if (soundcard_init() < 0) {
1003                 ast_verb(2, "No sound card detected -- console channel will be unavailable\n");
1004                 ast_verb(2, "Turn off ALSA support by adding 'noload=chan_alsa.so' in /etc/asterisk/modules.conf\n");
1005                 return AST_MODULE_LOAD_DECLINE;
1006         }
1007
1008         if (ast_channel_register(&alsa_tech)) {
1009                 ast_log(LOG_ERROR, "Unable to register channel class 'Console'\n");
1010                 return AST_MODULE_LOAD_FAILURE;
1011         }
1012
1013         ast_cli_register_multiple(cli_alsa, ARRAY_LEN(cli_alsa));
1014
1015         return AST_MODULE_LOAD_SUCCESS;
1016 }
1017
1018 static int unload_module(void)
1019 {
1020         ast_channel_unregister(&alsa_tech);
1021         ast_cli_unregister_multiple(cli_alsa, ARRAY_LEN(cli_alsa));
1022
1023         if (alsa.icard)
1024                 snd_pcm_close(alsa.icard);
1025         if (alsa.ocard)
1026                 snd_pcm_close(alsa.ocard);
1027         if (alsa.owner)
1028                 ast_softhangup(alsa.owner, AST_SOFTHANGUP_APPUNLOAD);
1029         if (alsa.owner)
1030                 return -1;
1031
1032         alsa_tech.capabilities = ast_format_cap_destroy(alsa_tech.capabilities);
1033         return 0;
1034 }
1035
1036 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "ALSA Console Channel Driver",
1037                 .load = load_module,
1038                 .unload = unload_module,
1039                 .load_pri = AST_MODPRI_CHANNEL_DRIVER,
1040         );