Teledyne LeCroy Protocol Analyzers File-Based Decoding User Manual - Manual (Page 65)

File-based Decoding User Manual
LeCroy Corporation
59
Appendix A: PCI Express
The information in this appendix is specific to the PETracer™ analyzer.
It is divided into two parts:
• Modules
• Decoder Script Files
A.1 Modules
Modules are a collection of functions and data dedicated to decoding a certain type of
transaction. Each module consists of one primary file (.dec), and possibly several
included files (.inc)
Module Function
A module function is used as an entry-point into a decoding module. It is called by the
application and used each time a transaction needs to be displayed.
ProcessData()
PETracer supports only the ProcessData() function. It is called with each packet of the
appropriate type with input context filled with data from that packet. It reports the amount
of processed data through the out.Decoded variable.
A.2 Decoder Script Files
PETracer includes the four script files in the \Scripts directory. You can use these files
as is or modify them.
To activate a script file, go to the last line in the file (for example, in io.dec, the line
reads: “set OutputType =”__IO”) and remove the underscore. For example:
set OutputType =”__IO”
Change to:
set OutputType =”IO”
Following is a list and brief summary of the decoder script files. The following sections
describe each file in greater detail.
cfg.dec Configuration data script decoder
io.dec IO data script decoder
mem.dec Memory data script decoder
msg.dec Message data script decoder
atomop.dec Atomic Operation data script decoder
Decoder Script File Function