Table of Contents Index NMS Glossary Previous Page Next Page Version


Appendix D

Demonstration Programs and Utilities


Multiple Pool Demonstration Program: c6t2tivr
DSP Module Description Utility: f54info
Display Flash Memory and RAM: cg6ktool
CG Board Trace Utility: cgtrace

Multiple Pool Demonstration Program: c6t2tivrTop of Page

Name

c6t2tivr

Purpose

Provides an example of how multiple pools on the CG 6100C board can be used to place a calling card or credit card call.

Usage

c6t2tivr -b boardnum options

where boardnum is the CG 6100C board number (0 by default) and options are:
Option

Description

-A [adi_mgr]

CTA manager to use for ADI service.

-b [board number]

OAM board number.

-s [incoming, outgoing]

Incoming and outgoing DSP timeslots.

-i [incoming protocol]

Incoming protocol to run.

-o [outgoing protocol]

Outgoing protocol to run.

-t [inbound_trunk]

Inbound trunk to use.

-T [outbound_trunk]

Outbound trunk to use.

-n [number_of_digits]

Number of digits to get from user.

Procedure

To run c6t2tivr, enter the following command on the command line:

c6t2tivr

Description

c6t2tivr demonstrates the transfer of a single call received over an incoming line to an outgoing call placed over an outgoing line. This call transfer uses the IVR resources from a third pool to get the number to dial. Separate pools of DSP resources are used for the setup and tear down of the call.

From CTADEMO.VOX use the generic prompt for demo use, GETEXT.

Details

c6t2tivr defaults to trunk 0 for the incoming trunk and trunk 10 for the outgoing trunk. The demo was tested using a CG 6000 board to place the call to trunk 0 on the CG 6100C board and to receive a call from trunk 10 of the CG 6100C board.

The CG 6100C board associates timeslots with pools. c6t2tivr uses timeslot 0 and pool 0 resources for receiving a call on trunk 0. The program uses timeslot 256 and pool 1 resources for placing the outgoing call on trunk 10 and timeslot 496 and pool 2 to play a prompt and get the phone number of the call to place. The IVR resources from pool 2 are released as soon as they are no longer needed.

DSP Module Description Utility: f54infoTop of Page

Name

f54info

Purpose

Parses the contents of a .f54 file and displays resources used by the DPFs associated with the specified DPM.

Usage

f54info f54name -t -d

or

f54info -a

where f54name is the name of a supported CG 6100C DPM file.

The options are:
Options

Description

-t

Displays information about DPFs associated with the specified DPM in a table format.

-d

Displays information about DPFs associated with the specified DPM.

-a

· Displays information about all DPFs in table format

· Processes all .f54 files that it finds in the current working directory

· Searches the path specified by the AGLOAD environment variable

Procedure

To run f54info, enter the following at the command line:

f54info -a

Description

Run f54info in order to display information about specific DPMs (.f54 files) that can run on CG 6100C DSP resources. f54info displays the following information:

For more information about managing on-board resources, refer to Appendix B.

Example: f54info dtmf -d

The following information appears:

NMS Communications Show F54 File Info            Version 1.00  Jan  27 2000

File name: C:\NMS\AG\LOAD\dtmf.f54
Revision : 0.2
Size     : 12964 bytes
Created  : Fri Jan 21 16:43:28 2000

FUNCTION STATE MIPS Msec In  Out Cmd Context Description
---------------------------------------------------------------------------
   807h   0   2.523  2   8v      16     113  DTMF, Silence, Cleardown
   801h   0   1.996  2   8v      16     113  DTMF only
   802h   0   0.773  2   8v      16     113  post-/pre- Silence only
   804h   0   1.359  2   8v      16     113  Cleardown only
   
POOL NAME                           SIZE  ADDRESS TYPE
------------------------------------------------------
.DTMF_TABLE                         1h       0h%    DATA_GLOBAL_FAST

SECTION NAME                        SIZE
----------------------------------------
.text                               e9h
The following table describes the output that appears:
Column

Description

Function

The lower byte is the DPF ID. The upper byte is the DPM family code.

STATE

There will be one row of resource information per state. STATE indicates the state number. A P in the STATE column indicates that the resources used are in the DPF persist mode.

MIPS

MIPS (millions of instructions per second) used by the DPF.

Msec

DPF period in ms.

In

Input Frame Size, in words. V indicates that the voice bit is set meaning that this queue is typically circuit switched.

Out

Output Frame Size, in words. V indicates that the voice bit is set meaning that this queue is typically circuit switched.

Cmd

Command packet size, in words.

Context

User context size, in words. The user context holds DPF static data.

Description

DPF functional description.

POOL NAME

Displays data pool definitions used by the DSP linker to relocate existing sections, or create new sections as scratchpad areas.

SECTION NAME

Only displayed with the -d option. The .text section is program code while other sections represent a user defined table.

