User Manual

ManualsBrandsTeledyne LeCroy ManualsEquipmentSummit T28 PCIe Multi-lane Protocol Analyzer

Summit T28

PCI Express

Multi-Lane Protocol Analyzer

User Manual

SoftwareVersion7.xx

January2014

Summary of content (256 pages)

PAGE 1
Summit T28 PCI Express Multi-Lane Protocol Analyzer User Manual Software Version 7.
PAGE 2
Teledyne LeCroy Protocol Solutions Group Trademarks and Servicemarks Teledyne LeCroy, CATC Trace, PCI Express, PETracer, PETracer Summit, Summit T28, Universal Protocol Analyzer System, UPAS, and BusEngine are trademarks of Teledyne LeCroy. Microsoft and Windows are registered trademarks of Microsoft Corporation. Intel and Pentium are registered trademarks of Intel Corporation. All other trademarks and registered trademarks are property of their respective owners.
PAGE 3
Contents Chapter 1: Overview................................................................................................1 1.1 PETracer Analyzer Hardware and Software ......................................................................... 1 1.1.1 CATC Trace Software .............................................................................................................................2 1.1.2 Summit T28 Analyzer ......................................................................................
PAGE 4
Teledyne LeCroy Contents Connection Procedure........................................................................................................................ 15 3.7.2 Example: Connecting the Summit T28 Analyzer to the Device Under Test Using a Gen2 Multi-lead Probe for x1 and x4 ......16 Components ........................................................................................................................................ 16 Connections for Gen2 Multi-lead Probe.........................
PAGE 5
Contents Teledyne LeCroy 4.11.2 What Gets Created .............................................................................................................................39 4.12 PETracer Files..................................................................................................................... 40 4.12.1 CATC Trace Files................................................................................................................................40 4.12.2 Recording Options Files ......
PAGE 6
Teledyne LeCroy Contents 5.14.2 Link Width ...........................................................................................................................................57 5.14.3 Upstream and Downstream ...............................................................................................................57 5.14.4 Reference Clock .................................................................................................................................57 5.14.5 SMA...............
PAGE 7
Contents Teledyne LeCroy 5.22.2 How to Increment or Reset a Counter ..............................................................................................89 5.22.3 Changing the Value of the Counter ..................................................................................................90 5.22.4 Deleting a Counter..............................................................................................................................91 5.23 Timer .....................................
PAGE 8
Teledyne LeCroy Contents 6.13 Decoding Traffic ............................................................................................................... 117 6.13.1 Packet ................................................................................................................................................117 6.13.2 Link ....................................................................................................................................................118 6.13.3 Split.........
PAGE 9
Contents Teledyne LeCroy 7.8 Go To Menu ......................................................................................................................... 137 7.9 Search Direction ................................................................................................................. 137 7.10 Find .................................................................................................................................... 138 7.10.1 Event Groups ......................................
PAGE 10
Teledyne LeCroy Contents 9.14 Link Configuration............................................................................................................ 165 9.15 Export of BitTracer Capture to CATC Trace Format ..................................................... 167 9.15.1 Exports Involving Multiple Logical Links on One Physical Link .................................................167 9.15.2 Export To CSV Text .........................................................................................
PAGE 11
Contents Teledyne LeCroy 10.9 Detail View......................................................................................................................... 194 10.10 LTSSM Flow Graph......................................................................................................... 195 10.11 Packet Header Bar .......................................................................................................... 196 10.12 Packet Data Window....................................................
PAGE 12
Teledyne LeCroy Contents 11.3 License Information.......................................................................................................... 225 Appendix A: Configuration Space Decoding ...................................................227 12.1 Mandatory Definitions ...................................................................................................... 227 12.2 Mandatory Module Functions........................................................................................
PAGE 13
Chapter 1 Overview Designed for developers and validators, the Teledyne LeCroy Summit T28™ is a Gen1/ Gen2 PCI Express advanced verification system. By leveraging years of experience in protocol analysis tools for emerging markets, Summit T28 blends sophisticated functionality with practical features to speed the development of PCI Express™ IP cores, semiconductors, bridges, switches, add‐in boards, and systems. 1.
PAGE 14
Teledyne LeCroy PETracer Analyzer Hardware and Software Flexible Host Interface Downloadable CATC Trace Viewer USB 2.0 Share and annotate CATC Trace recordings within a development team. Freely distributable PETracer software enables collaborative analysis across sites and time zones. Bidirectional x1‐x8, 2.5 GBps to 5.0 GBps recording support Field‐upgradeable firmware and recording engine Flexible probing options Accurate and non‐intrusive collection of PCI Express CATC Trace data.
PAGE 15
PETracer Analyzer Hardware and Software 1.1.2 Teledyne LeCroy Summit T28 Analyzer The Teledyne LeCroy Summit T28 is Teledyne LeCroy’s high performance PCI Express analyzer for customers in server, workstation, desktop, graphics, storage and network card markets. Figure 1.1: Summit T28 Analyzer With advanced features such as data rates from 2.5 to 5.
PAGE 16
Teledyne LeCroy PETracer Analyzer Hardware and Software Features            1.1.3 Powerful and Intuitive CATC Trace Analysis Software System: The CATC Trace embeds deep understanding of the PCI Express protocol hierarchy and intricacies. This knowledge is presented in a colorful, intuitive and easy‐to‐use graphical display, allowing you to quickly capture and validate PCI Express product designs.
PAGE 17
Chapter 2 Hardware Description The PCI Express™ system features Summit Analyzers. 2.1 System Components      2.2 Summit T28™ analyzer system DC Power Adaptor, 12 volts, and AC power cable USB cable PETracer Software program CD‐ROM (optional) probes and interposers (see “Interposers and Probes” on page 11) Host Machine Requirements The Summit T28 connects to a host machine. Please consult the readme file on the installation CD for the latest host machine requirements. 2.
PAGE 18
Teledyne LeCroy Summit T28 Rear Panel Description  2.4 Speed LEDs: Indicate speed setting the analyzer is using for Downstream direc‐ tion. Summit T28 Rear Panel Description The Summit T28 rear panel contains:      6 Trigger In and Out connector: Provide external trigger capabilities. You can con‐ figure Summit T28 to trigger external equipment using Trigger Out. You can use Trigger In to trigger the Analyzer from another device. The minimal pulse width for Trigger In is 20ns.
PAGE 19
Chapter 3 Installation and Setup The Summit T28™ is a standalone system. You can begin PCI Express™ recordings after following the steps in this chapter. 3.1 Installing the PETracer Software PETracer software operates all of Teledyne LeCroy’s PCI Express protocol Analyzer and Exerciser products: The PETracer software is installed on a Microsoft® Windows®‐based host machine and serves as the interface for the Exerciser and/or Analyzer. To install the PETracer software on the host machine: 1.
PAGE 20
Teledyne LeCroy Installing the PETracer Software The PETracer program displays. Figure 3.2: Teledyne LeCroy PETracer Application Note: The software may be used with or without the Analyzer. When used without an Analyzer attached to the computer, the program functions as a CATC Trace Viewer to view, analyze, and print captured traffic.
PAGE 21
Setting Up the Summit T28 Analyzer using a USB Connection 3.2 Teledyne LeCroy Setting Up the Summit T28 Analyzer using a USB Connection To set up the Analyzer using a USB connection: 1. Connect the Analyzer to a 100‐volt to 240‐volt, 50 Hz to 60 Hz, 120 W power outlet using the provided power cord. 2. Connect the USB port to a USB port on the host machine using a USB cable. 3. Turn on the front power switch. Note: At power‐on, the Analyzer initializes and performs a self‐diagnosis.
PAGE 22
Teledyne LeCroy 3.4 Analyzer Network Analyzer Network For Ethernet, to display the host machines and analyzers on the local network, select Setup > Analyzer Network to display the Analyzer Network dialog. Figure 3.4: Analyzer Network Dialog The dialog displays the host machines on the network and the Analyzer devices connected to the host machines. Note: The Analyzer must be turned on before it appears in the list.
PAGE 23
Interposers and Probes 3.5 Teledyne LeCroy Interposers and Probes The Summit T28 works with Interposers and Probes. Some of them are listed below.    Gen2 MidBus Probe: The Gen2 MidBus Probe is designed for use with the Summit T28 Analyzer and supports lane widths from x1 to x8 at data rates of 2.5 GT/s (Gen1) or 5.0 GT/s (Gen2). Gen2 Multi‐lead Probe: The Gen2 Multi‐lead Probe is designed for use with the Summit T28 Protocol Analyzer.
PAGE 24
Teledyne LeCroy Using Interposers 3.6 Using Interposers 3.6.1 Gen2 Active Interposer. Figure 3.6: Connecting the Summit T28 Analyzer to the Device Under Test Using a Gen2 Active Interposer Summit T28 Components Summit T28 components used in the installation are:  iPass Y‐Cable: The cable supports eight lanes from two directions.
PAGE 25
Using Interposers Teledyne LeCroy Installing the Gen2 Active Interposer To install the Interposer, perform the following steps. 1. Insert the gold male connector on the Interposer probe into a x8 PCI Express slot in the motherboard. Use edge adaptors for x1 and x4 slots. 2. Insert the PCI Express DUT into the Interposer’s PCIe female device connector. 3. The slot Interposer is shipped from Teledyne LeCroy with a metal face plate for attachment to a PC case.
PAGE 26
Teledyne LeCroy Using Probes 3.7 Using Probes 3.7.1 Example: Connecting the Summit T28 Analyzer to the Device Under Test Using a Gen2 MidBus Probe Note: Mid‐bus probes require attachment‐pad and reference‐clock connections. For information about how to connect the attachment pad, reference clock, and cables in your system, see the MidBus Probe Manual. Components Figure 3.7: iPass Y-cable Figure 3.8: MidBus Probe pod Figure 3.
PAGE 27
Using Probes Teledyne LeCroy Figure 3.10: Clock Cable Connections Overview for Gen2 MidBus Probe Use a 1‐pod setup. Use the iPass Y‐cables to connect the probe data connectors on the Analyzer to the MidBus pod(s). On the other side of the pod, connect the MidBus probe assembly. Connect the header on the MidBus probe assembly to the MidBus footprint on the System Under Test (host platform/root complex). The following picture shows two midbus footprints, with one connected to the MidBus probe assembly.
PAGE 28
Teledyne LeCroy 3.7.2 Using Probes Example: Connecting the Summit T28 Analyzer to the Device Under Test Using a Gen2 Multi-lead Probe for x1 and x4 Components   1 iPass Y‐cable for x1 and x4 (see “iPass Y‐cable” on page 14). 1 Multi‐lead Probe Pod for x1 and x4 Figure 3.12: Multi-Lead Probe Pod  Up to 16 MidBus Probe SSMP Cables, and up to 8 Flexible Leads, per pod Figure 3.13: Midbus Probe SSMP Cables  1 Clock Cable (see Figure 3.10 on page 15).
PAGE 29
Using Probes Teledyne LeCroy Connection Procedure To connect Summit T28 to the System Under Test (host platform/root complex): 1. Connect the pods to the Analyzer using the iPass Y‐cable cables. 2. Connect the flexible lead tips to the pods using the SSMP cables. 3. Connect the lead tips to the system under test by soldering to the trace.
PAGE 30
Teledyne LeCroy 3.7.3 Using Probes Example: Connecting the Summit T28 Analyzer to the Device Under Test Using a Gen2 Multi-lead Probe for x8 Components  2 iPass Straight cables for x8 Figure 3.14: iPass Straight Cables    2 Multi‐lead Probe pods for x8 (See “1 Multi‐lead Probe Pod for x1 and x4” on page 16). Up to 16 MidBus Probe SSMP Cables, and up to 8 Flexible Leads, per pod. (See Figure 3.12 on page 16). 1 Clock Cable (see Figure 3.9 on page 14).
PAGE 31
Chapter 4 Software Overview 4.1 The PETracer Software The PETracer™ software administers Analyzer platforms and handles all CATC Trace analysis and display. The core software is thus the same for all of Teledyne LeCroy's PCI Express products. The software runs on a Windows® based host machine that is attached to the Analyzer via a USB 2.0 connection (USB 1.0 is also supported). PETracer software can be used without the Analyzer as a CATC Trace viewer for viewing, analyzing and printing traces.
PAGE 32
Teledyne LeCroy Application Layout Figure 4.1: Sample of a CATC Trace 4.2 Application Layout The PETracer application contains the following components: Title bar: The title bar is at the top of the application window and displays the CATC Trace file name or generation script name. Menu bar: The menu bar is located below the title bar, by default. The menu bar can be moved by clicking a blank area of the bar and then dragging the menu to a new position.
PAGE 33
Using the Toolbar Teledyne LeCroy Display area: The display area is the main part of the application window in which CATC Traces are displayed. Status bar: The status bar is located at the bottom of the application window. The left end of the status bar displays descriptions of buttons and menu items when the mouse is positioned over them. The right end of the bar shows the search direction. 4.
PAGE 34
Teledyne LeCroy Using the Toolbar Hide Training Sequence. Compact View Toggles compacting of training sequences to analyze CATC Trace data faster, or no compacting to display more data. Hide SKIP and Update FC packets. Find Opens a dialog box that allows you to select one or more items to find in the recording, then searches to that point. Hide Upstream recording/ traffic. Find Next. Repeats last Find or Search action. Hide Downstream traffic/ recording. View Packet Level data.
PAGE 35
Multi‐Segment Toolbar Teledyne LeCroy File Information Lists the conditions under which the recording was made. Bus Utilization Opens a window that graphically represents various information about the recording. Error Report Opens a window that lists all errors identified in the recording. Link Tracker Opens a window that displays symbol information per lane. Traffic Summary Opens a window that lists all events that occurred during the recording Opens the Data Flow window.
PAGE 36
Teledyne LeCroy 4.4.1 Multi‐Segment Toolbar Toolbar Hide Buttons The PETracer application toolbar has five buttons related to show/hide of CATC Trace file contents. The buttons allow you to quickly adjust the display to your needs. Hide Training: Brings up a drop‐down menu that lets you to hide all or a portion of the packets in the training portion of the CATC Trace. Hide SKIP, Hide EDS and Update FC: Brings up a drop‐down menu that lets you hide SKIP, Update FC and hide EDS packets in a CATC Trace.
PAGE 37
Using the Menus Teledyne LeCroy Figure 4.3: Display Options 4.5 Using the Menus The PETracer application main display includes the following set of pull‐down menus: 4.5.1 File Menu New PETrainer Script Creates a new Traffic Generation file. Open Opens a file.
PAGE 38
Teledyne LeCroy 4.5.2 26 Using the Menus Close Closes the current file. Save as Saves all or a specified range of packets to a uniquely named file. Convert Old Files Convert CATC Trace files made in previous versions of PETracer to the new format for PETracer version 5.0 and higher. Print Prints part or all of the current traffic data file. Print Preview Produces an on‐screen preview before printing. Print Setup Setup your current or new printer.
PAGE 39
Using the Menus 4.5.3 4.5.4 Teledyne LeCroy Analyzer Network Opens a dialog box for browsing to local and networked analyzers. Within the dialog, click Add to browse. The dialog lists PCs that are on the LAN. If a PC has an analyzer attached to it, and if DCOM permissions have been set on the selected PC, clicking Select establishes a connection. See “Analyzer Network” on page 10. All Connected Devices Opens a dialog box with a list of locally or remotely connected devices.
PAGE 40
Teledyne LeCroy 4.5.5 Using the Menus Trace Navigator Shows the Navigator bar for navigating a CATC Trace. Shows a snapshot of the recording and allows you to adjust the memory area for the view. LTSSM Flow Graph Shows a state diagram of bus activity. Also allows you to navigate through the LTSSM, based on the current recording. Packet Header Opens the Packet Header bar, showing the Packet Header information as it would be viewed in the specification.
PAGE 41
Using the Menus 4.5.6 Teledyne LeCroy Find Displays the Find dialog to allow searching for various events within a CATC Trace.
PAGE 42
Teledyne LeCroy 4.5.7 Using the Menus Zoom Out Zoom out decreases the size of the displayed elements. Wrap Allows the display to wrap. Synchronize Trace View With Other Views Synchronizes the Trace view with other views. FC Credits Toggles a display for tracking Flow Control Credit update and consumption on a PCI Express link. FC Credits Setup Allows you to customize the display for tracking Flow Control Credits.
PAGE 43
Using the Menus 4.5.8 4.5.9 Teledyne LeCroy Memory/IO Space Editor Displays the Memory/IO Space Editor dialog which allows you to either create a new Address Space File or open an existing Address Space File. Select the memory size from the drop‐down menu.
PAGE 44
Teledyne LeCroy 4.6 Dashboard View Tell Teledyne LeCroy Report a problem to Teledyne LeCroy Support via e‐mail. This requires that an e‐mail client be installed and configured on the computer. Shortcuts List Displays a list of Keyboard shortcuts. About PETracer Displays version information about the attached Analyzer and its Firmware and BusEngine™. Dashboard View Dashboard View shows state of the link that analyzer is tracking.
PAGE 45
Dashboard View Teledyne LeCroy Figure 4.5: Dashboard View Dialog You can launch Recording Options for the analyzer from the Dashboard View and adjust recording settings to match the current link configuration. The Copy Polarity Settings to Recording Options button allows you to copy the detected polarity into Recording Options. The Copy Lane Swizzling Settings to Recording Options button allows you to copy the detected Lane Swizzling Settings into Recording Options.
PAGE 46
Teledyne LeCroy 4.7 Tool Tips Tool Tips Tool tips provide details about fields within the CATC Trace. To see a tool tip, position your mouse pointer over a field within the CATC Trace. You can turn off this capability in the Display Options menu. 4.8 4.
PAGE 47
Status Bar Teledyne LeCroy Recording Progress Bar: The colored bar to the right of the serial number represents how much traffic has been recorded. The trigger point is indicated by the black line at the left side of the bar. In this example, the trigger occurred at the very beginning of the CATC Trace. If the trigger is set in the middle of the CATC Trace, the line is positioned in the middle of the bar. Additionally, the color of the bar is different on each side of the trigger point.
PAGE 48
Teledyne LeCroy Making a PCI Express Recording Figure 4.7: Status Bar - Uploading The status bar displays Triggered when the trigger condition has occurred, but uploading has not commenced yet. Figure 4.8: Status Bar - Triggered As uploading progresses, the percent increases to 100. You can abort this upload if you wish by pressing the ESC button on your keyboard or clicking 4.9.3 in the Tool Bar. Recording Activity The third segment displays recorded activity as a series of blue vertical bars.
PAGE 49
Making a PCI Express Recording Teledyne LeCroy Figure 4.9: Summit T28 in Simple Recording Mode 3. In the Link section, specify the lane width of the PCI Express link to be analyzed. The rest of the settings in this section can be left at the factory defaults for most PCI Express systems. 4. For multi‐lane PCI Express links, the Analyzer needs to observe link training in order to record link traffic correctly.
PAGE 50
Teledyne LeCroy 4.10.1 Recording Multi‐Segmented CATC Traces Stopping a Recording You can stop the recording process at any time by pressing the Stop button . This causes the Analyzer to stop the recording and upload the CATC Trace to the host machine. If you press the Stop button again, the Analyzer temporarily halts the upload process and opens the following dialog box. Figure 4.
PAGE 51
Recording Multi‐Segmented CATC Traces Teledyne LeCroy The only downside to multi‐segmenting is that limits the scope of reports such as Traffic Summary, Bus Utilization, and Error Summary to each of the segments. You cannot perform summary statistics on the full recording. The default segment size is 10 MB. Before attempting large recordings, it is recommended that you play with this number to see what value best suits your needs. 4.11.
PAGE 52
Teledyne LeCroy 4.12 PETracer Files PETracer Files The PETracer software creates and uses different kinds of files:    4.12.
PAGE 53
Saving CATC Trace Files Teledyne LeCroy Also, when you analyze a recorded CATC Trace file, you might be interested in preserving just a part of the PCI Express traffic that was recorded. If you save a portion of a CATC Trace file, it can get significantly smaller, allowing you to attach it to an e‐mail. To save a portion of a CATC Trace file or the whole file to a unique name, select File Save As from the File menu. Figure 4.
PAGE 54
Teledyne LeCroy Exporting a CATC Trace File checked. In this case it is going to save all packets in the range, EXCLUDING the currently hidden packets. 4.14 Exporting a CATC Trace File By default, PETracer saves CATC Trace files in the .pex format. However, you can export a CATC Trace to a file in any of the following other formats:    Text Comma Separated Value (CSV) Generator file format Exporting to Generator file format is a simple way to create a script file from your CATC Trace.
PAGE 55
Analyzer Chat Window Teledyne LeCroy Figure 4.13: Print Packets Dialog 2. To select a range of packets, enter values in the From packet # and To packet # fields and click Print. 3. To print an entire file, leave the From and To fields empty and click Print. The specified traffic information is printed as currently displayed, in color or gray scale as supported by your printer. Any CATC Trace File comments you entered are printed following the current document name at the top of each page.
PAGE 56
Teledyne LeCroy Analyzer Chat Window If the above conditions are met, a Chat session is initiated by running the command: View > Analyzer Network Chat Bar. The following dialog box opens. Figure 4.15: Analyzer Network Chat Dialog Enter some text, then press Send. The message is then broadcast to all host machines listed in your network browse window. If a target host machine also lists your host machine in its Network Browse window, then it can receive your message.
PAGE 57
Analyzer Chat Window Teledyne LeCroy Launching the CrossSync Control Panel To launch CrossSync from the PETracer PCI Express Protocol Analyzer software application, select the ‘Launch CrossSync Control Panel‘ entry in the ‘Setup’ menu (see the screen below). Or, you can launch CrossSync from the ‘Start’ menu. Figure 4.16: Launching CrossSync from the PETracer PCI Express Protocol Analyzer Application Please refer to the CrossSync Control Panel User Manual for more information.
PAGE 58
Teledyne LeCroy 46 Analyzer Chat Window Summit T28 PCI Express Multi‐Lane Protocol Analyzer User Manual
PAGE 59
Chapter 5] Recording Options 5.1 Recording Overview After installing the software recording options should be set prior to recording. The recording options define the behavior of the Summit T28 during recording. You can create, save and load previously saved recordings. This section explains how to define recording options on the Summit T28 Analyzer. 5.2 General Tab The Recording Options dialog is used to configure a recording. To open the Recording Options window, click Setup > Recording Options.
PAGE 60
Teledyne LeCroy 5.3 Recording Options‐General Tab Recording Options-General Tab This section describes the General Tab recording options. 2G 2F 2E 3A 3B 2 3 2A 3C 2B 3D 2C 2D 3E 1 3F 1A 3H 1B 1C 1D 1E 1F 3G 3I Figure 5.1: Summit T28 in Recording Options Note: Please refer to the figure callout numbers in each of the sections below to co‐relate to Figure 5.1 shown above. For instance, for Simple and Advanced Mode, see Figure 5.1: 1B.
PAGE 61
Simple and Advanced Mode 5.4 Teledyne LeCroy Simple and Advanced Mode The recording options can be defined in Simple or Advanced modes. The Simple Recording and Advanced Recording options are the same in functionality, only the interface displayed is different. The Simple Mode allows quick access to commonly used options. The recording options are the same in both modes (See Figure 5.1: 1B). Clicking on the Switch to Simple Mode toggles you between Simple and Advanced Mode (see Figure 5.2 on page 49).
PAGE 62
Teledyne LeCroy 5.6 Saving and Loading Previously Saved Recording Options Saving and Loading Previously Saved Recording Options You can save a recording or load previously saved recordings. In the general tab the following Save options are available (see Figure 5.1 on page 48). 5.6.1 Setting Default Recording Options To save the current recording options into the default Recording Options file: Click Save As Default. The default file for the options is default.rec.
PAGE 63
Recording Type 5.6.3 Teledyne LeCroy Saving Recording Options Recording Options settings can be saved and later reused. Recording options settings are stored in *.rec files. 1. Open the Recording Options dialog by selecting Setup > Recording Options. 2. Set your options, then click Save. 3. Enter a unique file name. The .rec extension is added by default.(optional) To add a descriptive label to this file to help you remember what options were set, use the Options Name box. 5.
PAGE 64
Teledyne LeCroy 5.7.1 Buffer Size Snapshot A recording of a pre‐determined length. You set the recording length in the Buffer Size box. Recording begins when you click the Rec button on the toolbar and ends when the selected buffer size is filled or when you press the Stop button. 5.7.2 Manual Trigger A recording that switches between the pre‐trigger buffer and the post‐trigger buffer when a Trigger is received. Recording begins when you select Start in the application.
PAGE 65
Upload Size 5.9 Teledyne LeCroy Upload Size Causes the Analyzer to upload a portion of the Analyzer's buffer. This option lets you look at part of the CATC Trace. Half of the uploaded CATC Trace is pre‐buffer and half post‐ trigger (See Figure 5.1 on page 48: 2C). Figure 5.5: Upload Size Slide Bar 5.10 Misc Turns on trigger beep, allows external interface signals to be saved into the CATC Trace, and tells the Analyzer to use whatever TC to VC mapping was used in the last recording.
PAGE 66
Teledyne LeCroy Recording Mode  Default TC to VC mapping button: Lets users manually configure the default mapping. Figure 5.7: Default TC to VC Mapping 5.11 Recording Mode There are two options for Recording Mode:   Protocol Recording Bit Tracer Recording Figure 5.8: Recording Mode Options 5.11.1 BitTracer Recording When the Bit Tracer Recording box is checked, it allows you to select the Speed and the Link Width from the drop‐down menu.
PAGE 67
Save As MultiSegment Trace Teledyne LeCroy For example, if you set the Trigger Position to 90% Post‐Triggering Traffic, the Analyzer records 10% pre‐trigger traffic and 90% post‐trigger traffic. Trigger Position is only available when Manual Trigger or Event Trigger is selected. 5.13 Save As MultiSegment Trace Divides the recording into segments so as to allow very large recordings to easily upload and view.
PAGE 68
Teledyne LeCroy 5.13.1 Link Settings Viewing Multisegmented Files If Save As MultiSegment Trace is enabled in the General tab of the Recording Options, the PETracer divides the CATC Trace into segments and stores them on the host machine's hard drive. Segment size is set in the MB Segments box. Enter a value from 4 MB to 128 MB. PETracer also creates an index file that provides a brief summary of each segment and hyperlinks to each of the segments.
PAGE 69
Link Settings Teledyne LeCroy 5.0 GT/s or 2.5 GT/s: When set to a specific speed, Teledyne LeCroy’s software forces the hardware to record at that speed. For Auto speed setting to work the polarity setting of lane 0 has to be correct. The polarity can be set manually if the link is already in L0 state, or, for automatic polarity detection, the bus has to go through a reset so the analyzer can track the polarity.
PAGE 70
Teledyne LeCroy 5.14.7 Link Settings Auto-Configure Lane Polarity Lets the Analyzer determine lane polarity (see Figure 5.1 on page 48: 3G). Auto functions such as Auto Configure polarity rely on Gen1 or Gen2 training sequences to properly discover their values. If the speed option is set to fixed Gen3, the analyzer will never see these sequences and the polarity discovery will not be reported properly in the dashboard dialog. 5.14.
PAGE 71
Triggering Teledyne LeCroy Manually moving Lane 0 to the required position Figure 5.13: Manually Configuring Lane 0 when Auto-Configure Lane Swizzle is Checked 5.15 Triggering Triggering Options can be set in both Simple and Advanced Modes. The options in both modes are the same, only the GUI is different where shortcuts for the events are displayed in the Simple Mode for easy access (see Figure 5.2 on page 49).
PAGE 72
Teledyne LeCroy 5.15.1 Triggering Triggering On (Simple Mode) You can check any of the boxes shown in Table 5.1 for Trigger On in Simple Mode (see Figure 5.14 on page 61). TABLE 5.1: Simple Mode Trigger On Events Enter Elec Idle Exit Elec Idle Switch to G1 Switch to G2 TS1 TS2 InitFC1 NAK PM AnyTLP Config Memory IO RD Error Invalid Symbol Block Align Error Token Error Idle Symbol Error Trigger Position is only available when Event Trigger or Bit Tracer Recording is selected.
PAGE 73
Triggering Teledyne LeCroy Figure 5.14: Simple Mode Triggering Options 5.15.2 Triggering On (Advanced Mode) The same triggering options are available in the Advanced Mode as in the Simple Mode. The Advanced Mode gives you additional flexibility to drill down and configure these options in greater detail via the Recording Rules dialog. In the Advanced mode click on the Recording Rules tab to configure the settings. As shown in Figure 5.
PAGE 74
Teledyne LeCroy Recording Rules Overview New Events Menu Available Events Panel Toolbar Global State Cell Sequence Cells Actions Menu Main Display Area Figure 5.15: Recording Rules Tab 5.16 Recording Rules Overview The Recording Rules allows you to specify complex triggering and filtering options. The Summit T28 monitors incoming traffic and looks for specified events. It performs actions like triggering and filtering. Complex options can be created by putting Events in a sequence.
PAGE 75
Recording Rules Overview Teledyne LeCroy Figure 5.
PAGE 76
Teledyne LeCroy Recording Rules Overview There are three steps to creating a recording rule: 1. Select events. 2. Place the events in the Global State or Sequence cells. 3. Assign actions to the events. Note: There are limits to the types of rules that can be created. 1. Click and select one or more events from the menu. Selecting an event automatically places it in the Available Events area.
PAGE 77
Resources Teledyne LeCroy 4. Assign an action to the selected events by right‐clicking each of the events, selecting Specify Action from the pop‐up menu, and assigning an action such as Trigger, Filter, or Count. Be sure to click the event itself and not the State cell that it is sitting in (which produces a different pop‐up menu). Figure 5.
PAGE 78
Teledyne LeCroy Resources Available Events panel. Double‐click on the DLLP: InitFC1 to select the specific fields and go to the Layout tab to change the pre‐defined bits. Figure 5.
PAGE 79
Resources Teledyne LeCroy 5.17.2 Basic Resource Basic Resources are for the Link States, Ordered Sets (except TS1 and TS2) and Errors. A Basic Resource does not allow you to define patterns to the bit level. It just matches events that have been predefined. To set a Basic Resource, click on the New Event button and select any of the options. In this case we have selected Ordered Set: TS1. The EIEOS displays in the Available Events panel.
PAGE 80
Teledyne LeCroy 5.17.3 Resources Payload Match Resource Payload Match Resources are available for TLP events only. A Payload Match Resource allows you to define up to five double‐words of payload content to be matched for any TLP. These five double‐words are floating, meaning the payload of any TLP will be analyzed five double‐words at a time for all double‐words offsets in the payload. You can define the layout to the bit level in the Payload tab so that the Analyzer can match an exact pattern.
PAGE 81
Resources Teledyne LeCroy Figure 5.
PAGE 82
Teledyne LeCroy Resources Figure 5.21: Setting Up a Payload Match Resource 2 The payload match pattern byte ordering is always little‐endian while the data payload display in the CATC Trace is big‐endian. The CATC Trace is configurable, so you need to exercise caution in order to specify the matching pattern properly.
PAGE 83
Global State and Sequence States Teledyne LeCroy Figure 5.22: Match Pattern Causing a Trigger ACHI Register and NVMe Register trigger options are based on TLP packet match resources 5.18 Global State and Sequence States The Main Display area in the center of the Recording Rules window has two cells that affect events differently, they are the Global State and Sequence State. Global State Cell Sequence Cell Figure 5.
PAGE 84
Teledyne LeCroy Global State and Sequence States Figure 5.24: Global State Menu 5.18.1 Global State The Global State is active all the time. The Summit T28 Analyzer tracks all the Events and Actions defined in the Global State throughout the recording. In the Global State the Link State, Ordered Set (except TS1 and TS2), Errors, Counter and the Timer use Basic Resources while TLP, DLLP, TS1 and TS2 use Packet Match Resources. The Global State has two Timers and two Counters (see Figure 5.25 on page 73).
PAGE 85
Global State and Sequence States Teledyne LeCroy Figure 5.25: Global State For the Global State there are only 2 Basic Resources for each Channel. Some optimization is done internally to accommodate additional resources. You can keep adding resources to the Global state so long as the Config is valid button stays green. If you add a new event which is not valid a window appears with a message prompting Invalid Recording Rules Configuration and the Config is valid button will turn red (see Figure 5.
PAGE 86
Teledyne LeCroy Global State and Sequence States Figure 5.26: Valid and Invalid Recording Rules Configuration Dialogs 5.18.2 Sequence State The cell marked Drag an event here to add another sequence is the Sequence State (see Figure 5.27 on page 75). In the Sequence State you can define a sequence of Events and Actions which the Summit T28 Analyzer looks for at pre‐determined times. Sequences are chains of events culminating in a trigger or any other action.
PAGE 87
Navigating Recording Rules Teledyne LeCroy Events can be added to this Sequence State Sequence States Figure 5.27: Sequence State Events In the Sequence State the Link State, Ordered Set, Errors, Counter and the Timer use Basic Resources while DLLP and TLP use Packet Match Resources. There are four Timers and four Counters in the Sequence State. Note: In each Sequence State up to eight Basic Resources and eight Packet Match Resources can be defined. 5.
PAGE 88
Teledyne LeCroy 5.19.2 Recording Rules Events Available Events Area The Available Events area is in the left repository panel where you can park buttons that you intend to use in the Main display area. The events in this panel do not affect the recording. You can drag and drop events in the Main Display panel. 5.19.3 Main Display Area The Main Display area is the right panel where you create trigger and filter conditions.
PAGE 89
Recording Rules Events Teledyne LeCroy TABLE 5.3: Events and Event Actions Speed Change to 2.5Gb/s Speed Change to 5.
PAGE 90
Teledyne LeCroy Properties Dialog Boxes for Events TABLE 5.3: Events and Event Actions AHCI AHCI Register ATA Command NVME NVME Register NVME Command Submission NVME Command Completion 5.21 Properties Dialog Boxes for Events Properties dialog boxes provide additional settings for Events, States, and Actions in the Recording Rules page. You can access a Properties dialog by double‐clicking an Event, State, Action or any other object. It allows you to set triggers and filters.
PAGE 91
Properties Dialog Boxes for Events Teledyne LeCroy Description String This area contains a textual description of the event. Event‐specific Settings The largest part of the Event Properties dialog. The settings in this area vary for different events. Some events do not have any additional settings. Figure 5.28: Properties Dialog Box 5.21.3 Link State Dialog The Link Properties dialog lets you select the link state. Figure 5.
PAGE 92
Teledyne LeCroy 5.21.4 Properties Dialog Boxes for Events Ordered Set Properties Dialog An Ordered Set cannot be filtered in a Global State, but can be filtered in a Sequence State. Figure 5.30: Ordered Set Properties Dialog 5.21.5 Error Properties Dialog The Error Properties dialog lets you select specific error types for performing an action. There are two sets of Error types: Packet Errors and Idle Errors. Figure 5.
PAGE 93
Properties Dialog Boxes for Events 5.21.6 Teledyne LeCroy DLLP Packet Properties Dialog The DLLP Packet Properties dialog allows you to specify any DLLP field as shown below. Figure 5.32: DLLP Packet Properties Dialog The Layout tab of the DLLP Packet Properties dialog allows you to change the pattern and customize it by defining each specific bit as shown in the figure below. Figure 5.
PAGE 94
Teledyne LeCroy 5.21.7 Properties Dialog Boxes for Events TLP Header Properties Dialog The TLP Header Properties dialog enables you to set the TLP Header Fields and Layout, TLP Prefixes and Actions. You can manually change the Requester/Completer ID. Figure 5.34: TLP Header Properties Dialog 5.21.8 TLP Prefix Properties Dialog The Layout tab of the TLP Prefix Packet Properties dialog allows you to change the pattern and customize it by defining each specific bit as shown in the figure below.
PAGE 95
Properties Dialog Boxes for Events 5.21.9 Teledyne LeCroy AHCI Register Properties Dialog The AHCI Register Properties dialog allows you to enter the MBAR value, choose the Register and Address Type from the drop‐down list and enter the offset. Figure 5.36: AHCI Register Properties Dialog 5.21.10 ATA Command Properties Dialog The ATA Command Properties dialog allows you to change the pattern and customize it by defining each specific bit as shown in the figure below. Figure 5.
PAGE 96
Teledyne LeCroy Properties Dialog Boxes for Events 5.21.11 NVME Register Properties Dialog The NVME Register Properties dialog allows you to enter the MBAR value, choose the Register and Address Type from the drop‐down list and enter the offset. Figure 5.38: NVME Register Properties Dialog 5.21.12 NVME Command Submission Properties Dialog The NVME Command Submission Properties dialog allows you to change the pattern and customize it by defining each specific bit as shown in the figure below. Figure 5.
PAGE 97
Properties Dialog Boxes for Events Teledyne LeCroy 5.21.13 NVME Command Completion Properties Dialog The NVME Command Completion Properties dialog allows you to change the pattern and customize it by defining each specific bit as shown in the figure below. Figure 5.
PAGE 98
Teledyne LeCroy Properties Dialog Boxes for Events 5.21.14 Actions Properties Dialog Every Event has an Action tab as shown in Figure 5.41 on page 87. The following tables describes the Actions for each Event. TABLE 5.4: Event Actions Action Label Channels Internal Triggering External Triggering Sequence Filtering Local Timer Action Local Counter Local Counter Action Global Timer Global Timer Action Global Counter Global Counter Action 86 Description Label the action.
PAGE 99
Counter Teledyne LeCroy Figure 5.41: Actions Properties Dialog 5.22 Counter Counters can be created for any specific event or for multiple events. Counters function similar to an event and are independent of the event, thus allowing greater flexibility. You can select a counter for any event and if both channels are selected you can set the counter to count upstream and downstream. Counters can be reset providing further flexibility. The counter once set lives in the State.
PAGE 100
Teledyne LeCroy Counter Figure 5.42: Global and Sequence State Counters As shown in Figure 5.42 there is a Global Counter 1, set to the value of 2 on channel up displayed in green in the Global State and there are two counter 1s, set to the value of 2, one counting upstream and the other counting downstream displayed in pink in the Sequence State. 5.22.
PAGE 101
Counter Teledyne LeCroy Figure 5.43: Setting Global and Sequence State Counter Events 5.22.2 How to Increment or Reset a Counter You can Increment or Reset counters in the Global State and in the Sequence State by performing the following steps: 1. Open the Recording Rules page, select an event, and drag it to the Global State or Sequence cells. For details on these steps (see “Events with Channels” on page 96). 2.
PAGE 102
Teledyne LeCroy Counter Figure 5.44: Incrementing and Resetting Global and Sequence State Counters Note: Listed below are some of the considerations to note about the counter functionality 1. If a counter is reset, it will restore to it's original value, in this case the value defined by the user. 2. Resetting a counter will stop it and set it to it's original value. 3. Local counters for a particular state will automatically reset if the sequencer advances to another state.
PAGE 103
Timer Teledyne LeCroy 5.22.4 Deleting a Counter To delete a counter 1. Right‐click on the Counter. 2. Select Delete This Event. The counter will disappear from the event. 5.23 Timer The Timer has two options which are Start and Reset. When set to Start it starts the timer and when set to Reset it resets the timer to its initial value. When the timer count is down to 0 the action is triggered. The Global State timer can trigger, start an action. It can also affect some other timers and counters.
PAGE 104
Teledyne LeCroy Timer Figure 5.45: Global and Sequence State Timers As shown in Figure 5.45 there is a Global Timer A, set to the value of 1.000s on channel Up displayed in blue in the Global State and there is one timer A, set to the value of 1.000s on channel Down displayed in brown in the Sequence State.
PAGE 105
Timer Teledyne LeCroy 5.23.1 How to Set a Timer Timers are events and you can add a timer to the Global State or the Sequence State as an event by doing the following: Right‐click in the blue space in the Global or Sequence State and New Event > Timer. Figure 5.
PAGE 106
Teledyne LeCroy 5.23.2 Timer How to Start or Reset a Timer You can Start or Reset the Timer in the Global State and in the Sequence State by performing the following steps: 1. Open the Recording Rules page, select an event, and drag it to the Global State or Sequence cells. For details on these steps (see “Events with Channels” on page 96). 2. Right‐click on an event and select Specify Actions > Start Global Timer > Global Timer A or Timer B from the menu. See the figure below. Figure 5.
PAGE 107
Channel Teledyne LeCroy 5. In case of competing actions to control global timers using the same event from global and local states, the control from local states takes priority. 5.23.3 Changing the Value of the Timer To change the value of the timer: 1. Right‐click on the Timer. 2. Select Properties 3. Enter in values for the Timer in the fields provides in Secs, Millisecs, Microsecs and Nanosecs on the Timer tab. Figure 5.48: Setting the Timer Values 4.
PAGE 108
Teledyne LeCroy Filter Out Figure 5.49: Events with Channels 5.25 Filter Out A filter causes the Analyzer to filter out specified events from the recording. If events are filtered out of the recording, they are excluded from the Analyzer's buffer and not simply hidden from the CATC Trace. The purpose of filtering is to preserve recording memory so you conduct longer recording sessions and exclude events that do not interest you.
PAGE 109
Probe Settings 5.26 Teledyne LeCroy Probe Settings The Summit T28 analyzer can be optimized for specific DUT signal characteristics. The auto calibration feature in the Probe Settings allows for better signal recovery. There are 16, 0 db to 15 db, internal equalization modes in the analyzer hardware that boost the high frequency content of the captured signal.
PAGE 110
Teledyne LeCroy Probe Settings Figure 5.51: Probe Settings Tab You can auto configure the probe settings by clicking on the Auto Configure button. In order to calibrate the device the link should be trained to the widest width and the highest speed. Specify the link width, speed and lane polarity click Start Calibration (see Figure 5.52 on page 99). By default, the polarity settings are carried over from the recording options menu.
PAGE 111
Probe Settings Teledyne LeCroy To use the external reference clock or for quick calibration click the appropriate checkboxes to select them. If checked, calibration routine will only scan CTLE, if not checked it will include DFE with the CTLE scan which will take longer, approximately 9 minutes. Figure 5.52: Auto Configure Dialog The calculated CTLE values are automatically displayed in the relevant lane field. Click Save to save the settings or click Save As Default to save the settings as the default.
PAGE 112
Teledyne LeCroy Probe Settings Figure 5.
PAGE 113
Probe Settings 5.26.1 Teledyne LeCroy Save The Save function in the Recording Rules and the Probe settings tab has the following options (see Figure 5.54 on page 101):    Save the whole Recording Options (.rec) Save only the Recording Rules portions of the recording options (.rr) Save only the Probe Settings portions of the recording options (.ps) Figure 5.
PAGE 114
Teledyne LeCroy 5.26.2 Probe Settings Load The Load function in the Recording Rules and the Probe settings tab has the following options (see Figure 5.55 on page 102):     Load the whole Recording Options (.rec) Load the Recording Options of a PCIe Trace File (.pex) Load only the Recording Rules portions of the recording options (.rr) Load only the Probe Settings portions of the recording options (.ps) Figure 5.
PAGE 115
Chapter 6 Reading CATC Traces 6.1 Viewing PCI Express CATC Traces PETracer™ displays traffic as labeled, color‐coded, and time‐stamped rows. Tool tips provide details about fields within the CATC Trace. Hold the mouse cursor over a field to see a tool tip. Additional information is available from pop‐up menus. For example, if you click the left mouse button on the first cell in a packet a menu appears with an option to view Raw 10b Codes. 6.
PAGE 116
Teledyne LeCroy 6.3 Resizing Cells Resizing Cells Data cells can be resized by pointing the mouse pointer on the edge of a data cell, depressing and holding the left mouse button, and then repositioning the mouse pointer while keeping the mouse button depressed. 6.4 Pop-up Menus The Analyzer software makes extensive use of pop‐up menus.
PAGE 117
Show Raw 10b Codes 6.6 Teledyne LeCroy Show Raw 10b Codes You can view the raw bits that make up the data field by right‐clicking the field and selecting Show Raw 10b Codes from the pop‐up menu. To view Raw 10b Codes: 1. Right‐click the first cell in a packet. 2. Select Show Raw 10b Codes from the pop‐up menu to display the Raw 10b Codes window Figure 6.2: Show Raw 10b Codes Dialog 3. To change the format of the data, use the options along the right side of the dialog. 4.
PAGE 118
Teledyne LeCroy 6.7 Show Header Fields Show Header Fields You can view details about header fields by opening the Show Header Fields dialog. 1. Click a header. A pop‐up menu displays. 2. Select Show Header Fields. The following dialog opens. Figure 6.3: Viewing Packet Fields 3. Use the Prev and Next buttons to navigate to other headers.
PAGE 119
Packet Cell Popup Menus 6.8 Teledyne LeCroy Packet Cell Popup Menus The Packet cell has a right‐click pop‐up menu that includes the Show Raw 10b Codes command. 6.8.1 Set Start Quick Timing Marker Sets the start packet for the Quick Timing marker. An S symbol is displayed at the packet. Quick Timing provides immediate time deltas and bandwidth calculations.
PAGE 120
Teledyne LeCroy Packet Cell Popup Menus The right‐click pop‐up menu from Packet cell is displayed below: 6.8.1 Packet Header R-> Cell Popup Menu The Packet Header R‐> cell has a pop‐up menu with the Swap Upstream/Downstream command, which changes the directionality of the packets in the CATC Trace. 6.8.
PAGE 121
Set Marker 6.9 Teledyne LeCroy Set Marker A marker is a unique label for a packet that allows you to go to that packet and also serves as a comment string for a specific packet. When you select a marker, the identified packet appears at the top of the screen. Packets that have been marked have a red bar on the left edge. To set a marker, perform the following steps: 1.
PAGE 122
Teledyne LeCroy Edit or Clear Marker Figure 6.4: Create Marker for Packet Dialog Later, you can go directly to this packet using the Go To Marker operation in the Search Menu. 6.10 Edit or Clear Marker To change a markers identifier, or clear (delete) the marker: 1. Left‐click the Packet field of the desired packet to display a pop‐up menu (see Figure 6.5 on page 111).
PAGE 123
Compressed CATC Trace View Teledyne LeCroy Figure 6.5: Edit Marker Pop-up Menu 2. Choose Edit Marker and enter a new identifier into the Edit Marker for Packer # pop‐up, or Choose Clear Marker. When you choose Clear Marker, the marker is removed and the red line disappears. 6.11 Compressed CATC Trace View The Compressed CATC Trace view shows fields in the format “Attribute: Value”, whereas the normal CATC View shows the attribute name on top and the value below.
PAGE 124
Teledyne LeCroy Spreadsheet View Figure 6.6: Compressed CATC Trace  6.12 Click on the toolbar to return to the normal CATC Trace View, or Select View > Trace Views > CATC Trace. Spreadsheet View You can view the CATC Trace as a spreadsheet in color or black and white. Click 112 on the toolbar to display the Spreadsheet View (see Figure 6.7 on page 113).
PAGE 125
Spreadsheet View Teledyne LeCroy Figure 6.7: Spreadsheet View (Color)  Click on the toolbar to display the Spreadsheet View B/W. Figure 6.
PAGE 126
Teledyne LeCroy 6.12.1 Spreadsheet View Columns To add a column, right‐click a column header, select Add Column, and then select the column name. To delete a column, right‐click a column header and then select Remove Column. To reposition a column, drag the column header to the new position. To resize columns, select the column divider and drag the divider to the right or left. Each of the SSD options (NVMe, AHCI, ATA) can be viewed and has its own customizable column configuration.
PAGE 127
Spreadsheet View Teledyne LeCroy  Right‐click in the empty space and select Restore views to default positions to display a confirmation dialog. Click Yes to restore for specific transaction level. Figure 6.11: Right-click Empty Space Restore Views to Default Positions Dialogs  Select Setup > Display Options to display the Display Options dialog. Click Restore Factory Settings. Figure 6.
PAGE 128
Teledyne LeCroy 6.12.
PAGE 129
Decoding Traffic 6.12.3 Teledyne LeCroy Detail View and Spreadsheet View In the Spreadsheet View, double‐click a packet, transaction, or transfer, or select a field and then click on the toolbar, to display the Detail View. To put a Detail View header as a column in the Spreadsheet View, drag the header to a column divider in the Spreadsheet View. Figure 6.13: Detail View in Spreadsheet View 6.13 Decoding Traffic The PETracer software has several decode levels: 6.13.
PAGE 130
Teledyne LeCroy Decoding Traffic   If AER_CAP_VER = 1 and it is a Root Port or RC Event Collector, there are 14 DWs (00h to 34h)in the total AER Capability structure. If AER_CAP_VER = 2 then, there are 18 DWs (00h to 44h) in the total AER Capa‐ bility structure. In fact, there are PCI‐E 3.0 compliant devices that have AER_CAP_VER=1. Example H/W: A PCI‐E 3.0 device that supports Multiple Header Recording, but does NOT support TLP Prefixes.
PAGE 131
Decoding Traffic 6.13.4 Teledyne LeCroy NVM NVM level decode displays NVMe transactions. PETracer decodes the storage commands starting from lower Transaction Layer decodes. In the case of NVMe, it will decode first the Packet Level, then the Link Transaction level, then the Split Transaction Level and finally the NVME decode level. Note: The trace must contain the device enumeration sequence so the decoding picks up the associated base addresses and NVMe transactions can be properly decoded.
PAGE 132
Teledyne LeCroy 6.13.6 Decoding Traffic AHCI AHCI level decode displays AHCI transactions. PETracer decodes the storage commands starting from lower Transaction Layer decodes. In the case of AHCI, it will decode first the Packet Level, then the Link Transaction level, then the Split Transaction Level and finally the AHCI decode level. Note: The trace must contain the device enumeration sequence so the decoding picks up the associated base addresses and AHCI transactions can be properly decoded.
PAGE 133
Chapter 7 Searching CATC Traces This chapter describes how to search for CATC Trace events. 7.1 CATC Trace Search Overview Several search commands let you navigate a CATC Trace view to search for key events, such as errors and triggers. To view the search options, click Search in the Menu bar. 7.2 Go to Trigger To position a trigger packet at the top of the screen: Select Search > Go to Trigger. 7.3 Go to Segment/Packet To position a packet at the top of the screen: 1.
PAGE 134
Teledyne LeCroy Go to Packet 2. Enter the packet number, marker, or time. 3. Click OK. 7.4 Go to Packet To position a transaction at the top of the screen: 1. Select Go to Packet from the Search menu. A pop‐up menu prompts you for the packet number, marker, or time. 2. Choose the needed transaction level from the Packet drop‐down list and enter the transaction number. Please note that transaction levels is added to list if corresponding level is decoded for current trace file. 3. Click OK. 7.
PAGE 135
Go To Marker 7.6 Teledyne LeCroy Go To Marker Use this operation to go directly to a specific packet or transaction that has been marked with a unique marker by the Set Marker operation. To go to a marker: 1. Select Go To Marker from the Search Menu. 2. Select the marker you want from the fly‐out menu. Alternatively, select All Markers to display the All Markers and Playlists dialog, then select a marker and click Goto. Deletes selected Marker The packet you want appears at the top of the screen.
PAGE 136
Teledyne LeCroy 7.6.1 Go To Marker Markers This section explains the features of Markers. A marker is an entity that flags a physical or logical item of interest within a trace file. A marker contains one or more attachments. You can add a marker to a trace file or unmark a trace file by removing the marker. Markers are represented graphically in a different way in the application.You can not only add markers to the packets but it is granular enabling you to also add markers to individual cells.
PAGE 137
Go To Marker Teledyne LeCroy Figure 7.14: Create Marker for Packet Dialog Click Enter to close the Marker dialog. Click ALT>Enter to add a new line. As shown above you can: Add icon. Click on this icon to add any file. See “Adding an Attachment” on page 126. Record icon. Click on this icon to record audio. See “Recording an Audio File” on page 126. New URL icon. Click on this icon to add any URL. 7.6.2 Export icon. Click on this icon to export an attachment. Delete icon.
PAGE 138
Teledyne LeCroy 7.6.3 Go To Marker Adding an Attachment Perform the following steps to add an attachment to a marker: 1. Right‐click on any cell in the trace and select Set Marker. The Create Marker window displays. 2. Click on the Add icon. The Add File to the Marker dialog displays. 3. Go to the file and select it to add it to the marker as an attachment. 4. Click Open. The file will appear in the Create Marker for Transfer... dialog as shown below.
PAGE 139
Go To Marker 7.6.5 Teledyne LeCroy Video Files Supported The user can attach video clips to the trace file (“add to the marker”). The playback of the Video clips is limited to the formats that are supported by the video codecs installed in the system. 7.6.6 Attachment Types and Visualization The markers are represented graphically by a yellow triangle at the top right of the marked item and a red vertical bar at the left‐most cell of a packet as shown below.
PAGE 140
Teledyne LeCroy 7.6.8 Go To Marker Viewing Attachments of a Marker If you hover over the marked cell (yellow triangle at the top right of the marked item), refer to “Attachment Types and Visualization” on page 127, a window pops up displaying the contents of the marked cell as shown below. While hovering over the marked cell, it can start playing the start of the audio or video file, but it will stop after a short time due to the Anaylzer’s host system timeout for Tooltips.
PAGE 141
Go To Marker Teledyne LeCroy If there are attachments, the status bar is hidden. You can move the cursor to an attachment icon in the list view and a preview of the attachment starts. Figure 7.19: Preview Attachments Pop-up Window Audio Audio snippets that are recorded and attached to certain point of interest in a trace can be played. The basic Play, Start, Stop, Pause buttons are displayed to listen to the audio file.
PAGE 142
Teledyne LeCroy Go To Marker Video Video clips that are recorded and attached to certain point of interest in a trace can be played. The video is embedded in the tooltip with simple playback controls. File Attachment You can attach any kind of file, including images, PDFs, documents, media files, etc. URL Link You can specify a URL that links to a web page (i.e., YouTube), a network location, or a local file‐system location. Web Link Due to the small size, the web page is not embedded in the callout.
PAGE 143
Go To Marker Teledyne LeCroy YouTube Video YouTube’s video player is embedded for YouTube Video playback. Images The image is embedded in the trace. Other Attachments Click the Open button to open the attachment file with the system’s default application for that file type.
PAGE 144
Teledyne LeCroy 7.6.9 Go To Marker Edit Marker To edit a marker, right‐click on the marked item and select Edit marker from the menu or Ctrl + L. The Edit Marker dialog displays. This Edit Marker window can be used to edit one marker at a time. You can do the following in the Edit Marker dialog:        Edit text attachment. Record audio attachment. Add URL link attachment Add a file attachment. Click on File and click the Open button or drag and drop the file.
PAGE 145
Go To Marker Teledyne LeCroy          All attachments within the marker are displayed. Hovering over the marker dis‐ plays a tool‐tip displaying the size of all the attachments. You can collapse or expand the item marked to view the attachments. The Time and size of audio and video files are displayed. You can edit Playlists from this window. You can edit, delete a marker or delete all markers from this location. You can filter attachments within the marker.
PAGE 146
Teledyne LeCroy CATC Walk Playlist Clicking delete on markers to delete markers with attachments displays the Delete Marker(s) dialog. Checking the “Dont ask again” checkbox will not display this confirmation dialog again. Figure 7.23: Confirmation Dialog 7.7 CATC Walk Playlist This feature allows users to configure sequences of attachments into playlists. Any arbitrary order of attachments are allowed, and there are no limits on the number of playlists supported.
PAGE 147
CATC Walk Playlist 7.7.1 Teledyne LeCroy Playlist Functionality You can do the following to manage playlists:      Remove or edit current playlists Edit the playlist name Edit the playlist description List the sequence of attachments in current playlist List of all available attachments and drag/drop to a playlist. As shown in the previous figure the Playlist window lists the markers with their attachments on the left and the playlist on the right. Figure 7.
PAGE 148
Teledyne LeCroy 7.7.2 CATC Walk Playlist Playback Window To playback a playlist, click on the View menu in the top toolbar of application, select CATC Walk and then select Play > Playlist 1 as shown below. Figure 7.26: View Dialog The attachment item starts to play in the playback window as shown below. Figure 7.27: Playback Window The playback window is resizable.
PAGE 149
Go To Menu Teledyne LeCroy   Volume slider Playback speed slider (for text attachments) As a playlist is played back, the playback window is displayed in close proximity to the marked area, just like a regular tooltip window. As the playback progresses, the view jumps to the element corresponding to the current attachment being played and the marked element is highlighted. During playback the user is prevented from interacting with the trace.
PAGE 150
Teledyne LeCroy Find selected, the search order is reversed. For example, if the previous search was forward, choosing Search Direction toggles the current search to backward. To verify the direction of a search look at the lower right corner of the screen. Search: Bwd or Search: Fwd should appear. If a direction is not indicated, it means that the status bar is turned off. To turn on the Status bar, select from the menu View > Status Bar.
PAGE 151
Find Teledyne LeCroy Figure 7.29: Find Dialog 3. From the Search For menu, select a display level such as Packets. To search multiple levels, finish steps 3 to 9, and then repeat 3 to 9 for each additional display level. 4. From the Event Groups menu, select an Event Group. The menu in the far right of the dialog is context sensitive and changes to reflect the options for that group. 5. In the menu in the far right, select one or more items. 6.
PAGE 152
Teledyne LeCroy Find The options Union, Intersection, and Exclusion let you set conditions on your searches: Union: To search for any of the selected criteria. Example: “Find packets with ANY of the following characteristics …”  Intersection: To search for all of the selected criteria. Example: “Find packets with ALL of the following characteristics …”  Exclude: To exclude items from a search. This option works in conjunction with Union and Intersection.
PAGE 153
Find Teledyne LeCroy     Direction Errors TS1 Data (see “TS1 and TS2 Event Groups”) TS2 Data (see “TS1 and TS2 Event Groups”) The Event Groups for Link Transactions, Split and PQI Transactions are:         TLP Type Traffic Class Virtual Channel Direction RequesterID CompleterID Status Tag The Event Groups for NVM transactions are:        Controller Registers Doorbell Registers Admin Submission Command Set Admin Completion Command Set NVM Submission Command Set NVM Completion Comman
PAGE 154
Teledyne LeCroy Find TS1 and TS2 Event Groups Selecting TS1 Data or TS2 Data options allows further definition of the exact field contents to match via the three dialogs show below. The search algorithm will find the specified TS ordered set on any lane. Figure 7.30: TS Data Fields Tab Select parameters from the drop‐down lists to use. Figure 7.31: TS G1/G2 Layout Tab Select parameters from the links to use and enter the mask and match values.
PAGE 155
Search for the Next Packet Type Teledyne LeCroy Figure 7.32: TS G3 Layout Tab Select parameters from the links to use and enter the mask and match values. 7.11 Search for the Next Packet Type Use Find Next or click to search for the next packet meeting the search criteria.
PAGE 156
Teledyne LeCroy 144 Search for the Next Packet Type Summit T28 PCI Express Multi‐Lane Protocol Analyzer User Manual
PAGE 157
Chapter 8 Display Options 8.1 Setting Display Options Display Options allow you to customize the colors and formats of displayed traffic. To open the Display Options dialog at the General tab, Select Setup > Display Options from the menu or click the Display Options button on the toolbar. Figure 8.
PAGE 158
Teledyne LeCroy 8.2 Specifying General Display Options Specifying General Display Options The Display Options General tab allows you to specify: Zoom Level: Defines the size of packet fields in the packet view. Zoom level is adjustable as 10, 20, 40, 60, 80, 100, 120, 140, 160, 180 and 200 percent. Enable Tool tips: Allows information to be displayed on a packet by resting your mouse pointer over it. Wrap: Allows packets, Link Transactions, and Split Transactions to wrap within the display.
PAGE 159
Specifying General Display Options Teledyne LeCroy Figure 8.2: Expanded Data Field 8.2.2 Fonts Fonts: Allows the appearance of field text and/or data text to be defined. 8.2.3 Configuration Name Display Configuration Name: This field is used to enter a text string to be associated with the current set of Display Options. This name is saved with the Display Options file, and appears as part of the title of the packet view window that uses this set of Display Options. 8.2.
PAGE 160
Teledyne LeCroy Specifying General Display Options Figure 8.3: Display Options Dialog - Color/Format/Hiding Tab 8.2.5 Setting Field Colors The Field Colors tab allows you to customize the colors associated with each field used in the packet view. You may experiment with this option to achieve a color combination that suits you.
PAGE 161
Specifying General Display Options Teledyne LeCroy 3. Under the Group and Colors column, click the plus symbol (+) next to the group you want to reformat. The group expands to show the individual fields within the group. Each field has a color, as shown below: 4. Click the colored cell that you want to change. A color palette appears. 5. Click a color in the palette, then click Apply or OK.
PAGE 162
Teledyne LeCroy 8.2.6 Specifying General Display Options Changing Field Formats The Field Formats tab allows you to define the way various numeric fields are shown in the packet display. You can select Hexadecimal, Decimal, Binary, or ASCII for certain fields or groups of fields. To change a field's format, click the plus sign (+) next to a field in the list. This causes the selected item to expand so you can see its constituent sub‐fields.
PAGE 163
Specifying General Display Options Teledyne LeCroy 2. Click the row representing the field that you want to reformat. If the field can be reformatted, the format options at the top of the dialog become active, as shown below: 3. Select a format. 4. Specify the bit order in the displayed fields by checking/unchecking the MSB > LSB checkboxes. 5. Click Apply or OK. 8.2.7 Hiding Fields To hide a field: 1.
PAGE 164
Teledyne LeCroy Specifying General Display Options Figure 8.6: Display Options Dialog - Level Hiding Tab To hide a level: 1. 2. 3. 4. 5. Select an Event Group. Select whether to Hide or Show selected items. Select Upstream, Downstream, or Any Direction. (Optional) Select Compact EIEOS packets. Click OK.
PAGE 165
Specifying General Display Options          Teledyne LeCroy DLLP Header DLLP Virtual Channel ACK/NAK Seq Number Ordered Sets Link Event Direction Errors TS1 Data TS2 Data The Event Groups for Link Transactions, Split and PQI Transactions are:         TLP Type Traffic Class Virtual Channel Direction RequesterID CompleterID Status Tag The Event Groups for NVM transactions are:        Controller Registers Doorbell Registers Admin Submission Command Set Admin Completion Command Se
PAGE 166
Teledyne LeCroy Load a Previously Saved Display Options File      8.3 ATA CFIS Fields ATA RFIS Device to Host Fields ATA DSFIS Fields ATA PSFIS Fields ATA SDBFIS Fields. Load a Previously Saved Display Options File If you have previously saved Display Options, you can load them by opening the Display Options dialog and clicking the Load button. A dialog opens to let you load a previously saved display options file. 1. Click Load to use a previously defined display options file. 2.
PAGE 167
Chapter 9 BitTracer Recording Note: BitTracer Recording is an optional feature. The Summit T28 analyzer has an optional BitTracer data capture mode, which captures bi‐ directional link traffic in raw format. The BitTracer recording mode captures and displays traffic before lane‐to‐lane de‐skew operations and before descrambling of 10b bytes. The BitTracer mode includes support for multiple logical links (bifurcations) on a single physical link.
PAGE 168
Teledyne LeCroy Views Available for Captured Data . In Bit Tracer Recording, you can use the Snapshot, Manual Trigger, and Event Trigger recording types. Note: You can also use other standard Recording Options, such as Link Width, Buffer Size, and Lane Polarity Settings, to characterize the link. 9.2 Views Available for Captured Data BitTracer mode displays captured data lane‐by‐lane and byte‐by‐byte in each direction (upstream and downstream), with the time scale progressing left to right.
PAGE 169
Data Display Formats Teledyne LeCroy You can automatically de‐skew an entire lane direction. First, left‐click on the direction in the data window. Then right‐click to display a popup menu. Then select Auto De‐Skew. You can de‐skew only one direction for each right‐click operation. To automatically de‐ skew the opposite direction, first left‐click on that direction in the data window. 9.
PAGE 170
Teledyne LeCroy Report and Analysis Windows    Signal presence Background of the Markers Bar (see “Markers Bar” on page 159) (color coded according to traffic speed). All symbols of a TS1/TS2 ordered set By default, these color selections match the standard color selections used in the CATC Trace format. You can modify them in the Display Options menu, accessible from the Main toolbar or the Setup menu. 9.
PAGE 171
Timing Measurements Bar 9.7.1 Teledyne LeCroy Markers Bar The Trigger marker trigger condition. is at the point where BitTracer recognized the user‐defined To set an X marker , left‐click anywhere in the data display, except for the light gray bar located above the data and below the directional label. To set a Y marker .right‐click anywhere in the data display, except for the light gray bar located above the data and below the directional label.
PAGE 172
Teledyne LeCroy Errors Bar Figure 9.1: Markers Window Timing measurements between all combinations of X, Y, U, and Trigger cursors are in the Timing window. Figure 9.2: Timing Window 9.8 Errors Bar BitTracer mode provides a summary of 10b errors (invalid symbols) and disparity errors in the Errors window. The window shows the total error count and errors per‐lane for each error type. Hyperlinks allow jumps to selected errors (see Figure 9.3 on page 161).
PAGE 173
Errors Bar Teledyne LeCroy Figure 9.3: Errors Window BitTracer mode also highlights errors:   Invalid symbols have a black background. Bytes with incorrect running disparity have red borders.
PAGE 174
Teledyne LeCroy 9.9 Symbols Bar Symbols Bar The Symbols window provides a summary of the different symbol types captured, by quantity and direction, and includes hyperlinks for jumps to selected symbols. Expanding the + sign at the left of each symbol provides a summary of symbols by lane. Figure 9.4: Symbols Window 9.10 Events Bar The Events report window summarizes Link Up, Link Down, and Speed Switch events for Upstream and Downstream. Figure 9.
PAGE 175
Packets Bar 9.11 Teledyne LeCroy Packets Bar The Packets report window summarizes packet types detected in the file. Note: To obtain packet types, you must perform a post‐capture “Analyze” step. After capture, when you open the Packets Bar for the first time, items can display the command “Analyze”. To start the analysis, click the word Analyze. After analysis finishes, the results are saved with the file. Therefore, you do not need to click Analyze the next time. The table entries are hyperlinks.
PAGE 176
Teledyne LeCroy 9.12 Decoding Bar Decoding Bar If you select them in the data view, or search or jump locates a feature, BitTracer mode displays ordered sets and packets in the Decoding window:   Logical view is identical to CATC Trace format. Specification view provides a more elementary display. The Specification view includes an option to display data in hex or binary format.
PAGE 177
Link Configuration Teledyne LeCroy Figure 9.8: Search Window You can copy data shown in the BitTracer display across a lane (horizontally) or across multiple lanes (vertically), and then paste it into the Search Pattern window. The Search Pattern window stores previous search values, which you can recall by selecting the Search Pattern drop‐down button. In the Pattern Format section, select to search in 10‐bit Codes, Scrambled Bytes, or Descrambled Bytes format.
PAGE 178
Teledyne LeCroy Link Configuration Use the polarity checkbox to invert lane polarity on the selected lane or use the +/‐ toolbar icon. Use the scrambling option to select a scrambling algorithm, as per specification 1.0a or legacy specification 1.0. Note: This dialog applies to one direction at a time (upstream or downstream). Left‐click in the direction in the data display to edit the configuration for that direction. Figure 9.
PAGE 179
Export of BitTracer Capture to CATC Trace Format 9.15 Teledyne LeCroy Export of BitTracer Capture to CATC Trace Format You can export BitTracer captures to standard CATC Trace file formats, selecting the Export option from the File menu. Note: You should use the Auto De‐skew feature before using the export feature. The exported CATC Trace keeps association information with the original BitTracer file. Such traces scroll synchronously when you select the Synchronize Traces option in the Windows menu.
PAGE 180
Teledyne LeCroy Opening and Saving BitTracer Captures Figure 9.10: Export Packets to Comma Delimited Text Dialog Compressing and Expanding the Data View You can compress (zoom out) the horizontal timing of the displayed data to view higher‐ order link behaviors. You can expand (zoom in) to examine higher‐resolution views. To zoom in or zoom out, right‐click the data view, then select a command or select a zoom icon on the toolbar.
PAGE 181
Chapter 10 Reports and Tools Reports assist you in analyzing traffic recorded by the Analyzer. The available reports are:                  File Information: To view general information about the CATC Trace file. Error Summary: To view a count of errors in a CATC Trace file.
PAGE 182
Teledyne LeCroy 10.1 File Information File Information The File Information window provides a summary on the currently displayed file. Select Report > File Information to obtain the Trace Information window. Figure 10.
PAGE 183
Error Summary Teledyne LeCroy Figure 10.2: File Information Window 2 10.2 Error Summary The Error Summary dialog displays the number of errors for each event and the packet containing the errors. Select Reports > Error Summary to open the Error Summary dialog (see Figure 10.3 on page 172).
PAGE 184
Teledyne LeCroy Error Summary Figure 10.3: Error Summary Dialog 10.2.1 AHCI Error Summary The AHCI Error Summary dialog is a sub‐entry for the main Error Summary dialog. It displays the number of errors for each AHCI transaction containing the errors. Select Reports > Error Summary to open the Error Summary dialog (see Figure 10.4). Figure 10.
PAGE 185
Error Summary Teledyne LeCroy Figure 10.5: Reserved Field Not Filled With Zeroes Note: Reserved fields for AHCI level are not displayed when filled with all 0s. Incomplete The AHCI transaction does not contain enough data or lower‐level transactions (Link or Split) are marked as incomplete. Figure 10.6: Incomplete Logical Error One or more fields are in an inconsistent state relative to the other fields in the same or other registers. Figure 10.
PAGE 186
Teledyne LeCroy Traffic Summary Unknown The AHCI decoder is unable to decode a particular transaction correctly. This can be caused by a distorted trace file. Figure 10.9: Unknown Checks for Logical error and Read‐only field depending on the values obtained from previous registers. It can result in false‐positive or false‐negative detections in case of partially saved trace file. The AHCI transaction can be marked as incomplete in case of saving a portion. 10.
PAGE 187
Traffic Summary Teledyne LeCroy Figure 10.10: Traffic Summary Dialog Buttons at the top of the Traffic Summary window change the display format and enable data to be exported to email, file, or the printer. 10.3.1 AHCI Traffic Summary The AHCI Traffic Summary window summarizes the AHCI traffic in the current CATC Trace. The right side displays a summary of AHCI transactions and errors. Select Reports > Traffic Summary to open the Traffic Summary dialog (see Figure 10.11). Figure 10.
PAGE 188
Teledyne LeCroy 10.3.2 Traffic Summary Using the Traffic Summary Window to Search the CATC Trace You can use the Traffic Summary window to move the CATC Trace to packets of interest: 1. Click one of the numbers in the right side of the Traffic Summary window. The CATC Trace jumps to the first instance of the selected protocol (See the following figure). . The CATC Trace jumps forward or backward 2. Click the up or down arrows through the display to the next instance of selected protocol level. 10.3.
PAGE 189
Bus Utilization Teledyne LeCroy Options. Opens a drop‐down menu with the following options: Grid Lines: Displays/Hides grid lines Row Selection: Allows entire rows to be selected Tight Columns: Reformats column widths to match data Event Navigation: Skip Hidden Items Show Hidden Items Prompt each time 10.4 Bus Utilization Select Report > Bus Utilization from the menu or press window. to open the Bus Utilization Figure 10.
PAGE 190
Teledyne LeCroy Bus Utilization The Bus Utilization window displays information on bandwidth use for the transmit and receive channels. 10.4.1 Bus Utilization Pop-up Menu You can reformat the display by right‐clicking a graph and making a selection from the Bus Utilization pop‐up menu (see the following figure). Go to Packet #: Relocates the CATC Trace to the selected packet number. Undo Zoom: If you have zoomed in, this command undoes the zoom.
PAGE 191
Bus Utilization Teledyne LeCroy Figure 10.13: Graph Area Properties Dialog 10.4.2 Bus Utilization Buttons The Bus Utilization window buttons allow you to reformat the display and export data. Button Function Save. Saves Bus Utilization data to a bitmap file (*.bmp). Email. Opens an email and attaches a bitmap file of the Bus Utilization data.
PAGE 192
Teledyne LeCroy Bus Utilization Print. Prints the Bus Utilization data. Full Screen. Maximizes the Bus Utilization window. View Settings. Opens a sub‐menu with the following choices: • Orient Horizontally • Tile Vertically • Show Markers • Show Plumbline • Status >> • Bar • Tool tips • None • Grid Lines >> • Both Axes • X Axis • Y Axis • No Grid • Grid on Top • Fonts & Colors Horizontal zoom in Horizontal zoom out Vertical zoom in Vertical zoom out Click and Drag zoom.
PAGE 193
Link Tracker Teledyne LeCroy Graph Areas. Provides options for creating and displaying additional graphs of data lengths, packet lengths, and percentage of bus used. 10.5 Link Tracker The Link Tracker window displays a detailed chronological view of events. Events are shown on a channel‐by‐channel basis in columns within the window . Figure 10.14: Link Tracker Window Each time slot in the vertical axis represents the minimum time that a DWORD requires to traverse the bus.
PAGE 194
Teledyne LeCroy 10.5.1 Link Tracker Using the Link Tracker Window The Link Tracker window can be reformatted in several ways. 10.5.2 Zooming In and Out Zooming out can give you a quick, high‐level view of a CATC Trace. A fully zoomed out CATC Trace only shows columns and colored lines. Using the colors, you can see what types of traffic run through the CATC Trace (see the following figure).
PAGE 195
Link Tracker 10.5.3 Teledyne LeCroy Collapsing Idle Time, Enabling Tool tips, and Resetting Column Widths Click the View Options button to open a menu with options for formatting the display. Three options are presented: Collapsible Idle Time: Opens a dialog box for setting the Idle time value. Setting a value tells the Analyzer when to collapse Idle times and display them as grayed out strips within the Bus View window. Tooltip Display: Opens a menu with options for adding content to Tooltips.
PAGE 196
Teledyne LeCroy 10.5.4 Link Tracker Docking and Undocking the Window You can undock the Link Tracker window by double‐clicking the blue title bar along the left side of the window. Once undocked, the window can be dragged anywhere in the application. To redock, double‐click again on the title bar. 10.5.5 Setting Markers Markers can be set on any event within the Link Tracker window. To set a marker, right‐click an event, then select Set Marker from the pop‐up menu.
PAGE 197
Link Tracker 10.5.7 Teledyne LeCroy Hiding Traffic You can hide Idles and other data from the Link Tracker window by clicking the Hide buttons on the toolbar. 10.5.8 Link Tracker Buttons The Link Tracker window has a row of buttons for changing the format of the displayed data and for exporting data: The buttons have the following functions: Full Screen. Expands the Link Tracker window to fill the entire screen. View Options.
PAGE 198
Teledyne LeCroy Data Flow Window Collapse Idle Plus. Do not show periods of Link being idle. Show Values Show Scrambled Values Show 10b Codes Show Symbols Show Text 10.6 Data Flow Window The Data Flow window shows marker, packet, direction, type, length, address, payload, handshake, and timestamp information. To obtain the Data Flow window, select Report > Data Flow or click the Data Flow toolbar icon. Figure 10.
PAGE 199
Flow Control Tracking Teledyne LeCroy The toolbar allows you to:     Expand the window to full screen or Collapse to a smaller window. Synchronize. Save. Select Data Flow columns to display and their widths:  Marker  Packet  Direction  Type  Length  Address  Payload  Handshake  Time Stamp Figure 10.16: Data Flow Columns Dialog 10.7 Flow Control Tracking The Flow Control View mode highlights portions of the packets that affect flow control and displays flow control values.
PAGE 200
Teledyne LeCroy Using the CATC Trace Navigator Figure 10.17: Flow Control Display If the trace includes Flow Control initialization, PETracer detects the amount of available credits based on the values advertised in InitFC packets. If the InitFC packets are not in the trace, the amount of available credits can be set using the FC Credit Setup dialog (see the following screen capture). Select View > FC Credits Setup... displays the FC Credit Setup dialog (see the following screen capture).
PAGE 201
Using the CATC Trace Navigator 10.8.1 Teledyne LeCroy Displaying the Navigator Click in the toolbar to display the Navigator. The Navigator appears on the right side of the Main window. It has a two‐button toolbar and a vertical slider bar. It also has colored panes for navigating the CATC Trace in different ways. You set which panes are displayed through Navigator pop‐up menus. Figure 10.19: Navigator Dialog 10.8.2 Navigator Toolbar The Navigator toolbar lets you quickly set Navigator features.
PAGE 202
Teledyne LeCroy Using the CATC Trace Navigator Navigator Panes: This button has two purposes: To select which Navigator panes appear and to bring up the Navigator legend. The legend determines how information is shown in the panes. 10.8.3 Navigator Ranges You set the viewing range by dragging the yellow range delimiters along the slider. To set the lowest packet viewable, drag the top delimiter up. As you do so, a tool tip appears to indicate the current range.
PAGE 203
Using the CATC Trace Navigator Teledyne LeCroy The menu has the following options:    10.8.6 Set Range to Whole Trace: Allows you to reset the range to include the entire CATC Trace file contents. The top range delimiter is placed at the lowest packet number in the CATC Trace. The bottom range delimiter is placed at the highest packet number in the CATC Trace.
PAGE 204
Teledyne LeCroy Using the CATC Trace Navigator information. The top of each pane represents the start of the CATC Trace file, and the bottom represents the end of the CATC Trace file.      10.8.7 Pre/Post Trigger: To view the trigger event in the CATC Trace and the relative size of pre‐trigger and post‐trigger portions of the CATC Trace. The two portions are set apart as different colors. The trigger event occurs at the point the two colors meet. Errors: To view any errors in the CATC Trace.
PAGE 205
Using the CATC Trace Navigator Teledyne LeCroy Figure 10.20: Navigator Pane and Navigator Legend Dialog The Navigator Legend dialog has areas corresponding to each of the panes. Each area has check boxes that allow you to hide/display information in the pane. You can set the priority of information displayed in the panes using the up and down triangles on the right. 10.8.
PAGE 206
Teledyne LeCroy Detail View In the case of the Traffic Type pane, priority determines display priority of each packet type. For portions of the CATC Trace that are dominated by a particular packet type, this setting no effect: only the color corresponding to that packet type is displayed in that portion of the pane. Suppose, however, that part of the CATC Trace includes equal or near equal numbers of several types of packets.
PAGE 207
LTSSM Flow Graph Teledyne LeCroy 10.10 LTSSM Flow Graph The LTSSM Flow Graph shows link state transitions that the link goes through, as recorded in the CATC Trace file. To obtain the LTSSM Flow Graph, select Report> LTSSM Flow Graph. Figure 10.22: LTSSM Flow Graph Dialog You can display the following directions:    Upstream Downstream Both You can Show Number of Transitions. Click the blue button (on the Recovery state below) to see the substate.
PAGE 208
Teledyne LeCroy Packet Header Bar 10.11 Packet Header Bar The Packet Header bar shows packet header information. To obtain the Packet Header bar, select Report > Packet Header or click the Packet Header toolbar icon. Figure 10.23: Packet Header Bar The toolbar allows you to Save, go to Previous or Next, display Hexadecimal or Binary, and show the Packet Data window.
PAGE 209
Packet Data Window Teledyne LeCroy 10.12 Packet Data Window The Packet Data window shows packet or transaction payload. To obtain the Packet Data window, select Report > Packet Data or click the toolbar icon. Figure 10.24: Packet Data Window The toolbar allows you to Save; go to Previous or Next; display Hexadecimal, ASCII, Decimal, or Binary; use MSB Format or LSB Format; and use Big Endian or Little Endian. Format and Columns allows you to enter the number of bytes, words, or dwords per line.
PAGE 210
Teledyne LeCroy Configuration Space View 10.13 Configuration Space View The Configuration Space View displays information about the Configuration Space state as of the current packet of the currently selected device. The view shows the Configuration Space Header and the PCI‐compatible or PCI Express Capability Structures. To display the Configuration Space View for a device at a packet: 1. Open a CATC Trace, such as the sample file cfg_pci_express.pex. 2. Scroll to a packet with a Configuration header.
PAGE 211
Using Unit Metrics Teledyne LeCroy Figure 10.25: Configuration Space View On the left, the view displays the Configuration Space for the selected CompleterID or DeviceID at the current packet. You can select Configuration Space Header or a Capability Structure. The right displays the decoded data of the selected Configuration Space Header or a Capability Structure, up to the current packet. (The decoding builds while navigating through the next packets.
PAGE 212
Teledyne LeCroy Metrics Defined for Link Transactions 10.15 Metrics Defined for Link Transactions     Number of Packets: The total number of packets that compose this Link transac‐ tion. Payload: The number of data payload bytes this Link transaction transferred. Response Time: The time it took to transmit this Link transaction on the PE link, from the beginning of the first packet in the transaction to the end of the last packet in the transaction.
PAGE 213
Show Metrics in the CATC Trace Display Teledyne LeCroy Following is a collapsed metrics display for a unit of Split Transaction. The collapsed header display shows only the metrics cell representing Number of Link Transactions. 10.16.2 Metrics Tool Tip Display In both CATC Trace level views, you can view the summary of all the unit metrics in the Metrics header tool tip. To view the tool tip, simply place the mouse cursor over the Metrics header.
PAGE 214
Teledyne LeCroy Show Metrics in the Traffic Summary Window 10.17 Show Metrics in the Traffic Summary Window Some of the Traffic Summary reports at the Link and Split Transaction levels are based on metrics collected for the corresponding protocol units in the CATC Trace. 10.17.
PAGE 215
Show Metrics in the Bus Utilization Window Teledyne LeCroy 10.17.2 Reports at the Link Transaction Level The following metric‐based reports are displayed at the Link Transaction level: Link Transaction Performance: This report table groups the Link Transactions by TLP Type and displays Minimum/Average/Maximum data for Number Of Packets, Response Time and Payload Bytes metrics. Memory Writes: This report table includes only the Link Transactions that present Memory Write Requests.
PAGE 216
Teledyne LeCroy Show Metrics in the Bus Utilization Window 3. 4. 5. 6. 7. Latency Time at Split Transaction level. Throughput Per Transaction at Split Transaction level. Response Time and Latency Time at Split Transaction level (combined graph). Response Time at Link Transaction level, for Memory Writes only. Throughput at Link Transaction level, for Memory Writes only. The following is an example of Bus Utilization window display of graph numbers 1, 4, 5, 6 and 7: 10.18.
PAGE 217
Show Metrics in the Bus Utilization Window Teledyne LeCroy 10.18.2 Bus Utilization Window Features For the seven Split‐ and Transaction‐level graphs listed, all Bus Utilization window features are available, such as zooming in/out, changing scale type, scrolling, context‐ sensitive status, and graph synchronization. See Bus Utilization and Bus Utilization Buttons for more on these features.
PAGE 218
Teledyne LeCroy Real‐Time Statistics Window 10.18.4 Link Transaction Level Graphs Memory Writes are the only (posted) requests that do not get promoted to the Split transaction level. Therefore, Memory Write performance should be viewed at the Link Transaction level. That is the reason graphs at the Link level only present the Memory Write‐related metrics and are titled Writes: Response Time: and Writes: Throughput. 10.
PAGE 219
Real‐Time Statistics Window Teledyne LeCroy Figure 10.26: Real-Time Statistics Dialog Start PCI Express™ link activity. To start the monitor, press . To stop the monitor, press . The remaining Real‐Time Statistics buttons provide options for changing the format of the display. Additional formatting options are available through the Real‐Time Statistics pop‐up menu and the Real‐Time Statistics toolbar. 10.19.
PAGE 220
Teledyne LeCroy Real‐Time Statistics Window Button Function Save. Saves Real‐Time Statistics data to bitmap file (*.bmp). Email. Opens an email and attaches a bitmap file of the Real‐Time Statistics data. Print. Prints the Real‐Time Statistics data. Full Screen. Maximizes the Real‐Time Statistics window. Synchronize Views.Synchronize the current view with other open views. View Settings.
PAGE 221
Real‐Time Statistics Window Teledyne LeCroy Vertical zoom out Click and Drag Zoom. Click and drag to zoom in on a part of the graph. Synchronize Graph Areas. If two or more graphs are displayed, this button synchronizes the graphs to one another. Once synchronized, the positioning slider of one graph moves the other graphs. Graph Areas. Allows you to hide or display the graphs and the counters. You can toggle Statistics Accumulation, Link Utilization, Data Payload Throughput, and Data Packet Count.
PAGE 222
Teledyne LeCroy Real‐Time Statistics Window Properties: Opens a dialog box with options for changing the Title, Appearance, and Color of the graph. Figure 10.27: Graph Area Properties Display 10.19.
PAGE 223
Real‐Time Statistics Window Teledyne LeCroy Figure 10.
PAGE 224
Teledyne LeCroy Memory I/O Space Editor 10.20 Memory I/O Space Editor The Memory I/O Space Editor allows you to create a new Memory I/O Space file or open an existing Memory I/O Space file. It is used in conjunction with Teledyne LeCroy Trainer products. Select Tools > Memory I/O Space Editor to display the Memory Space Editor dialog. Figure 10.29: Memory I/O Space Editor Dialog 10.
PAGE 225
Timing and Bus Usage Calculations Teledyne LeCroy 10.22 Timing and Bus Usage Calculations The Timing and Bus Usage Calculator allows you to calculate time between packets. Select Tools > Timing Calculations to obtain the Timing Calculator dialog. Figure 10.31: Timing Calculator Dialog Total Time: Total time from beginning of the first unit to beginning of the second unit. 10.22.
PAGE 226
Teledyne LeCroy Timing and Bus Usage Calculations Upstream is from endpoint devices to the root complex. Downstream is from the root complex to endpoint devices. Link Utilization: Percentage of non‐idle symbols in total number of symbols transferred. Time Coverage: Percentage of non‐idle symbol times in total number of symbol times. (Non‐idle symbol time occurs when at least on one of the lanes there were non‐idle symbols transferred.) Bandwidth: Number of non‐idle symbol bits transferred per second.
PAGE 227
PCIe SSD Base Address Mapping Teledyne LeCroy 10.23 PCIe SSD Base Address Mapping In order for NVMe, PQI, AHCI and ATA command decoding to work correctly, the PETracer software needs to know the Memory Base Address of the device. In cases when Base Address assignment is recorded in the trace, the software will determine all the values automatically. If the Base Address assignment is not present in the trace, you can specify the values manually using this dialog.
PAGE 228
Teledyne LeCroy PCIe SSD Base Address Mapping Figure 10.32: PCIe SSD Configuration Dialog Pre-decoding Click button to decode the trace and select Tools > PCIe SSD Base Address Mapping (see Figure 10.33 on page 217).
PAGE 229
PCIe SSD Base Address Mapping Teledyne LeCroy Figure 10.33: PCIe SSD Configuration Dialog The MBAR field in this dialog is required and editable. Make sure that the information entered is correct. Click on any field and the description displays in the bottom read‐only box (see Figure 10.36 on page 220). Some important fields are described below:   Device: There is only one device node, (support for multiple device trace decod‐ ing will be available in a later release).
PAGE 230
Teledyne LeCroy PCIe SSD Base Address Mapping Click the Import Config Info button to import the configuration information as an .xml file, instead of adding it individually. Click the hyper‐link XML Schema File Path to access the required format to generate the .xml file. This schema provides the detailed format for the imported file. All modern languages are equipped to generate an .xml file on a specific xml schema.
PAGE 231
PCIe SSD Base Address Mapping Teledyne LeCroy All the fields in this dialog are required and editable. Make sure that the information entered is correct. Click on any field and the description displays in the bottom read‐only box (see Figure xx on page xx). Some important fields are described below:  Device: There is only one device node, (support for multiple device trace decod‐ ing will be available in a later release).
PAGE 232
Teledyne LeCroy PCIe SSD Base Address Mapping Figure 10.36: PCIe SSD Configuration Dialog - AHCI- Description Note: Only one device should be marked with the appropriate BAR, multiple BARs do not work.
PAGE 233
Running Verification Scripts Teledyne LeCroy Figure 10.37: PCIe SSD Configuration Dialog - PQI See “Example of XML File Format for SSD Decodes” on page 231 for a template of the XML files. 10.24 Running Verification Scripts You can run verification scripts to check errors, link transactions, split transactions, metrics, ordered sets, replays, DLLPs, and TLPs. To display the Verification Script dialog (see Figure 10.38 on page 222), select Tools > Run verification scripts or click the icon.
PAGE 234
Teledyne LeCroy Running Verification Scripts Figure 10.38: Verification Scripts Dialog The available verification scripts are in the Verification script section. To run a script, select it, then click the Run Scripts button . The results appear in the bottom window. You can expand or collapse this window. You find a view related to the CATC Trace and place this window under or to the right of it. You can Save the results. Click the Settings button to display the Settings Dialog (see Figure 10.
PAGE 235
Running Verification Scripts Teledyne LeCroy Figure 10.39: Settings Dialog You can choose the editor, display settings, and saving settings.
PAGE 236
Teledyne LeCroy 224 Running Verification Scripts Summit T28 PCI Express Multi‐Lane Protocol Analyzer User Manual
PAGE 237
Chapter 11 Updates and Licensing 11.1 Updating the Analyzer BusEngine™ and/or Firmware updates are now automatic processes that run anytime a new version of the PETracer™ software is installed that is incompatible with the currently installed BusEngine or Firmware. The update process generates onscreen instructions. If, however, you need to manually perform BusEngine or Firmware updates, follow these steps: 1.
PAGE 238
Teledyne LeCroy 226 License Information Summit T28 PCI Express Multi‐Lane Protocol Analyzer User Manual
PAGE 239
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.
PAGE 240
Teledyne LeCroy 12.2.1 Configuration Register Types 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. The Configuration Space Editor calls this function to determine how to decode the assigned configuration space. The offset parameter is the DWORD to decode. An offset of 0 indicates bytes 00h‐03h, an offset of 1 indicates bytes 04h‐07h, and so on.
PAGE 241
Primitives Teledyne LeCroy 12.4.2 AddField AddField(field_name, field_length, configuration_reg_type, tooltip, encoding_table = NULL) This function adds a register field to the Capability View and returns a pointer to the field, for adding subfields.       field_name: Name of the register field to display in the Capability View field_length: Length of the register field configuration_reg_type: Configuration register type of the register field.
PAGE 242
Teledyne LeCroy 12.5 Helper File Helper File ConfigSpaceCommon.inc include file contains useful functions for script decoding.
PAGE 243
Appendix B Example of XML File Format for SSD Decodes PAGE 244
Teledyne LeCroy PAGE 245
Appendix C China Restriction of Hazardous Substances Table The following tables are supplied in compliance with China's Restriction of Hazardous Substances (China RoHS) requirements: Summit T28 PCI Express Multi‐Lane Protocol Analyzer User Manual 233
PAGE 246
Teledyne LeCroy 234 Summit T28 PCI Express Multi‐Lane Protocol Analyzer User Manual
PAGE 247
Appendix D How to Contact Teledyne LeCroy Type of Service Contact Call for technical support Fax your questions US and Canada: 1 (800) 909‐7112 Worldwide: 1 (408) 653‐1260 Worldwide: 1 (408) 727‐6622 Write a letter Teledyne LeCroy Protocol Solutions Group Customer Support 3385 Scott Blvd. Santa Clara, CA 95054‐3115 USA Send e‐mail psgsupport@teledynelecroy.com Visit Teledyne LeCroy’s web site teledynelecroy.
PAGE 248
Teledyne LeCroy 236 Summit T28 PCI Express Multi‐Lane Protocol Analyzer User Manual
PAGE 249
Index Symbols .lic files 225 .opt files 154 .pem file 40 .pem files 40 .peraw file extension 168 .pex files 40 .rec files 40 + Packet # button 148 + sign 162 Numerics 10b errors 160 10‐bit code format B Bandwidth 214 Base Spec 1.0 Rev Compatibility Mode Basic Resource 67 Beep When Trigger Occurs 53 Binary code format 157 Bit Tracer mode 3 BitTracer color-coding 157 compressing data view 168 data capture mode 155 data display 157 Data Display toolbar.
PAGE 250
Teledyne LeCroy Index C calculating time between DWORDs CATC Technical Support 235 CATC Trace 2 CATC Trace View 112 CATC Walk Playlist 134 cells 104 current‐position indicator 184 resizing 104 states 71 Change Counter Value command changing 95 markers 110 Changing the Value of the Counter 90 Changing the Value of the Timer 95 Channel 95 Channels 78 Chat session 44 Chat window 43 Clear Marker command 111 Clocks radio button 122 Collapse Idle 185 Collapse Idle Plus.
PAGE 251
Index Teledyne LeCroy E Edit Comment command 43 Edit Marker 132 Edit Marker command 111 Edit Marker for Packet # pop‐up e‐mail 235 Email CATC Support 235 Enable Tool tips 146 Error Properties dialog box 80 Error Summary dialog box 171 error types 80 errors format field 150 From packet # field 43 From Packet field 41 front panel 5 Functionality of Markers 109 G Gen2 PCI Express 16‐lane advanced verification system 1 General tab 47, 145 Generator file format 42 Global State 72 Global State and Sequence
PAGE 252
Teledyne LeCroy Index interface 7 Interposer 12 interposer Link Width 56, 57 Link Width pane 191 Load 102 Load button 50, 154 Load command 50, 154 loading 50, 154 Logarithmic 178, 209 logical links installing 13 interposer data cable connecting 13 Intersection option 140 K K/D symbol format Key 157 BitTracer 167 Logical view 164 long format 103 LTSSM Flow Graph 195 LTSSM Flow Graph command License 225 keyboard shortcuts keystrokes 34 34 L label 51 lane swizzling 3 Latency 214 Latency Time 200
PAGE 253
Index multi‐segmenting Teledyne LeCroy PETracer T28 39 N navigating 188 Navigating Recording Rules Navigator 188 opening 8 PETracer 28 opening 8 PETracer SN message PETracer Summit 75 components 14, 16, 18 displaying 189 legend 192 panes 190, 191 range 190 ranges 189 slider 192 toolbar 189 PHY layer problems 3 Pin Button 78 Playback Window 136 Playlist Functionality 135 Playlist Playback Control 136, 137 plus symbol 149, 150 polarity checkbox 166 pop‐up menus 104 Power Switch 5 powering on 13 Pr
PAGE 254
Teledyne LeCroy Index Recording Options searching 121 Seconds radio button segmenting 39 segments command 47 configuring 36 dialog box 47 files 40 loading 50 saving 50 settings 51 viewing 56 Recording Options command recording progress 35 Recording Progress Bar 35 Recording Rules 36 buttons 76 toolbar 76 Recording Rules Events 76 recording status 35 Recording Type 51 Reference Clock 57 Remove 178 Report Menu 27 Report menu 169 reports 169 Reset Column Widths 183 resizing 104 Response Time 200, 214
PAGE 255
Index Teledyne LeCroy Swizzling Config...
PAGE 256
Teledyne LeCroy Z zoom 182 Zoom Level 146 Zoom to Trace View 244 Index 178 Summit T28 PCI Express Multi‐Lane Protocol Analyzer User Manual