This tool may be used by customers under guidance from Aculab technical support to obtain diagnostic information from a Prosody X card. It may also be used to determine DSP resource usage when customer application is running.
Go to directory $(TiNG)/test.
Run pxdiagutil with the appropriate options (the program is
../util/gen-LINUX_V6/pxdiagutil,
../util/gen-SOL_32_V6/pxdiagutil, or
../util/gen-WINNT_V6/pxdiagutil
depending on which operating system you are using).
Command line options are:
-i ip-address
| Specifies the IP address for Prosody X card on which is the module to be examined |
-k security-key
| Specifies the security key for Prosody X card on which is the module to be examined |
-m module
| Specifies the module to to be examined (default 0). |
-d dump-file
| Specifies a dumpfile to be used in conjunction with dump commands |
-v verbose-level
| Specifies a number which controls the amount of commentary printed during command execution. Larger numbers generate more output. |
| <command> | name of pxdiagutil command to be executed - see below. |
| [command params] | optional additional parameters specific to command - see below. |
The set of possible pxdiagutil commands are as follows:
dump
| Generate very large diagnostic dump for crashed DSP into dump file. |
dump_nosdr
| Generate smaller diagnostic dump for crashed or runing DSP into dump file. |
dump_asspsdr
| Generate medium size diagnostic dump for crashed DSP into dump file. |
dump_withipb
| Generate very large diagnostic dump with extra register info for crashed DSP into dump file. |
mem hex-address hex-length
| Dump DSP memory as hex octets or as generated binary dump file if -d specified. |
aggmem hex-address hex-length
| Dump aggregator memory as hex octets or as generated binary dump file if -d specified. |
kernel
| Output kernel version and epoch count. |
status
| Determine running kernel version, state of DSP (running, crashed etc) and its uptime. |
dspcpu
| Get snapshot of DSP CPU load over last second, maximum and average (use cpumon for more accurate picture) |
heap
| Report remaining M2 and SDRAM space, useful for resource evaluations. |
m1left
| Report amount of fast code space remaining for algorithm download before overflow M2 has to be used. |
tdmmem
| Report amount of memory used for TDM timeslot buffers. |
tdmtssamps rx port ts
| Dump 16 bit samples shown as hex from buffer for signal received by DSP (rx). Assumes timeslot is set up in companding mode and 160 samples are shown. Values are normalised 16 bit linear values (x8 for A-Law and x4 for mu-Law) |
tdmtssamps tx port ts
| As above but for signal transmitted by DSP |
vmptxs
| List VMP tx tasks |
vmprxs
| List VMP rx tasks |
asspdump
| Generate dump of current live ASSP connection state into dump file. |
ping6
| Send IPv6 PiNG from DSP. |
nr6
| Output IPv6 address information for DSP. |
For example,
../util/gen-LINUX_V6/pxdiagutil -i 172.16.1.220 -k mykey -d dump.out1 dump
produces diagnostic binary dump in file named dump.out which may then be sent to Aculab support.