How it Works
Tektronix
Loading...
T
Loading...
Loading...
TekExpress USB3.2 Tx Automated Test Solution Software Help
User manual
176 pgs3.64 Mb0
Table of contents
Loading...

Tektronix TekExpress USB3.2 Tx Automated Test Solution Software Help User manual

TekExpress® USB3.2 Tx USB 3.2 Automated Test Solution Software
Printable Application Help
*P077093906*
077-0939-06
TekExpress® USB3.2 Tx USB 3.2 Automated Test Solution Software
Printable Application Help
www.tek.com
077-0939-06
Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions. Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supersedes that in all previously published material. Specifications and price change privileges reserved.
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
Contacting Tektronix
Tektronix, Inc. 14150 SW Karl Braun Drive P.O. Box 500 Beaverton, OR 97077 USA
For product information, sales, service, and technical support:
■
In North America, call 1-800-833-9200.
■
Worldwide, visit www.tek.com to find contacts in your area.

Table of Contents

Welcome ............................................................................................................................................ vii
Getting help and support
Related documentation ................................................................................................................... 1
Conventions used in help ................................................................................................................ 2
Technical support ........................................................................................................................... 2
Getting started
Minimum system requirements ...................................................................................................... 3
Required windows 7/ windows 10 user account setting ................................................................. 4
Supported instruments .................................................................................................................... 6
Install the software .......................................................................................................................... 7
Verify application installation ........................................................................................................ 8
Activate the license ......................................................................................................................... 8
View software version .................................................................................................................... 9
Required my TekExpress folder settings ........................................................................................ 9
Set the my TekExpress folder permissions ..................................................................................... 9
Application directories and their contents .................................................................................... 11
File name extensions .................................................................................................................... 12
Where test files are stored ............................................................................................................ 13
Operating basics
Run the application ....................................................................................................................... 16
Application panels overview ........................................................................................................ 18
Global application controls ........................................................................................................... 20
Application controls ................................................................................................................ 20
Options menu overview ........................................................................................................... 21
TekExpress instrument control settings .................................................................................. 23
Configure email settings .......................................................................................................... 25
Setup panel ................................................................................................................................... 27
Setup panel overview .............................................................................................................. 27
Set DUT parameters ................................................................................................................ 28
Select tests ............................................................................................................................... 32
Set acquisition parameters ....................................................................................................... 34
Running tests on prerecorded (saved) waveforms .................................................................. 36
TekExpress USB3.2 Tx Automated Test Solution Help i
Table of Contents
Set configuration tab parameters ............................................................................................. 37
Preferences tab ........................................................................................................................ 41
Status panel ................................................................................................................................... 42
Status panel overview .............................................................................................................. 42
Results panel ................................................................................................................................. 44
Results panel overview ............................................................................................................ 44
View test-related files .............................................................................................................. 45
Preferences menu .................................................................................................................... 46
Reports panel ................................................................................................................................ 47
Reports panel overview ........................................................................................................... 47
Select report options ................................................................................................................ 48
View a report ........................................................................................................................... 50
Report contents ........................................................................................................................ 51
Running tests
Test process flow .......................................................................................................................... 53
Deskew real-time oscilloscopes .................................................................................................... 54
Instrument and DUT connection setup ......................................................................................... 55
Running tests ................................................................................................................................ 55
Prerun checklist ............................................................................................................................ 56
Saving and recalling test setup files
Test setup files overview .............................................................................................................. 57
Save a test setup file ..................................................................................................................... 57
Open (load) a saved test setup file ................................................................................................ 58
Run a saved test in prerecorded mode .......................................................................................... 59
Create a new test setup file based on an existing one ................................................................... 60
TekExpress programmatic interface
About the programmatic interface ................................................................................................ 61
To enable remote access ............................................................................................................... 62
Requirements for developing TekExpress client .......................................................................... 64
Remote proxy object ..................................................................................................................... 65
Client proxy object ....................................................................................................................... 66
Client programmatic interface example ....................................................................................... 67
Program remote access code example .......................................................................................... 70
USB-TX programmer interface commands .................................................................................. 71
ApplicationStatus() .................................................................................................................. 71
ii TekExpress USB3.2 Tx Automated Test Solution Help
CheckSessionSaved() .............................................................................................................. 72
Connect() ................................................................................................................................. 72
Disconnect() ............................................................................................................................ 74
GetCurrentStateInfo() .............................................................................................................. 75
GetDutId() ............................................................................................................................... 76
SetDutId() ................................................................................................................................ 77
GetGeneralParameter() ............................................................................................................ 77
GetReportParameter() ............................................................................................................. 78
GetResultsValue() ................................................................................................................... 80
GetSelectedVersions() ............................................................................................................. 81
GetTimeOut() .......................................................................................................................... 81
LockServer() ............................................................................................................................ 82
LockSession() .......................................................................................................................... 83
QueryStatus() ........................................................................................................................... 84
RecallSession() ........................................................................................................................ 85
RegisterStatusChangeNotification() ........................................................................................ 85
Run() ........................................................................................................................................ 87
SaveSession() .......................................................................................................................... 87
SaveSessionAs() ...................................................................................................................... 88
SelectSingleTest() ................................................................................................................... 89
SendResponse() ....................................................................................................................... 90
SelectDevice() ......................................................................................................................... 91
SelectSuite() ............................................................................................................................ 92
SelectTest() .............................................................................................................................. 92
test values for SelectTest command ........................................................................................ 94
SetInstrument() ........................................................................................................................ 96
SetPreRecorded() ..................................................................................................................... 97
SetTimeOut() ........................................................................................................................... 98
SetVerboseMode() ................................................................................................................... 99
Status() ................................................................................................................................... 100
Stop() ..................................................................................................................................... 100
TransferImages() ................................................................................................................... 101
TransferResult() ..................................................................................................................... 102
TransferWaveforms() ............................................................................................................ 102
UnlockServer() ...................................................................................................................... 103
UnlockSession() .................................................................................................................... 103
GetPassFailStatus() ............................................................................................................... 104
SetGeneralParameter() .......................................................................................................... 105
paramString values for SetGeneralParameter command ....................................................... 106
Table of Contents
TekExpress USB3.2 Tx Automated Test Solution Help iii
Table of Contents
SCPI commands
About SCPI command ................................................................................................................ 117
Socket configuration for SCPI commands ................................................................................. 117
TEKEXP:*IDN? ......................................................................................................................... 125
TEKEXP:*OPC? ........................................................................................................................ 125
TEKEXP:ACQUIRE_MODE .................................................................................................... 126
TEKEXP:ACQUIRE_MODE? .................................................................................................. 126
TEKEXP:EXPORT .................................................................................................................... 127
TEKEXP:INFO? ......................................................................................................................... 127
TEKEXP:INSTRUMENT .......................................................................................................... 128
TEKEXP:INSTRUMENT? ........................................................................................................ 128
TEKEXP:LASTERROR? ........................................................................................................... 129
TEKEXP:LIST? .......................................................................................................................... 129
TEKEXP:POPUP ....................................................................................................................... 130
TEKEXP:POPUP? ...................................................................................................................... 130
TEKEXP:REPORT .................................................................................................................... 131
TEKEXP:REPORT? ................................................................................................................... 131
TEKEXP:RESULT? ................................................................................................................... 132
TEKEXP:SELECT ..................................................................................................................... 133
TEKEXP:SELECT? ................................................................................................................... 133
TEKEXP:SETUP ........................................................................................................................ 134
TEKEXP:STATE ....................................................................................................................... 134
TEKEXP:STATE? ...................................................................................................................... 135
TEKEXP:VALUE ...................................................................................................................... 135
TEKEXP:VALUE? .................................................................................................................... 136
Command parameters ................................................................................................................. 137
Examples .................................................................................................................................... 148
Reference
Handle error codes ...................................................................................................................... 151
Signal validation ......................................................................................................................... 152
LFPS pattern type validation ................................................................................................. 152
CPx pattern type validation ................................................................................................... 153
Compliance pattern toggle mechanisms ..................................................................................... 154
Oscilloscope-based toggle ..................................................................................................... 154
AWG-based toggle ................................................................................................................ 156
AFG-based toggle .................................................................................................................. 157
iv TekExpress USB3.2 Tx Automated Test Solution Help
Table of Contents
Manual toggle ........................................................................................................................ 158
TekExpress USB3.2 Tx Automated Test Solution Help v
Table of Contents
vi TekExpress USB3.2 Tx Automated Test Solution Help

