note that group assignments must be from 0 to 63 (issue #7048)
[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
227 ;
228 ; Whether or not to use caller ID
229 ;
230 usecallerid=yes
231 ;
232 ; Type of caller ID signalling in use
233 ;     bell     = bell202 as used in US
234 ;     v23      = v23 as used in the UK
235 ;     v23_jp   = v23 as used in Japan
236 ;     dtmf     = DTMF as used in Denmark, Sweden and Netherlands
237 ;     smdi     = Use SMDI for callerid.  Requires SMDI to be enabled (usesmdi).
238 ;
239 ;cidsignalling=bell
240 ;
241 ; What signals the start of caller ID
242 ;     ring     = a ring signals the start
243 ;     polarity = polarity reversal signals the start
244 ;
245 ;cidstart=ring
246 ;
247 ; Whether or not to hide outgoing caller ID (Override with *67 or *82)
248 ;
249 hidecallerid=no
250 ;
251 ; Whether or not to enable call waiting on FXO lines
252 ;
253 callwaiting=yes
254 ;
255 ; Whether or not restrict outgoing caller ID (will be sent as ANI only, not
256 ; available for the user)
257 ; Mostly use with FXS ports
258 ;
259 ;restrictcid=no
260 ;
261 ; Whether or not use the caller ID presentation for the outgoing call that the
262 ; calling switch is sending.
263 ; See README.callingpres
264 ;
265 usecallingpres=yes
266 ;
267 ; Some countries (UK) have ring tones with different ring tones (ring-ring),
268 ; which means the callerid needs to be set later on, and not just after
269 ; the first ring, as per the default. 
270 ;
271 ;sendcalleridafter=1
272 ;
273 ;
274 ; Support Caller*ID on Call Waiting
275 ;
276 callwaitingcallerid=yes
277 ;
278 ; Support three-way calling
279 ;
280 threewaycalling=yes
281 ;
282 ; Support flash-hook call transfer (requires three way calling)
283 ; Also enables call parking (overrides the 'canpark' parameter)
284 ;
285 transfer=yes
286 ;
287 ; Allow call parking
288 ; ('canpark=no' is overridden by 'transfer=yes')
289 ;
290 canpark=yes
291 ;
292 ; Support call forward variable
293 ;
294 cancallforward=yes
295 ;
296 ; Whether or not to support Call Return (*69)
297 ;
298 callreturn=yes
299 ;
300 ; Stutter dialtone support: If a mailbox is specified without a voicemail 
301 ; context, then when voicemail is received in a mailbox in the default 
302 ; voicemail context in voicemail.conf, taking the phone off hook will cause a
303 ; stutter dialtone instead of a normal one. 
304 ;
305 ; If a mailbox is specified *with* a voicemail context, the same will result
306 ; if voicemail recieved in mailbox in the specified voicemail context.
307 ;
308 ; for default voicemail context, the example below is fine:
309 ;
310 ;mailbox=1234
311 ;
312 ; for any other voicemail context, the following will produce the stutter tone:
313 ;
314 ;mailbox=1234@context 
315 ;
316 ; Enable echo cancellation 
317 ; Use either "yes", "no", or a power of two from 32 to 256 if you wish to
318 ; actually set the number of taps of cancellation.
319 ;
320 echocancel=yes
321 ;
322 ; Generally, it is not necessary (and in fact undesirable) to echo cancel when
323 ; the circuit path is entirely TDM.  You may, however, reverse this behavior
324 ; by enabling the echo cancel during pure TDM bridging below.
325 ;
326 echocancelwhenbridged=yes
327 ;
328 ; In some cases, the echo canceller doesn't train quickly enough and there
329 ; is echo at the beginning of the call.  Enabling echo training will cause
330 ; asterisk to briefly mute the channel, send an impulse, and use the impulse
331 ; response to pre-train the echo canceller so it can start out with a much
332 ; closer idea of the actual echo.  Value may be "yes", "no", or a number of
333 ; milliseconds to delay before training (default = 400)
334 ;
335 ;echotraining=yes
336 ;echotraining=800
337 ;
338 ; If you are having trouble with DTMF detection, you can relax the DTMF
339 ; detection parameters.  Relaxing them may make the DTMF detector more likely
340 ; to have "talkoff" where DTMF is detected when it shouldn't be.
341 ;
342 ;relaxdtmf=yes
343 ;
344 ; You may also set the default receive and transmit gains (in dB)
345 ;
346 rxgain=0.0
347 txgain=0.0
348 ;
349 ; Logical groups can be assigned to allow outgoing rollover.  Groups range
350 ; from 0 to 63, and multiple groups can be specified.
351 ;
352 group=1
353 ;
354 ; Ring groups (a.k.a. call groups) and pickup groups.  If a phone is ringing
355 ; and it is a member of a group which is one of your pickup groups, then
356 ; you can answer it by picking up and dialing *8#.  For simple offices, just
357 ; make these both the same.  Groups range from 0 to 63.
358 ;
359 callgroup=1
360 pickupgroup=1
361
362 ;
363 ; Specify whether the channel should be answered immediately or if the simple
364 ; switch should provide dialtone, read digits, etc.
365 ;
366 immediate=no
367 ;
368 ; Specify whether flash-hook transfers to 'busy' channels should complete or
369 ; return to the caller performing the transfer (default is yes).
370 ;
371 ;transfertobusy=no
372 ;
373 ; CallerID can be set to "asreceived" or a specific number if you want to
374 ; override it.  Note that "asreceived" only applies to trunk interfaces.
375 ;
376 ;callerid=2564286000
377 ;
378 ; AMA flags affects the recording of Call Detail Records.  If specified
379 ; it may be 'default', 'omit', 'billing', or 'documentation'.
380 ;
381 ;amaflags=default
382 ;
383 ; Channels may be associated with an account code to ease
384 ; billing
385 ;
386 ;accountcode=lss0101
387 ;
388 ; ADSI (Analog Display Services Interface) can be enabled on a per-channel
389 ; basis if you have (or may have) ADSI compatible CPE equipment
390 ;
391 ;adsi=yes
392 ;
393 ; SMDI (Simplified Message Desk Interface) can be enabled on a per-channel
394 ; basis if you would like that channel to behave like an SMDI message desk.
395 ; The SMDI port specfied should have already been defined in smdi.conf.  The
396 ; default port is /dev/ttyS0.
397 ;
398 ;usesmdi=yes
399 ;smdiport=/dev/ttyS0
400 ;
401 ; On trunk interfaces (FXS) and E&M interfaces (E&M, Wink, Feature Group D
402 ; etc, it can be useful to perform busy detection either in an effort to 
403 ; detect hangup or for detecting busies.  This enables listening for
404 ; the beep-beep busy pattern.
405 ;
406 ;busydetect=yes
407 ;
408 ; If busydetect is enabled, it is also possible to specify how many busy tones
409 ; to wait for before hanging up.  The default is 4, but better results can be
410 ; achieved if set to 6 or even 8.  Mind that the higher the number, the more
411 ; time that will be needed to hangup a channel, but lowers the probability
412 ; that you will get random hangups.
413 ;
414 ;busycount=4
415 ;
416 ; If busydetect is enabled, it is also possible to specify the cadence of your
417 ; busy signal.  In many countries, it is 500msec on, 500msec off.  Without
418 ; busypattern specified, we'll accept any regular sound-silence pattern that
419 ; repeats <busycount> times as a busy signal.  If you specify busypattern,
420 ; then we'll further check the length of the sound (tone) and silence, which
421 ; will further reduce the chance of a false positive.
422 ;
423 ;busypattern=500,500
424 ;
425 ; NOTE: In the Asterisk Makefile you'll find further options to tweak the busy
426 ; detector.  If your country has a busy tone with the same length tone and
427 ; silence (as many countries do), consider defining the
428 ; -DBUSYDETECT_COMPARE_TONE_AND_SILENCE option.
429 ;
430 ; Use a polarity reversal to mark when a outgoing call is answered by the
431 ; remote party.
432 ;
433 ;answeronpolarityswitch=yes
434 ;
435 ; In some countries, a polarity reversal is used to signal the disconnect of a
436 ; phone line.  If the hanguponpolarityswitch option is selected, the call will
437 ; be considered "hung up" on a polarity reversal.
438 ;
439 ;hanguponpolarityswitch=yes
440 ;
441 ; On trunk interfaces (FXS) it can be useful to attempt to follow the progress
442 ; of a call through RINGING, BUSY, and ANSWERING.   If turned on, call
443 ; progress attempts to determine answer, busy, and ringing on phone lines.
444 ; This feature is HIGHLY EXPERIMENTAL and can easily detect false answers,
445 ; so don't count on it being very accurate.
446 ;
447 ; Few zones are supported at the time of this writing, but may be selected
448 ; with "progzone"
449 ;
450 ; This feature can also easily detect false hangups. The symptoms of this is
451 ; being disconnected in the middle of a call for no reason.
452 ;
453 ;callprogress=yes
454 ;progzone=us
455 ;
456 ; FXO (FXS signalled) devices must have a timeout to determine if there was a
457 ; hangup before the line was answered.  This value can be tweaked to shorten
458 ; how long it takes before Zap considers a non-ringing line to have hungup.
459 ;
460 ;ringtimeout=8000
461 ;
462 ; For FXO (FXS signalled) devices, whether to use pulse dial instead of DTMF
463 ;
464 ;pulsedial=yes
465 ;
466 ; For fax detection, uncomment one of the following lines.  The default is *OFF*
467 ;
468 ;faxdetect=both
469 ;faxdetect=incoming
470 ;faxdetect=outgoing
471 ;faxdetect=no
472 ;
473 ; Select which class of music to use for music on hold.  If not specified
474 ; then the default will be used.
475 ;
476 ;musicclass=default
477 ;
478 ; PRI channels can have an idle extension and a minunused number.  So long as
479 ; at least "minunused" channels are idle, chan_zap will try to call "idledial"
480 ; on them, and then dump them into the PBX in the "idleext" extension (which
481 ; is of the form exten@context).  When channels are needed the "idle" calls
482 ; are disconnected (so long as there are at least "minidle" calls still
483 ; running, of course) to make more channels available.  The primary use of
484 ; this is to create a dynamic service, where idle channels are bundled through
485 ; multilink PPP, thus more efficiently utilizing combined voice/data services
486 ; than conventional fixed mappings/muxings.
487 ;
488 ;idledial=6999
489 ;idleext=6999@dialout
490 ;minunused=2
491 ;minidle=1
492 ;
493 ; Configure jitter buffers in zapata (each one is 20ms, default is 4)
494 ;
495 ;jitterbuffers=4
496 ;
497 ; You can define your own custom ring cadences here.  You can define up to 8
498 ; pairs.  If the silence is negative, it indicates where the callerid spill is
499 ; to be placed.  Also, if you define any custom cadences, the default cadences
500 ; will be turned off.
501 ;
502 ; Syntax is:  cadence=ring,silence[,ring,silence[...]]
503 ;
504 ; These are the default cadences:
505 ;
506 ;cadence=125,125,2000,-4000
507 ;cadence=250,250,500,1000,250,250,500,-4000
508 ;cadence=125,125,125,125,125,-4000
509 ;cadence=1000,500,2500,-5000
510 ;
511 ; Each channel consists of the channel number or range.  It inherits the
512 ; parameters that were specified above its declaration.
513 ;
514 ; For GR-303, CRV's are created like channels except they must start with the
515 ; trunk group followed by a colon, e.g.: 
516 ;
517 ; crv => 1:1
518 ; crv => 2:1-2,5-8
519 ;
520 ;
521 ;callerid="Green Phone"<(256) 428-6121>
522 ;channel => 1
523 ;callerid="Black Phone"<(256) 428-6122>
524 ;channel => 2
525 ;callerid="CallerID Phone" <(256) 428-6123>
526 ;callerid="CallerID Phone" <(630) 372-1564>
527 ;callerid="CallerID Phone" <(256) 704-4666>
528 ;channel => 3
529 ;callerid="Pac Tel Phone" <(256) 428-6124>
530 ;channel => 4
531 ;callerid="Uniden Dead" <(256) 428-6125>
532 ;channel => 5
533 ;callerid="Cortelco 2500" <(256) 428-6126>
534 ;channel => 6
535 ;callerid="Main TA 750" <(256) 428-6127>
536 ;channel => 44
537 ;
538 ; For example, maybe we have some other channels which start out in a
539 ; different context and use E & M signalling instead.
540 ;
541 ;context=remote
542 ;sigalling=em
543 ;channel => 15
544 ;channel => 16
545
546 ;signalling=em_w
547 ;
548 ; All those in group 0 I'll use for outgoing calls
549 ;
550 ; Strip most significant digit (9) before sending
551 ;
552 ;stripmsd=1
553 ;callerid=asreceived
554 ;group=0
555 ;signalling=fxs_ls
556 ;channel => 45
557
558 ;signalling=fxo_ls
559 ;group=1
560 ;callerid="Joe Schmoe" <(256) 428-6131>
561 ;channel => 25
562 ;callerid="Megan May" <(256) 428-6132>
563 ;channel => 26
564 ;callerid="Suzy Queue" <(256) 428-6233>
565 ;channel => 27
566 ;callerid="Larry Moe" <(256) 428-6234>
567 ;channel => 28
568 ;
569 ; Sample PRI (CPE) config:  Specify the switchtype, the signalling as either
570 ; pri_cpe or pri_net for CPE or Network termination, and generally you will
571 ; want to create a single "group" for all channels of the PRI.
572 ;
573 ; switchtype = national
574 ; signalling = pri_cpe
575 ; group = 2
576 ; channel => 1-23
577
578 ;
579
580 ;  Used for distintive ring support for x100p.
581 ;  You can see the dringX patterns is to set any one of the dringXcontext fields
582 ;  and they will be printed on the console when an inbound call comes in.
583 ;
584 ;dring1=95,0,0 
585 ;dring1context=internal1 
586 ;dring2=325,95,0 
587 ;dring2context=internal2 
588 ; If no pattern is matched here is where we go.
589 ;context=default
590 ;channel => 1 
591