Line Setup

The Line Setup tabs give detailed information about the VoIP network and may be switched between Standard and Advanced views. The default view is Standard, and may be changed by clicking the button shown below:

In Standard view, a user will have the option of configuring a SIP Config tab, Features, Dial Plan, Quality of Service, NAT and Voice Features settings. In advanced view, the user is given additional options under the SIP Config and Features tab.

Make sure to save any changes before navigating away from the tab.

SIP Config View - Standard View

Settings under the SIP Config tab are as follows:

Proxy Vendor and Setup Instructions

Allows the user to choose the entry that matches the phone system the VoIP Phone is integrating with. File names (such as Extension, Display Name, etc.) will change automatically to reflect the naming conventions of the Proxy Vendor selected. See a complete list of vendors, associated naming conventions and links to platform-specific articles here.

Vendor Specific Setup Instructions

Links to Setup Instructions for the designated Proxy Vendor.

SIP User Name

The alphanumeric string that identifies the VoIP extension on the network. It is the number or string to dial to reach this extension.

Authentication User Name (Extension)

The credentials needed to register and authenticate with the VoIP proxy server.

Proxy Address

The network address of the VoIP proxy server.

Proxy Port

The network port the VoIP endpoint should use to communicate with the proxy server. Port 5060 is a standard port used in VoIP systems, but may  be modified as required.

SIP Display Name

The string used for Caller ID name purposes.

Authentication Password

Credentials that must be entered.

Registration Expiration

Determines the interval in which the VoIP line will attempt to re-register with the Proxy. The Proxy may override this setting with a value of its own. If an acknowledgement has not been received from the Proxy within the agreed time, the VoIP card-phone registration information kept in the Proxy's database will be cleared. The default registration expiration period is 3600 seconds.

SIP Domain Name

The SIP domain name to be used if required.

Configuration File

VoIP card attributes can be provisioned using a JSON file delivered via TFTP (Trivial File Transfer Protocol) and the Configuration File button allows users to select and upload a JSON file created offline for specific VoIP configurations. 

In brief, JSON configuration files must contain parameters of a certain type (characters, bools, enumerations, etc.) and limits (within min & max values, where applicable). If an entered value is invalid, it will be replaced by a default (correct) value, based on the default of that parameter. Parameters not defined in an uploaded JSON file will be left as previously-configured.   

Example of a Properly Formatted JSON FileExample of a Properly Formatted JSON File{
    "account":
    {
        "user":"",
        "displayName":"",
        "domain":"",
        "dnsSrv":false,
        "proxies":
        [
            {
                "addr":"",
                "port":5060
            }
        ],
        "vendor":1,
        "auth":
        {
            "user":"",
            "passwd":""
        },
        "transport":1,
        "regInterval":3600,
        "avpfInterval":3,
        "sipsUri":false,
        "avpf":false,
        "reqRegister":true,
        "pubPresenceInfo":false
    },
    "callControl":
    {
        "autoAnswer":
        {
            "enable":false,
            "delay":10
        },
        "redial":true,
        "dnd":false,
        "consultTransfer":false,
        "encryption":
        {
            "mode":1,
            "algorithm":2
        },
        "sessTimer":
        {
            "enable":true,
            "refresher":1,
            "expires":1800,
            "minExpires":90
        },
        "prack":false,
        "dialPlan":
        {
            "dialingTimeOut":3,
            "digitMap":"[2-9]11|0T|011xxx.T|[0-1][2-9]xxxxxxxxx|[2-9]xxxxxxxxx|[2-9]xxxT",
            "normRules":
            [
            ]
        },
        "tone":
        {
            "localDtmfLevel":-6.0,
            "localDtmfMute":false,
            "CPTLevel":-20.0,
            "dtmfType":1
        },
        "ringer":"notes_of_the_optimistic.mkv",
        "codecs":
        [
            {
                "inUse":true,
                "codec":1,
                "conf":
                {
                    "bitRate":510,
                    "useinbandfec":true,
                    "usedtx":false,
                    "cbr":false
                }
            },
            {
                "inUse":true,
                "codec":2,
                "conf":
                {
                    "bitRate":0,
                    "useinbandfec":false,
                    "usedtx":false,
                    "cbr":false
                }
            },
            {
                "inUse":true,
                "codec":3,
                "conf":
                {
                    "bitRate":0,
                    "useinbandfec":false,
                    "usedtx":false,
                    "cbr":false
                }
            },
            {
                "inUse":true,
                "codec":4,
                "conf":
                {
                    "bitRate":0,
                    "useinbandfec":false,
                    "usedtx":false,
                    "cbr":false
                }
            },
            {
                "inUse":true,
                "codec":5,
                "conf":
                {
                    "bitRate":0,
                    "useinbandfec":false,
                    "usedtx":false,
                    "cbr":false
                }
            }
        ],
        "comfortNoise":false
    },
    "nat":
    {
        "keepalive":false,
        "ice":false,
        "turnEnable":false,
        "stunTurnSrv":
        {
            "addr":"",
            "port":5349
        },
        "auth":
        {
            "user":"",
            "passwd":""
        }
    },
    "qos":
    {
        "sipL3":11,
        "rtpL3":19
    },
    "transports":
    {
        "sipUdp":
        {
            "enable":true,
            "port":5060,
            "random":false
        },
        "sipTcp":
        {
            "enable":false,
            "port":5060,
            "random":false
        },
        "sipTls":
        {
            "enable":false,
            "port":5061,
            "random":false
        },
        "rtpUdp":
        {
            "enable":true,
            "port":7078,
            "random":true
        }
    },
    "tls":
    {
        "version":3,
        "cert":
        {
            "tlsCert":"",
            "tlsCertPref":1
        }
    },
    "diag":
    {
        "log":
        {
            "enable":true,
            "level":4
        }
    }
}

To upload a JSON file, click Choose File from the SIP Config page:

In addition to the formatting detailed above, JSON files should be named appropriately by MAC address and the JSON extension. The MAC address must be preceded by 'bsip'.

Example: bsip00905e1bd22c.json

If the file name does not contain the MAC address, the system will search for a general configuration file.

Example: bsip000000000000.json

If neither file/format is found, configuration via TFTP will not occur. 

The current VoIP configuration may be downloaded via the DOWNLOAD button.