Welcome

Welcome to the TekExpress® USB3.2 Tx Automated Test Solution Software application (referred to as USB3.2 Tx in the rest of the document). TekExpress USB3.2 Tx provides an automated, simple, and efficient way to test USB3.2 Tx transmitter interfaces and devices for USB-IF compliance and allows you to correlate Sig Test results with DPOJET for better margin, debugging, and analysis.
Key features and benefits
■
■
■
■
■
■
Automated solution for USB Type C, Standard, and Micro connectors which support USB3.2 Tx specification and CTS (Gen1 & Gen 2).
DPOJET plugin for USB Type C, Standard, and Micro connectors which support USB3.2 Tx specification and CTS (Gen1 & Gen 2) with setup files and MOI.
Support embedding Channels (1 m, 2 m, and 3 m cable) and their respective filter files for Type C, Standard, and Micro connectors.
Automated Lane Switching for reversible Type C connector.
Command line support for SigTest (latest released version by USB-IF).
Manual support for compliance to debug with DPOJET USB and USBSSP plug-ins.
TekExpress USB3.2 Tx Automated Test Solution Help vii
Welcome
viii TekExpress USB3.2 Tx Automated Test Solution Help

Getting help and support

Related documentation

The following manuals are available as part of the TekExpress USB3.2 Tx Automated Test and Compliance Solution documentation set.
Table 1: Product documentation
Item Purpose Location
Help Application operation and User
PDF of the help Printable version of the
®
Interface help
compiled help
DPOJET SuperSpeed (USB) and SuperSpeed Plus (USB SSP) Setup Library Methods of Implementation (MOI) for Verification, Debug and Characterization.
Detailed information on test setup and execution
PDF file that ships with USB-TX and USBSSP-Tx software distribution (USB-TX-
Automated-Test-Solution­Software-Printable-Help-EN­US.pdf).
PDF file that ships with USB-TX and USBSSP-Tx software distribution.
TekExpress USB3.2 Tx Automated Test Solution Help 1
Getting help and support
See also

