Manuals / Brands / Photography / Digital Camera / Intel / Photography / Digital Camera

Intel 05-2409-003 1.3 Global Call Architecture, 1.3.1 Overview

1 154

Download 154 pages, 955.12 Kb

Global Call API for HMP on Windows Programming Guide — August 2006 19

Product Description

Event Handling Functionality

Provides the ability to handle and process events, including the ability to disable and enable

events and to retrieve event information. See Chapter4, “Event Handling” for more

information.

Global Call Alarm Management System (GCAMS)

Provides the ability to manage alarms. GCAMS provides Global Call applications with the

ability to receive extensive alarm information that can be used to troubleshoot line problems.

See Chapter8, “Alarm Handling” for more information.

Real Time Configuration Management (RTCM)

Allows the modification of call control and protocol elements in real time, providing a single

common user interface for configuration management. See Chapter9, “Real Time

Configuration Management” for more information.

Global Call Service Request (GCSR)

Enables an application to send a request for a service to a remote device. Examples of the types

of services that this feature supports are device registration, channel setup, call setup,

information requests, or other kinds of requests that need to be made between two devices

across the network. See Chapter 10, “Handling Service Requests” for more information.

Library Information Functions

Enables an application to get information about the call control libraries being used. See the

Global Call API Library Reference for more information about these functions.

Debugging Facilities

Global Call provides powerful debugging capabilities for troubleshooting protocol-related

problems, including the ability to generate a detailed log file. See the appropriate Global Call

Technology Guide for information on the debugging facilities available when using Global

Call with each technology.

1.3 Global Call Architecture

The Global Call development software architecture is based on the Intel® Dialogic® architecture

that supports Host Media Processing (HMP) software and DM3 hardware. The architecture is

described in the following topics:

•Overview

•Global Call API

1.3.1 Overview

Figure 1 shows a system-level view of the Global Call architecture for IP technology and Figure2

shows the Global Call architecture for E1/T1 and ISDN technologies on DM3 hardware.

Contents

