codecs.conf.sample: update codec opus docs
[asterisk/asterisk.git] / configs / samples / misdn.conf.sample
1 ;
2 ; chan_misdn sample config
3 ;
4
5 ; general section:
6 ;
7 ; for debugging and general setup, things that are not bound to port groups
8 ;
9
10 [general]
11 ;
12 ; Sets the Path to the misdn-init.conf (for nt_ptp mode checking)
13 ;
14 misdn_init=/etc/misdn-init.conf
15
16 ; set debugging flag:
17 ;   0 - No Debug
18 ;   1 - mISDN Messages and * - Messages, and * - State changes
19 ;   2 - Messages + Message specific Informations (e.g. bearer capability)
20 ;   3 - very Verbose, the above + lots of Driver specific infos
21 ;   4 - even more Verbose than 3
22 ;
23 ; default value: 0
24 ;
25 debug=0
26
27
28
29 ; set debugging file and flags for mISDNuser (NT-Stack)
30 ;
31 ; flags can be or'ed with the following values:
32 ;
33 ; DBGM_NET        0x00000001
34 ; DBGM_MSG        0x00000002
35 ; DBGM_FSM        0x00000004
36 ; DBGM_TEI        0x00000010
37 ; DBGM_L2         0x00000020
38 ; DBGM_L3         0x00000040
39 ; DBGM_L3DATA     0x00000080
40 ; DBGM_BC         0x00000100
41 ; DBGM_TONE       0x00000200
42 ; DBGM_BCDATA     0x00000400
43 ; DBGM_MAN        0x00001000
44 ; DBGM_APPL       0x00002000
45 ; DBGM_ISDN       0x00004000
46 ; DBGM_SOCK       0x00010000
47 ; DBGM_CONN       0x00020000
48 ; DBGM_CDATA      0x00040000
49 ; DBGM_DDATA      0x00080000
50 ; DBGM_SOUND      0x00100000
51 ; DBGM_SDATA      0x00200000
52 ; DBGM_TOPLEVEL   0x40000000
53 ; DBGM_ALL        0xffffffff
54 ;
55
56 ntdebugflags=0
57 ntdebugfile=/var/log/misdn-nt.log
58
59
60 ; some pbx systems do cut the L1 for some milliseconds, to avoid
61 ; dropping running calls, we can set this flag to yes and tell
62 ; mISDNuser not to drop the calls on L2_RELEASE
63 ntkeepcalls=no
64
65 ; the big trace
66 ;
67 ; default value: [not set]
68 ;
69 ;tracefile=/var/log/asterisk/misdn.log
70
71
72 ; set to yes if you want mISDN_dsp to bridge the calls in HW
73 ;
74 ; default value: yes
75 ;
76 bridging=no
77
78
79 ; stops dialtone after getting first digit on nt Port
80 ;
81 ; default value: yes
82 ;
83 stop_tone_after_first_digit=yes
84
85 ; whether to append overlapdialed Digits to Extension or not
86 ;
87 ; default value: yes
88 ;
89 append_digits2exten=yes
90
91 ;;; CRYPTION STUFF
92
93 ; Whether to look for dynamic crypting attempt
94 ;
95 ; default value: no
96 ;
97 dynamic_crypt=no
98
99 ; crypt_prefix, what is used for crypting Protocol
100 ;
101 ; default value: [not set]
102 ;
103 crypt_prefix=**
104
105 ; Keys for cryption, you reference them in the dialplan
106 ; later also in dynamic encr.
107 ;
108 ; default value: [not set]
109 ;
110 crypt_keys=test,muh
111
112 ; ----------------------------- JITTER BUFFER CONFIGURATION --------------------------
113 ; jbenable = yes              ; Enables the use of a jitterbuffer on the receiving side of a
114                               ; SIP channel. Defaults to "no". An enabled jitterbuffer will
115                               ; be used only if the sending side can create and the receiving
116                               ; side can not accept jitter. The SIP channel can accept jitter,
117                               ; thus a jitterbuffer on the receive SIP side will be used only
118                               ; if it is forced and enabled.
119
120 ; jbforce = no                ; Forces the use of a jitterbuffer on the receive side of a SIP
121                               ; channel. Defaults to "no".
122
123 ; jbmaxsize = 200             ; Max length of the jitterbuffer in milliseconds.
124
125 ; jbresyncthreshold = 1000    ; Jump in the frame timestamps over which the jitterbuffer is
126                               ; resynchronized. Useful to improve the quality of the voice, with
127                               ; big jumps in/broken timestamps, usually sent from exotic devices
128                               ; and programs. Defaults to 1000.
129
130 ; jbimpl = fixed              ; Jitterbuffer implementation, used on the receiving side of a SIP
131                               ; channel. Two implementations are currently available - "fixed"
132                               ; (with size always equals to jbmaxsize) and "adaptive" (with
133                               ; variable size, actually the new jb of IAX2). Defaults to fixed.
134
135 ; jbtargetextra = 40          ; This option only affects the jb when 'jbimpl = adaptive' is set.
136                               ; The option represents the number of milliseconds by which the new
137                               ; jitter buffer will pad its size. the default is 40, so without
138                               ; modification, the new jitter buffer will set its size to the jitter
139                               ; value plus 40 milliseconds. increasing this value may help if your
140                               ; network normally has low jitter, but occasionally has spikes.
141
142 ; jblog = no                  ; Enables jitterbuffer frame logging. Defaults to "no".
143 ; ----------------------------------------------------------------------------------
144
145 ; users sections:
146 ;
147 ; name your sections as you wish but not "general" or "default" !
148 ; the sections are Groups, you can dial out in extensions.conf
149 ; with Dial(mISDN/g:extern/101) where extern is a section name,
150 ; chan_misdn tries every port in this section to find a
151 ; new free channel
152 ;
153 ; The default section is not a group section, it just contains config elements
154 ; which are inherited by group sections.
155 ;
156 [default]
157
158 ; define your default context here
159 ;
160 ; default value: default
161 ;
162 context=misdn
163
164 ; language
165 ;
166 ; default value: en
167 ;
168 language=en
169
170 ;
171 ; This option specifies a default music on hold class to
172 ; use when put on hold if the channel's moh class was not
173 ; explicitly set with Set(CHANNEL(musicclass)=whatever) and
174 ; the peer channel did not suggest a class to use.
175 ;
176 musicclass=default
177
178 ;
179 ; Either if we should produce DTMF Tones ourselves
180 ;
181 senddtmf=yes
182
183 ;
184 ; If we should generate Ringing for chan_sip and others
185 ;
186 far_alerting=no
187
188
189 ;
190 ; Here you can list which bearer capabilities should be allowed:
191 ;   all                  - allow any bearer capability
192 ;   speech               - allow speech
193 ;   3_1khz               - allow 3.1KHz audio
194 ;   digital_unrestricted - allow unrestricted digital
195 ;   digital_restricted   - allow restricted digital
196 ;   video                - allow video
197 ;
198 ; Example:
199 ; allowed_bearers=speech,3_1khz
200 ;
201 allowed_bearers=all
202
203 ; Incoming number prefixes for the indicated Type-Of-Number.  These are
204 ; inserted before any number (caller, dialed, connected, redirecting,
205 ; redirection) received from the ISDN link if that number has the
206 ; corresponding Type-Of-Number.
207 ; See the dialplan options.
208 ;
209 ; default values:
210 ;    unknownprefix=
211 ;    internationalprefix=00
212 ;    nationalprefix=0
213 ;    netspecificprefix=
214 ;    subscriberprefix=
215 ;    abbreviatedprefix=
216 ;
217 ;unknownprefix=
218 internationalprefix=00
219 nationalprefix=0
220 ;netspecificprefix=
221 ;subscriberprefix=
222 ;abbreviatedprefix=
223
224 ; set rx/tx gains between -8 and 8 to change the RX/TX Gain
225 ;
226 ; default values: rxgain: 0
227 ;                 txgain: 0
228 ;
229 rxgain=0
230 txgain=0
231
232 ; some telcos especially in NL seem to need this set to yes, also in
233 ; switzerland this seems to be important
234 ;
235 ; default value: no
236 ;
237 te_choose_channel=no
238
239
240
241 ;
242 ; Monitors L1 of the port.  If L1 is down it tries
243 ; to bring it up.  The polling timeout is given in seconds.
244 ; Setting the value to 0 disables monitoring L1 of the port.
245 ;
246 ; default value: 0
247 ;
248 ; This option is only read at chan_misdn loading time.
249 ; You need to unload and load chan_misdn to change the
250 ; value.  An asterisk restart will also do the trick.
251 ;
252 l1watcher_timeout=0
253
254 ;
255 ; This option defines, if chan_misdn should check the L1 on  a PMP
256 ; before making a group call on it. The L1 may go down for PMP Ports
257 ; so we might need this.
258 ; But be aware! a broken or plugged off cable might be used for a group call
259 ; as well, since chan_misdn has no chance to distinguish if the L1 is down
260 ; because of a lost Link or because the Provider shut it down...
261 ;
262 ; default: no
263 ;
264 pmp_l1_check=no
265
266
267 ;
268 ; in PMP this option defines which cause should be sent out to
269 ; the 3. caller. chan_misdn does not support callwaiting on TE
270 ; PMP side. This allows to modify the RELEASE_COMPLETE cause
271 ; at least.
272 ;
273 reject_cause=16
274
275
276 ;
277 ; Send Setup_Acknowledge on incoming calls anyway (instead of PROCEEDING),
278 ; this requests additional Infos, so we can waitfordigits
279 ; without much issues. This works only for PTP Ports
280 ;
281 ; default value: no
282 ;
283 need_more_infos=no
284
285
286 ;
287 ; set this to yes if you want to disconnect calls when a timeout occurs
288 ; for example during the overlapdial phase
289 ;
290 nttimeout=no
291
292 ; Set the method to use for channel selection:
293 ;   standard     - Use the first free channel starting from the lowest number.
294 ;   standard_dec - Use the first free channel starting from the highest number.
295 ;   round_robin  - Use the round robin algorithm to select a channel. Use this
296 ;                  if you want to balance your load.
297 ;
298 ; default value: standard
299 ;
300 method=standard
301
302
303 ; specify if chan_misdn should collect digits before going into the
304 ; dialplan, you can choose yes=4 Seconds, no, or specify the amount
305 ; of seconds you need;
306 ;
307 overlapdial=yes
308
309 ;
310 ; dialplan means Type Of Number in ISDN Terms
311 ; There are different types of the dialplan:
312 ;
313 ; dialplan -> for outgoing call's dialed number
314 ; localdialplan -> for outgoing call's callerid
315 ;       (if -1 is set use the value from the asterisk channel)
316 ; cpndialplan -> for incoming call's connected party number sent to caller
317 ;       (if -1 is set use the value from the asterisk channel)
318 ;
319 ; dialplan options:
320 ;
321 ; 0 - unknown
322 ; 1 - International
323 ; 2 - National
324 ; 3 - Network-Specific
325 ; 4 - Subscriber
326 ; 5 - Abbreviated
327 ;
328 ; default value: 0
329 ;
330 dialplan=0
331 localdialplan=0
332 cpndialplan=0
333
334
335
336 ;
337 ; turn this to no if you don't mind correct handling of Progress Indicators
338 ;
339 early_bconnect=yes
340
341
342 ;
343 ; turn this on if you like to send Tone Indications to a Incoming
344 ; isdn channel on a TE Port. Rarely used, only if the Telco allows
345 ; you to send indications by yourself, normally the Telco sends the
346 ; indications to the remote party.
347 ;
348 ; default: no
349 ;
350 incoming_early_audio=no
351
352 ; uncomment the following to get into s extension at extension conf
353 ; there you can use DigitTimeout if you can't or don't want to use
354 ; isdn overlap dial.
355 ; note: This will jump into the s exten for every exten!
356 ;
357 ; default value: no
358 ;
359 ;always_immediate=no
360
361 ;
362 ; set this to yes if you want to generate your own dialtone
363 ; with always_immediate=yes, else chan_misdn generates the dialtone
364 ;
365 ; default value: no
366 ;
367 nodialtone=no
368
369
370 ; uncomment the following if you want callers which called exactly the
371 ; base number (so no extension is set) jump to the s extension.
372 ; if the user dials something more it jumps to the correct extension
373 ; instead
374 ;
375 ; default value: no
376 ;
377 ;immediate=no
378
379 ; uncomment the following to have hold and retrieve support
380 ;
381 ; default value: no
382 ;
383 ;hold_allowed=yes
384
385 ; Pickup and Callgroup
386 ;
387 ; default values: not set = 0
388 ; range: 0-63
389 ;
390 ;callgroup=1
391 ;pickupgroup=1
392
393 ; Named pickup groups and named call groups
394 ;
395 ; give a name to groups and configure any number of groups
396 ;
397 ;namedcallgroup=engineering,sales,netgroup,protgroup
398 ;namedpickupgroup=sales
399
400 ; Set the outgoing caller id to the value.
401 ;callerid="name" <number>
402
403 ;
404 ; these are the exact isdn screening and presentation indicators
405 ; if -1 is given for either value the presentation indicators are used
406 ; from asterisks CALLERPRES function.
407 ; s=0, p=0 -> callerid presented
408 ; s=1, p=1 -> callerid restricted (the remote end does not see it!)
409 ;
410 ; default values s=-1, p=-1
411 presentation=-1
412 screen=-1
413
414 ; Incoming calls will have a caller ID tag set to this value
415 ;
416 ;incoming_cid_tag = "asterisk"
417
418 ; With this set, you can automatically append the MSN of a party
419 ; to the cid_tag. Incoming calls have the dialed number appended
420 ; to the tag, and outgoing calls have the caller number appended
421 ; to the tag. An '_' is used to separate the tag from the
422 ; MSN.
423 ; Default is no.
424 ;
425 ;append_msn_to_cid_tag = no
426
427 ; Select what to do with outgoing COLP information on this port.
428 ;
429 ; 0 - Send out COLP information unaltered. (default)
430 ; 1 - Force COLP to restricted on all outgoing COLP information.
431 ; 2 - Do not send COLP information.
432 outgoing_colp=0
433
434 ; Put a display ie in the CONNECT message containing the following
435 ; information if it is available (nt port only):
436 ;
437 ; 0 - Do not put the connected line information in the display ie.
438 ; 1 - Put the available connected line name in the display ie.
439 ; 2 - Put the available connected line number in the display ie.
440 ; 3 - Put the available connected line name and number in the display ie.
441 ;
442 display_connected=0
443
444 ; Put a display ie in the SETUP message containing the following
445 ; information if it is available (nt port only):
446 ;
447 ; 0 - Do not put the caller information in the display ie.
448 ; 1 - Put the available caller name in the display ie.
449 ; 2 - Put the available caller number in the display ie.
450 ; 3 - Put the available caller name and number in the display ie.
451 ;
452 display_setup=0
453
454 ; This enables echo cancellation with the given number of taps.
455 ; Be aware: Move this setting only to outgoing portgroups!
456 ; A value of zero turns echo cancellation off.
457 ;
458 ; possible values are: 0,32,64,128,256,yes(=128),no(=0)
459 ;
460 ; default value: no
461 ;
462 ;echocancel=no
463
464 ;
465 ; chan_misdns jitterbuffer, default 4000
466 ;
467 jitterbuffer=4000
468
469 ;
470 ; change this threshold to enable dejitter functionality
471 ;
472 jitterbuffer_upper_threshold=0
473
474
475 ;
476 ; change this to yes, if you want to bridge a mISDN data channel to
477 ; another channel type or to an application.
478 ;
479 hdlc=no
480
481
482 ;
483 ; defines the maximum amount of incoming calls per port for
484 ; this group. Calls which exceed the maximum will be marked with
485 ; the channel variable MAX_OVERFLOW. It will contain the amount of
486 ; overflowed calls
487 ;
488 max_incoming=-1
489
490 ;
491 ; defines the maximum amount of outgoing calls per port for this group
492 ; exceeding calls will be rejected
493 ;
494 max_outgoing=-1
495
496 ;
497 ; Enable/disable the call-completion retention option support (ptp only).
498 ;
499 ; Note: To use the CCBS/CCNR supplementary service feature and other
500 ; supplementary services using FACILITY messages requires a
501 ; modified version of mISDN from:
502 ; http://svn.digium.com/svn/thirdparty/mISDN/trunk
503 ; http://svn.digium.com/svn/thirdparty/mISDNuser/trunk
504 ;
505 cc_request_retention=yes
506
507 [intern]
508 ; define your ports, e.g. 1,2 (depends on mISDN-driver loading order)
509 ports=1,2
510 ; context where to go to when incoming Call on one of the above ports
511 context=Intern
512
513 [internPP]
514 ;
515 ; adding the postfix 'ptp' to a port number is obsolete now, chan_misdn
516 ; parses /etc/misdn-init.conf and sets the ptp mode to the corresponding
517 ; configs. For backwards compatibility you can still set ptp here.
518 ;
519 ports=3
520
521 [first_extern]
522 ; again port defs
523 ports=4
524 ; again a context for incoming calls
525 context=Extern1
526 ; msns for te ports, listen on those numbers on the above ports, and
527 ; indicate the incoming calls to asterisk
528 ; here you can give a comma separated list or simply an '*' for
529 ; any msn.
530 msns=*
531
532 ; here an example with given msns
533 [second_extern]
534 ports=5
535 context=Extern2
536 callerid="Asterisk" <1234>
537 msns=102,144,101,104