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