use auto-build for cdr modules
[asterisk/asterisk.git] / channels / chan_oss.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2005, Digium, Inc.
5  *
6  * Mark Spencer <markster@digium.com>
7  *
8  * FreeBSD changes and multiple device support by Luigi Rizzo, 2005.05.25
9  * note-this code best seen with ts=8 (8-spaces tabs) in the editor
10  *
11  * See http://www.asterisk.org for more information about
12  * the Asterisk project. Please do not directly contact
13  * any of the maintainers of this project for assistance;
14  * the project provides a web site, mailing lists and IRC
15  * channels for your use.
16  *
17  * This program is free software, distributed under the terms of
18  * the GNU General Public License Version 2. See the LICENSE file
19  * at the top of the source tree.
20  */
21
22 /*! \file
23  *
24  * \brief Channel driver for OSS sound cards
25  *
26  * \author Mark Spencer <markster@digium.com>
27  * \author Luigi Rizzo
28  *
29  * \par See also
30  * \arg \ref Config_oss
31  *
32  * \ingroup channel_drivers
33  */
34
35 #include <stdio.h>
36 #include <ctype.h>      /* for isalnum */
37 #include <math.h>       /* exp and log */
38 #include <string.h>
39 #include <unistd.h>
40 #include <sys/ioctl.h>
41 #include <fcntl.h>
42 #include <sys/time.h>
43 #include <stdlib.h>
44 #include <errno.h>
45
46
47 #ifdef __linux
48 #include <linux/soundcard.h>
49 #elif defined(__FreeBSD__)
50 #include <sys/soundcard.h>
51 #else
52 #include <soundcard.h>
53 #endif
54
55 #include "asterisk.h"
56
57 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
58
59 #include "asterisk/lock.h"
60 #include "asterisk/frame.h"
61 #include "asterisk/logger.h"
62 #include "asterisk/callerid.h"  /* for ast_callerid_split() */
63 #include "asterisk/channel.h"
64 #include "asterisk/module.h"
65 #include "asterisk/options.h"
66 #include "asterisk/pbx.h"
67 #include "asterisk/config.h"
68
69 #include "asterisk/cli.h"
70 #include "asterisk/utils.h"
71 #include "asterisk/causes.h"
72 #include "asterisk/endian.h"
73 #include "asterisk/stringfields.h"
74
75 /* ringtones we use */
76 #include "busy.h"
77 #include "ringtone.h"
78 #include "ring10.h"
79 #include "answer.h"
80
81 /*
82  * Basic mode of operation:
83  *
84  * we have one keyboard (which receives commands from the keyboard)
85  * and multiple headset's connected to audio cards.
86  * Cards/Headsets are named as the sections of oss.conf.
87  * The section called [general] contains the default parameters.
88  *
89  * At any time, the keyboard is attached to one card, and you
90  * can switch among them using the command 'console foo'
91  * where 'foo' is the name of the card you want.
92  *
93  * oss.conf parameters are
94 START_CONFIG
95
96 [general]
97 ; general config options, default values are shown
98 ; all but debug can go also in the device-specific sections.
99 ; debug=0x0             ; misc debug flags, default is 0
100
101 [card1]
102 ; autoanswer = no       ; no autoanswer on call
103 ; autohangup = yes      ; hangup when other party closes
104 ; extension=s           ; default extension to call
105 ; context=default       ; default context
106 ; language=""           ; default language
107 ; overridecontext=yes   ; the whole dial string is considered an extension.
108                         ; if no, the last @ will start the context
109
110 ; device=/dev/dsp       ; device to open
111 ; mixer="-f /dev/mixer0 pcm 80 ; mixer command to run on start
112 ; queuesize=10          ; frames in device driver
113 ; frags=8               ; argument to SETFRAGMENT
114 ; boost = n             ; mic volume boost in dB
115
116 END_CONFIG
117
118 .. and so on for the other cards.
119
120  */
121
122 /*
123  * Helper macros to parse config arguments. They will go in a common
124  * header file if their usage is globally accepted. In the meantime,
125  * we define them here. Typical usage is as below.
126  * Remember to open a block right before M_START (as it declares
127  * some variables) and use the M_* macros WITHOUT A SEMICOLON:
128  *
129  *      {
130  *              M_START(v->name, v->value) 
131  *
132  *              M_BOOL("dothis", x->flag1)
133  *              M_STR("name", x->somestring)
134  *              M_F("bar", some_c_code)
135  *              M_END(some_final_statement)
136  *              ... other code in the block
137  *      }
138  *
139  * XXX NOTE these macros should NOT be replicated in other parts of asterisk. 
140  * Likely we will come up with a better way of doing config file parsing.
141  */
142 #define M_START(var, val) \
143         char *__s = var; char *__val = val;
144 #define M_END(x)   x;
145 #define M_F(tag, f)                     if (!strcasecmp((__s), tag)) { f; } else
146 #define M_BOOL(tag, dst)        M_F(tag, (dst) = ast_true(__val) )
147 #define M_UINT(tag, dst)        M_F(tag, (dst) = strtoul(__val, NULL, 0) )
148 #define M_STR(tag, dst)         M_F(tag, ast_copy_string(dst, __val, sizeof(dst)))
149
150 /*
151  * The following parameters are used in the driver:
152  *
153  *  FRAME_SIZE  the size of an audio frame, in samples.
154  *              160 is used almost universally, so you should not change it.
155  *
156  *  FRAGS       the argument for the SETFRAGMENT ioctl.
157  *              Overridden by the 'frags' parameter in oss.conf
158  *
159  *              Bits 0-7 are the base-2 log of the device's block size,
160  *              bits 16-31 are the number of blocks in the driver's queue.
161  *              There are a lot of differences in the way this parameter
162  *              is supported by different drivers, so you may need to
163  *              experiment a bit with the value.
164  *              A good default for linux is 30 blocks of 64 bytes, which
165  *              results in 6 frames of 320 bytes (160 samples).
166  *              FreeBSD works decently with blocks of 256 or 512 bytes,
167  *              leaving the number unspecified.
168  *              Note that this only refers to the device buffer size,
169  *              this module will then try to keep the lenght of audio
170  *              buffered within small constraints.
171  *
172  *  QUEUE_SIZE  The max number of blocks actually allowed in the device
173  *              driver's buffer, irrespective of the available number.
174  *              Overridden by the 'queuesize' parameter in oss.conf
175  *
176  *              Should be >=2, and at most as large as the hw queue above
177  *              (otherwise it will never be full).
178  */
179
180 #define FRAME_SIZE      160
181 #define QUEUE_SIZE      10
182
183 #if defined(__FreeBSD__)
184 #define FRAGS   0x8
185 #else
186 #define FRAGS   ( ( (6 * 5) << 16 ) | 0x6 )
187 #endif
188
189 /*
190  * XXX text message sizes are probably 256 chars, but i am
191  * not sure if there is a suitable definition anywhere.
192  */
193 #define TEXT_SIZE       256
194
195 #if 0
196 #define TRYOPEN 1       /* try to open on startup */
197 #endif
198 #define O_CLOSE 0x444   /* special 'close' mode for device */
199 /* Which device to use */
200 #if defined( __OpenBSD__ ) || defined( __NetBSD__ )
201 #define DEV_DSP "/dev/audio"
202 #else
203 #define DEV_DSP "/dev/dsp"
204 #endif
205
206 #ifndef MIN
207 #define MIN(a,b) ((a) < (b) ? (a) : (b))
208 #endif
209 #ifndef MAX
210 #define MAX(a,b) ((a) > (b) ? (a) : (b))
211 #endif
212
213
214 static int usecnt;
215 AST_MUTEX_DEFINE_STATIC(usecnt_lock);
216
217 static char *config = "oss.conf";       /* default config file */
218
219 static int oss_debug;
220
221 /*
222  * Each sound is made of 'datalen' samples of sound, repeated as needed to
223  * generate 'samplen' samples of data, then followed by 'silencelen' samples
224  * of silence. The loop is repeated if 'repeat' is set.
225  */
226 struct sound {
227         int ind;
228         char *desc;
229         short *data;
230         int datalen;
231         int samplen;
232         int silencelen;
233         int repeat;
234 };
235
236 static struct sound sounds[] = {
237         { AST_CONTROL_RINGING, "RINGING", ringtone, sizeof(ringtone)/2, 16000, 32000, 1 },
238         { AST_CONTROL_BUSY, "BUSY", busy, sizeof(busy)/2, 4000, 4000, 1 },
239         { AST_CONTROL_CONGESTION, "CONGESTION", busy, sizeof(busy)/2, 2000, 2000, 1 },
240         { AST_CONTROL_RING, "RING10", ring10, sizeof(ring10)/2, 16000, 32000, 1 },
241         { AST_CONTROL_ANSWER, "ANSWER", answer, sizeof(answer)/2, 2200, 0, 0 },
242         { -1, NULL, 0, 0, 0, 0 },       /* end marker */
243 };
244
245
246 /*
247  * descriptor for one of our channels.
248  * There is one used for 'default' values (from the [general] entry in
249  * the configuration file), and then one instance for each device
250  * (the default is cloned from [general], others are only created
251  * if the relevant section exists).
252  */
253 struct chan_oss_pvt {
254         struct chan_oss_pvt *next;
255
256         char *name;
257         /*
258          * cursound indicates which in struct sound we play. -1 means nothing,
259          * any other value is a valid sound, in which case sampsent indicates
260          * the next sample to send in [0..samplen + silencelen]
261          * nosound is set to disable the audio data from the channel
262          * (so we can play the tones etc.).
263          */
264         int sndcmd[2]; /* Sound command pipe */
265         int cursound;   /* index of sound to send */
266         int sampsent;   /* # of sound samples sent      */
267         int nosound;    /* set to block audio from the PBX */
268
269         int total_blocks;       /* total blocks in the output device */
270         int sounddev;
271         enum { M_UNSET, M_FULL, M_READ, M_WRITE } duplex;
272         int autoanswer;
273         int autohangup;
274         int hookstate;
275         char *mixer_cmd;                /* initial command to issue to the mixer */
276         unsigned int    queuesize;      /* max fragments in queue */
277         unsigned int    frags;          /* parameter for SETFRAGMENT */
278
279         int warned;             /* various flags used for warnings */
280 #define WARN_used_blocks        1
281 #define WARN_speed              2
282 #define WARN_frag               4
283         int w_errors;   /* overfull in the write path */
284         struct timeval lastopen;
285
286         int overridecontext;
287         int mute;
288
289         /* boost support. BOOST_SCALE * 10 ^(BOOST_MAX/20) must
290          * be representable in 16 bits to avoid overflows.
291          */
292 #define BOOST_SCALE     (1<<9)
293 #define BOOST_MAX       40      /* slightly less than 7 bits */
294         int boost;      /* input boost, scaled by BOOST_SCALE */
295         char device[64];        /* device to open */
296
297         pthread_t sthread;
298
299         struct ast_channel *owner;
300         char ext[AST_MAX_EXTENSION];
301         char ctx[AST_MAX_CONTEXT];
302         char language[MAX_LANGUAGE];
303         char cid_name[256]; /*XXX */
304         char cid_num[256]; /*XXX */
305
306         /* buffers used in oss_write */
307         char oss_write_buf[FRAME_SIZE*2];
308         int oss_write_dst;
309         /* buffers used in oss_read - AST_FRIENDLY_OFFSET space for headers
310          * plus enough room for a full frame
311          */
312         char oss_read_buf[FRAME_SIZE * 2 + AST_FRIENDLY_OFFSET];
313         int readpos; /* read position above */
314         struct ast_frame read_f;        /* returned by oss_read */
315 };
316
317 static struct chan_oss_pvt oss_default = {
318         .cursound = -1,
319         .sounddev = -1,
320         .duplex = M_UNSET, /* XXX check this */
321         .autoanswer = 1,
322         .autohangup = 1,
323         .queuesize = QUEUE_SIZE,
324         .frags = FRAGS,
325         .ext = "s",
326         .ctx = "default",
327         .readpos = AST_FRIENDLY_OFFSET, /* start here on reads */
328         .lastopen = { 0, 0 },
329         .boost = BOOST_SCALE,
330 };
331
332 static char *oss_active;         /* the active device */
333
334 static int setformat(struct chan_oss_pvt *o, int mode);
335
336 static struct ast_channel *oss_request(const char *type, int format, void *data
337 , int *cause);
338 static int oss_digit(struct ast_channel *c, char digit);
339 static int oss_text(struct ast_channel *c, const char *text);
340 static int oss_hangup(struct ast_channel *c);
341 static int oss_answer(struct ast_channel *c);
342 static struct ast_frame *oss_read(struct ast_channel *chan);
343 static int oss_call(struct ast_channel *c, char *dest, int timeout);
344 static int oss_write(struct ast_channel *chan, struct ast_frame *f);
345 static int oss_indicate(struct ast_channel *chan, int cond);
346 static int oss_fixup(struct ast_channel *oldchan, struct ast_channel *newchan);
347
348 static const struct ast_channel_tech oss_tech = {
349         .type = "Console",
350         .description =  "OSS Console Channel Driver",
351         .capabilities = AST_FORMAT_SLINEAR,
352         .requester = oss_request,
353         .send_digit = oss_digit,
354         .send_text = oss_text,
355         .hangup = oss_hangup,
356         .answer = oss_answer,
357         .read = oss_read,
358         .call = oss_call,
359         .write = oss_write,
360         .indicate = oss_indicate,
361         .fixup = oss_fixup,
362 };
363
364 /*
365  * returns a pointer to the descriptor with the given name
366  */
367 static struct chan_oss_pvt *find_desc(char *dev)
368 {
369         struct chan_oss_pvt *o;
370         if (dev == NULL)
371                 ast_log(LOG_WARNING, "null dev\n");
372
373         for (o = oss_default.next; o && o->name && dev && strcmp(o->name, dev) != 0; o = o->next)
374                 ;
375         if (o == NULL)
376                 ast_log(LOG_WARNING, "could not find <%s>\n", dev ? dev : "--no-device--");
377         return o;
378 }
379
380 /*
381  * split a string in extension-context, returns pointers to malloc'ed
382  * strings.
383  * If we do not have 'overridecontext' then the last @ is considered as
384  * a context separator, and the context is overridden.
385  * This is usually not very necessary as you can play with the dialplan,
386  * and it is nice not to need it because you have '@' in SIP addresses.
387  * Return value is the buffer address.
388  */
389 static char *ast_ext_ctx(const char *src, char **ext, char **ctx)
390 {
391         struct chan_oss_pvt *o = find_desc(oss_active);
392
393         if (ext == NULL || ctx == NULL)
394                 return NULL;    /* error */
395         *ext = *ctx = NULL;
396         if (src && *src != '\0')
397                 *ext = ast_strdup(src);
398         if (*ext == NULL)
399                 return NULL;
400         if (!o->overridecontext) {
401                 /* parse from the right */
402                 *ctx = strrchr(*ext, '@');
403                 if (*ctx)
404                         *(*ctx)++ = '\0';
405         }
406         return *ext;
407 }
408
409 /*
410  * Returns the number of blocks used in the audio output channel
411  */
412 static int used_blocks(struct chan_oss_pvt *o)
413 {
414         struct audio_buf_info info;
415
416         if (ioctl(o->sounddev, SNDCTL_DSP_GETOSPACE, &info)) {
417                 if (! (o->warned & WARN_used_blocks)) {
418                         ast_log(LOG_WARNING, "Error reading output space\n");
419                         o->warned |= WARN_used_blocks;
420                 }
421                 return 1;
422         }
423         if (o->total_blocks == 0) {
424                 if (0) /* debugging */
425                         ast_log(LOG_WARNING, "fragtotal %d size %d avail %d\n",
426                             info.fragstotal,
427                             info.fragsize,
428                             info.fragments);
429                 o->total_blocks = info.fragments;
430         }
431         return o->total_blocks - info.fragments;
432 }
433
434 /* Write an exactly FRAME_SIZE sized frame */
435 static int soundcard_writeframe(struct chan_oss_pvt *o, short *data)
436 {       
437         int res;
438
439         if (o->sounddev < 0)
440                 setformat(o, O_RDWR);
441         if (o->sounddev < 0)
442                 return 0;       /* not fatal */
443         /*
444          * Nothing complex to manage the audio device queue.
445          * If the buffer is full just drop the extra, otherwise write.
446          * XXX in some cases it might be useful to write anyways after
447          * a number of failures, to restart the output chain.
448          */
449         res = used_blocks(o);
450         if (res > o->queuesize) {       /* no room to write a block */
451                 if (o->w_errors++ == 0 && (oss_debug & 0x4))
452                         ast_log(LOG_WARNING, "write: used %d blocks (%d)\n",
453                             res, o->w_errors);
454                 return 0;
455         }
456         o->w_errors = 0;
457         return write(o->sounddev, ((void *)data), FRAME_SIZE * 2);
458 }
459
460 /*
461  * Handler for 'sound writable' events from the sound thread.
462  * Builds a frame from the high level description of the sounds,
463  * and passes it to the audio device.
464  * The actual sound is made of 1 or more sequences of sound samples
465  * (s->datalen, repeated to make s->samplen samples) followed by
466  * s->silencelen samples of silence. The position in the sequence is stored
467  * in o->sampsent, which goes between 0 .. s->samplen+s->silencelen.
468  * In case we fail to write a frame, don't update o->sampsent.
469  */
470 static void send_sound(struct chan_oss_pvt *o)
471 {
472         short myframe[FRAME_SIZE];
473         int ofs, l, start;
474         int l_sampsent = o->sampsent;
475         struct sound *s;
476
477         if (o->cursound < 0)    /* no sound to send */
478                 return;
479         s = &sounds[o->cursound];
480         for (ofs = 0; ofs < FRAME_SIZE; ofs += l) {
481                 l = s->samplen - l_sampsent;    /* # of available samples */
482                 if (l > 0) {
483                         start = l_sampsent % s->datalen; /* source offset */
484                         if (l > FRAME_SIZE - ofs)       /* don't overflow the frame */
485                                 l = FRAME_SIZE - ofs;
486                         if (l > s->datalen - start)     /* don't overflow the source */
487                                 l = s->datalen - start;
488                         bcopy(s->data + start, myframe + ofs, l*2);
489                         if (0)
490                                 ast_log(LOG_WARNING, "send_sound sound %d/%d of %d into %d\n",
491                                     l_sampsent, l, s->samplen, ofs);
492                         l_sampsent += l;
493                 } else { /* end of samples, maybe some silence */
494                         static const short silence[FRAME_SIZE] = {0, };
495
496                         l += s->silencelen;
497                         if (l > 0) {
498                                 if (l > FRAME_SIZE - ofs)
499                                         l = FRAME_SIZE - ofs;
500                                 bcopy(silence, myframe + ofs, l*2);
501                                 l_sampsent += l;
502                         } else { /* silence is over, restart sound if loop */
503                                 if (s->repeat == 0) {   /* last block */
504                                         o->cursound = -1;
505                                         o->nosound = 0; /* allow audio data */
506                                         if (ofs < FRAME_SIZE)   /* pad with silence */
507                                                 bcopy(silence, myframe + ofs, (FRAME_SIZE - ofs)*2);
508                                 }
509                                 l_sampsent = 0;
510                         }
511                 }
512         }
513         l = soundcard_writeframe(o, myframe);
514         if (l > 0)
515                 o->sampsent = l_sampsent;       /* update status */
516 }
517
518 static void *sound_thread(void *arg)
519 {
520         char ign[4096];
521         struct chan_oss_pvt *o = (struct chan_oss_pvt *)arg;
522
523         /*
524          * Just in case, kick the driver by trying to read from it.
525          * Ignore errors - this read is almost guaranteed to fail.
526          */
527         read(o->sounddev, ign, sizeof(ign));
528         for (;;) {
529                 fd_set rfds, wfds;
530                 int maxfd, res;
531
532                 FD_ZERO(&rfds);
533                 FD_ZERO(&wfds);
534                 FD_SET(o->sndcmd[0], &rfds);
535                 maxfd = o->sndcmd[0];   /* pipe from the main process */
536                 if (o->cursound > -1 && o->sounddev < 0)
537                         setformat(o, O_RDWR);   /* need the channel, try to reopen */
538                 else if (o->cursound == -1 && o->owner == NULL)
539                         setformat(o, O_CLOSE);  /* can close */
540                 if (o->sounddev > -1) {
541                         if (!o->owner) { /* no one owns the audio, so we must drain it */
542                                 FD_SET(o->sounddev, &rfds);
543                                 maxfd = MAX(o->sounddev, maxfd);
544                         }
545                         if (o->cursound > -1) {
546                                 FD_SET(o->sounddev, &wfds);
547                                 maxfd = MAX(o->sounddev, maxfd);
548                         }
549                 }
550                 /* ast_select emulates linux behaviour in terms of timeout handling */
551                 res = ast_select(maxfd + 1, &rfds, &wfds, NULL, NULL);
552                 if (res < 1) {
553                         ast_log(LOG_WARNING, "select failed: %s\n", strerror(errno));
554                         sleep(1);
555                         continue;
556                 }
557                 if (FD_ISSET(o->sndcmd[0], &rfds)) {
558                         /* read which sound to play from the pipe */
559                         int i, what = -1;
560
561                         read(o->sndcmd[0], &what, sizeof(what));
562                         for (i = 0; sounds[i].ind != -1; i++) {
563                                 if (sounds[i].ind == what) {
564                                         o->cursound = i;
565                                         o->sampsent = 0;
566                                         o->nosound = 1; /* block audio from pbx */
567                                         break;
568                                 }
569                         }
570                         if (sounds[i].ind == -1)
571                                 ast_log(LOG_WARNING, "invalid sound index: %d\n", what);
572                 }
573                 if (o->sounddev > -1) {
574                         if (FD_ISSET(o->sounddev, &rfds)) /* read and ignore errors */
575                                 read(o->sounddev, ign, sizeof(ign));
576                         if (FD_ISSET(o->sounddev, &wfds))
577                                 send_sound(o);
578                 }
579         }
580         return NULL; /* Never reached */
581 }
582
583 /*
584  * reset and close the device if opened,
585  * then open and initialize it in the desired mode,
586  * trigger reads and writes so we can start using it.
587  */
588 static int setformat(struct chan_oss_pvt *o, int mode)
589 {
590         int fmt, desired, res, fd;
591
592         if (o->sounddev >= 0) {
593                 ioctl(o->sounddev, SNDCTL_DSP_RESET, 0);
594                 close(o->sounddev);
595                 o->duplex = M_UNSET;
596                 o->sounddev = -1;
597         }
598         if (mode == O_CLOSE)    /* we are done */
599                 return 0;
600         if (ast_tvdiff_ms(ast_tvnow(), o->lastopen) < 1000)
601                 return -1;      /* don't open too often */
602         o->lastopen = ast_tvnow();
603         fd = o->sounddev = open(o->device, mode |O_NONBLOCK);
604         if (fd < 0) {
605                 ast_log(LOG_WARNING, "Unable to re-open DSP device %s: %s\n",
606                     o->device, strerror(errno));
607                 return -1;
608         }
609         if (o->owner)
610                 o->owner->fds[0] = fd;
611
612 #if __BYTE_ORDER == __LITTLE_ENDIAN
613         fmt = AFMT_S16_LE;
614 #else
615         fmt = AFMT_S16_BE;
616 #endif
617         res = ioctl(fd, SNDCTL_DSP_SETFMT, &fmt);
618         if (res < 0) {
619                 ast_log(LOG_WARNING, "Unable to set format to 16-bit signed\n");
620                 return -1;
621         }
622         switch (mode) {
623         case O_RDWR:
624                 res = ioctl(fd, SNDCTL_DSP_SETDUPLEX, 0);
625                 /* Check to see if duplex set (FreeBSD Bug)*/
626                 res = ioctl(fd, SNDCTL_DSP_GETCAPS, &fmt);
627                 if (res == 0 && (fmt & DSP_CAP_DUPLEX)) {
628                         if (option_verbose > 1) 
629                                 ast_verbose(VERBOSE_PREFIX_2 "Console is full duplex\n");
630                         o->duplex = M_FULL;
631                 };
632                 break;
633         case O_WRONLY:
634                 o->duplex = M_WRITE;
635                 break;
636         case O_RDONLY:
637                 o->duplex = M_READ;
638                 break;
639         }
640
641         fmt = 0;
642         res = ioctl(fd, SNDCTL_DSP_STEREO, &fmt);
643         if (res < 0) {
644                 ast_log(LOG_WARNING, "Failed to set audio device to mono\n");
645                 return -1;
646         }
647         fmt = desired = 8000; /* 8000 Hz desired */
648         res = ioctl(fd, SNDCTL_DSP_SPEED, &fmt);
649
650         if (res < 0) {
651                 ast_log(LOG_WARNING, "Failed to set audio device to mono\n");
652                 return -1;
653         }
654         if (fmt != desired) {
655                 if (!(o->warned & WARN_speed)) {
656                         ast_log(LOG_WARNING,
657                             "Requested %d Hz, got %d Hz -- sound may be choppy\n",
658                             desired, fmt);
659                         o->warned |= WARN_speed;
660                 }
661         }
662         /*
663          * on Freebsd, SETFRAGMENT does not work very well on some cards.
664          * Default to use 256 bytes, let the user override
665          */
666         if (o->frags) {
667                 fmt = o->frags;
668                 res = ioctl(fd, SNDCTL_DSP_SETFRAGMENT, &fmt);
669                 if (res < 0) {
670                         if (!(o->warned & WARN_frag)) {
671                                 ast_log(LOG_WARNING,
672                                         "Unable to set fragment size -- sound may be choppy\n");
673                                 o->warned |= WARN_frag;
674                         }
675                 }
676         }
677         /* on some cards, we need SNDCTL_DSP_SETTRIGGER to start outputting */
678         res = PCM_ENABLE_INPUT | PCM_ENABLE_OUTPUT;
679         res = ioctl(fd, SNDCTL_DSP_SETTRIGGER, &res);
680         /* it may fail if we are in half duplex, never mind */
681         return 0;
682 }
683
684 /*
685  * some of the standard methods supported by channels.
686  */
687 static int oss_digit(struct ast_channel *c, char digit)
688 {
689         /* no better use for received digits than print them */
690         ast_verbose( " << Console Received digit %c >> \n", digit);
691         return 0;
692 }
693
694 static int oss_text(struct ast_channel *c, const char *text)
695 {
696         /* print received messages */
697         ast_verbose( " << Console Received text %s >> \n", text);
698         return 0;
699 }
700
701 /* Play ringtone 'x' on device 'o' */
702 static void ring(struct chan_oss_pvt *o, int x)
703 {
704         write(o->sndcmd[1], &x, sizeof(x));
705 }
706
707
708 /*
709  * handler for incoming calls. Either autoanswer, or start ringing
710  */
711 static int oss_call(struct ast_channel *c, char *dest, int timeout)
712 {
713         struct chan_oss_pvt *o = c->tech_pvt;
714         struct ast_frame f = { 0, };
715
716         ast_verbose(" << Call to device '%s' dnid '%s' rdnis '%s' on console from '%s' <%s> >>\n",
717                 dest, c->cid.cid_dnid, c->cid.cid_rdnis, c->cid.cid_name, c->cid.cid_num);
718         if (o->autoanswer) {
719                 ast_verbose( " << Auto-answered >> \n" );
720                 f.frametype = AST_FRAME_CONTROL;
721                 f.subclass = AST_CONTROL_ANSWER;
722                 ast_queue_frame(c, &f);
723         } else {
724                 ast_verbose("<< Type 'answer' to answer, or use 'autoanswer' for future calls >> \n");
725                 f.frametype = AST_FRAME_CONTROL;
726                 f.subclass = AST_CONTROL_RINGING;
727                 ast_queue_frame(c, &f);
728                 ring(o, AST_CONTROL_RING);
729         }
730         return 0;
731 }
732
733 /*
734  * remote side answered the phone
735  */
736 static int oss_answer(struct ast_channel *c)
737 {
738         struct chan_oss_pvt *o = c->tech_pvt;
739
740         ast_verbose( " << Console call has been answered >> \n");
741 #if 0
742         /* play an answer tone (XXX do we really need it ?) */
743         ring(o, AST_CONTROL_ANSWER);
744 #endif
745         ast_setstate(c, AST_STATE_UP);
746         o->cursound = -1;
747         o->nosound=0;
748         return 0;
749 }
750
751 static int oss_hangup(struct ast_channel *c)
752 {
753         struct chan_oss_pvt *o = c->tech_pvt;
754
755         o->cursound = -1;
756         o->nosound = 0;
757         c->tech_pvt = NULL;
758         o->owner = NULL;
759         ast_verbose( " << Hangup on console >> \n");
760         ast_mutex_lock(&usecnt_lock);   /* XXX not sure why */
761         usecnt--;
762         ast_mutex_unlock(&usecnt_lock);
763         if (o->hookstate) {
764                 if (o->autoanswer || o->autohangup) {
765                         /* Assume auto-hangup too */
766                         o->hookstate = 0;
767                         setformat(o, O_CLOSE);
768                 } else {
769                         /* Make congestion noise */
770                         ring(o, AST_CONTROL_CONGESTION);
771                 }
772         }
773         return 0;
774 }
775
776 /* used for data coming from the network */
777 static int oss_write(struct ast_channel *c, struct ast_frame *f)
778 {
779         int src;
780         struct chan_oss_pvt *o = c->tech_pvt;
781
782         /* Immediately return if no sound is enabled */
783         if (o->nosound)
784                 return 0;
785         /* Stop any currently playing sound */
786         o->cursound = -1;
787         /*
788          * we could receive a block which is not a multiple of our
789          * FRAME_SIZE, so buffer it locally and write to the device
790          * in FRAME_SIZE chunks.
791          * Keep the residue stored for future use.
792          */
793         src = 0; /* read position into f->data */
794         while ( src < f->datalen ) {
795                 /* Compute spare room in the buffer */
796                 int l = sizeof(o->oss_write_buf) - o->oss_write_dst;
797
798                 if (f->datalen - src >= l) {    /* enough to fill a frame */
799                         memcpy(o->oss_write_buf + o->oss_write_dst,
800                                 f->data + src, l);
801                         soundcard_writeframe(o, (short *)o->oss_write_buf);
802                         src += l;
803                         o->oss_write_dst = 0;
804                 } else { /* copy residue */
805                         l = f->datalen - src;
806                         memcpy(o->oss_write_buf + o->oss_write_dst,
807                                 f->data + src, l);
808                         src += l;       /* but really, we are done */
809                         o->oss_write_dst += l;
810                 }
811         }
812         return 0;
813 }
814
815 static struct ast_frame *oss_read(struct ast_channel *c)
816 {
817         int res;
818         struct chan_oss_pvt *o = c->tech_pvt;
819         struct ast_frame *f = &o->read_f;
820
821         /* XXX can be simplified returning &ast_null_frame */
822         /* prepare a NULL frame in case we don't have enough data to return */
823         bzero(f, sizeof(struct ast_frame));
824         f->frametype = AST_FRAME_NULL;
825         f->src = oss_tech.type;
826
827         res = read(o->sounddev, o->oss_read_buf + o->readpos,
828         sizeof(o->oss_read_buf) - o->readpos);
829         if (res < 0)    /* audio data not ready, return a NULL frame */
830                 return f;
831
832         o->readpos += res;
833         if (o->readpos < sizeof(o->oss_read_buf))       /* not enough samples */
834                 return f;
835
836         if (o->mute)
837                 return f;
838
839         o->readpos = AST_FRIENDLY_OFFSET;       /* reset read pointer for next frame */
840         if (c->_state != AST_STATE_UP)  /* drop data if frame is not up */
841                 return f;
842         /* ok we can build and deliver the frame to the caller */
843         f->frametype = AST_FRAME_VOICE;
844         f->subclass = AST_FORMAT_SLINEAR;
845         f->samples = FRAME_SIZE;
846         f->datalen = FRAME_SIZE * 2;
847         f->data = o->oss_read_buf + AST_FRIENDLY_OFFSET;
848         if (o->boost != BOOST_SCALE) { /* scale and clip values */
849                 int i, x;
850                 int16_t *p = (int16_t *)f->data;
851                 for (i = 0; i < f->samples; i++) {
852                         x = (p[i] * o->boost) / BOOST_SCALE;
853                         if (x > 32767)
854                                 x = 32767;
855                         else if (x < -32768)
856                                 x = -32768;
857                         p[i] = x;
858                 }
859         }
860         
861         f->offset = AST_FRIENDLY_OFFSET;
862         return f;
863 }
864
865 static int oss_fixup(struct ast_channel *oldchan, struct ast_channel *newchan)
866 {
867         struct chan_oss_pvt *o = newchan->tech_pvt;
868         o->owner = newchan;
869         return 0;
870 }
871
872 static int oss_indicate(struct ast_channel *c, int cond)
873 {
874         struct chan_oss_pvt *o = c->tech_pvt;
875         int res;
876
877         switch(cond) {
878         case AST_CONTROL_BUSY:
879         case AST_CONTROL_CONGESTION:
880         case AST_CONTROL_RINGING:
881                 res = cond;
882                 break;
883
884         case -1:
885                 o->cursound = -1;
886                 o->nosound = 0; /* when cursound is -1 nosound must be 0 */
887                 return 0;
888
889         case AST_CONTROL_VIDUPDATE:
890                 res = -1;
891                 break;
892         default:
893                 ast_log(LOG_WARNING,
894                     "Don't know how to display condition %d on %s\n",
895                     cond, c->name);
896                 return -1;
897         }
898         if (res > -1)
899                 ring(o, res);
900         return 0;       
901 }
902
903 /*
904  * allocate a new channel.
905  */
906 static struct ast_channel *oss_new(struct chan_oss_pvt *o,
907         char *ext, char *ctx, int state)
908 {
909         struct ast_channel *c;
910
911         c = ast_channel_alloc(1);
912         if (c == NULL)
913                 return NULL;
914         c->tech = &oss_tech;
915         ast_string_field_build(c, name, "OSS/%s", o->device + 5);
916         if (o->sounddev < 0)
917                 setformat(o, O_RDWR);
918         c->fds[0] = o->sounddev; /* -1 if device closed, override later */
919         c->nativeformats = AST_FORMAT_SLINEAR;
920         c->readformat = AST_FORMAT_SLINEAR;
921         c->writeformat = AST_FORMAT_SLINEAR;
922         c->tech_pvt = o;
923
924         if (!ast_strlen_zero(ctx))
925                 ast_copy_string(c->context, ctx, sizeof(c->context));
926         if (!ast_strlen_zero(ext))
927                 ast_copy_string(c->exten, ext, sizeof(c->exten));
928         if (!ast_strlen_zero(o->language))
929                 ast_string_field_set(c, language, o->language);
930         if (!ast_strlen_zero(o->cid_num))
931                 c->cid.cid_num = ast_strdup(o->cid_num);
932         if (!ast_strlen_zero(o->cid_name))
933                 c->cid.cid_name = ast_strdup(o->cid_name);
934         if (!ast_strlen_zero(ext))
935                 c->cid.cid_dnid = strdup(ext);
936
937         o->owner = c;
938         ast_setstate(c, state);
939         ast_mutex_lock(&usecnt_lock);
940         usecnt++;
941         ast_mutex_unlock(&usecnt_lock);
942         ast_update_use_count();
943         if (state != AST_STATE_DOWN) {
944                 if (ast_pbx_start(c)) {
945                         ast_log(LOG_WARNING, "Unable to start PBX on %s\n", c->name);
946                         ast_hangup(c);
947                         o->owner = c = NULL;
948                         /* XXX what about the channel itself ? */
949                         /* XXX what about usecnt ? */
950                 }
951         }
952         return c;
953 }
954
955 static struct ast_channel *oss_request(const char *type,
956         int format, void *data, int *cause)
957 {
958         struct ast_channel *c;
959         struct chan_oss_pvt *o = find_desc(data);
960
961         ast_log(LOG_WARNING, "oss_request ty <%s> data 0x%p <%s>\n",
962                 type, data, (char *)data);
963         if (o == NULL) {
964                 ast_log(LOG_NOTICE, "Device %s not found\n", (char *)data);
965                 /* XXX we could default to 'dsp' perhaps ? */
966                 return NULL;
967         }
968         if ((format & AST_FORMAT_SLINEAR) == 0) {
969                 ast_log(LOG_NOTICE, "Format 0x%x unsupported\n", format);
970                 return NULL;
971         }
972         if (o->owner) {
973                 ast_log(LOG_NOTICE, "Already have a call (chan %p) on the OSS channel\n", o->owner);
974                 *cause = AST_CAUSE_BUSY;
975                 return NULL;
976         }
977         c= oss_new(o, NULL, NULL, AST_STATE_DOWN);
978         if (c == NULL) {
979                 ast_log(LOG_WARNING, "Unable to create new OSS channel\n");
980                 return NULL;
981         }
982         return c;
983 }
984
985 static int console_autoanswer(int fd, int argc, char *argv[])
986 {
987         struct chan_oss_pvt *o = find_desc(oss_active);
988
989         if (argc == 1) {
990                 ast_cli(fd, "Auto answer is %s.\n", o->autoanswer ? "on" : "off");
991                 return RESULT_SUCCESS;
992         }
993         if (argc != 2)
994                 return RESULT_SHOWUSAGE;
995         if (o == NULL) {
996                 ast_log(LOG_WARNING, "Cannot find device %s (should not happen!)\n",
997                     oss_active);
998                 return RESULT_FAILURE;
999         }
1000         if (!strcasecmp(argv[1], "on"))
1001                 o->autoanswer = -1;
1002         else if (!strcasecmp(argv[1], "off"))
1003                 o->autoanswer = 0;
1004         else
1005                 return RESULT_SHOWUSAGE;
1006         return RESULT_SUCCESS;
1007 }
1008
1009 static char *autoanswer_complete(const char *line, const char *word, int pos, int state)
1010 {
1011         int l = strlen(word);
1012
1013         switch(state) {
1014         case 0:
1015                 if (l && !strncasecmp(word, "on", MIN(l, 2)))
1016                         return ast_strdup("on");
1017         case 1:
1018                 if (l && !strncasecmp(word, "off", MIN(l, 3)))
1019                         return ast_strdup("off");
1020         default:
1021                 return NULL;
1022         }
1023         return NULL;
1024 }
1025
1026 static char autoanswer_usage[] =
1027 "Usage: autoanswer [on|off]\n"
1028 "       Enables or disables autoanswer feature.  If used without\n"
1029 "       argument, displays the current on/off status of autoanswer.\n"
1030 "       The default value of autoanswer is in 'oss.conf'.\n";
1031
1032 /*
1033  * answer command from the console
1034  */
1035 static int console_answer(int fd, int argc, char *argv[])
1036 {
1037         struct ast_frame f = { AST_FRAME_CONTROL, AST_CONTROL_ANSWER };
1038         struct chan_oss_pvt *o = find_desc(oss_active);
1039
1040         if (argc != 1)
1041                 return RESULT_SHOWUSAGE;
1042         if (!o->owner) {
1043                 ast_cli(fd, "No one is calling us\n");
1044                 return RESULT_FAILURE;
1045         }
1046         o->hookstate = 1;
1047         o->cursound = -1;
1048         o->nosound = 0;
1049         ast_queue_frame(o->owner, &f);
1050 #if 0
1051         /* XXX do we really need it ? considering we shut down immediately... */
1052         ring(o, AST_CONTROL_ANSWER);
1053 #endif
1054         return RESULT_SUCCESS;
1055 }
1056
1057 static char sendtext_usage[] =
1058 "Usage: send text <message>\n"
1059 "       Sends a text message for display on the remote terminal.\n";
1060
1061 /*
1062  * concatenate all arguments into a single string. argv is NULL-terminated
1063  * so we can use it right away
1064  */
1065 static int console_sendtext(int fd, int argc, char *argv[])
1066 {
1067         struct chan_oss_pvt *o = find_desc(oss_active);
1068         char buf[TEXT_SIZE];
1069
1070         if (argc < 2)
1071                 return RESULT_SHOWUSAGE;
1072         if (!o->owner) {
1073                 ast_cli(fd, "Not in a call\n");
1074                 return RESULT_FAILURE;
1075         }
1076         ast_join(buf, sizeof(buf) - 1, argv+2);
1077         if (!ast_strlen_zero(buf)) {
1078                 struct ast_frame f = { 0, };
1079                 int i = strlen(buf);
1080                 buf[i] = '\n';
1081                 f.frametype = AST_FRAME_TEXT;
1082                 f.subclass = 0;
1083                 f.data = buf;
1084                 f.datalen = i + 1;
1085                 ast_queue_frame(o->owner, &f);
1086         }
1087         return RESULT_SUCCESS;
1088 }
1089
1090 static char answer_usage[] =
1091 "Usage: answer\n"
1092 "       Answers an incoming call on the console (OSS) channel.\n";
1093
1094 static int console_hangup(int fd, int argc, char *argv[])
1095 {
1096         struct chan_oss_pvt *o = find_desc(oss_active);
1097
1098         if (argc != 1)
1099                 return RESULT_SHOWUSAGE;
1100         o->cursound = -1;
1101         o->nosound = 0;
1102         if (!o->owner && !o->hookstate) { /* XXX maybe only one ? */
1103                 ast_cli(fd, "No call to hang up\n");
1104                 return RESULT_FAILURE;
1105         }
1106         o->hookstate = 0;
1107         if (o->owner)
1108                 ast_queue_hangup(o->owner);
1109         setformat(o, O_CLOSE);
1110         return RESULT_SUCCESS;
1111 }
1112
1113 static char hangup_usage[] =
1114 "Usage: hangup\n"
1115 "       Hangs up any call currently placed on the console.\n";
1116
1117
1118 static int console_flash(int fd, int argc, char *argv[])
1119 {
1120         struct ast_frame f = { AST_FRAME_CONTROL, AST_CONTROL_FLASH };
1121         struct chan_oss_pvt *o = find_desc(oss_active);
1122
1123         if (argc != 1)
1124                 return RESULT_SHOWUSAGE;
1125         o->cursound = -1;
1126         o->nosound = 0; /* when cursound is -1 nosound must be 0 */
1127         if (!o->owner) { /* XXX maybe !o->hookstate too ? */
1128                 ast_cli(fd, "No call to flash\n");
1129                 return RESULT_FAILURE;
1130         }
1131         o->hookstate = 0;
1132         if (o->owner) /* XXX must be true, right ? */
1133                 ast_queue_frame(o->owner, &f);
1134         return RESULT_SUCCESS;
1135 }
1136
1137
1138 static char flash_usage[] =
1139 "Usage: flash\n"
1140 "       Flashes the call currently placed on the console.\n";
1141
1142
1143
1144 static int console_dial(int fd, int argc, char *argv[])
1145 {
1146         char *s = NULL, *mye = NULL, *myc = NULL;
1147         struct chan_oss_pvt *o = find_desc(oss_active);
1148
1149         if (argc != 1 && argc != 2)
1150                 return RESULT_SHOWUSAGE;
1151         if (o->owner) { /* already in a call */
1152                 int i;
1153                 struct ast_frame f = { AST_FRAME_DTMF, 0 };
1154
1155                 if (argc == 1) {        /* argument is mandatory here */
1156                         ast_cli(fd, "Already in a call. You can only dial digits until you hangup.\n");
1157                         return RESULT_FAILURE;
1158                 }
1159                 s = argv[1];
1160                 /* send the string one char at a time */
1161                 for (i=0; i<strlen(s); i++) {
1162                         f.subclass = s[i];
1163                         ast_queue_frame(o->owner, &f);
1164                 }
1165                 return RESULT_SUCCESS;
1166         }
1167         /* if we have an argument split it into extension and context */
1168         if (argc == 2)
1169                 s = ast_ext_ctx(argv[1], &mye, &myc);
1170         /* supply default values if needed */
1171         if (mye == NULL)
1172                 mye = o->ext;
1173         if (myc == NULL)
1174                 myc = o->ctx;
1175         if (ast_exists_extension(NULL, myc, mye, 1, NULL)) {
1176                 o->hookstate = 1;
1177                 oss_new(o, mye, myc, AST_STATE_RINGING);
1178         } else
1179                 ast_cli(fd, "No such extension '%s' in context '%s'\n", mye, myc);
1180         if (s)
1181                 free(s);
1182         return RESULT_SUCCESS;
1183 }
1184
1185 static char dial_usage[] =
1186 "Usage: dial [extension[@context]]\n"
1187 "       Dials a given extensison (and context if specified)\n";
1188
1189 static char mute_usage[] =
1190 "Usage: mute\nMutes the microphone\n";
1191
1192 static char unmute_usage[] =
1193 "Usage: unmute\nUnmutes the microphone\n";
1194
1195 static int console_mute(int fd, int argc, char *argv[])
1196 {
1197         struct chan_oss_pvt *o = find_desc(oss_active);
1198
1199         if (argc != 1)
1200                 return RESULT_SHOWUSAGE;
1201         o->mute = 1;
1202         return RESULT_SUCCESS;
1203 }
1204
1205 static int console_unmute(int fd, int argc, char *argv[])
1206 {
1207         struct chan_oss_pvt *o = find_desc(oss_active);
1208
1209         if (argc != 1)
1210                 return RESULT_SHOWUSAGE;
1211         o->mute = 0;
1212         return RESULT_SUCCESS;
1213 }
1214
1215 static int console_transfer(int fd, int argc, char *argv[])
1216 {
1217         struct chan_oss_pvt *o = find_desc(oss_active);
1218         struct ast_channel *b = NULL;
1219         char *tmp, *ext, *ctx;
1220
1221         if (argc != 2)
1222                 return RESULT_SHOWUSAGE;
1223         if (o == NULL)
1224                 return RESULT_FAILURE;
1225         if (o->owner ==NULL || (b = ast_bridged_channel(o->owner)) == NULL) {
1226                 ast_cli(fd, "There is no call to transfer\n");
1227                 return RESULT_SUCCESS;
1228         }
1229
1230         tmp = ast_ext_ctx(argv[1], &ext, &ctx);
1231         if (ctx == NULL)                /* supply default context if needed */
1232                 ctx = o->owner->context;
1233         if (!ast_exists_extension(b, ctx, ext, 1, b->cid.cid_num))
1234                 ast_cli(fd, "No such extension exists\n");
1235         else {
1236                 ast_cli(fd, "Whee, transferring %s to %s@%s.\n",
1237                         b->name, ext, ctx);
1238                 if (ast_async_goto(b, ctx, ext, 1))
1239                         ast_cli(fd, "Failed to transfer :(\n");
1240         }
1241         if (tmp)
1242                 free(tmp);
1243         return RESULT_SUCCESS;
1244 }
1245
1246 static char transfer_usage[] =
1247 "Usage: transfer <extension>[@context]\n"
1248 "       Transfers the currently connected call to the given extension (and\n"
1249 "context if specified)\n";
1250
1251 static char console_usage[] =
1252 "Usage: console [device]\n"
1253 "       If used without a parameter, displays which device is the current\n"
1254 "console.  If a device is specified, the console sound device is changed to\n"
1255 "the device specified.\n";
1256
1257 static int console_active(int fd, int argc, char *argv[])
1258 {
1259         if (argc == 1)
1260                 ast_cli(fd, "active console is [%s]\n", oss_active);
1261         else if (argc != 2)
1262                 return RESULT_SHOWUSAGE;
1263         else {
1264                 struct chan_oss_pvt *o;
1265                 if (strcmp(argv[1], "show") == 0) {
1266                         for (o = oss_default.next; o ; o = o->next)
1267                             ast_cli(fd, "device [%s] exists\n", o->name);
1268                         return RESULT_SUCCESS;
1269                 }
1270                 o = find_desc(argv[1]);
1271                 if (o == NULL)
1272                         ast_cli(fd, "No device [%s] exists\n", argv[1]);
1273                 else
1274                         oss_active = o->name;
1275         }
1276         return RESULT_SUCCESS;
1277 }
1278
1279 /*
1280  * store the boost factor
1281  */
1282 static void store_boost(struct chan_oss_pvt *o, char *s)
1283 {
1284         double boost = 0;
1285         if (sscanf(s, "%lf", &boost) != 1) {
1286                 ast_log(LOG_WARNING, "invalid boost <%s>\n", s);
1287                 return;
1288         }
1289         if (boost < - BOOST_MAX) {
1290                 ast_log(LOG_WARNING, "boost %s too small, using %d\n",
1291                         s, -BOOST_MAX);
1292                 boost = -BOOST_MAX;
1293         } else if (boost > BOOST_MAX) {
1294                 ast_log(LOG_WARNING, "boost %s too large, using %d\n",
1295                         s, BOOST_MAX);
1296                 boost = BOOST_MAX;
1297         }
1298         boost = exp(log(10)*boost/20) * BOOST_SCALE;
1299         o->boost = boost;
1300         ast_log(LOG_WARNING, "setting boost %s to %d\n", s, o->boost);
1301 }
1302
1303 static int do_boost(int fd, int argc, char *argv[])
1304 {
1305         struct chan_oss_pvt *o = find_desc(oss_active);
1306
1307         if (argc == 2)
1308                 ast_cli(fd, "boost currently %5.1f\n",
1309                         20 * log10(((double)o->boost/(double)BOOST_SCALE)) );
1310         else if (argc == 3)
1311                 store_boost(o, argv[2]);
1312         return RESULT_SUCCESS;
1313 }
1314
1315 static struct ast_cli_entry myclis[] = {
1316         { { "answer", NULL }, console_answer, "Answer an incoming console call", answer_usage },
1317         { { "hangup", NULL }, console_hangup, "Hangup a call on the console", hangup_usage },
1318         { { "flash", NULL }, console_flash, "Flash a call on the console", flash_usage },
1319         { { "dial", NULL }, console_dial, "Dial an extension on the console", dial_usage },
1320         { { "mute", NULL }, console_mute, "Disable mic input", mute_usage },
1321         { { "unmute", NULL }, console_unmute, "Enable mic input", unmute_usage },
1322         { { "transfer", NULL }, console_transfer, "Transfer a call to a different extension", transfer_usage },
1323         { { "send", "text", NULL }, console_sendtext, "Send text to the remote device", sendtext_usage },
1324         { { "autoanswer", NULL }, console_autoanswer, "Sets/displays autoanswer", autoanswer_usage, autoanswer_complete },
1325         { { "oss", "boost", NULL }, do_boost, "Sets/displays mic boost in dB"},
1326         { { "console", NULL }, console_active, "Sets/displays active console", console_usage },
1327 };
1328
1329 /*
1330  * store the mixer argument from the config file, filtering possibly
1331  * invalid or dangerous values (the string is used as argument for
1332  * system("mixer %s")
1333  */
1334 static void store_mixer(struct chan_oss_pvt *o, char *s)
1335 {
1336         int i;
1337
1338         for (i=0; i < strlen(s); i++) {
1339                 if (!isalnum(s[i]) && index(" \t-/", s[i]) == NULL) {
1340                         ast_log(LOG_WARNING,
1341                                 "Suspect char %c in mixer cmd, ignoring:\n\t%s\n", s[i], s);
1342                         return;
1343                 }
1344         }
1345         if (o->mixer_cmd)
1346                 free(o->mixer_cmd);
1347         o->mixer_cmd = ast_strdup(s);
1348         ast_log(LOG_WARNING, "setting mixer %s\n", s);
1349 }
1350
1351 /*
1352  * store the callerid components
1353  */
1354 static void store_callerid(struct chan_oss_pvt *o, char *s)
1355 {
1356         ast_callerid_split(s, o->cid_name, sizeof(o->cid_name), o->cid_num, sizeof(o->cid_num));
1357 }
1358
1359 /*
1360  * grab fields from the config file, init the descriptor and open the device.
1361  */
1362 static struct chan_oss_pvt * store_config(struct ast_config *cfg, char *ctg)
1363 {
1364         struct ast_variable *v;
1365         struct chan_oss_pvt *o;
1366
1367         if (ctg == NULL) {
1368                 o = &oss_default;
1369                 ctg = "general";
1370         } else {
1371                 if (!(o = ast_calloc(1, sizeof(*o))))
1372                         return NULL;
1373                 *o = oss_default;
1374                 /* "general" is also the default thing */
1375                 if (strcmp(ctg, "general") == 0) {
1376                         o->name = ast_strdup("dsp");
1377                         oss_active = o->name;
1378                         goto openit;
1379                 }
1380                 o->name = ast_strdup(ctg);
1381         }
1382
1383         o->lastopen = ast_tvnow(); /* don't leave it 0 or tvdiff may wrap */
1384         /* fill other fields from configuration */
1385         for (v = ast_variable_browse(cfg, ctg);v; v=v->next) {
1386                 M_START(v->name, v->value);
1387
1388                 M_BOOL("autoanswer", o->autoanswer)
1389                 M_BOOL("autohangup", o->autohangup)
1390                 M_BOOL("overridecontext", o->overridecontext)
1391                 M_STR("device", o->device)
1392                 M_UINT("frags", o->frags)
1393                 M_UINT("debug", oss_debug)
1394                 M_UINT("queuesize", o->queuesize)
1395                 M_STR("context", o->ctx)
1396                 M_STR("language", o->language)
1397                 M_STR("extension", o->ext)
1398                 M_F("mixer", store_mixer(o, v->value))
1399                 M_F("callerid", store_callerid(o, v->value))
1400                 M_F("boost", store_boost(o, v->value))
1401                 M_END(;);
1402         }
1403         if (ast_strlen_zero(o->device))
1404                 ast_copy_string(o->device, DEV_DSP, sizeof(o->device));
1405         if (o->mixer_cmd) {
1406                 char *cmd;
1407
1408                 asprintf(&cmd, "mixer %s", o->mixer_cmd);
1409                 ast_log(LOG_WARNING, "running [%s]\n", cmd);
1410                 system(cmd);
1411                 free(cmd);
1412         }
1413         if (o == &oss_default)  /* we are done with the default */
1414                 return NULL;
1415
1416 openit:
1417 #if TRYOPEN
1418         if (setformat(o, O_RDWR) < 0) { /* open device */
1419                 if (option_verbose > 0) {
1420                         ast_verbose(VERBOSE_PREFIX_2 "Device %s not detected\n", ctg);
1421                         ast_verbose(VERBOSE_PREFIX_2 "Turn off OSS support by adding "
1422                             "'noload=chan_oss.so' in /etc/asterisk/modules.conf\n");
1423                 }
1424                 goto error;
1425         }
1426         if (o->duplex != M_FULL)
1427                 ast_log(LOG_WARNING, "XXX I don't work right with non "
1428                         "full-duplex sound cards XXX\n");
1429 #endif /* TRYOPEN */
1430         if (pipe(o->sndcmd) != 0) {
1431                 ast_log(LOG_ERROR, "Unable to create pipe\n");
1432                 goto error;
1433         }
1434         ast_pthread_create(&o->sthread, NULL, sound_thread, o);
1435         /* link into list of devices */
1436         if (o != &oss_default) {
1437                 o->next = oss_default.next;
1438                 oss_default.next = o;
1439         }
1440         return o;
1441
1442 error:
1443         if (o != &oss_default)
1444                 free(o);
1445         return NULL;
1446 }
1447
1448 int load_module(void)
1449 {
1450         int i;
1451         struct ast_config *cfg;
1452
1453         /* load config file */
1454         cfg = ast_config_load(config);
1455         if (cfg != NULL) {
1456                 char *ctg = NULL;       /* first pass is 'general' */
1457
1458                 do {
1459                         store_config(cfg, ctg);
1460                 } while ( (ctg = ast_category_browse(cfg, ctg)) != NULL);
1461                 ast_config_destroy(cfg);
1462         } else {
1463                  ast_log(LOG_NOTICE, "Unable to load config oss.conf\n");
1464                  return -1;
1465         }
1466         if (find_desc(oss_active) == NULL) {
1467                 ast_log(LOG_NOTICE, "Device %s not found\n", oss_active);
1468                 /* XXX we could default to 'dsp' perhaps ? */
1469                 /* XXX should cleanup allocated memory etc. */
1470                 return -1;
1471         }
1472         i = ast_channel_register(&oss_tech);
1473         if (i < 0) {
1474                 ast_log(LOG_ERROR, "Unable to register channel class 'Console'\n");
1475                 /* XXX should cleanup allocated memory etc. */
1476                 return -1;
1477         }
1478         ast_cli_register_multiple(myclis, sizeof(myclis)/sizeof(struct ast_cli_entry));
1479         return 0;
1480 }
1481
1482
1483 int unload_module()
1484 {
1485         struct chan_oss_pvt *o;
1486
1487         ast_channel_unregister(&oss_tech);
1488         ast_cli_unregister_multiple(myclis,
1489                 sizeof(myclis)/sizeof(struct ast_cli_entry));
1490
1491         for (o = oss_default.next; o ; o = o->next) {
1492                 close(o->sounddev);
1493                 if (o->sndcmd[0] > 0) {
1494                         close(o->sndcmd[0]);
1495                         close(o->sndcmd[1]);
1496                 }
1497                 if (o->owner)
1498                         ast_softhangup(o->owner, AST_SOFTHANGUP_APPUNLOAD);
1499                 if (o->owner) /* XXX how ??? */
1500                         return -1;
1501                 /* XXX what about the thread ? */
1502                 /* XXX what about the memory allocated ? */
1503         }
1504         return 0;
1505 }
1506
1507 char *description()
1508 {
1509         return (char *)oss_tech.description;
1510 }
1511
1512 int usecount()
1513 {
1514         return usecnt;
1515 }
1516
1517 char *key()
1518 {
1519         return ASTERISK_GPL_KEY;
1520 }