36
QPHY-eDP Embedded DisplayPort Serial Data Compliance Software Instruction Manual Revision B – November, 2017 Relating to: XStreamDSO™ v.8.5.x.x and later QualiPHY Software v.8.5.x.x and later

QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

  • Upload
    others

  • View
    10

  • Download
    0

Embed Size (px)

Citation preview

Page 1: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP

Embedded DisplayPort Serial Data Compliance Software

Instruction Manual Revision B – November, 2017 Relating to:

XStreamDSO™ v.8.5.x.x and later QualiPHY Software v.8.5.x.x and later

Page 2: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

700 Chestnut Ridge Road Chestnut Ridge, NY, 10977-6499 Tel: (845) 425-2000, Fax: (845) 578 5985 teledynelecroy.com

© 2017 Teledyne LeCroy, Inc. All rights reserved. Customers are permitted to duplicate and distribute Teledyne LeCroy documentation for internal training purposes. Unauthorized duplication is strictly prohibited. Teledyne LeCroy and other product or brand names are trademarks or requested trademarks of their respective holders. Information in this publication supersedes all earlier versions. Specifications are subject to change without notice. 926462 Rev B November, 2017

Page 3: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B i

Table of Contents Introduction .................................................................................................................................................. 1 About QualiPHY ............................................................................................................................................. 1 About QPHY-eDP .......................................................................................................................................... 1 Required Equipment and Software ................................................................................................................ 1 Required Host Computer System .................................................................................................................. 2 Installation and Setup ................................................................................................................................. 3 Install Base Application .................................................................................................................................. 3 Activate Components..................................................................................................................................... 3 Set Up Secondary Display ............................................................................................................................. 3 Set Up Remote Control ................................................................................................................................. 4

Configure Oscilloscope for Remote Control............................................................................................ 4 Add Connection to QualiPHY .................................................................................................................. 4 Select Connection ................................................................................................................................... 4

Using QualiPHY ........................................................................................................................................... 5 Accessing the Software ................................................................................................................................. 5 General Setup ................................................................................................................................................ 6

Connection tab ........................................................................................................................................ 6 Session Info tab ...................................................................................................................................... 6 Report tab................................................................................................................................................ 6 Advanced tab .......................................................................................................................................... 6 About tab ................................................................................................................................................. 6

QualiPHY Test Process ................................................................................................................................. 7 Set Up Test Session ............................................................................................................................... 7 Run Tests ................................................................................................................................................ 8 Generate Reports .................................................................................................................................... 9

Customizing QualiPHY ................................................................................................................................ 10 Copy Configuration ............................................................................................................................... 10 Select Tests .......................................................................................................................................... 11 Edit Variables ........................................................................................................................................ 12 Edit Test Limits ...................................................................................................................................... 13

X-Replay Mode ............................................................................................................................................ 14 QPHY-eDP Testing..................................................................................................................................... 15 Test Preparation ........................................................................................................................................... 15

Required DUT Test Modes ................................................................................................................... 15 Host Program Control ........................................................................................................................... 15 Four-lane Testing .................................................................................................................................. 16 Deskewing Input Channels, Cables and/or Switches ........................................................................... 16 De-embedding ....................................................................................................................................... 17

QPHY-eDP Test Configurations ................................................................................................................... 19 All eDP 1.4 Tests .................................................................................................................................. 19 All eDP Tests, 1 Lane, HBR2 Only ....................................................................................................... 19 Demo, eDP 1.0, HBR ............................................................................................................................ 19 Demo, eDP 1.4, HBR2 .......................................................................................................................... 19

QPHY-eDP Test Descriptions ...................................................................................................................... 20 Deskew Channels ................................................................................................................................. 20 Main Link CTG v1.4 Tests ..................................................................................................................... 20 Main Link CTG v1.0 Tests ..................................................................................................................... 21 AUX Channel EYE Test (CTG 1.0 only) ............................................................................................... 21

QPHY-eDP Variables ................................................................................................................................... 22 Bitrate Setup Group .............................................................................................................................. 22 Lane Setup Group ................................................................................................................................. 22 Swing and Pre-emphasis Level Setup Group ....................................................................................... 23 Save/Recall Waveform Group .............................................................................................................. 23 Host Program Control Group ................................................................................................................ 24 De-embedding Setup Group ................................................................................................................. 24

Page 4: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

ii

Other Setup Group ................................................................................................................................ 25 QPHY-eDP Limit Sets .................................................................................................................................. 25 Appendix A: Using Host Program Control Mode ................................................................................... 26 Preparing Special Configuration for Host Control Mode ............................................................................. 26 Host Program Elements Needed to Control the QualiPHY Script ............................................................... 27

Launching QualiPHY (XReplay.exe) ..................................................................................................... 27 Monitoring for QualiPHY Termination ................................................................................................... 27 File Transfer Synchronization ............................................................................................................... 27 Renaming the Test Report .................................................................................................................... 27 Sample Host Program ........................................................................................................................... 28

HPC Sync File ............................................................................................................................................. 30 Sync File Tags ...................................................................................................................................... 30 Sample XML Sync Files ........................................................................................................................ 30

Table of Figures Figure 1 - QualiPHY framework dialog and standard selection menu ......................................................... 5 Figure 2 - The Test Report Cover and Summary pages ............................................................................... 9 Figure 3 – Configuration Test Selector tab .................................................................................................. 11 Figure 4 – X-Replay Mode window ............................................................................................................. 14

About This Manual This manual assumes that you are familiar with using an oscilloscope−in particular the Teledyne LeCroy oscilloscope that will be used with QualiPHY−and that you have purchased and installed the QPHY-eDP software option. Some of the images in this manual may show QualiPHY products other than QPHY-eDP, or were captured using different model oscilloscopes, as they are meant to illustrate general concepts only. Rest assured that while the user interface may look different from yours, the functionality is identical.

Page 5: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 1

Introduction About QualiPHY QualiPHY is highly automated compliance test software meant to help you develop and validate the PHY (physical-electrical) layer of a device, in accordance with the official documents published by the applicable standards organizations and special interest groups (SIGs). You can additionally set custom variables and limits to test compliance to internal standards. QualiPHY is composed of a “framework” application that enables the configuration and control of separate tests for each standard through a common user interface. Features include:

