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

Teledyne LeCroy PCI Express Script Automation Test Tool User Manual
13
2.5 Device Emulator Driver for Root Complex Testing
Root Complex testing requires installing a driver for the Device Emulator PCI Express Endpoint on the DUT
system. Currently supported operating systems are:
- Windows XP and Windows Server 2003 (lcrypede.inf driver)
- Windows 7 (see details below)
- Ubuntu 13.10 (see details below)
After installing the PETracer application, you can find the drivers at \Public
Documents\Lecroy\Petracer\ScriptAutomationTestTool\Drivers folder. Copy the
\ScriptAutomationTestTool\Drivers folder from the testing PC to a CD to use for installation on the DUT.
The \Drivers folder contains three subfolders:
o \Xp contains the lcrypede.inf driver for the Windows XP operating system.
o \Server2003 contains the lcrypede.inf driver for the Windows Server 2003 operating system.
o \Win7 contains the lcrypede.inf driver for the Windows 7 operating system.
o \Linux contains the files needed to install and build the driver under Linux distributions.
2.5.1 Installation Instructions under Windows
When you first boot the system for Root Complex testing, the New Device plug-and-play wizard appears for the
Device Emulator PCI Express Endpoint. The Device Emulator presents itself to the system as an Ethernet Controller
device. Follow the wizard instructions. When asked for the driver location, point to the appropriate subfolder of the
\Drivers folder for your operating system.
The lcrypede.inf driver installs. The Device Emulator device appears in the Device Manager under a
Sample Drivers group named LeCroy PETrainer Device Emulator Driver for PCI Express Root testing.
After you install the driver, you can restart the DUT, if necessary, and perform testing.
If you move the Device Emulator to another PCI Express slot for testing, you must install the driver again. After the
first test, you can use the Install the software automatically option of the New Device plug-and-play wizard to
install the driver.
Note on Enabling the “phantom” Advanced Error Reporting Capability
The Advanced Error Reporting Capability structure for the Root or Switch ports should enable by default. However,
some Root Complex DUT setups may not enable the Advanced Error Reporting Capability structure for the Root or
Switch ports. Advanced Error Reporting may be fully operational, but the Advanced Error Reporting Capability
structure does not link within the Root or Switch port’s Enhanced Configuration Space.
The Device Emulator Driver includes an option to test Advanced Error Reporting features. After you install the
driver, perform the following steps to perform the test:
1. Using a registry editor, locate the enumerator key for the Device Emulator under the
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\PCI path. The name is based on the
LeCroy Vendor ID (0x1570) and the Product ID used for Root testing (0xA239).
2. Under the enumerator key, find the key for the current device instance. That key includes a Control entry.
3. Open the DeviceParameters folder for the instance key.
4. Add a DWORD value named AdvancedErrorStructOffset in the DeviceParameters folder. Set the value
for this entry to the byte offset of the “phantom” Advanced Error Reporting Capability structure within the
Root or Switch port’s Enhanced Configuration Space.