CT Access Developer' s Manual

P/N 6304-10

(Page 1 of 1 in this chapter)

Table of Contents

1 Introduction

1.1 About CT Access
1.2 About This Manual
1.3 Related Documents
1.4 Developer Support

2 CT Access Architecture

2.1 Introduction
2.2 CT Access Components
2.2.1 Services
2.2.2 Service Managers
2.2.3 Dispatcher
2.3 CT Access 1.0
2.3.1 Switching Service
2.3.2 Voice Message Service
2.3.3 ADI Service
2.4 Principles of Operation
2.4.1 Asynchronous Programming Model
2.4.2 Events
2.4.3 CTA Context
2.4.4 Event Queue
2.4.5 Command and Event Processing

3 Application Development

3.1 Introduction
3.2 Programming Models
3.2.1 Single Context, Single Queue per Process
3.2.2 Multiple Contexts, Multiple Queues per Process
3.2.3 Multiple Contexts, Single Queue per Process
3.3 Setting Up a CT Access Application
3.3.1 Initializing CT Access
3.3.2 Creating Queues
3.3.3 Creating CTA Contexts
3.3.4 Opening Services
3.3.5 Opening the ADI Service
3.3.6 Closing Services, Destroying Contexts and Queues
3.4 Using Wait Objects
3.4.1 Wait Object Functions
3.4.2 Wait Objects and Events Managed by CT Access
3.4.3 Wait Objects and Events Managed by the Application
3.5 Managing Parameters
3.5.1 Parameter Scope
3.5.2 Global Default Parameters
3.5.3 Parameter Functions
3.6 CT Access Error Codes
3.6.1 Handling Errors
3.6.2 Error Tracing
3.7 Verifying Compatibility
3.8 Development Environment
3.8.1 Header Files
3.8.2 Binaries
3.8.3 Windows NT
3.8.4 UnixWare 2.1
3.8.5 OS/2
3.8.6 SCO Openserver 5.0

4 Switching Service

4.1 Introduction
4.2 Characteristics
4.2.1 Switch Handles
4.2.2 Terminus
4.2.3 MVIP-95 Switch Block Model
4.3 Opening a Switch Handle
4.3.1 Specifying MVIP-95 or MVIP-90 Mode
4.3.2 Enabling Terminus Output State Restoration
4.4 Closing a Switch Handle
4.5 MVIP Switching
4.5.1 Making Connections
4.5.2 Sending a Pattern
4.5.3 Disabling Output
4.5.4 Sampling Data
4.5.5 Querying Switch Capabilities
4.6 Clock Configuration
4.6.1 MVIP Clock Configuration Example
4.6.2 MC1 Clock Configuration Example
4.7 Stream Speed Configuration
4.8 Board and Driver Configuration
4.9 Diagnostic Function
4.10 Utility Functions

5 Voice Message Service

5.1 Introduction
5.2 Characteristics
5.2.1 File Types
5.2.2 Voice Encoding Formats
5.2.3 Voice Handles
5.2.4 Messages
5.2.5 Lists
5.2.6 Current Message and Current Position
5.2.7 Prompt Builder
5.2.8 Message Text
5.3 Getting a Voice Handle
5.4 Playing
5.4.1 Playing Functions
5.4.2 Playing Completion Reasons
5.4.3 Speed and Gain Adjustment
5.4.4 Parameters
5.5 Recording
5.5.1 Recording Functions
5.5.2 Recording Completion Reasons
5.5.3 Resizing Messages
5.5.4 Parameters
5.6 Playing and Recording States
5.7 Stopping
5.8 DTMF Interaction
5.9 Getting Status
5.9.1 Context Status
5.9.2 Voice Object Information
5.10 Editing
5.10.1 Copy
5.10.2 Erase
5.10.3 Read/Write
5.10.4 Convert Encoding or Amplitude
5.11 Using Prompt Builder Functions
5.12 Using Message Text
5.13 System Restrictions

6 ADI Service: Call Control

6.1 Introduction
6.1.1 Call Control and Protocol Independence
6.2 Telephone Network Events
6.2.1 Informational Events
6.2.2 Transitional Events
6.3 Responding to Inbound Calls
6.3.1 Inbound Call Parameters
6.3.2 Inbound Call Events
6.3.3 Performing Caller ID on Inbound Calls
6.4 Establishing Outbound Calls
6.4.1 Call Control Mask Parameters
6.4.2 Connectmask
6.4.3 Disconnectmask
6.4.4 Using Telephone Network Tone Detection
6.4.5 Using Precise Tone Detection
6.4.6 Using Broadband Tone Detection
6.4.7 Using Voice Detection
6.4.8 Using Call Placement Timeout
6.4.9 Outbound Call Parameters
6.4.10 Outbound Call Events
6.5 Releasing Calls
6.5.1 Telephone Network-Initiated Release
6.5.2 Application-Initiated Release
6.5.3 Call Release Parameters
6.5.4 Call Release Events
6.6 Blocking and Unblocking Calls
6.6.1 Call Blocking Parameters
6.6.2 Call Blocking Events
6.7 Managing Service Interruption
6.8 Transferring Calls
6.8.1 Using Supervised Transfer
6.8.2 Using Blind Transfer
6.8.3 Call Transfer Parameters
6.8.4 Call Transfer Events
6.9 State Diagrams
6.10 Protocol Specific Parameters
6.10.1 Loop-Start Parameters
6.10.2 Wink-Start and DID Parameters
6.11 System Restrictions

