Introduction

CPTAnalyzer

CPTAnalyzer is a utility which allows the user to capture call progress tones, simulate and run the Call Progress Tone Detector module, analyze the detection results and generate new cadences for undefined tones. This utility will run under Windows NT 4.0 operating system.

Call Progress Tones are tones that are created by the Telephony Switches or Central Offices to give users of phone systems a feedback of the progress of their call. Such signals are dialtone, linebusy, reorder ringback, etc.

The Analyzer can make an outbound call, simulate CPTD action for a specific country and then analyze the tones. It will be initialized by that specific country's parameters prior to performing any functions. Those parameters are read from a configuration (COFF) file, which includes cadence parameters for about 30 countries in the world.

The configuration (COFF) file has the following parameters for each country:

•	Cadence parameters

•	Digital filters coefficients

•	Timing Values

•	Non-Repeating Tones parameters

•	Special Information Tone (SIT) data

The sequence of events that will happen when CPTAnalyzer is running:

•	Make an outbound call.

•	Record tone.

•	Disconnect the call.

•	Detection of call progress tone.

•	Analyze the results of the detection.

•	Modify the CPTD parameters if necessary.

Repeat the above steps until all tones have been processed.


Overview of Features

The CPTAnalyzer Utility can perform the following functions:

•	List of Countries

•	Choice of Switch

•	Tones to Capture

•	Temporary File

•	Run/Stop the Utility

•	Call Status

•	CPTD Status

•	Recording Status

•	DSP Status

•	Accumulated Detection Report

•	Temporary File in Use

•	Detection Results

•	View Cadence Parameters


List of Countries

0	CPTAnalyzer enables users to select a country from a list of countries to simulate that country. When a country is selected, its parameters are read from an input COFF file and initialize the utility.

1	To select a country, choose a name from the "Country Name" box in the main form. You will need to select a country before performing anything with this utility such as viewing Cadences or Running.


Choice of Switch

There is a difference between making an outbound call in an M1 system and a non-M1 system.  Therefore, there is a need to choose the type of switch being used.

For M1(AML) systems:

Put a check mark next to "M1(AML) Switch" checkbox.  Since Dial Tone cannot be captured in M1(AML) systems, the Dial Tone checkbox under the "Tone to Analyze" box has been disabled.

For non-M1(AML) systems:

Make sure the checkbox to "M1(AML) Switch" is clear/unchecked.


Tones of Capture

Tones to Analyze

There are 4 types of tone that can be analyzed using this tool; they are dialtone, linebusy, reorder and ringback.

Since Dial tone cannot be obtained from M1(AML) switch, the Dial Tone checkbox under the "Tone to Analyze" box will be disabled if M1(AML) switch is chosen.

0	More than 1 type of tone can be captured and analyzed in 1 run.  To specify the type of tone to analyze, simply put a check mark next to the tones to analyze and the corresponding phone numbers to call to obtain the tone.

1	Note that to analyze dial tone on non-M1(AML) switch, phone number is not required.


Temporary File

The box for entering the full path and the temporary file name used for storing the recorded tone will only appear if CPTAnalyzer cannot access the default path which is d:\ as displayed in the box when it first shows up.  The default temporary file name is cpt_tmp.wav; this file will be deleted once analysis on the recorded tone is completed.

When this box appears, the drive name and the temporary file name can be changed.


Run the Analyzer, Running; Run; Stop the Analyzer; Stop;

How to Run/Stop the Utility

To Run the analyzer, just click the "RUN" button on the GUI.

0	The Run button will be enabled only when all necessary information to run the analyzer are entered, they are country type, switch type and type of tones to analyze.

1	The name of the file that is being used for analysis and its path will be indicated in the Temporary File In Use window.

The sequence of events that will happen when CPTAnalyzer is running:

•	Make an outbound call.

•	Record tone.

•	Disconnect the call.

•	Detection of call progress tone.

•	Analyze the results of the detection.

•	Generate new cadences if necessary.

•	Add new cadences to flash_cp.out and flash_cp.ini files if necessary.

•	Repeat all the steps above until all tones have been processed.

When the utility running, the "RUN" button will be disabled and it can not be pressed until recording has been completed.

When recording is finished, this button will be changed to a Stop button and will be enabled.  It is safe to stop the process anytime when the Stop button is enabled.

After "STOP" button was pressed, CPTAnalyzer will stop running and terminates whatever it is currently doing immediately.

