Tektronix TTR500 series Operating and maintenance manual

xx
TTR500 Series
Vector Network Analyzer
ZZZ
Programmer Manual
*P077125701*
077-1257-01

TTR500 Series
Vector Network Analyzer
ZZZ
Programmer Manual
xx
www.tek.com
077-1257-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.
VectorVu-PC is a trademark 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
Preface.............................................................................................................. iii
Related Documentation ...................................................................................... iii
Get Started
Get Started......................................................................................................... 1-1
Overview of the Manual ......................................................................................... 1-2
Install TekVISA................................................................................................... 1-3
Setup for the programming interface ...................................................................... 1-3
Enable control over the Ethernet........................................................................... 1-4
Connect with NI-VISA and LabVIEW......................................................................... 1-5
Connect NI-VISA to VectorVu-PC without TekVISA................................................... 1-5
Connect NI-VISA to Tek-VISA LAN Server Control................................................... 1-7
Syntax and Commands
Command Syntax................................................................................................. 2-1
Backus-Naur Form Definition . ... .. .. ... .. .. ... .. .. ... .. .. ... .. .. ... ....................................... 2-1
SCPI Commands and Queries.............................................................................. 2-1
IEEE 488.2 Common commands .......................................................................... 2-6
Constructed mnemonics..................................................................................... 2-7
Command groups................................................................................................. 2-9
Functional groups............................................................................................ 2-9
IEEE common commands ................................................................................ 2-10
Abort commands................................................................................................ 2-11
Calculate commands ........................................................................................... 2-12
Marker Mnemonics........................................................................................ 2-20
Display commands ............................................................................................. 2-21
Initiate commands .............................................................................................. 2-24
Mass Memory Commands..................................................................................... 2-25
Specifying the File......................................................................................... 2-29
DRAFT – 01/24/2019
TTR500 Series Programmer Manual i

Table of Contents
Output Commands.............................................................................................. 2-30
Sense commands................................................................................................ 2-31
Service commands.............................................................................................. 2-39
Simulator commands........................................................................................... 2-40
Source commands .............................................................................................. 2-41
Status commands ............................................................................................... 2-43
System commands.............................................................................................. 2-50
Trigger commands.............................................................................................. 2-52
Retrieving Response Message................................................................................. 2-53
Command Descriptions........................................................................................ 2-55
Status and Events
Status and Events................................................................................................. 3-1
Status and Event Reporting System ....................................................................... 3-1
Status Byte.................................................................................................... 3-3
Standard Event Status Block ............................................................................... 3-4
Operation Status Block...................................................................................... 3-6
Queues ........................................................................................................ 3-6
Status and Event Processing Sequence.................................................................... 3-7
Synchronizing Execution ................................................................................... 3-9
Error messages.................................................................................................. 3-11
IEEE error messages ...................................................................................... 3-11
VNA error messages ...................................................................................... 3-12
Warnings and notifications................................................................................ 3-15
DRAFT – 01/24/2019
ii TTR500 Series Programmer Manual

Preface
When you open VectorVu-PC after connecting a TTR500 series Vector Network
Analyzer (VNA) to your Windows machine, the software supports commands that
control the functions of the VNA. This programmer manual contains information
on operating the TTR500 VNA using VectorVu-PC vector analysis software. The
manual applies to software version 1.2.4 and contains these sections:
Get Started – How to send commands to the VNA.
Syntax and Commands – Syntax definitions in the command descriptions
and lists of all command subsystems.
Commands Descriptions – Descriptions of all commands with examples.
Status and Events – Operations of the Status and Events Reporting system,
and a list of all system errors.
Related Documentation
TTR500 Series Vector Network Analyzer Quick Start Guide
(Tektronix part number 071-3486-00, English)
This manual contains general information about how to put your instrument
into service.
TTR500 Series Vector Network Analyzer Help
This online help manual is configured in VectorVu-PC. It contains detailed
information about how to operate the VNA.
TekVISA Programmer Manual
(Tektronix part number 077-0140-XX)
This manual is available as a printable PDF file on the Tektronix web
site (www.tek.com). The manual describes TekVISA, the Tektronix
implementation of the VISA Application Programming Interface (API).
TekVISA is industry-compliant software for writing interoperable instrument
drivers in a variety of Application Development Environments (ADEs).
DRAFT – 01/24/2019
TTR500 Series Programmer Manual iii

Preface
DRAFT – 01/24/2019
iv TTR500 Series Programmer Manual

Get Started

Get Started
You can write computer programs that take measurements with the analyzer
and read those measurements for further analysis or storage. These subsections
contain information to help you get started with programming the analyzer:
Overview of the Manual
Summarizes each major section of this manual.
Using TekVISA
Describes how to use the TekVISA communication protocol to communicate
with the VNA to a programmatic interface.
DRAFT – 01/24/2019
TTR500 Series Programmer Manual 1-1