• Multiple Data Source Capability: Connect to your X-Stream oscilloscope via LAN or other interfaces.

• User-Defined Test Limits: Tighten limits to ensure devices are well within the passing region, even if subsequently measured with different equipment.

• Flexible Test Results Reporting that includes XML Test Record Generation. Understand a device performance distribution, or obtain process related information from the devices under test.

About QPHY-eDP The QualiPHY-eDP compliance test package follows the Compliance Test Guideline document for eDP 1.4 (eDP1.4 PHY CTG v1 d1.pdf), and specification document eDP_v1.4a_mem.pdf. The software can be run on any Teledyne LeCroy oscilloscope with at least 8 GHz bandwidth and 40 GS/s sample rate.

Required Equipment and Software • Teledyne LeCroy real-time oscilloscope, ≥ 9 GHz BW, installed with

o XStreamDSO v.7.9.0.1 minimum* with an activated QPHY-DP option key o QualiPHY v.7.9.x.x minimum with an activated QPHY-DP component o SDAIII option for compliance testing (standard on SDA Zi and DDA Zi oscilloscopes),

SDAIII-LinQ option for multi-lane testing/debugging o Eye Doctor II option for HBR2 worst-case cable EYE test o VirtualProbe option if de-embedding TPA or switch/cables o Manchester Decode option for AUX Channel test (included with QPHY-eDP option code)

*Note: The versions of XStreamDSO and QualiPHY software must match, so upgrade your version of QualilPHY if you have upgraded your oscilloscope firmware. The versions listed above are the minimum versions required for this product. The QualiPHY software may be installed on a remote PC, but all other software must be run on the oscilloscope.

• Wilder Technologies eDP test adapter model DP-TPI-P

• 4 SMA Male to SMA Male cables

Page 6: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

2

Remote Host Computer Requirements Usually, the oscilloscope is the host computer for the QualiPHY software, and all models that meet the acquisition requirements will also meet the host system requirements. However, if you wish to run the QualiPHY software from a remote computer, these minimum requirements apply:

• Operating System: o Windows 10 Professional o Windows 7 Professional

• 1 GHz or faster processor

• 1 GB (32-bit) or 2 GB (64-bit) of RAM

• Ethernet (LAN) network capability

• Hard Drive: o At least 100 MB free to install the framework application o Up to 2 GB per standard installed to store the log database (each database grows from a

few MB to a maximum of 2 GB) See Set Up Remote Control for configuration instructions.

Page 7: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 3

Installation and Setup QualiPHY is a Windows-based application that can be configured with one or more serial data compliance components. Each compliance component is purchased as a software option.

Install Base Application Download the latest version of the QualiPHY software from: teledynelecroy.com/support/softwaredownload under Oscilloscope Downloads > Software Utilities If the oscilloscope is not connected to the Internet, copy the installer onto a USB memory stick then transfer it to the oscilloscope desktop or a folder on a D:\ drive to execute it. Run QualiPHYInstaller.exe and follow the installer prompts. Choose all the components you plan to activate. If you omit any components now, you will need to update the installation to activate them later. By default, the oscilloscope appears as local host when QualiPHY is executed on the oscilloscope. Follow the steps under Add Connection to QualiPHY to check that the IP address is 127.0.0.1.

Activate Components The serial data compliance components are factory installed as part of the main application in your oscilloscope and are individually activated through the use of an alphanumeric code uniquely matched to the oscilloscope’s serial number. This option key code is what is delivered when purchasing a software option. To activate a component on the oscilloscope:

1. From the menu bar, choose Utilities > Utilities Setup. 2. On the Options tab, click Add Key. 3. Use the Virtual Keyboard to Enter Option Key, then click OK.

If activation is successful, the key code now appears in the list of Installed Option Keys. 4. Restart the oscilloscope application by choosing File > Exit, then double-clicking the Start DSO

icon on the desktop.

Set Up Secondary Display Teledyne LeCroy recommends running QualiPHY on an oscilloscope with a secondary display attached. This allows the waveform and measurements to be shown on the oscilloscope LCD display while the QualiPHY application and test results are displayed on a second monitor. See the oscilloscope Operator’s Manual for instructions on setting up dual monitor display.

Page 8: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

4

Set Up Remote Control QualiPHY software can be executed from a remote host computer, controlling the oscilloscope through a LAN Connection.

Configure Oscilloscope for Remote Control 1. From the menu bar, choose Utilities Utilities Setup... 2. Open the Remote tab and set Remote Control to TCP/IP. 3. Verify that the oscilloscope shows an IP address.

Add Connection to QualiPHY 1. On the host PC, download and run QualiPHYInstaller.exe. 2. Start QualiPHY and click the General Setup button. 3. On the Connection tab, click Scope Selector. 4. Click Add and choose the connection type. Enter the oscilloscope IP address from Step 3

above. Click OK. 5. When the oscilloscope is properly detected, it appears on the Scope Selector dialog. Select the

connection, and click OK. QualiPHY is now ready to control the oscilloscope.

Select Connection Multiple oscilloscopes may be accessible to a single remote host. In that case, go to General Setup and use the Scope Selector at the start of the session to choose the correct connection. QualiPHY tests the oscilloscope connection when starting a test. The system warns you if there is a connection problem.

Page 9: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 5

Using QualiPHY This section provides an overview of the QualiPHY user interface and general procedures. For detailed information about the QPHY-eDP software option, see QPHY-eDP Testing.

Accessing the Software Once QualiPHY is installed and activated, it can be accessed from the oscilloscope menu bar by choosing Analysis > QualiPHY, or by double-clicking the QualiPHY desktop icon on a remote computer. The QualiPHY framework dialog illustrates the overall software flow, from general set up through running individual compliance tests. Work from left to right, making all desired settings on each sub-dialog.

Figure 1 - QualiPHY framework dialog and standard selection menu

The sub-dialogs are organized into tabs each containing configuration controls related to that part of the process. These are described in more detail in the following sections. If Pause on Failure is checked, QauliPHY prompts to retry a measure whenever a test fails. Report Generator launches the manual report generator dialog. The Exit button at the bottom of the framework dialog closes the QualiPHY application.

Page 10: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

6

