Tektronix Switch Matrix Application Help User manual
Switch Matrix
Printable Application Help
*P077134601*
077-1346-01
Switch Matrix
Printable Application Help
www.tek.com
077-1346-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.
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 ............................................................................................................................................. iii
Getting help and support
Conventions used in help ................................................................................................................ 1
Related documentation ................................................................................................................... 1
Technical support ........................................................................................................................... 2
Getting started
Minimum system requirements ...................................................................................................... 3
Downloading and installing the application ................................................................................... 4
Purchase the license ........................................................................................................................ 4
Activate the license ......................................................................................................................... 5
View the software version .............................................................................................................. 5
Status indicators .............................................................................................................................. 6
File name extensions ...................................................................................................................... 6
Operating basics
Launch the application .................................................................................................................... 7
Application overview ..................................................................................................................... 9
Saved configurations .................................................................................................................... 16
De-embed settings ........................................................................................................................ 17
Apply a filter file for all relays ................................................................................................ 17
Apply a filter file for each relay type separately ..................................................................... 18
Apply a filter file for each relay separately ............................................................................. 18
Apply a filter file for each connection separately ................................................................... 19
Graphical view of switch matrix configuration ............................................................................ 20
Saving the configuration ............................................................................................................... 20
Feature description ....................................................................................................................... 21
Configure new switch .............................................................................................................. 21
Link width ............................................................................................................................... 26
Debug mode ............................................................................................................................ 26
Cascade (Relay cascade) ......................................................................................................... 27
Tutorial
Gigatronics switch configuration with cascade settings ............................................................... 31
Switch Matrix application help i
Table of Contents
Create a new configuration (four lane, two SP4T relays) ............................................................ 32
Configure the filter file for each relay separately ......................................................................... 33
Debug the Keithley S46T switch .................................................................................................. 34
SCPI commands
About SCPI commands ................................................................................................................ 35
Socket configuration for SCPI commands ................................................................................... 35
SWITCH:*IDN ............................................................................................................................. 42
SWITCH:*OPC ............................................................................................................................ 42
SWITCH:CONFIG ....................................................................................................................... 43
SWITCH:DE-EMBED:ALL:FILTER_FILE ............................................................................... 43
SWITCH:DE-EMBED:CONN:FILTER_FILE ............................................................................ 44
SWITCH:DE-EMBED:FILTER_FILE ........................................................................................ 45
SWITCH:DE-EMBED:MODE .................................................................................................... 46
SWITCH:DE-EMBED:RELAY:FILTER_FILE .......................................................................... 46
SWITCH:DE-EMBED:RELAY_TYPE:FILTER_FILE .............................................................. 47
SWITCH:LASTERROR .............................................................................................................. 47
SWITCH:LINKWIDTH ............................................................................................................... 48
SWITCH:RELAY:CASCADE ..................................................................................................... 49
SWITCH:RELAY:CASCADED .................................................................................................. 50
SWITCH:RELAY:COMMON ..................................................................................................... 50
SWITCH:RELAY:POLARITY .................................................................................................... 51
SWITCH:RELAY:SIGNAL ......................................................................................................... 52
Reference
Error messages .............................................................................................................................. 53
ii Switch Matrix application help
Welcome
Switch Matrix is a software solution which simplifies the user experience to
configure and setup automated multi-lane testing using RF switch. The solution
allows you to map each of the several transmitter signals and forward the selected
input either to another relay or to the oscilloscope channel.
Key Features:
■
Auto Detects Keithley and Gigatronics switches on the GPIB/LAN
interfaces.
■
De-embed using filter files with multiple de-embed options.
■
Apply single filter file for all relays, for each relay type separately, for each
relay separately, and for each connection separately.
■
Ability to cascade multiple relays within a switch.
■
Operates with TekExpress and DPOJET (Debug Mode)
■
Use standard built-in configurations or create custom configurations
■
Save/recall configurations
■
Graphical view with print option to support hardware wiring
■
Built in error handling to support easy and error-free configuration.
■
Programmatic interface to support scripting and easy integration into the
user’s automation environment.
Debug Mode:
■
Debug mode to manually close each relay channel.
■
Ability to close multiple contacts on a relay
■
Built-in Self-Test with report in .csv file
Switch Matrix application help iii
Welcome
Status Indicators:
■
Status indicators for each relay signal being de-embedded
■
Status indicator for input displaying open or close relay contacts
■
Live status for Self-Test
iv Switch Matrix application help
Getting help and support
Conventions used in help
This help uses the following conventions:
■
The terms "Application" and "Software" refer to the Switch Matrix
application.
■
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.
■
The term "close" refers to normally close the relay signal (select the signal).
■
The term "open" refers to normally open the relay signal (unselect the
signal).
■
The term "channel" refers to the relay signal or oscilloscope channel.
Related documentation
The following documentation is available as part of the Switch Matrix
application.
Table 1: Product documentation
Item Purpose Location
Help Application operation
and User Interface help
PDF of the help Printable version of the
compiled help
PDF of the TekScope
Application User
Manual
Activate the license
www.tek.com
®
Switch Matrix application help 1
Getting help and support
Technical support
Tektronix values 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):
■
Software version number
■
Description of the problem so that technical support can duplicate the
problem
■
If possible, save the setup files for all the instruments used and the
application.
2 Switch Matrix application help
Getting started
Minimum system requirements
The following table shows the minimum system requirements for the Switch
Matrix application.
Table 2: Minimum system requirements
Component Requirement
Oscilloscope
Firmware
■
TekScope 10.7.0 or greater (for Windows 7)
■
TekScope 10.8.0 or greater (for Windows 10)
Software
Operating system Windows 7
Processor Same as the oscilloscope
Memory Same as the oscilloscope
Hard Disk Same as the oscilloscope
Display Super VGA resolution or higher video adapter (800 x
Other devices Microsoft compatible mouse or compatible pointing device
■
IronPython 2.7.3 installed
■
PyVisa 1.0.0.25 installed
■
Microsoft .NET 4.0 Framework
■
Microsoft Internet Explorer 11.0 SP1 or greater, or other
Web browser for viewing reports
■
Adobe Reader software 7.0 or greater for viewing portable
document format (PDF) files
600 minimum video resolution for small fonts or 1024 x
768 minimum video resolution for large fonts). The application is
best viewed at 96 dpi display settings
1
1
If TekExpress is running on an instrument that has a video resolution less than 800x600, connect and configure a second monitor to the instrument.
Switch Matrix application help 3
Getting started
Downloading and installing the application
Complete the following steps to download and install the latest Switch Matrix
application. See Minimum system requirements for compatibility.
1. Go to www.tek.com.
2. Click Downloads. In the Downloads menu, select DOWNLOAD TYPE as
Software and enter Switch Matrix 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 into the oscilloscope.
Purchase the license
4. Double-click the executable and follow the on-screen instructions. The
software is installed at C:\Program Files\Tektronix\TekExpress\Switch
Matrix\.
5. Select Analyze > Switch Matrix from the TekScope menu to launch the
application.
Contact Tektronix to purchase the license key (Option). Visit www.tek.com to
find the contacts in your area.
4 Switch Matrix application help
Getting started
Activate the license
Refer to Install an option in the TekScope Application User Manual to activate
the license. This manual is downloadable from the Tektronix Web.
View the software version
Use the following instructions to view version information for the application and
for the application modules, such as the programmatic interface and the
programmatic interface client.
To view the version information, click Options > About Switch Matrix in
Switch Matrix configuration panel.
A dialog box similar to the following figure appears.
Switch Matrix application help 5
Getting started
Status indicators
Status indicators Description
Success indicator
Failure indicator
Closed channel indicator (NC = Normally
Closed)
Opened channel indicator (NO = Normally
Opened)
File name extensions
This application uses the following file name extensions:
File name extension Description
.html Saved configuration and Graphical view file formats
.xml Switch Matrix configuration files
6 Switch Matrix application help
Operating basics
Launch the application
Complete the following steps to launch the Switch Matrix application:
1. Click Analyze > Switch Matrix from the TekScope menu.
The application automatically detects for connected switch(es) on GPIB, and
then prompts to search on other networks (LAN, Serial, VXI, USB, and
TekLink)
1
.
NOTE. Autodetect works only for Keithley and Gigatronics switches.
If only one switch is detected, the application launches with the configuration
for the detected switch.
1
Searching on LAN and other networks (LAN, Serial, VXI, USB, and TekLink) might take few minutes.
Switch Matrix application help 7
Operating basics
2. If multiple switches are detected, the Select Relevant Switch window
displays where you can select the appropriate switch.
3. If no switch is detected, the Select Configuration window displays; Select the
configuration from the drop-down list and click Launch.
8 Switch Matrix application help
Operating basics
Application overview
This section describes the Switch Matrix application settings.
Table 3: Switch Matrix configuration settings
Item Description
Options
Switch Matrix configuration
Click to expand/collapse the switch matrix configuration.
Click Help to view the software help document and About Switch
Matrix for software version.
Switch Matrix application help 9
Operating basics
Item Description
Configuration
Vendor
Select the configuration option:
■
Keithley S46T: 6-input-to-1-output switch configuration
■
Gigatronics ASCOR 8000: 8-input-to-1-output switch
configuration
■
Auto Detect: Select to autodetect the switch.
■
New Configuration: Select to manually configure the switch.
■
Saved file names: Saved configuration file name(s) are
displayed in the drop-down list. Select to recall the
configuration.
■
Show All Files: Select to view the list of all saved files.
Select the vendor from the drop-down list. This field is displayed:
■
When you select Configuration > New Configuration to
create afresh configuration.
Link Width
Add <X> more lane(s)
■
When you open a saved configuration. The displayed vendor
name is not editable.
■
When Auto Detect is selected. The displayed vendor name is
not editable.
Select the Link Width from the drop-down list. This determines the
maximum number of lanes supported by the DUT.
Select to add extra lanes (Additional1, Additional2,....) to the lanes
list. The extra lanes added are displayed in the relay signals.
You can add a maximum of 10 lanes.
10 Switch Matrix application help
Operating basics
Item Description
Click to rename the lanes. Enter the LanePrefix and select the
Rename Lanes
increment label type to suffix by either number or alphabet. The
number of lanes depends on the Link Width selected. Clear the Auto
rename lane check box to set unique names for the lanes.
De-embed
De-embed
Debug Mode
Select the De-embed option:
2
■
None
■
All relays (Recommended)
■
Each relay type separately (SP4T, SP6T, etc.)
■
Each relay separately
■
Each connection
Select the de-embed option and click Select Filter File to browse
and select the filter file(s).
2
Configure at least one relay before configuring the de-embed settings.
Switch Matrix application help 11
Operating basics
Item Description
Select Debug Mode to manually configure the switch.
Debug Mode
Switch Address
Enter the Switch Address in the GPIB or TCPIP format.
GPIB format: GPIB0:X:INSTR
TCPIP format: TCPIP::IPADDR::INSTR
Init Switch
This will synchronize the configuration of relay(s) in the application
with the relay(s) in the switch. Synchronization will be successful
only for the relays whose configuration matches with the physical
switch. Pass/Fail status is displayed next to the button.
NOTE. Relay configurations (number of relays, number of relay
inputs, and name of relays) in the application should match the
physical switch, for successful synchronization.
Relays
Switch Self-Test
This will close and open all switch channels one-by-one and
displays the pass/fail status of the channel next to the ID. A self-test
report (CSV) is generated at the end of the process. You cannot
abort this process.
NOTE. Initialize the switch before performing the self-test.
Reset Switch
Click Reset Switch to reset the switch. This will open all channels.
Scope Address
Enter the oscilloscope address in the GPIB or TCPIP format.
GPIB format: GPIB0:X:INSTR
TCPIP format: TCPIP::IPADDR::INSTR
Init Scope
Enter the oscilloscope address in the Scope Address field and click
Init Scope to initialize the oscilloscope. This will establish the
connection with the oscilloscope. The pass/fail status is displayed
next to the button.
Apply De-embed settings
Select to apply de-embed settings to the channels.
When the oscilloscope is initialized and de-embed settings are
configured, closing a connection will apply the de-embed settings
and then close the connection.
12 Switch Matrix application help