PowerCall for OTF®

OTF, Commetrex’ S.100 middleware, is licensed without media-processing resources. PowerCall for OTF adds S.100-conforming signal generation-detection capability and in-band call-progress analysis to an OTF system. The PowerCall OTF SDK provides the necessary development environment; runtime licenses add a specific number of runtime resources to an OTF system.

The PowerCall for OTF SDK provides an ECTF S.100 Signal Generator-Detector API. It is used with the System Call Router (place call/accept call) and other OTF Services APIs by the telecommunications system developer to produce digital-media telephony applications.

Telephony applications that use the public switched telephone network for outbound calling require the ability to accurately and rapidly interpret the call-progress tones, such as ringback and busy, that are delivered by the network to the calling entity. This call- progress analysis (CPA) is complicated by the lack of the worldwide use of standard tone frequencies and patterns. The design of PowerCall signal-processing software, therefore, must address the tradeoff between speed of analysis and generality. Commetrex’ CPA is designed to minimize support requirements by providing an analysis resource that does not require tuning for over 99% of applications, even for global deployments, while providing fast, accurate responses.

Commetrex’ Signal Generator/Detector (SGD) furnishes all necessary functionality at the physical-layer level to support in-band telephony-signaling functions. Specifically, the SGD implements signal-processing to generate and detect DTMF and Multi-frequency (MF) (R1/R2) digits as well as any generic in-band tone comprised of up to two frequencies. The SGD is compliant with the ITU Q.24 recommendation.

Features

• Universal compatibility
• Detect ringback, busy, reorder, SIT, dialtone, voice answer, and modem answer.
• Detect voice, voice followed by silence then voice.
• Generate/detect DTMF, MF R1 and R2
• Generate/detect general bi-frequency tones
• S.100 application portability Benefits

Benefits

• Worldwide marketing of your product
• Fast, accurate detection
• Low support costs
• Low implementation costs
• Low resource utilization

Overview
OTF is an ECTF S.100 R2-conforming telephony middleware product that supports both third-party and Commetrex-provided media and switching resources. These vendor- specific resources are isolated from the OTF system by Resource Service Managers (RSMs). The resource-specific RSM determines the number of concurrent media- technology resources that have been licensed. The RSM then launches the appropriate Resource Controllers. Licensing the PowerCall SDK adds the CPA and Signal Generator- Detector Resource Controller to an OTF system. The RSM will then vend the licensed runtime resources to the OTF Group Manager, which can then allocate them to client applications.

The signal generation and detection functions of PowerCall may be directly accessed by an application program using the supplied S.100- conforming API. The tone generation and CPA functions are also invoked on behalf of applications that place calls through OTF’s System Call Router (SCR). The SCR API presents a network-access-independent interface to the application. Should the target of a CTscr_MakeCall() command be a network interface that requires DTMF dialing and in- band CPA, these functions will be invoked by the appropriate resource service manager on behalf of the SCR.

DTMF/MF and Precise Tone Generation
The Signal Generator is controlled by one function, CTsg_SendSignals(). The tables that follow show the user-defined parameters for DTMF, MF, and a generic tone generation.

DTMF and MF Parameters

Parm Name	Type	Default	Units	Description
Level 1	INT	-6	dBm	The level of the low frequency component of the DTMF pair. Valid range – 43 to –3.
Level 2	INT	-4	dBm	The level of the high frequency component of the DTMF pair. Valid range – 43 to –3.
LongPause	INT	5000	Msec	The delay associated with the ‘.’ (period) character. Valid range 0-65535.
Off Time	INT	55	Msec	The duration of the silence time between each DTMF digit. Valid range is 0–65535.
On Time	INT	45	Msec	The duration of each DTMF digit. Valid range is 0–65535.
ShortPause	INT	2000	Msec	The delay associated with the ‘,’ (comma) character. Valid range 0-65535.

Generic Tone Parameters

Parameter Name	Type	Default	Units	Description
Level 1	INT	-20	dBm	The level of the first (or only) frequency component. Valid range – 43 to –3.
Level 2	INT	-4	dBm	The level of the second frequency component (if any). Valid range – 43 to –3.
OffTime	INT	0	Msec	The duration of silence between tones on time. Specify 0 for no off-time. Valid range 0-65535.
OnTime	INT	200	Msec	The duration of the tone. Valid range is 1–65535.
FREQ1_Parm_1	INT	N/A	N/A	Parameter 1 of the first (or only) frequency of the generated tone. Must be S.10 fixed point format. This parameter is computed from the desired frequency.
FREQ1_Parm_2	INT	N/A	N/A	Parameter 2 of the first (or only) frequency of the generated tone. Must be S.10 fixed point format. This parameter is computed from the desired frequency.
FREQ2_Parm_1	INT	N/A	N/A	Parameter 1 of the second frequency of the generated tone. Must be S.10 fixed point format. This parameter is computed from the desired frequency.
FREQ2_Parm_2	INT	N/A	N/A	Parameter 2 of the second frequency of the generated tone. Must be S.10 fixed point format. This parameter is computed from the desired frequency.
Iterations	INT	1	Integer	The number of times to repeat the alternating tone and silence period. A count of –1 means repeat forever*. Otherwise the valid range is 1 to 32767.