Technical support

Conventions used in help

Online help uses the following conventions:
■
■
Technical support
Tektronix values your feedback on our products. To help us serve you better, please send us your suggestions, ideas, or comments on your application or oscilloscope. Contact Tektronix through mail, telephone, or the Web site. See Contacting Tektronix for more information.
When you contact Tektronix Technical Support, please include the following information (be as specific as possible):
The term “DUT” is an abbreviation for Device Under Test.
The term “select” is a generic term that applies to the two methods of choosing a screen item (button, control, list item): using a mouse or using the touch screen.
General information
Application specific
information
■
All instrument model numbers
■
Hardware options, if any
■
Probes used
■
Your name, company, mailing address, phone number, FAX number
■
Please indicate if you would like to be contacted by Tektronix about your suggestion or comments.
■
Software version number
■
Description of the problem such that technical support can duplicate the problem
■
If possible, save the setup files for all the instruments used and the application.
■
If possible, save the TekExpress setup files, log.xml, *.TekX (session files and folders), and status messages text file.
■
If possible, save the waveform on which you are performing the measurement as a .wfm file.
2 TekExpress USB3.2 Tx Automated Test Solution Help

Getting started

Minimum system requirements

The following table shows the minimum system requirements needed for an oscilloscope to run TekExpress USB3.2 Tx.
Table 2: USB3.2 system requirements
Component Requirement
Oscilloscope See Supported instruments
Processor Same as the oscilloscope
Operating System Same as the oscilloscope:
Memory Same as the oscilloscope
Hard Disk Same as the oscilloscope
Display Super VGA resolution or higher video adapter (800 x
Firmware
■
Windows 7/ Windows 10 (64-bit only) SP1 Windows 7/
Windows 10 user account settings
600 minimum video resolution for small fonts or 1024 x 768 minimum video resolution for large fonts). The application is best viewed at 96 dpi display settings
■
TekScope 10.8.1 and later (for Windows 7)
1
■
TekScope 10.10.0 and above (for Windows 10)
Software
1
If TekExpress is running on an instrument that has a video resolution less than 800x600, connect and configure a second monitor to the instrument.
■
Microsoft .NET 4.0 Framework
■
DPOJET Jitter and Eye Analysis Tool (version 10.0.10 or higher) with Advanced Jitter and Eye analysis (DJA option) installed.
■
Microsoft Internet Explorer 7.0 SP1 or later, or other Web browser for viewing reports.
■
Adobe Reader software 7.0 or later for viewing portable document format (PDF) files.
■
Serial Data Link Analysis (SDLA) software, version 3.0.4 or later, for Channel De-Embed, for custom filter development.
TekExpress USB3.2 Tx Automated Test Solution Help 3
Getting started

