Tektronix TekExpress C-PHY Tx Help, C-PHY Tx Online Help
TekExpress
®
C-PHY Tx Essentials
Printable Application Help
*P077110800*
077-1108-00
TekExpress
®
C-PHY Tx Essentials
Printable Application Help
Supports C-PHY-Tx Product Firmware V1.0 and above.
www.tektronix.com
077-1108-00
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.tektronix.com to find contacts in your area.
Table of Contents
Welcome .............................................................................................................................................................. v
Getting help and support
Related documentation .................................................................................................................................. 1
Conventions used in help ............................................................................................................................... 1
Technical support ........................................................................................................................................... 1
Getting started
Installing the software .................................................................................................................................... 3
Install the software ................................................................................................................................... 3
Activate the license .................................................................................................................................. 3
View software version and license information ........................................................................................ 3
Application overview ...................................................................................................................................... 5
C-PHY Tx Essentials key features ........................................................................................................... 5
Supported oscilloscopes and probes ....................................................................................................... 5
Minimum system requirements ................................................................................................................ 6
Application directories and files ................................................................................................................ 7
File name extensions ............................................................................................................................... 7
Operating basics
Run the application ........................................................................................................................................ 9
Exit the application ......................................................................................................................................... 9
Application controls and menus ................................................................................................................... 10
Application controls ................................................................................................................................ 10
Options menu ......................................................................................................................................... 11
Application panels ........................................................................................................................................ 14
Application panel overview ..................................................................................................................... 14
Setup panel ............................................................................................................................................ 15
Status panel overview ............................................................................................................................ 22
Results panel .......................................................................................................................................... 23
Reports panel ......................................................................................................................................... 25
Setting up and configuring tests
About setting up tests ................................................................................................................................... 29
Instrument connection setup ........................................................................................................................ 29
C-PHY Tx Essentials Printable Application Help
i
Table of Contents
View connected instruments ........................................................................................................................ 31
Test setup overview ..................................................................................................................................... 32
Running tests
About running tests ...................................................................................................................................... 33
Before you click start .................................................................................................................................... 33
Pre-test checklist .......................................................................................................................................... 35
Saving and recalling test setups
Test setups overview ................................................................................................................................... 37
Save a test setup ......................................................................................................................................... 37
Recall a saved test setup ............................................................................................................................. 38
Create a new test setup based on an existing one ...................................................................................... 38
TekExpress programmatic interface
Programmatic interface overview ................................................................................................................. 39
Requirements for developing TekExpress client .......................................................................................... 40
To enable remote access ............................................................................................................................. 40
Remote proxy object .................................................................................................................................... 42
Client proxy object ........................................................................................................................................ 43
Client programmatic interface overview ....................................................................................................... 44
Program remote access code example ........................................................................................................ 46
C-PHY Tx Essentials command flow ........................................................................................................... 47
Connect through an IP address ................................................................................................................... 48
Lock the server ............................................................................................................................................. 49
Disable popup messages ............................................................................................................................. 50
Set or get the DUT ID ................................................................................................................................... 51
Set the configuration parameters for a suite or measurement ..................................................................... 52
Query the configuration parameters for a suite or measurement ................................................................. 55
Select a test ................................................................................................................................................. 58
Select a channel ........................................................................................................................................... 59
Configure the selected measurement .......................................................................................................... 62
Run with set configurations or stop the run operation .................................................................................. 63
Handle error codes ....................................................................................................................................... 64
Get or set the timeout value ......................................................................................................................... 65
Wait for the test to complete ........................................................................................................................ 66
After the test is complete .............................................................................................................................. 70
Save recall or query a saved session .......................................................................................................... 76
ii C-PHY Tx Essentials Printable Application Help
Table of Contents
Unlock the server ......................................................................................................................................... 78
Disconnect from the server .......................................................................................................................... 79
Reference
C-PHY Tx Essentials Parameters ................................................................................................................ 81
General parameters ............................................................................................................................... 81
Test parameters ..................................................................................................................................... 82
Map my TekExpress folder ..................................................................................................................... 83
Rise time ................................................................................................................................................ 83
Fall time .................................................................................................................................................. 83
Eye measurement .................................................................................................................................. 83
DC common mode measurement .......................................................................................................... 83
AC common mode mismatch measurement .......................................................................................... 83
AC common mode level variation ΔVCPTX(LF) between (50 MHz to 450 MHz) ................................... 84
AC common mode level variation ΔVCPTX(HF)(Above 450 MHz) ........................................................ 84
Intra-pair skew ........................................................................................................................................ 84
C-PHY Tx Essentials Printable Application Help iii
Table of Contents
iv C-PHY Tx Essentials Printable Application Help
Welcome
The Tektronix C-PHY Tx Essentials Automated Test software runs on Tektronix real-time oscilloscopes that are based on
Windows 7 computer operating systems. C-PHY Tx Essentials delivers the TekExpress 3.0 based C-PHY automation solution
with Tx measurement. It verifies the Eye diagram and performs width, and height measurement for C-PHY signals.
C-PHY Tx Essentials Printable Application Help v
Welcome
vi C-PHY Tx Essentials Printable Application Help
Getting help and support
Related documentation
The following information is available as part of the TekExpress C-PHY Tx Essentials Automated Solution application.
Table 1: Product documentation
Item Purpose Location
Online Help In-depth operation and UI help Application Help menu
PDF of the Online Help Operation and user interface help Application Help menu
Downloadable file from www.tektronix.com (Search
keywords ‘tekexpress c-phy tx’, type = manual; sort by
date for latest release)
See also
Technical support
Conventions used in help
Online Help uses the following conventions:
■
The term “DUT” is an abbreviation for Device Under Test.
■
The terms “click” and “select” are generic terms that mean to select an item in the application user interface (UI). You can
use a mouse or the touch screen to select UI items.
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):
General 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.
C-PHY Tx Essentials Printable Application Help 1
Getting help and support
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.
■
If possible, save the TekExpress setup files, log.xml, *.TekX (session files and folders), and status messages text file.
2 C-PHY Tx Essentials Printable Application Help
Getting started
Installing the software
Install the software
The TekExpress C-PHY Tx web installer page provides a link to the software package TekExpressC-PHYTXWebInstaller.exe
used to install the application on a supported oscilloscope. For a list of compatible instruments, see Supported oscilloscopes and
probes.
To download and install the files:
1. Close the TekScope application.
2. Go to the www.tek.com Web site and search for C-PHY Tx to locate the installation file. Download the file TekExpressC-
PHYTxWebInstaller.exe.
3. If you downloaded the file to a PC, copy the file to a supported Tektronix oscilloscope model.
4. Double-click the executable file to extract the installation files and automatically start the installer program. The software is
installed at the following location:
Windows 7 instruments: C:\Program Files (x86)\Tektronix\TekExpress\TekExpress C–PHYTx
Essentials
5. To run the application, open the TekScope application and select Analyze > C-PHY Tx Essentials.
See also. Minimum system requirements
Supported oscilloscopes and probes
Activate the license
Activate the license using the Option Installation wizard on the oscilloscope. The oscilloscope Online Help has instructions for
using the Options Installation window to activate licenses for installed applications. Follow these steps to activate the TekExpress
C-PHY Tx license:
1. From the oscilloscope menu, click Utilities > Option Installation.
The TekScope Option Installation wizard opens.
2. Press the F1 key on the oscilloscope keyboard to open the Option Installation help topic.
Follow the directions in the topic to activate the license.
See also. View software version and license information
View software version and license information
The following instructions show how to view version and license information for the application and associated modules such as
the Programmatic Interface and the Programmatic Interface Client.
C-PHY Tx Essentials Printable Application Help 3
Getting started
To view the version information:
1. Select Options > About TekExpress.
2. You can view the version numbers of the installed test suites. Click OK to close the dialog box when finished.
To view the end-user license agreement:
1. Select Options > About TekExpress.
Click View End-User Agreement. You can view the TekExpress End-User License Agreement.
2. Click Print to print the software license agreement.
3. Click Close, to close the dialog box.
To view the license information:
1. In the TekScope application, select Help > About TekScope.
The Options drop-down displays a list of installed options, including C-PHY Tx Essentials: C-PHY Tx Essentials solution.
2. Look in the Option Installation Key section for option key information.
See also. Activate the license
Options menu overview
4 C-PHY Tx Essentials Printable Application Help
Getting started
Application overview
C-PHY Tx Essentials key features
The Tektronix C-PHY TX Essentials Automated Test software runs on Tektronix real-time oscilloscopes that are based on
Windows 7 computer operating systems. C-PHY Tx Essentials delivers the TekExpress 3.0 based C-PHY automation solution
with Tx measurement.
■
Supports De embed and Embed software for three port on either side (6-port parameter support for de-embedding).
■
Verifies the rise time and fall time of the DUT C-PHY signals.
■
Performs both eye height and eye height measurements, and also verifies the eye diagram on C-PHY signals.
■
Verifies that the static point common mode voltage VCPTX of the Trio signal are within the Transmitter limit.
■
Verifies that the common-mode voltage mismatch (ΔVCMTPX)) of the DUT Data Lane HS Transmitter is less than the
maximum conformance limit.
■
Verifies that the common mode level variation is between 50 MHz to 450 MHz.
■
Verifies that the common mode level variation is above 450Mhz.
■
Measures the Intra pair skew of the trio signal.
Supported oscilloscopes and probes
The C-PHY Tx Essentials application runs on the following Tektronix oscilloscopes:
■
MSO/DPO70604C
■
MSO/DPO70804C
■
MSO/DPO/DSA 71254C
■
MSO/DPO/DSA71604C
■
MSO/DPO/DSA72004C
■
DPO/DSA72504D
■
DPO/DSA73304D
■
MSO/DPO72304DX
■
MSO/DPO72504DX
■
MSO/DPO73304DX
You need the following accessories to run C-PHY Tx Essentials:
■
Two Bias tees
■
Three 100psec RT/FT filters
■
Two BNC T connectors
■
Three matched pair SMA cables
■
Six male to male SMA connectors
■
Three binding posts (Female to Female)
■
Three TTC convertors
■
Amplifier
C-PHY Tx Essentials Printable Application Help 5
Getting started
Minimum system requirements
The following table shows the minimum system requirements for an oscilloscope to run TekExpress.
Table 2: System requirements
Component Requirement
Oscilloscope Supported oscilloscopes and probes
Processor Same as the oscilloscope
Operating System Same as the oscilloscope:
Win 7 64-bit
Memory Same as the oscilloscope
Hard Disk Same as the oscilloscope
Display Same as the oscilloscope
Firmware DPO/DSA/MSO TekScope v7.3.0.9 or later and DPOJET
verrsion is 6.2.1.8
Software
■
Microsoft .NET 4.0 Framework
■
Microsoft Excel 2002 or above
1
■
Microsoft Internet Explorer 6.0 SP1 or later
■
Adobe Reader 7.0 or equivalent software for viewing
portable document format (PDF) files
Probes Supported oscilloscopes and probes
Other Devices
■
Matched pair of SMA cables, two-set minimum for single
lane
■
Microsoft compatible mouse or compatible pointing device
NOTE. If TekExpress is installed on a Tektronix oscilloscope, TekExpress uses a virtual GPIB port to communicate with
oscilloscope applications. If external GPIB communication devices such as USB-GPIB-HS or equivalent are used for instrument
connectivity, make sure that the Talker Listener utility is enabled in the DPO/DSA/MSO oscilloscope GPIB menu. For ease of
use, connect to an external (secondary) monitor.
See also. Supported oscilloscopes and probes
Instrument connection setup
1
If TekExpress is running on an instrument having a video resolution lower than 800x600 (for example, sampling oscilloscope), it is recommended that you connect a
secondary monitor. The secondary monitor must be configured and active before launching the application.
6 C-PHY Tx Essentials Printable Application Help
Getting started
Application directories and files
The following table lists the default application directory names and their usage:
Table 3: Application directories
Directory names Contains
InstallDir\TekExpress\TekExpress CPHYTX Path to the root application directory and associated sub-
folders. The folders described in this table (ACP, Bin, and so
on) are all in this root directory
Bin Miscellaneous C-PHY Tx Essentials application libraries
Compliance Suites Compliance-specific files
Examples Various support files
ICP Instrument and C-PHY Tx Essentials application-specific
interface libraries
Lib Utility files specific to the C-PHY Tx Essentials application
Report Generator Excel Active X interface Library for Report Generation
Images Images related to C-PHY Tx Essentials are saved
Tools Instrument and C-PHY Tx Essentials application-specific files
See also. View test-related files
File name extensions
File name extensions
The C-PHY Tx Essentials application uses the following file name extensions:
File name extension Description
.TekX Saved session files. The extensions may not be displayed.
.seq Test sequence files
.xml Encrypted XML files that contain test-specific configuration
information
Note that the log file extension is also xml
.wfm Test waveform files
.mht
.mhtml
.pdf
See also. Select report options
View test-related files
Application directories and files
Test result report file formats (.mht is the default format).
C-PHY Tx Essentials Printable Application Help 7
Getting started
8 C-PHY Tx Essentials Printable Application Help
Operating basics
Run the application
To run the C-PHY Tx Essentials application, do either of the following:
■
Select Analyze > C-PHY Tx Essentials from the TekScope menu, OR
■
Double-click any saved C-PHY Tx Essentials session file.
When you open the application after installation, the application checks for a file called Resources.xml located in the My
TekExpress folder. If this file is not found, instrument discovery is performed before launching C-PHY Tx Essentials. The
Resources.xml file contains information regarding instruments that are available on your network.
If the application license was not installed using the TekScope menu Utilities > Option Installation selection, you can open and
demo the application 10 times. Each time you open the application without supplying a valid license key, one of the free trials is
used.
See also
Activate the license
Exit the application
Use the following method to exit the application:
NOTE. Using other methods to exit the application results in abnormal termination of the application.
1.
Click on the application title bar.
2. Do one of the following:
■
If you have an unsaved session or test setup open, you are asked to save it before exiting. To save it, click Yes.
Otherwise click No.
The application closes, OR
■
A message box appears asking if you really want to exit TekExpress. To exit, click Yes.
C-PHY Tx Essentials Printable Application Help 9
Operating basics
Application controls and menus
Application controls
Table 4: Application control descriptions
Item Description
Options menu Opens the Options menu for access to global controls
Panels Visual frames with sets of related options
Command buttons Buttons that initiate an immediate action such as the Start,
Stop, Pause, Continue, and Clear command buttons
Start button
Starts measurement acquisition and analysis.
Stop button
Stops (aborts) the current test run.
Pause \ Continue button
Clear button
Clear Log
Save
Application window move icon
Use the Pause button to temporarily interrupt the current test
run. When a test is paused, the button name changes to
Continue.
Clears all existing measurement results. Adding or deleting a
measurement, or changing a configuration parameter of an
existing measurement, also clears measurements. This
prevents the accumulation of measurement statistics or sets of
statistics that are not coherent. This button is available only on
the Results panel.
This button is available only on the Status panel.
This button is available only on the Status panel.
Place the cursor over the three-dot pattern in the upper left
corner of the application window. When the cursor changes to
a hand, drag the window to the desired location.
10 C-PHY Tx Essentials Printable Application Help
Operating basics
Options menu
Options menu overview. The Options menu is located in the upper right corner of the application.
The Options menu has the following selections:
Options Menu
Menu Function
Default Test Setup Opens an untitled test setup with defaults selected
Open Test Setup Opens a saved test setup
Save Test Setup Saves the current test setup selections
Save Test Setup As Creates a new test setup based on an existing one
Open Recent Displays a menu of recently opened test setups from which to
select
Instrument control settings Shows the list of instruments connected to the test setup and
allows you to locate and refresh connections to connected
instruments
Keep On Top Keeps the TekExpress C-PHY Tx utility on top of other open
windows on the desktop
Email settings Use to configure email options for test run and results
notifications
Help Displays TekExpress Help
About TekExpress
■
Displays application details such as software name,
version number, and copyright
■
Provides access to software version and license
information for your C-PHY Tx installation
■
Provides a link to the Tektronix Web site
See also. Application controls
C-PHY Tx Essentials Printable Application Help 11
Operating basics
Instrument control settings. Use the TekExpress Instrument Control Settings dialog box to search for and list the connected
resources (instruments) found on specified connections (LAN, GPIB, USB, and so on) and each instruments connection
information. You access this dialog box from the Options menu.
Use the Instrument Control Settings feature to and view instrument connection details. Connected instruments displayed here
can be selected for use in the Global Settings tab in the configuration section. See step 1 of Configure tests for details.
See also. View connected instruments
Options menu overview
12 C-PHY Tx Essentials Printable Application Help
Operating basics
Email settings. Use the Email Settings dialog box to enable C-PHY Tx to send an email message when a test completes,
produces an error, or fails. Select the type of test run information to attach to the email (such as test reports and test logs), the
email message format, and the email message size limit.
Open the Email Settings dialog box from the Options menu.
NOTE. Recipient email address, sender’s address, and SMTP Server are mandatory fields. You cannot clear these fields after
you enter a value. You can change the email address or enable or disable the mailing option.
NOTE. Once user enters the value in these fields, user will not be able to clear the fields. However user can enable or disable the
mailing option.
See also. Configure email settings
Options menu overview
Set test notification preferences
C-PHY Tx Essentials Printable Application Help 13
Operating basics
Configure email settings. To be notified by email when a test completes, fails, or produces an error, configure the email
settings.
1. Select Options > Email Settings to open the Email settings dialog box.
2. (Required) For Recipient email Address(es), enter one or more email addresses to which to send the test notification. To
include multiple addresses, separate the addresses with commas.
3. (Required) For Sender's Address, enter the email address used by the instrument. This address consists of the instrument
name, followed by an underscore, followed by the instrument serial number, the @ symbol and then the email server used.
For example: DPO72004C_B130099@yourcompany.com.
4. (Required) In the Server Configuration section, type the SMTP Server address of the Mail server configured at the client
location, and the SMTP Port number, in the corresponding fields.
If this server requires password authentication, enter a valid login name, password, and host name in the corresponding
fields.
NOTE. If any of the above required fields are left blank, the settings will not be saved and email notifications will not be sent
5. In the Email Attachments section, select from the following options:
■
Reports: Attach the test report to the notification email.
■
Status Log: Attach the test status log to the notification email. If you select this option, then also select whether you
want to receive the full log or just the last 20 lines.
6. In the Email Configuration section:
■
Select the message file format to send: HTML (the default) or plain text.
■
Enter a maximum file size for the email message (message plus attachment files). Messages with attachments larger
than this limit will not be sent. The default is 5 MB.
■
Enter the number in the Number of Attempts to Send field, to limit the number of attempts that the system makes to
send a notification. The default is 1. You can also specify a timeout period.
7. Select the Email Test Results When complete or on error check box. Use this check box to quickly enable or disable
email notifications.
8. To test your email settings, click Test Email.
9. To apply your settings, click Apply.
10. Click Close when finished.
Application panels
Application panel overview
Panels group related configuration, test and results settings.
The TekExpress C-PHY Tx Essentials panels are:
14 C-PHY Tx Essentials Printable Application Help
Operating basics
Table 5: Application panels
Panel name Description
Setup Set the DUT, test, acquisition, and report parameters.
Status View the progress and analysis status of the selected tests,
and view test logs.
Results View a summary of test results and select results viewing
preferences.
Reports Browse for reports, save reports as specific file types, specify
report naming conventions, select report content to include
(such as summary information, detailed information, user
comments, setup configuration, application configuration), and
select report viewing options.
See also. Application controls
About setting up tests
Setup panel
Setup panel overview. The Setup panel contains sequentially ordered tabs that help guide you through a typical test setup
process.
Set the DUT parameters
Select test(s)
Set lane acquisition source
Configure tests
Select test notification preferences
Items selected in one Setup tab may change options available in the following tabs. You can switch between the tabs in any
order to modify your test parameters.
C-PHY Tx Essentials Printable Application Help 15
Operating basics
DUT tab controls. Use the Setup panel DUT tab to select parameters for the device under test. The settings are global and
apply to all tests for the current session. DUT settings also affect the list of available tests in the Test Selection tab.
Figure 1: DUT tab settings
1. Click Setup > DUT.
2. (Optional) Enter the ID for the device. The default value is DUT001. The DUT ID parameter is added to reports.
3.
(Optional) To add comments to the test report, click the notepad icon ( ) to the right of the DUT ID field. Enter comment
text up to 256 characters. To enable or disable displaying comments in the test report, see Select report options.
4. Select from the following parameters. Settings that do not apply to compliance testing cannot be changed and are grayed
out.
Table 6: DUT tab settings
Control or field Description
Acquire live waveforms Acquire active signals from the oscilloscope for testing.
Use pre-recorded waveform files Run an analysis on a saved run session file. Select a file
from the Run Session field.
Data Rate Enter the data rate to include in the tests
NOTE. Values should be between 0.05 - 4.5
See also. About setting up tests
16 C-PHY Tx Essentials Printable Application Help
Operating basics
Test selection tab controls. Use the Test Selection tab to select the tests to run on the connected DUT and configure individual
test parameters. Click Setup > Test Selection to open this tab.
Table 7: Test Selection tab settings
Control or field Description
Deselect All Deselects (clears) all tests.
Select All Selects all listed tests.
Test Selection field Lists available test and if they are selected to run. Click in the
box adjacent to a test to select or unselect a test. Tests listed
are affected by DUT tab selections (Rise Time, Fall Time, Eye
Diagram, DC Common Mode, AC common mode mismatch,
AC common mode level variation between 50 MHz and
450 MHz, AC common mode level variation above 450 MHz,
IntraPair Skew).
Test Description field Shows a description of the selected test.
Schematic Opens a connection diagram that shows the DUT test setup.
Use the diagram to verify the test setup before running the test.
See also. About setting up tests
C-PHY Tx Essentials Printable Application Help 17
Operating basics
Configure test parameters. Use the Configuration button in the Test Selection tab to view or edit the global and measurement
parameters for selected tests. Global parameters set the instrument source and related parameters that are common for all tests.
Measurement parameters listed are specific to the tests in the Configuration view.
Figure 2: Configuration tab - Global Settings
Figure 3: Configuration tab - Measurements
18 C-PHY Tx Essentials Printable Application Help
Operating basics
Table 8: Test configuration settings
Control or field Description
User Defined Mode Enables editing of the global and measurement parameters for
tests.
Test Selection Returns the application window to the default Test Selection
tab listing.
Global Settings Click this tab to list the detected instrument(s) and any
available global parameters that you can set. The global
settings apply to all tests.
To select a different instrument, click on the instruments list in
the Instruments Detected area and select an instrument from
the menu. If you do not see the desired instrument in the list,
refresh the list. If the instrument is still not listed, verify that the
instrument is powered on, has correct network settings, and is
connected to the network or instrument.
Filter
■
Insertion Loss and Cross Talk
■
Insertion Loss
Measurements Lists all tests which are selected in the Test Selection tab.
Click on a measurement to view the available parameters in the
tabbed field below the list. The parameters and parameter type
tabs shown depend on the selected test.
See also. Configure tests
About running tests
C-PHY Tx Essentials Printable Application Help 19
Operating basics
Acquisitions tab controls. Use the Acquisitions tab to set the signal source (channel) used to acquire data for the tested lanes.
1. Click Setup > Acquisitions.
2. Select the Channels for VA, VB, and VC signals.
20 C-PHY Tx Essentials Printable Application Help
Loading...