Bri Advanced Options
Sangoma BRI Daemon advanced options
Your Sangoma BRI Daemon configuration file is located in /etc/wanpipe/smg_bri.conf . This file can also be generated using the wancfg_smg utility if no advanced options are required. The verbose level and protocol capture options are global. All the other parameters are configurable per span.
- Verbose Level : Set verbosity level of SMG BRI Daemon log file in /var/log/sangoma_mgd.log
- Protocol Capture : Enables / Disables BRI protocol stack debugging log file in /var/log/sangoma_bri.log
- Country Code : To set local country code
- Operator code
- Signalling
- Connection Type: Point to Point / Point to Multipoint
- Number of Incoming Call Digits: Minimum number of digits for called number on incoming calls
- Dialplan
- Numbering Plan
- Service Type
- Prefix
- Default TEI
- Local Number (MSN)
- Timers
- Incoming Calls Behaviour
- Outgoing Calls Behaviour
- General Calls Behaviour
- D-channel Log
Verbose Level
descr: Sets the verbosity level of the SMG BRI Daemon log file in /var/log/sangoma_mgd.log
parameter: verbose
possible values:1-10
recommended option: 2 (for production environment)
7 (for testing environment)
example:
verbose=2
Protocol Capture
descr: Enables or disables BRI protocol stack debugging log file in /var/log/sangoma_bri.log
parameter: prot_capture
possible values: yes/no
recommended option: no (for production environment)
yes (for testing environment)
example:
prot_capture=yes
The remaining options are configurable per span.
Country code
descr: Set this to your local country
parameter: country
possible values: australia, austria, belgium, canada, chile, denmark, europe, finland,
france, germany, hong_kong, india, irlande, israel, italy, japan, korea, luxembourg,
netherlands, new_zealand, norway, portugal, singapore, south_africa, spain,
sweden, switzerland, taiwan, uk, usa, ussr
recommended option: europe
example:
country=europe
Operator code
descr: Contact your telco for this parameter. Currently, only ETSI mode is supported.
parameter: operator
possible values: etsi
recommended option: etsi
example:
operator=etsi
Signalling
descr: Specifies the BRI function
parameter: signalling
possible values: bri_te, bri_nt Note: bri_te is sometimes called bri_cpe, and bri_nt is sometimes called bri_net
default option: bri_te
example:
signalling=bri_te
Connection type
descr: This should match the parameter configured by your telco, or remote switch
parameter: connection_type
possible values: point_to_point, point_to_multipoint
default option: point_to_multipoint
example:
connection_type=point_to_multipoint
Number of incoming digits
descr: Minimum number of digits for called number on an incoming call. Incoming calls with called number less than this value will be rejected with cause: Invalid number format.
parameter: num_digits
possible values: 1-16
recommended option: 8
example:
num_digits=8
Dialplan
descr: Some switches require the "type of number" network specific facility IE to be set.
parameter: dialplan
possible values: unknown, national, international, network_specific, subscriber, abbreviated
example: dialplan=national
NumberingPlan
* requires wanpipe-3.3.2.p11 or later
descr: Some switches require the "number plan" network specific facility IE to be set.
parameter: numberingplan
possible values:
unknown
isdn ;ISDN/telephony numbering plan (CCITT E.164/E.163)
telephone ;telephony - not in CEPT
data ;data numbering plan (CCITT X.121)
telex ;telex numbering plan (CCITT F.69)
national ;national standard numbering plan
private ;private numbering plan
reserved ;reserved numbering plan
example:
numberingplan=isdn
ServiceType
* requires wanpipe-3.3.2.p11 or later
descr: The service type.
parameter: servicetype
possible values:
voice ;voice
voice-cgi ;voice on GCI service
audio-7 ;7Khz audio service
data ;data service
data-56k ;data at 56kbs service
data-trans ;transparent data service
modem ;modem data service
fax ;G3 facsimile service
fax-4 ;G4 facsimile service
v110 ;v.110 service
v120 ;v.120 service
video ;video service
example:
servicetype=modem
Prefix
descr: Prepend incoming Caller ID Number based on the "type of number" network specific facility IE.
parameter: unknown_prefix, national_prefix, international_prefix, networkspf_prefix, subscriber_prefix, abbreviated_prefix
possible values: <any phone number>
example:
national_prefix=01
international_prefix=011
unknown_prefix=00
Default TEI
descr: When configured in point to point mode, a default TEI value can be assigned per span.
parameter: default_tei
possible values: 1-127 Note: default_tei=127 means the TEI value will be negotiated between the NT and TE side.
recommended option: 0 for TE, 127 for NT
Note: by default, the TEI is set to 0
when connection type is set to point to point and 127 when the connection type i set to point to multipoint
example:
default_tei=0
Local Number (MSN)
descr: Call filtering number. On incoming calls, any number that does not match the local_number string will not be answered. This feature is used for Multiple Subscriber Numbering. An incoming call will be answered if the shortest string between the received called number and the programmed called number matches.
parameter: local_number
possible values: <any phone number>
example:
local_number=123456789
Examples:
| Received Called Number |
Local Called Number |
Call answered |
| 123456 |
456
|
YES
|
| 456 |
123456
|
YES
|
| 123456 |
123456
|
YES
|
| <none> |
456 |
NO
|
| <none> |
<none> |
YES
|
| 123456 |
<none>
|
YES |
| 123456 |
4567 |
NO |
To reset the local numbers, use:
local_number = none
or
local_number = reset
Timers
descr: Setting non-default values for the Timers
T3: Time-out after an activation request is sent.
default: timer_t3 = 8000
example: timer_t3=10000
This will set the T3 timer to 10 seconds
T302: Used in overlap receive mode, amount of time to wait for incoming digits.
default: timer_t302 = 15000
example: timer_t302 = 30000
This will set the T302 timer to 30 seconds
Incoming calls behaviour
descr: Some telcos might require some parameters to be enabled for incoming calls.
Multiple parameters can be enabled per span.
parameter: in_calls_behaviour
default: (bri_te): DATA_CONN_RS
(bri_nt): DATA_ALERT_RQ, SEND_CALL_PROC_RQ
To reset: in_calls_behaviour=default
example:
To enable "transparent overlap receive" on bri_te mode, enable the default in_calls_behaviour, then enable "transparent overlap receive"
in_calls_behaviour=VOICE_ALERT_RQ
List of options for in_calls_behaviour:
SEND_VOICE_ALERT_RQ (default = enabled)
A call alert message is sent on incoming voice calls.
DATA_ALERT_RQ (default = enabled for NT, disabled for TE)
A call alert message is sent on incoming data calls.
SEND_CALL_PROC_RQ (default = enabled for NT mode, disabled for TE mode)
A call proceeding message will be sent before the call alert message is sent. The call proceeding message is optional, but some switches require it.
TRUNCATE_NB (default = disabled)
When using overlap receive mode (usually used then ISDN BRI phones are connected to a bri_nt port), the called number will be truncated to the number of digits specified in num_digits.
CALL_WAITING (default = disabled)
Enables support for "Call-Waiting Supplementary Service". If disabled, all calls received with channel-id = No-channel will be rejected.
TRANSPARENT_OVERLAP_RCV (default = disabled)
Only used in overlap receiving mode. On incoming calls, the call is forwared to the "s" extension in Asterisk and incoming out of band digits are forwarded as DTMF digits to Asterisk.
Outgoing calls behaviour
descr: Some telcos might require some parameters to be enabled for outgoing calls.
Multiple parameters can be enabled per span.
parameter: out_calls_behaviour
default: USER_SENDING_COMPLETE
To reset: out_calls_behaviour=default
example:
See incoming calls behaviour
List of options for out_calls_behaviour:
USER_SENDING COMPLETE (default = enabled)
The sending-complete information element is send when requesting an outgoingcall.
SEND_CONN_CO_ON_PROGRESS (default = disabled)
The call will be answered when after a call progress message is received. Otherwise, the call is answered when a Connect message is received.
SEND_DIGIT_CO_ON_PROGRESS (default = disabled)
When this is enabled, a call progress message will be sent when a call proceeding message is received. Otherwise, BRI stack will wait for a Setup ACK message.
REJECT_IF_NO_FREE_CHAN (default = disabled)
Outgoing calls will be rejected locally if no b-channels are available. Otherwise, outgoing calls will still be requested, and the remote side is expected to reject the call.
STORE_CHAN_ID_IN_SETUP (default = disabled)
The channel-id is always specified in an outgoing call setup message, even if it is not required (i.e optional only).
ACCEPT_IA5_NB (default = disabled)
If enabled, outgoing calls with calling number, and called number containing IA5 characters will not be rejected. Otherwise, only extended digits are allowed (0-9, *, #)
General calls behaviour
descr: Some telcos might require some parameters to be enabled for general call behaviours.
Multiple parameters can be enabled per span.
parameter: gen_calls_behaviour
default: CC_UUI_RECOGNITION
To reset: gen_calls_behaviour=default
CHAN_ALLOC_LOWEST
allocates the b-channels by starting with the lowest available B-channel.
CHAN_ALLOC_HIGHEST
allocates the b-channels by starting with the highest available B-channel.
D-channel Log
descr: Logs the traces for each frame received on the d-channel. This can take up a lot of system resources and should only be enabled upon request by Sangoma.
parameter: dchan_log
possible values: yes/no
default: no
example: dchan_log=yes
| 
