Intel 05-1662-005 User Manual

IP Gateway (Global Call)

Demo Guide

for Linux and Windows

05-1662-005

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. Intel products are not intended for use in medical, life saving, or life sustaining applications.

Intel may make changes to specifications and product descriptions at any time, without notice. This document as well as the software described in it is furnished under license and may only be used

or copied in accordance with the terms of the license. The information in this manual is furnished for

informational use only, is subject to change without notice, and should not be construed as a commitment by Intel Corporation. Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document.

Except as permitted by such license, no part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means without express written consent of Intel Corporation.

InstantIP, Intel, Intel Centrino, Intel Centrino logo, Intel logo, Intel386, Intel486, Intel740, IntelDX2, IntelDX4, IntelSX2, Intel Inside, Intel Inside logo, Intel NetBurst, Intel NetMerge, Intel NetStructure, Intel SingleDriver, Intel SpeedStep, Intel StrataFlash, Intel Xeon, Intel XScale, IPLink, Itanium, MCS, MMX, MMX logo, Optimizer logo, OverDrive, Paragon, PDCharm, Pentium, Pentium II Xeon, Pentium III Xeon, Performance at Your Command, skoool, Sound Mark, The Computer Inside., The Journey Inside, VTune, and Xircom are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

*Other names and brands may be claimed as the property of others. Publication Date: July, 2005 Intel Converged Communications, Inc.

1515 Route 10 Parsippany NJ 07054

For Technical Support, visit the Intel Telecom Support Resources website:

http://developer.intel.com/design/telecom/support/

For Products and Services Information, visit the Intel Telecom Products website:

http://www.intel.com/design/network/products/telecom

For Sales Offices, visit the Where to Buy Intel Telecom Products page:

http://www.intel.com/buy/networking/telecom.htm

Table of Contents

1. About This Guide............................................................................................ 1

1.1. Purpose........................................................................................................... 1

1.2. Intended Audience ......................................................................................... 1

1.3. Related Documents ........................................................................................ 1

2. Demo Description............................................................................................ 3

2.1. About the Demo............................................................................................. 3

2.2. Choosing Channels ........................................................................................ 3

3. System Requirements ..................................................................................... 5

3.1. Hardware Requirements.................................................................................5

3.2. Software Requirements.................................................................................. 5

4. Preparing to Run the Demo ........................................................................... 7

4.1. Connecting to External Equipment............................................................... 7

4.2. Editing Configuration Files............................................................................9

4.2.1. Configuration File Location.................................................................. 9

4.2.2. Editing the gateway_r4.cfg File .......................................................... 10

5. Running the Demo ........................................................................................ 17

5.1. Starting the Demo ........................................................................................ 17

5.2. Demo Options .............................................................................................. 17

5.3. Using the Demo ........................................................................................... 20

5.4. Stopping the Demo....................................................................................... 20

6. Demo Details..................................................................................................21

6.1. Files Used by the Demo............................................................................... 21

6.1.1. Demo Source Files .............................................................................. 21

6.1.2. Utility Files.......................................................................................... 23

6.1.3. PDL Files............................................................................................. 24

6.2. Handling an Incoming Call.......................................................................... 25

6.2.1. Receiving a Call .................................................................................. 25

6.2.2. Handling a PSTN Call.........................................................................25

6.2.3. Handling an IP Call............................................................................. 26

6.3. Programming Model .................................................................................... 26

6.4. Initializations................................................................................................ 27

6.5. Event Mechanism ........................................................................................ 29

iii

IP Gateway (Global Call) Demo Guide for Linux and Windows

6.5.1. Handling Keyboard Input Events........................................................ 29

6.5.2. Handling SRL Events.......................................................................... 29

6.5.3. Handling Application Exit Events.......................................................30

6.6. Demo State Machine.................................................................................... 30

6.6.1. Call Establishment from IP ................................................................. 30

6.6.2. Call Establishment from PSTN ........................................................... 32

6.6.3. Call Teardown..................................................................................... 33

6.6.4. Glare Conditions ................................................................................. 34

Appendix A - Log File of IP Call Establishment............................................. 35

Appendix B - Log File of PSTN Call Establishment....................................... 39

Index....................................................................................................................45

List of Tables

Table 2. Command Line Switches ...................................................................... 18

Table 3. Runtime Keyboard Commands............................................................. 20

Table 4. Source Files Used by the IP Gateway (Global Call) Demo .................. 21

IP Gateway (Global Call) Demo Guide for Linux and Windows

List of Figures

Figure 1. Hardware Configuration with Onboard NIC and PSTN Front End....... 7

Figure 2. Hardware Configuration with Onboard NIC and separate PSTN

board..............................................................................................................8

Figure 3. Typical Topology .................................................................................. 9

Figure 4. Programming Model............................................................................ 26

Figure 5. Call Establishment from IP.................................................................. 31

Figure 6. Call Establishment from PSTN............................................................ 32

vii

IP Gateway (Global Call) Demo Guide for Linux and Windows

viii

1. About This Guide

This section describes the purpose of this guide, the intended audience, and references to other documents that may be useful to the user.

1.1. Purpose

This guide describes the operation of the IP Gateway (Global Call) demo.

1.2. Intended Audience

This guide is intended for application developers who will be developing a PSTN-IP gateway application using the Global Call API.

