Fix some spelling errors, and convert tabs to spaces.
[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> 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 or GR-303 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 ; Some switches (AT&T especially) require network specific facility IE
71 ; supported values are currently 'none', 'sdn', 'megacom', 'tollfreemegacom', 'accunet'
72 ;
73 ; nsf cannot be changed on a reload.
74 ;
75 ;nsf=none
76 ;
77 ; PRI Dialplan: The ISDN-level Type Of Number (TON) or numbering plan, used for
78 ; the dialed number.  For most installations, leaving this as 'unknown' (the
79 ; default) works in the most cases.  In some very unusual circumstances, you
80 ; may need to set this to 'dynamic' or 'redundant'.  Note that if you set one
81 ; of the others, you will be unable to dial another class of numbers.  For
82 ; example, if you set 'national', you will be unable to dial local or
83 ; international numbers.
84 ;
85 ; PRI Local Dialplan:  Only RARELY used for PRI (sets the calling number's 
86 ; numbering plan).  In North America, the typical use is sending the 10 digit
87 ; callerID number and setting the prilocaldialplan to 'national' (the default).
88 ; Only VERY rarely will you need to change this.
89 ;
90 ; Neither pridialplan nor prilocaldialplan can be changed on reload.
91 ;
92 ; unknown:        Unknown
93 ; private:        Private ISDN
94 ; local:          Local ISDN
95 ; national:       National ISDN
96 ; international:  International ISDN
97 ; dynamic:        Dynamically selects the appropriate dialplan
98 ; redundant:      Same as dynamic, except that the underlying number is not 
99 ;                 changed (not common)
100 ;
101 ;pridialplan=unknown
102 ;prilocaldialplan=national
103
104 ; pridialplan may be also set at dialtime, by prefixing the dialled number with
105 ; one of the following letters:
106 ; U - Unknown
107 ; I - International
108 ; N - National
109 ; L - Local (Net Specific)
110 ; S - Subscriber
111 ; V - Abbreviated
112 ; R - Reserved (should probably never be used but is included for completeness)
113 ;
114 ; Additionally, you may also set the following NPI bits (also by prefixing the
115 ; dialled string with one of the following letters):
116 ; u - Unknown
117 ; e - E.163/E.164 (ISDN/telephony)
118 ; x - X.121 (Data)
119 ; f - F.69 (Telex)
120 ; n - National
121 ; p - Private
122 ; r - Reserved (should probably never be used but is included for completeness)
123 ;
124 ; You may also set the prilocaldialplan in the same way, but by prefixing the
125 ; Caller*ID Number, rather than the dialled number.  Please note that telcos
126 ; which require this kind of additional manipulation of the TON/NPI are *rare*.
127 ; Most telco PRIs will work fine simply by setting pridialplan to unknown or
128 ; dynamic.
129 ;
130 ;
131 ; PRI caller ID prefixes based on the given TON/NPI (dialplan)
132 ; This is especially needed for EuroISDN E1-PRIs
133
134 ; None of the prefix settings can be changed on reload.
135 ;
136 ; sample 1 for Germany 
137 ;internationalprefix = 00
138 ;nationalprefix = 0
139 ;localprefix = 0711
140 ;privateprefix = 07115678
141 ;unknownprefix = 
142 ;
143 ; sample 2 for Germany 
144 ;internationalprefix = +
145 ;nationalprefix = +49
146 ;localprefix = +49711
147 ;privateprefix = +497115678
148 ;unknownprefix = 
149 ;
150 ; PRI resetinterval: sets the time in seconds between restart of unused
151 ; B channels; defaults to 'never'.
152 ;
153 ;resetinterval = 3600 
154 ;
155 ; Overlap dialing mode (sending overlap digits)
156 ; Cannot be changed on a reload.
157 ;
158 ;overlapdial=yes
159 ;
160 ; Allow inband audio (progress) when a call is RELEASEd by the far end of a PRI
161 ;
162 ;inbanddisconnect=yes
163 ;
164 ; PRI Out of band indications.
165 ; Enable this to report Busy and Congestion on a PRI using out-of-band
166 ; notification. Inband indication, as used by Asterisk doesn't seem to work
167 ; with all telcos.
168
169 ; outofband:      Signal Busy/Congestion out of band with RELEASE/DISCONNECT
170 ; inband:         Signal Busy/Congestion using in-band tones (default)
171 ;
172 ; priindication cannot be changed on a reload.
173 ;
174 ;priindication = outofband
175 ;
176 ; If you need to override the existing channels selection routine and force all
177 ; PRI channels to be marked as exclusively selected, set this to yes.
178 ;
179 ; priexclusive cannot be changed on a reload.
180 ;
181 ;priexclusive = yes
182 ;
183 ;
184 ; If you need to use the logical channel mapping with your Q.SIG PRI instead
185 ; of the physical mapping you must use the qsigchannelmapping option.
186 ;
187 ; logical:  Use the logical channel mapping
188 ; physical: Use physical channel mapping (default)
189 ;
190 ;qsigchannelmapping=logical
191 ;
192 ; If you wish to ignore remote hold indications (and use MOH that is supplied over
193 ; the B channel) enable this option.
194 ;
195 ;discardremoteholdretrieval=yes
196 ;
197 ; ISDN Timers
198 ; All of the ISDN timers and counters that are used are configurable.  Specify
199 ; the timer name, and its value (in ms for timers).
200 ; K:    Layer 2 max number of outstanding unacknowledged I frames (default 7)
201 ; N200: Layer 2 max number of retransmissions of a frame (default 3)
202 ; T200: Layer 2 max time before retransmission of a frame (default 1000 ms)
203 ; T203: Layer 2 max time without frames being exchanged (default 10000 ms)
204 ; T305: Wait for DISCONNECT acknowledge (default 30000 ms)
205 ; T308: Wait for RELEASE acknowledge (default 4000 ms)
206 ; T309: Maintain active calls on Layer 2 disconnection (default -1, 
207 ;       Asterisk clears calls)
208 ;       EuroISDN: 6000 to 12000 ms, according to (N200 + 1) x T200 + 2s
209 ;       May vary in other ISDN standards (Q.931 1993 : 90000 ms)
210 ; T313: Wait for CONNECT acknowledge, CPE side only (default 3000 ms)
211 ;
212 ;pritimer => t200,1000
213 ;pritimer => t313,4000
214 ;
215 ; To enable transmission of facility-based ISDN supplementary services (such
216 ; as caller name from CPE over facility), enable this option.
217 ; Cannot be changed on a reload.
218 ;
219 ;facilityenable = yes
220 ;
221 ; pritimer cannot be changed on a reload.
222 ;
223 ; Signalling method. The default is "auto". Valid values:
224 ; auto:           Use the current value from DAHDI.
225 ; em:             E & M
226 ; em_e1:          E & M E1
227 ; em_w:           E & M Wink
228 ; featd:          Feature Group D (The fake, Adtran style, DTMF)
229 ; featdmf:        Feature Group D (The real thing, MF (domestic, US))
230 ; featdmf_ta:     Feature Group D (The real thing, MF (domestic, US)) through
231 ;                 a Tandem Access point
232 ; featb:          Feature Group B (MF (domestic, US))
233 ; fgccama:        Feature Group C-CAMA (DP DNIS, MF ANI)
234 ; fgccamamf:      Feature Group C-CAMA MF (MF DNIS, MF ANI)
235 ; fxs_ls:         FXS (Loop Start)
236 ; fxs_gs:         FXS (Ground Start)
237 ; fxs_ks:         FXS (Kewl Start)
238 ; fxo_ls:         FXO (Loop Start)
239 ; fxo_gs:         FXO (Ground Start)
240 ; fxo_ks:         FXO (Kewl Start)
241 ; pri_cpe:        PRI signalling, CPE side
242 ; pri_net:        PRI signalling, Network side
243 ; gr303fxoks_net: GR-303 Signalling, FXO Loopstart, Network side
244 ; gr303fxsks_cpe: GR-303 Signalling, FXS Loopstart, CPE side
245 ; sf:             SF (Inband Tone) Signalling
246 ; sf_w:           SF Wink
247 ; sf_featd:       SF Feature Group D (The fake, Adtran style, DTMF)
248 ; sf_featdmf:     SF Feature Group D (The real thing, MF (domestic, US))
249 ; sf_featb:       SF Feature Group B (MF (domestic, US))
250 ; e911:           E911 (MF) style signalling
251 ; ss7:            Signalling System 7
252 ;
253 ; The following are used for Radio interfaces:
254 ; fxs_rx:         Receive audio/COR on an FXS kewlstart interface (FXO at the
255 ;                 channel bank)
256 ; fxs_tx:         Transmit audio/PTT on an FXS loopstart interface (FXO at the
257 ;                 channel bank)
258 ; fxo_rx:         Receive audio/COR on an FXO loopstart interface (FXS at the
259 ;                 channel bank)
260 ; fxo_tx:         Transmit audio/PTT on an FXO groundstart interface (FXS at
261 ;                 the channel bank)
262 ; em_rx:          Receive audio/COR on an E&M interface (1-way)
263 ; em_tx:          Transmit audio/PTT on an E&M interface (1-way)
264 ; em_txrx:        Receive audio/COR AND Transmit audio/PTT on an E&M interface
265 ;                 (2-way)
266 ; em_rxtx:        Same as em_txrx (for our dyslexic friends)
267 ; sf_rx:          Receive audio/COR on an SF interface (1-way)
268 ; sf_tx:          Transmit audio/PTT on an SF interface (1-way)
269 ; sf_txrx:        Receive audio/COR AND Transmit audio/PTT on an SF interface
270 ;                 (2-way)
271 ; sf_rxtx:        Same as sf_txrx (for our dyslexic friends)
272 ; ss7:            Signalling System 7
273 ;
274 ; signalling of a channel can not be changed on a reload.
275 ;
276 ;signalling=fxo_ls
277 ;
278 ; If you have an outbound signalling format that is different from format
279 ; specified above (but compatible), you can specify outbound signalling format,
280 ; (see below). The 'signalling' format specified will be the inbound signalling
281 ; format. If you only specify 'signalling', then it will be the format for
282 ; both inbound and outbound.
283
284 ; outsignalling can only be one of: 
285 ;   em, em_e1, em_w, sf, sf_w, sf_featd, sf_featdmf, sf_featb, featd,
286 ;   featdmf, featdmf_ta, e911, fgccama, fgccamamf
287
288 ; outsignalling cannot be changed on a reload.
289 ;
290 ;signalling=featdmf
291 ;
292 ;outsignalling=featb
293 ;
294 ; For Feature Group D Tandem access, to set the default CIC and OZZ use these
295 ; parameters (Will not be updated on reload):
296 ;
297 ;defaultozz=0000
298 ;defaultcic=303
299 ;
300 ; A variety of timing parameters can be specified as well
301 ; The default values for those are "-1", which is to use the
302 ; compile-time defaults of the DAHDI kernel modules. The timing
303 ; parameters, (with the standard default from DAHDI):
304 ;
305 ;    prewink:     Pre-wink time (default 50ms)
306 ;    preflash:    Pre-flash time (default 50ms)
307 ;    wink:        Wink time (default 150ms)
308 ;    flash:       Flash time (default 750ms)
309 ;    start:       Start time (default 1500ms)
310 ;    rxwink:      Receiver wink time (default 300ms)
311 ;    rxflash:     Receiver flashtime (default 1250ms)
312 ;    debounce:    Debounce timing (default 600ms)
313 ;
314 ; None of them will update on a reload.
315 ;
316 ; How long generated tones (DTMF and MF) will be played on the channel
317 ; (in milliseconds). 
318 ;
319 ; This is a global, rather than a per-channel setting. It will not be 
320 ; updated on a reload.
321 ;
322 ;toneduration=100
323 ;
324 ; Whether or not to do distinctive ring detection on FXO lines:
325 ;
326 ;usedistinctiveringdetection=yes
327 ;
328 ; enable dring detection after caller ID for those countries like Australia
329 ; where the ring cadence is changed *after* the caller ID spill:
330 ;
331 ;distinctiveringaftercid=yes
332 ;
333 ; Whether or not to use caller ID:
334 ;
335 usecallerid=yes
336 ;
337 ; Hide the name part and leave just the number part of the caller ID
338 ; string. Only applies to PRI channels.
339 ;hidecalleridname=yes
340 ;
341 ; Type of caller ID signalling in use
342 ;     bell     = bell202 as used in US (default)
343 ;     v23      = v23 as used in the UK
344 ;     v23_jp   = v23 as used in Japan
345 ;     dtmf     = DTMF as used in Denmark, Sweden and Netherlands
346 ;     smdi     = Use SMDI for caller ID.  Requires SMDI to be enabled (usesmdi).
347 ;
348 ;cidsignalling=v23
349 ;
350 ; What signals the start of caller ID
351 ;     ring        = a ring signals the start (default)
352 ;     polarity    = polarity reversal signals the start
353 ;     polarity_IN = polarity reversal signals the start, for India, 
354 ;                   for dtmf dialtone detection; using DTMF.
355 ;                   (see doc/India-CID.txt)
356 ;
357 ;cidstart=polarity
358 ;
359 ; Whether or not to hide outgoing caller ID (Override with *67 or *82)
360 ; (If your dialplan doesn't catch it)
361 ;
362 ;hidecallerid=yes
363 ;
364 ; The following option enables receiving MWI on FXO lines.  The default
365 ; value is no.  When this is enabled, and MWI notification indicates on or off,
366 ; the script specified by the mwimonitornotify option is executed.  Also, an
367 ; internal Asterisk MWI event will be generated so that any other part of
368 ; Asterisk that cares about MWI state changes will get notified, just as if
369 ; the state change came from app_voicemail. The energy level that must be seen
370 ; before starting the MWI detection process can be set with 'mwilevel'.
371 ;
372 ;mwimonitor=no
373 ;mwilevel=512
374 ;
375 ; This option is used in conjunction with mwimonitor.  This will get executed
376 ; when incoming MWI state changes.  The script is passed 2 arguments.  The
377 ; first is the corresponding mailbox, and the second is 1 or 0, indicating if
378 ; there are messages waiting or not.
379 ;
380 ;mwimonitornotify=/usr/local/bin/dahdinotify.sh
381 ;
382 ; Whether or not to enable call waiting on internal extensions
383 ; With this set to 'yes', busy extensions will hear the call-waiting
384 ; tone, and can use hook-flash to switch between callers. The Dial()
385 ; app will not return the "BUSY" result for extensions.
386 ;
387 callwaiting=yes
388 ;
389 ; Whether or not restrict outgoing caller ID (will be sent as ANI only, not
390 ; available for the user)
391 ; Mostly use with FXS ports
392 ;
393 ;restrictcid=no
394 ;
395 ; Whether or not use the caller ID presentation for the outgoing call that the
396 ; calling switch is sending.
397 ; See README.callingpres. FIXME: file no longer exists.
398 ;
399 usecallingpres=yes
400 ;
401 ; Some countries (UK) have ring tones with different ring tones (ring-ring),
402 ; which means the caller ID needs to be set later on, and not just after
403 ; the first ring, as per the default (1). 
404 ;
405 ;sendcalleridafter = 2
406 ;
407 ;
408 ; Support caller ID on Call Waiting
409 ;
410 callwaitingcallerid=yes
411 ;
412 ; Support three-way calling
413 ;
414 threewaycalling=yes
415 ;
416 ; For FXS ports (either direct analog or over T1/E1):
417 ;   Support flash-hook call transfer (requires three way calling)
418 ;   Also enables call parking (overrides the 'canpark' parameter)
419 ;
420 ; For digital ports using ISDN PRI protocols:
421 ;   Support switch-side transfer (called 2BCT, RLT or other names)
422 ;   This setting must be enabled on both ports involved, and the
423 ;   'facilityenable' setting must also be enabled to allow sending
424 ;   the transfer to the ISDN switch, since it sent in a FACILITY
425 ;   message.
426 ;
427 transfer=yes
428 ;
429 ; Allow call parking
430 ; ('canpark=no' is overridden by 'transfer=yes')
431 ;
432 canpark=yes
433 ;
434 ; Support call forward variable
435 ;
436 cancallforward=yes
437 ;
438 ; Whether or not to support Call Return (*69, if your dialplan doesn't
439 ; catch this first)
440 ;
441 callreturn=yes
442 ;
443 ; Stutter dialtone support: If a mailbox is specified without a voicemail 
444 ; context, then when voicemail is received in a mailbox in the default 
445 ; voicemail context in voicemail.conf, taking the phone off hook will cause a
446 ; stutter dialtone instead of a normal one. 
447 ;
448 ; If a mailbox is specified *with* a voicemail context, the same will result
449 ; if voicemail received in mailbox in the specified voicemail context.
450 ;
451 ; for default voicemail context, the example below is fine:
452 ;
453 ;mailbox=1234
454 ;
455 ; for any other voicemail context, the following will produce the stutter tone:
456 ;
457 ;mailbox=1234@context 
458 ;
459 ; Enable echo cancellation 
460 ; Use either "yes", "no", or a power of two from 32 to 256 if you wish to
461 ; actually set the number of taps of cancellation.
462 ;
463 ; Note that when setting the number of taps, the number 256 does not translate
464 ; to 256 ms of echo cancellation.  echocancel=256 means 256 / 8 = 32 ms.
465 ;
466 ; Note that if any of your DAHDI cards have hardware echo cancellers,
467 ; then this setting only turns them on and off; numeric settings will
468 ; be treated as "yes". There are no special settings required for
469 ; hardware echo cancellers; when present and enabled in their kernel
470 ; modules, they take precedence over the software echo canceller compiled
471 ; into DAHDI automatically.
472 ;
473 ;
474 echocancel=yes
475 ;
476 ; Some DAHDI echo cancellers (software and hardware) support adjustable
477 ; parameters; these parameters can be supplied as additional options to
478 ; the 'echocancel' setting. Note that Asterisk does not attempt to
479 ; validate the parameters or their values, so if you supply an invalid
480 ; parameter you will not know the specific reason it failed without
481 ; checking the kernel message log for the error(s) put there by DAHDI.
482 ;
483 ;echocancel=128,param1=32,param2=0,param3=14
484 ;
485 ; Generally, it is not necessary (and in fact undesirable) to echo cancel when
486 ; the circuit path is entirely TDM.  You may, however, change this behavior
487 ; by enabling the echo canceller during pure TDM bridging below.
488 ;
489 echocancelwhenbridged=yes
490 ;
491 ; In some cases, the echo canceller doesn't train quickly enough and there
492 ; is echo at the beginning of the call.  Enabling echo training will cause
493 ; DAHDI to briefly mute the channel, send an impulse, and use the impulse
494 ; response to pre-train the echo canceller so it can start out with a much
495 ; closer idea of the actual echo.  Value may be "yes", "no", or a number of
496 ; milliseconds to delay before training (default = 400)
497 ;
498 ; WARNING:  In some cases this option can make echo worse!  If you are
499 ; trying to debug an echo problem, it is worth checking to see if your echo
500 ; is better with the option set to yes or no.  Use whatever setting gives
501 ; the best results.
502 ;
503 ; Note that these parameters do not apply to hardware echo cancellers.
504 ;
505 ;echotraining=yes
506 ;echotraining=800
507 ;
508 ; If you are having trouble with DTMF detection, you can relax the DTMF
509 ; detection parameters.  Relaxing them may make the DTMF detector more likely
510 ; to have "talkoff" where DTMF is detected when it shouldn't be.
511 ;
512 ;relaxdtmf=yes
513 ;
514 ; You may also set the default receive and transmit gains (in dB)
515 ;
516 ; Gain Settings: increasing / decreasing the volume level on a channel.
517 ;                The values are in db (decibells). A positive number
518 ;                increases the volume level on a channel, and a
519 ;                negavive value decreases volume level.
520 ;
521 ;                There are several independent gain settings:
522 ;   rxgain: gain for the rx (receive - into Asterisk) channel. Default: 0.0
523 ;   txgain: gain for the tx (transmit - out of Asterisk Asterisk) channel. 
524 ;           Default: 0.0
525 ;   cid_rxgain: set the gain just for the caller ID sounds Asterisk
526 ;               emits. Default: 5.0 .
527
528 ;rxgain=2.0
529 ;txgain=3.0
530 ;
531 ; Logical groups can be assigned to allow outgoing roll-over.  Groups range
532 ; from 0 to 63, and multiple groups can be specified. By default the
533 ; channel is not a member of any group.
534 ;
535 ; Note that an explicit empty value for 'group' is invalid, and will not
536 ; override a previous non-empty one. The same applies to callgroup and
537 ; pickupgroup as well.
538 ;
539 group=1
540 ;
541 ; Ring groups (a.k.a. call groups) and pickup groups.  If a phone is ringing
542 ; and it is a member of a group which is one of your pickup groups, then
543 ; you can answer it by picking up and dialing *8#.  For simple offices, just
544 ; make these both the same.  Groups range from 0 to 63.
545 ;
546 callgroup=1
547 pickupgroup=1
548
549 ; Channel variable to be set for all calls from this channel
550 ;setvar=CHANNEL=42
551 ;setvar=ATTENDED_TRANSFER_COMPLETE_SOUND=beep   ; This channel variable will
552                                                 ; cause the given audio file to
553                                                 ; be played upon completion of
554                                                 ; an attended transfer.
555
556 ;
557 ; Specify whether the channel should be answered immediately or if the simple
558 ; switch should provide dialtone, read digits, etc.
559 ; Note: If immediate=yes the dialplan execution will always start at extension
560 ; 's' priority 1 regardless of the dialed number!
561 ;
562 ;immediate=yes
563 ;
564 ; Specify whether flash-hook transfers to 'busy' channels should complete or
565 ; return to the caller performing the transfer (default is yes).
566 ;
567 ;transfertobusy=no
568 ;
569 ; caller ID can be set to "asreceived" or a specific number if you want to
570 ; override it.  Note that "asreceived" only applies to trunk interfaces.
571 ; fullname sets just the 
572 ;
573 ; fullname: sets just the name part.
574 ; cid_number: sets just the number part: 
575 ;
576 ;callerid = 123456
577 ;
578 ;callerid = My Name <2564286000>
579 ; Which can also be written as:
580 ;cid_number = 2564286000
581 ;fullname = My Name
582 ;
583 ;callerid = asreceived
584 ;
585 ; should we use the caller ID from incoming call on DAHDI transfer?
586 ;
587 ;useincomingcalleridondahditransfer = yes
588 ;
589 ; AMA flags affects the recording of Call Detail Records.  If specified
590 ; it may be 'default', 'omit', 'billing', or 'documentation'.
591 ;
592 ;amaflags=default
593 ;
594 ; Channels may be associated with an account code to ease
595 ; billing
596 ;
597 ;accountcode=lss0101
598 ;
599 ; ADSI (Analog Display Services Interface) can be enabled on a per-channel
600 ; basis if you have (or may have) ADSI compatible CPE equipment
601 ;
602 ;adsi=yes
603 ;
604 ; SMDI (Simplified Message Desk Interface) can be enabled on a per-channel
605 ; basis if you would like that channel to behave like an SMDI message desk.
606 ; The SMDI port specified should have already been defined in smdi.conf.  The
607 ; default port is /dev/ttyS0.
608 ;
609 ;usesmdi=yes
610 ;smdiport=/dev/ttyS0
611 ;
612 ; On trunk interfaces (FXS) and E&M interfaces (E&M, Wink, Feature Group D
613 ; etc, it can be useful to perform busy detection either in an effort to 
614 ; detect hangup or for detecting busies.  This enables listening for
615 ; the beep-beep busy pattern.
616 ;
617 ;busydetect=yes
618 ;
619 ; If busydetect is enabled, it is also possible to specify how many busy tones
620 ; to wait for before hanging up.  The default is 3, but it might be
621 ; safer to set to 6 or even 8.  Mind that the higher the number, the more
622 ; time that will be needed to hangup a channel, but lowers the probability
623 ; that you will get random hangups.
624 ;
625 ;busycount=6
626 ;
627 ; If busydetect is enabled, it is also possible to specify the cadence of your
628 ; busy signal.  In many countries, it is 500msec on, 500msec off.  Without
629 ; busypattern specified, we'll accept any regular sound-silence pattern that
630 ; repeats <busycount> times as a busy signal.  If you specify busypattern,
631 ; then we'll further check the length of the sound (tone) and silence, which
632 ; will further reduce the chance of a false positive.
633 ;
634 ;busypattern=500,500
635 ;
636 ; NOTE: In make menuselect, you'll find further options to tweak the busy
637 ; detector.  If your country has a busy tone with the same length tone and
638 ; silence (as many countries do), consider enabling the
639 ; BUSYDETECT_COMPARE_TONE_AND_SILENCE option.
640 ;
641 ; To further detect which hangup tone your telco provider is sending, it is
642 ; useful to use the ztmonitor utility to record the audio that main/dsp.c
643 ; is receiving after the caller hangs up.
644 ;
645 ; Use a polarity reversal to mark when a outgoing call is answered by the
646 ; remote party.
647 ;
648 ;answeronpolarityswitch=yes
649 ;
650 ; In some countries, a polarity reversal is used to signal the disconnect of a
651 ; phone line.  If the hanguponpolarityswitch option is selected, the call will
652 ; be considered "hung up" on a polarity reversal.
653 ;
654 ;hanguponpolarityswitch=yes
655 ;
656 ; polarityonanswerdelay: minimal time period (ms) between the answer 
657 ;                        polarity switch and hangup polarity switch. 
658 ;                        (default: 600ms)
659 ;
660 ; On trunk interfaces (FXS) it can be useful to attempt to follow the progress
661 ; of a call through RINGING, BUSY, and ANSWERING.   If turned on, call
662 ; progress attempts to determine answer, busy, and ringing on phone lines.
663 ; This feature is HIGHLY EXPERIMENTAL and can easily detect false answers,
664 ; so don't count on it being very accurate.
665 ;
666 ; Few zones are supported at the time of this writing, but may be selected
667 ; with "progzone".
668 ;
669 ; progzone also affects the pattern used for buzydetect (unless
670 ; busypattern is set explicitly). The possible values are: 
671 ;   us (default)
672 ;   ca (alias for 'us')
673 ;   cr (Costa Rica)
674 ;   br (Brazil, alias for 'cr')
675 ;   uk
676 ;
677 ; This feature can also easily detect false hangups. The symptoms of this is
678 ; being disconnected in the middle of a call for no reason.
679 ;
680 ;callprogress=yes
681 ;progzone=uk
682 ;
683 ; Set the tonezone. Equivalent of the defaultzone settings in
684 ; /etc/dahdi.conf . This sets the tone zone by number.
685 ; Note that you'd still need to load tonezones (loadzone in dahdi.conf).
686 ; The default is -1: not to set anything.
687 ;tonezone = 0 ; 0 is US
688 ;
689 ; FXO (FXS signalled) devices must have a timeout to determine if there was a
690 ; hangup before the line was answered.  This value can be tweaked to shorten
691 ; how long it takes before DAHDI considers a non-ringing line to have hungup.
692 ;
693 ; ringtimeout will not update on a reload.
694 ;
695 ;ringtimeout=8000
696 ;
697 ; For FXO (FXS signalled) devices, whether to use pulse dial instead of DTMF
698 ; Pulse digits from phones (FXS devices, FXO signalling) are always
699 ; detected.
700 ;
701 ;pulsedial=yes
702 ;
703 ; For fax detection, uncomment one of the following lines.  The default is *OFF*
704 ;
705 ;faxdetect=both
706 ;faxdetect=incoming
707 ;faxdetect=outgoing
708 ;faxdetect=no
709 ;
710 ; This option specifies a preference for which music on hold class this channel
711 ; should listen to when put on hold if the music class has not been set on the
712 ; channel with Set(CHANNEL(musicclass)=whatever) in the dialplan, and the peer
713 ; channel putting this one on hold did not suggest a music class.
714 ;
715 ; If this option is set to "passthrough", then the hold message will always be
716 ; passed through as signalling instead of generating hold music locally. This
717 ; setting is only valid when used on a channel that uses digital signalling.
718 ;
719 ; This option may be set globally or on a per-channel basis.
720 ;
721 ;mohinterpret=default
722 ;
723 ; This option specifies which music on hold class to suggest to the peer channel
724 ; when this channel places the peer on hold.  This option may be set globally,
725 ; or on a per-channel basis.
726 ;
727 ;mohsuggest=default
728 ;
729 ; PRI channels can have an idle extension and a minunused number.  So long as
730 ; at least "minunused" channels are idle, chan_dahdi will try to call "idledial"
731 ; on them, and then dump them into the PBX in the "idleext" extension (which
732 ; is of the form exten@context).  When channels are needed the "idle" calls
733 ; are disconnected (so long as there are at least "minidle" calls still
734 ; running, of course) to make more channels available.  The primary use of
735 ; this is to create a dynamic service, where idle channels are bundled through
736 ; multilink PPP, thus more efficiently utilizing combined voice/data services
737 ; than conventional fixed mappings/muxings.
738 ;
739 ; Those settings cannot be changed on reload.
740 ;
741 ;idledial=6999
742 ;idleext=6999@dialout
743 ;minunused=2
744 ;minidle=1
745 ;
746 ; Configure jitter buffers in DAHDI (each one is 20ms, default is 4)
747 ; This is set globally, rather than per-channel.
748 ;
749 ;jitterbuffers=4
750 ;
751 ;------------------------------ JITTER BUFFER CONFIGURATION --------------------------
752 ; jbenable = yes              ; Enables the use of a jitterbuffer on the receiving side of a
753                               ; DAHDI channel. Defaults to "no". An enabled jitterbuffer will
754                               ; be used only if the sending side can create and the receiving
755                               ; side can not accept jitter. The DAHDI channel can't accept jitter,
756                               ; thus an enabled jitterbuffer on the receive DAHDI side will always
757                               ; be used if the sending side can create jitter.
758
759 ; jbmaxsize = 200             ; Max length of the jitterbuffer in milliseconds.
760
761 ; jbresyncthreshold = 1000    ; Jump in the frame timestamps over which the jitterbuffer is
762                               ; resynchronized. Useful to improve the quality of the voice, with
763                               ; big jumps in/broken timestamps, usually sent from exotic devices
764                               ; and programs. Defaults to 1000.
765
766 ; jbimpl = fixed              ; Jitterbuffer implementation, used on the receiving side of a DAHDI
767                               ; channel. Two implementations are currently available - "fixed"
768                               ; (with size always equals to jbmax-size) and "adaptive" (with
769                               ; variable size, actually the new jb of IAX2). Defaults to fixed.
770
771 ; jblog = no                  ; Enables jitterbuffer frame logging. Defaults to "no".
772 ;-----------------------------------------------------------------------------------
773 ;
774 ; You can define your own custom ring cadences here.  You can define up to 8
775 ; pairs.  If the silence is negative, it indicates where the caller ID spill is
776 ; to be placed.  Also, if you define any custom cadences, the default cadences
777 ; will be turned off.
778 ;
779 ; This setting is global, rather than per-channel. It will not update on
780 ; a reload.
781 ;
782 ; Syntax is:  cadence=ring,silence[,ring,silence[...]]
783 ;
784 ; These are the default cadences:
785 ;
786 ;cadence=125,125,2000,-4000
787 ;cadence=250,250,500,1000,250,250,500,-4000
788 ;cadence=125,125,125,125,125,-4000
789 ;cadence=1000,500,2500,-5000
790 ;
791 ; Each channel consists of the channel number or range.  It inherits the
792 ; parameters that were specified above its declaration.
793 ;
794 ; For GR-303, CRV's are created like channels except they must start with the
795 ; trunk group followed by a colon, e.g.: 
796 ;
797 ; crv => 1:1
798 ; crv => 2:1-2,5-8
799 ;
800 ;
801 ;callerid="Green Phone"<(256) 428-6121>
802 ;channel => 1
803 ;callerid="Black Phone"<(256) 428-6122>
804 ;channel => 2
805 ;callerid="CallerID Phone" <(630) 372-1564>
806 ;channel => 3
807 ;callerid="Pac Tel Phone" <(256) 428-6124>
808 ;channel => 4
809 ;callerid="Uniden Dead" <(256) 428-6125>
810 ;channel => 5
811 ;callerid="Cortelco 2500" <(256) 428-6126>
812 ;channel => 6
813 ;callerid="Main TA 750" <(256) 428-6127>
814 ;channel => 44
815 ;
816 ; For example, maybe we have some other channels which start out in a
817 ; different context and use E & M signalling instead.
818 ;
819 ;context=remote
820 ;signaling=em
821 ;channel => 15
822 ;channel => 16
823
824 ;signalling=em_w
825 ;
826 ; All those in group 0 I'll use for outgoing calls
827 ;
828 ; Strip most significant digit (9) before sending
829 ;
830 ;stripmsd=1
831 ;callerid=asreceived
832 ;group=0
833 ;signalling=fxs_ls
834 ;channel => 45
835
836 ;signalling=fxo_ls
837 ;group=1
838 ;callerid="Joe Schmoe" <(256) 428-6131>
839 ;channel => 25
840 ;callerid="Megan May" <(256) 428-6132>
841 ;channel => 26
842 ;callerid="Suzy Queue" <(256) 428-6233>
843 ;channel => 27
844 ;callerid="Larry Moe" <(256) 428-6234>
845 ;channel => 28
846 ;
847 ; Sample PRI (CPE) config:  Specify the switchtype, the signalling as either
848 ; pri_cpe or pri_net for CPE or Network termination, and generally you will
849 ; want to create a single "group" for all channels of the PRI.
850 ;
851 ; switchtype cannot be changed on a reload.
852 ;
853 ; switchtype = national
854 ; signalling = pri_cpe
855 ; group = 2
856 ; channel => 1-23
857
858 ;
859
860 ;  Used for distinctive ring support for x100p.
861 ;  You can see the dringX patterns is to set any one of the dringXcontext fields
862 ;  and they will be printed on the console when an inbound call comes in.
863 ;
864 ;  dringXrange is used to change the acceptable ranges for "tone offsets".  Defaults to 10.
865 ;  Note: a range of 0 is NOT what you might expect - it instead forces it to the default.
866 ;  A range of -1 will force it to always match.
867 ;  Anything lower than -1 would presumably cause it to never match.
868 ;
869 ;dring1=95,0,0 
870 ;dring1context=internal1 
871 ;dring1range=10
872 ;dring2=325,95,0 
873 ;dring2context=internal2 
874 ;dring2range=10
875 ; If no pattern is matched here is where we go.
876 ;context=default
877 ;channel => 1 
878
879 ; ---------------- Options for use with signalling=ss7 -----------------
880 ; None of them can be changed by a reload.
881 ;
882 ; Variant of SS7 signalling:
883 ; Options are itu and ansi
884 ;ss7type = itu
885
886 ; SS7 Called Nature of Address Indicator
887 ;
888 ; unknown:        Unknown
889 ; subscriber:     Subscriber
890 ; national:       National
891 ; international:  International
892 ; dynamic:        Dynamically selects the appropriate dialplan
893 ;
894 ;ss7_called_nai=dynamic
895 ;
896 ; SS7 Calling Nature of Address Indicator
897 ;
898 ; unknown:        Unknown
899 ; subscriber:     Subscriber
900 ; national:       National
901 ; international:  International
902 ; dynamic:        Dynamically selects the appropriate dialplan
903 ;
904 ;ss7_calling_nai=dynamic
905 ;
906
907 ; sample 1 for Germany 
908 ;ss7_internationalprefix = 00
909 ;ss7_nationalprefix = 0
910 ;ss7_subscriberprefix = 
911 ;ss7_unknownprefix = 
912 ;
913
914 ; This option is used to disable automatic sending of ACM when the call is started
915 ; in the dialplan.  If you do use this option, you will need to use the Proceeding()
916 ; application in the dialplan to send ACM.
917 ;ss7_explictacm=yes
918
919 ; All settings apply to linkset 1
920 ;linkset = 1
921
922 ; Point code of the linkset.  For ITU, this is the decimal number
923 ; format of the point code.  For ANSI, this can either be in decimal
924 ; number format or in the xxx-xxx-xxx format
925 ;pointcode = 1
926
927 ; Point code of node adjacent to this signalling link (Possibly the STP between you and
928 ; your destination).  Point code format follows the same rules as above.
929 ;adjpointcode = 2
930
931 ; Default point code that you would like to assign to outgoing messages (in case of
932 ; routing through STPs, or using A links).  Point code format follows the same rules
933 ; as above.
934 ;defaultdpc = 3
935
936 ; Begin CIC (Circuit indication codes) count with this number
937 ;cicbeginswith = 1
938
939 ; What the MTP3 network indicator bits should be set to.  Choices are
940 ; national, national_spare, international, international_spare
941 ;networkindicator=international
942
943 ; First signalling channel
944 ;sigchan = 48
945
946 ; Additional signalling channel for this linkset (So you can have a linkset
947 ; with two signalling links in it).  It seems like a silly way to do it, but
948 ; for linksets with multiple signalling links, you add an additional sigchan
949 ; line for every additional signalling link on the linkset.
950 ;sigchan = 96
951
952 ; Channels to associate with CICs on this linkset
953 ;channel = 25-47
954 ;
955 ; For more information on setting up SS7, see the README file in libss7 or
956 ; the doc/ss7.txt file in the Asterisk source tree.
957 ; ----------------- SS7 Options ----------------------------------------
958
959 ; Configuration Sections
960 ; ~~~~~~~~~~~~~~~~~~~~~~
961 ; You can also configure channels in a separate dahdi.conf section. In
962 ; this case the keyword 'channel' is not used. Instead the keyword
963 ; 'dahdichan' is used (as in users.conf) - configuration is only processed
964 ; in a section where the keyword dahdichan is used. It will only be
965 ; processed in the end of the section. Thus the following section:
966 ;
967 ;[phones]
968 ;echocancel = 64
969 ;dahdichan = 1-8
970 ;group = 1
971 ;
972 ; Is somewhat equivalent to the following snippet in the section
973 ; [channels]:
974 ;
975 ;echocancel = 64
976 ;group = 1
977 ;channel => 1-8
978 ;
979 ; When starting a new section almost all of the configuration values are
980 ; copied from their values at the end of the section [channels] in
981 ; dahdi.conf and [general] in users.conf - one section's configuration
982 ; does not affect another one's.
983 ;
984 ; Instead of letting common configuration values "slide through" you can 
985 ; use configuration templates to easily keep the common part in one
986 ; place and override where needed.
987 ;
988 ;[phones](!)
989 ;echocancel = yes
990 ;group = 0,4
991 ;callgroup = 3
992 ;pickupgroup = 3
993 ;threewaycalling = yes
994 ;transfer = yes
995 ;context = phones
996 ;faxdetect = incoming
997 ;
998 ;[phone-1](phones)
999 ;dahdichan = 1
1000 ;callerid = My Name <501>
1001 ;mailbox = 501@mailboxes
1002 ;
1003 ;
1004 ;[fax](phones)
1005 ;dahdichan = 2
1006 ;faxdetect = no
1007 ;context = fax
1008 ;
1009 ;[phone-3](phones)
1010 ;dahdichan = 3
1011 ;pickupgroup = 3,4