Specifications

122 System Software Diagnostics Guide — September 2006
PDK Trace Reference
24.3 Options
The PDK Trace tool uses the following command line options:
-b#
This required option specifies the logical board ID of the board to trace.
Example:
pdktrace -b0 where 0 is the logical board ID of the destination board.
-l[#] or -l[#-#]
Specify which trunk(s) the channels to be traced are located on. The default value is 1 (trunk
1).
Example 1:
pdktrace -b0 -l[1] /* Single trunk */
Example 2: pdktrace -b0 -l[1-4] /* Range of trunks */
-c[#] or -c[#-#]
Specify which channel(s) on the specified trunks to trace. The default value is 1 (channel 1).
Example 1:
pdktrace -b0 -l[1] -c[5] /* Single channel */
Example 2: pdktrace -b0 -l[1-4] -c[1-30] /* Range of channels */
-f[filename]
Specify the name of a file on the host system to write the trace data to. The default is
pdktrace.log.
-i
This option is required only when you first use the PDK Trace tool. This option is used to
initialize the DM3 Tracer Component in the firmware.
Note: This option should only be used the first time the utility is executed after the board is
downloaded
-v
Prints the version number of the utility.
-?, -h
Prints the help screen (command line options) for the utility.
Warning: Due to memory constraints in the embedded DM3 system, the tool will limit the number of
channels that can be traced simultaneously to 60. Trying to trace more than 60 channels per board
can cause unpredictable results.
24.4 Sample Scenarios
The following are some sample scenarios in which the PDK Trace tool can be used and the
command line options used to specify each configuration. These sample scenarios assume that the
logical ID of the board being used is 0.
Scenario 1: For board 0, trace channel 1 on trunk 1
pdktrace -b0
pdktrace -b0 -l[1]
pdktrace -b0 -l[1] -c[1]