The process status panel will show the status of the call.  "Running" will be displayed for Call Status if the CPTAnalyzer is running and ready to make a call.   Please refer to Call Status for other possible status.

The Analyzer can only be rerun when the "Run" button is enabled and all statuses indicate complete, idle or successful.


Call Status

The status of the outbound call made will be indicated in the "Process Status" box with "Call Status".  "Successful" will be displayed if the outbound call has been successfully made.

Other possible statuses are:

•	Idle - CPTAnalyzer is not making an outbound call or disconnecting a call.

•	Failed - the call has failed.

•	Successful - the outbound call has been made without any problem.

•	Running - the CPTAnalyzer is currently running and is preparing to make an outbound call.

•	Calling - making an outbound call.

•	Disconnecting - disconnecting call; at this stage, stopping or exiting the application is prohibited.

•	Disconnected - call has been successfully dropped.


CPTD Status

The status of the call progress tone detection, analysis and modification of the configuration file will be indicated in the "Process Status" box  "CPTD Status".  "Completed" will be displayed for CPTD Status if the detection, analysis and modification have been successfully done.

Other possible statuses are:

•	Idle - CPTAnalyzer is not analyzing/detecting any tone or modifying configuration file.

•	Running - Call Process Tone Detection is in progress.

•	Analyzing - it is currently analyzing the captured tone.

•	Generating - new cadences are in the process of being calculated.

•	Updating - it is writing new cadences into the COFF and flash_cp.ini files.

•	Completed - Detection, Analysis and Modification have been completed without any problem.


Recording Status

The status of the recording will appear in the "Process Status" box only when CPTAnalyzer is recording.  When recording has finished, the amount of time of recording done and where the recording is done will be displayed under Recording Status.

0	Noticed in the example below, "Recording Status" has indicated that 7.66s of tone have been recorded so far and recording is done from Task 1.


Accumulated Detection Report

The type of tones detected in one run cycle will be displayed in this box.  Depending on the number of tones the user have specified under the "Tone to Capture" box, the same number of tones detected will be displayed here.

Possible detected tones will be reported are:

•	Dialtone

•	RingBack

•	LineBusy

•	Reorder Tone

•	Unrecognized Signal

•	SIT Band

•	Voice Like

•	Silence

•	Ringback Stopped

•	Pager Tone


Temporary File in Use

The name and full path name of the temporary file with the captured tone will be displayed in this box for users to know from where the tone being analyzed is stored.

This file will be deleted once analysis is completed.


DSP Status

The DSP Status box will only show up when recording tone.

Information being displayed is:

•	From which DSP the recording is done, DSP 1,2,3,...

•	From which Task of the above DSP the recording is done, Task 1,2,3,...

•	The kind of task currently running, this will always be "SPC 21 OUTDIAL" which means a CPTD task.


Detection Results

The results of the call progress tone detection will be displayed.  All the results in one run will be displayed after detection of each tone is done.  This area will be cleared only when the "Run" button is pressed.

Results being displayed are:

•	The expected type of tone.

•	The detected tone type.

•	Whether the detected tone type matches the expected type of tone.

•	Whether new cadences have been defined.


View Cadence Parameters

View Cadences

When a country has been selected, its cadence parameters can be displayed in the viewing window provided.

Cadence information resides in the configuration (COFF) file flash_cp.out. Once the CTPAnalyzer utility is started, a copy of the flash_cp.out file will be created and named as flash_cp_old.out in the d:\dsp directory.  If new cadences are being defined after analysis of the tones, they will be inserted into the flash_cp.out file and at the same time the additions will be written to flash_cp.ini file to keep track of changes made.

To view the cadences, choose "View Cadences" tab and then select "Display/Refresh" button.  Both the cadences from the flash_cp.out and the old flash_cp.out files will be displayed as a comparison between newly defined and old cadences for a specific country.

There are 36 cadences that can be defined for each country. However, only few of them are usually defined. When you display cadence parameters, there has to be at least one defined as "Linebusy" and one as "Ringback". The rest can be left unassigned.

In the example below, the newly defined cadences and the old ones are the same.  This means no new cadences have been defined.

Cadences Values

Each cadence has an On-Off, On-Off-On-Off or On-Off-On-Off-On-Off repetition. For every value there are a maximum and a minimum number. All the values are in msec and they are rounded to a nearest 16ms multiple. Therefore, for every defined cadence there has to be 4 or 8 or 12 values defined. Anything else is not correct. This rule will also apply when the user wants to define a new cadence. To view all the cadences and all the values you have to scroll up and down, left and right on above window.