General Setup The first sub-dialog contains general system settings. These remain in effect for each session, regardless of Standard used, until changed.

Connection tab Shows IP Address of the test oscilloscope (local host 127.0.0.1 if QualiPHY is run from the oscilloscope). The Scope Selector allows you to choose the oscilloscope used for testing when several are connected to the QualiPHY installation. See Set Up Remote Control for details.

Session Info tab Optional information about the test session that may be added to reports, such as: Operator Name, Device Under Test (DUT), Temperature (in °C) of the test location, and any additional Comments. There is also an option to Append Results or Replace Results when continuing a previous session.

To optimize report generation, enter at least a DUT name at the beginning of each session.

Report tab Settings related to automatic report generation. Choose:

• Reporting behavior of: o “Ask to generate a report after tests,” where you’ll be prompted to create a new file for

each set of test results. o “Never generate a report after tests,” where you’ll need to manually execute the Report

Generator to create a report. o “Always generate a report after tests,” to autogenerate a report of the latest test results.

• Default report output type of XML, HTML, or PDF.

• A generic Output file name, including the full path to the report output folder.

Optionally, check Allow style sheet selection in Report Generator to enable the use of a custom .xslt when generating reports (XML and HTML output only). The path to the .xslt is entered on the Report Generator dialog. Report Generator launches the Report Generator dialog, which contains the same settings as the Report tab, only applied to individual reports.

Advanced tab This tab launches the X-Replay Mode dialog. See X-Replay Mode.

About tab Information about your QualiPHY installation.

Page 11: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 7

QualiPHY Test Process Once general system settings are in place, these are the steps for running test sessions.

Set Up Test Session 1. Connect the oscilloscope to the DUT - QualiPHY will display connection diagrams during

operation to assist with this. 2. Open the QualiPHY software to display the framework dialog.

3. If running QualiPHY remotely, click General Setup and open the Scope Selector to select the

correct oscilloscope connection. 4. If you have more than one component activated, click Standard and select the desired standard

to test against. Otherwise, your one activated component will appear as the default selection. Note: Although all the QualiPHY components appear on this dialog, only those selected when installing QualiPHY are enabled for selection.

5. Click the Configuration button and select the test configuration to run. These pre-loaded configurations are set up to run all the tests required for compliance and provide a quick, easy way to begin compliance testing. See QPHY-eDP Test Configurations for a description of your configurations. You can also create custom configurations for internal compliance tests by copying and modifying the pre-loaded configurations. See Customizing QualiPHY for details.

6. Close the Edit/View Configuration dialog to return to the framework dialog.

Page 12: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

8

Run Tests 1. On the framework dialog, click Start to begin testing.

When tests are in progress, this button changes to Stop. Click it at any time to stop the test in process. You’ll be able to resume from the point of termination or from the beginning of the test.

2. Follow the pop-up window prompts. QualiPHY guides you step-by-step through each of the tests described in the standard specification, including diagrams of the connection to the DUT for each required test mode.

3. When all tests are successfully completed, both progress bars on the framework dialog are completely green and the message “All tests completed successfully” appears. If problems are encountered, you’ll be offered options to:

• Retry the test from the latest established point defined in the script

• Ignore and Continue with the next test

• Abort Session

Page 13: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 9

Generate Reports The QualiPHY software automates report generation. On the framework dialog, go to General Setup > Report to pre-configure reporting behavior. You can also manually launch the Report Generator from the framework dialog once a test is run. The Report Generator offers the same selections as the Report tab, only applied to each report individually, rather than as a system setting. There are also options to link a custom style sheet (.xslt) to the report, or to Exclude Informative Results. The Test Report includes a summary table with links to the detailed test result pages.

Figure 2 - The Test Report Cover and Summary pages

Reports are output to the folder D:\QPHY\Reports, or C:\LeCroy\QPHY\Reports if QualiPHY is installed on a remote PC. You can add your own logo to the report by replacing the file *\QPHY\StyleSheets\CustomerLogo.jpg. The recommended maximum size is 250x100 pixels at 72 ppi, 16.7 million colors, 24 bits. Use the same file name and format.

Page 14: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

10

Customizing QualiPHY Pre-loaded configurations that are “locked” cannot be modified, as these have been created with exactly the tests and variable settings required for compliance. However, you can modify copies of these configurations for internal testing. Unlocked configurations can be modified by altering test selections and variable settings.

Copy Configuration 1. Access the QualiPHY framework dialog and select a Standard. 2. Click Edit/View Configuration and select the configuration upon which to base the new

configuration. This can be a pre-loaded configuration or another copy. 3. Click Copy and enter a name and description.

Note: Until you enter a new name, the new configuration is shown followed by “(Copy)”.

4. Select the new configuration from the list and follow the procedures below to continue making changes. Note: If any part of a configuration is changed, the Save As button becomes active on the bottom of the dialog. If a custom configuration is changed, the Save button will also become active to apply the changes to the existing configuration, rather than create a new one.

Page 15: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 11

Select Tests On the Test Selector tab, check the tests that make up the configuration. Each test is defined by the Embedded DisplayPort standard. A description of each test is displayed when it is selected. To loop any of the tests in this configuration, select the test from the list, then choose to Loop selected test until stopped or enter the number of repetitions. When defining a number of repetitions, enter the number of repetitions before selecting the checkbox.

Figure 3 – Configuration Test Selector tab

Page 16: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

12

Edit Variables The Variable Setup tab contains a list of test variables. See QPHY-eDP Variables for a description of each. To modify a variable:

1. Select the variable on the Variable Setup tab, then click Edit Variable. 2. The conditions of this variable appear on a pop-up. Choose the new condition to apply.

You can also choose to Reset to Default at any time.

Page 17: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 13

Edit Test Limits The Limits tab shows the Limit Set currently associated with the configuration. Any limit set can be associated with a custom configuration by selecting it in this field. The Limits Manager shows the settings for every test limit in a limit set. Those in the Default set are the limits defined by the standard. To create a custom limit set:

1. On the Limits tab, click Limits Manager. 2. With the default set selected, click Copy Set and enter a name.

Note: You can also choose to copy and/or modify another custom set that has been associated with this configuration.

3. Double click the limit to be modified, and in the pop-up enter the new values.

