r2test.conf

Langue: en

Version: 362300 (ubuntu - 24/10/10)

Section: 5 (Format de fichier)

NAME

r2test.conf - OpenR2 r2test program configuration file

SYNOPSIS

/etc/openr2/r2test.conf

DESCRIPTION

This file defines the behavior of the r2test program

This file works pretty much like Asterisk zapata.conf file, the channel parameter will create a R2 context with the specified range of channels and will take all the preceding parameters as configuration.

SYNTAX

No spaces are allowed in parameter definition, lines starting with # or spaces will be ignored

This definition will not be read properly

param = value

This definition will be read fine

param=value

OPTIONS

category=<NATIONAL_SUBSCRIBER, NATIONAL_PRIORITY_SUBSCRIBER, INTERNATIONAL_SUBSCRIBER, INTERNATIONAL_PRIORITY_SUBSCRIBER>
Defines the call category of subscriber. Defaults to NATIONAL_SUBSCRIBER
loglevel=<all,error,warning,debug,notice,cas,mf,stack,nothing>
Defines the log level for debugging purpouses. Defaults to all

error, warning, debug, notice These options are self-descriptive

cas is for logging ABCD CAS tx and rx

mf is for logging of the Multi Frequency tones

stack is for very verbose output of the channel and context call stack, only useful if you are debugging a crash or want to learn how the library works. The stack logging will be only enabled if the openr2 library was compiled with -DOR2_TRACE_STACKS

all is a special value to log all the activity

nothing is a clean-up value, in case you want to not log any activity for a channel or group of channels

You can mix up values, like: loglevel=error,debug,mf to log just error, debug and multi frequency messages

callfile=<yes|no>
Call files useful to debug signaling isssues are dumped in the current directory if this parameter is enabled. Defaults to no
variant=<br,mx,ar,itu>
R2 country variant. Defaults to mx
maxani
How much ANI to expect. Defaults to 10
maxdnis
How much DNIS to expect. Defaults to 4
getanifirst=<yes|no>
Wheter or not we want to request ANI first. Defaults to no
usedahdimf=<yes|no>
Whether to use the built-in openr2 MF tone generation or DAHDI MF tone generation. DAHDI is faster since it does not require to copy user space buffers to the kernel, however this option will only be available when the configure script detects DAHDI support for MF R2 tone generation. Defaults to no
mfthreshold
MF threshold in milliseconds. This is the amount of time a R2 MF signal is required to be ON or OFF after has been detected to be handled. 0 means as soon as we detect a signal we handle it. This aids when a buggy generator or detector causes small false positives. Defaults to 0
mfbacktimeout
MF backward timeout in milliseconds to use openr2 default just specify any negative number or comment this line. Defaults to -1
meteringpulsetimeout
Value in milliseconds for the metering pulse timeout, any negative value means default. Defaults to -1
collectcalls=<yes|no>
Whether to accept collect calls (se also doubleanswer). Defaults to no
doubleanswer=<yes|no>
This option are related but independent of collectcalls. If you have problems to block collect calls using Group B signals (collectcalls), enable this option. Defaults to no
immediateaccept=<yes|no>
Whether to skip Group B/II signals and go directly to the accepted state for an incoming call. Defaults to no
advancedprotocolfile
This option is for advanced users only! Define a file that contains hacks to R2 protocol. This allow advanced users to fine tune the library or make test with specific scenarios to inclide in the library in the future.
playaudio=<yes|no>
This feature allows you to play an alaw audio file for inconming/outgoing calls. Defaults to no
audiofile
If you set playaudio=yes you should provide the path to the audio file
channel
Define range of channels to configure using previous options. The channel range must be specified, unless you will use only one channel. If this option is specified after dnid, cid and caller that options will be used. Defaults to



channel=1-15
channel=17-31

dnid
Defines the destinity number. Only used if .B caller = yes
cid
Defines the caller id number. Only used if .B caller = yes
caller=<yes|no>
Whether or not the group of channels will start a call to the specified dnid. Defaults to yes

FILES

/etc/openr2/r2test.conf
/etc/openr2/r2proto.conf

SEE ALSO

r2test(8)

AUTHOR

This manual page was written by Alexandre Cavalcante Alencar
<alexandre.alencar@gmail.com>

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.