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

Teledyne LeCroy PCI Express Script Automation Test Tool User Manual
7
2.2 Test Information
The PCI Express Script Automation Test Tool uses the PETracer/Trainer Automation API to run the tests. The
PETracer Automation™ API loads required Generation Options into PETrainer, loads required Recording Options
into PETracer, generates test stimuli from the PETrainer script file, records the traffic, and runs a Verification script
against the recorded trace to determine if the test PASSED or FAILED.
Each of the tests has the following information in its subfolders:
• test script files
• Recording Option settings file (.rec file)
• Generation Option settings file (.gen file)
• PETrainer Trainer Script (.peg file) for the test
• PETracer Verification Script (.pevs file and its corresponding .inc files) for the test
Test Script Files
All the components for a specific test are supplied in a test script file. Each test script file represents one test. The
test script files for Endpoint Device testing are in the Endpoint subfolder of the AutomatedTests folder. The test
script files for Root Complex testing are in the RootComplex subfolder of the AutomatedTests folder. The format
of a test script file is:
TestAnalyzer = PETracer;
TestGroup = "Link Layer";
TestName = "Link 41-20 ReservedFieldsDLLPReceive";
TestCode = "Test 41-20";
TestDescription = "The intent of this test is to verify that the DUT truly ignores
reserved fields in an ACK DLLP by sending arbitrary data in those fields.";
RecordingOptions = "RootComplex\\link_layer.rec";
GenerationOptions = "RootComplex\\link_layer.gen";
TrainerScript = "RootComplex\\LinkLayer\\link_41-20_ReservedFieldsDLLPReceive.peg";
VerificationScript = "
RootComplex\\LinkLayer\\ link_41-20_ReservedFieldsDLLPReceive.pevs";
GenerationTimeout = 4000; // Optional parameter, tells the application to stop
// generation and recording after specified time in
// milliseconds in case generation didn’t progress through
// all the stages and stopped in its own course.
// The default value of the timeout is 2 seconds.
TestDevice = "Root Complex"; // Optional parameter, specifies the DUT type.
// Default value is "Endpoint", specifying the Endpoint DUT
TestGenerator = "All"; // Optional parameter, specifies the type of LeCroy
// PCI Express Trainer product that must be used with this
// automated test. The possible values are:
// "EML/ML" (default)
// "All"
// "Z2-16"