Teledyne LeCroy Protocol PCI Express Script Automation Test Tool - Manual (Page 9)

Teledyne LeCroy PCI Express Script Automation Test Tool User Manual
5
The upper left Settings and Status areas show the following:
• PETracer Analyzer and PETrainer Exerciser Platform: ML, EML or Edge for the Tracer platform, ML or EML
for the Trainer platform [display only]
NOTE: Do not connect more than one trainer, only one is supported.
• Test Device: From the list, select the device type to test. The two main device types supplied by Teledyne
LeCroy are "Endpoint" and "Root Complex". You can create additional device types by specifying strings for
the TestDevice variable in the Test Script File for user-defined tests (see the
Test Script Files section).
• Test Group: From the list, select a group of tests for a Test Device. Test Group is a parameter specified in the
Test Script File for each test (see the Test Script Files section). The application sorts all Test Groups for a
Test Device and adds them to the list. In addition to the defined groups, the list includes a group named “All”,
which has all tests for the Test Device.
• Lane Width: Select x1, x2, x4, x8, or x16.
• Speed (for the 5GT/s capable PETracer Summit, Summit T2-16, and Summit Z2-16 systems only): You can
select 2.5 GT/s, 5 GT/s, or Auto as the speed at which to run the tests. The Auto setting sets the speed for
recording to “Auto” and the speed of generation to whatever is defined in Generation Options and the Trainer
script, allowing tests that change speed as they run. See the
Setting Test Speed section for how this setting
affects the script and options files used in the tests.
• Use Options files: Check to use the Lane Reversal and Polarity settings that you set in Recording Options and
use the Generation Option files specified for tests. This includes the Automatic polarity settings. Uncheck to set
Lane Reversal and Polarity settings manually.
• Reversal/Polarity: Displays the dialog for manually specifying Lane Reversal and Polarity settings.
• Preserve Traces: Select All, Failed, or None. If set to Failed or All, double-clicking a test in the list in the
upper right of the window displays the CATC Trace™ of the test in the PETracer application. Use the Go to
Marker menu to locate failure points. Position the cursor over the vertical red bar indicating a marker to the left
of the failed packet to read a tool tip with an explanation of why the PCI Express test failed. See below for an
example of Link Layer Test 41-20 showing a marked failed packet and a tooltip explanation of the failure.
• Save logs: Select to save the log files. A log file includes test results and traces for a test. The log files are
stored in the TestLog folder of the ScriptAutomationTestTool folder. The name of the subfolder for each run
of the tests is based on the date and time of the test run (for example, 06_28_2005__15_07). An example log
file folder is C:\Program Files\CATC\PETracer\ScriptAutomationTestTool\TestLog\06_28_2005__15_07.
See below for an example of a test log for a run of one Link Layer Test (41-20) for an Endpoint DUT in which
the test passed. If a test fails, the test log identifies both the location of the failure (i.e., the packet number) and
the reason for the test failure.
• Run in a loop: You can run one or more tests repeatedly to accumulate loop results. Use loops to stress test all
or some of the tests. After you select the Run in a loop option, the application allows you to specify the number
of times to run the test cycle. If you leave the edit control empty or specify 0, the loop runs until you press the
Stop Tests button. As the loop cycles, the application will display the number of runs remaining and will count
the passed and failed test cycles.
The upper right of the window lists the available tests and their status or results. The bottom half of the window
displays in real time the status of the test, the log, and the test results.
Before running tests, select one or more tests to run sequentially:
1. Select a test and place it in the sequence of tests:
• Position the cursor over a test, then press the Shift key and an "up arrow" or "down arrow” key.
• Alternatively, press the Shift (for down) or Ctrl (for up) key and left-click the mouse.
• You can also left-click the test and drag the test up or down.
Selected tests have a shaded background. Unselected tests have no background. All selected tests
should be in the top of the list with no unselected tests among them. Unselected tests should be last in
the list.
2. To initiate testing, select the Run Tests button. The tests run automatically.
The upper right of the window shows test results (either PASSED in green or FAILED in red) for each
selected test, (see the window example on the previous page).
Note: To terminate testing before all selected tests have been run, click the Stop Tests button.