Example: f54info crc -t

The following information appears:

NMS Communications Show F54 File Info            Version 1.00  Jan 27 2000

File name: C:\NMS\AG\LOAD\crc.f54
Revision : 0.2
Size     : 8154 bytes
Created  : Fri Jan 21 16:43:18 2000
                                              Slots     Memory       Packet
FUNCTION    Description               MIPS    In  Out   Data       Up  Down
---------------------------------------------------------------------------
  d08h      CRC Play mu-law           0.621   0   1     282         0    40
  d10h      CRC Play A-law            0.621   0   1     282         0    40
  d41h      CRC Record mu-law         0.621   1   0     245        40     0
  d42h      CRC Record A-law          0.621   1   0     245        40     0

Program Memory = 426 words

POOL NAME                           SIZE  ADDRESS TYPE
------------------------------------------------------
crcdebug                            100h    0h%   DATA
The output is similar to the preceeding table with the following changes:
Column

Description

MIPS

Prefaced with State number or Persist (P) mode. A single state is not displayed.

Slots

Circuit switched queues, as determined by the V (voice) bit. (Consumes timeslots.) V-bit set indicates a slot is used. Otherwise, the queue is assumed to be a packet (DSP to/from Host) queue.

Memory

Data

DPM instance context size in words. Obtained by summing data requirements of queues, command and context, plus instance overhead.

Packet

Up

If the V-bit is clear, the queue is assumed to be a packet queue. Packet Up displays DSP to Host frame size in words.

Down

If the V-bit is clear, the queue is assumed to be a packet queue. Packet Down displays Host to DSP frame size in words.

Note: Packet Up / Down sizes are cumulative. If there are more than one Up or Down queues, the sizes are summed.

The following table shows the ASCII string IDs associated with supported CG 6100C DPFs (in relation to their hexadecimal IDs):
ASCII ID String

Hexadecimal ID String

voice.rec_64

0x020B00

voice.rec_32

0x020A00

voice.rec_24

0x020900

voice.rec_16

0x020800

voice.play_64_100

0x020300

voice.play_64_150

0x021300

voice.play_64_200

0x022300

voice.play_32_100

0x020200

voice.play_32_150

0x021200

voice.play_32_200

0x022200

voice.play_24_100

0x020100

voice.play_24_150

0x021100

voice.play_24_200

0x022100

voice.play_16_100

0x020000

voice.play_16_150

0x021000

voice.play_16_200

0x022000

signal.xmt

0x050100

signal.rcv

0x050A00

signal.rcv_QA

0x050E00

callp.gnc

0x0a0000

tone.gen

0x0c0000

rvoice.play_mulaw

0x0d0800

rvoice.play_alaw

0x0d1000

rvoice.play_lin

0x0d2000

rvoice.rec_mulaw

0x0d4100

rvoice.rec_alaw

0x0d4200

rvoice.rec_lin

0x0d4400

rvoice.mu2mu

0x0d8900

rvoice.mu2a

0x0d8a00

rvoice.mu2lin

0x0d8c00

rvoice.a2mu

0x0d9100

rvoice.a2a

0x0d9200

rvoice.a2lin

0x0d9400

rvoice.lin2mu

0x0da100

rvoice.lin2a

0x0da200

rvoice.lin2lin

0x0da400

rvoice.passthru

0x0dc000

rvoice.passthru_play

0x0d0000

rvoice.passthru_rec

0x0d4000

dtmf.det_dtmf

0x080100

dtmf.det_sil

0x080200

dtmf.det_clrdwn

0x080400

dtmf.dtmf_sil_clrdwn

0x080700

dtmf.det_all

0x080F00

dtmfe.det_dtmf

0x080100

dtmfe.det_sil

0x080200

dtmfe.det_clrdwn

0x080400

dtmfe.dtmf_sil_clrdwn

0x080700

dtmf.det_sil_clrdwn_ced

0x080E00

dtmfe.det_all

0x080F00

mf.fdet_bcmpl

0x090A00

mf.bdet_fcmpl

0x090C00

mf.fdet_USA

0x090100

mf.fdet

0x090200

mf.bdet

0x090400

echo.ln20_apt100

0x160A00

echo.ln20_apt50

0x161A00

echo.ln20_apt25

0x162A00

echo.ln20_apt12

0x163A00

echo.ln16_apt100

0x160800

echo.ln16_apt50

0x161800

echo.ln16_apt25

0x162800

echo.ln16_apt12

0x163800

echo.ln10_apt100

0x160500

echo.ln10_apt50

0x161500

echo.ln10_apt25

0x162500

echo.ln10_apt12

0x163500

echo.ln8_apt100

0x160400

echo.ln8_apt50

0x161400

echo.ln8_apt25

0x162400

echo.ln8_apt12

0x163400

