Add support for ring begin event and configurable ringtimeout.
[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', '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 channels, defaults to 3600
107 ; minimum 60 seconds
108 ; some PBXs don't like 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 ; ISDN Timers
128 ; All of the ISDN timers and counters that are used are configurable.  Specify 
129 ; the timer name, and its value (in ms for timers)
130 ;
131 ; pritimer => t200,1000
132 ; pritimer => t313,4000
133 ;
134 ; To enable transmission of facility-based ISDN supplementary services (such
135 ; as caller name from CPE over facility) enable this option.
136 ; facilityenable = yes
137 ;
138 ;
139 ; Signalling method (default is fxs).  Valid values:
140 ; em:      E & M
141 ; em_w:    E & M Wink
142 ; featd:   Feature Group D (The fake, Adtran style, DTMF)
143 ; featdmf: Feature Group D (The real thing, MF (domestic, US))
144 ; featdmf_ta : Feature Group D (The real thing, MF (domestic, US)) through a Tandem Access point
145 ; featb:   Feature Group B (MF (domestic, US))
146 ; fxs_ls:  FXS (Loop Start)
147 ; fxs_gs:  FXS (Ground Start)
148 ; fxs_ks:  FXS (Kewl Start)
149 ; fxo_ls:  FXO (Loop Start)
150 ; fxo_gs:  FXO (Ground Start)
151 ; fxo_ks:  FXO (Kewl Start)
152 ; pri_cpe: PRI signalling, CPE side
153 ; pri_net: PRI signalling, Network side
154 ; gr303fxoks_net: GR-303 Signalling, FXO Loopstart, Network side
155 ; gr303fxsks_cpe: GR-303 Signalling, FXS Loopstart, CPE side
156 ; sf:         SF (Inband Tone) Signalling
157 ; sf_w:       SF Wink
158 ; sf_featd:   SF Feature Group D (The fake, Adtran style, DTMF)
159 ; sf_featdmf: SF Feature Group D (The real thing, MF (domestic, US))
160 ; sf_featb:   SF Feature Group B (MF (domestic, US))
161 ; e911:    E911 (MF) style signalling
162 ; The following are used for Radio interfaces:
163 ; fxs_rx:  Receive audio/COR on an FXS kewlstart interface (FXO at the channel bank)
164 ; fxs_tx:  Transmit audio/PTT on an FXS loopstart interface (FXO at the channel bank)
165 ; fxo_rx:  Receive audio/COR on an FXO loopstart interface (FXS at the channel bank)
166 ; fxo_tx:  Transmit audio/PTT on an FXO groundstart interface (FXS at the channel bank)
167 ; em_rx:   Receive audio/COR on an E&M interface (1-way)
168 ; em_tx:   Transmit audio/PTT on an E&M interface (1-way)
169 ; em_txrx: Receive audio/COR AND Transmit audio/PTT on an E&M interface (2-way)
170 ; em_rxtx: same as em_txrx (for our dyslexic friends)
171 ; sf_rx:   Receive audio/COR on an SF interface (1-way)
172 ; sf_tx:   Transmit audio/PTT on an SF interface (1-way)
173 ; sf_txrx: Receive audio/COR AND Transmit audio/PTT on an SF interface (2-way)
174 ; sf_rxtx: same as sf_txrx (for our dyslexic friends)
175 ;
176 signalling=fxo_ls
177 ;
178 ; For Feature Group D Tandem access, to set the default CIC and OZZ use
179 ; these parameters:
180 ;defaultozz=0000
181 ;defaultcic=303
182 ;
183 ; A variety of timing parameters can be specified as well
184 ; Including:
185 ;    prewink:     Pre-wink time (default 50ms)
186 ;    preflash:    Pre-flash time (default 50ms)
187 ;    wink:        Wink time (default 150ms)
188 ;    flash:       Flash time (default 750ms)
189 ;    start:       Start time (default 1500ms)
190 ;    rxwink:      Receiver wink time (default 300ms)
191 ;    rxflash:     Receiver flashtime (default 1250ms)
192 ;    debounce:    Debounce timing (default 600ms)
193 ;    emdigitwait: Time to wait for DID digits on E&M links (default 250ms) (Increase to 500
194 ;                 or so if you are not getting all DID digits on your E&M link)
195 ;
196 rxwink=300              ; Atlas seems to use long (250ms) winks
197 ;
198 ; How long generated tones (DTMF and MF) will be played on the channel (in miliseconds)
199 ;toneduration=100
200 ;
201 ; Whether or not to do distinctive ring detection on FXO lines
202 ;
203 ;usedistinctiveringdetection=yes
204
205 ;
206 ; Whether or not to use caller ID
207 ;
208 usecallerid=yes
209 ;
210 ; Type of caller ID signalling in use
211 ; bell = bell202 as used in US, v23 = v23 as used in the UK, dtmf = DTMF as used in Denmark, Sweden and Netherlands
212 ;
213 ;cidsignalling=bell
214 ;
215 ; What signals the start of caller ID
216 ; ring = a ring signals the start, polarity = polarity reversal signals the start
217 ;
218 ;cidstart=ring
219 ;
220 ; Whether or not to hide outgoing caller ID (Override with *67 or *82)
221 ;
222 hidecallerid=no
223 ;
224 ; Whether or not to enable call waiting on FXO lines
225 ;
226 callwaiting=yes
227 ;
228 ; Whether or not restrict outgoing caller ID (will be sent as ANI only, not available for the user)
229 ; Mostly use with FXS ports
230 ;
231 ;restrictcid=no
232 ;
233 ; Whether or not use the caller ID presentation for the outgoing call that the calling switch is sending
234 ;
235 usecallingpres=yes
236 ;
237 ; Some countries (UK) have ring tones with different ring tones (ring-ring),
238 ; which means the callerid needs to be set later on, and not just after
239 ; the first ring, as per the default. 
240 ;
241 ;sendcalleridafter=1
242 ;
243 ;
244 ; Support Caller*ID on Call Waiting
245 ;
246 callwaitingcallerid=yes
247 ;
248 ; Support three-way calling
249 ;
250 threewaycalling=yes
251 ;
252 ; Support flash-hook call transfer (requires three way calling)
253 ; Also enables call parking (overrides the 'canpark' parameter)
254 ;
255 transfer=yes
256 ;
257 ; Allow call parking
258 ; ('canpark=no' is overridden by 'transfer=yes')
259 ;
260 canpark=yes
261 ;
262 ; Support call forward variable
263 ;
264 cancallforward=yes
265 ;
266 ; Whether or not to support Call Return (*69)
267 ;
268 callreturn=yes
269 ;
270 ; Stutter dialtone support: If a mailbox is specified without a voicemail 
271 ; context, then when voicemail is received in a mailbox in the default 
272 ; voicemail context in voicemail.conf, taking the phone off hook will 
273 ; cause a stutter dialtone instead of a normal one. 
274 ;
275 ; If a mailbox is specified *with* a voicemail context, the same will 
276 ; result if voicemail recieved in mailbox in the specified voicemail 
277 ; context
278 ;
279 ; for default voicemail context, the example below is fine:
280 ;
281 ;mailbox=1234
282 ;
283 ; for any other voicemail context, the following will produce the 
284 ; stutter tone:
285 ;
286 ;mailbox=1234@context 
287 ;
288 ; Enable echo cancellation 
289 ; Use either "yes", "no", or a power of two from 32 to 256 if you wish
290 ; to actually set the number of taps of cancellation.
291 ;
292 echocancel=yes
293 ;
294 ; Generally, it is not necessary (and in fact undesirable) to echo cancel
295 ; when the circuit path is entirely TDM.  You may, however, reverse this
296 ; behavior by enabling the echo cancel during pure TDM bridging below.
297 ;
298 echocancelwhenbridged=yes
299 ;
300 ; In some cases, the echo canceller doesn't train quickly enough and there
301 ; is echo at the beginning of the call.  Enabling echo training will cause
302 ; asterisk to briefly mute the channel, send an impulse, and use the impulse
303 ; response to pre-train the echo canceller so it can start out with a much
304 ; closer idea of the actual echo.  Value may be "yes", "no", or a number of
305 ; milliseconds to delay before training (default = 400)
306 ;
307 ;echotraining=yes
308 ;echotraining=800
309 ;
310 ; If you are having trouble with DTMF detection, you can relax the
311 ; DTMF detection parameters.  Relaxing them may make the DTMF detector
312 ; more likely to have "talkoff" where DTMF is detected when it
313 ; shouldn't be.
314 ;
315 ;relaxdtmf=yes
316 ;
317 ; You may also set the default receive and transmit gains (in dB)
318 ;
319 rxgain=0.0
320 txgain=0.0
321 ;
322 ; Logical groups can be assigned to allow outgoing rollover.  Groups
323 ; range from 0 to 63, and multiple groups can be specified.
324 ;
325 group=1
326 ;
327 ; Ring groups (a.k.a. call groups) and pickup groups.  If a phone is ringing
328 ; and it is a member of a group which is one of your pickup groups, then
329 ; you can answer it by picking up and dialing *8#.  For simple offices, just
330 ; make these both the same
331 ;
332 callgroup=1
333 pickupgroup=1
334
335 ;
336 ; Specify whether the channel should be answered immediately or
337 ; if the simple switch should provide dialtone, read digits, etc.
338 ;
339 immediate=no
340 ;
341 ; Specify whether flash-hook transfers to 'busy' channels should complete
342 ; or return to the caller performing the transfer (default is yes).
343 ;
344 ;transfertobusy=no
345 ;
346 ; CallerID can be set to "asreceived" or a specific number
347 ; if you want to override it.  Note that "asreceived" only
348 ; applies to trunk interfaces.
349 ;
350 ;callerid=2564286000
351 ;
352 ; AMA flags affects the recording of Call Detail Records.  If specified
353 ; it may be 'default', 'omit', 'billing', or 'documentation'.
354 ;
355 ;amaflags=default
356 ;
357 ; Channels may be associated with an account code to ease
358 ; billing
359 ;
360 ;accountcode=lss0101
361 ;
362 ; ADSI (Analog Display Services Interface) can be enabled on a per-channel
363 ; basis if you have (or may have) ADSI compatible CPE equipment
364 ;
365 ;adsi=yes
366 ;
367 ; On trunk interfaces (FXS) and E&M interfaces (E&M, Wink, Feature Group D
368 ; etc, it can be useful to perform busy detection either in an effort to 
369 ; detect hangup or for detecting busies.  This enables listening for
370 ; the beep-beep busy pattern.
371 ;
372 ;busydetect=yes
373 ;
374 ; If busydetect is enabled, is also possible to specify how many
375 ; busy tones to wait for before hanging up. The default is 4, but
376 ; better results can be achieved if set to 6 or even 8. Mind that
377 ; higher the number, more time is needed to hangup a channel, but
378 ; lower is probability to get random hangups
379 ;
380 ;busycount=4
381 ;
382 ; If busydetect is enabled, is also possible to specify the
383 ; cadence of your busy signal.  In many countries it is 500mec
384 ; on, 500msec off.
385 ; Without busypattern specified, we'll accept any regular
386 ; sound-silence pattern than repeats busycount times as a busy
387 ; signal.
388 ; If you specify busypattern then we'll further check the length
389 ; of the sound (tone) and silence, which will further reduce the
390 ; chance of a false positive.
391 ;
392 ;busypattern=500,500
393 ;
394 ; NOTE: In the Asterisk Makefile you'll find further options to tweak
395 ; the busy detector.  If your country has a busy tone with the same
396 ; lengh tone and silence (as many countries do), consider defining
397 ; the -DBUSYDETECT_COMPARE_TONE_AND_SILENCE option.
398 ;
399 ; Use a polarity reversal to mark when a outgoing call is answered by the
400 ; remote party.
401 ;
402 ;answeronpolarityswitch=yes
403 ;
404 ; In some countries, a polarity reversal is used to signal the disconnect
405 ; of a phone line.  If the hanguponpolarityswitch option is selected, the
406 ; call will be considered "hung up" on a polarity reversal
407 ;
408 ;hanguponpolarityswitch=yes
409 ;
410 ; On trunk interfaces (FXS) it can be useful to attempt to follow the progress
411 ; of a call through RINGING, BUSY, and ANSWERING.   If turned on, call
412 ; progress attempts to determine answer, busy, and ringing on phone lines.
413 ; This feature is HIGHLY EXPERIMENTAL and can easily detect false answers,
414 ; so don't count on it being very accurate.  
415 ;
416 ; Few zones are supported at the time of this writing, but may
417 ; be selected with "progzone"
418 ;
419 ; This feature can also easily detect false hangups. The symptoms of this 
420 ; is being disconnected in the middle of a call for no reason.
421 ;
422 ;callprogress=yes
423 ;progzone=us
424 ;
425 ; FXO (FXS signalled) devices must have a timeout to determine whe there was a
426 ; hangup before the line was answered.  This value can be tweaked to shorten
427 ; how long it takes before Zap considers a non-ringing line to have hungup.
428 ;
429 ;ringtimeout=8000
430 ;
431 ; For FXO (FXS signalled) devices, whether to use pulse dial instead of DTMF
432 ;
433 ;pulsedial=yes
434 ;
435 ; For fax detection, uncomment one of the following lines.  The default is *OFF*
436 ;
437 ;faxdetect=both
438 ;faxdetect=incoming
439 ;faxdetect=outgoing
440 ;faxdetect=no
441 ;
442 ; Select which class of music to use for music on hold.  If not specified
443 ; then the default will be used.
444 ;
445 ;musiconhold=default
446 ;
447 ; PRI channels can have an idle extension and a minunused number.  So long
448 ; as at least "minunused" channels are idle, chan_zap will try to call
449 ; "idledial" on them, and then dump them into the PBX in the "idleext"
450 ; extension (which is of the form exten@context).  When channels are needed
451 ; the "idle" calls are disconnected (so long as there are at least "minidle"
452 ; calls still running, of course) to make more channels available.  The
453 ; primary use of this is to create a dynamic service, where idle channels
454 ; are bundled through multilink PPP, thus more efficiently utilizing
455 ; combined voice/data services than conventional fixed mappings/muxings.
456 ;
457 ;idledial=6999
458 ;idleext=6999@dialout
459 ;minunused=2
460 ;minidle=1
461 ;
462 ; Configure jitter buffers in zapata (each one is 20ms, default is 4)
463 ;
464 ;jitterbuffers=4
465 ;
466 ; You can define your own custom ring cadences here.  You can define up to
467 ; 8 pairs.  If the silence is negative, it indicates where the callerid
468 ; spill is to be placed.  Also, if you define any custom cadences, the
469 ; default cadences will be turned off.
470 ;
471 ; Syntax is:  cadence=ring,silence[,ring,silence[...]]
472 ;
473 ; These are the default cadences:
474 ;
475 ;cadence=125,125,2000,-4000
476 ;cadence=250,250,500,1000,250,250,500,-4000
477 ;cadence=125,125,125,125,125,-4000
478 ;cadence=1000,500,2500,-5000
479 ;
480 ; Each channel consists of the channel number or range.  It
481 ; inherits the parameters that were specified above its declaration
482 ;
483 ; For GR-303, CRV's are created like channels except they must start
484 ; with the trunk group followed by a colon, e.g.: 
485 ;
486 ; crv => 1:1
487 ; crv => 2:1-2,5-8
488 ;
489 ;
490 ;callerid="Green Phone"<(256) 428-6121>
491 ;channel => 1
492 ;callerid="Black Phone"<(256) 428-6122>
493 ;channel => 2
494 ;callerid="CallerID Phone" <(256) 428-6123>
495 ;callerid="CallerID Phone" <(630) 372-1564>
496 ;callerid="CallerID Phone" <(256) 704-4666>
497 ;channel => 3
498 ;callerid="Pac Tel Phone" <(256) 428-6124>
499 ;channel => 4
500 ;callerid="Uniden Dead" <(256) 428-6125>
501 ;channel => 5
502 ;callerid="Cortelco 2500" <(256) 428-6126>
503 ;channel => 6
504 ;callerid="Main TA 750" <(256) 428-6127>
505 ;channel => 44
506 ;
507 ; For example, maybe we have some other channels
508 ; which start out in a different context and use
509 ; E & M signalling instead.
510 ;
511 ;context=remote
512 ;sigalling=em
513 ;channel => 15
514 ;channel => 16
515
516 ;signalling=em_w
517 ;
518 ; All those in group 0 I'll use for outgoing calls
519 ;
520 ; Strip most significant digit (9) before sending
521 ;
522 ;stripmsd=1
523 ;callerid=asreceived
524 ;group=0
525 ;signalling=fxs_ls
526 ;channel => 45
527
528 ;signalling=fxo_ls
529 ;group=1
530 ;callerid="Joe Schmoe" <(256) 428-6131>
531 ;channel => 25
532 ;callerid="Megan May" <(256) 428-6132>
533 ;channel => 26
534 ;callerid="Suzy Queue" <(256) 428-6233>
535 ;channel => 27
536 ;callerid="Larry Moe" <(256) 428-6234>
537 ;channel => 28
538 ;
539 ; Sample PRI (CPE) config:  Specify the switchtype, the signalling as
540 ; either pri_cpe or pri_net for CPE or Network termination, and generally
541 ; you will want to create a single "group" for all channels of the PRI.
542 ;
543 ; switchtype = national
544 ; signalling = pri_cpe
545 ; group = 2
546 ; channel => 1-23
547
548 ;
549
550 ;  Used for distintive ring support for x100p.
551 ;  You can see the dringX patterns is to set any one of the dringXcontext fields
552 ;  and they will be printed on the console when an inbound call comes in.
553 ;
554 ;dring1=95,0,0 
555 ;dring1context=internal1 
556 ;dring2=325,95,0 
557 ;dring2context=internal2 
558 ; If no pattern is matched here is where we go.
559 ;context=default
560 ;channel => 1 
561