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