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