beautypg.com

A.1 modules, Module function, A.2 decoder script files – Teledyne LeCroy Protocol Analyzers File-Based Decoding User Manual User Manual

Page 65: Appendix a:pci express, Appendix a: pci express

background image

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