User's Manual
Table Of Contents
- Contents
- Figures
- Tables
- Revision History
- About This Publication
- 1. Product Description
- 2. Programming Models
- 3. Device Handling
- 4. Event Handling
- 5. Error Handling
- 6. Application Development Guidelines
- 7. Call Progress Analysis
- 7.1 Call Progress Analysis Overview
- 7.2 Call Progress and Call Analysis Terminology
- 7.3 Call Progress Analysis Components
- 7.4 Using Call Progress Analysis on DM3 Boards
- 7.5 Call Progress Analysis Tone Detection on DM3 Boards
- 7.6 Media Tone Detection on DM3 Boards
- 7.7 Default Call Progress Analysis Tone Definitions on DM3 Boards
- 7.8 Modifying Default Call Progress Analysis Tone Definitions on DM3 Boards
- 7.9 Call Progress Analysis Errors
- 7.10 Using Call Progress Analysis on Springware Boards
- 7.11 Call Progress Analysis Tone Detection on Springware Boards
- 7.12 Media Tone Detection on Springware Boards
- 7.13 Default Call Progress Analysis Tone Definitions on Springware Boards
- 7.14 Modifying Default Call Progress Analysis Tone Definitions on Springware Boards
- 7.15 SIT Frequency Detection (Springware Only)
- 7.15.1 Tri-Tone SIT Sequences
- 7.15.2 Setting Tri-Tone SIT Frequency Detection Parameters
- 7.15.3 Obtaining Tri-Tone SIT Frequency Information
- 7.15.4 Global Tone Detection Tone Memory Usage
- 7.15.5 Frequency Detection Errors
- 7.15.6 Setting Single Tone Frequency Detection Parameters
- 7.15.7 Obtaining Single Tone Frequency Information
- 7.16 Cadence Detection in Basic Call Progress Analysis (Springware Only)
- 8. Recording and Playback
- 8.1 Overview of Recording and Playback
- 8.2 Digital Recording and Playback
- 8.3 Play and Record Functions
- 8.4 Play and Record Convenience Functions
- 8.5 Voice Encoding Methods
- 8.6 G.726 Voice Coder
- 8.7 Transaction Record
- 8.8 Silence Compressed Record
- 8.9 Recording with the Voice Activity Detector
- 8.10 Streaming to Board
- 8.11 Pause and Resume Play
- 8.12 Echo Cancellation Resource
- 9. Speed and Volume Control
- 10. Send and Receive FSK Data
- 11. Caller ID
- 12. Cached Prompt Management
- 13. Global Tone Detection and Generation, and Cadenced Tone Generation
- 13.1 Global Tone Detection (GTD)
- 13.1.1 Overview of Global Tone Detection
- 13.1.2 Global Tone Detection on DM3 Boards versus Springware Boards
- 13.1.3 Defining Global Tone Detection Tones
- 13.1.4 Building Tone Templates
- 13.1.5 Working with Tone Templates
- 13.1.6 Retrieving Tone Events
- 13.1.7 Setting GTD Tones as Termination Conditions
- 13.1.8 Maximum Amount of Memory for Tone Templates
- 13.1.9 Estimating Memory
- 13.1.10 Guidelines for Creating User-Defined Tones
- 13.1.11 Global Tone Detection Application
- 13.2 Global Tone Generation (GTG)
- 13.3 Cadenced Tone Generation
- 13.3.1 Using Cadenced Tone Generation
- 13.3.2 How To Generate a Custom Cadenced Tone
- 13.3.3 How To Generate a Non-Cadenced Tone
- 13.3.4 TN_GENCAD Data Structure - Cadenced Tone Generation
- 13.3.5 How To Generate a Standard PBX Call Progress Signal
- 13.3.6 Predefined Set of Standard PBX Call Progress Signals
- 13.3.7 Important Considerations for Using Predefined Call Progress Signals
- 13.1 Global Tone Detection (GTD)
- 14. Global Dial Pulse Detection
- 14.1 Key Features
- 14.2 Global DPD Parameters
- 14.3 Enabling Global DPD
- 14.4 Global DPD Programming Considerations
- 14.5 Retrieving Digits from the Digit Buffer
- 14.6 Retrieving Digits as Events
- 14.7 Dial Pulse Detection Digit Type Reporting
- 14.8 Defines for Digit Type Reporting
- 14.9 Global DPD Programming Procedure
- 14.10 Global DPD Example Code
- 15. R2/MF Signaling
- 16. Syntellect License Automated Attendant
- 17. Building Applications
- Glossary
- Index

170 Voice API Programming Guide — June 2005
Global Dial Pulse Detection
• The application can enable global DPD and volume control. (Previously, there was a
restriction that DPD digits had to be sent to the event queue instead of the digit queue if
volume control was enabled.)
The following applications are supported by the global DPD feature:
• Analog applications using the loop-start telephone interface on a supported voice board
• Digital applications using a supported voice board
See the Release Guide for information on boards that support the global DPD feature.
14.2 Global DPD Parameters
This implementation of dial pulse detection is referred to as global DPD because its detection
algorithm supports a wide range of dial pulses, from 8 pulse-per-second (PPS) to 22 PPS
telephones.
Intel is continually qualifying its dial pulse detection algorithm against dial pulse data collected
from different parts of the world to improve DPD accuracy for telephone systems and telephones in
different regions. As appropriate, Intel will issue download parameters from time to time to
improve the accuracy of DPD in a given region of the world, whether it is part of a country, an
entire country, or a group of countries.
On Linux, these parameters are contained in the voice.prm file. To download the global DPD
parameters, select a specific country when the boards are configured.
On Windows, customized global DPD download parameters are provided for several countries such
as Argentina, Brazil, Colombia, India, Japan, Mexico and Venezuela, one of which can be selected
during installation (refer to the Country Specific Parameter File). As additional regions are
qualified for customized global DPD, relevant region-specific support will be released.
Support for a generic 10 pulse-per-second (PPS) global DPD parameter file is provided for
countries that use 10 PPS phones.
You must install the Country-Specific Parameters and select a country to obtain support for global
DPD.
14.3 Enabling Global DPD
On Windows, Global DPD works only on DPD-enabled boards. You must order a separate GDPD
enablement package from Intel to enable GDPD on these boards. See the Release Guide for
information on boards that support the global DPD feature. To indicate that a board is DPD-
enabled, apply the sticker provided with the GDPD enablement package to your board.
Additionally, it is recommended that you write down the serial number of the DPD-enabled board
for your records.