Required windows 7/ windows 10 user account setting

Windows 7/ Windows 10 instruments need to have the User Account Control Settings set to Never Notify. To set User Account Control Settings:
1. Go to Control Panel > User Accounts > Change User Account Control settings.
2. Set the sliding control to Never Notify as shown in the image, and click OK.
Windows 7
4 TekExpress USB3.2 Tx Automated Test Solution Help
Getting started
Windows 10
See also
Supported oscilloscopes
TekExpress USB3.2 Tx Automated Test Solution Help 5
Getting started

Supported instruments

Table 3: Required equipment
Resource Model supported
Real-time oscilloscope Tektronix DPO/DSA/MSO70000C, D, DX, and SX series
oscilloscopes (Windows 7/ Windows 10 OS):
■
16 GHz bandwidth and above required for both Gen1 (5 Gbps) and Gen2 (10 Gbps) Normative and Informative measurements.
■
12.5 GHz bandwidth and above is suitable for Gen1 (5 Gbps) Normative and Informative measurements.
■
8 GHz bandwidth model is suitable for Gen1 (5 Gbps) debug only.
Probes Two TCA-SMA cables
Two SMP cables P7313SMA differential probe P7500 TriMode probe
USB3.2 Standard and Micro-B fixtures
The USB31AET fixture includes all Standard and Micro-B test fixtures for USB3.2 Tx compliance testing. This fixture set includes Tx Host and device testing, captive device testing, and Rx cal testing.
USB3.2 Type C fixtures
Tektronix AWG/AFG instruments
Tektronix Power Supply instruments
■
For Gen1 (5 Gb/s), use the USB3.0 Electrical Test Fixture.
■
For Gen2 (10 Gb/s), use th USB31AET fixture set.
■
The USB31CET fixture includes Type C fixtures for USB3.2 Tx Type C compliance testing.
■
The fixture set includes Tx Host and Device testing, captive device testing, and Rx Cal testing.
AWG7102, AWG7122 series with options 6, 8 AWG70001A, AWG70002A AWG5202, AWG5204 and AWG5208, AWG5014B, AWG5014C, AWG5012C, AWG5002C AFG3051C, AFG3052C, AFG3101, AFG3101C, AFG3102, AFG3102C, AFG3251, AFG3251C, AFG3252, AFG3252C, AFG3151C, AFG3152C AFG31101 /AFG31102, AFG31151 /AFG31152 or AFG31251 / AFG31252
PWS4205, PWS4305, PWS4323, PWS4602, PWS4721 AWG7102, AWG7122B, AWG7122C
6 TekExpress USB3.2 Tx Automated Test Solution Help
Getting started
Resource Model supported
Connector Type Standard Standard A to B connector
Micro Micro A and micro B connector
Type C Symmetrical connector on both
side
2
See also