You can also Import Limits from a .csv file. Navigate to the file location after clicking the button. Tip: Likewise, Export Limits creates a .csv file from the current limit set. You may wish to do this and copy it to format the input .csv file.

Page 18: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

14

X-Replay Mode The X-Replay mode window is an advanced (“developer”) view of QualiPHY. The tree in the upper-left frame enables you to navigate to processes in the eDP test script, in case you need to review the code, which appears in the upper-right frame. Two other particularly useful features are:

• A list of recent test sessions in the lower-left frame. While you can only generate a report of the current test session in the QualiPHY wizard, in X-Replay Mode you can generate a report for any of these recent sessions. Select the session and choose Report > Create Report from the menu bar.

• The QualiPHY log in the bottom-right frame. The frame can be split by dragging up the lower edge. The bottom half of this split frame now shows the raw Python output.

Figure 4 – X-Replay Mode window

Page 19: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 15

QPHY-eDP Testing Embedded DisplayPort compliance testing involves generating signals with various bitrates, patterns, levels, pre-emphasis settings, and SSC settings—all on up to four lanes. The QualiPHY-eDP test script loops over the different values of each of these properties and performs tests on combinations of signal properties that are enabled for testing. While some of the properties may be defined by the user, this looping structure is not controlled by the user. A consequence of using this particular architecture is that the order in which tests are executed will depend on which tests are selected within the configuration, and which swing/pre-emphasis levels are chosen. The QualilPHY script enforces the eDP rules for which pre-emphasis levels are supported vs. swing levels (for example; Table 4-3 in the eDP 1.4 specification):

However, because of the flexibility permitted by the specification in configuring swing and pre-emphasis, it is possible to set “unused” levels for swing and pre-emphasis (e.g., swing = 3 and pre-emphasis = 3). Unused combinations are not tested.

Test Preparation Before beginning any test or data acquisition, warm the oscilloscope for at least 20 minutes. Calibration is performed automatically by the oscilloscope software; no manual calibration is required. The calibration procedure will be run again if the temperature of the oscilloscope changes by more than a few degrees.

Required DUT Test Modes All tests require that the DisplayPort test fixture be connected to the DUT. The test fixture outputs will connect either directly to the oscilloscope, or optionally to the switch matrix. Refer to the QualiPHY connection diagrams for physical set up information. QPHY-eDP supports both fully automated and semi-automated testing. In either case, the DUT must be placed in the required test mode. It is recommended that you ensure the DUT is capable of outputting the required test modes before beginning testing.

Host Program Control Host Program Control (HPC) is a mode of operation where QualiPHY is controlled by a separate application (the “Host Program”). In this mode of operation, QualiPHY uses a simple handshaking protocol to send messages to the host program. This is implemented using a synchronization file. See Appendix 1: Using Host Program Control. Note: When in HPC mode, QualiPHY will halt execution while waiting for the sync file to be deleted.

Page 20: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

16

Four-lane Testing QPHY-eDP performs automated testing of all four lanes by using the Mini-Circuits USB-4SPDT-A18 switch matrix. To configure four-lane testing, set the “Number of Lanes” variable to 4. This variable setting signals QualiPHY to use the switch matrix. If you do not have a switch, one or two lanes may be tested simultaneously.

Deskewing Input Channels, Cables and/or Switches In order to achieve the highest accuracy possible, a deskewing step is required. Deskewing (or simply “deskew”) corrects for any difference in the path lengths connecting each signal input to the oscilloscope. When properly deskewed, differences in these path lengths are corrected, avoiding potential measurement errors. Improperly deskewed inputs can result in higher than expected intra-pair and inter-pair skew measurements, incorrect differential rise and fall times, higher than expected AC Common Mode noise measurements, excess eye diagram closer, excess jitter, etc. Higher bandwidth Teledyne LeCroy oscilloscopes (such as WaveMaster 8 Zi series) include the unique FastEdge output signal and trigger type to facilitate deskewing. The test script uses this output as a signal source in conjunction with the FastEdge trigger to measure the arrival time of the FastEdge through each channel. Deskew values are stored in a file, and are recalled back into each channel’s Deskew setting, which is located in the Pre-processing section of each channel’s configuration dialog. There are three basic kinds of deskew that are performed:

1. Deskew only the oscilloscope’s inputs 2. Deskew input cabling and oscilloscope inputs 3. Deskew input switches, cabling and oscilloscope inputs

Oscilloscope Inputs Only When wishing to correct for timing differences only between the oscilloscope input connectors and the internal digitizing hardware, a deskew is performed where the reference plane is the point where the input signal is plugged into the oscilloscope. This type of deskew is used in the case where the test fixture is being connected directly to the oscilloscope inputs. To perform this deskew, disconnect all signals, and use a single cable connected to the FastEdge output. When the software prompts you to plug a cable into an input channel, simply change the connection from one channel to the next using the same cable. The script will store a file containing time offsets between the FastEdge signal and the trigger time. Skew with respect to channel 1 will be used during testing, such that the deskew setting for C1 = 0. The deskew settings for other channels are with respect to the value measured for C1. Deskew values that are small (picoseconds) will result.

Input Cabling and Oscilloscope Inputs When timing differences between the cables used to connect the DUT to the oscilloscope are not of interest and are to be removed (which is usually the case), then a slightly different deskew procedure is used. This type of deskew is used in the case where the test fixture is connected to the oscilloscope via cables. Leave the cables connected to the oscilloscope, and disconnect them from the DUT. When the software prompts you to, plug a cable into an input channel (e.g., C2), leave the cable plugged into C2, and connect the other end of the cable into the FastEdge connect. (Don’t forget to torque properly!) The result is a deskew of the input path through the cables specific to each channel, through the LP-SMA adapter, and the oscilloscope’s internal circuitry. The script will store to file the time offsets between the FastEdge signal and the trigger.

Page 21: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 17

Skew with respect to channel 1 will be used during testing, such that the deskew setting for C1 = 0. The deskew settings for other channels are with respect to the value measured for C1. Deskew values depend on cable lengths used, but if the cables are of the same nominal length (but are not specifically “matched cables”), then channel deskew values can be as high as several tens of picoseconds. Tip: Label the cables and input adapters with the number of the channel to which they are connected.

