Tektronix TekExpress Automotive PAM3 Analysis Application Help Online Help
TekExpress® Automotive PAM3 Analysis Application
Printable Application Help
*P077160601*
077-1606-01
TekExpress® Automotive PAM3 Analysis Application
Printable Application Help
www.tek.com
077-1606-01
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.
TekExpress is a registered trademark of Tektronix, Inc.
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 .................................................................................................................................... 2
Technical support ........................................................................................................................... 2
Getting started
Supported oscilloscopes ................................................................................................................. 5
Recommended probes ..................................................................................................................... 5
Downloading and installing the software ....................................................................................... 6
Activate the license ......................................................................................................................... 6
View software version .................................................................................................................... 7
Application directories ................................................................................................................... 7
File name extensions ...................................................................................................................... 8
Operating basics
Launch the application .................................................................................................................... 9
Exit the application ....................................................................................................................... 10
Application controls ..................................................................................................................... 11
Global application controls ........................................................................................................... 13
Options menu overview ........................................................................................................... 13
TekExpress instrument control settings .................................................................................. 14
View connected instruments ................................................................................................... 15
Configure email settings .......................................................................................................... 16
Application panels overview ........................................................................................................ 18
Setup panel ................................................................................................................................... 19
Setup panel overview .............................................................................................................. 20
Set DUT parameters ................................................................................................................ 20
Select tests ............................................................................................................................... 32
Set acquisition tab parameters ................................................................................................. 33
Set configuration tab parameters ............................................................................................. 34
Set preferences tab parameters ................................................................................................ 38
Status panel overview ................................................................................................................... 39
TekExpress® Automotive PAM3 Analysis Application i
Table of Contents
Results panel ................................................................................................................................. 41
Results panel overview ............................................................................................................ 41
Preferences menu .................................................................................................................... 42
View test-related files .............................................................................................................. 42
Reports panel ................................................................................................................................ 43
Reports panel overview ........................................................................................................... 43
Select report options ................................................................................................................ 44
View a report ........................................................................................................................... 46
Report content ......................................................................................................................... 46
Running tests
Equipment connection diagram .................................................................................................... 49
Compensate the signal path .......................................................................................................... 61
Running tests ................................................................................................................................ 61
View test results ............................................................................................................................ 62
Saving and recalling test setup
Test setup files overview .............................................................................................................. 63
Save a test setup ............................................................................................................................ 63
Open load a saved test setup ......................................................................................................... 64
Create a test setup from default settings ....................................................................................... 64
Create a test setup using an existing one ...................................................................................... 64
SCPI commands
About SCPI command .................................................................................................................. 65
Socket configuration for SCPI commands ................................................................................... 65
TEKEXP:*IDN? ........................................................................................................................... 73
TEKEXP:*OPC? .......................................................................................................................... 73
TEKEXP:ACQUIRE_MODE ...................................................................................................... 74
TEKEXP:ACQUIRE_MODE? .................................................................................................... 74
TEKEXP:EXPORT ...................................................................................................................... 75
TEKEXP:INFO? ........................................................................................................................... 75
TEKEXP:INSTRUMENT ............................................................................................................ 76
TEKEXP:INSTRUMENT? .......................................................................................................... 76
TEKEXP:LASTERROR? ............................................................................................................. 77
TEKEXP:LIST? ............................................................................................................................ 77
TEKEXP:POPUP ......................................................................................................................... 78
TEKEXP:POPUP? ........................................................................................................................ 78
ii TekExpress® Automotive PAM3 Analysis Application
Table of Contents
TEKEXP:REPORT ...................................................................................................................... 79
TEKEXP:REPORT? ..................................................................................................................... 79
TEKEXP:RESULT? ..................................................................................................................... 80
TEKEXP:SELECT ....................................................................................................................... 81
TEKEXP:SELECT? ..................................................................................................................... 81
TEKEXP:SETUP .......................................................................................................................... 82
TEKEXP:STATE ......................................................................................................................... 82
TEKEXP:STATE? ........................................................................................................................ 83
TEKEXP:VALUE ........................................................................................................................ 83
TEKEXP:VALUE? ...................................................................................................................... 84
Command parameters list ............................................................................................................. 85
Examples ...................................................................................................................................... 93
TekExpress® Automotive PAM3 Analysis Application iii
Table of Contents
iv TekExpress® Automotive PAM3 Analysis Application
Welcome
Welcome to TekExpress® Automotive PAM3 Analysis software application.
Automotive Ethernet operates as a full-duplex communication link over a
twisted-pair cable. The Full-Duplex communication, along with PAM3 signaling,
adds complexity in validating the Electronic Control Units (ECU) in real-world
conditions. The TekExpress Automotive PAM3 Analysis application includes
unique Signal Separation capability and Electrical analysis.
The application enables you to separate traffic from two ECUs in full-duplex
mode without having to cut cables or make hardware changes to the Ethernet
cable using unique Signal Separation feature. The application provides more
visibility into your Automotive PAM3 design with PAM3-based measurements
including Eye Diagram, Bathtub Plot, and Jitter tests.
Key features
■
Signal separation algorithm enables the analysis of a full duplex signal by
separating them into their respective half duplex signals. The separation can
be performed without affecting the ECU system or dissecting the Ethernet
cable to install a directional coupler.
■
Eye Diagram in noisy condition provides better insight compared to SQI
(Signal Quality Index) value.
■
The separated waveforms obtained from the signal separation algorithm
enables you to decode both Master and Slave ECU signals simultaneously.
■
Measurements like eye height and eye width can be used to measure the eyeopening of the signals. Additionally, an eye mask can be added to check the
TekExpress® Automotive PAM3 Analysis Application v
Welcome
shape of the eye-diagrams. The jitter measurements include deterministic,
random and total jitter. The total jitter measurement can be calculated at a
particular Bit Error Rate (BER) to demonstrate the signal integrity of the
system. All the measurements can be performed on both master and slave
ECUs.
vi TekExpress® Automotive PAM3 Analysis Application
Getting help and support
Related documentation
The following manuals are available as part of the TekExpress Automotive
PAM3 Analysis Solution documentation set.
Table 1: Product documentation
Item Purpose Location
Online Help Application operation and User
Interface help
PDF of the Online Help Printable version of the compiled
help
PDF file that ships with TekExpress Automotive PAM3 Analysis
solution (TekExpress-Automotive-PAM3-Solution-SoftwarePrintable-Help-ENUS.pdf).
You can download the PDF version of the manual from the Tektronix
website.
Part number: 077-1606-xx
http://www.tek.com
TekExpress® Automotive PAM3 Analysis Application 1
Getting help and support
Conventions
Help uses the following conventions:
■
The term "Application," and "Software" refers to the TekExpress Automotive
PAM3 Analysis 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.
Technical support
General 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.
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, http://
www.tek.com.
When you contact Tektronix Technical Support, please include the following
information (be as specific as possible):
■
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.
2 TekExpress® Automotive PAM3 Analysis Application
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
■
If possible, save the waveform on which you are performing the
measurement as a .wfm file
TekExpress® Automotive PAM3 Analysis Application 3
Getting help and support
4 TekExpress® Automotive PAM3 Analysis Application
Getting started
Supported oscilloscopes
■
■
■
Recommended probes
5 Series Mixed Signal Oscilloscope (MSO54, MSO56, MSO58)
6 Series Mixed Signal Oscilloscope (MSO64) with bandwidth 4 GHz and
above
Firmware Version: 1.24.9.x or above
100BASE-T1
1000BASE-T1
Voltage probe
■
TDP1500
■
TDP3500
Current probe
■
TCP0030A
■
P6022
■
CT6
Voltage probe
■
TDP3500
Current probe
■
CT6
TekExpress® Automotive PAM3 Analysis Application 5
Getting started
Downloading and installing the software
Complete the following steps to download and install the latest PAM3
application. See Supported oscilloscopes on page 5 for compatibility.
1. Go to www.tek.com.
2. Click Downloads. In the Downloads menu, select DOWNLOAD TYPE as
Software and enter PAM3 in the MODEL OR KEYWORD field and click
SEARCH.
Figure 1: Download Manuals, Datasheets, Software and more
3. Select the latest version of software and follow the instructions to download.
Copy the executable file to the oscilloscope.
Activate the license
4. Double-click the executable and follow the on-screen instructions. The
software is installed at C:\Program Files\Tektronix\TekExpress\TekExpress
Automotive PAM3 Analysis.
5. Select Application > TekExpress Automotive PAM3 Analysis from the
oscilloscope Menu bar to launch the application.
Activate the license from the oscilloscope:
1. From the Help tab, select About.
2. Click Install License.
Browse to select the license file.
6 TekExpress® Automotive PAM3 Analysis Application
Getting started
View software version
Use the following instruction to view version information for the application.
Click Options > About TekExpress.
Application directories
The TekExpress Automotive PAM3 Analysis files are installed at the following
location:
C:\Program Files\Tektronix\TekExpress\TekExpress Automotive PAM3 Analysis
The application directory and associated files are organized as follows:
Figure 2: Application directory
The following table lists the default directory names and their usage:
Directory names Usage
ACP Contains application libraries
Bin Contains dll files
Compliance Suites Contains compliance specific files
Examples Contains examples for SCPI commands
ICP Contains instrument and application specific interface libraries
Images Contains images of the application
Lib Contains utility files specific to the application
Report Generator Contains style sheets for report generation
Tools Contains instrument and application specific files
TekExpress® Automotive PAM3 Analysis Application 7
Getting started
File name extensions
The TekExpress Automotive PAM3 Analysis software uses the following file
name extensions:
Table 3: 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
.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
8 TekExpress® Automotive PAM3 Analysis Application
Operating basics
Launch the application
To launch the TekExpress Automotive PAM3 Analysis application, select
Applications > TekExpress Automotive PAM3 Analysis from the oscilloscope
Menu bar.
Figure 3: TekExpress Automotive PAM3 Analysis
After first launch of the TekExpress Automotive PAM3 Analysis application, the
following changes take place on the oscilloscope.
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.
NOTE. If a user with new login ID launches "TekExpress Automotive PAM3
Analysis.exe", the "My TekExpress" folder is created in the Documents folder of
the new user.
TekExpress® Automotive PAM3 Analysis Application 9
Operating basics
When you first run the application after installation, the application checks for
Resources.xml located in the X:\ folder. The Resources.xml file gets created in
the X: drive. If the file is not found, then the application creates the file with
equipment details. Session files are then stored inside the X:\TekExpress
Automotive PAM3 Analysis folder. If this file is not found, the application runs
an instrument discovery program to detect connected instruments before
launching TekExpress Automotive PAM3 Analysis.
To keep the TekExpress Automotive PAM3 Analysis application window on top,
select Keep On Top from the Options menu. If the application goes behind the
oscilloscope application, click Application > TekExpress Automotive PAM3
Analysis to move the application to be in front.
NOTE. When Keep on Top is selected, you cannot access the combo boxes in the
application panels.
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.
10 TekExpress® Automotive PAM3 Analysis Application
Operating basics
Application controls
This section describes the application controls.
Table 4: Application control description
Item Description
Options menu
Test panel
Menu to display global application controls.
Controls that open tabs for configuring test settings and options.
Start / Stop button
Pause / Continue button
Clear 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.
Use the Pause button to pause the acquisition. When a test is
paused, this button changes as Continue.
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 the Results panel.
NOTE. This button is visible only when there are results data on
the panel.
TekExpress® Automotive PAM3 Analysis Application 11
Operating basics
Item Description
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.
12 TekExpress® Automotive PAM3 Analysis Application
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 4: Options
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
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
Keep On Top Keeps the TekExpress Automotive PAM3 Analysis application on top of
Detects, lists, and refreshes the connected instruments found on
specified connections (LAN, GPIB, USB, and so on)
all the application
NOTE. When Keep on Top is selected, you cannot access the combo
boxes in the application panels.
Email Settings Configures email options for test run and results notifications
MOI Displays the TekExpress Automotive PAM3 Analysis MOI (Method Of
Implementation) document
TekExpress® Automotive PAM3 Analysis Application 13
Operating basics
Menu Function
Help Displays the TekExpress Automotive PAM3 Analysis help
About TekExpress
■
Displays application details such as software name, version number,
and copyright
■
Provides a link to the end-user license agreement
■
Provides a link to the Tektronix Web site
See also. Application controls
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 controls 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.
Figure 5: TekExpress Instrument Control Settings
The connected instruments displayed here can be selected for use under Global
Settings in the test configuration section.
NOTE. Select GPIB (Default) and LAN when using TekExpress Automotive
PAM3 Analysis application on 5/6 Series MSO instruments.
See also. Options menu overview
14 TekExpress® Automotive PAM3 Analysis Application
Operating basics
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 be
recognized 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.
3. Click Refresh. TekExpress searches for connected instruments.
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.
TekExpress® Automotive PAM3 Analysis Application 15
Operating basics
Figure 6: TekExpress Instrument Control Settings
Configure email settings
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.
See also. Equipment connection diagram on page 49
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:
16 TekExpress® Automotive PAM3 Analysis Application
Operating basics
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 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.
TekExpress® Automotive PAM3 Analysis Application 17
Operating basics
6. In the Email Configuration section:
■
■
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 overview
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.
The TekExpress Automotive PAM3 Analysis 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.
Figure 7: Application panels
18 TekExpress® Automotive PAM3 Analysis Application
Operating basics
Table 5: 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.
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, test point, signal mode, and eye sections etc.),
and select report viewing options.
Setup panel
See also
Application controls
TekExpress® Automotive PAM3 Analysis Application 19
Operating basics
Setup panel overview
The Setup panel contains sequentially ordered tabs that help guide you through
the test setup and the execution process.
Set DUT parameters
Figure 8: Setup panel
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.
20 TekExpress® Automotive PAM3 Analysis Application
Loading...