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.

1. Verbose Level
   
2. Protocol Capture
3. Country Code
4. Operator code
5. Signalling
6. Connection Type
7. Number of Incoming Digits
8. Dialplan (TON)
   
9. Numbering Plan
10. Service Type
11. Prefix
12. Default TEI
13. Local Number (MSN)
14. Timers
15. Incoming Calls Behaviour
16. Outgoing Calls Behaviour
17. General Calls Behaviour
18. 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 - Type of Number (TON)

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

default: unknown
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
default value: unknown

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:

To reset the local numbers, use:
local_number = none
or
local_number = reset

NOTE: You can define local_number up to 8 times to handle multiple MSN's. 

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=0

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:

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 forwarded to the "s" extension in Asterisk and incoming out of band digits are forwarded as DTMF digits to Asterisk.

    Note: Do not forget to put a WaitExten in your dialplan so that asterisk can wait a certain amount of time to collect all the digits before processing the number.
    e.g (waiting 5 seconds)
    [A500_context]
    exten => s, 1, WaitExten(5)
    exten => s, 2, Answer()
    exten => s, 3, .......keep on with your diaplan

CALLED_NB_ABSENT_MATCH (default = disabled)
    Incoming calls without a called numbed number specified will not be rejected with "Invalid Number", but instead get forwarded to the "s" extension in 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=0
              
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=0

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