5.1 TRAU Exerciser Program

5.2 Using the TRAU Exerciser Program

5.1 TRAU Exerciser Program

After initializing the system hardware with agmon, run the TRAU Exerciser (trauxsr) program to verify that the NMS board DSPs can run AG TRAU programs. The TRAU Exerciser program is a looping demonstration program that repeatedly loads, attaches, enables, disables, detaches, and unloads the maximum number of channels the host system can support.

Note: The TRAU Exerciser program does not test MVIP communication paths (for example, connections between NMS board PSTN line interfaces and DSP resources).

trauxsr starts the maximum number of TRAU channels the NMS board can support. This depends on:

• The type of AG TRAU programs trauxsr loads (for example G.723.1 or G729A).

• The number of DSPs on the NMS board.

5.2 Using the TRAU Exerciser Program

trauxsr

Demonstrates the ability of Fusion vocoder DSP programs to encode and decode data.

trauxsr vocfile loopcount

trauAttach, trauDetach, trauDisable, trauEnable, trauLoad, trauReleaseBuffer, trauUnload, trauShowDSPInfo, and trauRegisterCallback (for Host-based Fusion configurations)

Verifies that AG TRAU channels can be loaded, attached, and enabled on NMS board DSPs.

Before running trauxsr:

• Edit one of the provided agmon configuration (ag.cfg) files to indicate any system-specific configuration information.

• (Optional) Compile the file trauxsr.c using nmake. A compiled executable is also provided.

• Run agmon with the customized ag.cfg file.
  Note: For information about the Fusion vocoder files available on your system, view the appropriate readme_vocodername.txt file (for example, readme_g729a.txt) in the Fusion docs directory.

To run trauxsr:

1. From the command line, navigate to the nms\fusion\samples\general\trauxsr directory (or the opt/nms/fusion/samples/general/trauxsr directory under Unix).

2. Enter the following:
   trauxsr vocfile loopcount
   Where vocfile is the filename of the AG TRAU program to be run, and loopcount indicates the number of times to exercise each
   AG TRAU program.
   trauxsr uses ctaCreateQueue, ctaCreateContext, and ctaOpenService to create CTA queues, contexts, open CTA services for AG TRAU channels. It then loads, attaches and enables AG TRAU channels with trauLoad, trauAttach, and trauEnable. As soon as the maximum number of channels have been attached and enabled, trauxsr disables and detaches the channels, and unloads the AG TRAU channels with trauDisable, trauDetach, and trauUnload. The program exercises each
   AG TRAU program the number of times specified by loopcount.
   As trauxsr executes, it displays results of AG TRAU function calls at the command prompt, and displays status and switching information about AG TRAU programs and channels.

3. To stop the program before the end of the its cycle, enter CTRL+C.

trauxsr loads and enables the maximum supported number of
AG TRAU channels for the number of iterations specified by loopcount. The command line interface shows the progress of AG TRAU commands as they execute.

For more information about running agmon, refer to the AG Runtime Configuration and Developer's Manual.

When the trauxsr stops running in the middle of a cycle, this usually means an expected event has not been received. This may occur because of a configuration error or software mismatch. Check configuration files, runtime files, and DLL dates (make sure the PATH environment variable does not redirect the system to an older file).