Tektronix TekExpress Industrial Ethernet Compliance Solution Help Online Help
TekExpress Industrial Ethernet (10Base-T1L)
Compliance Analysis Solution for 5/6 Series Mixed Signal
Oscilloscope (MSO)
Printable Application Help
*P077162400*
077-1624-00
TekExpress Industrial Ethernet (10Base-T1L)
Compliance Analysis Solution for 5/6 Series Mixed Signal
Oscilloscope (MSO)
Printable Application Help
www.tek.com
077-1624-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.tek.com to find contacts in your area.
Table of Contents
Welcome .............................................................................................................................................................. v
Getting help and support
Related documentation .................................................................................................................................. 1
Conventions ................................................................................................................................................... 1
Technical Support .......................................................................................................................................... 2
Getting started
Required instruments and applications .......................................................................................................... 3
List of supported instrument models .............................................................................................................. 4
Downloading and installing the software ........................................................................................................ 5
Activate the license ........................................................................................................................................ 5
View software version .................................................................................................................................... 5
File name extensions ..................................................................................................................................... 6
Operating basics
Launch the application ................................................................................................................................... 7
Exit the application ......................................................................................................................................... 8
Application controls ........................................................................................................................................ 8
Global application controls ........................................................................................................................... 10
Options menu overview .......................................................................................................................... 10
TekExpress instrument control settings ................................................................................................. 11
View connected instruments .................................................................................................................. 11
Configure email settings ......................................................................................................................... 12
Application panels overview ......................................................................................................................... 14
Setup panel .................................................................................................................................................. 15
Setup panel overview ............................................................................................................................. 15
Set DUT parameters .............................................................................................................................. 15
Select tests ............................................................................................................................................. 17
Set acquisition tab parameters ............................................................................................................... 18
Set configuration tab parameters ........................................................................................................... 20
Set preferences tab parameters ............................................................................................................. 26
Status panel overview .................................................................................................................................. 27
Results panel ............................................................................................................................................... 29
Results panel overview .......................................................................................................................... 29
TekExpress Industrial Ethernet Application Printable Help i
Table of Contents
View test-related files ............................................................................................................................. 30
Plots panel ................................................................................................................................................... 31
Plots panel overview .............................................................................................................................. 31
Viewing plots .......................................................................................................................................... 33
Reports panel ............................................................................................................................................... 35
Reports panel overview .......................................................................................................................... 35
Select report options .............................................................................................................................. 35
View a report .......................................................................................................................................... 37
Report content ........................................................................................................................................ 37
Running tests
Automate the signal generation ................................................................................................................... 39
Running tests ............................................................................................................................................... 40
View test results ........................................................................................................................................... 41
Saving and recalling test setup
Test setup files overview .............................................................................................................................. 43
Save a test setup ......................................................................................................................................... 43
Open load a saved test setup ...................................................................................................................... 43
Create a test setup from default settings ..................................................................................................... 44
Create a test setup using an existing one .................................................................................................... 44
Industrial Ethernet measurements
Test procedure for Industrial Ethernet measurements ................................................................................. 45
SCPI commands
About SCPI command .................................................................................................................................. 55
Socket configuration for SCPI commands ................................................................................................... 55
TEKEXP:*IDN? ............................................................................................................................................ 62
TEKEXP:*OPC? ........................................................................................................................................... 62
TEKEXP:ACQUIRE_MODE ......................................................................................................................... 62
TEKEXP:ACQUIRE_MODE? ....................................................................................................................... 63
TEKEXP:EXPORT ....................................................................................................................................... 63
TEKEXP:INFO? ........................................................................................................................................... 63
TEKEXP:INSTRUMENT .............................................................................................................................. 64
TEKEXP:INSTRUMENT? ............................................................................................................................ 64
TEKEXP:LASTERROR? .............................................................................................................................. 65
ii TekExpress Industrial Ethernet Application Printable Help
Table of Contents
TEKEXP:LIST? ............................................................................................................................................ 65
TEKEXP:MODE ........................................................................................................................................... 66
TEKEXP:MODE? ......................................................................................................................................... 66
TEKEXP:POPUP ......................................................................................................................................... 66
TEKEXP:POPUP? ....................................................................................................................................... 67
TEKEXP:REPORT ....................................................................................................................................... 67
TEKEXP:REPORT? ..................................................................................................................................... 67
TEKEXP:RESULT? ...................................................................................................................................... 68
TEKEXP:SELECT ........................................................................................................................................ 69
TEKEXP:SELECT? ...................................................................................................................................... 69
TEKEXP:SETUP .......................................................................................................................................... 70
TEKEXP:STATE .......................................................................................................................................... 70
TEKEXP:STATE? ........................................................................................................................................ 70
TEKEXP:VALUE .......................................................................................................................................... 71
TEKEXP:VALUE? ........................................................................................................................................ 71
Command parameters list ............................................................................................................................ 72
Examples ..................................................................................................................................................... 76
References
Measurement error messages ..................................................................................................................... 81
TekExpress Industrial Ethernet Application Printable Help iii
Table of Contents
iv TekExpress Industrial Ethernet Application Printable Help
Welcome
The TekExpress Industrial Ethernet application (10Base-T1L) is a compliance test solution for performing transmitter electrical
specification measurements and MDI return loss measurements in accordance to IEEE P802.3cg™ specifications. The Industrial
Ethernet application is an Ethernet-based point-to-point technology for long range industrial applications.
Key features
■
Fully automated setup wizard to perform transmitter electrical specification measurements and MDI electrical specification
return loss measurements.
■
Comprehensive reports of results with Pass/Fail status along with plots.
■
Offers full coverage of test measurements.
■
One instrument offering full coverage of measurements. Return Loss measurement is offered as a patented approach and
requires an oscilloscope only, without the need of an additional instrument (VNA).
■
Power Spectral Density (PSD) is an oscilloscope-based measurement and Spectrum analyzer is not required.
■
Validates Test Mode signals before performing measurements.
■
Ability to run the measurements multiple times and generate result statistics across runs.
TekExpress Industrial Ethernet Application Printable Help v
Welcome
Supported measurements
■
Transmitter Output Droop
■
Transmitter Timing Jitter
■
Transmitter Power Spectral Density and Power Level
■
Transmitter Output Voltage
■
Transmit Clock Frequency
■
MDI Return Loss
vi TekExpress Industrial Ethernet Application Printable Help
Getting help and support
Related documentation
The following manuals are available as part of the TekExpress Industrial Ethernet Solution documentation set.
Table 1: Product documentation
Item Purpose Location
Online Help In-depth operation and UI help.
PDF of the Online Help In-depth operation and UI help.
Conventions
Help uses the following conventions:
■
The term "Application," and "Software" refers to the TekExpress Industrial Ethernet application.
■
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.
■
A Note identifies important information.
Table 2: Icon descriptions
Icon Meaning
This icon identifies important information.
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.
TekExpress Industrial Ethernet Application Printable Help 1
Getting help and 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. Contact Tektronix through mail, telephone, or the Web site.
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
■
Modules 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.
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
■
If possible, save the waveform on which you are performing the measurement as a .wfm file
2 TekExpress Industrial Ethernet Application Printable Help
Getting started
Required instruments and applications
Table 3: Required instruments and applications
Category Description Model/Part number
Instrument Oscilloscope
5/6 series MSO oscilloscope with bandwidth
350MHz or above
Software option Serial compliance testing package - TekExpress
Industrial Ethernet
Instrument Signal Generator to test return loss
2-Channel AFG with a frequency range of 50MHz
or above
Probe Differential Probes TDP1500
Cable Same length cable for Signal source connections Quantity = 3
Accessory Adapter, SMA female to BNC male Part number: 015-0572-00
TF-XGbT Compliance Test Fixture and Calibration
Board
MSO54 with 5-BW-350, 5-WIN
(Windows 10 only)
CMINDUEN10
AFG31052
Quantity = 2
Quantity = 4
TF-XGbT
NOTE.
1.
Recommended oscilloscope firmware version v1.16.6 or later.
2.
A short RJ45 cable recommended for return loss calibration and measurement.
3.
To have common ground of the DUT, fixture and oscilloscope, one could use few minigator clip to stacking banana plug
[partnumber : 3220-12-2], to connect to the ground point on the oscilloscope.
TekExpress Industrial Ethernet Application Printable Help 3
Getting started
List of supported instrument models
This table lists all the supported oscilloscopes, signal sources, and probe models by this application.
Table 4: List of supported instrument models
Category Description Models
Instrument Oscilloscope
MSO 5/6 series oscilloscope with bandwidth
350MHz or above. (Windows 10 only)
1. MSO54 with 5-BW-350, 5-WIN
2. MS056 with 5-BW-350, 5-WIN
3. MSO58 with 5-BW-350, 5-WIN
4. MSO64 with 6-BW-1000, 6-WIN
Instrument Signal Generator to test return loss.
2-Channel AFG with a frequency range of 50MHz
or above
Probe Differential probes
1. AFG31052
2. AFG31102
3. AFG31152
4. AFG31252
1. TDP1500
2. P6248
Probe settings:
ATTENUATION: ÷10
3. P6247
Probe settings:
DC REJECT: OFF
BANDWIDTH: FULL
ATTENUATION: ÷10
4 TekExpress Industrial Ethernet Application Printable Help
Getting started
Downloading and installing the software
Complete the following steps to download and install the latest TekExpress Industrial Ethernet application. See Required
instruments and applications on page 3 for compatibility.
1. Go to www.tek.com.
2. Click Downloads. In the Downloads menu, select DOWNLOAD TYPE as Software and enter Industrial Ethernet in the
MODEL OR KEYWORD field and click SEARCH.
3. Select the latest version of software and follow the instructions to download. Copy the executable file to the oscilloscope.
4. Double-click the installer (.exe) and follow the on-screen instructions.
5. Select Application > TekExpress Industrial Ethernet from the Oscilloscope menu bar to launch the application.
Activate the license
Activate the license using the Option Installation wizard in the TekScope application:
1. From the MSO 5/6 Series Oscilloscope menu bar, click Help > About.
2. Click Install License, and then select the license file (*.Lic).
3. Follow the application instructions in the oscilloscope to activate the license.
4. After successful activation of the license, reboot the oscilloscope.
View software version
To view version information for Industrial Ethernet, click Options > About TekExpress.
TekExpress Industrial Ethernet Application Printable Help 5
Getting started
File name extensions
The TekExpress Industrial Ethernet software uses the following file name extensions:
Table 5: File name extension
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
.csv Test result reports
Plot data
.mht Test result reports (default)
Test reports can also be saved in HTML format
.pdf Test result reports
Application help document
.xslt Style sheet used to generate reports
.png Captured images
.wfm Tektronix waveform file.
6 TekExpress Industrial Ethernet Application Printable Help
Operating basics
Launch the application
To launch the TekExpress Industrial Ethernet application, select Applications > TekExpress Industrial Ethernet from the
oscilloscope menu bar.
Figure 1: DUT tab displayed when you launch the application
During launch, a "My TekExpress" folder is created in the Documents folder of the current user and gets mapped to "X" drive.
When the application is closed properly, the "X" drive will get unmapped. Session files are then stored inside the X:
\Industrial Ethernet folder. If this file is not found, the application runs an instrument discovery program to detect
connected instruments before launching TekExpress Industrial Ethernet.
To keep the TekExpress Industrial Ethernet application on top of any application, select Keep On Top from the Options menu. If
the application goes behind the oscilloscope application, click Applications > TekExpress Industrial Ethernet to move the
application to be in front.
TekExpress Industrial Ethernet Application Printable Help 7
Operating basics
See also
Exit the application
Exit the application
To exit the application, click on the application title bar. Follow on-screen prompts to save any unsaved session, save test
setup files, or exit the application.
NOTE. Using other methods to exit the application can result in abnormal termination of the application.
Application controls
This section describes the application controls.
Table 6: Application control description
Item Description
Options menu
Menu to display global application controls.
Test panel
Controls that open tabs for configuring test settings and options.
Start / Stop button
Use the Start button to start the test run of the measurements in the selected order.
If prior acquired measurements are not cleared, then new measurements are added
to the existing set.
The button toggles to the Stop mode while tests are running. Use the Stop button to
abort the test.
8 TekExpress Industrial Ethernet Application Printable Help
Operating basics
Item Description
Pause / Continue button
Use the Pause button to pause the acquisition. When a test is paused, this button
changes as Continue.
Clear button
Use the Clear button to clear all existing measurement results. Adding or deleting a
measurement, or changing a configuration parameter of an existing measurement,
also clears measurements. This is to prevent the accumulation of measurement
statistics or sets of statistics that are not coherent. This button is available only on
Results panel.
NOTE. This button is visible only when there are results data on the panel.
Application window move icon
Minimize icon
Close icon
Mini view / Normal view
Place the cursor over the top of the application window to move the application
window to the desired location
Minimizes the application.
Close the application.
Toggles the application between mini view and normal view.
Mini view displays the run messages with the time stamp, progress bar,
Start / Stop button, and Pause / Continue button.
The application moves to mini view when you click the Start button.
TekExpress Industrial Ethernet Application Printable Help 9
Operating basics
Global application controls
The menus and controls that appear outside the individual tabs are called “Global Controls”. These are used to specify the
devices to be tested.
Options menu overview
To access the Options menu, click in the upper-right corner of the application. It has the following selections:
Options menu
Figure 2: Options menu
Table 7: Options menu settings
Menu Function
Default Test Setup Opens a new test setup with default configurations.
Open Test Setup Opens a previously saved test setup.
Save Test Setup Saves the current test configurations with the specified file name.
Save Test Setup As Saves the current test setup with a different file name or file type
Open Recent Displays the recently opened test setups to open
Instrument Control Settings Detects, lists, and refreshes the connected instruments found on specified connections (LAN,
GPIB, USB, and so on).
Keep On Top Keeps the TekExpress Industrial Ethernet application on top of all the application.
Email Settings Configures email options for test run and results notifications
Help Displays the TekExpress Industrial Ethernet help
About TekExpress Displays application name, version, and hyperlink to end user license agreement.
See also. Application controls
10 TekExpress Industrial Ethernet Application Printable Help
Operating basics
TekExpress instrument control settings
Use the TekExpress Instrument Control Settings dialog box to search the instruments (resources) connected to the
application. You can use the Search Criteria options to search the connected instruments depending on the connection type.
The details of the connected instrument is displayed in the Retrieved Instruments window.
To access, click Options > Instrument Control Settings. Select USB and LAN as search criteria for TekExpress Industrial
Ethernet application and click Refresh. The connected instruments displayed here can be selected for use under Global Settings
in the test configuration section.
Figure 3: TekExpress Instrument Control Settings window
See also. Options menu overview
View connected instruments
Use the TekExpress Instrument Control Settings dialog box to search the instruments (resources) connected to the application.
The application uses TekVISA to discover the connected instruments.
NOTE. The instruments required for the test setup must be connected and detected by the application before running the test.
To refresh the list of connected instruments:
1. From the Options menu, select Instrument Control Settings.
2. In the Search Criteria section of the Instrument Control Settings dialog box, select the connection types of the instruments
to search.
Instrument search is based on the VISA layer, but different connections determine the resource type, such as LAN, GPIB,
and USB. For example, if you choose LAN, the search will include all the instruments supported by TekExpress that are
communicating over the LAN.
TekExpress Industrial Ethernet Application Printable Help 11
Operating basics
3. Click Refresh. TekExpress searches for connected instruments.
Figure 4: Search status of the instruments connected to LAN
4. After searching, the dialog box lists the instrument-related details based on the search criteria. For example, for the Search
Criteria as LAN and GPIB, the application displays all LAN and GPIB instruments connected to the application.
Figure 5: TekExpress Instrument Control Settings window
The details of the instruments are displayed in the Retrieved Instruments table. The time and date of instrument refresh is
displayed in the Last Updated field.
Configure email settings
Use the Email Settings utility to get notified by email when a measurement completes, or produces any error condition. Follow
the steps to configure email settings:
12 TekExpress Industrial Ethernet Application Printable Help
Operating basics
Email Settings
Figure 6: Email settings window
1. Select Options > Email Settings to open the Email Settings dialog box.
2. (Required) For Recipient email Address(es), enter one or more recipient email addresses. 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, then the @ symbol, and the email server ID.
For example: user@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: Select to receive the test report with the notification email.
■
Status Log: Select to receive the test status log with 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:
■
Enter a maximum file size for the email message. 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.
TekExpress Industrial Ethernet Application Printable Help 13
Operating basics
Application panels overview
TekExpress Industrial Ethernet solution uses panels to group Test Setup Configuration, Results, and Reports settings. Click any
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 tab can change depending on settings made in the same tab or another tab.
Table 8: Application panels overview
Panel Name Purpose
Setup panel The Setup panel shows the test setup controls. Click the Setup button to open this panel.
Use this panel to:
■
Set DUT tab parameters
■
Select tests
■
Set acquisition tab parameters
■
Set configuration tab parameters
■
Set preferences tab parameters
Status panel View the progress and analysis status of the selected tests, and view test logs.
Results panel View the summary of test results and select result viewing preferences.
Plots panel View the result as a two-dimensional plot for measurement analysis.
Reports panel Browse for reports, save reports as specific file types, specify report naming conventions, select
report content to include (summary information, detailed information, user comments, setup
configuration, application configuration, etc.), and select report viewing options.
14 TekExpress Industrial Ethernet Application Printable Help
Operating basics
See also
Application controls
Setup panel
Setup panel overview
The Setup panel contains sequentially ordered tabs that helps you guide through the test setup and execution process.
Figure 7: Setup panel
Set DUT parameters
Use the DUT tab to select parameters for the device under test. These settings are global and apply to all tests of the current
session. The DUT settings also affect the list of available tests in the Test Selection tab.
TekExpress Industrial Ethernet Application Printable Help 15
Operating basics
Figure 8: DUT tab
Click Setup > DUT to access the DUT parameters:
Table 9: DUT tab settings
Setting Description
DUT ID Adds an optional text label for the DUT to reports. The default value is DUT001. The
maximum number of characters is 32.
You cannot use the following characters in an ID name: (\,/:?”<>|*.)
Opens Comments dialog box to enter text to add to the report. Maximum size is
Comments icon (to the right of the
DUT ID field)
Acquire live waveforms Acquires active signals from the DUT for measurement and analysis.
Use pre-recorded waveform files Select to run tests on a saved waveform.
Suite Select the suite from the drop-down list. The available value is 10Base-T1L.
Version Displays the CTS specification for the selected suite.
Operating Mode Select the operating mode from the drop-down list. The available values are 1.0 Vpp,
See also. Select tests
256 characters. To enable or disable comments appearing on the test report, see Select
report options.
See Open (load) a saved test setup for steps to load a saved waveform.
2.4Vpp, Both.
16 TekExpress Industrial Ethernet Application Printable Help
Operating basics
Select tests
Use the Test Selection tab to select the tests. The test measurements available depends on the settings selected in the DUT.
tab.
Figure 9: Test Selection tab
Table 10: Test Selection tab settings
Setting Description
Deselect All
Select All
Tests Click on a test to select or unselect. Highlight a test to show
Test Description Displays brief description of the highlighted test in the test tree.
Schematic Displays an equipment and test fixture setup schematic
See also. Set acquisition tab parameters
Deselect or select all tests in the list.
details in the Test Description pane.
The application automatically selects all required tests when in
Compliance mode.
(connection diagram) for the selected test. Use to set up the
equipment and fixtures or to verify the setup before running the
test.
TekExpress Industrial Ethernet Application Printable Help 17
Operating basics
Set acquisition tab parameters
Use Acquisitions tab to view the test acquisition parameters. The contents displayed on this tab depends on the acquisition mode
selected in the DUT tab.
The TekExpress Industrial Ethernet application saves all acquisition waveforms to files by default. Waveforms are saved in a
unique folder for each session (a session is started when you click the Start button). The folder path is X:\TekExpress
Industrial Ethernet\Untitled Session\<dutid>\<date>_<time>. Images created for each analysis, XML
files with result values, reports, and other information specific to the session are also saved in this folder.
Saving a session moves the session file contents from the Untitled Session folder to the specified folder name, and changes the
session name to the specified name.
18 TekExpress Industrial Ethernet Application Printable Help
Operating basics
Acquire live waveforms for analysis. Select Acquire Live Waveforms on the DUT tab, to perform live acquisitions.
Figure 10: Acquisitions tab for Acquire Live Waveforms
Table 11: Acquisitions tab settings for Acquire Live Waveforms
Column name Description
Probe<x> Select the probe source channel for each listed signal in the Probe selection drop-
down menu.
Refresh Sources Click to refresh the sources.
Show Acquire Parameters Select to view the acquisition parameters for the selected tests in the results table.
Signal Validation
■
Prompt me if signal fails: Select to prompt if the signal fails.
■
Use Anyway: Click to Run the test on the current acquired signal in spite
of failed signal.
■
Skip Test: Click to skip the current test after signal validation fails.
■
Reacquire: Click to reacquire the signal for the test being Run.
■
Use signal as is-Don't check: Select to perform the test without signal
validation.
■
Skip test if signal fails: Select to skip the test for which signal validation fails.
TekExpress Industrial Ethernet Application Printable Help 19
Loading...