Teledyne LeCroy Summit Z3-16 PCI Express Multi-lane Exerciser User Manual - Manual (Page 97)

Summit Z3‐16 PCI Express Multi‐Lane Exerciser User Manual 97
Appendix A
Configuration Space Decoding
The decoded capability structures in the Configuration Space Viewer and Editor are based
on programmed definitions in the PETracer software and on Configuration Space Decode
Scripts.
Configuration Space Decode Scripts are tools to define capability structures and instruct
the Configuration Space Viewer or Editor how to decode them. These scripts are in the
\CfgSpaceScripts sub‐directory below the \Scripts directory in the application directory.
You can write Configuration Space Decode Scripts using the CATC Scripting Language (CSL).
See the Teledyne LeCroy Analyzers File Based Decoding Manual for reference.
PCI Express Configuration Space Decode Scripts have the file extension .pecfgdec.
A.1 Mandatory Definitions
Configuration Space Decode Scripts must set the following reserved variables.
 CapabilityName: Name of the capability structure
 CapabilityID: ID of the capability structure
 ExtAddSpace: Set to 1 if Extended Configuration Space. 
Otherwise, set to 0 for PCI.
A.2 Mandatory Module Functions
 Modules are collections of functions and data dedicated to decoding a specific
capability structure. Each module has one primary Configuration Space Decode
Script file (extension .pecfgdec) and optionally has include files (.inc).
 A module function is an entry‐point into a decoding module. To help display a
capability structure, the application calls a module function.
 The Configuration Space Editor and Viewer support only the DecodeRegister(off‐
set) and GetSize( ) functions.
A.2.1 DecodeRegister(offset)
The application calls this function while decoding a specific DWORD offset of the specified
CapabilityID. The offset is the decoding entry point, where the decoding path starts.