Version

Appendix D

Utilities

Displaying DPF File Resource Usage: f54info

Displaying Flash Memory, EEPROM, and RAM: cg6ktool

Performing CG Board Debugging: cgtrace

Displaying Statistics About CG Board Activity: cg6kcon Running cg6kcon from a Remote Host 316

Setting Up CG Board Routing Tables: cgroute 322

Displaying DPF File Resource Usage: f54info

Option	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 board DSP resources. f54info displays the following information: DPM revision and creation date DPM size in bytes DPF MIPs requirements Note: DPM MIPS requirements are listed according to the DPF's hexadecimal identifier (not its string identifier). For a list of the hexadecimal IDs associated with DPF strings IDs, refer to the table later in this section.
For more information about managing on-board resources, refer to Appendix B.
Example: f54info dtmf -d
The following information appears: Natural MicroSystems Show F54 File Info Version 1.00 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: Natural MicroSystems Show F54 File Info Version 1.00 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 is more than one Up or Down queue, the sizes are summed.
The following table shows the ASCII string IDs associated with supported CG board 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 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 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 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 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 g726.play_32 0x0f0200 g726.rec_32 0x0f0a00 qtsignal.128p 0x557f00 f_g711.cod 0x400000 f_g711.dec 0x400100 f_frgsm.cod 0x410000 f_frgsm.dec 0x410100 f_ms.frgsm_cod 0x420000 f_ms.frgsm_dec 0x420100 f_g723.cod 0x430000 f_g723.dec 0x430100 f_g729a.cod 0x440000 f_g729a.dec 0x440100 f_faxt38.relay 0x450000 f_g726.cod 0x460000 f_g726.dec 0x460100 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

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.

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.

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`
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`
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`
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`
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`
g726.play_32	`0x0f0200`
g726.rec_32	`0x0f0a00`
qtsignal.128p	`0x557f00`
f_g711.cod	`0x400000`
f_g711.dec	`0x400100`
f_frgsm.cod	`0x410000`
f_frgsm.dec	`0x410100`
f_ms.frgsm_cod	`0x420000`
f_ms.frgsm_dec	`0x420100`
f_g723.cod	`0x430000`
f_g723.dec	`0x430100`
f_g729a.cod	`0x440000`
f_g729a.dec	`0x440100`
f_faxt38.relay	`0x450000`
f_g726.cod	`0x460000`
f_g726.dec	`0x460100`
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`

Displaying Flash Memory, EEPROM, and RAM: cg6ktool

Name

cg6ktool

Purpose

Displays and modifies Flash memory, EEPROM, and RAM contents on a CG board.

Usage

cg6ktool [ options ]
where options are:

Option

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<numbbytes>

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

-S -l<bus:slot>

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

-D -l<bus:slot>

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

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

Burns the flash memory of all detected CG boards with the specified file (filename) starting at the specified Flash image number (imgnumb). The image number is 1's based, and the runtime core file is
image 2.
Note: If you burn the filename.hex file, cg6ktool 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 1's based.

-e

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

-h

Help.

