Tektronix RSA3408A Programmer Manual
Programmer Manual
RSA3408A
8 GHz Real-Time Spectrum Analyzer
077-0003-04
This document applies to firmware version 3.31
and above.
www.tektronix.com
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 internati onal treaty provisions.
Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supercedes
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.
14200 SW Karl Braun Drive
P.O. Box 500
Beaverton, OR 97077
USA
For product information, sales, service, and technical support:
H In North America, call 1-800-833-9200.
H Worldwide, visit www.tektronix.com to find contacts in your area.
Table of Contents
Getting Started
Syntax and Commands
Preface xi...................................................
Related Manual xi..................................................
Overview of the Manual 1--2...........................................
Connecting the Interface 1--4..........................................
Using the GPIB Port 1--5..............................................
Setting the GPIB Parameters from the Front Panel 1--6......................
Using TekVISA 1--8..................................................
Command Syntax 2--1.........................................
Backus-Naur Form Definition 2--1......................................
SCPI Commands and Queries 2--2......................................
IEEE 488.2 Common Commands 2--10...................................
Constructed Mnemonics 2--11...........................................
Command Groups 2--13.........................................
Measurement Mode 2-- 13..............................................
Functional Groups 2--15...............................................
IEEE Common Commands 2--16........................................
:ABORt Commands 2--16..............................................
:CALCulate Commands 2--17...........................................
:CALibration Commands 2--18..........................................
:CONFigure Commands 2--18...........................................
:CONFigure Commands (Option) 2--19...................................
:DISPlay Commands 2--21.............................................
:DISPlay Commands (Option) 2--25......................................
:FETCh Commands 2--43..............................................
:FETCh Commands (Option) 2--44.......................................
:FORMat Commands 2--48.............................................
:HCOPy Commands 2--48..............................................
:INITiate Commands 2--49.............................................
:INPut Commands 2--49...............................................
:INSTrument Commands 2--49..........................................
:MMEMory Commands 2--50...........................................
:OUTPut Commands 2--51.............................................
:PROGram Commands 2--51............................................
:READ Commands 2--51...............................................
:READ Commands (Option) 2--52.......................................
:SENSe Commands 2--55..............................................
:SENSe Commands (Option) 2--59.......................................
:STATus Commands 2--76..............................................
:SYSTem Commands 2-- 76.............................................
:TRACe Commands 2--77..............................................
:TRIGger Commands 2--77.............................................
:UNIT Commands 2--78...............................................
RSA3408A Programmer Manual
i
Table of Contents
IEEE Common Commands 2--79.................................
:ABORt Commands 2--89........................................
:CALCulate Commands 2--91....................................
:CALibration Commands 2--107...................................
:CONFigure Commands 2--119....................................
:CONFigure Commands (Option) 2--131............................
:DISPlay Commands 2--183.......................................
:DISPlay Commands (Option) 2--249...............................
:FETCh Commands 2--659.......................................
:FETCh Commands (Option) 2--687................................
:FORMat Commands 2--865......................................
:HCOPy Commands 2--867.......................................
:INITiate Commands 2--871.......................................
:INPut Commands 2--875.........................................
:INSTrument Commands 2--881...................................
:MMEMory Commands 2--885....................................
:OUTPut Commands 2--909.......................................
:PROGram Commands 2--911.....................................
:READ Commands 2--917........................................
:READ Commands (Option) 2--945................................
:SENSe Commands 2--1035........................................
:SENSe Commands (Option) 2--1119................................
:STATus Commands 2--1519.......................................
:SYSTem Commands 2--1527.......................................
:TRACe Commands 2--1537.......................................
:TRIGger Commands 2--1543......................................
:UNIT Commands 2--1555.........................................
Retrieving Response Message 2--1557................................
Status and Events
ii
Status and Event Reporting System 3--1..................................
Registers 3--5.......................................................
Status Registers 3--5..................................................
Enable Registers 3--9.................................................
Transition Registers 3--11..............................................
Queues 3--12........................................................
Status and Event Processing Sequence 3--13...............................
Synchronizing Execution 3--14..........................................
RSA3408A Programmer Manual
Programming Examples
Appendices
Table of Contents
Error Messages and Codes 3--17..................................
Command Errors 3--18.................................................
Execution Errors 3--20.................................................
Device Specific Errors 3--22............................................
Query Errors 3--22....................................................
General Programming Procedure 4--2....................................
Application Program Sample 4--3.......................................
Macro Program Execution Sample 4--15..................................
Appendix A: Character Charts A--1..............................
Appendix B: GPIB Interface Specification B--1.....................
Interface Functions B--1...............................................
Interface Messages B--3...............................................
Appendix C: Factory Initialization S ettings C--1....................
Appendix D: Setting Range D--1.................................
Scale Setting Range D-- 1..............................................
RBW D--8..........................................................
Appendix E: SCPI Conformance Information E--1..................
Glossary and Index
RSA3408A Programmer Manual
iii
Table of Contents
List of Figures
Figure 1-- 1: Command parts 1 --2.................................
Figure 1--2: Functional groupings and an alphabetical list of
commands 1--2............................................
Figure 1--3: Event-driven program 1--3...........................
Figure 1--4: Sample program (Visual C++ source code) 1--3..........
Figure 1--5: GPIB connector (rear panel) 1--4......................
Figure 1--6: GPIB connection 1--5................................
Figure 1--7: Typical GPIB network configurations 1--5..............
Figure 1--8: Remote Setup menu 1--6.............................
Figure 1--9: Setting the GPIB parameters 1--7......................
Figure 2--1: Example of SCPI subsystem hierarchy tree 2--2..........
Figure 2--2: Example of abbreviating a command 2--6...............
Figure 2--3: Example of chaining commands and queries 2--7.........
Figure 2--4: Example of omitting root and lower-level nodes in a
chained message 2--7.......................................
Figure 2--5: View number assignments 2--91........................
Figure 2--6: Horizontal scale setting requirements 2--184...............
Figure 2--7: Horizontal scale setting requirements for spectrum
view 2--185..................................................
Figure 2--8: :DISPlay:CCDF command setting 2--186..................
Figure 2--9: :DISPlay:OVIew command setting 2--193.................
Figure 2--10: :DISPlay:PULSe:SPECtrum command setting 2--215......
Figure 2--11: :DISPlay:SPECtrum command setting 2--224.............
Figure 2--12: :DISPlay:TFRequency command setting 2--234...........
Figure 2--13: View display formats 2--244............................
Figure 2--14: :DISPlay:WAVeform command setting 2--245.............
Figure 2--15: :DISPlay:DDEMod command setting 2--253..............
Figure 2--16: :DISPlay:AC3Gpp command setting 2--340..............
Figure 2--17: :DISPlay:UL3Gpp command setting 2--345..............
Figure 2--18: Setting up the ACPR measurement 2--1038................
Figure 2--19: Defining the analysis range 2--1041......................
Figure 2--20: Setting up the channel power measurement 2--1057.........
Figure 2--21: Setting up the C/N measurement 2--1060..................
Figure 2--22: Setting up the EBW measurement 2--1070................
Figure 2--23: Setting frequency and span 2--1072......................
iv
RSA3408A Programmer Manual
Table of Contents
Figure 2--24: Setting up the OBW measurement 2--1081................
Figure 2--25: Setting up the spurious signal measurement 2--1112........
Figure 2--26: Defining the analysis range 2--1115......................
Figure 2--27: Defining the analysis range 2--1123......................
Figure 2--28: Trigger mask setting example 2--1546....................
Figure 2--29: Retrieving response message 2--1557.....................
Figure 3--1: Status/Event reporting mechanism 3--2.................
Figure 3--2: The Status Byte Register (SBR) 3--6....................
Figure 3--3: The Standard Event Status Register (SESR) 3--7.........
Figure 3--4: The Operation Condition Register (OCR) 3--8...........
Figure 3--5: The Event Status Enable Register (ESER) 3-- 9...........
Figure 3--6: The Service Request Enable Register (SRER) 3--10........
Figure 3--7: Operation Enable Register (OENR) 3--10................
Figure 3--8: Operation Transition Register (OTR) 3--11...............
Figure 3-- 9: Status and event processing sequence 3--13...............
Figure 4--1: Saving the macro programs 4--15.......................
RSA3408A Programmer Manual
v
Table of Contents
List of Tables
Table 2--1: BNF symbols and meanings 2--1.......................
Table 2--2: Query response examples 2--3.........................
Table 2--3: Parameter types used in syntax descriptions 2--4.........
Table 2--4: Available units 2--8..................................
Table 2--5: Available SI prefixes 2--8.............................
Table 2--6: Constructed mnemonics 2--11..........................
Table 2--7: Measurement mode 2--13..............................
Tab le 2--8: List of command groups 2--15..........................
Table 2--9: IEEE common commands 2--16.........................
Table 2--10: :ABORt commands 2--16.............................
Table 2--11: :CALCulate commands 2--17..........................
Table 2--12: :CALibration commands 2--18........................
Table 2--13: :CONFigure commands 2--18..........................
Table 2--14: :CONFigure commands (Option) 2--19..................
Table 2--15: :DISPlay commands 2--21............................
Table 2--16: :DISPlay commands (Option) 2--25.....................
Table 2--17: :FETCh commands 2--43.............................
Table 2--18: :FETCh commands (Option) 2--44.....................
Table 2--19: :FORMat commands 2--48............................
Table 2--20: :HCOPy commands 2--48.............................
Table 2--21: :INITiate commands 2--49............................
Table 2--22: :INPut commands 2--49..............................
Table 2--23: :INSTrument commands 2--49.........................
Table 2--24: :MMEMory commands 2--50..........................
Table 2--25: :PROGram commands 2--51..........................
Table 2--26: :PROGram commands 2--51..........................
Table 2--27: :READ commands 2--51..............................
Table 2--28: :READ commands (Option) 2--52......................
Table 2--29: :SENSe commands 2-- 55..............................
Table 2--30: :SENSe commands (Option) 2--59......................
Table 2--31: :STATus commands 2--76.............................
Table 2--32: :SYSTem commands 2--76............................
Table 2--33: :TRACe commands 2--77.............................
Table 2--34: :TRIGger commands 2--77............................
Table 2--35: :UNIT commands 2--78...............................
vi
RSA3408A Programmer Manual
Table of Contents
Table 2--36: :CONFigure command subgroups (Option) 2--131.........
Table 2--37: :DISPlay command subgroups 2--183....................
Table 2--38: Subview display format 2--211..........................
Table 2--39: :DISPlay command subgroups (Option) 2--249............
Tabl e 2--40: Main view display formats 2--256.......................
Table 2--41: Subview display formats 2--270.........................
Table 2--42: Subview display formats 2--292.........................
Table 2--43: Subview display formats in the signal source analysis 2--318.
Table 2--44: Symbol rate settings 2--347.............................
Tabl e 2--45: Main view display formats 2--350.......................
Table 2--46: Subview display formats 2--358.........................
Tabl e 2--47: Main view display formats 2--367.......................
Table 2--48: Subview display formats 2--374.........................
Table 2--49: Display format of the main view 2--399...................
Table 2--50: Display format in the subview 2--405....................
Table 2--51: Display format of the main view 2--426...................
Table 2--52: Display format in the subview 2--432....................
Table 2--53: Symbol rate settings 2--449.............................
Table 2--54: 3GPP-R5 downlink modulation analysis display
formats 2--453...............................................
Table 2--55: Symbol rate settings 2--469.............................
Table 2--56: 3GPP-R5 uplink modulation analysis display formats 2--473
Table 2--57: Subview display formats, MIMO 2--524..................
Table 2--58: Subview display formats, nx1 2--561.....................
Table 2--59: Subview display formats 2--599.........................
Table 2--60: Symbol rate settings 2--619.............................
Table 2--61: 3GPP-R6 downlink modulation analysis display
formats 2--623...............................................
Table 2--62: Symbol rate settings 2--642.............................
Table 2--63: 3GPP-R6 uplink modulation analysis display formats 2--646
Table 2--64: Queried information 2--670............................
Table 2--65: :FETCh command subgroups (Option) 2--687.............
Table 2--66: Queried information on the digital modulation analysis
results 2--689................................................
Table 2--67: RFID measurement selections 2--695.....................
Table 2--68: Symbol value definition 2--698..........................
Table 2--69: Signal source analysis 2--705...........................
Table 2--70: Queried information on the W-CDMA uplink analysis
results 2--715................................................
RSA3408A Programmer Manual
vii
Table of Contents
Table 2--71: The n value for CDPower 2--756........................
Table 2--72: The n value for IQPower 2--756.........................
Table 2--73: The n value for MACCuracy 2--763.....................
Tab le 2--74: The n value for STABle 2--764..........................
Table 2--75: Queried information on the 3GPP-R5 downlink analysis
results 2--777................................................
Table 2--76: Queried information on the 3GPP-R5 uplink analysis
results 2--798................................................
Table 2--77: Queried information 2--827............................
Table 2--78: Queried information 2--834............................
Table 2--79: Queried information 2--842............................
Table 2--80: Queried information on the 3GPP-R6 downlink analysis
results 2--851................................................
Table 2--81: Queried information on the 3GPP-R6 uplink analysis
results 2--857................................................
Table 2--82: Refer e nce level range 2--879............................
Table 2--83: Measurement mode 2--882.............................
Table 2--84: Item to save (Option 40) 2--901.........................
Table 2--85: Content to save (Option 40) 2--902......................
Table 2--86: File header contents -- Option 21, 23, 27, 28, and 40 2--905..
Table 2--87: File header contents -- Option 25, 26, and 29 2--906........
Table 2--88: :READ command subgroups (Option) 2--945.............
Table 2--89: Queried information on the digital modulation analysis
results 2--948................................................
Table 2--90: Signal source analysis 2--959...........................
Table 2--91: :SENSe command subgroups 2--1035.....................
Table 2--92: Measurement item selections 2--1046.....................
Table 2--93: Block size setting range 2-- 1051..........................
Table 2--94: Measurement frequency bands 2--1073....................
Table 2--95: Span setting 2--1078...................................
Table 2--96: FFT windows 2--1105..................................
Table 2--97: S/A mode measurement items 2--1107.....................
Table 2--98: :SENSe command subgroups (Option) 2--1119.............
Table 2--99: Modulation selections 2--1130...........................
Table 2--100: Communication standard selections 2--1139..............
Table 2--101: RFID measurement items 2--1151.......................
Table 2--102: Decoding format 2--1157...............................
Table 2--103: Modulation format 2--1158.............................
Table 2--104: RFID demodulation standard 2--1162....................
viii
RSA3408A Programmer Manual
Table of Contents
Table 2--105: Analysis length setting range 2--1182....................
Table 2--106: SSOurce measurement items 2--1183....................
Tabl e 2--107: GSM/EDGE measurement i tems 2--1214.................
Table 2--108: Measurement item selections 2--1224....................
Table 2--109: Code range 2--1238...................................
Table 2--110: Walsh code length selections 2--1240.....................
Table 2--111: Code range 2--1258...................................
Table 2--112: Walsh code length selections 2--1260.....................
Table 2--113: Code range 2--1268...................................
Table 2--114: Walsh code length selections 2--1270.....................
Table 2--115: Measurement item selections 2--1289.....................
Table 2--116: Code range 2--1304...................................
Table 2--117: Code range 2--1325...................................
Table 2--118: Code range 2--1336...................................
Table 2--119: Measurements, 802.11n MIMO 2--1462..................
Table 2--120: Measurements, 802.11n (nx1) 2--1473....................
Table 2--121: Modulation type selections 2--1482......................
Table 2--122: Measurement selections 2--1485.........................
Table 2--123: Configuration in 3GPP-R6 2--1507......................
Table 2--124: DPCCH format 2--1508................................
Table 2--125: Bin number setting range 2--1545.......................
Table 3--1: SBR bit functions 3--6................................
Table 3--2: SESR bit functions 3--7...............................
Table 3--3: OCR bit functions 3--8...............................
Table 3--4: Command errors 3--18................................
Table 3--5: Execution errors 3--20.................................
Table 3--6: Device specific errors 3--22.............................
Table 3--7: Query errors 3--22....................................
Table A--1: ASCII & GPIB code chart A--2.........................
Table B--1: GPIB interface function implementation B--1............
Table B--2: Standard interface messages B--3......................
Table C--1: IEEE common commands C--1........................
Table C--2: :CALibration commands C--1.........................
Table C--3: :DISPlay commands C--1.............................
Table C--4: :DISPlay commands (Option) C--3.....................
RSA3408A Programmer Manual
ix
Table of Contents
Table C--5: :FORMat commands C--7............................
Table C--6: :INITiate commands C--8.............................
Table C--7: :INPut commands C-- 8...............................
Table C--8: :SENSe commands C--8..............................
Table C--9: :SENSe commands (Option) C-- 11......................
Table C--10: :STATus commands C--28............................
Table C--1 1: :TRACe commands C--28.............................
Table C--12: :TRIGger commands C--28...........................
Table C--13: :UNIT commands C--29..............................
Table D--1: Display format and scale D--1.........................
Tabl e D--2: Display format and scale: Digital modulation analysis
(Option 21) D--1...........................................
Table D--3: Display format and scale: RFID Measurements
(Option 21) D--2...........................................
Table D--4: Display format and scale: Signal source analysis
(Option 21) D--3...........................................
Table D--5: W-CDMA (Option 23), 3GPP-R5 (Option 27), and
3GPP-R6 (Option 40) analyses D--4...........................
Table D--6: Display format and scale, cdma2000 analysis
(Option 25) D--4...........................................
Table D--7: Display format and scale, 1xEV-DO analysis
(Option 26) D--5...........................................
Table D--8: Display format and scale, TD-SCDMA analysis
(Option 28) D--6...........................................
Table D--9: Display format and scale, WLAN analysis (Op tion 29) D--7
Table D--10: RBW setting range D--8.............................
Table E--1: SCPI 1999.0-defined commands E--1...................
x
RSA3408A Programmer Manual
Preface
This programmer manual is for the RSA3408A 8 GHz Real-Time S pectrum
Analyzer. It provides information on operating your analyzer using the General
Purpose Interface Bus (GPIB).
This manual is composed of the following sections:
H Getting Started outlines how to use the GPIB interface.
H Syntax and Commands defines the syntax used in command descriptions,
presents a list of all command subsystems, and presents detailed descriptions
of all programming commands.
H Status and Events describes how the status and Events Reporting system
operates and presents a list of all system errors.
H Programming Examples describes some example analyzer programs.
H Appendices provides additional information including character charts, GPIB
interface specification, and factory initialization settings.
Related Manual
RSA3408A User Manual
(Standard accessory, Tektronix part number 071-1617-XX)
Describes how to install the analyzer and how to work with the menus and
details the functions.
RSA3408A Programmer Manual
xi
Preface
xii
RSA3408A Programmer Manual
Getting Started
Getting Started
You can write computer programs that remotely set the analyzer front panel
controls or that take measurements and read those measurements for further
analysis or storage.
To help you get started with programming the analyzer, this section includes the
following sections:
H Overview of the Manual
Summarizes the t ype of programming information contained in each major
section of this manual.
H Connecting the Interface
Describes how to physically connect the analyzer to a controller.
H Using GPIB Ports
Describes how to use the GPIB port.
H Setting the GPIB Parameters from the Front Panel
Describes how to set the GPIB parameters from the front panel.
H Using TekVISA
Describes how to use the TekVISA communication protocol.
RSA3408A Programmer Manual
1- 1
Getting Started
Overview of the Manual
The information contained in each major section of this manual is described
below.
Syntax and Commands
:CALCulate Commands
:TRIGger
:ABORt Commands
IEEE Common Commands
*CAL?
*CLS
*ESE
*ESR
*IDN?
*OPC
Section 2, Syntax and Commands, describes the structure and content of the
messages your program sends to the analyzer. Figure 1--1 shows command parts
as described in the Command Syntax subsection.
Command parts
Header
Comma
:MMEMory:COPY FILE1,FILE2
Mnemonics
Figure 1- 1: Command parts
Section 2 also describes the effect of each command and provides examples of
how you might use it. The Command Groups section provides lists by functional
areas. The IEEE Common Commands and the subsequent sections arrange
commands alphabetically (Figure 1--2).
ArgumentsSpace
:CALCulate:MARKer:X
:CALCulate:MARKer:AOFF
S
A
E
:CALCulate:DLINe
S
A
Syntax:...
Arguments:
E
Examples:...
Commands grouped in functional areas Commands listed alphabetically
Figure 1- 2: Functional groupings and an alphabetical list of commands
1- 2
RSA3408A Programmer Manual
Getting Started
Status and Events
The program may request information from the analyzer. The analyzer provides
information in the form of status and error messages. Figure 1--3 illustrates the
basic operation of this system.
Section 3, Status and Events, describes how to get status or event information
from the program and details the event and error messages.
Your program requests
status and event reports.
Controller
The analyzer sends status and event reports.
RSA3408A
GPIB cable
Figure 1- 3: Event-driven program
Programming Examples
Section 4, Programming Examples, includes Visual C++ source code as well as
sample programs for running macro programs.
GpibWrite("INSTrument 'SANORMAL'");
GpibWrite("*RST");
GpibTimeOut(NORMAL_TIME);
GpibWrite("CONFigure:SPECtrum:CHPower");
GpibWrite("FREQuency:BAND RF1B");
GpibWrite("FREQuency:CENTer 1GHz");
GpibWrite("FREQuency:SPAN 1MHz");
GpibWrite("*CAL?");
GpibRead(readBuf, MAX_BUF);
printf("*CAL? result = %s\n", readBuf);
GpibWrite("CHPower:BANDwidth:INTegration 300kHz");
GpibWrite("SPECtrum:AVERage ON");
Figure 1- 4: Sample program (Visual C++ source code)
RSA3408A Programmer Manual
1- 3
Getting Started
Connecting the Interface
The analyzer has a 24-pin GPIB connector on its rear panel, as shown in
Figure 1--5. This connector has a D-type shell and conforms to IEEE Std
488.1--1987.
Attach an IEEE Std 488.1-1987 GPIB cable (Tektronix part number
012-0991-00) to this connector.
GPIB connector
1- 4
Figure 1- 5: GPIB connector (rear panel)
Appendix B: GPIB Interface Specifications gives more information on the GPIB
configuration of the analyzer.
For the other interfaces, refer to the RSA3408A User Manual.
RSA3408A Programmer Manual
Using the GPIB Port
Getting Started
The analyzer has Talker/Listener functions through which it can communicate
with other devices, as well as the external controller, located on the bus.
GPIB
Controller Using the analyzer as a talker or listener
Figure 1- 6: GPIB connection
GPIB Requirements
Observe these rules when you use your analyzer with a GPIB network:
H Assign a unique device address to each device on the bus. No two devices
can share the same device address.
H Do not connect more than 15 devices to any one bus.
H Connect one device for every 2 meters (6 feet) of cable used.
H Do not use m ore than 20 meters (65 feet) of cable to connect devices to a
bus.
H Turn on at least two-thirds of the devices on the network while using the
network.
H Connect the devices on the network in a star or linear configuration as shown
in Figure 1--7. Do not use loop or parallel configurations.
GPIB Device
GPIB Device
GPIB Device
GPIB Device
GPIB Device
RSA3408A Programmer Manual
GPIB Device
Figure 1- 7: Typical GPIB network configurations
GPIB Device
1- 5
Getting Started
Setting the GPIB Parameters from the Front Panel
Use the SYSTEM → Remote Setup menu to set the GPIB parameters as
required for the bus configuration. Once you have set the parameters, you can
control the analyzer through the GPIB interface.
Display Brightness
Reset All to Factory Defaults
Remote Setup...
Version and Installed Options...
Instrument Setup...
Remote Interface
GPIB Setup...
Ethernet Setup...
Off/On
GPIB Address
Connection Mode...
GPIB Port
Tek VISA
Figure 1- 8: Remote Setup menu
Remote Setup Menu
The Remote Setup menu contains the following controls:
Remote Interface. Turns on or off the connection between the analyzer and the
interface bus.
GPIB Setup... Sets the GPIB address and connection mode.
GPIB Address. Sets the GPIB address of the analyzer when GPIB Port is
selected as the Connection Mode. Range: 0 to 30 (default: 1)
Connection Mode. Selects the physical GPIB port or the virtual (TekVISA)
connection method.
H GPIB Port. Default. Uses the IEEE488.2 connector on the rear panel of the
analyzer to communicate with an external controller.
Refer to the next section Setting up the GPIB port for the procedure.
H TekV I SA. Uses TekVISA to communicate with test instrumentation through
Ethernet (LAN connector on the side panel of the analyzer), and also to run a
control program locally on the analyzer.
Refer to Using TekVISA on page 1--8 for more information.
1- 6
RSA3408A Programmer Manual
Getting Started
Ethernet Setup... Not available currently. Use the Windows XP Control Panel to
set up networking parameters.
Setting Up the GPIB Port
When you use the GPIB port, follow these steps to set the parameters:
1. Press the SYSTEM key in the UTILITY block on the front panel.
2. Press the side key Remote Setup...→ GPIB Setup...
Remote Setup menu
Remote Interface
Selects whether the connection
between the analyzer and GPIB
is turned on or off.
GPIB Setup...
Sets the GPIB parameters (GPIB
address and connection mode).
Figure 1- 9: Setting the GPIB parameters
3. Press the Connection Mode... side key and select GPIB Port.
4. Press the GPIB Address side key and set the address using either the
general purpose knob or the numeric keypad.
RSA3408A Programmer Manual
NOTE. The GPIB address cannot be initialized with *RST command.
5. Press the Cancel--Back (top) side key and then the Remote Interface
side key to select On.
To disconnect the analyzer from the bus:
H Press the Remote Interface side key to select Off.
When the analyzer is disconnected from the bus, all the communication
processes with the controller are interrupted.
1- 7
Getting Started
Using TekVISA
TekVISA is Tektronix implementation of VISA (Virtual Instrument Software
Architecture), an industry-standard communication protocol. It allows you to
write programs using the RSA3400A Series SCPI command set to control the
instrument through interfaces besides the built-in IEEE 488.2 port. Programs are
written to execute on the local or remote controller. The RSA3400A Series
implementation of TekVISA includes a subset of the TekVISA functionality
offered on Tektronix oscilloscopes. The Virtual GPIB (GPIB8), GPIB, and LAN
(VXI-11 protocol) interfaces are supported, but not the ASRL interface.
NOTE. The details on TekVISA concepts and operations are explained in the
TekVISA Programmer Manual. Refer to Installing TekVISA described below for
accessing the files.
Be aware of the following points:
H If TekVISA is not installed or has not been activated, and you select
TekVISA as the connection mode, the instrument still attempts to connect to
TekVISA. This does not hang up the instrument, but the GPIB port i s taken
off-line until you select GPIB Port as the connection mode again.
Installing TekVISA
H Applications which are designed to execute locally on the instrument need to
share the Wi ndows processor with the measurement calculation software of
the analyzer. If the controller application is very compute-intensive, it will
slow down the analyzer application significantly.
The TekVISA tools are not installed when you receive the instrument.
Use the following procedure to install the tools.
To use TekVISA, these conditions must be satisfied:
H Windows XP is used as the instrument’s operating system.
Instruments using Windows 98SE must be upgraded to Windows XP for
TekVISA to operate properly.
H A TekVISA-compatible version of the analyzer application is installed and
running on the instrument. Version must be greater than 3.00.000.
H TekVISA is installed on the instrument. Version 2.03 is recommended.
1- 8
RSA3408A Programmer Manual
Getting Started
The TekVISA-related files are on the internal hard disk of the analyzer
in these directories:
H C:\Tektronix\T ekVISA\installer contains the TekVISA installer.
H C:\Tektronix\TekVISA\manual contains the TekVISA Programmer Manual.
Use the following steps to install the TekVISA tools on your analyzer:
NOTE. For details on accessing Window s XP on the analyzer, refer to the
RSA3408A User Manual.
1. Connect a USB mouse and keyboard to the USB ports on the side panel of
the analyzer.
2. Display the Windows XP desktop on the screen.
3. Find the setup.exe file in the C:\T ektronix\TekVISA\installer directory
using Windows Explorer or other file access methods.
4. Run setup.exe and follow the instructions.
The TekVISA Programmer Manual is found in the C:\Tektronix\TekVISA\manual
directory.
RSA3408A Programmer Manual
1- 9
Getting Started
1- 10
RSA3408A Programmer Manual
Syntax and Commands
Command Syntax
This section contains information on the S t andard Commands for Programmable
Instruments (SCPI) and IEEE 488.2 Common Commands you can use to
program your RSA3408A analyzer. The information is organized in the
following subsections:
H Backus-Naur Form Definition
H SCPI C ommands and Queries
H IEEE 488.2 Common Commands
H Constructed Mnemonics
Backus-Naur Form Definition
This manual may describe commands and queries using the Backus-Naur Form
(BNF) notation. Table 2--1 defines the standard BNF symbols:
Table 2- 1: BNF symbols and meanings
Symbol Meaning
<> Defined element
::= Is defined as
| Exclusive OR
{} Group; one element is required
[] Optional; can be omitted
... Previous element(s) may be repeated
() Comment
RSA3408A Programmer Manual
2- 1
Command Syntax
SCPI Commands and Queries
SCPI is a standard created by a consortium that provides guidelines for remote
programming of instruments. These guidelines provide a consistent programming environment for instrument control and data transfer. This environment
uses defined programming messages, instrument responses, and data format
across all SCPI instruments, regardless of manufacturer. The analyzer uses a
command language based on the SCPI standard.
The SCPI language is based on a hierarchical or tree structure (see Figure 2--1)
that represents a subsystem. The top level of the tree is the root node; it is
followed by one or more lower-level nodes.
TRIGger
SEQuence
POLarity
SOURceLEVel
Root node
Lower-level nodes
Figure 2- 1: Example of SCPI subsystem hierarchy tree
You can create commands and queries from these subsystem hierarchy trees.
Commands specify actions for the instrument to perform. Queries return
measurement data and information about parameter settings.
2- 2
RSA3408A Programmer Manual