SIP Device Engines

SIP Device Engines enable AlarmPoint to send notifications to and receive responses from service providers using the Session Initiation Protocol (SIP). Be aware that each SIP account should have its own SIP Device Engine (i.e., each SIP account User Name must be unique to its SIP Device Engine).

Note: AlarmPoint deployments that will experience high volumes of SIP traffic must have SIP Device Engines configured on dedicated AlarmPoint Notification Server Node computers (i.e., the AlarmPoint Notification Server Node must reside on a computer that is separate from other AlarmPoint components such as web servers, application servers, and the database).

This protocol allows AlarmPoint to make voice calls through a company PBX or SIP Gateway using Voice Over IP (VOIP) rather than lines from the telephone company.

SIP routing for multiple-Company deployments

In multiple-Company deployments, incoming SIP calls are routed based on the value of the incoming call’s “Caller ID”. (In single-Company deployments, all incoming SIP requests are routed to the default callin script.) The deployment PBX must be configured to create or overwrite the Caller ID value and populate it with the Company Name. This value is parsed by the SIP Device Engine to identify the caller’s associated Company, and pass the incoming call to the correct callin script. If the Device Engine receives a Caller ID that does not match an existing Company Name, the Device Engine invokes the default error script, which plays a recording indicating that the call could not be routed.

For outbound SIP calls, the default scripts automatically populate the Caller ID field of the outbound call with the name of the Company associated with the Event, and use the Company’s call-in number, as specified on the Company details page.

Note: For general information about SIP Caller ID, see the SIP FAQ at http://www.egyed.com/faq/sip_faq.html#callerid.
SIP Device Engine details

Detail

Description

Name

Name used to identify this Device Engine.

Description

Brief description of this Device Engine (optional).

Notification Polling (sec)

How often (in seconds) the Device Engine polls the notification node for new alerts. Must be a whole number greater than or equal to 10 and less than or equal to 300.

Logging

For an explanation of Device Engine logging, see SIP Device Engines.

Number of Line Appearances

Total lines available for outgoing and incoming SIP calls. The number of lines available for outgoing calls is the total number of line appearances less those reserved for incoming calls.

Reserved for Incoming Calls

The number of lines reserved for incoming SIP calls.

Default Play/Date Format

Default format to use when playing current time and date to Users as specified by the language file using the index file for phrases. The following tokens are supported: yyyy, yy, MM, DD, HH, mm, and ss; by default, the value is:

mm/dd hh:nn.

TTS Engine Personality

Personality or voice to use when playing Text-To-Speech (TTS). This setting can also be changed in the AlarmPoint script.

TTS engines typically provide several different voices, like a male and female, but may also provide different languages. This requires that one or more TTS Engines are installed; SAPI is installed by default.

ASR Engine Personality

Personality or voice to use when playing Automatic Speech Recognition (ASR) methods. The default setting is Microsoft English Recognizer V5.1.

Default Initial Language

Determines the regional language settings to use when playing a language.

Call-in Silence Threshold

The threshold to use to determine silence on the line. Larger values are less sensitive to static. Valid values are from 0 to 65535; the default value is 256.

Codec List

The codec list supported by the Device Engine. Select one of the following options:

Ulaw: standard telephone codec for North American calls.

Alaw: standard telephone codec for European calls.

Call-in Script

Name of the script used to handle the communication for incoming calls.

Inbound SIP Registration List

This area displays an editable list of inbound SIP registrations available to the SIP Device Engine. Click Add New Inbound SIP Registration to create a new registration, and specify the settings as described in the table "Inbound SIP Registration settings", below.

To remove a registration, select the check box next to the registrations you want to remove, and then click Remove Selected Inbound SIP Registrations.

The following table describes the Inbound SIP Registration Settings:

Inbound SIP Registration Settings

Detail

Description

SIP Server Address

IP address of the SIP server with which AlarmPoint will register.

SIP Server Port

Port to use on the SIP server.

SIP Local Port

Local port to which the Device Engine will bind and which the SIP Server will use to communicate with AlarmPoint.

SIP Local Address

IP address that the Device Engine will bind to and listen for SIP calls.

SIP Domain

Domain used by the SIP server; this domain name will be included in the SIP messages.

SIP Outbound Proxy Address

If required, the IP address of the outbound proxy server.

SIP Outbound Proxy Port

If required, the port of the outbound proxy server.

RTP Port (min)

The lower limit to the port number on which RTP is allowed.

RTP Port (max)

The upper limit to the port number on which RTP is allowed.

DTMF Payload ID

The default value is 101, though some SIP Server environments may require a different value. Contact your SIP Server Administrator for more information. Note that the AlarmPoint SIP Device Engine supports only RFC2833 for DTMF tones.

Registration Attempts

How many times the Device Engine should attempt to register with the SIP server.

Registration Timeout

How long, in seconds, the Device Engine should wait before timing out on a registration attempt. The default is 60.

Session Timeout

How long, in seconds, the Device Engine should wait to timeout a SIP session. The default is 3600.

User Name

The user name to use on the SIP server.

Password

The password, if required, for the user name on the SIP server.

Display Name

Name displayed as source of call.

The AlarmPoint SIP Device Engine supports only RFC2833 for DTMF tones.