(Page 1 of 1 in this chapter) Version

Chapter 7

Demonstration Programs

7.1 Introduction

7.2 Demonstration Programs

: 7.2.1 Conferencing: conf90
: 7.2.2 Call Control: ctaset
: 7.2.3 Call Control: rawdrvr

7.1 Introduction

This chapter presents the demonstration programs and utilities shipped with the AG Connect driver software.
The driver software includes source code for all demonstration programs. Each demonstration program is shipped as source code, with makefiles. To use a demonstration program, first compile it as described in the sections below.
Before you start the demonstration programs, ensure that: CT Access is properly installed. MVIP switching is correctly configured.

7.2 Demonstration Programs

The following demonstration programs are provided with CX 1000 software: Program Description conf90 Multi-party telephone conferencing demonstration. incta Inbound or outbound call demonstration. rawdrivr Raw driver MVIP connection setup demonstration.

Program	Description
`conf90`	Multi-party telephone conferencing demonstration.
`incta`	Inbound or outbound call demonstration.
`rawdrivr`	Raw driver MVIP connection setup demonstration.

7.2.1 Conferencing: conf90

Option	Description
`-b` n	Specifies the AG-8 board number n. Default = `0.`
`-c` conference	Specifies the conference driver used in the demo. Default=`agcxsw.`
`-h`	Causes `conf90` to display usage message, and terminate.
`-n` n	Specifies the number n of the board supporting conferencing. Default=`0.`
`-l` m	Specifies the number of lines m connected to the AG-8.
`-p` protocol	Specifies the protocol to run. Default = `lps0.`
`-s` stream:slot	Specifies the port (DSP) address. Default = `0:0`.

Description

This program demonstrates multiparty telephone conferencing. The conferencing chip on the CX 1000 board performs the actual conferencing function. The AG-8 board supplies telephone interfaces. MVIP switching is performed on the CX 1000 board's FMIC chip.
You take a handset off-hook and enter three DTMF digits as the address. You hear a message, informing you about the status of all conferences in use (the number of people in each conference, if any).
After the message, the program prompts you to enter the number of a conference to connect to. The program waits for three seconds. If no digits are entered, it disconnects the call. If you enter an invalid conference number, the program asks you to re-enter it.
When you enter a valid number, the program connects you to the conference you requested.
You can make as many connections to the conferencing demonstration as the number of incoming lines you specified at the command line.

Procedure

The following procedure assumes that the AG-8 board has loop start hybrids set up to accept incoming calls.
To run conf90: Run the agmon utility to load the AG-8 driver and configure the AG-8. Start conf90 by entering the following at the prompt: conf90 -p lps0 -l lines -c driver ...where lines is the number of phone lines connected to the AG-8 board, and driver is the driver for the conferencing board you are using. The program starts up and waits for incoming calls. Take the handset off-hook. The loop start is acknowledged. Enter three DTMF digits as the address. You hear a message, informing you about the status of all conferences in use (the number of people in each conference, if any). The program then prompts you to enter the number of a conference to connect to. Using your phone keyboard, enter a conference number in a suitable range: Board Range AG Conference board 20 to 61 CX 1000 20 to 40 WTI-8 20 to 40 The program waits for three seconds. If no digits are entered, the program disconnects the line. If you enter an invalid conference number, the program asks you to re-enter it. When you enter a valid number, the program connects you to the desired conference. Make as many connections to the conferencing demonstration as you have specified on the command line (with the -l option). To exit a conference, hang up.

Board	Range
AG Conference board	20 to 61
CX 1000	20 to 40
WTI-8	20 to 40

Compilation

conf90 is supplied in source form. To compile conf90, do one of the following: Under this OS... Go to this directory... Enter... Windows NT c:\nms\agcx\demos\conf90 nmake -f makefile OS/2 c:\nms\agcx\demos\conf90 makedemo -f makefile UNIX /opt/nms/agcx/demos/conf90 make -f makefile
For more information, see the readme file that came with the CX 1000 software package.

Under this OS...	Go to this directory...	Enter...
Windows NT	`c:\nms\agcx\demos\conf90`	`nmake -f makefile`
OS/2	`c:\nms\agcx\demos\conf90`	`makedemo -f makefile`
UNIX	`/opt/nms/agcx/demos/conf90`	`make -f makefile`

