2 ; Zapata telephony interface
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.
16 ; Trunk groups are used for NFAS or GR-303 connections.
18 ; Group: Defines a trunk group.
19 ; trunkgroup => <trunkgroup>,<dchannel>[,<backup1>...]
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.
26 ;trunkgroup => 1,24,48
29 ; Spanmap: Associates a span with a trunk group
30 ; spanmap => <zapspan>,<trunkgroup>[,<logicalspan>]
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.
52 ; Switchtype: Only used for PRI.
54 ; national: National ISDN 2 (default)
55 ; dms100: Nortel DMS100
59 ; ni1: Old National ISDN 1
64 ; Some switches (AT&T especially) require network specific facility IE
65 ; supported values are currently 'none', 'sdn', 'megacom', 'tollfreemegacom', 'accunet'
69 ; PRI Dialplan: Only RARELY used for PRI.
72 ; private: Private ISDN
74 ; national: National ISDN
75 ; international: International ISDN
76 ; dynamic: Dynamically selects the appropriate dialplan
80 ; PRI Local Dialplan: Only RARELY used for PRI (sets the calling number's numbering plan)
83 ; private: Private ISDN
85 ; national: National ISDN
86 ; international: International ISDN
87 ; dynamic: Dynamically selects the appropriate dialplan
89 ;prilocaldialplan=national
91 ; PRI callerid prefixes based on the given TON/NPI (dialplan)
92 ; This is especially needed for euroisdn E1-PRIs
94 ; sample 1 for Germany
95 ;internationalprefix = 00
98 ;privateprefix = 07115678
101 ; sample 2 for Germany
102 ;internationalprefix = +
103 ;nationalprefix = +49
104 ;localprefix = +49711
105 ;privateprefix = +497115678
108 ; PRI resetinterval: sets the time in seconds between restart of unused
109 ; channels, defaults to 3600; minimum 60 seconds. Some PBXs don't like
110 ; channel restarts. so set the interval to a very long interval e.g. 100000000
111 ; or 'never' to disable *entirely*.
113 ;resetinterval = 3600
115 ; Overlap dialing mode (sending overlap digits)
119 ; PRI Out of band indications.
120 ; Enable this to report Busy and Congestion on a PRI using out-of-band
121 ; notification. Inband indication, as used by Asterisk doesn't seem to work
124 ; outofband: Signal Busy/Congestion out of band with RELEASE/DISCONNECT
125 ; inband: Signal Busy/Congestion using in-band tones
127 ; priindication = outofband
129 ; If you need to override the existing channels selection routine and force all
130 ; PRI channels to be marked as exclusively selected, set this to yes.
134 ; All of the ISDN timers and counters that are used are configurable. Specify
135 ; the timer name, and its value (in ms for timers).
136 ; K: Layer 2 max number of outstanding unacknowledged I frames (default 7)
137 ; N200: Layer 2 max number of retransmissions of a frame (default 3)
138 ; T200: Layer 2 max time before retransmission of a frame (default 1000 ms)
139 ; T203: Layer 2 max time without frames being exchanged (default 10000 ms)
140 ; T305: Wait for DISCONNECT acknowledge (default 30000 ms)
141 ; T308: Wait for RELEASE acknowledge (default 4000 ms)
142 ; T309: Maintain active calls on Layer 2 disconnection (default -1, Asterisk clears calls)
143 ; EuroISDN: 6000 to 12000 ms, according to (N200 + 1) x T200 + 2s
144 ; May vary in other ISDN standards (Q.931 1993 : 90000 ms)
145 ; T313: Wait for CONNECT acknowledge, CPE side only (default 3000 ms)
147 ; pritimer => t200,1000
148 ; pritimer => t313,4000
150 ; To enable transmission of facility-based ISDN supplementary services (such
151 ; as caller name from CPE over facility), enable this option.
152 ; facilityenable = yes
155 ; Signalling method (default is fxs). Valid values:
158 ; featd: Feature Group D (The fake, Adtran style, DTMF)
159 ; featdmf: Feature Group D (The real thing, MF (domestic, US))
160 ; featdmf_ta: Feature Group D (The real thing, MF (domestic, US)) through
161 ; a Tandem Access point
162 ; featb: Feature Group B (MF (domestic, US))
163 ; fgccama Feature Group C-CAMA (DP DNIS, MF ANI)
164 ; fgccamamf Feature Group C-CAMA MF (MF DNIS, MF ANI)
165 ; fxs_ls: FXS (Loop Start)
166 ; fxs_gs: FXS (Ground Start)
167 ; fxs_ks: FXS (Kewl Start)
168 ; fxo_ls: FXO (Loop Start)
169 ; fxo_gs: FXO (Ground Start)
170 ; fxo_ks: FXO (Kewl Start)
171 ; pri_cpe: PRI signalling, CPE side
172 ; pri_net: PRI signalling, Network side
173 ; gr303fxoks_net: GR-303 Signalling, FXO Loopstart, Network side
174 ; gr303fxsks_cpe: GR-303 Signalling, FXS Loopstart, CPE side
175 ; sf: SF (Inband Tone) Signalling
177 ; sf_featd: SF Feature Group D (The fake, Adtran style, DTMF)
178 ; sf_featdmf: SF Feature Group D (The real thing, MF (domestic, US))
179 ; sf_featb: SF Feature Group B (MF (domestic, US))
180 ; e911: E911 (MF) style signalling
182 ; The following are used for Radio interfaces:
183 ; fxs_rx: Receive audio/COR on an FXS kewlstart interface (FXO at the
185 ; fxs_tx: Transmit audio/PTT on an FXS loopstart interface (FXO at the
187 ; fxo_rx: Receive audio/COR on an FXO loopstart interface (FXS at the
189 ; fxo_tx: Transmit audio/PTT on an FXO groundstart interface (FXS at
191 ; em_rx: Receive audio/COR on an E&M interface (1-way)
192 ; em_tx: Transmit audio/PTT on an E&M interface (1-way)
193 ; em_txrx: Receive audio/COR AND Transmit audio/PTT on an E&M interface
195 ; em_rxtx: Same as em_txrx (for our dyslexic friends)
196 ; sf_rx: Receive audio/COR on an SF interface (1-way)
197 ; sf_tx: Transmit audio/PTT on an SF interface (1-way)
198 ; sf_txrx: Receive audio/COR AND Transmit audio/PTT on an SF interface
200 ; sf_rxtx: Same as sf_txrx (for our dyslexic friends)
204 ; If you have an outbound signalling format that is different from format
205 ; specified above (but compatible), you can specify outbound signalling format,
206 ; (see below). The 'signalling' format specified will be the inbound signalling
207 ; format. If you only specify 'signalling', then it will be the format for
208 ; both inbound and outbound.
211 ; outsignalling=featb
213 ; For Feature Group D Tandem access, to set the default CIC and OZZ use these
218 ; A variety of timing parameters can be specified as well
220 ; prewink: Pre-wink time (default 50ms)
221 ; preflash: Pre-flash time (default 50ms)
222 ; wink: Wink time (default 150ms)
223 ; flash: Flash time (default 750ms)
224 ; start: Start time (default 1500ms)
225 ; rxwink: Receiver wink time (default 300ms)
226 ; rxflash: Receiver flashtime (default 1250ms)
227 ; debounce: Debounce timing (default 600ms)
229 rxwink=300 ; Atlas seems to use long (250ms) winks
231 ; How long generated tones (DTMF and MF) will be played on the channel
235 ; Whether or not to do distinctive ring detection on FXO lines
237 ;usedistinctiveringdetection=yes
238 ;distinctiveringaftercid=yes ; enable dring detection after callerid for those countries like Australia
239 ; where the ring cadence is changed *after* the callerid spill.
241 ; Whether or not to use caller ID
245 ; Type of caller ID signalling in use
246 ; bell = bell202 as used in US
247 ; v23 = v23 as used in the UK
248 ; v23_jp = v23 as used in Japan
249 ; dtmf = DTMF as used in Denmark, Sweden and Netherlands
250 ; smdi = Use SMDI for callerid. Requires SMDI to be enabled (usesmdi).
254 ; What signals the start of caller ID
255 ; ring = a ring signals the start
256 ; polarity = polarity reversal signals the start
260 ; Whether or not to hide outgoing caller ID (Override with *67 or *82)
264 ; Whether or not to enable call waiting on internal extensions
265 ; With this set to 'yes', busy extensions will hear the call-waiting
266 ; tone, and can use hook-flash to switch between callers. The Dial()
267 ; app will not return the "BUSY" result for extensions.
271 ; Whether or not restrict outgoing caller ID (will be sent as ANI only, not
272 ; available for the user)
273 ; Mostly use with FXS ports
277 ; Whether or not use the caller ID presentation for the outgoing call that the
278 ; calling switch is sending.
279 ; See README.callingpres
283 ; Some countries (UK) have ring tones with different ring tones (ring-ring),
284 ; which means the callerid needs to be set later on, and not just after
285 ; the first ring, as per the default.
290 ; Support Caller*ID on Call Waiting
292 callwaitingcallerid=yes
294 ; Support three-way calling
298 ; Support flash-hook call transfer (requires three way calling)
299 ; Also enables call parking (overrides the 'canpark' parameter)
304 ; ('canpark=no' is overridden by 'transfer=yes')
308 ; Support call forward variable
312 ; Whether or not to support Call Return (*69)
316 ; Stutter dialtone support: If a mailbox is specified without a voicemail
317 ; context, then when voicemail is received in a mailbox in the default
318 ; voicemail context in voicemail.conf, taking the phone off hook will cause a
319 ; stutter dialtone instead of a normal one.
321 ; If a mailbox is specified *with* a voicemail context, the same will result
322 ; if voicemail received in mailbox in the specified voicemail context.
324 ; for default voicemail context, the example below is fine:
328 ; for any other voicemail context, the following will produce the stutter tone:
330 ;mailbox=1234@context
332 ; Enable echo cancellation
333 ; Use either "yes", "no", or a power of two from 32 to 256 if you wish to
334 ; actually set the number of taps of cancellation.
336 ; Note that if any of your Zaptel cards have hardware echo cancellers,
337 ; then this setting only turns them on and off; numeric settings will
338 ; be treated as "yes". There are no special settings required for
339 ; hardware echo cancellers; when present and enabled in their kernel
340 ; modules, they take precedence over the software echo canceller compiled
341 ; into Zaptel automatically.
345 ; Generally, it is not necessary (and in fact undesirable) to echo cancel when
346 ; the circuit path is entirely TDM. You may, however, change this behavior
347 ; by enabling the echo cancel during pure TDM bridging below.
349 echocancelwhenbridged=yes
351 ; In some cases, the echo canceller doesn't train quickly enough and there
352 ; is echo at the beginning of the call. Enabling echo training will cause
353 ; asterisk to briefly mute the channel, send an impulse, and use the impulse
354 ; response to pre-train the echo canceller so it can start out with a much
355 ; closer idea of the actual echo. Value may be "yes", "no", or a number of
356 ; milliseconds to delay before training (default = 400)
358 ; WARNING: In some cases this option can make echo worse! If you are
359 ; trying to debug an echo problem, it is worth checking to see if your echo
360 ; is better with the option set to yes or no. Use whatever setting gives
363 ; Note that these parameters do not apply to hardware echo cancellers.
368 ; If you are having trouble with DTMF detection, you can relax the DTMF
369 ; detection parameters. Relaxing them may make the DTMF detector more likely
370 ; to have "talkoff" where DTMF is detected when it shouldn't be.
374 ; You may also set the default receive and transmit gains (in dB)
379 ; Logical groups can be assigned to allow outgoing rollover. Groups range
380 ; from 0 to 63, and multiple groups can be specified.
384 ; Ring groups (a.k.a. call groups) and pickup groups. If a phone is ringing
385 ; and it is a member of a group which is one of your pickup groups, then
386 ; you can answer it by picking up and dialling *8#. For simple offices, just
387 ; make these both the same. Groups range from 0 to 63.
393 ; Specify whether the channel should be answered immediately or if the simple
394 ; switch should provide dialtone, read digits, etc.
398 ; Specify whether flash-hook transfers to 'busy' channels should complete or
399 ; return to the caller performing the transfer (default is yes).
403 ; CallerID can be set to "asreceived" or a specific number if you want to
404 ; override it. Note that "asreceived" only applies to trunk interfaces.
408 ; AMA flags affects the recording of Call Detail Records. If specified
409 ; it may be 'default', 'omit', 'billing', or 'documentation'.
413 ; Channels may be associated with an account code to ease
418 ; ADSI (Analog Display Services Interface) can be enabled on a per-channel
419 ; basis if you have (or may have) ADSI compatible CPE equipment
423 ; SMDI (Simplified Message Desk Interface) can be enabled on a per-channel
424 ; basis if you would like that channel to behave like an SMDI message desk.
425 ; The SMDI port specified should have already been defined in smdi.conf. The
426 ; default port is /dev/ttyS0.
431 ; On trunk interfaces (FXS) and E&M interfaces (E&M, Wink, Feature Group D
432 ; etc, it can be useful to perform busy detection either in an effort to
433 ; detect hangup or for detecting busies. This enables listening for
434 ; the beep-beep busy pattern.
438 ; If busydetect is enabled, it is also possible to specify how many busy tones
439 ; to wait for before hanging up. The default is 4, but better results can be
440 ; achieved if set to 6 or even 8. Mind that the higher the number, the more
441 ; time that will be needed to hangup a channel, but lowers the probability
442 ; that you will get random hangups.
446 ; If busydetect is enabled, it is also possible to specify the cadence of your
447 ; busy signal. In many countries, it is 500msec on, 500msec off. Without
448 ; busypattern specified, we'll accept any regular sound-silence pattern that
449 ; repeats <busycount> times as a busy signal. If you specify busypattern,
450 ; then we'll further check the length of the sound (tone) and silence, which
451 ; will further reduce the chance of a false positive.
455 ; NOTE: In the Asterisk Makefile you'll find further options to tweak the busy
456 ; detector. If your country has a busy tone with the same length tone and
457 ; silence (as many countries do), consider defining the
458 ; -DBUSYDETECT_COMPARE_TONE_AND_SILENCE option.
460 ; Use a polarity reversal to mark when a outgoing call is answered by the
463 ;answeronpolarityswitch=yes
465 ; In some countries, a polarity reversal is used to signal the disconnect of a
466 ; phone line. If the hanguponpolarityswitch option is selected, the call will
467 ; be considered "hung up" on a polarity reversal.
469 ;hanguponpolarityswitch=yes
471 ; On trunk interfaces (FXS) it can be useful to attempt to follow the progress
472 ; of a call through RINGING, BUSY, and ANSWERING. If turned on, call
473 ; progress attempts to determine answer, busy, and ringing on phone lines.
474 ; This feature is HIGHLY EXPERIMENTAL and can easily detect false answers,
475 ; so don't count on it being very accurate.
477 ; Few zones are supported at the time of this writing, but may be selected
480 ; This feature can also easily detect false hangups. The symptoms of this is
481 ; being disconnected in the middle of a call for no reason.
486 ; FXO (FXS signalled) devices must have a timeout to determine if there was a
487 ; hangup before the line was answered. This value can be tweaked to shorten
488 ; how long it takes before Zap considers a non-ringing line to have hungup.
492 ; For FXO (FXS signalled) devices, whether to use pulse dial instead of DTMF
496 ; For fax detection, uncomment one of the following lines. The default is *OFF*
503 ; This option specifies a preference for which music on hold class this channel
504 ; should listen to when put on hold if the music class has not been set on the
505 ; channel with Set(CHANNEL(musicclass)=whatever) in the dialplan, and the peer
506 ; channel putting this one on hold did not suggest a music class.
508 ; If this option is set to "passthrough", then the hold message will always be
509 ; passed through as signalling instead of generating hold music locally. This
510 ; setting is only valid when used on a channel that uses digital signalling.
512 ; This option may be specified globally, or on a per-user or per-peer basis.
514 ;mohinterpret=default
516 ; This option specifies which music on hold class to suggest to the peer channel
517 ; when this channel places the peer on hold. It may be specified globally or on
518 ; a per-user or per-peer basis.
522 ; PRI channels can have an idle extension and a minunused number. So long as
523 ; at least "minunused" channels are idle, chan_zap will try to call "idledial"
524 ; on them, and then dump them into the PBX in the "idleext" extension (which
525 ; is of the form exten@context). When channels are needed the "idle" calls
526 ; are disconnected (so long as there are at least "minidle" calls still
527 ; running, of course) to make more channels available. The primary use of
528 ; this is to create a dynamic service, where idle channels are bundled through
529 ; multilink PPP, thus more efficiently utilizing combined voice/data services
530 ; than conventional fixed mappings/muxings.
533 ;idleext=6999@dialout
537 ; Configure jitter buffers in zapata (each one is 20ms, default is 4)
541 ;------------------------------ JITTER BUFFER CONFIGURATION --------------------------
542 ; jbenable = yes ; Enables the use of a jitterbuffer on the receiving side of a
543 ; ZAP channel. Defaults to "no". An enabled jitterbuffer will
544 ; be used only if the sending side can create and the receiving
545 ; side can not accept jitter. The ZAP channel can't accept jitter,
546 ; thus an enabled jitterbuffer on the receive ZAP side will always
547 ; be used if the sending side can create jitter.
549 ; jbmaxsize = 200 ; Max length of the jitterbuffer in milliseconds.
551 ; jbresyncthreshold = 1000 ; Jump in the frame timestamps over which the jitterbuffer is
552 ; resynchronized. Useful to improve the quality of the voice, with
553 ; big jumps in/broken timestamps, usually sent from exotic devices
554 ; and programs. Defaults to 1000.
556 ; jbimpl = fixed ; Jitterbuffer implementation, used on the receiving side of a ZAP
557 ; channel. Two implementations are currently available - "fixed"
558 ; (with size always equals to jbmax-size) and "adaptive" (with
559 ; variable size, actually the new jb of IAX2). Defaults to fixed.
561 ; jblog = no ; Enables jitterbuffer frame logging. Defaults to "no".
562 ;-----------------------------------------------------------------------------------
564 ; You can define your own custom ring cadences here. You can define up to 8
565 ; pairs. If the silence is negative, it indicates where the callerid spill is
566 ; to be placed. Also, if you define any custom cadences, the default cadences
567 ; will be turned off.
569 ; Syntax is: cadence=ring,silence[,ring,silence[...]]
571 ; These are the default cadences:
573 ;cadence=125,125,2000,-4000
574 ;cadence=250,250,500,1000,250,250,500,-4000
575 ;cadence=125,125,125,125,125,-4000
576 ;cadence=1000,500,2500,-5000
578 ; Each channel consists of the channel number or range. It inherits the
579 ; parameters that were specified above its declaration.
581 ; For GR-303, CRV's are created like channels except they must start with the
582 ; trunk group followed by a colon, e.g.:
588 ;callerid="Green Phone"<(256) 428-6121>
590 ;callerid="Black Phone"<(256) 428-6122>
592 ;callerid="CallerID Phone" <(256) 428-6123>
593 ;callerid="CallerID Phone" <(630) 372-1564>
594 ;callerid="CallerID Phone" <(256) 704-4666>
596 ;callerid="Pac Tel Phone" <(256) 428-6124>
598 ;callerid="Uniden Dead" <(256) 428-6125>
600 ;callerid="Cortelco 2500" <(256) 428-6126>
602 ;callerid="Main TA 750" <(256) 428-6127>
605 ; For example, maybe we have some other channels which start out in a
606 ; different context and use E & M signalling instead.
615 ; All those in group 0 I'll use for outgoing calls
617 ; Strip most significant digit (9) before sending
627 ;callerid="Joe Schmoe" <(256) 428-6131>
629 ;callerid="Megan May" <(256) 428-6132>
631 ;callerid="Suzy Queue" <(256) 428-6233>
633 ;callerid="Larry Moe" <(256) 428-6234>
636 ; Sample PRI (CPE) config: Specify the switchtype, the signalling as either
637 ; pri_cpe or pri_net for CPE or Network termination, and generally you will
638 ; want to create a single "group" for all channels of the PRI.
640 ; switchtype = national
641 ; signalling = pri_cpe
647 ; Used for distinctive ring support for x100p.
648 ; You can see the dringX patterns is to set any one of the dringXcontext fields
649 ; and they will be printed on the console when an inbound call comes in.
652 ;dring1context=internal1
654 ;dring2context=internal2
655 ; If no pattern is matched here is where we go.