* Therefore, if the Iterations parameter is set –1 and the Off-time parameter is set to 0, a continuous tone is produced.

DTMF and Precise Tone Detection
Tone detection is controlled by two commands: CTsd_FlushBuffer() and CTsd_RetrieveSignals().

DTMF Tone Parameters

Parm Name	Type	Default	Units	Description
OffQualLevel	INT	-43	dBm	The minimum signal level required to maintain recognition of a DTMF signal once recognition has started. The valid range is –43 to –15.
OffQualTime	INT	40	ms	The minimum duration of absence of a recognized DTMF signal before end-of-digit event will be emitted. The valid range is 5 to 32767.
OnQualLevel	INT	-39	dBm	The minimum signal level recognized as a DTMF signal. The valid range is –43 to –15.
OnQualTime	INT	40	ms	The minimum duration of a recognized DTMF signal before a digit event will be emitted. The valid range is 23 to 32767.
MaxInterrupt	INT	20	ms	The maximum time which a digit may be interrupted before it is deemed ended. Usually range is between 10ms to 50 ms.

General Tone Parameters

Parm Name	Type	Default	Units	Description
OffQualTime	INT	500	ms	The minimum duration of absence of detected tone before a tone-end event will be emitted. The valid range is 0 to 32767.
OnQualLevel	INT	-28	dBm	The minimum signal level that will be detected. The valid range is –40 to 0.
OnQualTime	INT	500	Ms	The minimum duration of a detected tone before a tone event will be emitted. The valid range is 22 to 32767.
FREQ1_Parm_1	INT			Parameter #1 of the first (or only) frequency of the generated tone. This parameter is computed from the desired frequency.
FREQ1_Parm_2	INT			Parameter #2 of the first (or only) frequency of the generated tone. This parameter is computed from the desired frequency.
FREQ1_Parm_3	INT			Parameter #3 of the first (or only) frequency of the generated tone. This parameter is computed from the desired frequency.
FREQ1_Parm_4	INT			Parameter #4 of the first (or only) frequency of the generated tone. This parameter is computed from the desired frequency.
FREQ2_Parm_1	INT			Parameter #1 of the 2nd frequency of the generated tone. This parameter is computed from the desired frequency.
FREQ2_Parm_2	INT			Parameter #2 of the 2nd frequency of the generated tone. This parameter is computed from the desired frequency.
FREQ2_Parm_3	INT			Parameter #3 of the 2nd frequency of the generated tone. This parameter is computed from the desired frequency.
FREQ2_Parm_4	INT			Parameter #4 of the 2nd frequency of the generated tone. This parameter is computed from the desired frequency.
Bandwidth1	INT	70	Hz	The bandwidth of the 1st frequency.
Bandwidth2	INT	70	Hz	The bandwidth of the 2nd frequency.

Tone-generation has a wait-for-dial-tone capability and the following performance specifications:

Frequency resolution	+/-1 Hz
Dynamic level	-33 dBm to 0 dBm (programmable), -9 dBm nominal
DTMF digits	0-9, *, #, and ABCD per ITU-T Q.23 and Q.24
DTMF Rate	10 digits/sec (programmable)
MF digits	0-9, KP, ST, STP, KP2/STP2, and ST3 per US(R1) and ITU-T Q.321 European MFC/R2 forward/reverse tones per ITU-T Q.441
Generic tone type	Single or dual
Duration	10 msec increments
Generic tone freq. Range	200 to 4000 Hz

DTMF Detection

Dynamic Range	-35 to -3 dbm
Minimum tone duration	As specified in Q.24; AT&T: 40 ms
Inter-digit timing	Detects like digits with a 40 ms inter-digit delay. Detects different digits with 0 ms inter-digit delay.
Acceptable Twist	As specified in Q.24; AT&T: +4 dB to –8 dB
Talkoff	No hits on the Mitel or Bellcore test tapes
SNR	10 dB (reference to lowest amplitude tone)
Frequency Tolerance	As specified in Q.24; AT&T: +/-1.5%< BW < +/-3.5%

MF Signaling Detection

Dynamic Range	-35 to -3 dbm
Acceptable Twist	6 dB
Talkoff	TBD
Bandwidth	+/2% Hz

Test Results

The Commetrex DTMF detector uses a windowing algorithm to meet all the frequency-tolerance requirements of Q.24. The following table contains the test results.

Decode Tests(All digits detected)
Frequency Tolerance Tests	Frequency	Pos Deviation	Neg Deviation
	697	2.00%	-2.20%
Low Band	770	2.00%	-2.00%
	852	2.10%	-2.00%
	941	2.00%	-2.30%
	1209	2.50%	-2.70%
High Band	1336	2.50%	-2.70%
	1477	2.70%	-2.80%
	1633	2.80%	-2.90%