7.2.2 Call Control: ctaset

Name

ctaset

Purpose

Demonstrates how to perform call control with a CX 1000 board, using the DSP resources of another board.

Featured Functions

swiGetLocalTimeslotInfo, swiMakeConnection, swiOpenSwitch, swiResetSwitch, swiSendPattern

Requirements

This demonstration requires the following configuration (see Figure 26): One of the following AG DSP boards configured as the MVIP clock slave: AG-24, AG-30, AG-48 or AG-60. CX 1000 board, configured as the MVIP clock master. MVIP bus cable connecting the two boards. A 2500-type telephone set, connected to the CX 1000 board. An adapter cable and power supply, to provide power to the telephone set. CT Access and the ADI, Switching, and Voice Message services. Figure 26. ctaset Demonstration Program Hardware Configuration
Notes on configuring your boards and software: Other than the boards used in the demonstration, no other boards should be connected to the MVIP bus. Make sure that the encoding law selected for the two boards is the same (a-law or mu-law). To select the encoding law for your CX 1000 board, run the configuration program or script as described in Chapter 3. To select the law for your other board, see its installation manual. Note that AG-24 boards are configured for mu-law by default. AG-48 boards are configured for a-law by default. This program uses another demonstration program (either incta or outcta) to perform call control. The program to use is specified on the command line (see below). The program must be in the path, in executable form. For more information about the incta or outcta demonstration programs refer to the CT Access Developer's Reference Manual. Make sure the TCP specified in the AG configuration file matches the type of CX 1000 line interface you will be using. For example, if your board contains loop start line interfaces, the AG configuration file should specify: TCP=lps0.tcp. (AG-60 boards only) For ctaset to work, the AG-60 board's DSP resources must be nailed up to MVIP bus streams 1, 2, 4, and 5; NOT 3, 4, 6, and 7.

Usage

ctaset [options] [programoptions]
where options are: Option Description -r program Specifies the program to use for call control: either incta or outcta.
and where programoptions include: Option Description -b board Specifies the AG board number. Default = 0. -s stream:slot Specifies the MVIP address of the line interface to which the telephone is connected. Default = 18:0. -p protocol Specifies the protocol to run. Must match the type of line interface to which the telephone is connected. Default = wnk0. lps0 and did0 are also supported.

Option	Description
`-r` program	Specifies the program to use for call control: either `incta` or `outcta`.

Option	Description
`-b` board	Specifies the AG board number. Default = 0.
`-s` stream:slot	Specifies the MVIP address of the line interface to which the telephone is connected. Default = `18:0`.
`-p` protocol	Specifies the protocol to run. Must match the type of line interface to which the telephone is connected. Default = `wnk0`. `lps0` and `did0` are also supported.

Description

This program sets up your system so that the incta or outcta demonstration programs can run using the CX 1000 line interfaces and the DSP resources of an AG-24, AG-30, AG-48, or AG-60 resource board, connected to the CX 1000 over the MVIP bus. These resources are used for tone detection, and to record and play voice files.
ctaset initializes CT Access, sets the MVIP clock, enables phones attached to the CX 1000, and makes the switch connections needed to connect CX 1000 line interfaces to the DSP resources on the other card.
ctaset then calls incta or outcta, depending upon your selections on the command line. For more information about incta or outcta, refer to the CT Access Developer's Reference Manual.

Procedure

To run ctaset: Set up your AG configuration file so the wnk0, lps0, or did0 TCP is transferred to the AG-24/30/48/60 board when agmon runs. For more information about AG configuration files, see your AG Runtime Configuration and Developers Manual. Start ctaset by entering: ctaset options For example, the following command line specifies that ctaset is to call incta using CX 1000 line interface 1, wink start protocol: ctaset -r incta -s 18:2 -p wnk0 The following prompt appears: Start AG DSP board in another window, then press any key to continue... Open another DOS window and start agmon with a specified AG configuration file. For example: agmon -f ag24.cfg agmon downloads the TCP to the AG DSP board (in this case an AG-24). Return to the first window and press any key. ctaset now initializes incta or outcta. Follow one of the following procedures, depending upon which program you chose:
ctaset with incta

Take the handset off-hook. The wink start is acknowledged.

