VoIP Control/Status Block

The VoIP Control/Status blocks allows TTP control of a number of Dialer Service Codes that can be used for call based functions. It also enables a number of VoIP Call State Commands that allows monitoring and feedback to a control system as well as VoIP Control Status attributes for controlling general VoIP functions.

When a SVC-2 card is used and a Dialer is added and associated with the respective VoIP Control/Status block there are also a number of dialer specific attributes. Please refer to the Dialer section for more information.

Dialer Service Codes

The Tesira SERVER or SERVER IO SVC-2 VoIP card or TesiraFORTÉ VI or TesiraFORTE VT can support two independent phone lines. Each independent line can support up to 6 call appearances. Each call appearance can be a call to a different far end. However, there are limitations on active call appearances that apply to each line independently within an SVC-2 card.

Two active call appearances -The maximum number of active call appearances (i.e. call appearances that are not on hold) per line is two. When two call appearances are active, no other call appearances can be used for any purpose (an active call or a call on hold).
Less than two active call appearances -If there is only one active call appearance (or none), then all of the remaining call appearances can have calls on hold. In this case, the SVC-2 card will allow a call appearance to be put on hold and a different call appearance made active.

If you have 3 calls on hold you can choose any one of those to become an active call, but to conference in a second call appearance you need to disconnect the 3rd call before the conferencing can take place. Similarly, if 2 calls are in conference, any attempt to have a 3rd appearance dial in will result in a busy tone / redirect to voicemail / etc. since the system is already fully engaged. If a user tries to initiate a 3rd call appearance from the Tesira VoIP they will get an audible error tone / warble indicating they cannot complete the action.

Each element of the Service Code instruction is delimited by a single space. The commands are case sensitive and upper and lower case characters are used. The TTP string is structured in the following order:

Instance_Tag Service [Index] [Value] LF

Instance Tag: Is always required. Review the Instance Tag section for more details
Service: Is always required. Review the Service section for more details.
Index: Is shown in [Brackets] as may be required depending on the Service being referenced. The first number is the Line which is 1 or 2 and the Call Appearance Index which is 1,2,3,4,5 or 6.
[Value]: Is shown in [Brackets] as may be required depending on the Command or Service being referenced. If not be required it should not be defined. Would not normally have spaces, if it does it can be defined in "Double Quotes". Can also be a numerical value. Refer to the Value section for more details.
LF: A Line feed or Carriage Return is used to define the end of the command.

Instance Tag	Service	Index	Index	Value
VoIPControlStatus1	dial	1	1	15036417287

Description	Service	Index	Value
Redial	redial	Line,Call Appearance
End	end	Line,Call Appearance
Flash	flash	Line,Call Appearance
Send	send	Line,Call Appearance
Dial (Used when On Hook Only)	dial	Line, Call Appearance	Number to Dial (A String)
DTMF (Used when Off Hook only)	dtmf	Line	One number between 0 - 9, * or #
Answer	answer	Line,Call Appearance
Conference	lconf	Line,Call Appearance
Resume	resume	Line, Call Appearance
Leave Conference	leaveConf	Line, Call Appearance
Specify call appearance	callAppearance	Line, Call Appearance (0 -5)
Resume	resume	Line,Call Appearance
Hold	hold	Line,Call Appearance
Go Off Hook	offHook	Line,Call Appearance
Go On Hook	onHook	Line,Call Appearance
Go On Hook	onHook	Line,Call Appearance
Go On Hook	onHook	Line,Call Appearance
Go On Hook	onHook	Line,Call Appearance
Transfer	transfer	Line,Call Appearance	Refer to the VoIP Transfer Commands section

VoIP Call State Commands

The VoIP Control Status Block supports the use of Call State monitoring in order to poll information about the current call state of the telephone card. The response will include multiple information fields for all lines and call appearances of the card. Call State is also available as a subscribed service to allow unsolicited feedback to a connected control system via TTP. A full call state subscription update will be sent if any single part of the call state has changed.

Please refer to the VoIP Call State commands for more information.

VoIP Control Status Attributes

Please refer to the TTP Overview section for more details on the controlling Tesira devices using the TTP protocol.

Each element of the command instruction is delimited by one or more spaces. The commands are case sensitive and upper and lower case characters are used.

The TTP string to adjust a DSP object attribute is structured in the following order:

Instance_Tag Command Attribute [Index] [Value] LF

