Voicemail: Remove mailbox identifier format (box@context) assumptions in the system.
[asterisk/asterisk.git] / configs / chan_dahdi.conf.sample
1 ;
2 ; DAHDI Telephony Configuration file
3 ;
4 ; You need to restart Asterisk to re-configure the DAHDI channel
5 ; CLI> module reload chan_dahdi.so
6 ;      will reload the configuration file, but not all configuration options
7 ;      are re-configured during a reload (signalling, as well as PRI and
8 ;      SS7-related settings cannot be changed on a reload).
9 ;
10 ; This file documents many configuration variables.  Normally unless you know
11 ; what a variable means or that it should be changed, there's no reason to
12 ; un-comment those lines.
13 ;
14 ; Examples below that are commented out (those lines that begin with a ';' but
15 ; no space afterwards) typically show a value that is not the default value,
16 ; but would make sense under certain circumstances. The default values are
17 ; usually sane. Thus you should typically not touch them unless you know what
18 ; they mean or you know you should change them.
19
20 [trunkgroups]
21 ;
22 ; Trunk groups are used for NFAS connections.
23 ;
24 ; Group: Defines a trunk group.
25 ;        trunkgroup => <trunkgroup>,<dchannel>[,<backup1>...]
26 ;
27 ;        trunkgroup  is the numerical trunk group to create
28 ;        dchannel    is the DAHDI channel which will have the
29 ;                    d-channel for the trunk.
30 ;        backup1     is an optional list of backup d-channels.
31 ;
32 ;trunkgroup => 1,24,48
33 ;trunkgroup => 1,24
34 ;
35 ; Spanmap: Associates a span with a trunk group
36 ;        spanmap => <dahdispan>,<trunkgroup>[,<logicalspan>]
37 ;
38 ;        dahdispan   is the DAHDI span number to associate
39 ;        trunkgroup  is the trunkgroup (specified above) for the mapping
40 ;        logicalspan is the logical span number within the trunk group to use.
41 ;                    if unspecified, no logical span number is used.
42 ;
43 ;spanmap => 1,1,1
44 ;spanmap => 2,1,2
45 ;spanmap => 3,1,3
46 ;spanmap => 4,1,4
47
48 [channels]
49 ;
50 ; Default language
51 ;
52 ;language=en
53 ;
54 ; Context for incoming calls. Defaults to 'default'
55 ;
56 context=public
57 ;
58 ; Switchtype:  Only used for PRI.
59 ;
60 ; national:    National ISDN 2 (default)
61 ; dms100:      Nortel DMS100
62 ; 4ess:        AT&T 4ESS
63 ; 5ess:        Lucent 5ESS
64 ; euroisdn:    EuroISDN (common in Europe)
65 ; ni1:         Old National ISDN 1
66 ; qsig:        Q.SIG
67 ;
68 ;switchtype=euroisdn
69 ;
70 ; MSNs for ISDN spans.  Asterisk will listen for the listed numbers on
71 ; incoming calls and ignore any calls not listed.
72 ; Here you can give a comma separated list of numbers or dialplan extension
73 ; patterns.  An empty list disables MSN matching to allow any incoming call.
74 ; Only set on PTMP CPE side of ISDN span if needed.
75 ; The default is an empty list.
76 ;msn=
77 ;
78 ; Some switches (AT&T especially) require network specific facility IE.
79 ; Supported values are currently 'none', 'sdn', 'megacom', 'tollfreemegacom', 'accunet'
80 ;
81 ; nsf cannot be changed on a reload.
82 ;
83 ;nsf=none
84 ;
85 ;service_message_support=yes
86 ; Enable service message support for channel. Must be set after switchtype.
87 ;
88 ; Dialing options for ISDN (i.e., Dial(DAHDI/g1/exten/options)):
89 ; R      Reverse Charge Indication
90 ;          Indicate to the called party that the call will be reverse charged.
91 ; K(n)   Keypad digits n
92 ;          Send out the specified digits as keypad digits.
93 ;
94 ; PRI Dialplan: The ISDN-level Type Of Number (TON) or numbering plan, used for
95 ; the dialed number.  Leaving this as 'unknown' (the default) works for most
96 ; cases.  In some very unusual circumstances, you may need to set this to
97 ; 'dynamic' or 'redundant'.
98 ;
99 ; unknown:        Unknown
100 ; private:        Private ISDN
101 ; local:          Local ISDN
102 ; national:       National ISDN
103 ; international:  International ISDN
104 ; dynamic:        Dynamically selects the appropriate dialplan using the
105 ;                 prefix settings.
106 ; redundant:      Same as dynamic, except that the underlying number is not
107 ;                 changed (not common)
108 ;
109 ; pridialplan cannot be changed on reload.
110 ;pridialplan=unknown
111 ;
112 ; PRI Local Dialplan:  Only RARELY used for PRI (sets the calling number's
113 ; numbering plan).  In North America, the typical use is sending the 10 digit
114 ; callerID number and setting the prilocaldialplan to 'national' (the default).
115 ; Only VERY rarely will you need to change this.
116 ;
117 ; unknown:        Unknown
118 ; private:        Private ISDN
119 ; local:          Local ISDN
120 ; national:       National ISDN
121 ; international:  International ISDN
122 ; from_channel:   Use the CALLERID(ton) value from the channel.
123 ; dynamic:        Dynamically selects the appropriate dialplan using the
124 ;                 prefix settings.
125 ; redundant:      Same as dynamic, except that the underlying number is not
126 ;                 changed (not common)
127 ;
128 ; prilocaldialplan cannot be changed on reload.
129 ;prilocaldialplan=national
130 ;
131 ; PRI Connected Line Dialplan:  Sets the connected party number's numbering plan.
132 ;
133 ; unknown:        Unknown
134 ; private:        Private ISDN
135 ; local:          Local ISDN
136 ; national:       National ISDN
137 ; international:  International ISDN
138 ; from_channel:   Use the CONNECTEDLINE(ton) value from the channel.
139 ; dynamic:        Dynamically selects the appropriate dialplan using the
140 ;                 prefix settings.
141 ; redundant:      Same as dynamic, except that the underlying number is not
142 ;                 changed (not common)
143 ;
144 ; pricpndialplan cannot be changed on reload.
145 ;pricpndialplan=from_channel
146 ;
147 ; pridialplan may be also set at dialtime, by prefixing the dialed number with
148 ; one of the following letters:
149 ; U - Unknown
150 ; I - International
151 ; N - National
152 ; L - Local (Net Specific)
153 ; S - Subscriber
154 ; V - Abbreviated
155 ; R - Reserved (should probably never be used but is included for completeness)
156 ;
157 ; Additionally, you may also set the following NPI bits (also by prefixing the
158 ; dialed string with one of the following letters):
159 ; u - Unknown
160 ; e - E.163/E.164 (ISDN/telephony)
161 ; x - X.121 (Data)
162 ; f - F.69 (Telex)
163 ; n - National
164 ; p - Private
165 ; r - Reserved (should probably never be used but is included for completeness)
166 ;
167 ; You may also set the prilocaldialplan in the same way, but by prefixing the
168 ; Caller*ID Number rather than the dialed number.
169
170 ; Please note that telcos which require this kind of additional manipulation
171 ; of the TON/NPI are *rare*.  Most telco PRIs will work fine simply by
172 ; setting pridialplan to unknown or dynamic.
173 ;
174 ;
175 ; PRI caller ID prefixes based on the given TON/NPI (dialplan)
176 ; This is especially needed for EuroISDN E1-PRIs
177 ;
178 ; None of the prefix settings can be changed on reload.
179 ;
180 ; sample 1 for Germany
181 ;internationalprefix = 00
182 ;nationalprefix = 0
183 ;localprefix = 0711
184 ;privateprefix = 07115678
185 ;unknownprefix =
186 ;
187 ; sample 2 for Germany
188 ;internationalprefix = +
189 ;nationalprefix = +49
190 ;localprefix = +49711
191 ;privateprefix = +497115678
192 ;unknownprefix =
193 ;
194 ; PRI resetinterval: sets the time in seconds between restart of unused
195 ; B channels; defaults to 'never'.
196 ;
197 ;resetinterval = 3600
198 ;
199 ; Assume inband audio may be present when a PROCEEDING message is received.
200 ; Q.931 Section 5.1.2 says the network cannot assume that the CPE side has
201 ; attached to the B channel at this time without explicitly sending the
202 ; progress indicator ie informing the CPE side to attach to the B channel
203 ; for audio.  However, some non-compliant ISDN switches send a PROCEEDING
204 ; without the progress indicator ie indicating inband audio is available and
205 ; assume that the CPE device has connected the media path for listening to
206 ; ringback and other messages.
207 ; Default no.
208 ;
209 ;inband_on_proceeding=yes
210 ;
211 ; Overlap dialing mode (sending overlap digits)
212 ; Cannot be changed on a reload.
213 ;
214 ; incoming: incoming direction only
215 ; outgoing: outgoing direction only
216 ; no: neither direction
217 ; yes or both: both directions
218 ;
219 ;overlapdial=yes
220
221 ; Send/receive ISDN display IE options.  The display options are a comma separated
222 ; list of the following options:
223 ;
224 ; block:        Do not pass display text data.
225 ;               Q.SIG: Default for send/receive.
226 ;               ETSI CPE: Default for send.
227 ; name_initial: Use display text in SETUP/CONNECT messages as the party name.
228 ;               Default for all other modes.
229 ; name_update:  Use display text in other messages (NOTIFY/FACILITY) for COLP name
230 ;               update.
231 ; name:         Combined name_initial and name_update options.
232 ; text:         Pass any unused display text data as an arbitrary display message
233 ;               during a call.  Sent text goes out in an INFORMATION message.
234 ;
235 ; * Default is an empty string for legacy behavior.
236 ; * The name options are not recommended for Q.SIG since Q.SIG already
237 ;   supports names.
238 ; * The send block is the only recommended setting for CPE mode since Q.931 uses
239 ;   the display IE only in the network to user direction.
240 ;
241 ; display_send and display_receive cannot be changed on reload.
242 ;
243 ;display_send=
244 ;display_receive=
245
246 ; Allow sending an ISDN Malicious Caller ID (MCID) request on this span.
247 ; Default disabled
248 ;
249 ;mcid_send=yes
250
251 ; Send ISDN date/time IE in CONNECT message option.  Only valid on NT spans.
252 ;
253 ; no:           Do not send date/time IE in CONNECT message.
254 ; date:         Send date only.
255 ; date_hh       Send date and hour.
256 ; date_hhmm     Send date, hour, and minute.
257 ; date_hhmmss   Send date, hour, minute, and second.
258 ;
259 ; Default is an empty string which lets libpri pick the default
260 ; date/time IE send policy.
261 ;
262 ;datetime_send=
263
264 ; Send ISDN conected line information.
265 ;
266 ; block:   Do not send any connected line information.
267 ; connect: Send connected line information on initial connect.
268 ; update:  Same as connect but also send any updates during a call.
269 ;          Updates happen if the call is transferred. (Default)
270 ;
271 ;colp_send=update
272
273 ; Allow inband audio (progress) when a call is DISCONNECTed by the far end of a PRI
274 ;
275 ;inbanddisconnect=yes
276 ;
277 ; Allow a held call to be transferred to the active call on disconnect.
278 ; This is useful on BRI PTMP NT lines where an ISDN phone can simulate the
279 ; transfer feature of an analog phone.
280 ; The default is no.
281 ;hold_disconnect_transfer=yes
282
283 ; BRI PTMP layer 1 presence.
284 ; You should normally not need to set this option.
285 ; You may need to set this option if your telco brings layer 1 down when
286 ; the line is idle.
287 ; required:      Layer 1 presence required for outgoing calls. (default)
288 ; ignore:        Ignore alarms from DAHDI about this span.
289 ;                (Layer 1 and 2 will be brought back up for an outgoing call.)
290 ;                NOTE:  You will not be able to detect physical line problems
291 ;                until an outgoing call is attempted and fails.
292 ;
293 ;layer1_presence=ignore
294
295 ; BRI PTMP layer 2 persistence.
296 ; You should normally not need to set this option.
297 ; You may need to set this option if your telco brings layer 1 down when
298 ; the line is idle.
299 ; <blank>:       Use libpri default.
300 ; keep_up:       Bring layer 2 back up if peer takes it down.
301 ; leave_down:    Leave layer 2 down if peer takes it down. (Libpri default)
302 ;                (Layer 2 will be brought back up for an outgoing call.)
303 ;
304 ;layer2_persistence=leave_down
305
306 ; PRI Out of band indications.
307 ; Enable this to report Busy and Congestion on a PRI using out-of-band
308 ; notification. Inband indication, as used by Asterisk doesn't seem to work
309 ; with all telcos.
310 ;
311 ; outofband:      Signal Busy/Congestion out of band with RELEASE/DISCONNECT
312 ; inband:         Signal Busy/Congestion using in-band tones (default)
313 ;
314 ; priindication cannot be changed on a reload.
315 ;
316 ;priindication = outofband
317 ;
318 ; If you need to override the existing channels selection routine and force all
319 ; PRI channels to be marked as exclusively selected, set this to yes.
320 ;
321 ; priexclusive cannot be changed on a reload.
322 ;
323 ;priexclusive = yes
324 ;
325 ;
326 ; If you need to use the logical channel mapping with your Q.SIG PRI instead
327 ; of the physical mapping you must use the qsigchannelmapping option.
328 ;
329 ; logical:  Use the logical channel mapping
330 ; physical: Use physical channel mapping (default)
331 ;
332 ;qsigchannelmapping=logical
333 ;
334 ; If you wish to ignore remote hold indications (and use MOH that is supplied over
335 ; the B channel) enable this option.
336 ;
337 ;discardremoteholdretrieval=yes
338 ;
339 ; ISDN Timers
340 ; All of the ISDN timers and counters that are used are configurable.  Specify
341 ; the timer name, and its value (in ms for timers).
342 ; K:    Layer 2 max number of outstanding unacknowledged I frames (default 7)
343 ; N200: Layer 2 max number of retransmissions of a frame (default 3)
344 ; T200: Layer 2 max time before retransmission of a frame (default 1000 ms)
345 ; T203: Layer 2 max time without frames being exchanged (default 10000 ms)
346 ; T305: Wait for DISCONNECT acknowledge (default 30000 ms)
347 ; T308: Wait for RELEASE acknowledge (default 4000 ms)
348 ; T309: Maintain active calls on Layer 2 disconnection (default 6000 ms)
349 ;       EuroISDN: 6000 to 12000 ms, according to (N200 + 1) x T200 + 2s
350 ;       May vary in other ISDN standards (Q.931 1993 : 90000 ms)
351 ; T313: Wait for CONNECT acknowledge, CPE side only (default 3000 ms)
352 ;
353 ; T-RESPONSE:   Maximum time to wait for a typical APDU response. (default 4000 ms)
354 ;               This is an implementation timer when the standard does not specify one.
355 ; T-ACTIVATE:   Request supervision timeout. (default 10000 ms)
356 ; T-RETENTION:  Maximum  time to wait for user A to activate call-completion. (default 30000 ms)
357 ;               Used by ETSI PTP, ETSI PTMP, and Q.SIG as the cc_offer_timer.
358 ; T-CCBS1:      T-STATUS timer equivalent for CC user A status. (default 4000 ms)
359 ; T-CCBS2:      Maximum  time the CCBS service will be active (default 45 min in ms)
360 ; T-CCBS3:      Maximum  time to wait for user A to respond to user B availability. (default 20000 ms)
361 ; T-CCBS5:      Network B CCBS supervision timeout. (default 60 min in ms)
362 ; T-CCBS6:      Network A CCBS supervision timeout. (default 60 min in ms)
363 ; T-CCNR2:      Maximum  time the CCNR service will be active (default 180 min in ms)
364 ; T-CCNR5:      Network B CCNR supervision timeout. (default 195 min in ms)
365 ; T-CCNR6:      Network A CCNR supervision timeout. (default 195 min in ms)
366 ; CC-T1:        Q.SIG CC request supervision timeout. (default 30000 ms)
367 ; CCBS-T2:      Q.SIG CCBS supervision timeout. (default 60 min in ms)
368 ; CCNR-T2:      Q.SIG CCNR supervision timeout. (default 195 min in ms)
369 ; CC-T3:        Q.SIG CC Maximum time to wait for user A to respond to user B availability. (default 30000 ms)
370 ;
371 ;pritimer => t200,1000
372 ;pritimer => t313,4000
373 ;
374 ; CC PTMP recall mode:
375 ; specific - Only the CC original party A can participate in the CC callback
376 ; global - Other compatible endpoints on the PTMP line can be party A in the CC callback
377 ;
378 ; cc_ptmp_recall_mode cannot be changed on a reload.
379 ;
380 ;cc_ptmp_recall_mode = specific
381 ;
382 ; CC Q.SIG Party A (requester) retain signaling link option
383 ; retain       Require that the signaling link be retained.
384 ; release      Request that the signaling link be released.
385 ; do_not_care  The responder is free to choose if the signaling link will be retained.
386 ;
387 ;cc_qsig_signaling_link_req = retain
388 ;
389 ; CC Q.SIG Party B (responder) retain signaling link option
390 ; retain       Prefer that the signaling link be retained.
391 ; release      Prefer that the signaling link be released.
392 ;
393 ;cc_qsig_signaling_link_rsp = retain
394 ;
395 ; See ccss.conf.sample for more options.  The timers described by ccss.conf.sample
396 ; are not used by ISDN for the native protocol since they are defined by the
397 ; standards and set by pritimer above.
398 ;
399 ; To enable transmission of facility-based ISDN supplementary services (such
400 ; as caller name from CPE over facility), enable this option.
401 ; Cannot be changed on a reload.
402 ;
403 ;facilityenable = yes
404 ;
405
406 ; This option enables Advice of Charge pass-through between the ISDN PRI and
407 ; Asterisk.  This option can be set to any combination of 's', 'd', and 'e' which
408 ; represent the different variants of Advice of Charge, AOC-S, AOC-D, and AOC-E.
409 ; Advice of Charge pass-through is currently only supported for ETSI.  Since most
410 ; AOC messages are sent on facility messages, the 'facilityenable' option must
411 ; also be enabled to fully support AOC pass-through.
412 ;
413 ;aoc_enable=s,d,e
414 ;
415 ; When this option is enabled, a hangup initiated by the ISDN PRI side of the
416 ; asterisk channel will result in the channel delaying its hangup in an
417 ; attempt to receive the final AOC-E message from its bridge.  The delay
418 ; period is configured as one half the T305 timer length. If the channel
419 ; is not bridged the hangup will occur immediatly without delay.
420 ;
421 ;aoce_delayhangup=yes
422
423 ; pritimer cannot be changed on a reload.
424 ;
425 ; Signalling method. The default is "auto". Valid values:
426 ; auto:           Use the current value from DAHDI.
427 ; em:             E & M
428 ; em_e1:          E & M E1
429 ; em_w:           E & M Wink
430 ; featd:          Feature Group D (The fake, Adtran style, DTMF)
431 ; featdmf:        Feature Group D (The real thing, MF (domestic, US))
432 ; featdmf_ta:     Feature Group D (The real thing, MF (domestic, US)) through
433 ;                 a Tandem Access point
434 ; featb:          Feature Group B (MF (domestic, US))
435 ; fgccama:        Feature Group C-CAMA (DP DNIS, MF ANI)
436 ; fgccamamf:      Feature Group C-CAMA MF (MF DNIS, MF ANI)
437 ; fxs_ls:         FXS (Loop Start)
438 ; fxs_gs:         FXS (Ground Start)
439 ; fxs_ks:         FXS (Kewl Start)
440 ; fxo_ls:         FXO (Loop Start)
441 ; fxo_gs:         FXO (Ground Start)
442 ; fxo_ks:         FXO (Kewl Start)
443 ; pri_cpe:        PRI signalling, CPE side
444 ; pri_net:        PRI signalling, Network side
445 ; bri_cpe:        BRI PTP signalling, CPE side
446 ; bri_net:        BRI PTP signalling, Network side
447 ; bri_cpe_ptmp:   BRI PTMP signalling, CPE side
448 ; bri_net_ptmp:   BRI PTMP signalling, Network side
449 ; sf:             SF (Inband Tone) Signalling
450 ; sf_w:           SF Wink
451 ; sf_featd:       SF Feature Group D (The fake, Adtran style, DTMF)
452 ; sf_featdmf:     SF Feature Group D (The real thing, MF (domestic, US))
453 ; sf_featb:       SF Feature Group B (MF (domestic, US))
454 ; e911:           E911 (MF) style signalling
455 ; ss7:            Signalling System 7
456 ; mfcr2:          MFC/R2 Signalling. To specify the country variant see 'mfcr2_variant'
457 ;
458 ; The following are used for Radio interfaces:
459 ; fxs_rx:         Receive audio/COR on an FXS kewlstart interface (FXO at the
460 ;                 channel bank)
461 ; fxs_tx:         Transmit audio/PTT on an FXS loopstart interface (FXO at the
462 ;                 channel bank)
463 ; fxo_rx:         Receive audio/COR on an FXO loopstart interface (FXS at the
464 ;                 channel bank)
465 ; fxo_tx:         Transmit audio/PTT on an FXO groundstart interface (FXS at
466 ;                 the channel bank)
467 ; em_rx:          Receive audio/COR on an E&M interface (1-way)
468 ; em_tx:          Transmit audio/PTT on an E&M interface (1-way)
469 ; em_txrx:        Receive audio/COR AND Transmit audio/PTT on an E&M interface
470 ;                 (2-way)
471 ; em_rxtx:        Same as em_txrx (for our dyslexic friends)
472 ; sf_rx:          Receive audio/COR on an SF interface (1-way)
473 ; sf_tx:          Transmit audio/PTT on an SF interface (1-way)
474 ; sf_txrx:        Receive audio/COR AND Transmit audio/PTT on an SF interface
475 ;                 (2-way)
476 ; sf_rxtx:        Same as sf_txrx (for our dyslexic friends)
477 ; ss7:            Signalling System 7
478 ;
479 ; signalling of a channel can not be changed on a reload.
480 ;
481 ;signalling=fxo_ls
482 ;
483 ; If you have an outbound signalling format that is different from format
484 ; specified above (but compatible), you can specify outbound signalling format,
485 ; (see below). The 'signalling' format specified will be the inbound signalling
486 ; format. If you only specify 'signalling', then it will be the format for
487 ; both inbound and outbound.
488 ;
489 ; outsignalling can only be one of:
490 ;   em, em_e1, em_w, sf, sf_w, sf_featd, sf_featdmf, sf_featb, featd,
491 ;   featdmf, featdmf_ta, e911, fgccama, fgccamamf
492 ;
493 ; outsignalling cannot be changed on a reload.
494 ;
495 ;signalling=featdmf
496 ;
497 ;outsignalling=featb
498 ;
499 ; For Feature Group D Tandem access, to set the default CIC and OZZ use these
500 ; parameters (Will not be updated on reload):
501 ;
502 ;defaultozz=0000
503 ;defaultcic=303
504 ;
505 ; A variety of timing parameters can be specified as well
506 ; The default values for those are "-1", which is to use the
507 ; compile-time defaults of the DAHDI kernel modules. The timing
508 ; parameters, (with the standard default from DAHDI):
509 ;
510 ;    prewink:     Pre-wink time (default 50ms)
511 ;    preflash:    Pre-flash time (default 50ms)
512 ;    wink:        Wink time (default 150ms)
513 ;    flash:       Flash time (default 750ms)
514 ;    start:       Start time (default 1500ms)
515 ;    rxwink:      Receiver wink time (default 300ms)
516 ;    rxflash:     Receiver flashtime (default 1250ms)
517 ;    debounce:    Debounce timing (default 600ms)
518 ;
519 ; None of them will update on a reload.
520 ;
521 ; How long generated tones (DTMF and MF) will be played on the channel
522 ; (in milliseconds).
523 ;
524 ; This is a global, rather than a per-channel setting. It will not be
525 ; updated on a reload.
526 ;
527 ;toneduration=100
528 ;
529 ; Whether or not to do distinctive ring detection on FXO lines:
530 ;
531 ;usedistinctiveringdetection=yes
532 ;
533 ; enable dring detection after caller ID for those countries like Australia
534 ; where the ring cadence is changed *after* the caller ID spill:
535 ;
536 ;distinctiveringaftercid=yes
537 ;
538 ; Whether or not to use caller ID:
539 ;
540 usecallerid=yes
541 ;
542 ; Type of caller ID signalling in use
543 ;     bell     = bell202 as used in US (default)
544 ;     v23      = v23 as used in the UK
545 ;     v23_jp   = v23 as used in Japan
546 ;     dtmf     = DTMF as used in Denmark, Sweden and Netherlands
547 ;     smdi     = Use SMDI for caller ID.  Requires SMDI to be enabled (usesmdi).
548 ;
549 ;cidsignalling=v23
550 ;
551 ; What signals the start of caller ID
552 ;     ring        = a ring signals the start (default)
553 ;     polarity    = polarity reversal signals the start
554 ;     polarity_IN = polarity reversal signals the start, for India,
555 ;                   for dtmf dialtone detection; using DTMF.
556 ;     (see https://wiki.asterisk.org/wiki/display/AST/Caller+ID+in+India)
557 ;     dtmf        = causes monitor loop to look for dtmf energy on the
558 ;                   incoming channel to initate cid acquisition
559 ;
560 ;cidstart=polarity
561 ;
562 ; When cidstart=dtmf, the energy level on the line used to trigger dtmf cid
563 ; acquisition. This number is compared to the average over a packet of audio
564 ; of the absolute values of 16 bit signed linear samples. The default is set
565 ; to 256. The choice of 256 is arbitrary. The value you should select should
566 ; be high enough to prevent false detections while low enough to insure that
567 ; no dtmf spills are missed.
568 ;
569 ;dtmfcidlevel=256
570 ;
571 ; Whether or not to hide outgoing caller ID (Override with *67 or *82)
572 ; (If your dialplan doesn't catch it)
573 ;
574 ;hidecallerid=yes
575 ;
576 ; Enable if you need to hide just the name and not the number for legacy PBX use.
577 ; Only applies to PRI channels.
578 ;hidecalleridname=yes
579 ;
580 ; On UK analog lines, the caller hanging up determines the end of calls.  So
581 ; Asterisk hanging up the line may or may not end a call (DAHDI could just as
582 ; easily be re-attaching to a prior incoming call that was not yet hung up).
583 ; This option changes the hangup to wait for a dialtone on the line, before
584 ; marking the line as once again available for use with outgoing calls.
585 ; Specified in milliseconds, not set by default.
586 ;waitfordialtone=1000
587 ;
588 ; For analog lines, enables Asterisk to use dialtone detection per channel
589 ; if an incoming call was hung up before it was answered.  If dialtone is
590 ; detected, the call is hung up.
591 ; no:       Disabled. (Default)
592 ; yes:      Look for dialtone for 10000 ms after answer.
593 ; <number>: Look for dialtone for the specified number of ms after answer.
594 ; always:   Look for dialtone for the entire call.  Dialtone may return
595 ;           if the far end hangs up first.
596 ;
597 ;dialtone_detect=no
598 ;
599 ; The following option enables receiving MWI on FXO lines.  The default
600 ; value is no.
601 ;       The mwimonitor can take the following values
602 ;               no - No mwimonitoring occurs. (default)
603 ;               yes - The same as specifying fsk
604 ;               fsk - the FXO line is monitored for MWI FSK spills
605 ;               fsk,rpas - the FXO line is monitored for MWI FSK spills preceded
606 ;                       by a ring pulse alert signal.
607 ;               neon - The fxo line is monitored for the presence of NEON pulses
608 ;                       indicating MWI.
609 ; When detected, an internal Asterisk MWI event is generated so that any other
610 ; part of Asterisk that cares about MWI state changes is notified, just as if
611 ; the state change came from app_voicemail.
612 ; For FSK MWI Spills, the energy level that must be seen before starting the
613 ; MWI detection process can be set with 'mwilevel'.
614 ;
615 ;mwimonitor=no
616 ;mwilevel=512
617 ;
618 ; This option is used in conjunction with mwimonitor.  This will get executed
619 ; when incoming MWI state changes.  The script is passed 2 arguments.  The
620 ; first is the corresponding configured mailbox, and the second is 1 or 0,
621 ; indicating if there are messages waiting or not.
622 ; Note: app_voicemail mailboxes are in the form of mailbox@context.
623 ;
624 ; /usr/local/bin/dahdinotify.sh 501@mailboxes 1
625 ;
626 ;mwimonitornotify=/usr/local/bin/dahdinotify.sh
627 ;
628 ; The following keyword 'mwisendtype' enables various VMWI methods on FXS lines (if supported).
629 ; The default is to send FSK only.
630 ; The following options are available;
631 ; 'rpas' Ring Pulse Alert Signal, alerts intelligent phones that a FSK message is about to be sent.
632 ; 'lrev' Line reversed to indicate messages waiting.
633 ; 'hvdc' 90Vdc OnHook DC voltage to indicate messages waiting.
634 ; 'hvac' or 'neon' 90Vac OnHook AC voltage to light Neon bulb.
635 ; 'nofsk' Disables FSK MWI spills from being sent out.
636 ; It is feasible that multiple options can be enabled.
637 ;mwisendtype=rpas,lrev
638 ;
639 ; Whether or not to enable call waiting on internal extensions
640 ; With this set to 'yes', busy extensions will hear the call-waiting
641 ; tone, and can use hook-flash to switch between callers. The Dial()
642 ; app will not return the "BUSY" result for extensions.
643 ;
644 callwaiting=yes
645 ;
646 ; Configure the number of outstanding call waiting calls for internal ISDN
647 ; endpoints before bouncing the calls as busy.  This option is equivalent to
648 ; the callwaiting option for analog ports.
649 ; A call waiting call is a SETUP message with no B channel selected.
650 ; The default is zero to disable call waiting for ISDN endpoints.
651 ;max_call_waiting_calls=0
652 ;
653 ; Allow incoming ISDN call waiting calls.
654 ; A call waiting call is a SETUP message with no B channel selected.
655 ;allow_call_waiting_calls=no
656
657 ; Configure the ISDN span to indicate MWI for the list of mailboxes.
658 ; You can give a comma separated list of up to 8 mailboxes per span.
659 ; An empty list disables MWI.
660 ;
661 ; The default is an empty list.
662 ;mwi_mailboxes=vm-mailbox{,vm-mailbox}
663 ;  vm-mailbox = Internal voicemail mailbox identifier.
664 ;  Note: app_voicemail mailboxes must be in the form of mailbox@context.
665 ;mwi_mailboxes=501@mailboxes,502@mailboxes
666
667 ; Configure the ISDN mailbox number sent over the span for MWI mailboxes.
668 ; The position of the number in the list corresponds to the position in
669 ; mwi_mailboxes.  If either position in mwi_mailboxes or mwi_vm_boxes is
670 ; empty then that position is disabled.
671 ;
672 ; The default is an empty list.
673 ;mwi_vm_boxes=mailbox_number{,mailbox_number}
674 ;mwi_vm_boxes=501,502
675
676 ; Configure the ISDN span voicemail controlling numbers for MWI mailboxes.
677 ; What number to call for a user to retrieve voicemail messages.
678 ;
679 ; You can give a comma separated list of numbers.  The position of the number
680 ; corresponds to the position in mwi_mailboxes.  If a position is empty then
681 ; the last number is reused.
682 ;
683 ; For example:
684 ;  mwi_vm_numbers=700,,800,,900
685 ; is equivalent to:
686 ;  mwi_vm_numbers=700,700,800,800,900,900,900,900
687 ;
688 ; The default is no number.
689 ;mwi_vm_numbers=
690
691 ; Whether or not restrict outgoing caller ID (will be sent as ANI only, not
692 ; available for the user)
693 ; Mostly use with FXS ports
694 ; Does nothing.  Use hidecallerid instead.
695 ;
696 ;restrictcid=no
697 ;
698 ; Whether or not to use the caller ID presentation from the Asterisk channel
699 ; for outgoing calls.
700 ; See dialplan function CALLERID(pres) for more information.
701 ; Only applies to PRI and SS7 channels.
702 ;
703 usecallingpres=yes
704 ;
705 ; Some countries (UK) have ring tones with different ring tones (ring-ring),
706 ; which means the caller ID needs to be set later on, and not just after
707 ; the first ring, as per the default (1).
708 ;
709 ;sendcalleridafter = 2
710 ;
711 ;
712 ; Support caller ID on Call Waiting
713 ;
714 callwaitingcallerid=yes
715 ;
716 ; Support three-way calling
717 ;
718 threewaycalling=yes
719 ;
720 ; For FXS ports (either direct analog or over T1/E1):
721 ;   Support flash-hook call transfer (requires three way calling)
722 ;   Also enables call parking (overrides the 'canpark' parameter)
723 ;
724 ; For digital ports using ISDN PRI protocols:
725 ;   Support switch-side transfer (called 2BCT, RLT or other names)
726 ;   This setting must be enabled on both ports involved, and the
727 ;   'facilityenable' setting must also be enabled to allow sending
728 ;   the transfer to the ISDN switch, since it sent in a FACILITY
729 ;   message.
730 ;   NOTE:  This should be disabled for NT PTMP mode.  Phones cannot
731 ;   have tromboned calls pushed down to them.
732 ;
733 transfer=yes
734 ;
735 ; Allow call parking
736 ; ('canpark=no' is overridden by 'transfer=yes')
737 ;
738 canpark=yes
739
740 ; Sets the default parking lot for call parking.
741 ; This is setable per channel.
742 ; Parkinglots are configured in features.conf
743 ;
744 ;parkinglot=plaza
745
746 ;
747 ; Support call forward variable
748 ;
749 cancallforward=yes
750 ;
751 ; Whether or not to support Call Return (*69, if your dialplan doesn't
752 ; catch this first)
753 ;
754 callreturn=yes
755 ;
756 ; Stutter dialtone support: If voicemail is received in the mailbox then
757 ; taking the phone off hook will cause a stutter dialtone instead of a
758 ; normal one.
759 ;
760 ; Note: app_voicemail mailboxes must be in the form of mailbox@context.
761 ;
762 ;mailbox=1234@context
763 ;
764 ; Enable echo cancellation
765 ; Use either "yes", "no", or a power of two from 32 to 256 if you wish to
766 ; actually set the number of taps of cancellation.
767 ;
768 ; Note that when setting the number of taps, the number 256 does not translate
769 ; to 256 ms of echo cancellation.  echocancel=256 means 256 / 8 = 32 ms.
770 ;
771 ; Note that if any of your DAHDI cards have hardware echo cancellers,
772 ; then this setting only turns them on and off; numeric settings will
773 ; be treated as "yes". There are no special settings required for
774 ; hardware echo cancellers; when present and enabled in their kernel
775 ; modules, they take precedence over the software echo canceller compiled
776 ; into DAHDI automatically.
777 ;
778 ;
779 echocancel=yes
780 ;
781 ; Some DAHDI echo cancellers (software and hardware) support adjustable
782 ; parameters; these parameters can be supplied as additional options to
783 ; the 'echocancel' setting. Note that Asterisk does not attempt to
784 ; validate the parameters or their values, so if you supply an invalid
785 ; parameter you will not know the specific reason it failed without
786 ; checking the kernel message log for the error(s) put there by DAHDI.
787 ;
788 ;echocancel=128,param1=32,param2=0,param3=14
789 ;
790 ; Generally, it is not necessary (and in fact undesirable) to echo cancel when
791 ; the circuit path is entirely TDM.  You may, however, change this behavior
792 ; by enabling the echo canceller during pure TDM bridging below.
793 ;
794 echocancelwhenbridged=yes
795 ;
796 ; In some cases, the echo canceller doesn't train quickly enough and there
797 ; is echo at the beginning of the call.  Enabling echo training will cause
798 ; DAHDI to briefly mute the channel, send an impulse, and use the impulse
799 ; response to pre-train the echo canceller so it can start out with a much
800 ; closer idea of the actual echo.  Value may be "yes", "no", or a number of
801 ; milliseconds to delay before training (default = 400)
802 ;
803 ; WARNING:  In some cases this option can make echo worse!  If you are
804 ; trying to debug an echo problem, it is worth checking to see if your echo
805 ; is better with the option set to yes or no.  Use whatever setting gives
806 ; the best results.
807 ;
808 ; Note that these parameters do not apply to hardware echo cancellers.
809 ;
810 ;echotraining=yes
811 ;echotraining=800
812 ;
813 ; If you are having trouble with DTMF detection, you can relax the DTMF
814 ; detection parameters.  Relaxing them may make the DTMF detector more likely
815 ; to have "talkoff" where DTMF is detected when it shouldn't be.
816 ;
817 ;relaxdtmf=yes
818 ;
819 ; Hardware gain settings increase/decrease the analog volume level on a channel.
820 ;   The values are in db (decibels) and can be adjusted in 0.1 dB increments.
821 ;   A positive number increases the volume level on a channel, and a negavive
822 ;   value decreases volume level.
823 ;
824 ;   Hardware gain settings are only possible on hardware with analog ports
825 ;   because the gain is done on the analog side of the analog/digital conversion.
826 ;
827 ;   When hardware gains are disabled, Asterisk will NOT touch the gain setting
828 ;   already configured in hardware.
829 ;
830 ;   hwrxgain: Hardware receive gain for the channel (into Asterisk).
831 ;             Default: disabled
832 ;   hwtxgain: Hardware transmit gain for the channel (out of Asterisk).
833 ;             Default: disabled
834 ;
835 ;hwrxgain=disabled
836 ;hwtxgain=disabled
837 ;hwrxgain=2.0
838 ;hwtxgain=3.0
839 ;
840 ; Software gain settings digitally increase/decrease the volume level on a channel.
841 ;   The values are in db (decibels).  A positive number increases the volume
842 ;   level on a channel, and a negavive value decreases volume level.
843 ;
844 ;   Software gains work on the digital side of the analog/digital conversion
845 ;   and thus can also work with T1/E1 cards.
846 ;
847 ;   rxgain: Software receive gain for the channel (into Asterisk). Default: 0.0
848 ;   txgain: Software transmit gain for the channel (out of Asterisk).
849 ;             Default: 0.0
850 ;
851 ;   cid_rxgain: Add this gain to rxgain when Asterisk expects to receive
852 ;               a Caller ID stream.
853 ;               Default: 5.0 .
854 ;
855 ;rxgain=2.0
856 ;txgain=3.0
857 ;
858 ; Dynamic Range Compression: You can also enable dynamic range compression
859 ;   on a channel.  This will digitally amplify quiet sounds while leaving louder
860 ;   sounds untouched.  This is useful in situations where a linear gain setting
861 ;   would cause clipping.  Acceptable values are in the range of 0.0 to around
862 ;   6.0 with higher values causing more compression to be done.
863 ;
864 ;   rxdrc: dynamic range compression for the rx channel. Default: 0.0
865 ;   txdrc: dynamic range compression for the tx channel. Default: 0.0
866 ;
867 ;rxdrc=1.0
868 ;txdrc=4.0
869 ;
870 ; Logical groups can be assigned to allow outgoing roll-over.  Groups range
871 ; from 0 to 63, and multiple groups can be specified. By default the
872 ; channel is not a member of any group.
873 ;
874 ; Note that an explicit empty value for 'group' is invalid, and will not
875 ; override a previous non-empty one. The same applies to callgroup and
876 ; pickupgroup as well.
877 ;
878 group=1
879 ;
880 ; Ring groups (a.k.a. call groups) and pickup groups.  If a phone is ringing
881 ; and it is a member of a group which is one of your pickup groups, then
882 ; you can answer it by picking up and dialing *8#.  For simple offices, just
883 ; make these both the same.  Groups range from 0 to 63.
884 ;
885 callgroup=1
886 pickupgroup=1
887 ;
888 ; Named ring groups (a.k.a. named call groups) and named pickup groups.
889 ; If a phone is ringing and it is a member of a group which is one of your
890 ; named pickup groups, then you can answer it by picking up and dialing *8#.
891 ; For simple offices, just make these both the same.
892 ; The number of named groups is not limited.
893 ;
894 ;namedcallgroup=engineering,sales,netgroup,protgroup
895 ;namedpickupgroup=sales
896
897 ; Channel variables to be set for all calls from this channel
898 ;setvar=CHANNEL=42
899 ;setvar=ATTENDED_TRANSFER_COMPLETE_SOUND=beep   ; This channel variable will
900                                                 ; cause the given audio file to
901                                                 ; be played upon completion of
902                                                 ; an attended transfer to the
903                                                 ; target of the transfer.
904
905 ;
906 ; Specify whether the channel should be answered immediately or if the simple
907 ; switch should provide dialtone, read digits, etc.
908 ; Note: If immediate=yes the dialplan execution will always start at extension
909 ; 's' priority 1 regardless of the dialed number!
910 ;
911 ;immediate=yes
912 ;
913 ; Specify whether flash-hook transfers to 'busy' channels should complete or
914 ; return to the caller performing the transfer (default is yes).
915 ;
916 ;transfertobusy=no
917
918 ; Calls will have the party id user tag set to this string value.
919 ;
920 ;cid_tag=
921
922 ; With this set, you can automatically append the MSN of a party
923 ; to the cid_tag.  An '_' is used to separate the tag from the MSN.
924 ; Applies to ISDN spans.
925 ; Default is no.
926 ;
927 ; Table of what number is appended:
928 ;      outgoing  incoming
929 ; net  dialed    caller
930 ; cpe  caller    dialed
931 ;
932 ;append_msn_to_cid_tag=no
933
934 ; caller ID can be set to "asreceived" or a specific number if you want to
935 ; override it.  Note that "asreceived" only applies to trunk interfaces.
936 ; fullname sets just the
937 ;
938 ; fullname: sets just the name part.
939 ; cid_number: sets just the number part:
940 ;
941 ;callerid = 123456
942 ;
943 ;callerid = My Name <2564286000>
944 ; Which can also be written as:
945 ;cid_number = 2564286000
946 ;fullname = My Name
947 ;
948 ;callerid = asreceived
949 ;
950 ; should we use the caller ID from incoming call on DAHDI transfer?
951 ;
952 ;useincomingcalleridondahditransfer = yes
953 ;
954 ; Add a description for the channel which can be shown through the Asterisk
955 ; console  when executing the 'dahdi show channels' command is run.
956 ;
957 ;description=Phone located in lobby
958 ;
959 ; AMA flags affects the recording of Call Detail Records.  If specified
960 ; it may be 'default', 'omit', 'billing', or 'documentation'.
961 ;
962 ;amaflags=default
963 ;
964 ; Channels may be associated with an account code to ease
965 ; billing
966 ;
967 ;accountcode=lss0101
968 ;
969 ; ADSI (Analog Display Services Interface) can be enabled on a per-channel
970 ; basis if you have (or may have) ADSI compatible CPE equipment
971 ;
972 ;adsi=yes
973 ;
974 ; SMDI (Simplified Message Desk Interface) can be enabled on a per-channel
975 ; basis if you would like that channel to behave like an SMDI message desk.
976 ; The SMDI port specified should have already been defined in smdi.conf.  The
977 ; default port is /dev/ttyS0.
978 ;
979 ;usesmdi=yes
980 ;smdiport=/dev/ttyS0
981 ;
982 ; On trunk interfaces (FXS) and E&M interfaces (E&M, Wink, Feature Group D
983 ; etc, it can be useful to perform busy detection either in an effort to
984 ; detect hangup or for detecting busies.  This enables listening for
985 ; the beep-beep busy pattern.
986 ;
987 ;busydetect=yes
988 ;
989 ; If busydetect is enabled, it is also possible to specify how many busy tones
990 ; to wait for before hanging up.  The default is 3, but it might be
991 ; safer to set to 6 or even 8.  Mind that the higher the number, the more
992 ; time that will be needed to hangup a channel, but lowers the probability
993 ; that you will get random hangups.
994 ;
995 ;busycount=6
996 ;
997 ; If busydetect is enabled, it is also possible to specify the cadence of your
998 ; busy signal.  In many countries, it is 500msec on, 500msec off.  Without
999 ; busypattern specified, we'll accept any regular sound-silence pattern that
1000 ; repeats <busycount> times as a busy signal.  If you specify busypattern,
1001 ; then we'll further check the length of the sound (tone) and silence, which
1002 ; will further reduce the chance of a false positive.
1003 ;
1004 ;busypattern=500,500
1005 ;
1006 ; NOTE: In make menuselect, you'll find further options to tweak the busy
1007 ; detector.  If your country has a busy tone with the same length tone and
1008 ; silence (as many countries do), consider enabling the
1009 ; BUSYDETECT_COMPARE_TONE_AND_SILENCE option.
1010 ;
1011 ; To further detect which hangup tone your telco provider is sending, it is
1012 ; useful to use the dahdi_monitor utility to record the audio that main/dsp.c
1013 ; is receiving after the caller hangs up.
1014 ;
1015 ; For FXS (FXO signalled) ports
1016 ;   switch the line polarity to signal the connected PBX that an outgoing
1017 ;   call was answered by the remote party.
1018 ; For FXO (FXS signalled) ports
1019 ;   watch for a polarity reversal to mark when a outgoing call is
1020 ;   answered by the remote party.
1021 ;
1022 ;answeronpolarityswitch=yes
1023 ;
1024 ; For FXS (FXO signalled) ports
1025 ;   switch the line polarity to signal the connected PBX that the current
1026 ;   call was "hung up" by the remote party
1027 ; For FXO (FXS signalled) ports
1028 ;   In some countries, a polarity reversal is used to signal the disconnect of a
1029 ;   phone line.  If the hanguponpolarityswitch option is selected, the call will
1030 ;   be considered "hung up" on a polarity reversal.
1031 ;
1032 ;hanguponpolarityswitch=yes
1033 ;
1034 ; polarityonanswerdelay: minimal time period (ms) between the answer
1035 ;                        polarity switch and hangup polarity switch.
1036 ;                        (default: 600ms)
1037 ;
1038 ; On trunk interfaces (FXS) it can be useful to attempt to follow the progress
1039 ; of a call through RINGING, BUSY, and ANSWERING.   If turned on, call
1040 ; progress attempts to determine answer, busy, and ringing on phone lines.
1041 ; This feature is HIGHLY EXPERIMENTAL and can easily detect false answers,
1042 ; so don't count on it being very accurate.
1043 ;
1044 ; Few zones are supported at the time of this writing, but may be selected
1045 ; with "progzone".
1046 ;
1047 ; progzone also affects the pattern used for buzydetect (unless
1048 ; busypattern is set explicitly). The possible values are:
1049 ;   us (default)
1050 ;   ca (alias for 'us')
1051 ;   cr (Costa Rica)
1052 ;   br (Brazil, alias for 'cr')
1053 ;   uk
1054 ;
1055 ; This feature can also easily detect false hangups. The symptoms of this is
1056 ; being disconnected in the middle of a call for no reason.
1057 ;
1058 ;callprogress=yes
1059 ;progzone=uk
1060 ;
1061 ; Set the tonezone. Equivalent of the defaultzone settings in
1062 ; /etc/dahdi/system.conf. This sets the tone zone by number.
1063 ; Note that you'd still need to load tonezones (loadzone in
1064 ; /etc/dahdi/system.conf).
1065 ; The default is -1: not to set anything.
1066 ;tonezone = 0 ; 0 is US
1067 ;
1068 ; FXO (FXS signalled) devices must have a timeout to determine if there was a
1069 ; hangup before the line was answered.  This value can be tweaked to shorten
1070 ; how long it takes before DAHDI considers a non-ringing line to have hungup.
1071 ;
1072 ; ringtimeout will not update on a reload.
1073 ;
1074 ;ringtimeout=8000
1075 ;
1076 ; For FXO (FXS signalled) devices, whether to use pulse dial instead of DTMF
1077 ; Pulse digits from phones (FXS devices, FXO signalling) are always
1078 ; detected.
1079 ;
1080 ;pulsedial=yes
1081 ;
1082 ; For fax detection, uncomment one of the following lines.  The default is *OFF*
1083 ;
1084 ;faxdetect=both
1085 ;faxdetect=incoming
1086 ;faxdetect=outgoing
1087 ;faxdetect=no
1088 ;
1089 ; When 'faxdetect' is used, one could use 'faxbuffers' to configure the DAHDI
1090 ; transmit buffer policy.  The default is *OFF*.  When this configuration
1091 ; option is used, the faxbuffer policy will be used for the life of the call
1092 ; after a fax tone is detected.  The faxbuffer policy is reverted after the
1093 ; call is torn down.  The sample below will result in 6 buffers and a full
1094 ; buffer policy.
1095 ;
1096 ;faxbuffers=>6,full
1097 ;
1098 ; Configure the default number of DAHDI buffers and the transmit policy to use.
1099 ; This can be used to eliminate data drops when scheduling jitter prevents
1100 ; Asterisk from writing to a DAHDI channel regularly. Most users will probably
1101 ; want "faxbuffers" instead of "buffers".
1102 ;
1103 ; The policies are:
1104 ; immediate - DAHDI will immediately start sending the data to the hardware after
1105 ;             Asterisk writes to the channel. This is the default mode. It
1106 ;             introduces the least amount of latency but has an increased chance for
1107 ;             hardware under runs if Asterisk is not able to keep the DAHDI write
1108 ;             queue from going empty.
1109 ; half      - DAHDI will wait until half of the configured buffers are full before
1110 ;             starting to transmit. This adds latency to the audio but reduces
1111 ;             the chance of under runs. Essentially, this is like an in-kernel jitter
1112 ;             buffer.
1113 ; full      - DAHDI will not start transmitting until all buffers are full.
1114 ;             Introduces the most amount of latency and is susceptible to over
1115 ;             runs from the Asterisk process.
1116 ;
1117 ; The receive policy is never changed. DAHDI will always pass up audio as soon
1118 ; as possible.
1119 ;
1120 ; The default number of buffers is 4 (from jitterbuffers) and the default policy
1121 ; is immediate.
1122 ;
1123 ;buffers=4,immediate
1124 ;
1125 ; This option specifies what to do when the channel's bridged peer puts the
1126 ; ISDN channel on hold.  Settable per logical ISDN span.
1127 ; moh:          Generate music-on-hold to the remote party.
1128 ; notify:       Send hold notification signaling to the remote party.
1129 ;               For ETSI PTP and ETSI PTMP NT links.
1130 ;               (The notify setting deprecates the mohinterpret=passthrough setting.)
1131 ; hold:         Use HOLD/RETRIEVE signaling to release the B channel while on hold.
1132 ;               For ETSI PTMP TE links.
1133 ;
1134 ;moh_signaling=moh
1135 ;
1136 ; This option specifies a preference for which music on hold class this channel
1137 ; should listen to when put on hold if the music class has not been set on the
1138 ; channel with Set(CHANNEL(musicclass)=whatever) in the dialplan, and the peer
1139 ; channel putting this one on hold did not suggest a music class.
1140 ;
1141 ; This option may be set globally or on a per-channel basis.
1142 ;
1143 ;mohinterpret=default
1144 ;
1145 ; This option specifies which music on hold class to suggest to the peer channel
1146 ; when this channel places the peer on hold.  This option may be set globally,
1147 ; or on a per-channel basis.
1148 ;
1149 ;mohsuggest=default
1150 ;
1151 ; PRI channels can have an idle extension and a minunused number.  So long as
1152 ; at least "minunused" channels are idle, chan_dahdi will try to call "idledial"
1153 ; on them, and then dump them into the PBX in the "idleext" extension (which
1154 ; is of the form exten@context).  When channels are needed the "idle" calls
1155 ; are disconnected (so long as there are at least "minidle" calls still
1156 ; running, of course) to make more channels available.  The primary use of
1157 ; this is to create a dynamic service, where idle channels are bundled through
1158 ; multilink PPP, thus more efficiently utilizing combined voice/data services
1159 ; than conventional fixed mappings/muxings.
1160 ;
1161 ; Those settings cannot be changed on reload.
1162 ;
1163 ;idledial=6999
1164 ;idleext=6999@dialout
1165 ;minunused=2
1166 ;minidle=1
1167 ;
1168 ;
1169 ; ignore_failed_channels: Continue even if some channels failed to configure.
1170 ; False by default, as if even a single channel failed to configure, it might
1171 ; mean other channels are misplaced and having them work may not be a good
1172 ; idea. If enabled (set to true), chan_dahdi will nevertheless attempt to
1173 ; configure other channels rather than giving up. This normally makes sense
1174 ; only if you use names (<subdir>!<number>) for DAHDI channels.
1175 ;ignore_failed_channels = true
1176 ;
1177 ; Configure jitter buffers in DAHDI (each one is 20ms, default is 4)
1178 ; This is set globally, rather than per-channel.
1179 ;
1180 ;jitterbuffers=4
1181 ;
1182 ;------------------------------ JITTER BUFFER CONFIGURATION --------------------------
1183 ; jbenable = yes              ; Enables the use of a jitterbuffer on the receiving side of a
1184                               ; DAHDI channel. Defaults to "no". An enabled jitterbuffer will
1185                               ; be used only if the sending side can create and the receiving
1186                               ; side can not accept jitter. The DAHDI channel can't accept jitter,
1187                               ; thus an enabled jitterbuffer on the receive DAHDI side will always
1188                               ; be used if the sending side can create jitter.
1189
1190 ; jbmaxsize = 200             ; Max length of the jitterbuffer in milliseconds.
1191
1192 ; jbresyncthreshold = 1000    ; Jump in the frame timestamps over which the jitterbuffer is
1193                               ; resynchronized. Useful to improve the quality of the voice, with
1194                               ; big jumps in/broken timestamps, usually sent from exotic devices
1195                               ; and programs. Defaults to 1000.
1196
1197 ; jbimpl = fixed              ; Jitterbuffer implementation, used on the receiving side of a DAHDI
1198                               ; channel. Two implementations are currently available - "fixed"
1199                               ; (with size always equals to jbmax-size) and "adaptive" (with
1200                               ; variable size, actually the new jb of IAX2). Defaults to fixed.
1201
1202 ; jbtargetextra = 40          ; This option only affects the jb when 'jbimpl = adaptive' is set.
1203                               ; The option represents the number of milliseconds by which the new
1204                               ; jitter buffer will pad its size. the default is 40, so without
1205                               ; modification, the new jitter buffer will set its size to the jitter
1206                               ; value plus 40 milliseconds. increasing this value may help if your
1207                               ; network normally has low jitter, but occasionally has spikes.
1208
1209 ; jblog = no                  ; Enables jitterbuffer frame logging. Defaults to "no".
1210 ;-----------------------------------------------------------------------------------
1211 ;
1212 ; You can define your own custom ring cadences here.  You can define up to 8
1213 ; pairs.  If the silence is negative, it indicates where the caller ID spill is
1214 ; to be placed.  Also, if you define any custom cadences, the default cadences
1215 ; will be turned off.
1216 ;
1217 ; This setting is global, rather than per-channel. It will not update on
1218 ; a reload.
1219 ;
1220 ; Syntax is:  cadence=ring,silence[,ring,silence[...]]
1221 ;
1222 ; These are the default cadences:
1223 ;
1224 ;cadence=125,125,2000,-4000
1225 ;cadence=250,250,500,1000,250,250,500,-4000
1226 ;cadence=125,125,125,125,125,-4000
1227 ;cadence=1000,500,2500,-5000
1228 ;
1229 ; Each channel consists of the channel number or range.  It inherits the
1230 ; parameters that were specified above its declaration.
1231 ;
1232 ;
1233 ;callerid="Green Phone"<(256) 428-6121>
1234 ;description=Reception Phone                    ; add a description for 'dahdi show channels'
1235 ;channel => 1
1236 ;callerid="Black Phone"<(256) 428-6122>
1237 ;description=Courtesy Phone
1238 ;channel => 2
1239 ;callerid="CallerID Phone" <(630) 372-1564>
1240 ;description=                                   ; reset the description for following channels
1241 ;channel => 3
1242 ;callerid="Pac Tel Phone" <(256) 428-6124>
1243 ;channel => 4
1244 ;callerid="Uniden Dead" <(256) 428-6125>
1245 ;channel => 5
1246 ;callerid="Cortelco 2500" <(256) 428-6126>
1247 ;channel => 6
1248 ;callerid="Main TA 750" <(256) 428-6127>
1249 ;channel => 44
1250 ;
1251 ; For example, maybe we have some other channels which start out in a
1252 ; different context and use E & M signalling instead.
1253 ;
1254 ;context=remote
1255 ;signaling=em
1256 ;channel => 15
1257 ;channel => 16
1258
1259 ;signalling=em_w
1260 ;
1261 ; All those in group 0 I'll use for outgoing calls
1262 ;
1263 ; Strip most significant digit (9) before sending
1264 ;
1265 ;stripmsd=1
1266 ;callerid=asreceived
1267 ;group=0
1268 ;signalling=fxs_ls
1269 ;channel => 45
1270
1271 ;signalling=fxo_ls
1272 ;group=1
1273 ;callerid="Joe Schmoe" <(256) 428-6131>
1274 ;channel => 25
1275 ;callerid="Megan May" <(256) 428-6132>
1276 ;channel => 26
1277 ;callerid="Suzy Queue" <(256) 428-6233>
1278 ;channel => 27
1279 ;callerid="Larry Moe" <(256) 428-6234>
1280 ;channel => 28
1281 ;
1282 ; Sample PRI (CPE) config:  Specify the switchtype, the signalling as either
1283 ; pri_cpe or pri_net for CPE or Network termination, and generally you will
1284 ; want to create a single "group" for all channels of the PRI.
1285 ;
1286 ; switchtype cannot be changed on a reload.
1287 ;
1288 ; switchtype = national
1289 ; signalling = pri_cpe
1290 ; group = 2
1291 ; channel => 1-23
1292 ;
1293 ; Alternatively, the number of the channel may be replaced with a relative
1294 ; path to a device file under /dev/dahdi . The final element of that file
1295 ; must be a number, though. The directory separator is '!', as we can't
1296 ; use '/' in a dial string. So if we have
1297 ;
1298 ;   /dev/dahdi/span-name/pstn/00/1
1299 ;   /dev/dahdi/span-name/pstn/00/2
1300 ;   /dev/dahdi/span-name/pstn/00/3
1301 ;   /dev/dahdi/span-name/pstn/00/4
1302 ;
1303 ; we could use:
1304 ;channel => span-name!pstn!00!1-4
1305 ;
1306 ; or:
1307 ;channel => span-name!pstn!00!1,2,3,4
1308 ;
1309 ; See also ignore_failed_channels above.
1310
1311 ;  Used for distinctive ring support for x100p.
1312 ;  You can see the dringX patterns is to set any one of the dringXcontext fields
1313 ;  and they will be printed on the console when an inbound call comes in.
1314 ;
1315 ;  dringXrange is used to change the acceptable ranges for "tone offsets".  Defaults to 10.
1316 ;  Note: a range of 0 is NOT what you might expect - it instead forces it to the default.
1317 ;  A range of -1 will force it to always match.
1318 ;  Anything lower than -1 would presumably cause it to never match.
1319 ;
1320 ;dring1=95,0,0
1321 ;dring1context=internal1
1322 ;dring1range=10
1323 ;dring2=325,95,0
1324 ;dring2context=internal2
1325 ;dring2range=10
1326 ; If no pattern is matched here is where we go.
1327 ;context=default
1328 ;channel => 1
1329
1330 ; AMI alarm event reporting
1331 ;reportalarms=channels
1332 ;Possible values are:
1333 ;channels - report each channel alarms (current behavior, default for backward compatibility)
1334 ;spans - report an "SpanAlarm" event when the span of any configured channel is alarmed
1335 ;all - report channel and span alarms (aggregated behavior)
1336 ;none - do not report any alarms.
1337
1338 ; ---------------- Options for use with signalling=ss7 -----------------
1339 ; None of them can be changed by a reload.
1340 ;
1341 ; Variant of SS7 signalling:
1342 ; Options are itu and ansi
1343 ;ss7type = itu
1344
1345 ; SS7 Called Nature of Address Indicator
1346 ;
1347 ; unknown:        Unknown
1348 ; subscriber:     Subscriber
1349 ; national:       National
1350 ; international:  International
1351 ; dynamic:        Dynamically selects the appropriate dialplan
1352 ;
1353 ;ss7_called_nai=dynamic
1354 ;
1355 ; SS7 Calling Nature of Address Indicator
1356 ;
1357 ; unknown:        Unknown
1358 ; subscriber:     Subscriber
1359 ; national:       National
1360 ; international:  International
1361 ; dynamic:        Dynamically selects the appropriate dialplan
1362 ;
1363 ;ss7_calling_nai=dynamic
1364 ;
1365 ;
1366 ; sample 1 for Germany
1367 ;ss7_internationalprefix = 00
1368 ;ss7_nationalprefix = 0
1369 ;ss7_subscriberprefix =
1370 ;ss7_unknownprefix =
1371 ;
1372
1373 ; This option is used to disable automatic sending of ACM when the call is started
1374 ; in the dialplan.  If you do use this option, you will need to use the Proceeding()
1375 ; application in the dialplan to send ACM.
1376 ;ss7_explictacm=yes
1377
1378 ; All settings apply to linkset 1
1379 ;linkset = 1
1380
1381 ; Point code of the linkset.  For ITU, this is the decimal number
1382 ; format of the point code.  For ANSI, this can either be in decimal
1383 ; number format or in the xxx-xxx-xxx format
1384 ;pointcode = 1
1385
1386 ; Point code of node adjacent to this signalling link (Possibly the STP between you and
1387 ; your destination).  Point code format follows the same rules as above.
1388 ;adjpointcode = 2
1389
1390 ; Default point code that you would like to assign to outgoing messages (in case of
1391 ; routing through STPs, or using A links).  Point code format follows the same rules
1392 ; as above.
1393 ;defaultdpc = 3
1394
1395 ; Begin CIC (Circuit indication codes) count with this number
1396 ;cicbeginswith = 1
1397
1398 ; What the MTP3 network indicator bits should be set to.  Choices are
1399 ; national, national_spare, international, international_spare
1400 ;networkindicator=international
1401
1402 ; First signalling channel
1403 ;sigchan = 48
1404
1405 ; Additional signalling channel for this linkset (So you can have a linkset
1406 ; with two signalling links in it).  It seems like a silly way to do it, but
1407 ; for linksets with multiple signalling links, you add an additional sigchan
1408 ; line for every additional signalling link on the linkset.
1409 ;sigchan = 96
1410
1411 ; Channels to associate with CICs on this linkset
1412 ;channel = 25-47
1413 ;
1414 ; For more information on setting up SS7, see the README file in libss7 or
1415 ; https://wiki.asterisk.org/wiki/display/AST/Signaling+System+Number+7
1416 ; ----------------- SS7 Options ----------------------------------------
1417
1418 ; ---------------- Options for use with signalling=mfcr2 --------------
1419
1420 ; MFC-R2 signaling has lots of variants from country to country and even sometimes
1421 ; minor variants inside the same country. The only mandatory parameters here are:
1422 ; mfcr2_variant, mfcr2_max_ani and mfcr2_max_dnis.
1423 ; IT IS RECOMMENDED that you leave the default values (leaving it commented) for the 
1424 ; other parameters unless you have problems or you have been instructed to change some 
1425 ; parameter. OpenR2 library uses the mfcr2_variant parameter to try to determine the 
1426 ; best defaults for your country, also refer to the OpenR2 package directory 
1427 ; doc/asterisk/ where you can find sample configurations for some countries. If you 
1428 ; want to contribute your configs for a particular country send them to the e-mail 
1429 ; of the primary OpenR2 developer that you can find in the AUTHORS file of the OpenR2 package
1430
1431 ; MFC/R2 variant. This depends on the OpenR2 supported variants
1432 ; A list of values can be found by executing the openr2 command r2test -l
1433 ; some valid values are:
1434 ; ar (Argentina)
1435 ; br (Brazil)
1436 ; mx (Mexico)
1437 ; ph (Philippines)
1438 ; itu (per ITU spec)
1439 ; mfcr2_variant=mx
1440
1441 ; Max amount of ANI to ask for
1442 ; mfcr2_max_ani=10
1443
1444 ; Max amount of DNIS to ask for
1445 ; mfcr2_max_dnis=4
1446
1447 ; whether or not to get the ANI before getting DNIS.
1448 ; some telcos require ANI first some others do not care
1449 ; if this go wrong, change this value
1450 ; mfcr2_get_ani_first=no
1451
1452 ; Caller Category to send
1453 ; national_subscriber
1454 ; national_priority_subscriber
1455 ; international_subscriber
1456 ; international_priority_subscriber
1457 ; collect_call
1458 ; usually national_subscriber works just fine
1459 ; you can change this setting from the dialplan
1460 ; by setting the variable MFCR2_CATEGORY
1461 ; (remember to set _MFCR2_CATEGORY from originating channels)
1462 ; MFCR2_CATEGORY will also be a variable available in your context
1463 ; on incoming calls set to the value received from the far end
1464 ; mfcr2_category=national_subscriber
1465
1466 ; Call logging is stored at the Asterisk
1467 ; logging directory specified in asterisk.conf
1468 ; plus mfcr2/<whatever you put here>
1469 ; if you specify 'span1' here and asterisk.conf has
1470 ; as logging directory /var/log/asterisk then the full
1471 ; path to your MFC/R2 call logs will be /var/log/asterisk/mfcr2/span1
1472 ; (the directory will be automatically created if not present already)
1473 ; remember to set mfcr2_call_files=yes
1474 ; mfcr2_logdir=span1
1475
1476 ; whether or not to drop call files into mfcr2_logdir
1477 ; mfcr2_call_files=yes|no
1478
1479 ; MFC/R2 valid logging values are: all,error,warning,debug,notice,cas,mf,stack,nothing
1480 ; error,warning,debug and notice are self-descriptive
1481 ; 'cas' is for logging ABCD CAS tx and rx
1482 ; 'mf' is for logging of the Multi Frequency tones
1483 ; 'stack' is for very verbose output of the channel and context call stack, only useful
1484 ; if you are debugging a crash or want to learn how the library works. The stack logging
1485 ; will be only enabled if the openr2 library was compiled with -DOR2_TRACE_STACKS
1486 ; You can mix up values, like: loglevel=error,debug,mf to log just error, debug and
1487 ; multi frequency messages
1488 ; 'all' is a special value to log all the activity
1489 ; 'nothing' is a clean-up value, in case you want to not log any activity for
1490 ; a channel or group of channels
1491 ; BE AWARE that the level of output logged will ALSO depend on
1492 ; the value you have in logger.conf, if you disable output in logger.conf
1493 ; then it does not matter you specify 'all' here, nothing will be logged
1494 ; so logger.conf has the last word on what is going to be logged
1495 ; mfcr2_logging=all
1496
1497 ; MFC/R2 value in milliseconds for the MF timeout. Any negative value
1498 ; means 'default', smaller values than 500ms are not recommended
1499 ; and can cause malfunctioning. If you experience protocol error
1500 ; due to MF timeout try incrementing this value in 500ms steps
1501 ; mfcr2_mfback_timeout=-1
1502
1503 ; MFC/R2 value in milliseconds for the metering pulse timeout.
1504 ; Metering pulses are sent by some telcos for some R2 variants
1505 ; during a call presumably for billing purposes to indicate costs,
1506 ; however this pulses use the same signal that is used to indicate
1507 ; call hangup, therefore a timeout is sometimes required to distinguish
1508 ; between a *real* hangup and a billing pulse that should not
1509 ; last more than 500ms, If you experience call drops after some
1510 ; minutes of being stablished try setting a value of some ms here,
1511 ; values greater than 500ms are not recommended.
1512 ; BE AWARE that choosing the proper protocol mfcr2_variant parameter
1513 ; implicitly sets a good recommended value for this timer, use this
1514 ; parameter only when you *really* want to override the default, otherwise
1515 ; just comment out this value or put a -1
1516 ; Any negative value means 'default'.
1517 ; mfcr2_metering_pulse_timeout=-1
1518
1519 ; Brazil uses a special calling party category for collect calls (llamadas por cobrar)
1520 ; instead of using the operator (as in Mexico). The R2 spec in Brazil says a special GB tone
1521 ; should be used to reject collect calls. If you want to ALLOW collect calls specify 'yes',
1522 ; if you want to BLOCK collect calls then say 'no'. Default is to block collect calls.
1523 ; (see also 'mfcr2_double_answer')
1524 ; mfcr2_allow_collect_calls=no
1525
1526 ; This feature is related but independent of mfcr2_allow_collect_calls
1527 ; Some PBX's require a double-answer process to block collect calls, if
1528 ; you ever have problems blocking collect calls using Group B signals (mfcr2_allow_collect_calls=no)
1529 ; then you may want to try with mfcr2_double_answer=yes, this will cause that every answer signal
1530 ; is changed by answer->clear back->answer (sort of a flash)
1531 ; (see also 'mfcr2_allow_collect_calls')
1532 ; mfcr2_double_answer=no
1533
1534 ; This feature allows to skip the use of Group B/II signals and go directly
1535 ; to the accepted state for incoming calls
1536 ; mfcr2_immediate_accept=no
1537
1538 ; You most likely dont need this feature. Default is yes.
1539 ; When this is set to yes, all calls that are offered (incoming calls) which
1540 ; DNIS is valid (exists in extensions.conf) and pass collect call validation
1541 ; will be accepted with a Group B tone (either call with charge or not, depending on mfcr2_charge_calls)
1542 ; with this set to 'no' then the call will NOT be accepted on offered, and the call will start its
1543 ; execution in extensions.conf without being accepted until the channel is answered (either with Answer() or
1544 ; any other application resulting in the channel being answered).
1545 ; This can be set to 'no' if your telco or PBX needs the hangup cause to be set accurately
1546 ; when this option is set to no you must explicitly accept the call with DAHDIAcceptR2Call
1547 ; or implicitly through the Answer() application.
1548 ; mfcr2_accept_on_offer=yes
1549
1550 ; Skip request of calling party category and ANI
1551 ; you need openr2 >= 1.2.0 to use this feature
1552 ; mfcr2_skip_category=no
1553
1554 ; WARNING: advanced users only! I really mean it
1555 ; this parameter is commented by default because
1556 ; YOU DON'T NEED IT UNLESS YOU REALLY GROK MFC/R2
1557 ; READ COMMENTS on doc/r2proto.conf in openr2 package
1558 ; for more info
1559 ; mfcr2_advanced_protocol_file=/path/to/r2proto.conf
1560
1561 ; Brazil use a special signal to force the release of the line (hangup) from the
1562 ; backward perspective. When mfcr2_forced_release=no, the normal clear back signal
1563 ; will be sent on hangup, which is OK for all mfcr2 variants I know of, except for
1564 ; Brazilian variant, where the central will leave the line up for several seconds (30, 60)
1565 ; which sometimes is not what people really want. When mfcr2_forced_release=yes, a different
1566 ; signal will be sent to hangup the call indicating that the line should be released immediately
1567 ; mfcr2_forced_release=no
1568
1569 ; Whether or not report to the other end 'accept call with charge'
1570 ; This setting has no effect with most telecos, usually is safe
1571 ; leave the default (yes), but once in a while when interconnecting with
1572 ; old PBXs this may be useful.
1573 ; Concretely this affects the Group B signal used to accept calls
1574 ; The application DAHDIAcceptR2Call can also be used to decide this
1575 ; in the dial plan in a per-call basis instead of doing it here for all calls
1576 ; mfcr2_charge_calls=yes
1577
1578 ; ---------------- END of options to be used with signalling=mfcr2
1579
1580 ; Configuration Sections
1581 ; ~~~~~~~~~~~~~~~~~~~~~~
1582 ; You can also configure channels in a separate chan_dahdi.conf section. In
1583 ; this case the keyword 'channel' is not used. Instead the keyword
1584 ; 'dahdichan' is used (as in users.conf) - configuration is only processed
1585 ; in a section where the keyword dahdichan is used. It will only be
1586 ; processed in the end of the section. Thus the following section:
1587 ;
1588 ;[phones]
1589 ;echocancel = 64
1590 ;dahdichan = 1-8
1591 ;group = 1
1592 ;
1593 ; Is somewhat equivalent to the following snippet in the section
1594 ; [channels]:
1595 ;
1596 ;echocancel = 64
1597 ;group = 1
1598 ;channel => 1-8
1599 ;
1600 ; When starting a new section almost all of the configuration values are
1601 ; copied from their values at the end of the section [channels] in
1602 ; chan_dahdi.conf and [general] in users.conf - one section's configuration
1603 ; does not affect another one's.
1604 ;
1605 ; Instead of letting common configuration values "slide through" you can
1606 ; use configuration templates to easily keep the common part in one
1607 ; place and override where needed.
1608 ;
1609 ;[phones](!)
1610 ;echocancel = yes
1611 ;group = 0,4
1612 ;callgroup = 3
1613 ;pickupgroup = 3
1614 ;threewaycalling = yes
1615 ;transfer = yes
1616 ;context = phones
1617 ;faxdetect = incoming
1618 ;
1619 ;[phone-1](phones)
1620 ;dahdichan = 1
1621 ;callerid = My Name <501>
1622 ;mailbox = 501@mailboxes
1623 ;
1624 ;
1625 ;[fax](phones)
1626 ;dahdichan = 2
1627 ;faxdetect = no
1628 ;context = fax
1629 ;
1630 ;[phone-3](phones)
1631 ;dahdichan = 3
1632 ;pickupgroup = 3,4