Technical Helpweb

- more articles

Setting up CPA for fax tone detection

Symptom:

Dialogic® CSP Converged Services Platform (CSP) and Dialogic® MSP Multi-Services Platform (MSP) systems do not completely support the detection of both CNG 1100Hz and CED 2100Hz fax tones by default. The Call Progress Analysis (CPA) needs to be customized to support each fax tone.

Solution:

The following configuration messages are formatted for both the Dialogic® SwitchKit API and the raw API.

SwitchKit:

# Attach DSP service request of type 0x03 0x00 CPA class 0 N. American standard by default you will see the CPA 0x34 message with type 0x13 which is the 1100 hz tone CNG
# Attach DSP service request of type 0x03 0x00 and expect to see a CPA 0x34 message of type 0x14 which is the tone id 0x0e 2100 hz FAX CED tone..
Note the values below in each message are formated in hexidecimal values.

# CPA config for FAX tone detect setup fax tone detection.
# Configure pattern 0x14 with tone id 0x0e which is the 2100Hz CED.
# Store values without applying yet as more tones to follow
 CPAPatternConfig(Node=7, UpdateFlag=0x01, Pattern=0x14, Action=0x01, Data=0x14:0x00:0x01:0x0f:0x01:0x01:0x00:0x01:0x0e:0x00:0x00:0x50:0xff:0xff);

Below the same config file yet its in raw hex API format. Also the byte meanings are explained.

 #'Call Progress Analysis Pattern Config that adds the 2100 hz tone id 0x0e to CPA Class 0x00
 #'00 16 00 b2 00 00 ff\
 #'01\	'update
 #'14\	'New Pattern ID
 #'01\	'Add
 #'14\	'Report upon Detection
 #'00\	'Tone Group ID
 #'01\	'Last Interval Continuous
 #'0f\	'FAX 2100Hz
 #'01\	'Intervals to Match
 #'01\	'Intervals to Report
 #'00\	'Reserved
 #'01\	'Interval Descriptor
 #'0e\	'Tone ID 
 #'00\	'Reserved
 #'00 50\	'Min 500ms
 #'ff ff\	'Max Continuous ms
 
 # CPA Class config - Delete FAX 1100Hz CNG pattern 0x13 from Class 0x00
 CPAClassConfig(node=7, UpdateFlag=0x01, Class=0x00, Action=0x02, Data=0x13);
 
 # Add pattern 0x14 2100hz CED to class 0x0e which is a new class
 CPAClassConfig(node=7, UpdateFlag=0x01, Class=0x0e, Action=0x01, Data=0x14);
 
 # '00 09 00 b3 00 00 07
 # '01 'Update Flag
 # '0e 'CPA Class id
 # '01 'Action - add member pattern
 # '14 'Data - Add member pattern 14
 
 
 # Create and configure CPA Class 14 for receiving faxes and the other original tones
 CPAClassConfig(node=7, UpdateFlag=0x01, Class=0x0e, Action=0x01, Data=0x13); ' New Fax

Call Flow for a fax call originating from the CSP card outbound to a destination. The host application will send and outseize message for outbound call once the signalling requirments to setup the call is made the host also send to the CSP a DSP service request message to attach a DSP receiver that is programmed to scan for the FAX tone 2100Hz CED tone for this call flow case. Once the tone is detected you will receive a 0x34 CPA result message of type 0x14 2100Hz tone detected.

H->X 
 [00 23 00 2c 00 00 07 00 01 0d 03 00 1a 00 04 01 0a 00 
 01 08 00 01 0f 00 02 10 0a 01 02 07 02 01 04 33 39 35 
 37]
 X->H 
 [00 07 00 2c 00 00 07 00 10]
 X->H 
 [00 19 00 43 00 5a 07 00 01 0d 03 00 1a 00 00 05 00 01 01 02 
 10 05 01 01 02 00 04]
 H->X 
 [00 05 00 43 00 5a 07]
 X->H 
 [00 24 00 43 00 5c 07 00 01 0d 03 00 1a 00 00 05 00 03 02 02 
 10 05 01 01 02 00 04 02 11 08 01 0c 05 80 33 39 35 37]
 X->H 
 [00 0d 00 2e 00 86 07 00 01 0d 03 00 1a 00 20]
 H->X 
 [00 05 00 43 00 5c 07]
 H->X 
 [00 05 00 2e 00 86 07]
 H->X 
 [00 0e 00 bd 00 00 07 00 01 0d 03 00 1a 00 03 00]
 X->H 
 [00 07 00 bd 00 00 07 00 10]
 X->H 
 [00 10 00 34 00 08 07 00 01 0d 03 00 1a 00 14 00 00 00]
 H->X 
 [00 05 00 34 00 08 07]

Call Flow for receiving an inbound detected fax call on CSP. The DSP service request to scan for 1100Hz CNG tone is attached. Once the tone is detected you will receive a 0x34 CPA result message of type 0x13 1100Hz CNG tone detected.

 X->H 
 [00 3e 00 2d 00 0e 07 00 01 0d 03 00 1a 00 00 03 02 02 10 19 
 03 01 02 80 06 03 09 04 09 00 03 04 33 39 35 37 02 07 
 04 09 04 38 35 38 31 02 11 10 03 04 03 80 90 a2 18 03 
 a9 83 81 7c 03 80 90 a2]
 H->X 
 [00 0c 00 2d 00 0e 07 00 01 0d 03 00 1a 00]
 H->X 
 [00 0d 00 ba 00 00 07 00 01 0d 03 00 1a 00 01]
 X->H 
 [00 07 00 ba 00 00 07 00 10]
 H->X 
 [00 0e 00 bd 00 00 07 00 01 0d 03 00 1a 00 03 00]
 X->H 
 [00 07 00 bd 00 00 07 00 10]
 X->H 
 [00 10 00 34 00 09 07 00 01 0d 03 00 1a 00 13 00 00 00]
 H->X 
 [00 05 00 34 00 09 07]

 
Raw API:

 'Create a new class with only the 2 fax tones in it CNG 1100Hz CED 2100Hz
 
 'Configure pattern 0x14 with tone id 0x0e which is the 2100Hz tone
 00 15 00 b2 00 00 00 01 14 01 14 00 01 0f 01 01 00 01 0e 00 00 50 ff 
 
 ' Delete FAX (1100Hz) pattern 0x13 from Class 0x00
 00 09 00 b3 00 00 00 01 00 02 13 
 
 'Add pattern 14 2100hz to class 0x0e 14 which is a new class
 00 09 00 b3 00 00 00 01 0e 01 14 
 
 'Create and configure CPA Class 14 for receiving fax tones.
 00 09 00 b3 00 00 00 01 0e 01 13

Product List

Dialogic® MSP Multi-Services Platform
Dialogic® CSP Converged Services Platforms
Dialogic® CSP Matrix Controller Series 3 Card
Dialogic® Digital Signal Processing Series 2 Card
Dialogic® Digital Signal Processing Series 2 Plus Card

Glossary of Acronyms / Terms

CPA = Call Progress Analysis.
CED = Called tone.
CNG= Calling tone.

 

Related Documentation

Dialogic® Converged Services Platform (CSP) API Reference Guide.
Dialogic® Converged Services Platform (CSP) Developers Overview Guide.