2 ; DAHDI telephony interface
6 ; You need to restart Asterisk to re-configure the DAHDI channels
7 ; CLI> reload chan_dahdi.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 DAHDI 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 => <dahdispan>,<trunkgroup>[,<logicalspan>]
32 ; dahdispan is the DAHDI 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
58 ; euroisdn: EuroISDN (also known as ETSI NET/5; Cisco calls this "primary-net5")
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 ; Allow inband audio (progress) when a call is RELEASEd by the far end of a PRI
121 ;inbanddisconnect=yes
123 ; PRI Out of band indications.
124 ; Enable this to report Busy and Congestion on a PRI using out-of-band
125 ; notification. Inband indication, as used by Asterisk doesn't seem to work
128 ; outofband: Signal Busy/Congestion out of band with RELEASE/DISCONNECT
129 ; inband: Signal Busy/Congestion using in-band tones
131 ; priindication = outofband
133 ; If you need to override the existing channels selection routine and force all
134 ; PRI channels to be marked as exclusively selected, set this to yes.
138 ; All of the ISDN timers and counters that are used are configurable. Specify
139 ; the timer name, and its value (in ms for timers).
140 ; K: Layer 2 max number of outstanding unacknowledged I frames (default 7)
141 ; N200: Layer 2 max number of retransmissions of a frame (default 3)
142 ; T200: Layer 2 max time before retransmission of a frame (default 1000 ms)
143 ; T203: Layer 2 max time without frames being exchanged (default 10000 ms)
144 ; T305: Wait for DISCONNECT acknowledge (default 30000 ms)
145 ; T308: Wait for RELEASE acknowledge (default 4000 ms)
146 ; T309: Maintain active calls on Layer 2 disconnection (default -1, Asterisk clears calls)
147 ; EuroISDN: 6000 to 12000 ms, according to (N200 + 1) x T200 + 2s
148 ; May vary in other ISDN standards (Q.931 1993 : 90000 ms)
149 ; T313: Wait for CONNECT acknowledge, CPE side only (default 3000 ms)
151 ; pritimer => t200,1000
152 ; pritimer => t313,4000
154 ; To enable transmission of facility-based ISDN supplementary services (such
155 ; as caller name from CPE over facility), enable this option.
156 ; facilityenable = yes
159 ; Signalling method (default is fxs). Valid values:
162 ; featd: Feature Group D (The fake, Adtran style, DTMF)
163 ; featdmf: Feature Group D (The real thing, MF (domestic, US))
164 ; featdmf_ta: Feature Group D (The real thing, MF (domestic, US)) through
165 ; a Tandem Access point
166 ; featb: Feature Group B (MF (domestic, US))
167 ; fgccama Feature Group C-CAMA (DP DNIS, MF ANI)
168 ; fgccamamf Feature Group C-CAMA MF (MF DNIS, MF ANI)
169 ; fxs_ls: FXS (Loop Start)
170 ; fxs_gs: FXS (Ground Start)
171 ; fxs_ks: FXS (Kewl Start)
172 ; fxo_ls: FXO (Loop Start)
173 ; fxo_gs: FXO (Ground Start)
174 ; fxo_ks: FXO (Kewl Start)
175 ; pri_cpe: PRI signalling, CPE side
176 ; pri_net: PRI signalling, Network side
177 ; gr303fxoks_net: GR-303 Signalling, FXO Loopstart, Network side
178 ; gr303fxsks_cpe: GR-303 Signalling, FXS Loopstart, CPE side
179 ; sf: SF (Inband Tone) Signalling
181 ; sf_featd: SF Feature Group D (The fake, Adtran style, DTMF)
182 ; sf_featdmf: SF Feature Group D (The real thing, MF (domestic, US))
183 ; sf_featb: SF Feature Group B (MF (domestic, US))
184 ; e911: E911 (MF) style signalling
186 ; The following are used for Radio interfaces:
187 ; fxs_rx: Receive audio/COR on an FXS kewlstart interface (FXO at the
189 ; fxs_tx: Transmit audio/PTT on an FXS loopstart interface (FXO at the
191 ; fxo_rx: Receive audio/COR on an FXO loopstart interface (FXS at the
193 ; fxo_tx: Transmit audio/PTT on an FXO groundstart interface (FXS at
195 ; em_rx: Receive audio/COR on an E&M interface (1-way)
196 ; em_tx: Transmit audio/PTT on an E&M interface (1-way)
197 ; em_txrx: Receive audio/COR AND Transmit audio/PTT on an E&M interface
199 ; em_rxtx: Same as em_txrx (for our dyslexic friends)
200 ; sf_rx: Receive audio/COR on an SF interface (1-way)
201 ; sf_tx: Transmit audio/PTT on an SF interface (1-way)
202 ; sf_txrx: Receive audio/COR AND Transmit audio/PTT on an SF interface
204 ; sf_rxtx: Same as sf_txrx (for our dyslexic friends)
208 ; If you have an outbound signalling format that is different from format
209 ; specified above (but compatible), you can specify outbound signalling format,
210 ; (see below). The 'signalling' format specified will be the inbound signalling
211 ; format. If you only specify 'signalling', then it will be the format for
212 ; both inbound and outbound.
215 ; outsignalling=featb
217 ; For Feature Group D Tandem access, to set the default CIC and OZZ use these
222 ; A variety of timing parameters can be specified as well
224 ; prewink: Pre-wink time (default 50ms)
225 ; preflash: Pre-flash time (default 50ms)
226 ; wink: Wink time (default 150ms)
227 ; flash: Flash time (default 750ms)
228 ; start: Start time (default 1500ms)
229 ; rxwink: Receiver wink time (default 300ms)
230 ; rxflash: Receiver flashtime (default 1250ms)
231 ; debounce: Debounce timing (default 600ms)
233 rxwink=300 ; Atlas seems to use long (250ms) winks
235 ; How long generated tones (DTMF and MF) will be played on the channel
239 ; Whether or not to do distinctive ring detection on FXO lines
241 ;usedistinctiveringdetection=yes
242 ;distinctiveringaftercid=yes ; enable dring detection after callerid for those countries like Australia
243 ; where the ring cadence is changed *after* the callerid spill.
245 ; Whether or not to use caller ID
249 ; Type of caller ID signalling in use
250 ; bell = bell202 as used in US
251 ; v23 = v23 as used in the UK
252 ; v23_jp = v23 as used in Japan
253 ; dtmf = DTMF as used in Denmark, Sweden and Netherlands
254 ; smdi = Use SMDI for callerid. Requires SMDI to be enabled (usesmdi).
258 ; What signals the start of caller ID
259 ; ring = a ring signals the start
260 ; polarity = polarity reversal signals the start
264 ; Whether or not to hide outgoing caller ID (Override with *67 or *82)
268 ; Whether or not to enable call waiting on internal extensions
269 ; With this set to 'yes', busy extensions will hear the call-waiting
270 ; tone, and can use hook-flash to switch between callers. The Dial()
271 ; app will not return the "BUSY" result for extensions.
275 ; Whether or not restrict outgoing caller ID (will be sent as ANI only, not
276 ; available for the user)
277 ; Mostly use with FXS ports
281 ; Whether or not use the caller ID presentation for the outgoing call that the
282 ; calling switch is sending.
283 ; See doc/callingpres.txt
287 ; Some countries (UK) have ring tones with different ring tones (ring-ring),
288 ; which means the callerid needs to be set later on, and not just after
289 ; the first ring, as per the default.
294 ; Support Caller*ID on Call Waiting
296 callwaitingcallerid=yes
298 ; Support three-way calling
302 ; For FXS ports (either direct analog or over T1/E1):
303 ; Support flash-hook call transfer (requires three way calling)
304 ; Also enables call parking (overrides the 'canpark' parameter)
306 ; For digital ports using ISDN PRI protocols:
307 ; Support switch-side transfer (called 2BCT, RLT or other names)
308 ; This setting must be enabled on both ports involved, and the
309 ; 'facilityenable' setting must also be enabled to allow sending
310 ; the transfer to the ISDN switch, since it sent in a FACILITY
316 ; ('canpark=no' is overridden by 'transfer=yes')
320 ; Support call forward variable
324 ; Whether or not to support Call Return (*69)
328 ; Stutter dialtone support: If a mailbox is specified without a voicemail
329 ; context, then when voicemail is received in a mailbox in the default
330 ; voicemail context in voicemail.conf, taking the phone off hook will cause a
331 ; stutter dialtone instead of a normal one.
333 ; If a mailbox is specified *with* a voicemail context, the same will result
334 ; if voicemail received in mailbox in the specified voicemail context.
336 ; for default voicemail context, the example below is fine:
340 ; for any other voicemail context, the following will produce the stutter tone:
342 ;mailbox=1234@context
344 ; Enable echo cancellation
345 ; Use either "yes", "no", or a power of two from 32 to 256 if you wish to
346 ; actually set the number of taps of cancellation.
348 ; Note that when setting the number of taps, the number 256 does not translate
349 ; to 256 ms of echo cancellation. echocancel=256 means 256 / 8 = 32 ms.
351 ; Note that if any of your DAHDI cards have hardware echo cancellers,
352 ; then this setting only turns them on and off; numeric settings will
353 ; be treated as "yes". There are no special settings required for
354 ; hardware echo cancellers; when present and enabled in their kernel
355 ; modules, they take precedence over the software echo canceller compiled
356 ; into DAHDI automatically.
360 ; Generally, it is not necessary (and in fact undesirable) to echo cancel when
361 ; the circuit path is entirely TDM. You may, however, change this behavior
362 ; by enabling the echo cancel during pure TDM bridging below.
364 echocancelwhenbridged=yes
366 ; In some cases, the echo canceller doesn't train quickly enough and there
367 ; is echo at the beginning of the call. Enabling echo training will cause
368 ; asterisk to briefly mute the channel, send an impulse, and use the impulse
369 ; response to pre-train the echo canceller so it can start out with a much
370 ; closer idea of the actual echo. Value may be "yes", "no", or a number of
371 ; milliseconds to delay before training (default = 400)
373 ; WARNING: In some cases this option can make echo worse! If you are
374 ; trying to debug an echo problem, it is worth checking to see if your echo
375 ; is better with the option set to yes or no. Use whatever setting gives
378 ; Note that these parameters do not apply to hardware echo cancellers.
383 ; If you are having trouble with DTMF detection, you can relax the DTMF
384 ; detection parameters. Relaxing them may make the DTMF detector more likely
385 ; to have "talkoff" where DTMF is detected when it shouldn't be.
389 ; You may also set the default receive and transmit gains (in dB)
394 ; Logical groups can be assigned to allow outgoing rollover. Groups range
395 ; from 0 to 63, and multiple groups can be specified.
399 ; Ring groups (a.k.a. call groups) and pickup groups. If a phone is ringing
400 ; and it is a member of a group which is one of your pickup groups, then
401 ; you can answer it by picking up and dialling *8#. For simple offices, just
402 ; make these both the same. Groups range from 0 to 63.
408 ; Specify whether the channel should be answered immediately or if the simple
409 ; switch should provide dialtone, read digits, etc.
410 ; Note: If immediate=yes the dialplan execution will always start at extension
411 ; 's' priority 1 regardless of the dialed number!
415 ; Specify whether flash-hook transfers to 'busy' channels should complete or
416 ; return to the caller performing the transfer (default is yes).
420 ; CallerID can be set to "asreceived" or a specific number if you want to
421 ; override it. Note that "asreceived" only applies to trunk interfaces.
425 ; AMA flags affects the recording of Call Detail Records. If specified
426 ; it may be 'default', 'omit', 'billing', or 'documentation'.
430 ; Channels may be associated with an account code to ease
435 ; ADSI (Analog Display Services Interface) can be enabled on a per-channel
436 ; basis if you have (or may have) ADSI compatible CPE equipment
440 ; SMDI (Simplified Message Desk Interface) can be enabled on a per-channel
441 ; basis if you would like that channel to behave like an SMDI message desk.
442 ; The SMDI port specified should have already been defined in smdi.conf. The
443 ; default port is /dev/ttyS0.
448 ; On trunk interfaces (FXS) and E&M interfaces (E&M, Wink, Feature Group D
449 ; etc, it can be useful to perform busy detection either in an effort to
450 ; detect hangup or for detecting busies. This enables listening for
451 ; the beep-beep busy pattern.
455 ; If busydetect is enabled, it is also possible to specify how many busy tones
456 ; to wait for before hanging up. The default is 4, but better results can be
457 ; achieved if set to 6 or even 8. Mind that the higher the number, the more
458 ; time that will be needed to hangup a channel, but lowers the probability
459 ; that you will get random hangups.
463 ; If busydetect is enabled, it is also possible to specify the cadence of your
464 ; busy signal. In many countries, it is 500msec on, 500msec off. Without
465 ; busypattern specified, we'll accept any regular sound-silence pattern that
466 ; repeats <busycount> times as a busy signal. If you specify busypattern,
467 ; then we'll further check the length of the sound (tone) and silence, which
468 ; will further reduce the chance of a false positive.
472 ; NOTE: In the Asterisk Makefile you'll find further options to tweak the busy
473 ; detector. If your country has a busy tone with the same length tone and
474 ; silence (as many countries do), consider defining the
475 ; -DBUSYDETECT_COMPARE_TONE_AND_SILENCE option.
477 ; Use a polarity reversal to mark when a outgoing call is answered by the
480 ;answeronpolarityswitch=yes
482 ; In some countries, a polarity reversal is used to signal the disconnect of a
483 ; phone line. If the hanguponpolarityswitch option is selected, the call will
484 ; be considered "hung up" on a polarity reversal.
486 ;hanguponpolarityswitch=yes
488 ; On trunk interfaces (FXS) it can be useful to attempt to follow the progress
489 ; of a call through RINGING, BUSY, and ANSWERING. If turned on, call
490 ; progress attempts to determine answer, busy, and ringing on phone lines.
491 ; This feature is HIGHLY EXPERIMENTAL and can easily detect false answers,
492 ; so don't count on it being very accurate.
494 ; Few zones are supported at the time of this writing, but may be selected
497 ; This feature can also easily detect false hangups. The symptoms of this is
498 ; being disconnected in the middle of a call for no reason.
503 ; FXO (FXS signalled) devices must have a timeout to determine if there was a
504 ; hangup before the line was answered. This value can be tweaked to shorten
505 ; how long it takes before DAHDI considers a non-ringing line to have hungup.
509 ; For FXO (FXS signalled) devices, whether to use pulse dial instead of DTMF
513 ; For fax detection, uncomment one of the following lines. The default is *OFF*
520 ; This option specifies a preference for which music on hold class this channel
521 ; should listen to when put on hold if the music class has not been set on the
522 ; channel with Set(CHANNEL(musicclass)=whatever) in the dialplan, and the peer
523 ; channel putting this one on hold did not suggest a music class.
525 ; If this option is set to "passthrough", then the hold message will always be
526 ; passed through as signalling instead of generating hold music locally. This
527 ; setting is only valid when used on a channel that uses digital signalling.
529 ; This option may be specified globally, or on a per-channel basis.
531 ;mohinterpret=default
533 ; This option specifies which music on hold class to suggest to the peer channel
534 ; when this channel places the peer on hold. It may be specified globally or on
539 ; PRI channels can have an idle extension and a minunused number. So long as
540 ; at least "minunused" channels are idle, chan_dahdi will try to call "idledial"
541 ; on them, and then dump them into the PBX in the "idleext" extension (which
542 ; is of the form exten@context). When channels are needed the "idle" calls
543 ; are disconnected (so long as there are at least "minidle" calls still
544 ; running, of course) to make more channels available. The primary use of
545 ; this is to create a dynamic service, where idle channels are bundled through
546 ; multilink PPP, thus more efficiently utilizing combined voice/data services
547 ; than conventional fixed mappings/muxings.
550 ;idleext=6999@dialout
554 ; Configure jitter buffers in DAHDI (each one is 20ms, default is 4)
558 ;------------------------------ JITTER BUFFER CONFIGURATION --------------------------
559 ; jbenable = yes ; Enables the use of a jitterbuffer on the receiving side of a
560 ; DAHDI channel. Defaults to "no". An enabled jitterbuffer will
561 ; be used only if the sending side can create and the receiving
562 ; side can not accept jitter. The DAHDI channel can't accept jitter,
563 ; thus an enabled jitterbuffer on the receive DAHDI side will always
564 ; be used if the sending side can create jitter.
566 ; jbmaxsize = 200 ; Max length of the jitterbuffer in milliseconds.
568 ; jbresyncthreshold = 1000 ; Jump in the frame timestamps over which the jitterbuffer is
569 ; resynchronized. Useful to improve the quality of the voice, with
570 ; big jumps in/broken timestamps, usually sent from exotic devices
571 ; and programs. Defaults to 1000.
573 ; jbimpl = fixed ; Jitterbuffer implementation, used on the receiving side of a DAHDI
574 ; channel. Two implementations are currently available - "fixed"
575 ; (with size always equals to jbmax-size) and "adaptive" (with
576 ; variable size, actually the new jb of IAX2). Defaults to fixed.
578 ; jblog = no ; Enables jitterbuffer frame logging. Defaults to "no".
579 ;-----------------------------------------------------------------------------------
581 ; You can define your own custom ring cadences here. You can define up to 8
582 ; pairs. If the silence is negative, it indicates where the callerid spill is
583 ; to be placed. Also, if you define any custom cadences, the default cadences
584 ; will be turned off.
586 ; Syntax is: cadence=ring,silence[,ring,silence[...]]
588 ; These are the default cadences:
590 ;cadence=125,125,2000,-4000
591 ;cadence=250,250,500,1000,250,250,500,-4000
592 ;cadence=125,125,125,125,125,-4000
593 ;cadence=1000,500,2500,-5000
595 ; Each channel consists of the channel number or range. It inherits the
596 ; parameters that were specified above its declaration.
598 ; For GR-303, CRV's are created like channels except they must start with the
599 ; trunk group followed by a colon, e.g.:
605 ;callerid="Green Phone"<(256) 428-6121>
607 ;callerid="Black Phone"<(256) 428-6122>
609 ;callerid="CallerID Phone" <(256) 428-6123>
610 ;callerid="CallerID Phone" <(630) 372-1564>
611 ;callerid="CallerID Phone" <(256) 704-4666>
613 ;callerid="Pac Tel Phone" <(256) 428-6124>
615 ;callerid="Uniden Dead" <(256) 428-6125>
617 ;callerid="Cortelco 2500" <(256) 428-6126>
619 ;callerid="Main TA 750" <(256) 428-6127>
622 ; For example, maybe we have some other channels which start out in a
623 ; different context and use E & M signalling instead.
632 ; All those in group 0 I'll use for outgoing calls
634 ; Strip most significant digit (9) before sending
644 ;callerid="Joe Schmoe" <(256) 428-6131>
646 ;callerid="Megan May" <(256) 428-6132>
648 ;callerid="Suzy Queue" <(256) 428-6233>
650 ;callerid="Larry Moe" <(256) 428-6234>
653 ; Sample PRI (CPE) config: Specify the switchtype, the signalling as either
654 ; pri_cpe or pri_net for CPE or Network termination, and generally you will
655 ; want to create a single "group" for all channels of the PRI.
657 ; switchtype = national
658 ; signalling = pri_cpe
664 ; Used for distinctive ring support for x100p.
665 ; You can see the dringX patterns is to set any one of the dringXcontext fields
666 ; and they will be printed on the console when an inbound call comes in.
669 ;dring1context=internal1
671 ;dring2context=internal2
672 ; If no pattern is matched here is where we go.