Option	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`<numbbytes*>	Dumps memory in binary format to the file `memdump.bin`. If the starting byte (*startbyte) and number of bytes (numbbyte*) are not specified, the defaults are 0 and 16 MB respectively.
`-S -l`<*bus:slot*>	Dumps error and stack information to the file `errdump.txt`.
`-D -l`<*bus:slot*>	Displays flash block. Note: This option also resets the specified board(s).
`-F` <*bus:slot> `-f`<filename> `-n`<imgnumb*>	Burns the flash memory of all detected CG boards with the specified file (*filename) starting at the specified Flash image number (imgnumb). The image number is 1's based, and the runtime core file is image 2. Note: If you burn the filename.hex* file, `cg6ktool` 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 1's based.
`-e`	Applies the specified command to all CG boards in the chassis.
`-h`	Help.

Description

cg6ktool is used to display non-volatile (Flash) memory contents, burn new images into Flash memory, display EEPROM contents, modify EEPROM contents, and dump on-board error log.
The following rules apply to burning Flash memory:

When the image name (imgname) is not specified, cg6ktool defaults to <filename>.

The maximum number of characters allowed for the image name (imgname) is 23.

If you burn a file <filename>.hex into Flash memory, cg6ktool also automatically burns any file named <filename>.sym (located in the same directory) into memory.

The default path for any specified file is determined by the environment variable AGLOAD.

Caution:

The recommended way of updating board Flash memory for all boards in a chassis is to use the supplied script file burnall , which invokes cg6ktool with the appropriate options. Burning Flash memory incorrectly can result in the inability to boot a board (although no permanent damage is possible).

*Caution:*	The recommended way of updating board Flash memory for all boards in a chassis is to use the supplied script file `burnall` , which invokes `cg6ktool` with the appropriate options. Burning Flash memory incorrectly can result in the inability to boot a board (although no permanent damage is possible).

Performing CG Board Debugging: cgtrace

Name

cg6trace

Purpose

Enables debugging of CG board output.

Usage

cgtrace -bboardnumber options
Where boardnumber is the CG 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.

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 at the command line after a board has been booted:
cgtrace -bboardnumber options

The following menu of commands appears:

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.

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 want to enable command tracing and object starts and stops for the Filter Manager, 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.

Option	Description
`cgtrace -b`*boardnum* `-g100`	Traces messages to and from the host.
`cgtrace -b`*boardnum* `-g80000000`	Prints out an estimate of the amount of available board memory.

Displaying Statistics About CG Board Activity: cg6kcon

Name

cg6kcon

Purpose

Gathers information and statistics about an active CG board.

Usage

cg6kcon options
commands
Valid options include:

Option

Function

-b boardnumb

CG board number (1 - 8). Default = 0

-i ipaddress

IP address of remote Fusion system.

-p portnumber

Port number. Default = 759
To run cg6kcon across the host PCI interface, enter:
cg6kcon -b boardnumber
To run cg6kcon across the Ethernet interface, enter:
cg6kcon -i ipaddress
Valid commands include:

Command

Description

help

Shows the full command set or details for a specified command name.

arptable

Displays current ARP table contents.

conptdet

Displays details on a specific connect point.

dump

Displays a hex or ASCII dump of the memory address specified (256 bytes display).

eeprom

Displays CG board-specific EEPROM contents.

eth

Displays detailed information on the Ethernet interfaces in the following form:
· Context: Memory location for this Ethernet interface control block
· ADP#: Adapter number that indicates which Ethernet interface is displayed
· Ethernet Addr: Ethernet Hardware Address
· Mode: Indicates Ethernet mode (100Base-T or 10Base-T)
· Duplex: Indicates full or half duplex connection
· State: Indicates whether the Ethernet is UP or DOWN
· Statistics:
- The first line (TX Deferred/Collisions /MultiCollisions) is valid in half duplex operation
and is for informational use only.
- The second set of statistics are errors that have occurred.
- The third set of statistics display the current and
average interrupt rates and packet rates for the Ethernet.

ipallow

Allows the host computer with that IP address to query the board.

ipdisable

Disables IP interface.

ipdisallow

Prevents the capability of the host computer with that IP address to query the board.

ipenable

Enables IP interface.

ipshow

Displays the IP addresses that are allowed to query the board.

ppe

Displays current packet processing entities.

ppedet

Displays details on a specific packet processing entity.

resettutil

Resets the task utilization monitor snapshot or statistics.

rtpstat

Displays current RTP statistics for a session.

routetable

Displays current routing table contents.

starttutil

Starts the task utilization monitor snapshot or statistics.

stoptutil

Stops the task utilization monitor snapshot or statistics.

tasks

Displays the following status information for all tasks that have been created on the CG board:
· Name: Name of the given task.
· Prior: Priority of task (32 = highest priority; 0 = lowest).
· Context: Task context address.
· State: Shows the current state of a task. Valid states include:
State Description
Waiting Task is asleep, waiting for work.
Run/sch Task is running or scheduled to run.
Typically, the highest priority task is the
task that is currently running, and all lower
priority tasks in this state have been preempted
by the higher priority task(s).
Idle Task is waiting on a trigger.
Suspend Task has been suspended.
Halted Task is at breakpoint.

util

Shows the current and average system CPU utilization in the following form:
· Current: The value and graph of CPU utilization.
· Average: Average CPU utilization.
· Idle Peak: Peak value reached by idle loop.

Option	Function
`-b` *boardnumb*	CG board number (1 - 8). Default = `0`
`-i` *ipaddress*	IP address of remote Fusion system.
`-p` *portnumber*	Port number. Default = 759

Command	Description
`help`	Shows the full command set or details for a specified command name.
`arptable`	Displays current ARP table contents.
`conptdet`	Displays details on a specific connect point.
`dump`	Displays a hex or ASCII dump of the memory address specified (256 bytes display).
`eeprom`	Displays CG board-specific EEPROM contents.
`eth`	Displays detailed information on the Ethernet interfaces in the following form: · Context: Memory location for this Ethernet interface control block · ADP#: Adapter number that indicates which Ethernet interface is displayed · Ethernet Addr: Ethernet Hardware Address · Mode: Indicates Ethernet mode (100Base-T or 10Base-T) · Duplex: Indicates full or half duplex connection · State: Indicates whether the Ethernet is `UP` or `DOWN` · Statistics: - The first line (`TX Deferred/Collisions /MultiCollisions`) is valid in half duplex operation and is for informational use only. - The second set of statistics are errors that have occurred. - The third set of statistics display the current and average interrupt rates and packet rates for the Ethernet.
`ipallow`	Allows the host computer with that IP address to query the board.
`ipdisable`	Disables IP interface.
`ipdisallow`	Prevents the capability of the host computer with that IP address to query the board.
`ipenable`	Enables IP interface.
`ipshow`	Displays the IP addresses that are allowed to query the board.
`ppe`	Displays current packet processing entities.
`ppedet`	Displays details on a specific packet processing entity.
`resettutil`	Resets the task utilization monitor snapshot or statistics.
`rtpstat`	Displays current RTP statistics for a session.
`routetable`	Displays current routing table contents.
`starttutil`	Starts the task utilization monitor snapshot or statistics.
`stoptutil`	Stops the task utilization monitor snapshot or statistics.
`tasks`	Displays the following status information for all tasks that have been created on the CG board: · *Name: Name of the given task. · Prior: Priority of task (32 = highest priority; 0 = lowest). · Context: Task context address. · State*: Shows the current state of a task. Valid states include: State Description Waiting Task is asleep, waiting for work. Run/sch Task is running or scheduled to run. Typically, the highest priority task is the task that is currently running, and all lower priority tasks in this state have been preempted by the higher priority task(s). Idle Task is waiting on a trigger. Suspend Task has been suspended. Halted Task is at breakpoint.
`util`	Shows the current and average system CPU utilization in the following form: · *Current: The value and graph of CPU utilization. · Average: Average CPU utilization. · Idle Peak*: Peak value reached by idle loop.

Procedure

To run cg6kcon:
1. Open a command line window.
2. Enter the following at the command line:
cg6kcon [-b boardnumber -c channelnumber]
3. Enter one of the cg6kcon commands.
cg6kcon performs commands.
4. To exit the program, enter Q or quit.

Description

In Fusion systems, you can use cg6kcon as a diagnostic tool to monitor the flow of data to and from CG board communication processors.
Use cg6kcon to verify that: Connections are set up appropriately between the CG board DSPs on the same Fusion host system. Network connections are set up appropriately between different Fusion host systems.

Details

Use cg6kcon to view the operating characteristics of an active CG board. Use cg6kcon on the local system or remote system in the following ways: When using cg6kcon on a local system, specify the local board number, for example: cg6kcon -b 100 When using cg6kcon from a remote system, specify the configured IP address of the CG board, for example: cg6kcon -i 197.23.57.212 Running cg6kcon from a Remote Host
By default, remote access is always disabled. You can authorize remote access only from the local system. Each remote system must be authorized to access a particular CG board.
The following commands allow you to enable and disable remote access: Command Description ipenable Authorizes remote access to cg6kcon and sets global access restrictions for any remote IP system that uses cg6kcon. ipallow Enables access by a particular remote system. ipdisallow Removes particular IP addresses from the remote access list. ipdisable Completely disables remote IP access to cg6kcon. Note: ipdisable disables access cg6kcon, but does not effect the rest of the on-board IP Stack.
The following example shows enabling and disabling remote access for cg6kcon: C:\>cg6kcon Console program V1.0 : ['quit' to Exit] [For multi-screen reply, 'more' to scroll] > >ipenable Socket interface enabled > >ipallow 198.62.139.32 IP Address 198.62.139.32 added successfully > >ipshow IP ADDRESSES ============ 198.62.139.32 > >ipdisallow 198.62.139.32 IP Address 198.62.139.32 deleted successfully > >ipshow No allowable IP entries > >ipdisable Socket interface disabled >

Command	Description
`ipenable`	Authorizes remote access to `cg6kcon` and sets global access restrictions for any remote IP system that uses `cg6kcon`.
`ipallow`	Enables access by a particular remote system.
`ipdisallow`	Removes particular IP addresses from the remote access list.
`ipdisable`	Completely disables remote IP access to `cg6kcon`. Note: `ipdisable` disables access `cg6kcon`, but does not effect the rest of the on-board IP Stack.

Commands

Use util to view the current and average CPU utilization of the CG board coprocessor. This command does not provide any utilization information about the DSPs on the board.
util returns two values: CPU utilization during the last second of operation. Average CPU utilization over the last 16 seconds of operation. Both of these values are displayed as a percentage of available CPU.
For example, a value of 25 means that 25 percent of the CPU is being utilized and 75 percent is available. Note: The current CPU utilization number can vary quite a bit from moment to moment. Because of this variation, cg6kcon also displays the average CPU value.
Use eth to display detailed information about the operational status and statistical information for each Ethernet connection on the CG board.
The operational status is provided in the following fields: Field Description Mode Indicates whether the Ethernet is running at a speed of 10 Mb or 100 Mb. Duplex Indicates whether the connection is running Full Duplex or Half Duplex. State Indicates whether the physical interface for the Ethernet is active (UP) or inactive (DOWN). Note: If the State indicates that the physical interface is DOWN, usually the 10/100Base-T cable is not plugged in at the CG board or at the associated hub or router. Other possibilities include a hub or router that is not turned on, or an incorrect cable. T1 cables and Ethernet cables are not interchangeable even though the connectors are the same.
If the State of the physical interface is DOWN, the other two fields (Duplex and Mode) are meaningless.
The Ethernet interfaces on the CG board use a standard known as NWAY Autonegotiation. This standard allows each link partner in an Ethernet connection to inform the other link partner of its speed and capabilities. The CG board supports all four combinations of 100Mb or 10 Mb full duplex, 100 Mb or 10 Mb half duplex. The CG board then uses the corresponding information from the other link partner and runs at the highest capability level the link partner can support.
In descending order, these capabilities are: 100 Mb full duplex 100 Mb half duplex 10 Mb full duplex 10 Mb half duplex
The Mode and Duplex fields provide information on the results of the negotiation. Since most CG boards support all of these capabilities, they attempt to run at 100 Mb full duplex. However, the capability limitations of the link partner can impose lower settings.
The first line of statistical information is valid only when the Ethernet connection is half duplex. These statistics show the number of times a transmit signal has been deferred or a transmit collision has occurred due to the Carrier Sense Multiple Access with Collision Detect (CSMA/CD) algorithm defined by the Ethernet standard.
The next five lines of statistical information show errors that have occurred on this Ethernet link. Normally when operating in full duplex, these errors will all be 0. In half duplex operation, it is possible to have errors of various types. The Ethernet logic on the CG board detects and recovers from any errors on the Ethernet link. These errors are therefore informational, and display the general quality of the local Ethernet segment.
The next line displays the current and average interrupt rates for the Ethernet. CG boards uses various forms of interrupt mitigation logic in order to minimize the effect of interrupts on the system. These statistics in combination with the next set of statistics are used to verify the efficiency of the interrupt mitigation logic.
The last line displays the current and average packet rates for the Ethernet. The current values display the number of packets transmitted and received in the previous second. The average values display the average number of packets transmitted and received over the last 16 seconds. Note: Because current packet rates can vary significantly from moment to moment, the average packet rates are also displayed.
A PPE (Packet Processing Entity) is an entity that performs some form of packet processing on a CG board.
After booting the CG board, use ppe to display the following information: >ppe Name State Type Reg CPTs Ena CPTs Context ============ ======= ========= ======== ======== ======== Ethernet-1 Active Ethernet 2 2 $CD6D30 IP_Over_Eth-1 Active IP/Ether 2 2 $C7EE10 IP_Router Active IP Router 2 2 $C7E6A4 UDP Active UDP 1 2 $C7DBC4 >

In the previous example there are four PPEs: PPE Description Ethernet-1 Specifies the Ethernet driver for interface 1. IP_Over_Eth-1 Processes IP packets for Ethernet 1. IP_Router Manages the routing of packets to the correct Ethernet interface based on the IP Routing table configured and the destination IP address of each packet. UDP Specifies UDP number associated with the IP stack. This interface provides a socket-based interface to the rest of the CG board software. Note: Non-IP packets are forwarded to the host Ethernet task. If you install the CG board Ethernet driver on the host, these non-IP packets are forwarded to the host protocol stack.
When you create an RTP Endpoint, cg6kcon displays three additional PPEs associated with each RTP session: PPE Description RTP In (simplex) Connects to the UDP layer using a socket, receives all RTP packets from the IP network with the matching UDP port number, and (if specified) the local IP address. RTP Out (simplex) Connects directly to the Ethernet PPE, and transmits all outbound RTP packets to the IP network (half duplex). RTP Full Duplex (duplex) Manages the full duplex nature of a typical RTP/voice session.
The displayed Context address is used to identify a particular PPE when using ppedit.
Use ppedit to display detailed information about a specific PPE. The following example shows details about the IP router PPE: >ppedit $C7e6a4 me State Type Reg CPTs Ena CPTs Context ================== ======= ======== ======== ======== ======== IP_Router Active IP Router 2 2 $C7E6A4 Active Connect Points State Addr 1 Addr 2 Addr 3 Addr 4 Context ===================== ====== ======== ======== ======== ======== ======= ICMP Active 1 0 0 0 $C78D34 UDP Active 11 0 0 0 $C7DB14 Statisics ========= TX Pkts: 0x1E TX Bytes: 0x9DB TX Fails: 0x0 RX Pkts: 0x6 RX Bytes: 0x2AA RX Drops: 0x0 >
The first line in the example repeats the information provided in the ppe command.
The Active Connect Points section provides information about the active connect points using this PPE. Two connect points (a connect point is a socket-like connection to the PPE), the UDP and ICMP protocol layers, are currently registered with the IP Router.
The Statistics section provides information about the number of packets transmitted or received by this protocol layer. RX Drop displays the number of packets discarded due to the absence of a socket that is registered for the address contained in the received packet. In the example, ICMP is registered for IP packets with an IP Protocol field. This configuration indicates that the IP packet is an ICMP packet (1), and UDP is registered for IP packets with an IP Protocol field indicating that the IP packet is a UDP packet (11). For example, if another type of IP packet is received for TCP, the packet will be discarded (except in the case where the CG board host Ethernet driver has been installed on the host). Setting Up CG Board Routing Tables: cgroute

Field	Description
Mode	Indicates whether the Ethernet is running at a speed of 10 Mb or 100 Mb.
Duplex	Indicates whether the connection is running Full Duplex or Half Duplex.
State	Indicates whether the physical interface for the Ethernet is active (`UP`) or inactive (`DOWN`).

PPE	Description
`Ethernet-1`	Specifies the Ethernet driver for interface 1.
`IP_Over_Eth-1`	Processes IP packets for Ethernet 1.
`IP_Router`	Manages the routing of packets to the correct Ethernet interface based on the IP Routing table configured and the destination IP address of each packet.
`UDP`	Specifies UDP number associated with the IP stack. This interface provides a socket-based interface to the rest of the CG board software.

PPE	Description
`RTP In` (simplex)	Connects to the UDP layer using a socket, receives all RTP packets from the IP network with the matching UDP port number, and (if specified) the local IP address.
`RTP Out` (simplex)	Connects directly to the Ethernet PPE, and transmits all outbound RTP packets to the IP network (half duplex).
`RTP Full Duplex` (duplex)	Manages the full duplex nature of a typical RTP/voice session.

Name

cgroute

Purpose

Configures the routing table for a CG board.

Usage

cgroute [command [destination] [MASK netmask] [gateway]
[-i interface]] [-b boardnumber] [-p persistence]
Where valid commands include: Command Description print Prints the routing table. add Adds a route. delete Deletes a route. deleteall Deletes all the persistent entries in the routing table.
And valid arguments include:

Argument

Description

destination

Specifies the IP address for this route entry.

netmask

Specifies the subnet mask value for this route entry.
The default value is 255.255.255.255.
This argument is always preceded with the string MASK.

gateway

Specifies the gateway address for this route.

-i interface

Specifies the CG board Ethernet adapter (1 or 2) associated with the specified IP address.

boardnumber

Specifies number of the CG board.
The default value is 0.

-p persistence

Specifies whether or not a specified IP route is saved in non-volatile RAM and is automatically reloaded when the board is rebooted. When you enter -p1, the specified routing information is saved in non-volatile RAM. The routing information is automatically retrieved and reloaded into the board's IP routing table when the CG board is rebooted as in the following example:
cgroute 1.1.1.1 mask 255.255.255.0 -p 1
A value of 0 (the default) specifies that the address is not persistent across reboots.
Note: The number of persistent routing table entries you can specify is limited to:
· Two Ethernet interface addresses (per Ethernet adapter on the board)
· Five route entries
· Two default gateway addresses

Command	Description
`print`	Prints the routing table.
`add`	Adds a route.
`delete`	Deletes a route.
`delete`all	Deletes all the persistent entries in the routing table.

Argument	Description
*destination*	Specifies the IP address for this route entry.
*netmask*	Specifies the subnet mask value for this route entry. The default value is `255.255.255.255`. This argument is always preceded with the string `MASK`.
*gateway*	Specifies the gateway address for this route.
`-i` *interface*	Specifies the CG board Ethernet adapter (1 or 2) associated with the specified IP address.
*boardnumber*	Specifies number of the CG board. The default value is `0`.
`-p` *persistence*	Specifies whether or not a specified IP route is saved in non-volatile RAM and is automatically reloaded when the board is rebooted. When you enter `-p1`, the specified routing information is saved in non-volatile RAM. The routing information is automatically retrieved and reloaded into the board's IP routing table when the CG board is rebooted as in the following example: `cgroute 1.1.1.1 mask 255.255.255.0 -p 1` A value of `0` (the default) specifies that the address is not persistent across reboots. Note: The number of persistent routing table entries you can specify is limited to: · Two Ethernet interface addresses (per Ethernet adapter on the board) · Five route entries · Two default gateway addresses

Description

Use cgroute to add or delete routes from the routing table and print current routing table contents.

Caution:

cgroute adds and deletes routing table entries from the CG board routing table but does not update the host operating system's routing table. For example, using the Windows NT NDIS driver, the board's routing table entries may be inconsistent with the host system's routing table entries.
When booting a CG board, use cgroute to set the board's IP address. Use the add command to enter the interface address for each Ethernet adapter (that is, the board's IP address) in the routing table.
Example: Adding a Route
The following example specifies that all packets directed to the IP address subnet 198.62.139.x are routed to the gateway with IP address 198.62.139.1: cgroute add 198.62.139.12 mask 255.255.255.0 198.62.139.1

*Caution:*	`cgroute` adds and deletes routing table entries from the CG board routing table but does not update the host operating system's routing table. For example, using the Windows NT NDIS driver, the board's routing table entries may be inconsistent with the host system's routing table entries.

Version

Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com