Main Global Call API for HMP on Windows Programming Guide August 2006 Contents Page Page Page Figures Page Tab le s Page Revision History This revision history summarizes the changes made in each published version of this document. Page About This Publication Purpose Applicability Intended Audience How to Use This Publication Related Information Page Page 1.1 Global Call Software Overview 1.2 Global Call Feature Categories 1.2.1 Call Control Features 1.2.2 Operation, Administration and Maintenance Features 1.3 Global Call Architecture 1.3.1 Overview 20 Global Call API for HMP on Windows Programming Guide August 2006 Product Description Figure 1. Global Call Architecture for IP Technology 1.3.2 Global Call API 1.4 Call Control Libraries 1.4.1 Starting Call Control Libraries 1.4.2 Call Control Library States 1.5 Global Call Object Identifiers 1.5.1 Line Device Identifier 1.5.2 Call Reference Number 1.5.3 Object Identifiers and Resource Sharing Across Processes 1.5.4 Target Objects Page Target Object Availability Retrieving Target IDs Page 2.1 Programming Models Overview 2.2 Asynchronous Mode Programming 2.2.1 Asynchronous Model Overview 2.2.2 Asynchronous Model with Event Handlers 2.2.3 Asynchronous with Windows Callback Model 2.2.4 Asynchronous with Win32 Synchronization Model 2.2.5 Extended Asynchronous Programming Model Page 3.1 Call State Model Overview 3.2 Basic Call Model 3.2.1 Basic Call States at the Inbound Interface 3.2.2 Basic Call States at the Outbound Interface 3.2.3 Basic Call States for Call Termination 3.3 Basic Call Model Configuration Options 3.3.1 Call State Configuration 3.3.2 Call State Event Configuration 3.3.3 Call Acknowledgement Configuration 3.3.4 Call Proceeding Configuration 3.4 Basic Call Control in Asynchronous Mode 3.4.1 Inbound Calls in Asynchronous Mode 3.4.1.1 Inbound Calls in Asynchronous Mode Overview Figure 4. Basic Asynchronous Inbound Call State Diagram gc_CallAck(MORE_INFO) GCEV_MOREINFO Table6. Asynchronous Inbound Call State Transitions State Description Previous/Next State Applies to E1, T1 and ISDN technology only. Valid Call State Trans iti on Functions Call Transition Events 3.4.1.2 Channel Initialization 3.4.1.3 Call Detection 3.4.1.4 Call Offered 3.4.1.5 Call Routing 3.4.1.6 Call Acceptance 3.4.1.7 Call Establishment 3.4.1.8 Overlap Receiving Scenario 1 Scenario 2 Scenario 3 Scenario 4 3.4.1.9 Call Failure 3.4.1.10 Abandoned Calls 3.4.1.11 Inbound Call Scenarios in Asynchronous Mode Page Page Page Page 3.4.2 Outbound Calls in Asynchronous Mode 3.4.2.1 Outbound Calls in Asynchronous Mode Overview Figure 11. Basic Asynchronous Outbound Call State Diagram GCEV_PROCEEDING Table7. Asynchronous Outbound Call State Transitions State Previous/Next State Applies to E1, T1 and ISDN technologies only. Valid Call State Transition Functions Call Transition Events 3.4.2.2 Channel Initialization 3.4.2.3 Call Dialing 3.4.2.4 Call Proceeding 3.4.2.5 Call Alerting 3.4.2.6 Call Connected 3.4.2.7 Overlap Sending 3.4.2.8 Call Failure 3.4.2.9 Outbound Call Scenarios in Asynchronous Mode Page 3.4.3 Call Termination in Asynchronous Mode 3.4.3.1 Call Termination in Asynchronous Mode Overview 3.4.3.2 User Initiated Termination 3.4.3.3 Network Initiated Termination 3.4.3.4 Call Release 3.4.3.5 Call Termination Call Control Scenarios in Asynchronous Mode Figure 17. Network Initiated Asynchronous Call Termination Scenario 3.4.4 Handling Unsolicited Events 3.5 Advanced Call Control with Call Hold and Transfer 3.5.1 Advanced Call State Model Overview 3.5.2 Advanced Call States for Hold and Transfer 3.5.3 Call Hold 3.5.4 Call Transfer 3.5.4.1 Call Transfer Overview 3.5.4.2 Supervised Transfers Figure 19. Call State Model for Supervised and Unsupervised Transfers 3.5.4.3 Unsupervised Transfers Page 4.1 Overview of Event Handling 4.2 Event Categories 4.3 Blocked and Unblocked Event Handling 4.4 Event Retrieval 4.5 Events Indicating Errors 4.6 Masking Events 4.7 Event Handlers Page Page Guidelines 5.1 General Programming Tips 5.2 Tips for Programming Drop and Insert Applications 5.3 Using Global Call with Digital Network Interface Boards 5.3.1 Routing Overview 5.3.2 Working with Flexible Routing Configurations 5.3.2.1 Determining Channel Capabilities (Flexible Routing) 5.3.2.2 Using Device Handles (Flexible Routing) 5.3.2.3 Multi-Threading and Multi-Processing (Flexible Routing) 5.3.2.4 Initializing an Application (Flexible Routing) 5.3.2.5 Initializing Global Call (Flexible Routing) Page 5.3.2.6 Device Initialization Hint (Flexible Routing) 5.3.2.7 Using Protocols (Flexible Routing) 5.3.3 Handling Multiple Call Objects Per Channel in a Glare Condition Page 6.1 Error Handling Overview Page 7.1 Call Progress Analysis when Using IP Technology 7.2 Call Progress Analysis when Using Digital Network Interface Boards 7.2.1 Call Progress Analysis Definition 7.2.2 Configuring Default Call Progress Analysis Parameters 7.2.3 Configuring Call Progress Analysis on a Per Call Basis Page 7.2.4 Setting Call Analysis Attributes on a Per Call Basis 7.2.5 Configuring Call Progress Analysis on a Per Channel Basis 7.2.6 Setting Call Analysis Attributes on a Per Channel Basis 7.2.7 Customizing Call Progress Tones on a Per Board Basis 7.3 Resource Routing 7.4 Feature Transparency and Extension 7.4.1 Feature Transparency and Extension Overview 7.4.2 Technology-Specific Feature Access 7.4.3 Technology-Specific User Information Page 8.1 Alarm Handling Overview 8.1.1 Alarm Management System Components Page 8.2 Operation and Configuration of GCAMS 8.2.1 Generation of Events for Blocking Alarms 8.2.2 Generation of Alarm Events 8.2.3 Configuration of Alarm Properties and Characteristics 8.2.3.1 Configuring Alarm Notification 8.2.3.2 Configuring Alarm Flow 8.2.3.3 Configuring Blocking and Non-Blocking Alarm Classification 8.2.3.4 Configuring Alarm Parameters 8.2.3.5 Alarm Configuration Tips 8.2.4 Starting and Stopping Alarm Transmission 8.2.5 Retrieving Alarm Data 8.2.5.1 Alarm Numbers and Names 8.2.5.2 Alarm Source Object IDs and Names 8.3 Sample Alarm Scenarios 8.3.1 Scenario 1: Application Notified of First and Last Blocking Alarm Page 8.3.2 Scenario 2: Default Behavior for Alarm Notification 8.3.3 Scenario 3: Alarm Transmission Management 9.1 Real Time Configuration Manager Overview 9.2 RTCM Components 9.2.1 Customer Application Using Global Call RTCM 9.2.2 Global Call RTCM 9.2.3 RTCM Parameters 9.3 Using RTCM Parameters 9.3.1 Parameter Dependencies 9.3.2 Parameter Definitions 9.4 Getting and Setting Parameter Information 9.4.1 GC_PARM_BLK Data Structure 9.4.2 Control Parameters 9.4.2.1 Programming Mode 9.4.2.2 Timeout Option 9.4.2.3 Update Condition 9.5 Handling RTCM Errors 9.6 Configuration Procedure Real Time Configuration Management Figure 26. Run Time Configuration Procedure 9.7 Sample Scenarios Using the RTCM API Functions 9.7.1 Getting or Setting GCLib Configuration in Synchronous Mode 9.7.2 Getting or Setting CCLib Configuration in Synchronous Mode 9.7.3 Getting or Setting Line Device Configuration in Synchronous Mode Page 9.7.4 Setting Line Device Configuration in Asynchronous Mode 9.7.5 Setting Board Device Configuration in Asynchronous Mode (IP Technology) Page Page 10.1 Service Request Overview 10.2 10.3 Service Request Data 10.4 General Service Request Scenario Handling Service Requests Figure 33. Generic Service Request Operation Call Transfer 11.1 Introduction to Call Transfer 11.1.1 Blind Call Transfer Figure 34. Blind Call Transfer (Unsupervised Transfer) 11.1.2 Supervised Call Transfer 11.2 Call Transfer State Machine Table14. New Global Call Transfer Call States Figure 36. Call State Model for Blind Call Transfer at Party A Transferring Party (Party A) Figure 37. Call State Model for Blind Transfer at Party B Transferred Party (Party B) Transferring Party (Party A) Call 1 Call 2 Figure 39. Call State Model for Supervised Transfer at Party B Call 1 Transferred Party (Party B) Call 3 Figure 40. Call State Model for Supervised Transfer at Party C Call 2 Call 3 Transferred-To Party (Party C) 12.1 Compiling and Linking 12.1.1 Include Files 12.1.2 Required Libraries 12.1.3 Variables for Compiling and Linking Commands 12.1.4 Dynamically Loaded Libraries Page Page Glossary Page Page Page Page Page Page Page Index A B C D F G I L M P R S T U