20bcdb8b03d3f13e423720b88e3a9b2a9173cb03
[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 (signalling, as well as
11 ;               PRI and SS7-related settings cannot be changed on a
12 ;               reload.
13
14 ; This file documents many configuration variables.  Normally unless you
15 ; know what a variable means or that it should be changed, there's no
16 ; reason to unrem lines.
17 ;
18 ; remmed-out examples below (those lines that begin with a ';' but no
19 ; space afterwards) typically show a value that is not the defauult value,
20 ; but would make sense under cetain circumstances. The default values
21 ; are usually sane. Thus you should typically not touch them unless you 
22 ; know what they mean or you know you should change them.
23
24
25 [trunkgroups]
26 ;
27 ; Trunk groups are used for NFAS or GR-303 connections.
28 ;
29 ; Group: Defines a trunk group.  
30 ;        trunkgroup => <trunkgroup>,<dchannel>[,<backup1>...]
31 ;
32 ;        trunkgroup  is the numerical trunk group to create
33 ;        dchannel    is the zap channel which will have the 
34 ;                    d-channel for the trunk.
35 ;        backup1     is an optional list of backup d-channels.
36 ;
37 ;trunkgroup => 1,24,48
38 ;trunkgroup => 1,24
39 ;
40 ; Spanmap: Associates a span with a trunk group
41 ;        spanmap => <zapspan>,<trunkgroup>[,<logicalspan>]
42 ;
43 ;        zapspan     is the zap span number to associate
44 ;        trunkgroup  is the trunkgroup (specified above) for the mapping
45 ;        logicalspan is the logical span number within the trunk group to use.
46 ;                    if unspecified, no logical span number is used.
47 ;
48 ;spanmap => 1,1,1
49 ;spanmap => 2,1,2
50 ;spanmap => 3,1,3
51 ;spanmap => 4,1,4
52
53 [channels]
54 ;
55 ; Default language
56 ;
57 ;language=en
58 ;
59 ; Context for calls. Defaults to 'default'
60 ;
61 ;context=incoming
62 ;
63 ; Switchtype:  Only used for PRI.
64 ;
65 ; national:       National ISDN 2 (default)
66 ; dms100:         Nortel DMS100
67 ; 4ess:           AT&T 4ESS
68 ; 5ess:           Lucent 5ESS
69 ; euroisdn:       EuroISDN (common in Europe)
70 ; ni1:            Old National ISDN 1
71 ; qsig:           Q.SIG
72 ;
73 ;switchtype=euroisdn
74 ;
75 ; Some switches (AT&T especially) require network specific facility IE
76 ; supported values are currently 'none', 'sdn', 'megacom', 'tollfreemegacom', 'accunet'
77 ;
78 ; nsf cannot be changed on a reload.
79 ;
80 ;nsf=none
81 ;
82 ; PRI Dialplan:  Only RARELY used for PRI.
83 ; PRI Local Dialplan:  Only RARELY used for PRI (sets the calling number's 
84 ; numbering plan)
85 ; pridialplan and prilocaldialplan cannot be changed on a reload.
86 ;
87 ; unknown:        Unknown
88 ; private:        Private ISDN
89 ; local:          Local ISDN
90 ; national:       National ISDN
91 ; international:  International ISDN
92 ; dynamic:        Dynamically selects the appropriate dialplan
93 ; redundant:      Same as dynamic, except that the underlying number is not 
94 ;                 changed (not common)
95 ;
96 ;pridialplan=national
97 ;prilocaldialplan=national
98
99 ; pridialplan may be also set at dialtime, by prefixing the dialled number with
100 ; one of the following letters:
101 ; U - Unknown
102 ; I - International
103 ; N - National
104 ; L - Local (Net Specific)
105 ; S - Subscriber
106 ; V - Abbreviated
107 ; R - Reserved (should probably never be used but is included for completeness)
108 ;
109 ; Additionally, you may also set the following NPI bits (also by prefixing the
110 ; dialled string with one of the following letters):
111 ; u - Unknown
112 ; e - E.163/E.164 (ISDN/telephony)
113 ; x - X.121 (Data)
114 ; f - F.69 (Telex)
115 ; n - National
116 ; p - Private
117 ; r - Reserved (should probably never be used but is included for completeness)
118 ;
119 ; You may also set the prilocaldialplan in the same way, but by prefixing the
120 ; Caller*ID Number, rather than the dialled number.  Please note that telcos
121 ; which require this kind of additional manipulation of the TON/NPI are *rare*.
122 ; Most telco PRIs will work fine simply by setting pridialplan to unknown or
123 ; dynamic.
124 ;
125 ;
126 ; PRI caller ID prefixes based on the given TON/NPI (dialplan)
127 ; This is especially needed for EuroISDN E1-PRIs
128
129 ; None of the prefix settings can be changed on reload.
130 ;
131 ; sample 1 for Germany 
132 ;internationalprefix = 00
133 ;nationalprefix = 0
134 ;localprefix = 0711
135 ;privateprefix = 07115678
136 ;unknownprefix = 
137 ;
138 ; sample 2 for Germany 
139 ;internationalprefix = +
140 ;nationalprefix = +49
141 ;localprefix = +49711
142 ;privateprefix = +497115678
143 ;unknownprefix = 
144 ;
145 ; PRI resetinterval: sets the time in seconds between restart of unused
146 ; B channels; defaults to 'never'.
147 ;
148 ;resetinterval = 3600 
149 ;
150 ; Overlap dialing mode (sending overlap digits)
151 ; Cannot be changed on a reload.
152 ;
153 ;overlapdial=yes
154 ;
155 ; PRI Out of band indications.
156 ; Enable this to report Busy and Congestion on a PRI using out-of-band
157 ; notification. Inband indication, as used by Asterisk doesn't seem to work
158 ; with all telcos.
159
160 ; outofband:      Signal Busy/Congestion out of band with RELEASE/DISCONNECT
161 ; inband:         Signal Busy/Congestion using in-band tones (default)
162 ;
163 ; priindication cannot be changed on a reload.
164 ;
165 ;priindication = outofband
166 ;
167 ; If you need to override the existing channels selection routine and force all
168 ; PRI channels to be marked as exclusively selected, set this to yes.
169 ;
170 ; priexclusive cannot be changed on a reload.
171 ;
172 ;priexclusive = yes
173 ;
174 ; ISDN Timers
175 ; All of the ISDN timers and counters that are used are configurable.  Specify
176 ; the timer name, and its value (in ms for timers).
177 ; K:    Layer 2 max number of outstanding unacknowledged I frames (default 7)
178 ; N200: Layer 2 max number of retransmissions of a frame (default 3)
179 ; T200: Layer 2 max time before retransmission of a frame (default 1000 ms)
180 ; T203: Layer 2 max time without frames being exchanged (default 10000 ms)
181 ; T305: Wait for DISCONNECT acknowledge (default 30000 ms)
182 ; T308: Wait for RELEASE acknowledge (default 4000 ms)
183 ; T309: Maintain active calls on Layer 2 disconnection (default -1, 
184 ;       Asterisk clears calls)
185 ;       EuroISDN: 6000 to 12000 ms, according to (N200 + 1) x T200 + 2s
186 ;       May vary in other ISDN standards (Q.931 1993 : 90000 ms)
187 ; T313: Wait for CONNECT acknowledge, CPE side only (default 3000 ms)
188 ;
189 ;pritimer => t200,1000
190 ;pritimer => t313,4000
191 ;
192 ; To enable transmission of facility-based ISDN supplementary services (such
193 ; as caller name from CPE over facility), enable this option.
194 ; Cannot be changed on a reload.
195 ;
196 ;facilityenable = yes
197 ;
198 ; pritimer cannot be changed on a reload.
199 ;
200 ; Signalling method. The default is "auto". Valid values:
201 ; auto:           Use the current value from Zaptel.
202 ; em:             E & M
203 ; em_e1:          E & M E1
204 ; em_w:           E & M Wink
205 ; featd:          Feature Group D (The fake, Adtran style, DTMF)
206 ; featdmf:        Feature Group D (The real thing, MF (domestic, US))
207 ; featdmf_ta:     Feature Group D (The real thing, MF (domestic, US)) through
208 ;                 a Tandem Access point
209 ; featb:          Feature Group B (MF (domestic, US))
210 ; fgccama         Feature Group C-CAMA (DP DNIS, MF ANI)
211 ; fgccamamf       Feature Group C-CAMA MF (MF DNIS, MF ANI)
212 ; fxs_ls:         FXS (Loop Start)
213 ; fxs_gs:         FXS (Ground Start)
214 ; fxs_ks:         FXS (Kewl Start)
215 ; fxo_ls:         FXO (Loop Start)
216 ; fxo_gs:         FXO (Ground Start)
217 ; fxo_ks:         FXO (Kewl Start)
218 ; pri_cpe:        PRI signalling, CPE side
219 ; pri_net:        PRI signalling, Network side
220 ; gr303fxoks_net: GR-303 Signalling, FXO Loopstart, Network side
221 ; gr303fxsks_cpe: GR-303 Signalling, FXS Loopstart, CPE side
222 ; sf:             SF (Inband Tone) Signalling
223 ; sf_w:           SF Wink
224 ; sf_featd:       SF Feature Group D (The fake, Adtran style, DTMF)
225 ; sf_featdmf:     SF Feature Group D (The real thing, MF (domestic, US))
226 ; sf_featb:       SF Feature Group B (MF (domestic, US))
227 ; e911:           E911 (MF) style signalling
228 ; ss7:            Signalling System 7
229 ;
230 ; The following are used for Radio interfaces:
231 ; fxs_rx:         Receive audio/COR on an FXS kewlstart interface (FXO at the
232 ;                 channel bank)
233 ; fxs_tx:         Transmit audio/PTT on an FXS loopstart interface (FXO at the
234 ;                 channel bank)
235 ; fxo_rx:         Receive audio/COR on an FXO loopstart interface (FXS at the
236 ;                 channel bank)
237 ; fxo_tx:         Transmit audio/PTT on an FXO groundstart interface (FXS at
238 ;                 the channel bank)
239 ; em_rx:          Receive audio/COR on an E&M interface (1-way)
240 ; em_tx:          Transmit audio/PTT on an E&M interface (1-way)
241 ; em_txrx:        Receive audio/COR AND Transmit audio/PTT on an E&M interface
242 ;                 (2-way)
243 ; em_rxtx:        Same as em_txrx (for our dyslexic friends)
244 ; sf_rx:          Receive audio/COR on an SF interface (1-way)
245 ; sf_tx:          Transmit audio/PTT on an SF interface (1-way)
246 ; sf_txrx:        Receive audio/COR AND Transmit audio/PTT on an SF interface
247 ;                 (2-way)
248 ; sf_rxtx:        Same as sf_txrx (for our dyslexic friends)
249 ; ss7:            Signalling System 7
250 ;
251 ; signalling of a channel can not be changed on a reload.
252 ;
253 ;signalling=fxo_ls
254 ;
255 ; If you have an outbound signalling format that is different from format
256 ; specified above (but compatible), you can specify outbound signalling format,
257 ; (see below). The 'signalling' format specified will be the inbound signalling
258 ; format. If you only specify 'signalling', then it will be the format for
259 ; both inbound and outbound.
260
261 ; outsignalling can only be one of: 
262 ;   em, em_e1, em_w, sf, sf_w, sf_featd, sf_featdmf, sf_featb, featd,
263 ;   featdmf, featdmf_ta, e911, fgccama, fgccamamf
264
265 ; outsignalling cannot be changed on a reload.
266 ;
267 ;signalling=featdmf
268 ;
269 ;outsignalling=featb
270 ;
271 ; For Feature Group D Tandem access, to set the default CIC and OZZ use these
272 ; parameters (Will not be updated on reload):
273 ;
274 ;defaultozz=0000
275 ;defaultcic=303
276 ;
277 ; A variety of timing parameters can be specified as well
278 ; The default values for those are "-1", which is to use the
279 ; compile-time defaults of the Zaptel kernel modules. The timing
280 ; parameters, (with the standard default from Zaptel):
281 ;
282 ;    prewink:     Pre-wink time (default 50ms)
283 ;    preflash:    Pre-flash time (default 50ms)
284 ;    wink:        Wink time (default 150ms)
285 ;    flash:       Flash time (default 750ms)
286 ;    start:       Start time (default 1500ms)
287 ;    rxwink:      Receiver wink time (default 300ms)
288 ;    rxflash:     Receiver flashtime (default 1250ms)
289 ;    debounce:    Debounce timing (default 600ms)
290 ;
291 ; None of them will update on a reload.
292 ;
293 ; How long generated tones (DTMF and MF) will be played on the channel
294 ; (in milliseconds). 
295 ;
296 ; This is a global, rather than a per-channel setting. It will not be 
297 ; updated on a reload.
298 ;
299 ;toneduration=100
300 ;
301 ; Whether or not to do distinctive ring detection on FXO lines:
302 ;
303 ;usedistinctiveringdetection=yes
304 ;
305 ; enable dring detection after caller ID for those countries like Australia
306 ; where the ring cadence is changed *after* the caller ID spill:
307 ;
308 ;distinctiveringaftercid=yes    
309 ;
310 ; Whether or not to use caller ID:
311 ;
312 usecallerid=yes
313 ;
314 ; Hide the name part and leave just the number part of the caller ID
315 ; string. Only applies to PRI channels.
316 ;hidecalleridname=yes
317 ;
318 ; Type of caller ID signalling in use
319 ;     bell     = bell202 as used in US (default)
320 ;     v23      = v23 as used in the UK
321 ;     v23_jp   = v23 as used in Japan
322 ;     dtmf     = DTMF as used in Denmark, Sweden and Netherlands
323 ;     smdi     = Use SMDI for caller ID.  Requires SMDI to be enabled (usesmdi).
324 ;
325 ;cidsignalling=v23
326 ;
327 ; What signals the start of caller ID
328 ;     ring        = a ring signals the start (default)
329 ;     polarity    = polarity reversal signals the start
330 ;     polarity_IN = polarity reversal signals the start, for India, 
331 ;                   for dtmf dialtone detection; using DTMF.
332 ;                   (see doc/India-CID.txt)
333 ;
334 ;cidstart=polarity
335 ;
336 ; Whether or not to hide outgoing caller ID (Override with *67 or *82)
337 ; (If your dialplan doesn't catch it)
338 ;
339 ;hidecallerid=yes
340 ;
341 ; The following option enables receiving MWI on FXO lines.  The default
342 ; value is no.  When this is enabled, and MWI notification indicates on or off,
343 ; the script specified by the mwimonitornotify option is executed.  Also, an
344 ; internal Asterisk MWI event will be generated so that any other part of
345 ; Asterisk that cares about MWI state changes will get notified, just as if
346 ; the state change came from app_voicemail. The energy level that must be seen
347 ; before starting the MWI detection process can be set with 'mwilevel'.
348 ;
349 ;mwimonitor=no
350 ;mwilevel=512
351 ;
352 ; This option is used in conjunction with mwimonitor.  This will get executed
353 ; when incoming MWI state changes.  The script is passed 2 arguments.  The
354 ; first is the corresponding mailbox, and the second is 1 or 0, indicating if
355 ; there are messages waiting or not.
356 ;
357 ;mwimonitornotify=/usr/local/bin/zapnotify.sh
358 ;
359 ; Whether or not to enable call waiting on internal extensions
360 ; With this set to 'yes', busy extensions will hear the call-waiting
361 ; tone, and can use hook-flash to switch between callers. The Dial()
362 ; app will not return the "BUSY" result for extensions.
363 ;
364 callwaiting=yes
365 ;
366 ; Whether or not restrict outgoing caller ID (will be sent as ANI only, not
367 ; available for the user)
368 ; Mostly use with FXS ports
369 ;
370 ;restrictcid=no
371 ;
372 ; Whether or not use the caller ID presentation for the outgoing call that the
373 ; calling switch is sending.
374 ; See README.callingpres. FIXME: file no longer exists.
375 ;
376 usecallingpres=yes
377 ;
378 ; Some countries (UK) have ring tones with different ring tones (ring-ring),
379 ; which means the caller ID needs to be set later on, and not just after
380 ; the first ring, as per the default (1). 
381 ;
382 ;sendcalleridafter = 2
383 ;
384 ;
385 ; Support caller ID on Call Waiting
386 ;
387 callwaitingcallerid=yes
388 ;
389 ; Support three-way calling
390 ;
391 threewaycalling=yes
392 ;
393 ; For FXS ports (either direct analog or over T1/E1):
394 ;   Support flash-hook call transfer (requires three way calling)
395 ;   Also enables call parking (overrides the 'canpark' parameter)
396 ;
397 ; For digital ports using ISDN PRI protocols:
398 ;   Support switch-side transfer (called 2BCT, RLT or other names)
399 ;   This setting must be enabled on both ports involved, and the
400 ;   'facilityenable' setting must also be enabled to allow sending
401 ;   the transfer to the ISDN switch, since it sent in a FACILITY
402 ;   message.
403 ;
404 transfer=yes
405 ;
406 ; Allow call parking
407 ; ('canpark=no' is overridden by 'transfer=yes')
408 ;
409 canpark=yes
410 ;
411 ; Support call forward variable
412 ;
413 cancallforward=yes
414 ;
415 ; Whether or not to support Call Return (*69, if your dialplan doesn't
416 ; catch this first)
417 ;
418 callreturn=yes
419 ;
420 ; Stutter dialtone support: If a mailbox is specified without a voicemail 
421 ; context, then when voicemail is received in a mailbox in the default 
422 ; voicemail context in voicemail.conf, taking the phone off hook will cause a
423 ; stutter dialtone instead of a normal one. 
424 ;
425 ; If a mailbox is specified *with* a voicemail context, the same will result
426 ; if voicemail received in mailbox in the specified voicemail context.
427 ;
428 ; for default voicemail context, the example below is fine:
429 ;
430 ;mailbox=1234
431 ;
432 ; for any other voicemail context, the following will produce the stutter tone:
433 ;
434 ;mailbox=1234@context 
435 ;
436 ; Enable echo cancellation 
437 ; Use either "yes", "no", or a power of two from 32 to 256 if you wish to
438 ; actually set the number of taps of cancellation.
439 ;
440 ; Note that when setting the number of taps, the number 256 does not translate
441 ; to 256 ms of echo cancellation.  echocancel=256 means 256 / 8 = 32 ms.
442 ;
443 ; Note that if any of your Zaptel cards have hardware echo cancellers,
444 ; then this setting only turns them on and off; numeric settings will
445 ; be treated as "yes". There are no special settings required for
446 ; hardware echo cancellers; when present and enabled in their kernel
447 ; modules, they take precedence over the software echo canceller compiled
448 ; into Zaptel automatically.
449 ;
450 ;
451 echocancel=yes
452 ;
453 ; As of Zaptel 1.4.8, some Zaptel echo cancellers (software and hardware)
454 ; support adjustable parameters; these parameters can be supplied as
455 ; additional options to the 'echocancel' setting. Note that Asterisk
456 ; does not attempt to validate the parameters or their values, so if you
457 ; supply an invalid parameter you will not know the specific reason it
458 ; failed without checking the kernel message log for the error(s)
459 ; put there by Zaptel.
460 ;
461 ;echocancel=128,param1=32,param2=0,param3=14
462 ;
463 ; Generally, it is not necessary (and in fact undesirable) to echo cancel when
464 ; the circuit path is entirely TDM.  You may, however, change this behavior
465 ; by enabling the echo canceller during pure TDM bridging below.
466 ;
467 echocancelwhenbridged=yes
468 ;
469 ; In some cases, the echo canceller doesn't train quickly enough and there
470 ; is echo at the beginning of the call.  Enabling echo training will cause
471 ; Zaptel to briefly mute the channel, send an impulse, and use the impulse
472 ; response to pre-train the echo canceller so it can start out with a much
473 ; closer idea of the actual echo.  Value may be "yes", "no", or a number of
474 ; milliseconds to delay before training (default = 400)
475 ;
476 ; WARNING:  In some cases this option can make echo worse!  If you are
477 ; trying to debug an echo problem, it is worth checking to see if your echo
478 ; is better with the option set to yes or no.  Use whatever setting gives
479 ; the best results.
480 ;
481 ; Note that these parameters do not apply to hardware echo cancellers.
482 ;
483 ;echotraining=yes
484 ;echotraining=800
485 ;
486 ; If you are having trouble with DTMF detection, you can relax the DTMF
487 ; detection parameters.  Relaxing them may make the DTMF detector more likely
488 ; to have "talkoff" where DTMF is detected when it shouldn't be.
489 ;
490 ;relaxdtmf=yes
491 ;
492 ; You may also set the default receive and transmit gains (in dB)
493 ;
494 ; Gain Settings: increasing / decreasing the volume level on a channel.
495 ;                The values are in db (decibells). A positive number
496 ;                increases the volume level on a channel, and a
497 ;                negavive value decreases volume level.
498 ;
499 ;                There are several independent gain settings:
500 ;   rxgain: gain for the rx (receive - into Asterisk) channel. Default: 0.0
501 ;   txgain: gain for the tx (transmit - out of Asterisk Asterisk) channel. 
502 ;           Default: 0.0
503 ;   cid_rxgain: set the gain just for the caller ID sounds Asterisk
504 ;               emits. Default: 5.0 .
505
506 ;rxgain=2.0
507 ;txgain=3.0
508 ;
509 ; Logical groups can be assigned to allow outgoing roll-over.  Groups range
510 ; from 0 to 63, and multiple groups can be specified. By default the
511 ; channel is not a member of any group.
512 ;
513 ; Note that an explicit empty value for 'group' is invalid, and will not
514 ; override a previous non-empty one. The same applies to callgroup and
515 ; pickupgroup as well.
516 ;
517 group=1
518 ;
519 ; Ring groups (a.k.a. call groups) and pickup groups.  If a phone is ringing
520 ; and it is a member of a group which is one of your pickup groups, then
521 ; you can answer it by picking up and dialing *8#.  For simple offices, just
522 ; make these both the same.  Groups range from 0 to 63.
523 ;
524 callgroup=1
525 pickupgroup=1
526
527 ; Channel variable to be set for all calls from this channel
528 ;setvar=CHANNEL=42             
529
530 ;
531 ; Specify whether the channel should be answered immediately or if the simple
532 ; switch should provide dialtone, read digits, etc.
533 ; Note: If immediate=yes the dialplan execution will always start at extension
534 ; 's' priority 1 regardless of the dialed number!
535 ;
536 ;immediate=yes
537 ;
538 ; Specify whether flash-hook transfers to 'busy' channels should complete or
539 ; return to the caller performing the transfer (default is yes).
540 ;
541 ;transfertobusy=no
542 ;
543 ; caller ID can be set to "asreceived" or a specific number if you want to
544 ; override it.  Note that "asreceived" only applies to trunk interfaces.
545 ; fullname sets just the 
546 ;
547 ; fullname: sets just the name part.
548 ; cid_number: sets just the number part: 
549 ;
550 ;callerid = 123456
551 ;
552 ;callerid = My Name <2564286000>
553 ; Which can also be written as:
554 ;cid_number = 2564286000
555 ;fullname = My Name
556 ;
557 ;callerid = asreceived
558 ;
559 ; should we use the caller ID from incoming call on zap transfer?
560 ;
561 ;useincomingcalleridonzaptransfer = yes
562 ;
563 ; AMA flags affects the recording of Call Detail Records.  If specified
564 ; it may be 'default', 'omit', 'billing', or 'documentation'.
565 ;
566 ;amaflags=default
567 ;
568 ; Channels may be associated with an account code to ease
569 ; billing
570 ;
571 ;accountcode=lss0101
572 ;
573 ; ADSI (Analog Display Services Interface) can be enabled on a per-channel
574 ; basis if you have (or may have) ADSI compatible CPE equipment
575 ;
576 ;adsi=yes
577 ;
578 ; SMDI (Simplified Message Desk Interface) can be enabled on a per-channel
579 ; basis if you would like that channel to behave like an SMDI message desk.
580 ; The SMDI port specified should have already been defined in smdi.conf.  The
581 ; default port is /dev/ttyS0.
582 ;
583 ;usesmdi=yes
584 ;smdiport=/dev/ttyS0
585 ;
586 ; On trunk interfaces (FXS) and E&M interfaces (E&M, Wink, Feature Group D
587 ; etc, it can be useful to perform busy detection either in an effort to 
588 ; detect hangup or for detecting busies.  This enables listening for
589 ; the beep-beep busy pattern.
590 ;
591 ;busydetect=yes
592 ;
593 ; If busydetect is enabled, it is also possible to specify how many busy tones
594 ; to wait for before hanging up.  The default is 3, but it might be
595 ; safer to set to 6 or even 8.  Mind that the higher the number, the more
596 ; time that will be needed to hangup a channel, but lowers the probability
597 ; that you will get random hangups.
598 ;
599 ;busycount=6
600 ;
601 ; If busydetect is enabled, it is also possible to specify the cadence of your
602 ; busy signal.  In many countries, it is 500msec on, 500msec off.  Without
603 ; busypattern specified, we'll accept any regular sound-silence pattern that
604 ; repeats <busycount> times as a busy signal.  If you specify busypattern,
605 ; then we'll further check the length of the sound (tone) and silence, which
606 ; will further reduce the chance of a false positive.
607 ;
608 ;busypattern=500,500
609 ;
610 ; NOTE: In make menuselect, you'll find further options to tweak the busy
611 ; detector.  If your country has a busy tone with the same length tone and
612 ; silence (as many countries do), consider enabling the
613 ; BUSYDETECT_COMPARE_TONE_AND_SILENCE option.
614 ;
615 ; To further detect which hangup tone your telco provider is sending, it is
616 ; useful to use the ztmonitor utility to record the audio that main/dsp.c
617 ; is receiving after the caller hangs up.
618 ;
619 ; Use a polarity reversal to mark when a outgoing call is answered by the
620 ; remote party.
621 ;
622 ;answeronpolarityswitch=yes
623 ;
624 ; In some countries, a polarity reversal is used to signal the disconnect of a
625 ; phone line.  If the hanguponpolarityswitch option is selected, the call will
626 ; be considered "hung up" on a polarity reversal.
627 ;
628 ;hanguponpolarityswitch=yes
629 ;
630 ; polarityonanswerdelay: minimal time period (ms) between the answer 
631 ;                        polarity switch and hangup polarity switch. 
632 ;                        (default: 600ms)
633 ;
634 ; On trunk interfaces (FXS) it can be useful to attempt to follow the progress
635 ; of a call through RINGING, BUSY, and ANSWERING.   If turned on, call
636 ; progress attempts to determine answer, busy, and ringing on phone lines.
637 ; This feature is HIGHLY EXPERIMENTAL and can easily detect false answers,
638 ; so don't count on it being very accurate.
639 ;
640 ; Few zones are supported at the time of this writing, but may be selected
641 ; with "progzone".
642 ;
643 ; progzone also affects the pattern used for buzydetect (unless
644 ; busypattern is set explicitly). The possible values are: 
645 ;   us (default)
646 ;   ca (alias for 'us')
647 ;   cr (Costa Rica)
648 ;   br (Brazil, alias for 'cr')
649 ;   uk
650 ;
651 ; This feature can also easily detect false hangups. The symptoms of this is
652 ; being disconnected in the middle of a call for no reason.
653 ;
654 ;callprogress=yes
655 ;progzone=uk
656 ;
657 ; Set the tonezone. Equivalent of the defaultzone settings in
658 ; /etc/zaptel.conf . This sets the tone zone by number.
659 ; Note that you'd still need to load tonezones (loadzone in zaptel.conf).
660 ; The default is -1: not to set anything.
661 ;tonezone = 0 ; 0 is US
662 ;
663 ; FXO (FXS signalled) devices must have a timeout to determine if there was a
664 ; hangup before the line was answered.  This value can be tweaked to shorten
665 ; how long it takes before Zap considers a non-ringing line to have hungup.
666 ;
667 ; ringtimeout will not update on a reload.
668 ;
669 ;ringtimeout=8000
670 ;
671 ; For FXO (FXS signalled) devices, whether to use pulse dial instead of DTMF
672 ; Pulse digits from phones (FXS devices, FXO signalling) are always
673 ; detected.
674 ;
675 ;pulsedial=yes
676 ;
677 ; For fax detection, uncomment one of the following lines.  The default is *OFF*
678 ;
679 ;faxdetect=both
680 ;faxdetect=incoming
681 ;faxdetect=outgoing
682 ;faxdetect=no
683 ;
684 ; This option specifies a preference for which music on hold class this channel
685 ; should listen to when put on hold if the music class has not been set on the
686 ; channel with Set(CHANNEL(musicclass)=whatever) in the dialplan, and the peer
687 ; channel putting this one on hold did not suggest a music class.
688 ;
689 ; If this option is set to "passthrough", then the hold message will always be
690 ; passed through as signalling instead of generating hold music locally. This
691 ; setting is only valid when used on a channel that uses digital signalling.
692 ;
693 ;mohinterpret=default
694 ;
695 ; This option specifies which music on hold class to suggest to the peer channel
696 ; when this channel places the peer on hold. 
697 ;
698 ;mohsuggest=default
699 ;
700 ; PRI channels can have an idle extension and a minunused number.  So long as
701 ; at least "minunused" channels are idle, chan_zap will try to call "idledial"
702 ; on them, and then dump them into the PBX in the "idleext" extension (which
703 ; is of the form exten@context).  When channels are needed the "idle" calls
704 ; are disconnected (so long as there are at least "minidle" calls still
705 ; running, of course) to make more channels available.  The primary use of
706 ; this is to create a dynamic service, where idle channels are bundled through
707 ; multilink PPP, thus more efficiently utilizing combined voice/data services
708 ; than conventional fixed mappings/muxings.
709 ;
710 ; Those settings cannot be changed on reload.
711 ;
712 ;idledial=6999
713 ;idleext=6999@dialout
714 ;minunused=2
715 ;minidle=1
716 ;
717 ; Configure jitter buffers in Zapata (each one is 20ms, default is 4)
718 ; This is set globally, rather than per-channel.
719 ;
720 ;jitterbuffers=4
721 ;
722 ;------------------------------ JITTER BUFFER CONFIGURATION --------------------------
723 ; jbenable = yes              ; Enables the use of a jitterbuffer on the receiving side of a
724                               ; ZAP channel. Defaults to "no". An enabled jitterbuffer will
725                               ; be used only if the sending side can create and the receiving
726                               ; side can not accept jitter. The ZAP channel can't accept jitter,
727                               ; thus an enabled jitterbuffer on the receive ZAP side will always
728                               ; be used if the sending side can create jitter.
729
730 ; jbmaxsize = 200             ; Max length of the jitterbuffer in milliseconds.
731
732 ; jbresyncthreshold = 1000    ; Jump in the frame timestamps over which the jitterbuffer is
733                               ; resynchronized. Useful to improve the quality of the voice, with
734                               ; big jumps in/broken timestamps, usually sent from exotic devices
735                               ; and programs. Defaults to 1000.
736
737 ; jbimpl = fixed              ; Jitterbuffer implementation, used on the receiving side of a ZAP
738                               ; channel. Two implementations are currently available - "fixed"
739                               ; (with size always equals to jbmax-size) and "adaptive" (with
740                               ; variable size, actually the new jb of IAX2). Defaults to fixed.
741
742 ; jblog = no                  ; Enables jitterbuffer frame logging. Defaults to "no".
743 ;-----------------------------------------------------------------------------------
744 ;
745 ; You can define your own custom ring cadences here.  You can define up to 8
746 ; pairs.  If the silence is negative, it indicates where the caller ID spill is
747 ; to be placed.  Also, if you define any custom cadences, the default cadences
748 ; will be turned off.
749 ;
750 ; This setting is global, rather than per-channel. It will not update on
751 ; a reload.
752 ;
753 ; Syntax is:  cadence=ring,silence[,ring,silence[...]]
754 ;
755 ; These are the default cadences:
756 ;
757 ;cadence=125,125,2000,-4000
758 ;cadence=250,250,500,1000,250,250,500,-4000
759 ;cadence=125,125,125,125,125,-4000
760 ;cadence=1000,500,2500,-5000
761 ;
762 ; Each channel consists of the channel number or range.  It inherits the
763 ; parameters that were specified above its declaration.
764 ;
765 ; For GR-303, CRV's are created like channels except they must start with the
766 ; trunk group followed by a colon, e.g.: 
767 ;
768 ; crv => 1:1
769 ; crv => 2:1-2,5-8
770 ;
771 ;
772 ;callerid="Green Phone"<(256) 428-6121>
773 ;channel => 1
774 ;callerid="Black Phone"<(256) 428-6122>
775 ;channel => 2
776 ;callerid="CallerID Phone" <(630) 372-1564>
777 ;channel => 3
778 ;callerid="Pac Tel Phone" <(256) 428-6124>
779 ;channel => 4
780 ;callerid="Uniden Dead" <(256) 428-6125>
781 ;channel => 5
782 ;callerid="Cortelco 2500" <(256) 428-6126>
783 ;channel => 6
784 ;callerid="Main TA 750" <(256) 428-6127>
785 ;channel => 44
786 ;
787 ; For example, maybe we have some other channels which start out in a
788 ; different context and use E & M signalling instead.
789 ;
790 ;context=remote
791 ;sigalling=em
792 ;channel => 15
793 ;channel => 16
794
795 ;signalling=em_w
796 ;
797 ; All those in group 0 I'll use for outgoing calls
798 ;
799 ; Strip most significant digit (9) before sending
800 ;
801 ;stripmsd=1
802 ;callerid=asreceived
803 ;group=0
804 ;signalling=fxs_ls
805 ;channel => 45
806
807 ;signalling=fxo_ls
808 ;group=1
809 ;callerid="Joe Schmoe" <(256) 428-6131>
810 ;channel => 25
811 ;callerid="Megan May" <(256) 428-6132>
812 ;channel => 26
813 ;callerid="Suzy Queue" <(256) 428-6233>
814 ;channel => 27
815 ;callerid="Larry Moe" <(256) 428-6234>
816 ;channel => 28
817 ;
818 ; Sample PRI (CPE) config:  Specify the switchtype, the signalling as either
819 ; pri_cpe or pri_net for CPE or Network termination, and generally you will
820 ; want to create a single "group" for all channels of the PRI.
821 ;
822 ; switchtype cannot be changed on a reload.
823 ;
824 ; switchtype = national
825 ; signalling = pri_cpe
826 ; group = 2
827 ; channel => 1-23
828
829 ;
830
831 ;  Used for distinctive ring support for x100p.
832 ;  You can see the dringX patterns is to set any one of the dringXcontext fields
833 ;  and they will be printed on the console when an inbound call comes in.
834 ;
835 ;  dringXrange is used to change the acceptable ranges for "tone offsets".  Defaults to 10.
836 ;  Note: a range of 0 is NOT what you might expect - it instead forces it to the default.
837 ;  A range of -1 will force it to always match.
838 ;  Anything lower than -1 would presumably cause it to never match.
839 ;
840 ;dring1=95,0,0 
841 ;dring1context=internal1 
842 ;dring1range=10
843 ;dring2=325,95,0 
844 ;dring2context=internal2 
845 ;dring2range=10
846 ; If no pattern is matched here is where we go.
847 ;context=default
848 ;channel => 1 
849
850 ; ---------------- Options for use with signalling=ss7 -----------------
851 ; None of them can be changed by a reload.
852 ;
853 ; Variant of SS7 signalling:
854 ; Options are itu and ansi
855 ;ss7type = itu
856
857 ; SS7 Called Nature of Address Indicator
858 ;
859 ; unknown:        Unknown
860 ; subscriber:     Subscriber
861 ; national:       National
862 ; international:  International
863 ; dynamic:        Dynamically selects the appropriate dialplan
864 ;
865 ;ss7_called_nai=dynamic
866 ;
867 ; SS7 Calling Nature of Address Indicator
868 ;
869 ; unknown:        Unknown
870 ; subscriber:     Subscriber
871 ; national:       National
872 ; international:  International
873 ; dynamic:        Dynamically selects the appropriate dialplan
874 ;
875 ;ss7_calling_nai=dynamic
876 ;
877
878 ; sample 1 for Germany 
879 ;ss7_internationalprefix = 00
880 ;ss7_nationalprefix = 0
881 ;ss7_subscriberprefix = 
882 ;ss7_unknownprefix = 
883 ;
884
885 ; All settings apply to linkset 1
886 ;linkset = 1
887
888 ; Point code of the linkset.  For ITU, this is the decimal number
889 ; format of the point code.  For ANSI, this can either be in decimal
890 ; number format or in the xxx-xxx-xxx format
891 ;pointcode = 1
892
893 ; Point code of node adjacent to this signalling link (Possibly the STP between you and
894 ; your destination).  Point code format follows the same rules as above.
895 ;adjpointcode = 2
896
897 ; Default point code that you would like to assign to outgoing messages (in case of
898 ; routing through STPs, or using A links).  Point code format follows the same rules
899 ; as above.
900 ;defaultdpc = 3
901
902 ; Begin CIC (Circuit indication codes) count with this number
903 ;cicbeginswith = 1
904
905 ; What the MTP3 network indicator bits should be set to.  Choices are
906 ; national, national_spare, international, international_spare
907 ;networkindicator=international
908
909 ; First signalling channel
910 ;sigchan = 48
911
912 ; Channels to associate with CICs on this linkset
913 ;channel = 25-47
914 ;
915 ; For more information on setting up SS7, see the README file in libss7 or
916 ; the doc/ss7.txt file in the Asterisk source tree.
917 ; ----------------- SS7 Options ----------------------------------------
918
919 ; Configuration Sections
920 ; ~~~~~~~~~~~~~~~~~~~~~~
921 ; You can also configure channels in a separate zapata.conf section. In
922 ; this case the keyword 'channel' is not used. Instead the keyword
923 ; 'zapchan' is used (as in users.conf) - configuration is only processed
924 ; in a section where the keyword zapchan is used. It will only be
925 ; processed in the end of the section. Thus the following section:
926 ;
927 ;[phones]
928 ;echocancel = 64
929 ;zapchan = 1-8
930 ;group = 1
931 ;
932 ; Is somewhat equivalent to the following snippet in the section
933 ; [channels]:
934 ;
935 ;echocancel = 64
936 ;group = 1
937 ;channel => 1-8
938 ;
939 ; When starting a new section almost all of the configuration values are
940 ; copied from their values at the end of the section [channels] in
941 ; zapata.conf and [general] in users.conf - one section's configuration
942 ; does not affect another one's.
943 ;
944 ; Instead of letting common configuration values "slide through" you can 
945 ; use configuration templates to easily keep the common part in one
946 ; place and override where needed.
947 ;
948 ;[phones](!)
949 ;echocancel = yes
950 ;group = 0,4
951 ;callgroup = 3
952 ;pickupgroup = 3
953 ;threewaycalling = yes
954 ;transfer = yes
955 ;context = phones
956 ;faxdetect = incoming
957 ;
958 ;[phone-1](phones)
959 ;zapchan = 1
960 ;callerid = My Name <501>
961 ;mailbox = 501@mailboxes
962 ;
963 ;
964 ;[fax](phones)
965 ;zapchan = 2
966 ;faxdetect = no
967 ;context = fax
968 ;
969 ;[phone-3](phones)
970 ;zapchan = 3
971 ;pickupgroup = 3,4