Install the software

Minimum system requirements
Use the following steps to obtain the latest USB3.2 TX software from the Tektronix Web site and install on any compatible instrument running Microsoft Windows 7/ Windows 10 (64-bit). See Minimum System Requirements for details.
1. Close all applications (including the TekScope application).
2. Go to the www.tek.com Web site and locate the Downloads fields.
3. Enter tekexpress USB3.2 in the Model or Keyword field, select Software from the Select Download Type list, and click GO.
4. Select the latest version of software, and then follow instructions to
download the software file.
5. Copy or download the USB-TX installer executable file to the oscilloscope.
6. Double-click the installer .exe file to extract the installation files and launch
the InstallShield Wizard.
Follow the on-screen instructions. The software is installed at C:\Program Files (x86)\Tektronix\TekExpress\TekExpress USB3.2 Tx
7. Verify application installation
NOTE. To test Gen2 capable hosts, use the HSET tool. The HSET tool configures the host into the compliance mode.
2
A to mini-B from USB-IF is not compliant any more.
TekExpress USB3.2 Tx Automated Test Solution Help 7
Getting started
See also
Minimum system requirements
Supported instruments
Required My TekExpress folder settings

Verify application installation

To verify the installation was successful:
1. Open the TekScope application.
2. Click the Analyze menu.
3. Verify that TekExpress USB3.2 Tx is listed in the Analyze menu.
4. Click TekExpress USB3.2 Tx to open the application.
Verify that the application opens successfully.
See also

Activate the license

Required My TekExpress folder settings
Activate the license
See also
Activate the license using the Option Installation wizard in the TekScope application:
1. In the TekScope application menu bar, click Utilities > Option Installation.
The TekScope Option Installation wizard opens.
2. Push the F1 key on the oscilloscope keyboard to open the Option Installation help topic.
3. Follow the directions in the help topic to activate the license.
View version and license information
Required My TekExpress folder settings
8 TekExpress USB3.2 Tx Automated Test Solution Help
Getting started

View software version

To view version information for TekExpress USB3.2 Tx, click the Options button and select About TekExpress.
To view license and option key information in the TekScope applicaion:
1. In the TekScope application, select Help > About TekScope.
2. Scroll through the Options list to locate USB: TekExpress USB3.2 Tx and
USBSSP-Tx: TekExpress USB3.2 Tx .
3. To view the Option installation key value, look below the Options list.
See also
Activate the license
Options menu

Required my TekExpress folder settings

Before you run tests for the first time, you need to Set the My TekExpress folder
permissions.
See also
Application directories and usage
File name extensions

Set the my TekExpress folder permissions

Ensure that the My TekExpress folder has read and write access. Also verify that the folder is not set to be encrypted:
1. Right-click the folder and select Properties.
2. Select the General tab, and then click Advanced.
3. In the Advanced Attributes dialog box, ensure that the option Encrypt
contents to secure data is NOT selected.
TekExpress USB3.2 Tx Automated Test Solution Help 9
Getting started
See also
4. Click the Security tab and verify that the correct read and write permissions are set.
Application directories and usage
File name extensions
10 TekExpress USB3.2 Tx Automated Test Solution Help
Getting started

Application directories and their contents