Enter three DTMF digits as the address.

If the first digit is...

Then the demonstration releases the call...

8

By playing a reorder tone.

9

With a busy tone.

0

By playing a "special information tone."

Otherwise, the call is connected and the demonstration proceeds into the Conversation state. If the first digit in the step above is not 8, 9 or 0, you hear a prompt to record voice, play back your recorded sample, or hang up.

Select the record voice option.

You hear the record beep prompt.

Begin speaking after the prompt.

The record operation terminates after you stop speaking and you are returned to the options menu.

Select the playback option.

The sample you just recorded will be played back. You are returned to the options menu.

Select the hang-up option.

You hear "good-bye" and the line hangs up.
ctaset with outcta

Lift the handset and replace it to simulate a wink from the network.

ADIEVN_PLACING_CALL event is displayed as the ADI service dials the digits.

Lift the handset to simulate network answer.

You hear the greeting message and the menu message.

Dial 1 to record a message.

Begin speaking after the beep.

Recording ceases shortly after you stop speaking. You hear the menu message again.

Dial 2 to play back what you recorded.
For more information about using agmon, refer to the AG Runtime Configuration and Developer's Manual. For more information about incta or outcta, refer to the CT Access Developer's Reference Manual.

If the first digit is...	Then the demonstration releases the call...
8	By playing a reorder tone.
9	With a busy tone.
0	By playing a "special information tone."

Compilation

ctaset is supplied in source form. To compile ctaset, do one of the following: Under this OS... Go to this directory... Enter... Windows NT c:\nms\agcx\demos\ctaset nmake -f makefile OS/2 c:\nms\agcx\demos\ctaset makedemo -f makefile UNIX /opt/nms/agcx/demos/ctaset make -f makefile
For more information, see the readme file that came with the CX 1000 software package.

Under this OS...	Go to this directory...	Enter...
Windows NT	`c:\nms\agcx\demos\ctaset`	`nmake -f makefile`
OS/2	`c:\nms\agcx\demos\ctaset`	`makedemo -f makefile`
UNIX	`/opt/nms/agcx/demos/ctaset`	`make -f makefile`

7.2.3 Call Control: rawdrvr

Name

rawdrvr

Requirements

This demonstration requires a CX 1000 board.

Purpose

Sets up switch connections using raw MVIP-90 driver commands.

Usage

rawdrvr [options] Option Description -d driver_name Driver name (default = agcxsw). -b board_no Board number (default = 0). -i stream:timeslot Input stream:timeslot (default = 0:0). -o stream:timeslot Output stream:timeslot (default = 1:1).

Option	Description
`-d` driver_name	Driver name (default = `agcxsw`).
`-b` board_no	Board number (default = `0`).
`-i` stream`:`timeslot	Input stream:timeslot (default = `0:0`).
`-o` stream`:`timeslot	Output stream:timeslot (default = `1:1`).

Description

Using raw MVIP-90 driver commands, establishes a switch connection between a specified incoming stream:timeslot and an outgoing stream:timeslot.

Procedure

To run rawdrvr: Start rawdrvr by entering the following at the prompt (this example connects incoming stream:timeslot 1:2 to outgoing stream:timeslot 2:3): rawdrvr -d agcxsw -b 0 -i 1:2 -o 2:3 The following prompt appears: Command finished successfully. Run the showcx95 utility to check the established connection.
For more information about MVIP raw driver commands, refer to the MVIP-90 specifications.

Compilation

rawdrvr is supplied in source form. To compile rawdrvr, do one of the following: Under this OS... Go to this directory... Enter... Windows NT c:\nms\agcx\demos\rawdrvr nmake -f makefile OS/2 c:\nms\agcx\demos\rawdrvr makedemo -f makefile UNIX /opt/nms/agcx/demos/rawdrvr make -f makefile
For more information, see the readme file that came with the CX 1000 software package.

Under this OS...	Go to this directory...	Enter...
Windows NT	`c:\nms\agcx\demos\rawdrvr`	`nmake -f makefile`
OS/2	`c:\nms\agcx\demos\rawdrvr`	`makedemo -f makefile`
UNIX	`/opt/nms/agcx/demos/rawdrvr`	`make -f makefile`

(Page 1 of 1 in this chapter) Version

tech_support@nmss.com