Tektronix TekExpress USB User manual
xx
TekExpress® USB
ZZZ
Automated Solutions
Printable Online Help
*P077035003*
077-0350-03
TekExpress® USB
Automated Solutions
ZZZ
PrintableOnlineHelp
www.tektronix.com
077-0350-03
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.
TekExpress is a registered trademark of Tektronix, Inc.
TekExpress USB Automated Solutions Online help, 076-0196-03.
Contacting Tektronix
Tektroni
14150 SW Karl Braun Drive
P. O . Box 5 00
Beaverton, OR 97077
USA
x, Inc.
For pro
duct information, sales, service, and technical support:
In North America, call 1-800-833-9200.
Worldwide, visit www.tektronix.com to find contacts in your area.
Table of Contents
General Safety Summary .......................................................................................... v
Introduction
Using Online Help....................... ................................ ................................ ........... 1
Related Documentation ............... ................................ .................................. ........... 1
Conventions ................................ ................................ .................................. ....... 2
Techn i c a
Getting Started
What is new in this release ........................................................................................ 5
Accessories..................... .................................. ................................ ................... 5
Minimum System Requirements......................... ................................ ......................... 6
Application Directories and Usage .. .................................. ................................ ........... 7
File Name Extensions.............................................................................................. 9
How To Activate the License......................................... ................................ ............. 9
Before You Click Run............................................................................................. 11
l Support . ................................ ................................ ................................. 3
Table of Contents
Operating Basics
TekExpress Application Overview .............................................................................. 15
Starting the Application....................... .................................. ................................ .. 16
Resizing the Application Window ................. ................................ .............................. 16
Exiting the Application . . .. . .. .. . .. .. . .. .. ... ... .. . .. . .. . .. . .. .. . .. . .. . .. . .. ... ... .. . .. . .. . .. . .. .. . .. . .. . .. . .. ... . 17
Global Controls ............ .................................. ................................ ...................... 17
Menus
File Menu.................... .................................. ................................ ................ 18
View Menu ............ ................................ .................................. ...................... 19
Tools Menu .................................................................................................... 19
Help Menu..................................................................................................... 22
How To
Deskew Real Time Oscilloscopes .. . .. . .. . .. .. . .. . .. . .. . .. . .. . .. ... .. . .. . .. . .. . .. . .. ... ... .. . .. . .. . .. . .. ... ... .. 23
Select the Test(s)..................... ................................ .................................. ............ 24
Configure and Run the Test(s)........................................ ................................ ............ 26
View and Select Connected Instruments.................. .................................. .................... 29
Use the Prerecorded Waveform for Analysis................................................................... 31
View the Progress of Analysis ........... ................................ ................................ ........ 33
View the Report.................................................................................................... 34
View Test Related Files................. ................................ .................................. ........ 35
Select and Run a Test Using SigTest Software ....................... .................................. ........ 35
TekExpress USB Automated Solutions Help i
Table of Contents
Use Filters ........ ................................ ................................ .................................. 38
Using the Nonstandard Filter .. . .. . .. .. . .. . .. ... .. . .. . .. . .. .. . .. . .. . .. . .. .. . .. . .. ... .. . .. . .. . .. .. . .. . .. . .. . .. 38
Using the Nonstandard Waveform Mask........................................... ........................ 40
CP0-CP1 Toggle Using Mechanisms........................ ................................ .................... 40
Scope Based Toggle .............................. ................................ ............................ 40
AWG Based Toggle........................................................................................... 42
AFG Based Toggle ............................... ................................ ............................ 43
No Toggle.......................... ................................ ................................ ............ 44
LFPS Pattern Type Validation. . .. . .. . .. .. . .. . .. . .. . .. .. . .. . .. . .. . .. .. . .. . .. . .. . .. .. . .. . .. . .. ... .. . .. . .. . .. ... .. . . 47
CP0 Pattern Type Validation . .................................. ................................ .................. 48
CP1 Pattern Type Validation . .................................. ................................ .................. 48
Application Examples
Testing a Device Transmitter Using USB-IF Software
Mask Testing on a Device with a Hardware Channel..................................................... 49
Testing a Device Transmitter Us
Set Up the Equipment ........................................................................................ 53
Testing Deterministic Jitter on a Device Back Panel ... .. . .. . .. .. . . . .. . . . .. .. . .. .. . .. .. .. . .. .. . .. .. . . . .. . 54
ing DPOJET Application
TekExpress Programmatic Interface
About the Programmatic Interface............................................................................... 59
Server and Client Proxy Objects................................................................................. 61
Remote Proxy Object................... .................................. ................................ .... 61
Client Proxy Object......................... .................................. ................................ 62
Programmatic Interface APIs
Connect() ...................................................................................................... 63
Disconnect()................................................................................................... 65
LockSession(). ................................ .................................. .............................. 66
UnlockSession() .............................................................................................. 67
GetDutId() ..................................................................................................... 68
ChangeDutId() ................................................................................................ 69
SaveSession() ................................................................................................. 70
SaveSessionAs() ........ ................................ .................................. .................... 71
RecallSession()................................................................................................ 72
Run() ....... ................................ ................................ .................................. .. 73
Stop()........................................................................................................... 74
Status()......................................................................................................... 75
TransferReport() .............................................................................................. 76
ApplicationStatus() ......... ................................ .................................. ................ 77
Select Panel Parameters...................................................................................... 78
Error Codes......................................................................................................... 79
Example ............................................................................................................ 80
ii TekExpress USB Automated Solutions Help
Troubleshooting
Instrument Connectivity ................ .................................. ................................ ........ 81
TestStand Run time Engine Installation......................................... ................................ 81
Reference
Shortcut Keys .............. ................................ ................................ ........................ 83
Index
Table of Contents
TekExpress USB Automated Solutions Help iii
Table of Contents
iv TekExpress USB Automated Solutions Help
General Safety Summary
Review the following safety precautions to avoid injury and prevent damage to this product or any
products connected to it.
To avoid potential hazards, use this product only as specified.
Only qualified personnel should perform service procedures.
While using this product, you may need t o access other parts of a larger system. Read the safety sections
of the other component manuals for warnings and cautions related to operating the system.
To Avoid Fire or Personal Injury
Connect and disconnect properly. Connect the probe output to the measurement instrument before
connecting the probe to the circuit under test. Connect the probe reference lead to the circuit under test
before c
under test before disconnecting the probe from the measurement instrument.
onnecting the probe input. Disconnect the probe input and the probe reference lead from the circuit
General Safety Summary
Observ
Consult the product manual for further ratings information before making connections to the product.
Do not
Do not operate with sus p ected failures. If you suspect that there is damage to this product, have it inspected
by qu
Avoid exposed circuitry. Do not touch exposed connections and components when power is present.
e all terminal ratings. To av o i d fire or shock hazard, observe all ratings and markings on the product.
operate without covers. Do not operate this product with covers or panels removed.
alified service personnel.
Terms in This Manual
ese terms may appear in this manual:
Th
WARNING. Warning statements identify conditions or practices that could result in injury or loss of life.
CAUTION. Caution statements identify conditions or practices that could result in damage to this product
or other
property.
TekExpress USB Automated Solutions Help v
General Safety Summary
vi TekExpress USB Automated Solutions Help
Introduction Using Online Help
Using Online Help
Select Help from the menu to open the help file. You can also find an electronic copy of the help file in the
Documents directory on the 063-4068-XX DVD.
Tables of Contents (TOC) tab — Organizes the Help into book-like sections. Select a book icon to open
a section; select any of the topics listed under the book.
Index tab — Enables you to scroll a list of alphabetical keywords. Select the topic of interest to bring
up the appropriate help page.
Search tab — Allows a text-based search.
Follow these steps:
1. Type the word or phrase you want to find in the search box. If the word or phrase is not found, try the
Index tab.
2. Choose a topic in the lower box, and then select the Display button.
General Help Functions
Select the Print button from the Help topics menu bar to print a topic.
To return to the previous window, select the Back button.
Use hyperlinks to jump from one topic to another.
e Back button is grayed out or a jump is not available, choose the Help Topics button to return to
If th
the originating help folder.
ated Documentation
Rel
addition to TekExpress USB Online Help, the following documentation is included with the software:
In
DPOJET SuperSpeed (USB 3.0) Setup Library Methods of Implementation (MOI) for Verification,
ebug and Characterization, Tektronix part number 077-0266-xx.
D
TekExpress USB Online Help (PDF version), Tektronix part number 077-0350-XX.
TekExpress USB Automated Solutions Help 1
Introduction Conventions
Conventions
The online help uses the following conventions:
The term “DUT” is an abbreviation for Device Under Test.
The term “select” is a generic term that applies to the two mechanical methods of choosing an option:
using a mouse or using the touch screen.
Table 1: Ico
Icon Meaning
xxx
n descriptions
This icon i
This icon identifies conditions or practices that could result in loss of data.
This icon identifies additional information that will help you use the
application more efficiently.
dentifies important information.
2 TekExpress USB Automated Solutions Help
Introduction Technical Support
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.
When you contact Tektronix Technical Support, please include the following information (be as specificas
possible):
General Information
All instru
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.
ment model numbers.
Application Specific Information
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.
ssible, save the application setup files, log.xml and status messages text file.
If po
If possible, save the waveform on which you are performing the measurement as a .wfm file.
Forward the information to technical support using one of these methods:
E-mail – techsupport@tektronix.com
FAX – (503) 627-5695
TekExpress USB Automated Solutions Help 3
Introduction Technical Support
4 TekExpress USB Automated Solutions Help
Getting Started What is new in this release
What is new in this release
This version of TekExpress USB provides the following feature enhancements:
LFPS Tburst & Trepeat tests.
Windows 7 Support.
New UI for toggle options using AWG/AFG/Scope.
Accessori
About the Test Fixture
For Host Testing. TF-USB3-A-P (for best signal quality) or for more mechanical flexibility use
TF-USB-B-R (with included 13 cm USB 3.0 Cable - Part n umber 174-5772-00). For precision De-Embed
of TF-US
For Device Testing. TF-USB3-A-R (includes short USB 3.0 Cable).
Supported Probes
The following probes support TekExpress USB application:
P7313 SMA differential probe
P7500 Tri-Mode probe
es
B3-A plug fixture, order TF-USB3-AB-KIT (includes Cal Kit).
TekExpress USB Automated Solutions Help 5
Getting Started Minimum System Requirements
Minimum System Requirements
The minimum system requirements for a PC to run the application are as follows:
Table 2: System requirements
Processor
Pentium 4/M or equivalent processor.
Operating System Windows XP Service Pack 2.
Memory
Hard Disk
512 MB of memory.
Approximately 2 GB of available hard-disk space for the recommended
installation, which includes full TekExpress installation and distributed
components.
Drive DVD drive
Display
Super VGA resolution or higher video adapter (800x600 minimum video
resolution for small fonts or 1024x768 minimum video resolution for large fonts).
The application is best viewed at 96 dpi display settings
1
.
Software TekExpress Framework (v1.4.6 or later) installed.
SigTest 3.1.30 or later installed.
DPOJET Jitter and Eye Analysis Tool (v3.4.0 or later) with Advanced Jitter
and Eye analysis (DJA option) installed.
SDLA software for Channel De-Embed for custom filter development
(optional).
Microsoft Internet Explorer 7.0 or later.
Adobe Reader 6.0 or equivalent software for viewing portable document
format (PDF) files.
Other Devices Microsoft compatible mouse or compatible pointing device.
Four USB ports (2 USB ports minimum).
PCI-GPIB or equivalent interface for instrument connectivity2.
xxx
1
If TekExpress is running o n an instrument that has a video resolution lower than 800x600 (for example, sampling oscilloscope), it is recommended
to connect a secondary monitor and this has to be enabled before launching the application.
2
If TekExpress is installed on a Tektronix oscilloscope, the virtual GPIB port cannot be used by TekExpress for communicating with oscilloscope
applications.
If external devices like USB-GPIB or equivalent are used for instrument connectivity, ensure that the Talker Listener utility is enabled in the
/DPO/DSA oscilloscope's GPIB menu.
MSO
6 TekExpress USB Automated Solutions Help
Getting Started Application Directories and Usage
Application Directories and Usage
TekExpress USB is installed the following directory path, depending on the Windows operating system.
For Windows 7:
C:\Program Files (x86)\Tektronix\TekExpress\TekExpre ss USB
For Windows XP and Windows XP-Embedded:
C:\Program
The application directory and associated files are organized as follows:
Files\Tektronix\TekExpress\TekExpress USB
TekExpress USB Automated Solutions Help 7
Getting Started Application Directories and Usage
The following table lists the default directory names and their usage:
Table 3: Default directory names and their usage
Directory names Usage
InstallDir\TekExpress Contains the TekExpress application and associated
files.
\TekExpress\TekExpress USB Contains files specific to TekExpress USB.
\TekExpress USB\Compliance Suites Contains compliance specific sequence files. The
folders under this directory represent the devices
to be tested.
\TekExpress USB\Compliance Suites\USB Includes the Device and Host Transmitter folders.
\TekExpress USB\Compliance Suites\USB\Device Includes the “Device Connector” folder.
\TekExpress USB\Compliance Suites\USB\Device\Device
Connector
\TekExpress USB\Compliance Suites\USB\Host Includes the “Host Connector” folder.
\TekExpress USB\Compliance Suites\USB\Host\Host Connector Contains application specific files for Host.
\TekExpress US B\ACP
\TekExpress US B\SCP
\TekExpress USB\ICP
\TekExpress USB \Data Manager
\TekExpress USB \Data Storage
\TekExpress USB\Report Generator
\TekExpress USB\Documents Includes the Method of Implementation documents
\TekExpress USB\Bin
\TekExpress USB\Lib
\TekExpress USB\Tools
xxx
Contains application specific files for Device.
Includes instrument and application specific
interface libraries of TekExpress.
Includes the result management specific libraries of
TekExpress are present in these folders.
and technical documentation for the application.
Includes the miscellaneous libraries of TekExpress.
8 TekExpress USB Automated Solutions Help
Getting Started File Name Extensions
File Name Extensions
Thesoftwareusesthefollowingfile name extensions:
File name extension Description
.TekX
.seq
.xml
.mht
.PDF
.msk
.fltThefilter file.
.html
xxx
The session file will be saved in this format.
The test sequence file.
The encrypted XML file that contains the test specificconfiguration information. The
log file extension i s also xml.
This file details the test report.
The PDF file that details the method of implementation for the test.
The mask file.
The htm l file.
How To
Follo
NOTE. Ensure that your TekExpress USB dongle is installed on your host system.
1. Cli
2. Click the View Version Details link to check the version numbers of the installed test suites.
Activate the License
w the steps below to activate the license:
ck Help > About to view the license information.
TekExpress USB Automated Solutions Help 9
Getting Started How To Activate the License
3. Click the V
Agreement window. Click Print to print the License Agreement.
4. Click License Info to view the available software options. This window shows the license key and the
ous options with their status (active or inactive) with the current license key.
vari
5. If you are activating the license for the first time, the license key field will be empty. To activate the
ense, connect the USB dongle to your computer, enter the license key provided in the license
lic
iew End-User License Agreement link to open t he following Tektronix Software License
key certificate, and click Activate. If the activation is successful, a
the license key field.
10 TekExpress USB Automated Solutions Help
sign is displayed next to
Getting Started Before You Click Run
6. If you are reactivating the license, click Reactivate, enter the new license key and click Activate.
Before You C lick Run
After you first launch TekExpress, it creates the following folders on your computer:
\My Doc
uments\My TekExpress
NOTE. Ensure that the “My TekExpress” folder has read and write access.
NOTE.
created under that user's
If a user with a different Windows login ID launches TekExpress, a new
My Documents
ocuments\My TekExpress\USB
\My D
\My Documents\My TekExpress\USB\Untitled Sess ion. Every time the USB.exe is
nched an
lau
Untitled Session folder is created under USB folder. The Untitled Session folder
folder.
.
My TekExpress
folder is
is deleted when you exit TekExpress.
CAUTION. Each session has multiple files associated with it. Do not modify any of the session files and/or
folders as this may result in loss of data or corrupted session files.
The My TekExpress folder is created as a shared folder with share name as <domain><user
ID> My TekExpress
name><user ID> My TekExpress
(or if the PC is not connected to domain then share name is <Computer
).
TekExpress USB Automated Solutions Help 11
Getting Started Before You Click Run
NOTE. If the X: drive is mapped as a Local Disk and you want to map X: to a shared network location
on a PC on which TekExpress is running, you need to manually unmap the Local Disk X: using the
command (subs
t x: /d) from the command prompt and then manually map X: on the oscilloscope to
desired network location.
The above shared folder is mapped as X: (X drive) on the PC where TekExpress is running.
NOTE. If X drive is mapped to any other shared folder, TekExpress will display a warning message window
asking you to disconnect the X: drive manually.
Do the following before you click Run:
NOTE. Ensure that the network connectivity is enabled on the PC running TekExpress.
1. Map the shared My TekExpress folder as X: (X drive) on all the instruments used in the test setup
running Microsoft Windows Operating System. This share folder is used to save the waveform files
or any o
ther file transfer operations.
2. Right click on the
en Advanced.IntheAdvanced Attributes window, ensure that the option Encrypt contents
and th
to secure data is NOT selected. Click here
3. Ensu
re that all the required instruments are properly warmed up, and that Signal Path Compensation
My TekExpress folderandopentheProperties dialog box. Select the General tab
to view the picture.
(SPC) is performed.
Mapping My TekExpress folder
To map the My TekExpress folder on the instruments, follow the steps below:
1. Open Windows Explorer.
om the Windows Explorer menu, select Tools > Map Network drive.
2. Fr
3. Select the Drive letter as X: (if there is any previous connection on X:, disconnect it first through
ools > Disconnect Network drive menu of Windows Explorer).
T
4. In the Folder field, enter remote
TekExpress).
5. You can determine the IP address of the PC where “My TekExpress” folder exists by doing
the following:
Select Start > Run menu on the PC where My TekExpress folder exists.
My TekExpress folder path (for example, \\192.158.97.65\My
Enter cmd and click Enter.
At command prompt, type ipconfig.
12 TekExpress USB Automated Solutions Help
Getting Started Before You Click Run
You c a n
1. On the oscilloscope main menu, click Utilities menu.
2. Click Instrument Calibration option.
find SPC by following the steps below:
TekExpress USB Automated Solutions Help 13
Getting Started Before You Click Run
14 TekExpress USB Automated Solutions Help
Operating Basics TekExpress Application Overview
TekExpress Application Overview
TekExpress is the Tektronix Compliance Test Automation Framework, developed to support current and
future test automation needs of customers. It is a highly modular architecture that enables deploying
automated te
The TekExpress U SB application (Opt. USB-TX) is the automated version of USB3.0 measure ments from
DPOJET Timi
solution for verification, characterization, and debug.
Key Features
The following are the key features of TekExpress USB application:
Comprehensive test coverage
st solutions for various serial standards in a relatively short time.
ng and Analysis tool. With TekExpress USB, Tektronix provides Fully-Automated Tx
Precise
Accurate and reliable results
Integrated Signal Test Tool (Sigtest Tool software installation is required — available from the
USB-IF.)
debugging and troubleshooting
TekExpress USB Automated Solutions Help 15
Operating Basics Starting the Application
Starting the Application
To start the application, you can do one of the following:
Click Start > Programs > Tektronix > TekExpress > TekExpress USB. Other applications follow
similar pattern.
Double click the icon on the desktop.
If you have previously save d a session, you can double-click the session file stored under My
TekExpress\USB
When the application is launched it displays the splash screen providing launch information. The
application also checks for the presence and validity of the USB dongle.
.
NOTE. If the application was not terminated properly during the last use, a dialog box prompts to recall
the previously unsaved session.
Resizing the Application Window
minimize the application, click
To
previous size, select
To maximize the application, click . To restore it to previous size, click on the application
title bar.
16 TekExpress USB Automated Solutions Help
on the application title bar. To restore the application to its
in the Windows task bar.
Operating Basics Exiting the Application
Exiting the Application
To exit the application, do one of the following:
Click File > Exit.
Click on the application title bar.
Global Con
The menus a
used to specify the devices to be tested.
Table 4: Controls and Functions
Control name Function
DUT ID
xxx
trols
nd controls that appear outside the individual tabs are called “Global Controls”. These are
The device ID is specified at the global level and the
mation is stored in the default location for all data
infor
files. This field cannot be empty and does not allow these
special characters (.,..,...,\,/:?”<>|*). The maximum length
racters allowed is 32.
of cha
You will be able to run, pause, resume and stop the tests.
TekExpress USB Automated Solutions Help 17
Operating Basics File Menu
File Menu
Click File on the application menu bar.
The File menu has the following selections:
Menu Function
New Session Starts a default session of TekExpress.
Open Session Opens a saved session.
Save Session Saves the session.
Save Session As Saves a session in a different name.
Recently Recalled Setup Lists all the recent and previously recalled setup files.
Save Report As Saves the report in user specified location.
Print Preview Report
Print Report
Exit
x
xx
Previews the report before printing.
Opens the Windows “Print” dialog box.
Closes the application.
18 TekExpress USB Automated Solutions Help
Operating Basics View Menu
View Menu
Click View on the application menu bar.
The View menu has the following selections:
Menu Function
Log
xxx
Opens the log (log.xml) file in the default viewer.
Tools Menu
Click Tools on the application menu bar.
The Tools menu has the following selections:
Menu Function
Instrument Bench
Email Settings (see page 21) Opens a dialog box showing e-mail setting details.
xxx
ls > Instrument Bench
Too
Opens a dialog box showing the list of instruments attached to the test setup.
The Instrument Bench window shows the list of VISA and Non-VISA resources found on d ifferent
terfaces/connections. It serves two purposes at the launch of TekExpress:
in
Discovers the connected instruments.
Confirms the instrument connection setup.
When you click Tools > Instrument Bench, the following dialog box is displayed:
TekExpress USB Automated Solutions Help 19
Loading...