Instance Tag: Is always required. Review the Instance Tag section for more details.
Command: Is always required. Review the Command section for more details.
Attribute: Is always required. Review the Attribute section for more details.
[Index]: Is shown in [Brackets] as may be required depending on the Attribute being referenced. If not required it should not be defined. Depending on the Attribute, it can be made up of one or more indexes. Please refer to the Index section for more details.
[Value]: Is shown in [Brackets] as may be required depending on the Command or Attribute being referenced. If not be required it should not be defined. The Value would not normally have spaces, if it does it can be defined in "double quotes". It can also be a numerical value. Please refer to the Value section for more details.
LF: A Line feed or Carriage Return is used to define the end of the command.

Instance Tag	Command	Attribute Code	Index	Index
VoIPControlStatus1	get	lineInUse	1	1

Reason Code	Attribute Code	Command	Indexes	Value Range
Auto Answer	autoAnswer	get / set toggle	line	false, true
Auto Answer Ring Count	autoAnswerRingCount	get / set	line	AA_IMMEDIATELY, AA_ONE_RING, AA_TWO_RINGS, AA_THREE_RINGS
Call State	callState	get subscribe unsubscribe		Refer to the VoIP Call State Commands section
Statistics	cardStat	get subscribe unsubscribe
Simple Caller ID	cid	get subscribe unsubscribe	line (1 or 2), call appearance index (1-6)
Full Caller ID	cidUser	get subscribe unsubscribe	line (1 or 2), call appearance index (1-6)
Codec Priorities	codecPriority	get / set	line
Call Progress Tone Level	cptLevel	get / set increment decrement	line	-100.0 - 0.0 dB
Dialing Timeout	dialingTimeOut	get / set increment decrement	line	0 - 20 seconds
Direct URL Dialing Enabled	directUrlDialing	get/set/toggle	line	false, true
Do Not Disturb Enabled	dndEnable	get / set toggle	line	false, true
Do Not Disturb Response Code	dndMode	get/set	line	DND_480, DND_486, DND_603
DTMF Off Time	dtmfOffTime	get / set increment decrement	line	40 - 1000 ms
DTMF On Time	dtmfOnTime	get / set increment decrement	line	40 - 1000 ms
DTMF via SIP Info	dtmfSipInfo	get / set	line	DTMF_SIP_INFO_OFF, DTMF_SIP_INFO_NORMAL, DTMF_SIP_INFO_SIMPLE
Last Number Dialed	lastNum	get subscribe unsubscribe	line
Line In Use	lineInUse	get subscribe unsubscribe	line (1 or 2), call appearance index (1-6)	false, true
Line Ready	lineReady	get subscribe unsubscribe	line	false, true
DTMF Local Mute	localDtmfMute	get / set toggle	line	false, true
DTMF Local Level	localDtmfToneLevel	get / set increment decrement	line	-100.0 - 0.0 dB
NAT Info	nat	get subscribe unsubscribe
Network Info	network	get subscribe unsubscribe
Out-Of-Band DTMF Enabled	oobDtmf	get / set toggle	line	false, true
Out-Of-Band DTMF Payload Type	oobDtmfPayload	get / set increment decrement	line	97 - 127
Protocol Info	protocols	get subscribe unsubscribe
Redial Enabled	redialEnable	get / set toggle	line	false, true
RFC 2543-Style Hold Enabled	rfc2543StyleHold	get / set toggle	line	false, true
Ringing	ringing	get subscribe unsubscribe	line (1 or 2), call appearance index (1-6)	false, true
Ring Type	ringType	get set	line	RING_TYPE_CLASSIC, RING_TYPE_SILENT
Synchronized Time	syncTime	set		hh:mm:ss:MM:DD:YYYY
VAD Enabled	vad	get / set toggle	line	false, true
VAD Threshold	vadThreshold	get / set increment decrement	line	-64.0 - 24.0 dB

Synchronized Time format is

hh = Hours
mm = minutes
ss = Seconds. Leap seconds (SS=60) specification are forbidden.
MM =month of year 1-12
DD =day of month 1-(28,29,30,31) according to the month and year
YYYY = Year must be >= 2000
Spaces are not permitted after the : and before YYYY so “: 2000” is not valid.

Set Synchronized Time

Instance Tag	Command	Attribute Code	Index
VoIPControlStatus1	set	syncTime	"00:00:00:02:29:2014"

Example

VoIPControlStatus1 set syncTime "00:00:00:02:29:2014"