- add the ability to configure forced jitterbuffers on h323, jingle,
[asterisk/asterisk.git] / configs / zapata.conf.sample
1 ;
2 ; Zapata telephony interface
3 ;
4 ; Configuration file
5 ;
6 ; You need to restart Asterisk to re-configure the Zap channel
7 ; CLI> reload chan_zap.so 
8 ;               will reload the configuration file,
9 ;               but not all configuration options are 
10 ;               re-configured during a reload.
11
12
13
14 [trunkgroups]
15 ;
16 ; Trunk groups are used for NFAS or GR-303 connections.
17 ;
18 ; Group: Defines a trunk group.  
19 ;        group => <trunkgroup>,<dchannel>[,<backup1>...]
20 ;
21 ;        trunkgroup  is the numerical trunk group to create
22 ;        dchannel    is the zap channel which will have the 
23 ;                    d-channel for the trunk.
24 ;        backup1     is an optional list of backup d-channels.
25 ;
26 ;trunkgroup => 1,24,48
27 ;trunkgroup => 1,24
28 ;
29 ; Spanmap: Associates a span with a trunk group
30 ;        spanmap => <zapspan>,<trunkgroup>[,<logicalspan>]
31 ;
32 ;        zapspan     is the zap span number to associate
33 ;        trunkgroup  is the trunkgroup (specified above) for the mapping
34 ;        logicalspan is the logical span number within the trunk group to use.
35 ;                    if unspecified, no logical span number is used.
36 ;
37 ;spanmap => 1,1,1
38 ;spanmap => 2,1,2
39 ;spanmap => 3,1,3
40 ;spanmap => 4,1,4
41
42 [channels]
43 ;
44 ; Default language
45 ;
46 ;language=en
47 ;
48 ; Default context
49 ;
50 context=default
51 ;
52 ; Switchtype:  Only used for PRI.
53 ;
54 ; national:       National ISDN 2 (default)
55 ; dms100:         Nortel DMS100
56 ; 4ess:           AT&T 4ESS
57 ; 5ess:           Lucent 5ESS
58 ; euroisdn:       EuroISDN
59 ; ni1:            Old National ISDN 1
60 ; qsig:           Q.SIG
61 ;
62 switchtype=national
63 ;
64 ; Some switches (AT&T especially) require network specific facility IE
65 ; supported values are currently 'none', 'sdn', 'megacom', 'tollfreemegacom', 'accunet'
66 ;
67 ;nsf=none
68 ;
69 ; PRI Dialplan:  Only RARELY used for PRI.
70 ;
71 ; unknown:        Unknown
72 ; private:        Private ISDN
73 ; local:          Local ISDN
74 ; national:       National ISDN
75 ; international:  International ISDN
76 ;
77 ;pridialplan=national
78 ;
79 ; PRI Local Dialplan:  Only RARELY used for PRI (sets the calling number's numbering plan)
80 ;
81 ; unknown:        Unknown
82 ; private:        Private ISDN
83 ; local:          Local ISDN
84 ; national:       National ISDN
85 ; international:  International ISDN
86 ;
87 ;prilocaldialplan=national
88 ;
89 ; PRI callerid prefixes based on the given TON/NPI (dialplan)
90 ; This is especially needed for euroisdn E1-PRIs
91
92 ; sample 1 for Germany 
93 ;internationalprefix = 00
94 ;nationalprefix = 0
95 ;localprefix = 0711
96 ;privateprefix = 07115678
97 ;unknownprefix = 
98 ;
99 ; sample 2 for Germany 
100 ;internationalprefix = +
101 ;nationalprefix = +49
102 ;localprefix = +49711
103 ;privateprefix = +497115678
104 ;unknownprefix = 
105 ;
106 ; PRI resetinterval: sets the time in seconds between restart of unused
107 ; channels, defaults to 3600; minimum 60 seconds.  Some PBXs don't like
108 ; channel restarts. so set the interval to a very long interval e.g. 100000000
109 ; or 'never' to disable *entirely*.
110 ;
111 ;resetinterval = 3600 
112 ;
113 ; Overlap dialing mode (sending overlap digits)
114 ;
115 ;overlapdial=yes
116 ;
117 ; PRI Out of band indications.
118 ; Enable this to report Busy and Congestion on a PRI using out-of-band
119 ; notification. Inband indication, as used by Asterisk doesn't seem to work
120 ; with all telcos.
121
122 ; outofband:      Signal Busy/Congestion out of band with RELEASE/DISCONNECT
123 ; inband:         Signal Busy/Congestion using in-band tones
124 ;
125 ; priindication = outofband
126 ;
127 ; If you need to override the existing channels selection routine and force all
128 ; PRI channels to be marked as exclusively selected, set this to yes.
129 ; priexclusive = yes
130 ;
131 ; ISDN Timers
132 ; All of the ISDN timers and counters that are used are configurable.  Specify
133 ; the timer name, and its value (in ms for timers).
134 ;
135 ; pritimer => t200,1000
136 ; pritimer => t313,4000
137 ;
138 ; To enable transmission of facility-based ISDN supplementary services (such
139 ; as caller name from CPE over facility), enable this option.
140 ; facilityenable = yes
141 ;
142 ;
143 ; Signalling method (default is fxs).  Valid values:
144 ; em:             E & M
145 ; em_w:           E & M Wink
146 ; featd:          Feature Group D (The fake, Adtran style, DTMF)
147 ; featdmf:        Feature Group D (The real thing, MF (domestic, US))
148 ; featdmf_ta:     Feature Group D (The real thing, MF (domestic, US)) through
149 ;                 a Tandem Access point
150 ; featb:          Feature Group B (MF (domestic, US))
151 ; fgccama         Feature Group C-CAMA (DP DNIS, MF ANI)
152 ; fgccamamf       Feature Group C-CAMA MF (MF DNIS, MF ANI)
153 ; fxs_ls:         FXS (Loop Start)
154 ; fxs_gs:         FXS (Ground Start)
155 ; fxs_ks:         FXS (Kewl Start)
156 ; fxo_ls:         FXO (Loop Start)
157 ; fxo_gs:         FXO (Ground Start)
158 ; fxo_ks:         FXO (Kewl Start)
159 ; pri_cpe:        PRI signalling, CPE side
160 ; pri_net:        PRI signalling, Network side
161 ; gr303fxoks_net: GR-303 Signalling, FXO Loopstart, Network side
162 ; gr303fxsks_cpe: GR-303 Signalling, FXS Loopstart, CPE side
163 ; sf:             SF (Inband Tone) Signalling
164 ; sf_w:           SF Wink
165 ; sf_featd:       SF Feature Group D (The fake, Adtran style, DTMF)
166 ; sf_featdmf:     SF Feature Group D (The real thing, MF (domestic, US))
167 ; sf_featb:       SF Feature Group B (MF (domestic, US))
168 ; e911:           E911 (MF) style signalling
169 ;
170 ; The following are used for Radio interfaces:
171 ; fxs_rx:         Receive audio/COR on an FXS kewlstart interface (FXO at the
172 ;                 channel bank)
173 ; fxs_tx:         Transmit audio/PTT on an FXS loopstart interface (FXO at the
174 ;                 channel bank)
175 ; fxo_rx:         Receive audio/COR on an FXO loopstart interface (FXS at the
176 ;                 channel bank)
177 ; fxo_tx:         Transmit audio/PTT on an FXO groundstart interface (FXS at
178 ;                 the channel bank)
179 ; em_rx:          Receive audio/COR on an E&M interface (1-way)
180 ; em_tx:          Transmit audio/PTT on an E&M interface (1-way)
181 ; em_txrx:        Receive audio/COR AND Transmit audio/PTT on an E&M interface
182 ;                 (2-way)
183 ; em_rxtx:        Same as em_txrx (for our dyslexic friends)
184 ; sf_rx:          Receive audio/COR on an SF interface (1-way)
185 ; sf_tx:          Transmit audio/PTT on an SF interface (1-way)
186 ; sf_txrx:        Receive audio/COR AND Transmit audio/PTT on an SF interface
187 ;                 (2-way)
188 ; sf_rxtx:        Same as sf_txrx (for our dyslexic friends)
189 ;
190 signalling=fxo_ls
191 ;
192 ; If you have an outbound signalling format that is different from format
193 ; specified above (but compatible), you can specify outbound signalling format,
194 ; (see below). The 'signalling' format specified will be the inbound signalling
195 ; format. If you only specify 'signalling', then it will be the format for
196 ; both inbound and outbound.
197
198 ; signaling=featdmf
199 ; outsignalling=featb
200 ;
201 ; For Feature Group D Tandem access, to set the default CIC and OZZ use these
202 ; parameters:
203 ;defaultozz=0000
204 ;defaultcic=303
205 ;
206 ; A variety of timing parameters can be specified as well
207 ; Including:
208 ;    prewink:     Pre-wink time (default 50ms)
209 ;    preflash:    Pre-flash time (default 50ms)
210 ;    wink:        Wink time (default 150ms)
211 ;    flash:       Flash time (default 750ms)
212 ;    start:       Start time (default 1500ms)
213 ;    rxwink:      Receiver wink time (default 300ms)
214 ;    rxflash:     Receiver flashtime (default 1250ms)
215 ;    debounce:    Debounce timing (default 600ms)
216 ;
217 rxwink=300              ; Atlas seems to use long (250ms) winks
218 ;
219 ; How long generated tones (DTMF and MF) will be played on the channel
220 ; (in miliseconds)
221 ;toneduration=100
222 ;
223 ; Whether or not to do distinctive ring detection on FXO lines
224 ;
225 ;usedistinctiveringdetection=yes
226 ;distinctiveringaftercid=yes    ; enable dring detection after callerid for those countries like Australia
227                                 ; where the ring cadence is changed *after* the callerid spill.
228 ;
229 ; Whether or not to use caller ID
230 ;
231 usecallerid=yes
232 ;
233 ; Type of caller ID signalling in use
234 ;     bell     = bell202 as used in US
235 ;     v23      = v23 as used in the UK
236 ;     v23_jp   = v23 as used in Japan
237 ;     dtmf     = DTMF as used in Denmark, Sweden and Netherlands
238 ;     smdi     = Use SMDI for callerid.  Requires SMDI to be enabled (usesmdi).
239 ;
240 ;cidsignalling=bell
241 ;
242 ; What signals the start of caller ID
243 ;     ring     = a ring signals the start
244 ;     polarity = polarity reversal signals the start
245 ;
246 ;cidstart=ring
247 ;
248 ; Whether or not to hide outgoing caller ID (Override with *67 or *82)
249 ;
250 hidecallerid=no
251 ;
252 ; Whether or not to enable call waiting on FXO lines
253 ;
254 callwaiting=yes
255 ;
256 ; Whether or not restrict outgoing caller ID (will be sent as ANI only, not
257 ; available for the user)
258 ; Mostly use with FXS ports
259 ;
260 ;restrictcid=no
261 ;
262 ; Whether or not use the caller ID presentation for the outgoing call that the
263 ; calling switch is sending.
264 ; See README.callingpres
265 ;
266 usecallingpres=yes
267 ;
268 ; Some countries (UK) have ring tones with different ring tones (ring-ring),
269 ; which means the callerid needs to be set later on, and not just after
270 ; the first ring, as per the default. 
271 ;
272 ;sendcalleridafter=1
273 ;
274 ;
275 ; Support Caller*ID on Call Waiting
276 ;
277 callwaitingcallerid=yes
278 ;
279 ; Support three-way calling
280 ;
281 threewaycalling=yes
282 ;
283 ; Support flash-hook call transfer (requires three way calling)
284 ; Also enables call parking (overrides the 'canpark' parameter)
285 ;
286 transfer=yes
287 ;
288 ; Allow call parking
289 ; ('canpark=no' is overridden by 'transfer=yes')
290 ;
291 canpark=yes
292 ;
293 ; Support call forward variable
294 ;
295 cancallforward=yes
296 ;
297 ; Whether or not to support Call Return (*69)
298 ;
299 callreturn=yes
300 ;
301 ; Stutter dialtone support: If a mailbox is specified without a voicemail 
302 ; context, then when voicemail is received in a mailbox in the default 
303 ; voicemail context in voicemail.conf, taking the phone off hook will cause a
304 ; stutter dialtone instead of a normal one. 
305 ;
306 ; If a mailbox is specified *with* a voicemail context, the same will result
307 ; if voicemail recieved in mailbox in the specified voicemail context.
308 ;
309 ; for default voicemail context, the example below is fine:
310 ;
311 ;mailbox=1234
312 ;
313 ; for any other voicemail context, the following will produce the stutter tone:
314 ;
315 ;mailbox=1234@context 
316 ;
317 ; Enable echo cancellation 
318 ; Use either "yes", "no", or a power of two from 32 to 256 if you wish to
319 ; actually set the number of taps of cancellation.
320 ;
321 echocancel=yes
322 ;
323 ; Generally, it is not necessary (and in fact undesirable) to echo cancel when
324 ; the circuit path is entirely TDM.  You may, however, reverse this behavior
325 ; by enabling the echo cancel during pure TDM bridging below.
326 ;
327 echocancelwhenbridged=yes
328 ;
329 ; In some cases, the echo canceller doesn't train quickly enough and there
330 ; is echo at the beginning of the call.  Enabling echo training will cause
331 ; asterisk to briefly mute the channel, send an impulse, and use the impulse
332 ; response to pre-train the echo canceller so it can start out with a much
333 ; closer idea of the actual echo.  Value may be "yes", "no", or a number of
334 ; milliseconds to delay before training (default = 400)
335 ;
336 ;echotraining=yes
337 ;echotraining=800
338 ;
339 ; If you are having trouble with DTMF detection, you can relax the DTMF
340 ; detection parameters.  Relaxing them may make the DTMF detector more likely
341 ; to have "talkoff" where DTMF is detected when it shouldn't be.
342 ;
343 ;relaxdtmf=yes
344 ;
345 ; You may also set the default receive and transmit gains (in dB)
346 ;
347 rxgain=0.0
348 txgain=0.0
349 ;
350 ; Logical groups can be assigned to allow outgoing rollover.  Groups range
351 ; from 0 to 63, and multiple groups can be specified.
352 ;
353 group=1
354 ;
355 ; Ring groups (a.k.a. call groups) and pickup groups.  If a phone is ringing
356 ; and it is a member of a group which is one of your pickup groups, then
357 ; you can answer it by picking up and dialing *8#.  For simple offices, just
358 ; make these both the same.  Groups range from 0 to 63.
359 ;
360 callgroup=1
361 pickupgroup=1
362
363 ;
364 ; Specify whether the channel should be answered immediately or if the simple
365 ; switch should provide dialtone, read digits, etc.
366 ;
367 immediate=no
368 ;
369 ; Specify whether flash-hook transfers to 'busy' channels should complete or
370 ; return to the caller performing the transfer (default is yes).
371 ;
372 ;transfertobusy=no
373 ;
374 ; CallerID can be set to "asreceived" or a specific number if you want to
375 ; override it.  Note that "asreceived" only applies to trunk interfaces.
376 ;
377 ;callerid=2564286000
378 ;
379 ; AMA flags affects the recording of Call Detail Records.  If specified
380 ; it may be 'default', 'omit', 'billing', or 'documentation'.
381 ;
382 ;amaflags=default
383 ;
384 ; Channels may be associated with an account code to ease
385 ; billing
386 ;
387 ;accountcode=lss0101
388 ;
389 ; ADSI (Analog Display Services Interface) can be enabled on a per-channel
390 ; basis if you have (or may have) ADSI compatible CPE equipment
391 ;
392 ;adsi=yes
393 ;
394 ; SMDI (Simplified Message Desk Interface) can be enabled on a per-channel
395 ; basis if you would like that channel to behave like an SMDI message desk.
396 ; The SMDI port specfied should have already been defined in smdi.conf.  The
397 ; default port is /dev/ttyS0.
398 ;
399 ;usesmdi=yes
400 ;smdiport=/dev/ttyS0
401 ;
402 ; On trunk interfaces (FXS) and E&M interfaces (E&M, Wink, Feature Group D
403 ; etc, it can be useful to perform busy detection either in an effort to 
404 ; detect hangup or for detecting busies.  This enables listening for
405 ; the beep-beep busy pattern.
406 ;
407 ;busydetect=yes
408 ;
409 ; If busydetect is enabled, it is also possible to specify how many busy tones
410 ; to wait for before hanging up.  The default is 4, but better results can be
411 ; achieved if set to 6 or even 8.  Mind that the higher the number, the more
412 ; time that will be needed to hangup a channel, but lowers the probability
413 ; that you will get random hangups.
414 ;
415 ;busycount=4
416 ;
417 ; If busydetect is enabled, it is also possible to specify the cadence of your
418 ; busy signal.  In many countries, it is 500msec on, 500msec off.  Without
419 ; busypattern specified, we'll accept any regular sound-silence pattern that
420 ; repeats <busycount> times as a busy signal.  If you specify busypattern,
421 ; then we'll further check the length of the sound (tone) and silence, which
422 ; will further reduce the chance of a false positive.
423 ;
424 ;busypattern=500,500
425 ;
426 ; NOTE: In the Asterisk Makefile you'll find further options to tweak the busy
427 ; detector.  If your country has a busy tone with the same length tone and
428 ; silence (as many countries do), consider defining the
429 ; -DBUSYDETECT_COMPARE_TONE_AND_SILENCE option.
430 ;
431 ; Use a polarity reversal to mark when a outgoing call is answered by the
432 ; remote party.
433 ;
434 ;answeronpolarityswitch=yes
435 ;
436 ; In some countries, a polarity reversal is used to signal the disconnect of a
437 ; phone line.  If the hanguponpolarityswitch option is selected, the call will
438 ; be considered "hung up" on a polarity reversal.
439 ;
440 ;hanguponpolarityswitch=yes
441 ;
442 ; On trunk interfaces (FXS) it can be useful to attempt to follow the progress
443 ; of a call through RINGING, BUSY, and ANSWERING.   If turned on, call
444 ; progress attempts to determine answer, busy, and ringing on phone lines.
445 ; This feature is HIGHLY EXPERIMENTAL and can easily detect false answers,
446 ; so don't count on it being very accurate.
447 ;
448 ; Few zones are supported at the time of this writing, but may be selected
449 ; with "progzone"
450 ;
451 ; This feature can also easily detect false hangups. The symptoms of this is
452 ; being disconnected in the middle of a call for no reason.
453 ;
454 ;callprogress=yes
455 ;progzone=us
456 ;
457 ; FXO (FXS signalled) devices must have a timeout to determine if there was a
458 ; hangup before the line was answered.  This value can be tweaked to shorten
459 ; how long it takes before Zap considers a non-ringing line to have hungup.
460 ;
461 ;ringtimeout=8000
462 ;
463 ; For FXO (FXS signalled) devices, whether to use pulse dial instead of DTMF
464 ;
465 ;pulsedial=yes
466 ;
467 ; For fax detection, uncomment one of the following lines.  The default is *OFF*
468 ;
469 ;faxdetect=both
470 ;faxdetect=incoming
471 ;faxdetect=outgoing
472 ;faxdetect=no
473 ;
474 ; Select which class of music to use for music on hold.  If not specified
475 ; then the default will be used.
476 ;
477 ;musicclass=default
478 ;
479 ; PRI channels can have an idle extension and a minunused number.  So long as
480 ; at least "minunused" channels are idle, chan_zap will try to call "idledial"
481 ; on them, and then dump them into the PBX in the "idleext" extension (which
482 ; is of the form exten@context).  When channels are needed the "idle" calls
483 ; are disconnected (so long as there are at least "minidle" calls still
484 ; running, of course) to make more channels available.  The primary use of
485 ; this is to create a dynamic service, where idle channels are bundled through
486 ; multilink PPP, thus more efficiently utilizing combined voice/data services
487 ; than conventional fixed mappings/muxings.
488 ;
489 ;idledial=6999
490 ;idleext=6999@dialout
491 ;minunused=2
492 ;minidle=1
493 ;
494 ; Configure jitter buffers in zapata (each one is 20ms, default is 4)
495 ;
496 ;jitterbuffers=4
497 ;
498 ;------------------------------ JITTER BUFFER CONFIGURATION --------------------------
499 ; jbenable = yes              ; Enables the use of a jitterbuffer on the receiving side of a
500                               ; ZAP channel. Defaults to "no". An enabled jitterbuffer will
501                               ; be used only if the sending side can create and the receiving
502                               ; side can not accept jitter. The ZAP channel can't accept jitter,
503                               ; thus an enabled jitterbuffer on the receive ZAP side will always
504                               ; be used if the sending side can create jitter.
505
506 ; jbmaxsize = 200             ; Max length of the jitterbuffer in milliseconds.
507
508 ; jbresyncthreshold = 1000    ; Jump in the frame timestamps over which the jitterbuffer is
509                               ; resynchronized. Useful to improve the quality of the voice, with
510                               ; big jumps in/broken timestamps, usualy sent from exotic devices
511                               ; and programs. Defaults to 1000.
512
513 ; jbimpl = fixed              ; Jitterbuffer implementation, used on the receiving side of a ZAP
514                               ; channel. Two implementations are currenlty available - "fixed"
515                               ; (with size always equals to jbmax-size) and "adaptive" (with
516                               ; variable size, actually the new jb of IAX2). Defaults to fixed.
517
518 ; jblog = no                  ; Enables jitterbuffer frame logging. Defaults to "no".
519 ;-----------------------------------------------------------------------------------
520 ;
521 ; You can define your own custom ring cadences here.  You can define up to 8
522 ; pairs.  If the silence is negative, it indicates where the callerid spill is
523 ; to be placed.  Also, if you define any custom cadences, the default cadences
524 ; will be turned off.
525 ;
526 ; Syntax is:  cadence=ring,silence[,ring,silence[...]]
527 ;
528 ; These are the default cadences:
529 ;
530 ;cadence=125,125,2000,-4000
531 ;cadence=250,250,500,1000,250,250,500,-4000
532 ;cadence=125,125,125,125,125,-4000
533 ;cadence=1000,500,2500,-5000
534 ;
535 ; Each channel consists of the channel number or range.  It inherits the
536 ; parameters that were specified above its declaration.
537 ;
538 ; For GR-303, CRV's are created like channels except they must start with the
539 ; trunk group followed by a colon, e.g.: 
540 ;
541 ; crv => 1:1
542 ; crv => 2:1-2,5-8
543 ;
544 ;
545 ;callerid="Green Phone"<(256) 428-6121>
546 ;channel => 1
547 ;callerid="Black Phone"<(256) 428-6122>
548 ;channel => 2
549 ;callerid="CallerID Phone" <(256) 428-6123>
550 ;callerid="CallerID Phone" <(630) 372-1564>
551 ;callerid="CallerID Phone" <(256) 704-4666>
552 ;channel => 3
553 ;callerid="Pac Tel Phone" <(256) 428-6124>
554 ;channel => 4
555 ;callerid="Uniden Dead" <(256) 428-6125>
556 ;channel => 5
557 ;callerid="Cortelco 2500" <(256) 428-6126>
558 ;channel => 6
559 ;callerid="Main TA 750" <(256) 428-6127>
560 ;channel => 44
561 ;
562 ; For example, maybe we have some other channels which start out in a
563 ; different context and use E & M signalling instead.
564 ;
565 ;context=remote
566 ;sigalling=em
567 ;channel => 15
568 ;channel => 16
569
570 ;signalling=em_w
571 ;
572 ; All those in group 0 I'll use for outgoing calls
573 ;
574 ; Strip most significant digit (9) before sending
575 ;
576 ;stripmsd=1
577 ;callerid=asreceived
578 ;group=0
579 ;signalling=fxs_ls
580 ;channel => 45
581
582 ;signalling=fxo_ls
583 ;group=1
584 ;callerid="Joe Schmoe" <(256) 428-6131>
585 ;channel => 25
586 ;callerid="Megan May" <(256) 428-6132>
587 ;channel => 26
588 ;callerid="Suzy Queue" <(256) 428-6233>
589 ;channel => 27
590 ;callerid="Larry Moe" <(256) 428-6234>
591 ;channel => 28
592 ;
593 ; Sample PRI (CPE) config:  Specify the switchtype, the signalling as either
594 ; pri_cpe or pri_net for CPE or Network termination, and generally you will
595 ; want to create a single "group" for all channels of the PRI.
596 ;
597 ; switchtype = national
598 ; signalling = pri_cpe
599 ; group = 2
600 ; channel => 1-23
601
602 ;
603
604 ;  Used for distintive ring support for x100p.
605 ;  You can see the dringX patterns is to set any one of the dringXcontext fields
606 ;  and they will be printed on the console when an inbound call comes in.
607 ;
608 ;dring1=95,0,0 
609 ;dring1context=internal1 
610 ;dring2=325,95,0 
611 ;dring2context=internal2 
612 ; If no pattern is matched here is where we go.
613 ;context=default
614 ;channel => 1 
615