Twist Tests	Standard Twist	Reverse Twist
Digit 1	3.9 dB	8.0 dB
Digit 5	4.0 dB	8.4 dB
Digit 9	4.0 dB	8.2 dB
Digit D	4.2 dB	7.9 dB
Dynamic Range Test	Dynamic Range
Digit 1	29 dB
Guard Time Test	Min Pause Time	Min Guard Time
Digit 1	Configurable	29.4 ms
Acceptable Signal to Noise Ratio Test
(-24dBV)	pass
(-18dBV)	pass
(-12dBV)	pass
TALK-OFF Test	zero hits (pass)

Call-Progress Analysis (CPA) Voice Detection

The voice-begin event is the first voice event generated when the answering party begins speaking. Note that the signal must be above the SilenceLevel for VoiceOnTime milliseconds. The voice-end event is reported after an absence of voice for SilenceLong milliseconds. If voice is detected again after an absence of voice for SilenceShort milliseconds, the voice-end-short event is reported. The voice-end-short event is not generated if voice restarted after a silence less than SilenceShort milliseconds.

This capability allows the application to infer whether the called party answered with a "Hello", which is 0.4 seconds, or "Hello, thank you for calling Commetrex", or "Hi, this is Pete and Alice. We’re not here right now…"

CPA Events

Event Name(ID)	Description
CP_BEG	CPA Started
CP_BUSY	Busy tone detected
CP_CED	Modem tone detected
CP_DIALTONE	Dial tone detected
CP_END	Call progress has completed
CP_NOANSWER	No answer (after ringing) detected
CP_RBTONE	Ring back tone detected
CP_ROTONE	Reorder (fast busy) tone detected
CP_SIT	SIT detected
CP_VOICE	Voice detected
CP_VOICE_END_SHORT	Silence longer than SilenceShort has been detected after detection of voice
CP_VOICE_END	Silence longer than SilenceLong has been detected after detection of voice
CP_RBQUIT	Ring back quit

Configuration Information
PowerCall adds signal generation-detection and in-band call-progress analysis to an OTF system, giving the system the capability of placing outbound calls over the PSTN and generating and detecting network and general tones. PowerVox adds terminating voice to an OTF-based system, and PowerFax adds terminating fax. All members of the MSP line of DSP-resource boards are supported, as is the all-IP BladeWare IP media server.

OTF for MSP SDK, PN 20070
OTF PowerCall SDK, PN 20050
OTF PowerVox SDK, PN 20060
OTF PowerFax SDK, PN 20030
PowerCall Runtime License, PN 50005

CPA Parameters

Parameter Name	Default	Units	Description
SilenceLevel	-40	DBm	The average value of the input stream below which the signal is considered to be silence (noise). Valid range is –46 to –34.
SilenceTime	500	Msec	The minimum length if a silence period after voice is detected to qualify VOICE_OFF. Signal Detection circuit responds to loss of carrier within 4 –5 ms, so minimum value for parameter is 5 ms.
SilenceShort	1000	Msec	The time voice must be OFF before sending VOICE_END_SHORT event. This parameter must be greater than SilenceTime. Note that the MSP App must take into account that voice had been off for a duration SilenceTime.
SilenceLong	1500	Msec	The time voice must be OFF before sending VOICE_END event. This parameter must be greater than SilenceShort. Note that the MSP App. must take into account that voice had been off for a duration SilenceTime.
VoiceOnTime	50	Msec	The minimum length of time voice must be detected before call progress reports a voice begin event.
RB_Max	3000	Msec	The maximum duration of a Ring-Back (RB) tone to distinguish it from dial tone. Most RB tones are between 1-2 seconds in duration. The default should be at least 2.5 Sec. The longer it is the longer it takes to qualify dial tone. The shorter it is the more likely it will have to be tuned in the field.
RB_Count	5	Count	The number of RB tones to report “No Answer”
RB_StopPeriod	5000	Msec	The time from the end of the last RB tone before declaring RB stopped, meaning the called terminal is off-hook without voice, CED or SIT. Few RB tone-off times are greater than 4 seconds; CED period is 3.5 sec
BZ_Max	1500	Msec	The maximum period (on time plus off time) to differentiate between slow busy and RB. Busy typically has a period of one second and a 50% duty cycle. A value of 1.5 seconds for this parameter will yield excellent worldwide results
RO_Max	700	Msec	The maximum period (on time plus off time) to differentiate between Slow Busy and Fast Busy (reorder). A default value of 700 – 750 msec. will yield acceptable results.
BZ_Count	4	Count	The number of Busy tones to qualify “Busy” or “Fast Busy”.
TimeOut	10000	Msec	The maximum time that can elapse with no response from the network before call progress stops with a reason of timeout.
StopMask	0x21	Mask	Mask to control which events cause call progress to stop. A value may be formed by Oring any of the following: 0x0001 voice begin 0x0002 voice end short 0x0004 voice end 0x0008 modem tone (CED) 0x0010 SIT tone CPA always terminates if the following are detected: dial tone, busy, and no answer.
PrecMask	3	Mask	Mask to control which precise detector to run. A value may be formed by ORing any of the following: 0x0001 CED tone (modem) 0x0002 SIT