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