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