ADI Service Developer's Manual

P/N 6424-14
Version


(Page 1 of 1 in this chapter)

Table of Contents

About This Manual

Developer Support

1 Overview of CT Access

1.1 CT Access Environment
1.1.1 Programming Model
1.1.2 CT Access Components
1.1.3 Managing Parameters in CT Access
1.2 Setting Up the CT Access Environment
1.2.1 Initializing CT Access
1.2.2 Creating Event Queues and CTA Contexts
1.2.3 Opening Services
1.2.4 Linking with the ADI Service
1.2.5 Using the ADI Service in Driver-Only Mode
1.2.6 Using ADI with the Natural Call Control Service
1.3 ADI Service Functionality

2 Call Control

2.1 Introduction
2.1.1 Call Control and Protocol Independence
2.2 Telephone Network Events
2.2.1 Informational Events
2.2.2 Transitional Events
2.3 Responding to Inbound Calls
2.3.1 Inbound Call Parameters
2.3.2 Inbound Call Events
2.3.3 Accepting Calls
2.3.4 Performing Caller ID on Inbound Calls
2.4 Establishing Outbound Calls
2.4.1 Call Control Mask Parameters
2.4.2 Connectmask
2.4.3 Disconnectmask
2.4.4 Using Telephone Network Tone Detection
2.4.5 Using Precise Tone Detection
2.4.6 Using Broadband Tone Detection
2.4.7 Using Voice Detection
2.4.8 Using Call Placement Timeout
2.4.9 Outbound Call Parameters
2.4.10 Outbound Call Events
2.5 Releasing Calls
2.5.1 Telephone Network-Initiated Release
2.5.2 Application-Initiated Release
2.5.3 Cleardown Tone Detection
2.5.4 Call Release Parameters
2.5.5 Call Release Events
2.6 Blocking and Unblocking Calls
2.6.1 Call Blocking Parameters
2.6.2 Call Blocking Events
2.7 Managing Service Interruption
2.8 Transferring Calls
2.8.1 Using Supervised Transfer
2.8.2 Using Automatic Transfer
2.8.3 Call Transfer Parameters
2.8.4 Call Transfer Events
2.9 State Diagrams

3 Playing and Recording

3.1 Introduction
3.1.1 Voice Encoding Formats
3.1.2 Buffer Sizes
3.2 Data Transfer Methods
3.2.1 Single Memory Transaction
3.2.2 Asynchronous Transfer
3.2.3 Callback Transfer
3.3 DTMF Tones
3.3.1 DTMFabort Mask
3.4 Voice Play Functions
3.4.1 Voice Play Parameters
3.4.2 Initiating Play
3.4.3 Terminating Play
3.4.4 Playing Voice Data in Callback Mode
3.4.5 Playing Voice Data in Asynchronous Mode
3.4.6 Controlling Gain During Play
3.4.7 Controlling Speed During Play
3.5 Voice Record Functions
3.5.1 Voice Record Parameters
3.5.2 Initiating Record
3.5.3 Terminating Record
3.5.4 Data Transfer Using Callback Mode
3.5.5 Data Transfer Using Asynchronous Mode
3.5.6 Recording with Automatic Gain Control
3.6 System Restrictions
3.6.1 Delays in Data Processing (AG Boards)

4 Call Progress

4.1 Introduction
4.2 Call Progress Events
4.2.1 Call Progress Tone Events
4.2.2 Call Progress Voice Events
4.2.3 Call Progress Termination Events
4.3 System Restrictions (AG Boards)

5 Tone Detection

5.1 Introduction
5.2 Tone Detection Parameters
5.3 Stopping Tone Detection

6 Tone Generation

6.1 Introduction
6.2 Generating DTMFs and Tones
6.3 Tone Generation Parameters
6.4 Terminating Tone Generation
6.5 System Restrictions

7 DTMF Collection

7.1 Introduction
7.2 Digit (DTMF) Collection
7.2.1 ADI Service Digit Queue
7.2.2 Synchronous Digit Collection
7.2.3 Asynchronous Digit Collection
7.2.4 Digit Collection Parameters
7.2.5 Terminating Asynchronous Digit Collection
7.3 DTMF Detector
7.3.1 DTMF Detection Parameters
7.3.2 Terminating DTMF Detection
7.4 Echo Cancellation
7.4.1 Echo Cancellation Parameters
7.4.2 Enabling the Echo Canceller

8 Auxiliary Functions

8.1 Introduction
8.2 Energy Detector
8.2.1 Energy Detector Events
8.2.2 Energy Detector Parameters
8.2.3 Terminating Energy Detection
8.3 Frequency Shift Key (FSK) Data
8.3.1 Sending FSK Data
8.3.2 Parameters for Sending FSK Data
8.3.3 Terminating FSK Data Transmission
8.3.4 Receiving FSK Data
8.3.5 Parameters for Receiving FSK Data
8.3.6 Terminating FSK Data Reception
8.4 Low Level Call Control
8.5 On-Board Timers
8.5.1 Starting the Timer
8.5.2 Start Timer Events
8.5.3 Stopping the Timer
8.5.4 Stop Timer Event
8.6 Other Functions

9 Demonstration Programs

9.1 Introduction
9.1.1 About ctademo.c
9.2 Host Port to Port Connection Program: hostp2p
9.3 Play and Record: playrec
9.4 Multi-Threaded Application: threads
9.5 Call Transfer: xferpbx

Appendix A Glossary



(Page 1 of 1 in this chapter)


tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.