7 ADI Service: Playing/Recording

7.1 Introduction
7.2 Characteristics
7.2.1 Voice Encoding Formats
7.2.2 Buffer Sizes
7.3 Data Transfer Methods
7.3.1 Single Memory Transaction
7.3.2 Asynchronous Transfer
7.3.3 Callback Transfer
7.4 DTMF Tones
7.4.1 DTMFabort Mask
7.5 Voice Play Functions
7.5.1 Voice Play Parameters
7.5.2 Initiating Play
7.5.3 Terminating Play
7.5.4 Playing Voice Data in Callback Mode
7.5.5 Playing Voice Data in Asynchronous Mode
7.5.6 Controlling Gain During Play
7.5.7 Controlling Speed During Play
7.6 Voice Record Functions
7.6.1 Voice Record Parameters
7.6.2 Initiating Record
7.6.3 Terminating Record
7.6.4 Data Transfer Using Callback Mode
7.6.5 Data Transfer Using Asynchronous Mode
7.6.6 Recording with Automatic Gain Control
7.7 System Restrictions
7.7.1 Delays in Data Processing

8 ADI Service: Call Progress

8.1 Introduction
8.2 Call Progress Events
8.2.1 Call Progress Tone Events
8.2.2 Call Progress Voice Events
8.2.3 Call Progress Termination Events
8.3 System Restrictions

9 ADI Service: Tone Detection

9.1 Introduction
9.2 Tone Detection Parameters
9.3 Stopping Tone Detection

10 ADI Service: Tone Generation

10.1 Introduction
10.2 Generating DTMFs and Tones
10.3 Tone Generation Parameters
10.4 Terminating Tone Generation
10.5 System Restrictions

11 ADI Service: DTMF Collection

11.1 Introduction
11.2 Digit (DTMF) Collection
11.2.1 ADI Service Digit Queue
11.2.2 Synchronous Digit Collection
11.2.3 Asynchronous Digit Collection
11.2.4 Digit Collection Parameters
11.2.5 Terminating Asynchronous Digit Collection
11.3 DTMF Detector
11.3.1 DTMF Detection Parameters
11.3.2 Terminating DTMF Detection
11.4 Echo Cancellation
11.4.1 Echo Cancellation Parameters
11.4.2 Enabling the Echo Canceller

12 ADI Service: Auxiliary Functions

12.1 Introduction
12.2 Energy Detector
12.2.1 Energy Detector Events
12.2.2 Energy Detector Parameters
12.2.3 Terminating Energy Detection
12.3 Frequency Shift Key (FSK) Data
12.3.1 Sending FSK Data
12.3.2 Parameters for Sending FSK Data
12.3.3 Terminating FSK Data Transmission
12.3.4 Receiving FSK Data
12.3.5 Parameters for Receiving FSK Data
12.3.6 Terminating FSK Data Reception
12.4 Low Level Call Control
12.5 On-board Timers
12.5.1 Starting the Timer
12.5.2 Start Timer Events
12.5.3 Stopping the Timer
12.5.4 Stop Timer Event
12.6 AG Board Functions

13 Demonstration Programs and Utilities

13.1 Introduction
13.2 Demonstration Programs
13.2.1 Interactive Test Program: ctatest
13.2.2 Drop and Insert Program: drpinsrt
13.2.3 Inbound Call Control: incta
13.2.4 Outbound Call Control: outcta
13.2.5 Port to Port Program: prt2prt
13.2.6 Voice File Copy/Convert Program: vcecopy
13.2.7 Voice File Information: vceinfo
13.2.8 Voice File Play: vceplay
13.2.9 Voice File Record: vcerec
13.3 Utilities
13.3.1 CT Access Parameter Display: ctaparm
13.3.2 CT Access Installation: ctavers
13.3.3 CT Access Daemon: ctdaemon
13.3.4 Make Prompt: mkprompt
13.3.5 Control MVIP Switches: swish
13.3.6 Test Prompt: testpmpt
13.3.7 VOX File Information: voxinfo

Appendix A Glossary

Appendix B VOX File Format

Introduction
VOX File Format
Index Structure
Summary of Frame Sizes

Appendix C Prompt Builder

Introduction
Run-Time Files
Source Programs
Editing and Creating Your Own Prompt Rules Table

Appendix D Switching Application Example

Introduction

(Page 1 of 1 in this chapter)

Tech_Support@nmss.com
Copyright © 1996, Natural MicroSystems, Inc. All rights reserved.