echo.ln6_apt100

0x160300

echo.ln6_apt50

0x161300

echo.ln6_apt25

0x162300

echo.ln6_apt12

0x163300

echo.ln4_apt100

0x160200

echo.ln4_apt50

0x161200

echo.ln4_apt25

0x162200

echo.ln4_apt12

0x163200

echo.ln2_apt100

0x160100

echo.ln2_apt50

0x161100

echo.ln2_apt25

0x162100

echo.ln2_apt12

0x163100

echo.ln24_apt100

0x164300

echo.ln24_apt50

0x165300

echo.ln24_apt25

0x166300

echo.ln24_apt12

0x167300

echo.ln32_apt100

0x164400

echo.ln32_apt50

0x165400

echo.ln32_apt25

0x166400

echo.ln32_apt12

0x167400

echo.ln40_apt100

0x164500

echo.ln40_apt50

0x165500

echo.ln40_apt25

0x166500

echo.ln40_apt12

0x167500

echo.ln48_apt100

0x164600

echo.ln48_apt50

0x165600

echo.ln48_apt25

0x166600

echo.ln48_apt12

0x167600

echo.ln64_apt100

0x164800

echo.ln64_apt50

0x165800

echo.ln64_apt25

0x166800

echo.ln64_apt12

0x167800

oki.play_24_100

0x1B0100

oki.play_24_150

0x1B1100

oki.play_24_200

0x1B2100

oki.play_32_100

0x1B0200

oki.play_32_150

0x1B1200

oki.play_32_200

0x1B2200

oki.rec_24

0x1B0900

oki.rec_32

0x1B0A00

ptf.det_2f

0x1c0700

ptf.det_4f

0x1c7700

wave.play_11_16b

0x1d0000

wave.play_11_8b

0x1d0100

wave.rec_11_16b

0x1d0800

wave.rec_11_8b

0x1d0900

adsir.rcv

0x190000

adsir_j.rcv

0x190000

adsix.xmt

0x1a0000

adsix_j.xmt

0x1a0000

nmsfax

0x1e0000

ima.play_24

0x260100

ima.play_32

0x260200

ima.rec_24

0x260900

ima.rec_32

0x260A00

gsm_ms.frgsm_play

0x270000

gsm_ms.frgsm_rec

0x270100

gsm_ms.frgsm_plimit

0x270200

gsm_ms.frgsm_vt_play

0x270A00

gsm_ms.frgsm_vt_rec

0x270B00

g723.play_53

0x2A0000

g723.rec_53

0x2A0100

g723.play_64

0x2a0200

g723.rec_64

0x2A0300

g723_53.vt_play

0x2A0A00

g723_53.vt_record

0x2A0B00

g723_63.vt_play

0x2A0C00

g723_63.vt_record

0x2A0D00

g729a.play

0x2B0000

g729a.record

0x2B0100

g729a.vt_play

0x2B0A00

g729a.vt_record

0x2B0B00

g726.play_32

0x0f0200

g726.rec_32

0x0f0a00

8tsignal.256p

0x55FF00

qtsignal.128p

0x557f00

f_g711.cod

0x400000

f_g711.dec

0x400100

f_g711.cod_rfc2833

0x400200

f_g711.dec_rfc2833

0x400300

f_frgsm.cod

0x410000

f_frgsm.dec

0x410100

f_frgsm.cod_rfc2833

0x410200

f_frgsm.dec_rfc2833

0x410300

f_ms.frgsm_cod

0x420000

f_ms.frgsm_dec

0x420100

f_ms.frgsm_cod_rfc2833

0x420200

f_ms.frgsm_dec_rfc2833

0x420300

f_g723.cod

0x430000

f_g723.dec

0x430100

f_g723.cod_rfc2833

0x430200

f_g723.dec_rfc2833

0x430300

f_g729a.cod

0x440000

f_g729a.dec

0x440100

f_g729a.cod_rfc2833

0x440200

f_g729a.dec_rfc2833

0x440300

f_faxt38.relay

0x450000

f_g726.cod

0x460000

f_g726.dec

0x460100

f_g726.cod_rfc2833

0x460200

f_g726.dec_rfc2833

0x460300

f_g728.cod

0x470000

f_g728.dec

0x470100

f_g728.cod_rfc2833

0x470200

f_g728.dec_rfc2833

0x470300

f_g729e.cod

0x480000

f_g729e.dec

0x480100

f_g729e.cod_rfc2833

0x480200

f_g729e.dec_rfc2833

0x480300

f_sx96.cod

0x490000

f_sx96.dec

0x490100

f_sx96.cod_rfc2833

0x490200

f_sx96.dec_rfc2833

0x490300

f_efrgsm.cod

0x4A0000

f_efrgsm.dec

0x4A0100

f_efrgsm.cod_rfc2833

0x4A0200