Overview of the Manual
Overview of the Manual
The information contained in each major section of this manual is described here.
Syntax and Commands Syntax and Commands describes the structure and content of the messages your
program sends to the analyzer. This figure shows command parts as described in
the Command Syntax subsection:
The subsection Command Groups provides lists of all commands by functional
areas.
Command Descriptions All commands are listed alphabetically in the Command Descriptions section.
This section also describes the effect of each command and provides examples
that use it.
Status and Events The program may request information from the instrument. The instrument
provides information in the form of status and error messages. Status and Events
describes how to get status or event information from the program and details
the event and error messages.
DRAFT – 01/24/2019
1-2 TTR500 Series Programmer Manual

Install TekVISA
Install TekVISA
You must install the Tektronix Virtual Instrument Software Architecture
(TekVISA)onyourPC:
To communicate to VectorVu-PC to a programmatic interface. TekVISA
is the Tektronix implementation of VISA (Virtual Instrument Software
Architecture), an industry-standard communication protocol.
To perform power calibration using the TTR500 VNA
TekVISA is a collection of software and documentation that allows for remote
control of instruments regardless of instrument brand and physical connection.
You can use this software to write (or draw) interoperable instrument drivers in a
variety of Application Development Environments (ADEs). It includes a VISA
driver, VISA libraries, documentation, USB Device Driver, VXI-11 server,and
connection management/debug software.
Setup for the programming interface
The programming interface is automatically enabled as part of the VectorVu-PC
application software installation. However, in order to control VectorVu-PC using
the programmatic interface, you must also install TekVISA:
DRAFT – 01/24/2019
TTR500 Series Programmer Manual 1-3

Install TekVISA
1. Install VectorVu-PC.
2. Once the software has installed, the InstallShield Wizard prompts you to
install TekVisa as well. Proceed with this installation:
3. Install the Tektronix Power Meter applications next.
4. Click Finish to complete the installation.
Enable control over the Ethernet
TekVISA supports communication with VectorVu-PC over an Ethernet LAN
connection. The VXI-11 standard specifies an instrument protocol for TCP/IP
computer networks, supporting writing and reading data to and from instruments.
The VXI-11 server is automatically installed on the target PC as part of the
VectorVu-PC application software installation process. This also creates a
shortcut in the Startup folder.
Rightclickthe“TekVISALANServerControl”trayicontosetproperties,check
status, or start the VXI-11 or socket servers.
For more information about TekVISA concepts and operations, refer to the
TekVISA Programmer Manual available at http://www.tek.com.
DRAFT – 01/24/2019
1-4 TTR500 Series Programmer Manual

Connect with NI-VISA and LabVIEW
Connect with NI-VISA and LabVIEW
LabVIEW users can operate the TTR500 VNA using the NI-VISA instrument
manager from National Instruments. You can connect NI-VISA:
Directly to VectorVu-PC (without TekVISA) to a socket connection. This
option does not discover instrument connections automatically. Also, youcan
only pair one instance of VectorVu-PC with LabVIEW on a machine
Through the TekVISA LAN Server Control using a VX-11 standard.
Connect NI-VISA to VectorVu-PC without TekVISA
1. Open VectorVu-PC. Keep the program open to this procedure.
2. Open NI MAX.
3. Right click on Devices and Interfaces.SelecttheCreate New option:
4. Select CreatenewVISATCP/IPResourceand click Next.
5. In the next window, select Manual Entry of Raw Socket.
6. In the LAN resource details window, enter:
Hostname: localhost or 127.0.0.1
Port number:5026
7. Click Validate. A popup window validates the connection:
DRAFT – 01/24/2019
TTR500 Series Programmer Manual 1-5

Connect with NI-VISA and LabVIEW
8. You can now finish the setup. The TTR500 device connection is displayed
under Network Devices in the left pane.
9. Click on the TTR500 device connection. In the right pane, the Settings tab
displays the connection information you entered. You can create an alias for
this connection for future use:
DRAFT – 01/24/2019
1-6 TTR500 Series Programmer Manual

Connect with NI-VISA and LabVIEW
Connect NI-VISA to Tek-VISA LAN Server Control
1. ClickontheTekVISALANServer Control application. Open Server
Properties.:
2. Under VXI-11 Server,checkStart server on system power up:
3. Restart the machine.
4. Open NI-VISA and VectorVu-PC.
5. Right click Network Devices in NI-VISA and select Create new
VISA/TCP-IP Resource:
DRAFT – 01/24/2019
TTR500 Series Programmer Manual 1-7

Connect with NI-VISA and LabVIEW
6. Select Auto-detect of LAN Instrument and click Next:
NI-VISA should detect VectorVu-PC to enable the LabVIEW interface.
DRAFT – 01/24/2019
1-8 TTR500 Series Programmer Manual

Syntax and Commands