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