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 advance view, the user is given additional options under these tabs:

SIP Config View - Standard View

Proxy Vendor

Allows the user to choose the Proxy Vendor that matches the VoIP phone system. Field names (such as Generic, Avays SM, Avaya IPO, Cisco, Mitel, 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

Click Vendor Specific Setup Instructions link to access a VoIP configuration article.

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

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 that the VoIP endpoint uses to communicate with the proxy server. Port 5060 is the standard port used for VoIP systems, but may be modified as required:

SIP Display Name

The string used for Caller ID name.

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 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.

Save Changes

When making changes the user must Save Changes in order for them to take affect:

Navigating away from a page without saving will generate the following alert:

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
        }
    }
}

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.