Developers should be familiar with the C programming language and either the Windows or Linux programming environment.

1.3. Related Documents

See the following for more information:

• The Release Update for your system release for information on problems

fixed, known problems, workarounds, compatibility issues, and last minute updates not documented in the published information.

• The appropriate Configuration Guide for your hardware (Intel NetStructure

IPT Series or DM/IP Series board) and operating system

• Global Call API Software Reference Guide and the Global Call Application

Developer’s Guide

• Global Call IP Technology User’s Guide

• http://developer.intel.com/design/telecom/support/ (for technical support)

• http://www.intel.com/design/network/products/telecom (for product

information)

IP Gateway (Global Call) Demo Guide for Linux and Windows

2. Demo Description

2.1. About the Demo

The IP Gateway (Global Call) demo is a host-based application that demonstrates using the Global Call API to build a PSTN−IP gateway. The demo source code can be used as sample code for those who want to begin developing an application from a working application. The demo is not designed to implement a complete gateway, lacking features such as least-cost routing, etc.

The IP Gateway (Global Call) demo is a cross-OS demo, running under the Windows* or Linux* environments. Most of the differences in the environments are handled directly by the programming interface and are transparent to the user. Other differences, due to inherent differences in the operating systems, are handled by the Platform Dependency Library (PDL).

For more information about the PDL refer to the source code in the pdl_win or pdl_linux directories.

2.2. Choosing Channels

When a call comes from the PSTN, the call is answered by a PSTN line device. During initialization, the PSTN channel was associated with a specific IP line device, so the call is connected to the IP line device that is associated with this PSTN line device.

When a call arrives from the IP network, there is no direct association of a channel, since there are no individual physical connections for the IP channels. The call is answered by a line device. During initialization, the line device was associated with a specific PSTN line device. The Global Call API tells the IP Gateway (Global Call) demo which PSTN channel is associated with this IP channel. The application then connects the IP call to the appropriate PSTN channel.

IP Gateway (Global Call) Demo Guide for Linux and Windows

3. System Requirements

This chapter discusses the system requirement for running the IP Gateway (Global Call) demo. It contains the following topics:

• Hardware Requirements

• Software Requirements

3.1. Hardware Requirements

To run the IP Gateway (Global Call) demo, you need:

• One of the following:

• Intel NetStructure® DM/IP Series board

• Intel NetStructure® IPT Series board

• an IPT Series board also requires an Intel NetStructure® DM/V-A

series board for PSTN connection

• IP Network cable

For other hardware requirements, such as memory requirements, see the Release Guide for your system release.

3.2. Software Requirements

To run the IP Gateway (Global Call) demo, you need the Intel® Dialogic® System Release 6.x for the Linux* or Windows* Operating Systems on Intel Architecture. For a list of operating system requirements and supported compilers see the Release Guide for your system release.

IP Gateway (Global Call) Demo Guide for Linux and Windows

4. Preparing to Run the Demo

This chapter discusses how to prepare to run the IP Gateway (Global Call) demo. It provides information about the following topics:

• Connecting to External Equipment

• Editing Configuration Files

4.1. Connecting to External Equipment

There are two possible hardware configurations for the IP Gateway (Global Call) demo:

• Intel NetStructure® DM/IP series board(s) with on-board NIC and a PSTN

connection on the front end

• Intel NetStructure® IPT series board(s) with on-board NIC connected to an

Intel NetStructure® DM/V-A series board as the PSTN interface

The following diagrams illustrate the possible hardware configurations.

Ethernet

PBX

Telephone

Intel NetStructure® IP board

with on-board NIC and a

PSTN connection on the front end

Figure 1. Hardware Configuration with Onboard NIC and PSTN Front

End

IP Gateway (Global Call) Demo Guide for Linux and Windows

Intel NetStructure®

DM/V-A series board

CTbus

cable

PSTN

line

Intel NetStructure®

IPT board

Internet/

Intranet line

Figure 2. Hardware Configuration with Onboard NIC and separate

PSTN board

The IP Gateway (Global Call) demo allows you to connect to gateways on an IP network and establish voice calls via the IP network. It also allows you to connect to H.323 terminals on the IP network and connect a call from the terminal to a telephone via one of the gateways. Figure 3 shows a typical topology for demonstrating the capabilities of the IP Gateway (Global Call) demo. Note that the two PBXs that are shown can be a single PBX. Also note that more than one PSTN line can be connected to a single gateway.

PBX

IP Gateway

IP Network

4. Preparing to Run the Demo

FaxFax

IP Gateway

PBX

Telephone

H.323 Terminal

Telephone

Figure 3. Typical Topology

4.2. Editing Configuration Files

This section discusses how to configure the demo for your system. It contains the following topics:

• Configuration file location

• Editing the gateway_r4.cfg File

4.2.1. Configuration File Location

Before running the IP Gateway (Global Call) demo, modify the gateway_r4.cfg file to reflect your system environment. Use a text editor and open the file from:

• Windows:

$(INTEL_DIALOGIC_DIR)\samples\ipt_demos\gateway_r4\Release

• Linux:

$(INTEL_DIALOGIC_DIR)/ipt_demos/gateway_r4/Release

where $(INTEL_DIALOGIC_DIR) identifies the base directory where the Intel Dialogic System Release was installed.

+ 39 hidden pages