NMS Logo

ADI Service Developer's Manual

P/N 6424-16
Version

Table of Contents Index NMS Glossary Previous Page Next Page Version

Table of Contents

1 Overview of CT Access

1.1 Introduction
1.2 CT Access Environment
1.2.1 Programming Model
1.2.2 CT Access Components
1.2.3 Managing Parameters in CT Access
1.3 Setting Up the CT Access Environment
1.3.1 Initializing CT Access
1.3.2 Creating Event Queues and CTA Contexts
1.3.3 Opening Services
1.3.4 Linking with the ADI Service
1.3.5 Using the ADI Service in Driver-Only Mode
1.3.6 Using ADI with the Natural Call Control Service
1.4 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 Supervised Transfer
2.8.2 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)
3.7 Simultaneous Play and Record

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.3.3 Improving DTMF Using Echo Cancellation

8 Echo Cancellation

8.1 Introduction
8.1.1 DTMF Cut-Through Example
8.1.2 Host-Based ASR Example
8.1.3 IP Telephony Gateway (Network Echo Canceller) Example
8.2 Echo Canceller Description
8.2.1 Predelay Buffer
8.2.2 Finite Impulse Response (FIR) Filter
8.2.3 Subtractor
8.2.4 Adaptation Logic
8.2.5 Double-Talk Detector
8.2.6 Non-Linear Processor
8.2.7 Input Gain
8.2.8 Bypass
8.3 Control of NMS Echo Cancellers
8.3.1 Echo Cancellation Parameters
8.4 Echo Canceller Attributes of NMS Boards
8.4.1 Configuring AG Boards for Echo Cancellation
8.4.2 Configuring QX Boards for Echo Cancellation
8.4.3 Configuring CG Boards for Echo Cancellation
8.4.4 Default Filterlength and Adapttime Values
8.4.5 Features and Performance Parameters
8.5 Recommendations for Controlling Echo
8.5.1 Transmission Level Planning and Echo
8.5.2 Using Microsoft NetMeeting and/or other IP Telephony Clients
8.5.3 Delay and Echo
8.5.4 Non-Voice Terminals (FAX and Modem Pass-through)
8.5.5 Automatic Speech Recognition
8.5.6 Minimization of Two-Wire Switching

9 Auxiliary Functions

9.1 Introduction
9.2 Energy Detector
9.2.1 Energy Detector Events
9.2.2 Energy Detector Parameters
9.2.3 Terminating Energy Detection
9.3 Frequency Shift Key (FSK) Data
9.3.1 Sending FSK Data
9.3.2 Parameters for Sending FSK Data
9.3.3 Terminating FSK Data Transmission
9.3.4 Receiving FSK Data
9.3.5 Parameters for Receiving FSK Data
9.3.6 Terminating FSK Data Reception
9.4 Low Level Call Control
9.5 On-Board Timers
9.5.1 Starting the Timer
9.5.2 Start Timer Events
9.5.3 Stopping the Timer
9.5.4 Stop Timer Event
9.6 Other Functions

10 Demonstration Programs

10.1 Introduction
10.1.1 ctademo.c
10.2 Host Port to Port Connection Program: hostp2p
10.3 Play and Record: playrec
10.4 Multi-Threaded Application: threads

Table of Contents Index NMS Glossary Previous Page Next Page Version

Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2000, Natural MicroSystems, Inc. All rights reserved.