(Page 1 of 1 in this chapter)

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 AG Connect.
AG Connect is shipped with source code for all demonstration programs. Each demonstration program is shipped as an executable program and with its source and makefiles.
Before you start the demonstration programs, ensure that: CT Access is properly installed. The AG board is executing. MVIP switching is correctly configured.
Refer to the appropriate installation manual for your operating system for details on installation.

7.2 Demonstration Programs

The following demonstration programs are provided with AG Connect: 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`.

Featured Functions

adiFlushDigitQueue, ctaSetErrorHandler, ctaWaitEvent, swiCallDriver, swiDisableOutput, swiGetLastError, swiMakeConnection, swiOpenSwitch, swiResetSwitch

Description

This description applies to the loop start protocol did0.
When you take a handset off-hook, the TCP acknowledges the line seizure.
After the seizure, 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.
To exit a conference, hang up.

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 AG Connect 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
AG Connect	20 to 40
WTI-8	20 to 40

7.2.2 Call Control: ctaset

Name

ctaset

Requirements

This demonstration requires the following: One of the following AG DSP boards configured as the MVIP clock slave: AG-24, AG-30, AG-8 or AG-T1. AG Connect board, configured as the MVIP clock slave. MVIP bus cable connecting the two boards. A2500-type telephone set, connected to the AG Connect board. CT Access and the ADI, Switching, and Voice Message services.

Purpose

Initializes CT Access, sets the MVIP clock, enables OWS, makes a switch connection. Calls a specified program (incta or outcta) to receive an inbound call or place an out bound call. CT Access performs call control, while the AG Connect board acts as the line interface and an AG DSP board performs DSP functions.
For more information about the incta or outcta demonstration programs refer to the CT Access Developer's Reference Manual.

Usage

ctaset [options] [programoptions]
where options are: Option Description -r program Specifies the program to run: either incta or outcta.
and where programoptions include: Option Description -s stream:slot *Specifies the port (DSP) address. Default = 18:0. -p protocol ¹Specifies the protocol to run. Default = wnk0. lps0 and did0 are also supported. ¹ These are standard incta and outcta options.

Option	Description
`-r` program	Specifies the program to run: either `incta` or `outcta`.

Option	Description
`-s` stream:slot	*Specifies the port (DSP) address. Default = `18:0`.
`-p` protocol	¹Specifies the protocol to run. Default = `wnk0`. `lps0` and `did0` are also supported.

Featured Functions

swiGetLocalTimeslotInfo, swiMakeConnection, swiOpenSwitch, swiResetSwitch, swiSendPattern

Description

When you take the handset off-hook, the TCP acknowledges the line seizure.
After the seizure, enter three DTMF digits as the address. Depending upon the first digit entered, you hear a reorder tone, busy tone or the digits spoken to you. If the call is connected, the demonstration proceeds into the Conversation state.
Once in the Conversation state, the demonstration speaks the three-digit address you entered.
After speaking the digits, you are prompted for one of the following options: Record a short sample of your voice after which you are returned to the option prompt. Play back the sample you recorded in the first option. Hang up the line.

Procedure

The following procedure assumes that you have an AG-24 and an AG Connect board connected over the MVIP bus, and you have a 2500-type telephone connected to the AG Connect line interface 1.
To run ctaset: Set up your AG configuration file so the wnk0, lps0, or did0 TCP is transferred to the board when agmon runs. For more information about AG configuration files, see your AG Runtime Configuration and Developers Manual. Start ctaset by entering the following at the prompt (this example uses incta and the wink start protocol): ctaset -r incta -s 18:2 -p wnk0 Note: In this example timeslot 2 is an OWS hybrid for AG Connect boards. 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 wink start TCP to the AG DSP board (in this case an AG-24). Return to the first window and press any key. 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.
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."

7.2.3 Call Control: rawdrvr

Name

rawdrvr

Requirements

This demonstration requires an AG Connect 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 showconx utility to check the established connection.
For more information about MVIP raw driver commands, refer to the MVIP-90 specifications.

(Page 1 of 1 in this chapter)

tech_support@nmss.com