TekExpress USB3.2 Tx
application
The TekExpress USB3.2 Tx application files are installed at the following location:
C:\Program Files (x86)\Tektronix\TekExpress\TekExpress USB3.2 Tx
The following table lists the application directory names and their purpose.
Table 4: Application directories and usage
Directory names Usage
Bin It contains USB3.2 TX application libraries.
Compliance Suites It contains compliance-specific files.
Examples It contains various support files.
ICP It contains instrument and USB3.2 TX
application-specific interface libraries.
Lib It contains utility files specific to the USB3.2 TX
application.
Report Generator It contains style sheets for report generation.
Setup Files It contains setup files.
Tools It contains instrument and USB3.2 TX
application-specific files.
.pdf, .chm Help files
TekExpress USB3.2 Tx Automated Test Solution Help 11
Getting started
See also

File name extensions

View test-related files
File name extensions
The TekExpress USB3.2 Tx application uses the following file name extensions:
File name extension Description
.TekX Application session files (the extensions may not
be displayed)
.py Python sequence file
.xml Test-specific configuration information
(encrypted) files Application log files
.wfm Test waveform files
.mht Test result reports (default)
Test reports can also be saved in HTML format
.flt Filter files
.xslt Style sheet used to generate reports
.pdf, .chm Help files
See also
View test-related files
Application directories and their contents
12 TekExpress USB3.2 Tx Automated Test Solution Help
Getting started

Where test files are stored

When you launch TekExpress USB3.2 Tx for the first time, it creates the following folders on the oscilloscope:
■
\My Documents\My TekExpress\USB3.2 Tx
■
\My Documents\My TekExpress\USB3.2 Tx\Untitled Session
Every time you launch TekExpress USB3.2 Tx, an Untitled Session folder is created in the USB3.2 Tx folder. The Untitled Session folder is automatically deleted when you exit the USB3.2 Tx application. To preserve your test session files, save the test setup before exiting the TekExpress application.
CAUTION. Do not modify any of the session files or folders because this may result in loss of data or corrupted session files. Each session has multiple files associated with it. When you save a session, the application creates a .TekX file, and a folder named for the session that contains associated files, on the oscilloscope X: drive.
See also
Set the My TekExpress folder permissions
Application directories and usage
File name extensions
TekExpress USB3.2 Tx Automated Test Solution Help 13
Getting started
14 TekExpress USB3.2 Tx Automated Test Solution Help

Operating basics

TekExpress USB3.2 Tx Automated Test Solution Help 15
Operating basics

Run the application

To start the TekExpress USB3.2 Tx application, do either of the following:
■
Select Analyze > TekExpress USB3.2 Tx from the TekScope menu.
■
The oscilloscope opens the TekExpress USB3.2 Tx application.
16 TekExpress USB3.2 Tx Automated Test Solution Help
Operating basics
When you first run the application after installation, the application checks for a file called Resources.xml located in the C:\Users\<username>\My TekExpress\USB3.2 Tx folder. The Resources.xml file gets mapped to the X: drive when the application launches. Session files are then stored inside the X:\USB3.2 Tx folder. The Resources.xml file contains information about available network-connected instruments. If this file is not found, the application runs an instrument discovery program to detect connected instruments before launching USB3.2 Tx.
NOTE. Do the steps in the Required My TekExpress folder settings topic before running tests with the USB3.2 Tx application for the first time.
To keep the USB3.2 Tx application window on top, select Keep On Top from the USB3.2 Tx Options menu. If the application goes behind the oscilloscope application, click Analyze > TekExpress USB3.2 Tx to move the application to be in front.
TekExpress USB3.2 Tx Automated Test Solution Help 17
Operating basics
See also
Required My TekExpress folder settings
Activate the license Application controls
Application panel overview

Application panels overview

TekExpress USB3.2 Tx uses panels to group related configuration, test, and results settings. Click a button to open the associated panel. A panel may have one or more tabs that list the selections available in that panel. Controls in a panel can change depending on settings made in that panel or another panel.
18 TekExpress USB3.2 Tx Automated Test Solution Help
Loading...
+ 146 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use