Mini-circuits, Input Switches, Input Cabling and Oscilloscope Inputs When using a switch matrix to route inputs from the test fixture to the oscilloscope, there are two choices. One is to perform a deskew as described below, the other is to de-embed the switch matrix and attached cables via S-parameter de-embedding feature of the QualiPHY-eDP script. Do not do both, since this will essentially “Double correct” for any skew. Note: The S-parameter de-embeding performed by the VirtualProbe feature of the oscilloscope will correct for both loss and skew, since S-parameters include both magnitude and phase information. Note: The QPHY-eDP script does not utilize any special deskew procedure for performing a deskew through the switch. Employ matched cables to connect the text fixture to the switch (or to directly connect them), and use one of the methods described above. The Mini-Circuits switches are suitably matched. Important: Use a torque wrench at each step in the deskew process. If a torque wrench is not used, the accuracy can easily be off by several picoseconds.

De-embedding QualiPHY-eDP includes the capability to de-embed the TPA-P as well as any switch matrix and/or cables that sit between the lane under test and the oscilloscope. De-embedding is accomplished by using the VirtualProbe software capability to emulate the effects of the TPA/switches S-parameters. To de-embed, you must provide the Touchstone files containing the complete S-parameters. Note: De-embedding the TPA or switch is not a requirement of the eDP CTG, nor is it explicitly recommended. However, you may wish to de-embed if the DUT’s performance is on the pass/fail boundary.

TPA For the TPA (test fixture), this is a 4-port S-parameter file (.s4p), which would be s-parameters that represent any of the main link differential pairs. This file is specific to the TPA in use and should be requested from your TPA vendor if required.

