Specifications

System Software Diagnostics Guide — September 2006 121
24
24.PDK Trace Reference
This chapter provides reference information about the PDK Trace tool. The following topics are
included:
• Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
• Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
• Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
• Sample Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
24.1 Description
The DM3 PDK Protocol Trace (PDK Trace) tool allows those who use a DM3 PDK protocol to log
specific information related to the operation of the protocol. The PDK Trace tool is useful for
protocol developers because it can trace the runtime states, input signals, output signals, and
decision branches of the SDL protocol. The PDK Trace tool allows you to specify which channels
on the board to begin tracing. This can be a single channel on one trunk, a single channel on
multiple trunks, a range of channels on one trunk, or a range of channels on multiple trunks.
PDK Tracing will work on any of the following products with a PDK protocol loaded: Intel
NetStructure
®
DM/V, DM/V-A, DM/V-B, DM/F, and DMT160TEC boards. PDK tracing is not
supported for Intel NetStructure
®
on DM3 architecture analog boards and Intel NetStructure
®
DM/IP boards.
Note: If you are using an Intel NetStructure DM/IP board and get the following error message, you can
ignore it (the error message appears in DebugAngel - see Chapter 12, “DebugAngel Reference”):
001:CP1:Cause-Tag : 80013, Error File :qkernerr.h.-Failed to find tracer component address
24.2 Guidelines
The PDK Trace tool requires the Global Call Protocols, so you must choose the Global Call
Protocols option when you install the Intel
®
Dialogic
®
System Release software. Refer to the
Installation Guide for details.
The PDK Trace tool’s executable name is pdktrace.exe for the Windows operating system and
pdktrace for the Linux operating system. The PDK Trace tool is a command line application that
will create a system process thread to interact with the DM3 system to capture trace data. This data
will be streamed to a file on the host system.
Upon completion of tracing, the data will be stored on the host system in a file specified when
tracing was started (default: pdktrace.log). The file is in an unreadable binary format and will need
to be converted to a readable format. For help with this, contact technical support
(http://resource.intel.com/telecom/support/contact.htm).