f_efrgsm.dec_rfc2833

0x4A0300

f_amr.cod

0x4B0000

f_amr.dec

0x4B0100

f_amr.cod_rfc2833

0x4B0200

f_amr.dec_rfc2833

0x4B0300

f_10ms_loop.g711

0x4d0000

f_10ms_loop.g711_mp

0x4d0100

f_10ms_loop.g729

0x4d0200

f_10ms_loop.g729_mp

0x4d0300

f_20ms_loop.g711

0x4e0000

f_20ms_loop.g711_mp

0x4e0100

f_20ms_loop.gsm

0x4e0200

f_20ms_loop.gsm_mp

0x4e0300

f_30_loop.g711

0x4f0000

f_30_loop.g711_mp

0x4f0100

f_30_loop.g723

0x4f0200

f_30_loop.g723_mp

0x4f0300

unique0.unique0

0x560800

unique1.unique1

0x570800

Display Flash Memory and RAM: cg6ktoolTop of Page

Name

cg6ktool

Purpose

Displays and modifies Flash memory and RAM contents on a CG 6100C board.

Usage

cg6ktool [ options ]

where options are:
Options

Description

-A

Lists the board's bus and slot information

-B -l<bus:slot>

Blinks board's blue LED light.

-R -l<bus:slot>

Resets a specified board.

-M <bus:slot> -a<startbyte> -n<numbbyes>

Dumps memory in binary to the file memdump.bin. If the starting byte (startbyte) and number of bytes (numbbyte) are not specified, the defaults are 0 and 16MB respectively.

-S -l<bus:slot>

Dumps error/stack information to the file errdump.txt.

-D -l<bus:slot>

Display flash block.

Note: This option also resets the specified board(s).

-F <bus:slot> -f<filename> -n<imgnumb>

Burn the flash memory of all detected CG 6100C boards with the specified file (filename) starting at the specified flash image number (imgnumb). The image number is 1s based, and the runtime core file is
image 2.

Note: If you burn the filename.hex file, this also burns the filename.sym file in the same directory.

-J -l<bus:slot> -n<imgnumb>

Erases the specified Flash image from memory for the specified board.

Note: The image number is 1s based.

-e <PCI subsystem id>

For CG 6100C the PCI subsystem ID is 6100.

Applies the specified command to all CG 6100C boards in the chassis.

-h

Help.

Description

cg6ktool is used to display non-volatile (flash) memory contents, burn new images into Flash, and dump on-board error log.

The following rules apply to burning flash memory:

CG Board Trace Utility: cgtraceTop of Page

Name

cg6trace

Purpose

Enables debugging of CG 6100C board output.

Usage

cgtrace -bboardnum options

Where boardnum is the CG 6100C board number (0 by default) and options are:
Option

Description

-g[globalmask]

Global trace mask in hexadecimal format.

-q[query]

Global trace masks and manager IDs.

-m[managernum]

Manager number in hexadecimal format.

-t[managermask]

Manager trace mask number in hexadecimal format.

-i[intparm]

Optional Int32 parameter in decimal format.

-s[stringparm]

Optional string parameter.

Description

Enables debugging output for various on-board software components (managers). The resulting debug output appears in the oammon display.

Procedure:

To run cgtrace, enter the following after a board has been booted:

cgtrace -bboardnumber options

A About

M Display Manager Info

S Send New Mask

R Refresh Manager List

G Change Global Trace Mask

Q Quit

Enter one of the following commands:
Command

Description

A

Displays basic information about this cgtrace.

M

Displays a list of on-board managers. Select a manager by number to display more detailed information about its tracing capabilities.

S

Sends a tracing mask down to a selected manager. Output resulting from this tracing mask appears in the oammon display.

R

Refreshes the manager list from the board.

G

Sends a global trace mask down to the board. Output resulting from this tracing mask appears on the oammon display.

Q

Exits the program.

Details

Use the M command to display a list of on-board managers for which tracing can be enabled. When you specify the manager, cgtrace displays a list of trace options for that manager.

For example, selecting the Filter Manager, displays the following trace options:

00000001: Trace Commands
00000002: Object Creates and Destroys
00000004: Object Starts and Stops
00000010: Extra Pin Connect and Disconnect Errors

Each of these lines describes a tracing option that can be enabled for the Filter Manager. Combine (OR) the options together to get a 32-bit tracing mask, then use the S command to send the mask down to the manager. For example, if you wanted to enable command tracing and object starts and stops for the Filter Manager, you would use the tracing mask 00000005.

Some useful options to use with cgtrace include:
Option

Description

cgtrace -bboardnum -g100

Traces messages to and from the host.

cgtrace -bboardnum -g80000000

Prints out an estimate of the amount of available board memory.



Table of Contents Index NMS Glossary Previous Page Next Page Version


Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2001, NMS Communications Corporation. All rights reserved.