Switch/Cable For switches/cables, one two-port file (.s2p) is needed for each signal path that connects a single TPA output (such as Lane0(-), to a oscilloscope channel. The S2P file can be of any part of the path between the TPA output and the oscilloscope channel that you wish to de-embed. For a compete de-embedding, make your S-parameter measurements from the cable connecting to the TPA outputs (if used) to the end of the cable that is attached to the oscilloscope channel. The S2P file connecting Lane “N” of polarity “M” to channel “X” must be named using the syntax:

switchLane{N}{M}-C{X}

Page 22: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

18

Example filenames are shown in the following table:

S-parameter filename Corresponding signal path switchLane0+C1.s2p Lane0 (+) to oscilloscope channel C1

switchLane0-C2.s2p Lane0 (-) to oscilloscope channel C2

switchLane1+C3.s2p Lane1 (+) to oscilloscope channel C3

switchLane1-C4.s2p Lane1 (-) to oscilloscope channel C4

switchLane2+C1.s2p Lane2 (+) to oscilloscope channel C1

switchLane2-C2.s2p Lane2 (-) to oscilloscope channel C2

switchLane3+C3.s2p Lane3 (+) to oscilloscope channel C3

switchLane3-C4.s2p Lane3 (-) to oscilloscope channel C4

Preparing to De-embed Prior to performing de-embedding within QualiPHY, it is good practice to examine the touchstone files with an S-parameter viewer in order to confirm that the S-parameters are “healthy”. Set up the de-embedding in Virtual Probe and examine the de-embedding manually. This separate step will allow you to confirm that S-parameters for the TPA or switch are being properly read-in and yield reasonable results. After confirming the de-embedding in VirtualProbe, configure QualiPHY to perform the de-embedding.

Page 23: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 19

QPHY-eDP Test Configurations QPHY-eDP includes predefined test configurations for different test setups. Each test configuration includes a unique selection of tests and variable settings, which can be reviewed by selecting Edit/View Configuration from the Framework dialog and opening the Test Selector and Variable Setup tabs. See QPHY-eDP Variables for a description of each variable and its default value.

All eDP 1.4 Tests All transmitter compliance tests (CTG v1.4, CTG v1.0 and AUX channel), performed on all lanes.

All eDP Tests, 1 Lane, HBR2 Only All transmitter compliance tests (CTG v1.4, CTG v1.0 and AUX channel), pre-configured to use oscilloscope C1 and C2 to test a single lane (Lane0) at HBR2 bitrate 7 (5.4 Gb/s) only.

Demo, eDP 1.0, HBR Uses saved waveforms to demonstrate all CTG v1.0 transmitter tests on Lane0 at HBR bitrate 4 (2.7 Gb/s).

Demo, eDP 1.4, HBR2 Uses saved waveforms to demonstrate all CTG v1.4 transmitter tests on Lane0 at HBR2 bitrate 7 (5.4 Gb/s).

Page 24: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

20

QPHY-eDP Test Descriptions

Deskew Channels This is an optional procedure that may be added to custom configurations. It guides the user through the steps required to deskew cables prior to running other tests.

Main Link CTG v1.4 Tests 1.1 TP3_EQ Eye Diagram Testing Tests that the eye diagram meets the mask requirements defined in section 1.1.1 of eDP CTG v1.4 draft 1. Performed using the CP2520 pattern at all supported transfer rates.

1.4.1 TP3_EQ Tj/Dj Tests that Tj and Dj meet the requirements defined in section 1.4 of eDP CTG v1.4 draft 1. Performed using the CP2520 pattern at all supported transfer rates.

1.8 Intra-pair Skew Test (Informative) Measures the Intra-pair skew as described in section 1.8 of eDP CTG v1.4 draft 1. Performed using the CP2520 pattern at the highest supported transfer rate. Note that limits for this test are not defined in v1.4 of the eDP CTG.

1.9 AC Common Mode Noise (Informative) Measures the AC common-mode noise as described in section 1.9 of eDP CTG v1.4 draft 1. Performed using the CP2520 pattern at all supported transfer rate. Note that limits for this test are not defined in v1.4 of the eDP CTG.

1.7 Differential Transition Time (Informative) Measures the min, max and mean rise and fall differential transition times as described in section 1.7 of eDP CTG v1.4 draft 1. Performed using the PLTPAT pattern at all supported transfer rates. Note that limits for this test are not defined in v1.4 of the eDP CTG.

1.4.2 Main Link Frequency Compliance Tests that the minimum and maximum Main Link frequency range meets the limits defined in section 1.4.2 of eDP CTG v1.4 draft 1. Performed using the D10.2 pattern at all supported transfer rates.

1.5 Spread Spectrum Modulation Frequency Tests that the SSC frequency meets the limits defined in section 1.5 of eDP CTG v1.4 draft 1. Performed using the D10.2 pattern at all supported transfer rates when SSC is enabled.

1.6 Spread Spectrum Modulation Deviation Tests that the SSC modulation deviation meets the limits defined in section 1.6 of eDP CTG v1.4 draft 1. Performed using the D10.2 pattern at all supported transfer rates when SSC is enabled.

Page 25: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 21

Main Link CTG v1.0 Tests 3.1 TP3 Eye Diagram Test Tests that the eye diagram meets the mask requirements defined in section 3.1 of eDP CTG v1.0.For HBR2 signals, the test should be performed at TP3_EQ using the CP2520 pattern. For HBR/RBR and all intermediate rates, the test is performed at TP3, and a PRBS7 pattern should be used.

3.2 Inter-pair Skew Test Tests that the inter-pair skew meets the limits specified in section 3.2 of the eDP 1.0 CTG, using a PRBS7 pattern at TP3.

3.3 Non-ISI Jitter, RBR/HBR only Test that the Non-ISI jitter meets the limits specified in section 3.3 of the eDP 1.0 CTG. The test should be performed on HBR and RBR signals using a PRBS7 pattern.

3.4.1 Tj / Dj Measurements Tests that the Total and Deterministic Jitter (Tj and Dj) meet the limits specified in section 3.4.1 of the eDP v1.0 CTG. For HBR2, the CPAT2520 pattern should be used at TP3_EQ. For RBR and HBR and optionally all intermediate rates, the test is performed using a PRBS7 pattern at TP3.

3.4.2 Tj / Rj / Dj Measurements, D10.2, HBR2 only Tests that the Total, Random, and Deterministic Jitter meet the limits specified in section 3.4.2 of the eDP v1.0 CTG. Performed using the D10.2 pattern at HBR2 bitrate.

3.5 Main Link Frequency Compliance Tests that the minimum and maximum Main Link frequency range meets the limits defined in section 3.5 of eDP CTG v1.0. Performed using the D10.2 pattern at all supported transfer rates.

3.6 Spread Spectrum Modulation Frequency Tests that the SSC frequency meets the limits defined in section 3.6 of eDP CTG v1.0. Performed using the D10.2 pattern at all supported transfer rates when SSC is enabled.

3.7 Spread Spectrum Modulation Deviation Tests that the SSC modulation deviation meets the limits defined in section 3.7 of eDP CTG v1.0. Performed using the D10.2 pattern at all supported transfer rates when SSC is enabled.

AUX Channel EYE Test (CTG 1.0 only) Verifies that AUX channel amplitude and timing variables are within the conformance limits as defined in eDP CTG v.1.0.

Page 26: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

22

QPHY-eDP Variables

Bitrate Setup Group A complete eDP 1.4 test entails testing at seven different transfer rates, each with a specific CTLE definition. You may wish to test only a subset of these bitrates. This group includes variables to facilitate choosing the specific rates to test.

Bitrate n (Gb/s) Speed in Gb/s of the respective Bitrate, 1 though 7.

Bitrate n CTLE CTLE defined for the respective Bitrate (see table 4.19 of the eDP specification). Coefficients should be entered as a comma-delimited list of values in the format: Zero (MHz), Pole1 (GHz), Pole2 (GHz). For example: 460, 0.81, 1.46.

Enable Bitrate n Tests For each Bitrate defined, choose to enable (Yes) or disable (No) testing.

Highest Supported Bitrate Select the highest-supported bitrate for your DUT. Intra-pair skew will be tested at this bitrate, provided that the bitrate is enabled.

Lane Setup Group Performing tests on one lane at a time is often desirable, especially given the length of time required for a complete test on all four lanes. These variables define the configuration for 1- and 2-lane tests.

Primary Lane Under Test Lane tested when testing only one lane. If testing on two lanes, the variable Second Lane Under Test defines the second lane. This variable isn’t used when testing four lanes, since the script will by default test on all lanes.

Number of Lanes Select to test on 1, 2 or 4 lanes. When choosing 1 or 2, configure the Primary Lane Under Test and Second Lane Under Test variables.

Primary Lane Channels Since the lanes are differential, each lane under test requires two oscilloscope channels. This variable specifies the two channels to use for the primary lane under test. Use the default value of C1 and C2 under normal circumstances.

Second Lane Under Test When Number of Lanes = 2, this variable contains the lane number of the second lane to test.

Secondary Lane Channels Since the lanes are differential, each lane under test requires two oscilloscope channels. This variable contains the two channels to use for the second lane under test. Use the default value of C3 and C4 under normal circumstances.

Page 27: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 23

Swing and Pre-emphasis Level Setup Group Variables in this group set the voltage and pre-emphasis values for the four Swing and Pre-emphasis levels, 0 through 3. In eDP, the values these levels can take are not fixed, as they are in DisplayPort.

Pre-emphasis n (dB) Value in dB for Pre-emphasis level n.

Capture Level/Pre-emphasis Tests? Enables/disables screen capture of the Level and Pre-Emphasis tests. Select True to take screen shots of the oscilloscope results while testing. Image files are placed in the test report.

Swing n (mV) Value in mV for Swing level n.

Test <numbers> Tested Swing Level Swing level to measure for the respective tests.

Test <numbers> Tested Pre-emphasis Level Pre-emphasis level to apply for the respective tests.

Save/Recall Waveform Group Variables in this group control the behavior for QualiPHY to save and recall waveforms. QualiPHY-eDP can run off of a set of stored waveforms as well as on live waveforms, so there are variables to determine where files are saved, and whether testing will be performed on live or saved waveforms.

Demo Mode Runs the tests as a demonstration using saved waveforms. Test Mode should also be set to Use Saved Waveforms, and waveform files placed in the folder [Waveform Folder path]\Demo. This variable is True only for the Demo configurations.

Use Individual Run Folder? Set to Yes to ensure that results from each run will be saved in a unique folder. Set to No if you want all files in the same folder.

Test Mode Determines whether QualiPHY will Acquire New Data or on Use Saved Data. When using saved data, the waveforms required for the selected tests must be present in the folder defined by the Waveform Folder variable. If waveforms are not found, you will be prompted to load them manually.

Waveform Folder Full path to the root folder for saving waveforms when Test Mode is Acquire New Data, or location of saved waveforms to use when Test Mode is Use Saved Data. This path can be on the oscilloscope or on a network drive if the instrument is networked. Default is oscilloscope D:\Waveforms\eDP.

Page 28: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

24

Host Program Control Group Variables used when running tests in Host Program Control (HPC) mode. See Appendix A: Using Host Program Control Mode for implementing HPC and the Sync file.

Host Program Control Sync Filename Full path to the HPC Sync file (e.g., C:\eDP_sync_file.xml).

Use Host Program Control? Enables/disables use of Host Program Control, a simple file-based protocol that allows a host computer to interact with QualiPHY during a session, instead of a human user. When enabled, QualiPHY will write .XML files containing requests for the Host Program using the Host Program Control Sync Filename. Default is No (disabled). Note: The Host Program should cause the Sync file to be deleted when the operation is complete. When this variable is set to Yes, QualiPHY will halt execution until it sees that the Sync file is deleted.

De-embedding Setup Group This group includes variables to describe the de-embedding configuration. De-embedding is optional, it is not specified by the eDP compliance test specification. Requires VirtualProbe.

De-embed TPA? Set to Yes to de-embed the TPA-P.

Filename/Path for TPA-P Touchstone File The complete path to the 4-port S-parameter file used to de-embed the TPA.

TPA-P Touchstone File Port Mapping Configure this as described in the QualiPHY dialog when setting the variable. The variable is provided since the mapping of the input to output ports is arbitrary (e.g., some users may generate the touchstone file with ports 1&3 as the input ports, whereas others may use 1&2 as the inputs). Determine the correct assignments in order to perform the de-embedding correctly.

De-embed switches? Set to Yes to de-embed the switch and/or cables that route signals from the TPA output to oscilloscope input channels.

Folder for Switch De-embedding S2P Files The complete path to the folder containing the S2P files for the switch matrix.

Page 29: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 25

Other Setup Group The variables in this group are the remaining variables that apply to all tests.

CTLE for eDP 1.0 HBR2 Eye/Jitter Tests Global 3-pole CTLE for HBR2 Eye and Jitter tests. Enter coefficients in the format: Zero (MHz), Pole1 (GHz), Pole2 (GHz), Pole3 (GHz). For example: 450, 2.7, 4.5, 13.5.

SSC Setting(s) Specifies the state of SSC to use when running tests: Enabled, Disabled, or Both. The Both setting will test both states if SSC can be disabled on the DUT, otherwise Both will retain the enabled state for those DUTs where SSC cannot be disabled.

Switch Matrix for 4-Lane Mode Switching matrix to use when operating in 4-Lane mode. Select Mini-Circuits if using Mini-Circuits switch, User if another switch. If Mini-Circuits is selected, QualiPHY will automatically configure the switches. If User is selected, QualiPHY will prompt the user to switch lanes. Note: This variable is only used when Number of Lanes is set to 4.

QPHY-eDP Limit Sets The default installation of QPHY-eDP contains only one limit set, called “Default”, containing the limits specified by the VESA eDP Compliance Test Guideline v1.4. The limits for each value tested are encoded in or computed by the script and cannot be changed. To change limits for internal testing, copy the Default set and modify the limits in your custom set. Select the custom set as desired for non-compliance testing.

Page 30: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

26

Appendix A: Using Host Program Control Mode Host Program Control Mode (HPC) is a new feature that allows QualiPHY to be started by a user’s host program with a number of arguments. Once running, a simple “Sync File” protocol is used by QualiPHY to signal the host program. When the QualiPHY script requires action from the host program, it writes a User Sync File to the disk in .xml format containing several tags. QualiPHY then pauses execution and waits. The host program should set the requested DUT parameters or test system configuration, respond as necessary, then delete the User Sync File. When QualiPHY sees that the User Sync File is deleted, it continues execution. In the QPHY-eDP script, there are three situations when a Sync File is written out:

1. When the user host program needs to change which signals are connected to the oscilloscope (typically utilized in systems involving an RF switch)

2. When the user host program needs to change the signal type output from the DUT (e.g., the signal’s character rate)

3. When an issue error condition has occurred In order to use Host Program Control Mode, the following considerations should be taken into account.

Preparing Special Configuration for Host Control Mode In QualiPHY, create a custom Configuration that has the variables configured in the way you will need them when you run in Host Program Control Mode. Make sure you save the configuration after editing the variables so that it will be available to refer to when you startup QualiPHY via command line. Variables that need to be considered to run in HPC are:

• Host Program Control sync filename o Definition: Use to specify sync file path. o Default: C:\eDP_sync_file.xml o Comments: Just use default unless conflict.

• Use Host Program Control? o Definition: Set to “Yes” to use the Host Program Control feature, “No” otherwise. o Default: No o Comment: When set to “Yes”, QualiPHY will pause execution after it creates a sync file

and while it is waiting for the sync file to be deleted.

Page 31: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 27

Host Program Elements Needed to Control the QualiPHY Script

Launching QualiPHY (XReplay.exe) The Host program needs to launch the QualiPHY application (the actual program is named XReplay.exe) with the following command line, including arguments for eDP:

C:\Program Files(x86)\LeCroy\XReplay\XReplay.exe –A –R –E –WIZARD –TECH:tecDPORT\eDP –CONFIG:HostControlTest –N:IP Address

The path shown above is where the XReplay.exe program (QualiPHY) is placed by the installer. Arguments are:

-A Stops all manual user interaction. (Always use)

-R Causes the test script (eDP in this case) to be run automatically. (Always use)

-E Automatically exit when test script is done executing. (Always use)

-WIZARD Required.

-TECH:tecDPORT\eDP Sets the technology to test, eDP in this case.

-CONFIG:HostControlTest Sets the name of the configuration that will be used; HostControlTest in this case.

-N:IP Address IP address of the oscilloscope:

If QualiPHY is running on the oscilloscope, set to localhost.

If QualiPHY is not running on the oscilloscope, set to Host ID or IP Address of the oscilloscope.

Monitoring for QualiPHY Termination The host program needs to continuously test to see if the QualiPHY process still exists, to be able to know when the QualiPHY test script has completed and take appropriate action.

File Transfer Synchronization The host synchronization consists of three parts:

1. Waiting for C:\eDP_sync_file.xml (or other name specified in configuration) to be written by QualiPHY.

2. Reading the file and performing the required actions. 3. Deleting C:\eDP_sync_file.xml in order to signal QualiPHY that the operation is complete.

Renaming the Test Report The test report that is created by the QualiPHY test script is always created with the same name (for example, D:\QPHY\Reports\LeCroyReport.pdf). For this reason, it needs to be renamed after QualiPHY (XReplay.exe) terminates in order to avoid overwriting it the next time QualiPHY is run. Note: The report path is C:\LeCroy\QPHY\Reports if QualiPHY is installed on a remote PC instead of the oscilloscope.

Page 32: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

28

Sample Host Program This sample VBS host program performs all the essential tasks involved in launching and syncing with the QualiPHY eDP test script. It is shown below and referred to in the text following it.

‘eDP example Host Program Control Script no actions

Set shell = CreateObject("Wscript.Shell")

Set fso = CreateObject("Scripting.FileSystemObject")

WScript.Echo "Launching QualiPHY"

Set qphyProc = shell.Exec("C:\Program Files (x86)\LeCroy\XReplay\XReplay.exe -A -R -E -WIZARD -TECH:tecDPORT\eDP -CONFIG:HostControlTest -N:172.28.13.63")

fname = "C:\eDP_sync_file.xml"

Do While qphyProc.Status = 0

If fso.FileExists(fname) Then

result = parse_XML(fname, connectionsReq, errorcode, detail, mode, TestPattern, BitRate, SSC, PreEmphasis, Swing, Number_of_Lane)

'

' Perform actions based on info in sync file here.

'

Wscript.Echo "Deleting sync file"

fso.DeleteFile(fname)

Else

wscript.sleep(500)

End If

Loop

WScript.Echo "Renaming report"

fso.MoveFile "D:\QPHY\Reports\LeCroyReport.pdf", "D:\QPHY\Reports\QPHY-eDP.pdf"

WScript.Echo "Done!"

Function parse_XML(ByVal fname, ByRef connectionsReq, ByRef errorcode, ByRef detail, ByRef mode, ByRef TestPattern, ByRef BitRate, ByRef SSC, ByRef PreEmphasis, ByRef Swing, ByRef Number_of_Lane)

set xmlDoc=CreateObject("Microsoft.XMLDOM")

xmlDoc.async="false"

xmlDoc.load(fname)

'Set queryNode = xmlDoc.selectSingleNode(".//signal_type[@context = 'General']")

Set Node = xmlDoc.documentElement.selectSingleNode("connectionsReq")

connectionsReq = Node.text

Set Node = xmlDoc.documentElement.selectSingleNode("error")

errorcode = Node.text

Set Node = xmlDoc.documentElement.selectSingleNode("detail")

Page 33: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 29

detail = Node.text

Set Node = xmlDoc.documentElement.selectSingleNode("mode")

mode = Node.text

Set Node = xmlDoc.documentElement.selectSingleNode("TestPattern")

TestPattern = Node.text

Set Node = xmlDoc.documentElement.selectSingleNode("BitRate")

BitRate = Node.text

Set Node = xmlDoc.documentElement.selectSingleNode("SSC")

SSC = Node.text

Set Node = xmlDoc.documentElement.selectSingleNode("PreEmphasis")

PreEmphasis = Node.text

Set Node = xmlDoc.documentElement.selectSingleNode("Swing")

Swing = Node.text

Set Node = xmlDoc.documentElement.selectSingleNode("Number_of_Lane")

Number_of_Lane = Node.text

set xmlDoc = Nothing

parse_XML = 0

End Function

Page 34: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

30

HPC Sync File Sync File Tags The Host Program Control synchronization file includes the following tags:

• connectionsReq: describes the connections that should be made. o When instructed to, connect 2 lanes connect /route the lanes to the oscilloscope such

that (+) lines are to channels C1 and C3, and (-) lines to C2 and C4. o Example: “Lane0,Lane1”

• error: includes an error code. Refer to the “detail” field for information about the error.

• detail: gives additional information, especially in situations where the error code is 0, which would indicate an issue. Example: “No trigger: Trigger timed out. Is signal present and trigger set correctly?”

• PreEmphasis: indicates the preemphasis setting to configure (0 through 3).

• Number_of_Lane: indicates the variable setting for Number of Lanes.

• Swing: indicates the swing setting to configure (0 through 3).

• Bitrate: indicates the bitrate setting to configure in GB/s.

• PreEmphasis_value: indicates the preemphasis value to configure in dB (only written when needed).

• Level_value: indicates the swing to be configured, in volts (only written when needed).

• SSC: indicates whether to enable or disable spread spectrum clocking.

• TestPattern: indicates the test pattern to configure.

Sample XML Sync Files Request to change the connections:

<TestConfig>

<PreEmphasis/>

<Number_of_Lane>4</Number_of_Lane>

<Swing/>

<detail>Change connections</detail>

<mode/>

<error>0</error>

<TestPattern/>

<connectionsReq>Lane1,Lane2,</connectionsReq>

<BitRate/>

<SSC/>

</TestConfig>

Page 35: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup

QPHY-eDP Instruction Manual

926426 Rev B 31

Request to change signal characteristics: <TestConfig>

<PreEmphasis>Pre-emphasis0</PreEmphasis>

<Number_of_Lane>1</Number_of_Lane>

<Swing>Swing0</Swing>

<detail>Signal Attribute Change</detail>

<Pre-emphasis0_Value>0.0</Pre-emphasis0_Value>

<mode>eDP</mode>

<error>0</error>

<Swing0_Value>200</Swing0_Value>

<TestPattern>PLTPAT</TestPattern>

<connectionsReq/>

<BitRate>1.62</BitRate>

<SSC>Disabled</SSC>

Page 36: QPHY-eDP Instruction Manual - Teledyne LeCroycdn.teledynelecroy.com/files/manuals/qphy-edp-operators-manual.pdf · QPHY-eDP Instruction Manual 926426 Rev B 3 Installation and Setup