Page 1 Programming Manual VNA Master™ MS20xxC MS2026C Vector Network Analyzer MS2027C Vector Network Analyzer MS2028C Vector Network Analyzer MS2036C Vector Network Analyzer and Spectrum Analyzer MS2037C Vector Network Analyzer and Spectrum Analyzer MS2038C Vector Network Analyzer and Spectrum Analyzer Anritsu Company...
Page 2 Certificate of Authenticity), and the recipient agrees to the terms of this EULA. d. Termination. Without prejudice to any other rights, Anritsu may terminate this EULA if you fail to comply with the terms and conditions of this EULA. In such event, you must destroy all copies of the SOFTWARE PRODUCT.
Page 3: Table Of Contents
Table of Contents Chapter 1—General Information About this Manual ..........1-1 Introduction .
Page 4 Table of Contents (Continued) Chapter 3—VNA Commands Introduction ..........3-1 VNA Commands .
Page 5 Table of Contents (Continued) :CALCulate:LIMit Subsystem ........3-21 Limit Alarm.
Page 6 Table of Contents (Continued) Limit Y Value ..........3-52 :CALCulate:MARKer Subsystem .
Page 7 Table of Contents (Continued) 3-12 :Display Subsystem ......... 3-81 Trace Display.
Page 8 Table of Contents (Continued) 3-22 [:SENSe]:CALibration Subsystem......3-104 Calibration State ........3-104 3-23 [:SENSe]:CORRection Subsystem .
Page 9 Table of Contents (Continued) 3-27 [:SENSe]:FREQuency Subsystem ......3-136 Center Frequency ........3-136 Frequency Span .
Page 10 Table of Contents (Continued) Chapter 4—Vector Voltmeter Commands Introduction ..........4-1 VVM Commands .
Page 11 Table of Contents (Continued) :CALCulate:PMONitor Subsystem ....... 5-5 Offset ........... 5-5 Units .
Page 12 Table of Contents (Continued) :CALCulate Subsystem........6-3 Limit Alarm.
Page 13 Table of Contents (Continued) Delta Marker State........6-23 Marker Counter .
Page 14 Table of Contents (Continued) :MEASure Subsystem........6-41 Measure Adjacent Channel Power Ratio.
Page 15 Table of Contents (Continued) 6-15 [:SENSe] Subsystem ........6-68 ACPR Adjacent Channel Bandwidth .
Page 16 Table of Contents (Continued) Chapter 7—AM/FM/PM Commands Introduction ..........7-1 AM/FM/PM Analyzer Commands .
Page 17 Table of Contents (Continued) Appendix A—Example Introduction ..........A-1 C/C++ .
Page 18 Contents-16 PN: 10580-00306 Rev. E MS20xxC PM...
Page 19: Chapter 1-General Information
Commands”. This manual is intended to be used in conjunction with the VNA Master MS20xxC Vector Network Analyzer User Guide, Anritsu Part Number 10580-00306. Refer to that manual for general information about the MS20xxC, including equipment setup and operating instructions.
Page 20 Remote Programming Setup and Interface General Information Ethernet networking uses a bus or star topology in which all of the interfacing devices are connected to a central cable called the bus, or are connected to a hub. Ethernet uses the CSMA/CD access method to handle simultaneous transmissions over the bus.
Page 21: Connectivity
General Information Remote Programming Setup and Interface Interface between the MS20xxC and other devices on the network is via a category-five (CAT-5) interface cable that is connected to a network. This cable uses 4 twisted pairs of insulated copper wires that are terminated at an RJ45 connector. CAT-5 cabling is capable of supporting frequencies up to 100 MHz and data transfer speeds up to 1 Gbps, which accommodates 1000Base-T, 100Base-T, and 10Base-T networks.
Page 22: Ms20Xxc Lan Connections
Remote Programming Setup and Interface General Information MS20xxC LAN Connections The RJ-45 connector is used to connect the MS20xxC to a local area network (LAN). Integrated into this connector are two LEDs. The amber LED (Light Emitting Diode) indicates the speed of the LAN connection (ON for 10 Mb/s and OFF for 100 Mb/s), and the green LED flashes to show that LAN traffic is present.
Page 23: Usb Interface Connection And Setup
General Information Remote Programming Setup and Interface USB Interface Connection and Setup For proper detection, Master Software Tools must be installed on the PC prior to Note connecting to the MS20xxC using the USB port. Master Software Tools provides the installation tools to install the USB and VISA drivers. The Universal Serial Bus (USB) architecture is a high-performance networking standard that is considered “plug and play”...
Page 24 Remote Programming Setup and Interface General Information 4. Select to allow the Wizard to search for and install the USB software automatically. Figure 1-2. USB Found New Hardware Wizard 5. After the software is installed, close the Wizard by clicking Finish. Figure 1-3.
Page 25: Usb Interface, Type Mini-B
General Information Remote Programming Setup and Interface USB Interface, Type Mini-B The USB 2.0 Mini-B device connector can be used to connect the MS20xxC directly to a PC. The first time that the MS20xxC is connected to a PC, the normal USB device detection is performed by the computer operating system.
Page 26: Sending Scpi Commands
Sending SCPI Commands General Information Sending SCPI Commands SCPI commands can be sent to the MS20xxC though any Virtual Instrument Software Architecture (VISA) controller. VISA is a commonly-used API in the Test and Measurement industry for communicating with instruments from a PC. The physical connection between the PC and the MS20xxC can be Ethernet or USB.
Page 27 3. Select the viRead tab and click the Execute button. If the PC is connected to the MS20xxC, then the command returns the following information from the Buffer: manufacturer name (“Anritsu”), model number/options, serial number, and firmware package number. Figure 1-6.
Page 28 Sending SCPI Commands General Information 1-10 PN: 10580-00306 Rev. E MS20xxC PM...
Page 29: Chapter 2-Programming With Scpi
Greek letter mu (µ). Some commands, for example, return the units of time in Caution microseconds (µs). In this Anritsu programming manual, the Greek letter mu is represented by the English letter “u” to avoid typographic problems during publication.
Page 30: Scpi Common Commands
Title: Identification Query Description: This command returns the following information in <string> format separated by commas: manufacturer name (“Anritsu”), model number/options, serial number, firmware package number. The model number and options are separated by a “/” and each option is separated by a “/”.
Page 31: Scpi Required Commands
Programming with SCPI SCPI Required Commands SCPI Required Commands The required SCPI commands that are supported by the MS20xxC are listed in the Table 2-1. These commands work in all measurement modes and are described in Chapter 3 on page 3-1 Table 2-1.
Page 32: Subsystem Commands
Subsystem Commands Programming with SCPI Subsystem Commands Subsystem commands control all instrument functions and some general purpose functions. All subsystem commands are identified by the colon that is used between keywords, as in :INITiate:CONTinuous. The following information is provided for each subsystem command that is described in the following chapters: •...
Page 33: Hierarchical Command Structure
Programming with SCPI Subsystem Commands Long Format versus Short Format Each keyword has a long format and a short format. The start frequency can be specified by :SENSe:FREQuency:STARt or :SENS:FREQ:STAR. The capital letters in the command specification indicate the short form of the command. A mixture of the entire short form elements with entire long form elements of each command is acceptable.
Page 34 Subsystem Commands Programming with SCPI All MS20xxC SCPI commands, except the :ABORt command, have one or more subcommands (keywords) associated with them to further define the instrument function to be controlled. The subcommand keywords may also have one or more associated subcommands (keywords). Each subcommand level adds another layer to the command tree.
Page 35: Query Commands
Programming with SCPI Subsystem Commands Query Commands All commands, unless specifically noted in the commands syntax descriptions, have a query form (refer also to Section 2-10 “Command and Query Notational Conventions” on page 2-12). As defined in IEEE-488.2, a query is a command with a question mark symbol appended (examples: *IDN? and :TRACe[:DATA]? [1]|2|3|4).
Page 36: Data Parameters
Subsystem Commands Programming with SCPI Data Parameters Data parameters, referred to simply as “parameters,” are the quantitative values that are used as arguments for the command keywords. The parameter type that is associated with a particular SCPI command is determined by the type of information that is required to control the particular instrument function.
Page 37: Data Parameter Notations
Programming with SCPI Subsystem Commands Data Parameter Notations The following syntax conventions are used for data parameter descriptions in this manual: Table 2-4. Parameter Notations ::=a generic command argument consisting of one or more of the other data types <arg> ::=boolean values in <NR1>...
Page 38: Notational Conventions
Notational Conventions Programming with SCPI Notational Conventions The SCPI interface standardizes command syntax and style to simplify the task of programming across a wide range of instrumentation. As with any programming language, the exact command keywords and command syntax must be used. Unrecognized commands or improper syntax will not function.
Page 39: Notational Examples
Programming with SCPI Notational Examples Notational Examples Table 2-6. Creating Valid Commands Command Specification Valid Forms The following all produce the same result: [:SENSe]:FREQuency:STARt <freq> :SENSe:FREQuency:STARt 1 MHZ :SENS:FREQ:STAR 1 MHZ :sense:frequency:start 1000000 :FREQ:STAR 1000 KHZ The first 2 commands set the location of :CALCulate:MARKer{1|2|3|4|5|6}:X marker 1.
Page 40: Formatting Conventions
Formatting Conventions Programming with SCPI Formatting Conventions This manual uses the following conventions in describing SCPI commands. Table 2-7. Formatting Conventions Commands are formatted to differentiate them :COMMands:LOOK:LIKE:THIS from their description. The query form of the command is followed by :COMMand:QUERies:LOOK:LIKE:THIS? a “?”...
Page 41: Parameter Names
Programming with SCPI Parameter Names 2-11 Parameter Names The parameters that are returned depend on the firmware version in the MS20xxC, and this document does not cover all possible parameter values that can be returned by the command. Parameter names are dependent upon individual applications and are different for each application.
Page 42 Parameter Names Programming with SCPI 2-14 PN: 10580-00306 Rev. E MS20xxC PM...
Page 43: Introduction
Chapter 3 — VNA Commands Introduction This chapter describes commands for Vector Network Analyzer mode. Only the commands that are listed in this chapter and in Chapter 8, “All Mode Commands” can be used in Vector Network Analyzer mode. Using commands from other modes may produce unexpected results.
Page 44: Calculate Subsystem
:CALCulate Subsystem VNA Commands :CALCulate Subsystem The commands in this subsystem process data that have been collected via the :CALCulate subsystem. Table 3-2. :CALCulate Subsystem Keyword Parameter Data or Units :CALCulate{1-4} Refer to “:CALCulate<Tr>:FILTer[:GATE] Subsystem” on page 3-4 :FILTer[:GATE] Refer to “:CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem”...
Page 45 VNA Commands :CALCulate Subsystem Graph Type Returned Units Real unitless Imaginary unitless Group Delay ns (nanosecond) Smith Chart R + jX ohm Inverted Smith Chart G + jB S Linear Polar unitless, degree Log Polar dB, degree Real Impedance Imaginary Impedance SDATa: Complex measurement data.
Page 46: Calculate:Filter[:Gate] Subsystem
:CALCulate<Tr>:FILTer[:GATE] Subsystem VNA Commands :CALCulate<Tr>:FILTer[:GATE] Subsystem This subsystem includes commands that allow you to set up the gate configuration. Gate Coupling State :CALCulate:FILTer[:GATE]:COUPled[:STATe] Description: Sets the gate coupling state. Setting the value to ON or to 1 turns on the gate coupling, which implies that the gate settings for all traces are identical.
Page 47: Calculate:Filter[:Gate]:Distance Subsystem
VNA Commands :CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem :CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem The commands in this subsystem define the gate configuration for the distance domain. All Front Panel Access sequences that are referenced in this subsytem require that Note the active trace domain is set to Distance. Gate Center Distance :CALCulate<Tr>:FILTer[:GATE]:DISTance:CENTer Description: Sets the gate center distance for the given trace.
Page 48: Gate Center Distance (Continued)
:CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem VNA Commands Gate Center Distance (continued) Example: To set the gate center distance for Trace 4 to 12.5 m: :CALCulate4:FILTer:GATE:DISTance:CENTer 12500 mm :CALC4:FILT:GATE:DIST:CENT 12.5 After either of these two example commands, the following query: :CALCulate4:FILTer:GATE:DISTance:CENTer? Returns the result: 12500 To set the gate center distance for Trace 2 to 20.5 ft: :CALCulate2:FILTer:GATE:DISTance:CENTer 20.5 ft The query is:...
Page 49: Distance Domain Gate Notch State
VNA Commands :CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem Distance Domain Gate Notch State :CALCulate<Tr>:FILTer[:GATE]:DISTance:NOTCh Description: Sets the gate into notch mode for the given trace. Setting the value to ON or to 1 turns on the gate into a notch (in other words, the gate suppresses rather than passes through the time domain data within the start/stop gate settings).
Page 50: Distance Domain Gate Shape
:CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem VNA Commands Distance Domain Gate Shape :CALCulate<Tr>:FILTer[:GATE]:DISTance:SHAPe Description: Sets the gate shape for the given trace. The query version of this command returns the string “MAX” if the current gate shape is set to maximum, “WIDE” if set to wide, “NORM” if set to nominal, and “MIN” if set to minimum.
Page 51: Gate Span Distance
VNA Commands :CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem Gate Span Distance :CALCulate<Tr>:FILTer[:GATE]:DISTance:SPAN Description: Sets the gate span distance for the given trace. <Tr> is the trace number in the range of 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this commands returns the current gate span in millimeters.
Page 52: Gate Start Distance
:CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem VNA Commands Gate Start Distance :CALCulate<Tr>:FILTer[:GATE]:DISTance:STARt Description: Sets the gate start distance for the given trace. <Tr> is the trace number in the range of 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this commands returns the current gate start distance in millimeters.
Page 53: Distance Domain Gate Display Settings
VNA Commands :CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem Distance Domain Gate Display Settings :CALCulate<Tr>:FILTer[:GATE]:DISTance:STATe Description: Sets the gate display settings for the given trace. The gate can be either OFF, in DISPlay mode, or ON. In DISPLay mode, the gate is shown on the trace but is not applied to the transform. When set to ON, the gate is shown and applied to the transform.
Page 54: Gate Stop Distance
:CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem VNA Commands Gate Stop Distance :CALCulate<Tr>:FILTer[:GATE]:DISTance:STOP Description: Sets the gate stop distance for the given trace. <Tr> is the trace number in the range of 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this commands returns the current gate stop distance in millimeters.
Page 55: Calculate:Filter[:Gate]:Time Subsystem
VNA Commands :CALCulate<Tr>:FILTer[:GATE]:TIME Subsystem :CALCulate<Tr>:FILTer[:GATE]:TIME Subsystem The commands in this subsystem define the gate configuration for the time domain. All Front Panel Access sequences that are referenced in this subsytem require that Note the active trace domain is set to Time. Gate Center Time :CALCulate<Tr>:FILTer[:GATE]:TIME:CENTer Description: Sets the gate center time for the given trace.
Page 56: Time Domain Gate Notch State
:CALCulate<Tr>:FILTer[:GATE]:TIME Subsystem VNA Commands Time Domain Gate Notch State :CALCulate<Tr>:FILTer[:GATE]:TIME:NOTCh Description: Sets the gate into notch mode for the given trace. Setting the value to ON or to 1 turns on the gate into a notch (in other words, the gate suppresses rather than passes through the time domain data within the start/stop gate settings).
Page 57: Time Domain Gate Shape
VNA Commands :CALCulate<Tr>:FILTer[:GATE]:TIME Subsystem Time Domain Gate Shape :CALCulate<Tr>:FILTer[:GATE]:TIME:SHAPe Description: Sets the gate shape for the given trace. The query version of this command returns the string “MAX” if the current gate shape is set to maximum, “WIDE” if set to wide, “NORM” if set to nominal, and “MIN” if set to minimum.
Page 58: Gate Span Time
:CALCulate<Tr>:FILTer[:GATE]:TIME Subsystem VNA Commands Gate Span Time :CALCulate<Tr>:FILTer[:GATE]:TIME:SPAN Description: Sets the gate span time for the given trace. <Tr> is the trace number in the range of 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this command returns the current gate span in nanoseconds.
Page 59: Gate Start Time
VNA Commands :CALCulate<Tr>:FILTer[:GATE]:TIME Subsystem Gate Start Time :CALCulate<Tr>:FILTer[:GATE]:TIME:STARt Description: Sets the gate start time for the given trace. <Tr> is the trace number in the range of 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this command returns the current gate start time in nanoseconds.
Page 60: Time Domain Gate Display Setting
:CALCulate<Tr>:FILTer[:GATE]:TIME Subsystem VNA Commands Time Domain Gate Display Setting :CALCulate<Tr>:FILTer[:GATE]:TIME:STATe Description: Sets the gate display settings for the given trace. The gate can be OFF, in DISPlay mode, or ON. In DISPLay mode, the gate is shown on the trace but is not applied to the transform. When set to ON, the gate is shown and applied to the transform.
Page 61: Gate Stop Time
VNA Commands :CALCulate<Tr>:FILTer[:GATE]:TIME Subsystem Gate Stop Time :CALCulate<Tr>:FILTer[:GATE]:TIME:STOP Description: Sets the gate stop time for the given trace. <Tr> is the trace number in the range of 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this commands returns the current gate stop time in nanoseconds.
Page 62: Calculate:format Subsystem
:CALCulate:FORMat Subsystem VNA Commands :CALCulate:FORMat Subsystem Commands in this subsystem define the display format for a measurement. Graph Type :CALCulate<Tr>:FORMat Description: Defines the graph type for the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 63: Calculate:limit Subsystem
VNA Commands :CALCulate:LIMit Subsystem :CALCulate:LIMit Subsystem This subsystem defines the limit lines and controls the limit check. Limit Alarm :CALCulate:LIMit:ALARm Description: Enables/disables the active trace currently selected limit line alarm. Setting the value to ON or 1 turns on the active trace limit alarm. Setting the value to OFF or 0 turns off the active trace limit alarm.
Page 64: Limit Fail
:CALCulate:LIMit Subsystem VNA Commands Limit Fail :CALCulate<Tr>:LIMit:FAIL? Description: Returns the fail status of the given trace <Tr> based on the limits. The limit and the limit message must be ON in order to return a valid boolean value. If either or both limits fail, then a 1 is returned. <Tr>...
Page 65: Limit Pass/Fail
VNA Commands :CALCulate:LIMit Subsystem Limit Pass/Fail :CALCulate<Tr>:LIMit:PFMessage Description: Enables or disables the selected trace pass fail message. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. Setting the value to ON or to 1 turns on the selected trace pass fail message.
Page 66: Upper Limit Fail State
:CALCulate:LIMit Subsystem VNA Commands Upper Limit Fail State :CALCulate<Tr>:LIMit:UPPer:FAIL? Description: Returns the fail status of the given trace <Tr>. The uppper limit and the limit message must be ON in order to return a valid boolean value. If the upper limit fails, then a 1 is returned. Otherwise, a 0 is returned. <Tr>...
Page 67: Add Lower Limit Point
VNA Commands :CALCulate:LIMit Subsystem Add Lower Limit Point :CALCulate<Tr>:LIMit:LOWer:POINt:ADD Description: Adds a new limit point to the lower limit line of the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 68: Lower Limit Next Point Left
:CALCulate:LIMit Subsystem VNA Commands Lower Limit Next Point Left :CALCulate<Tr>:LIMit:LOWer:POINt:LEFT Description: Sets the limit point to the left of the lower limit active point of the given trace <Tr> as the new active point. <Tr> is the trace number in the range 1 to 4.
Page 69: Lower Limit Point X Value
VNA Commands :CALCulate:LIMit Subsystem Lower Limit Point X Value :CALCulate<Tr>:LIMit:LOWer:POINt:X Description: Sets the location of the lower limit point of the given trace <Tr> on the x-axis at the specified location. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1.
Page 70: Lower Limit Point X Value (Continued)
:CALCulate:LIMit Subsystem VNA Commands Lower Limit Point X Value (continued) Example: To set the trace 4 lower limit point to 5000 Hertz (trace 4 in frequency domain): :CALCulate4:LIMit:LOWer:POINt:X 5000 OR to 500 MHz: :CALCulate4:LIMit:LOWer:POINt:X 500 MHz To set the trace 1 lower limit point to 5 Feet (trace 1 in distance domain with current distance unit in meter): :CALCulate:LIMit:LOWer:POINt:X 5 FT OR to 4 Meter...
Page 71: Lower Limit Point Y Value
VNA Commands :CALCulate:LIMit Subsystem Lower Limit Point Y Value :CALCulate<Tr>:LIMit:LOWer:POINt:Y Description: Sets the location of the lower limit point of the given trace <Tr> on the y-axis at the specified location. <Tr> is the trace number in the range 1 to 4. If no trace number is specified then default is trace number 1. Sending the set command changes the Move Limit on the front panel to Point if it is currently set to Limit, and sets the given trace as the active trace.
Page 72: Lower Limit State
:CALCulate:LIMit Subsystem VNA Commands Lower Limit State :CALCulate<Tr>:LIMit:LOWer[:STATe] Description: Turns the lower limit line of the given trace <Tr> ON or OFF. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. <Tr> is the trace number in the range 1 to 4.
Page 73: Lower Limit X Value
VNA Commands :CALCulate:LIMit Subsystem Lower Limit X Value :CALCulate<Tr>:LIMit:LOWer:X Description: Moves the lower limit of the given trace <Tr> on the x-axis to the given value. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 74: Lower Limit X Value (Continued)
:CALCulate:LIMit Subsystem VNA Commands Lower Limit X Value (continued) Example: To move the trace 4 lower limit to 5000 Hertz (trace 4 in frequency domain) :CALCulate4:LIMit:LOWer:X 5000 OR to 500 MHz: :CALCulate4:LIMit:LOWer:X 500 MHz To move the trace 1 lower limit to 5 Feet (trace 1 in distance domain with current distance unit in meter) :CALCulate:LIMit:LOWer:X 5 FT OR to 4 Meter...
Page 75: Lower Limit Y Value
VNA Commands :CALCulate:LIMit Subsystem Lower Limit Y Value :CALCulate<Tr>:LIMit:LOWer:Y Description: Sets the location of the lower limit line of the given trace <Tr> on the y-axis at the given value. This moves the entire lower limit and moves the current active limit point by the given value. <Tr> is the trace number in the range 1 to 4.
Page 76: Add Limit Point
:CALCulate:LIMit Subsystem VNA Commands Add Limit Point :CALCulate:LIMit:POINt:ADD Description: Adds a new limit point to the currently active limit line. Use :CALCulate:LIMit:TYPE to set the currently active limit line. Syntax: :CALCulate:LIMit:POINt:ADD Cmd Parameter: NA Query Response: NA (no query) Related Command: :CALCulate:LIMit:TYPE :CALCulate:LIMit:POINt:DELete Front Panel Access: Shift 6 (Limit), Limit Edit, Add Point...
Page 77: Next Point Left
VNA Commands :CALCulate:LIMit Subsystem Next Point Left :CALCulate:LIMit:POINt:LEFT Description: Sets the limit point immediately to the left of the active limit point as the active point. This makes it active for editing or deleting. Use :CALCulate:LIMit:TYPE to set the currently active limit line. Syntax: :CALCulate:LIMit:POINt:LEFT Cmd Parameter: NA Query Response: NA (no query)
Page 78: Limit Point X Value
:CALCulate:LIMit Subsystem VNA Commands Limit Point X Value :CALCulate:LIMit:POINt:X Description: Sets the location of the active limit point on the x-axis at the specified location. Sending this command changes the Move Limit on the front panel to Point if it is currently set to Limit. The <x-parameter> must correspond to the current active trace domain type.
Page 79: Limit Point X Value (Continued)
VNA Commands :CALCulate:LIMit Subsystem Limit Point X Value (continued) Example: To set the active limit point to 5000 Hertz (active trace in frequency domain): :CALCulate:LIMit:POINt:X 5000 OR to 500 MHz: :CALCulate:LIMit:POINt:X 500 MHz To set the active limit point to 5 Feet (active trace in distance domain with current distance unit in meter): :CALCulate:LIMit:POINt:X 5 FT OR to 4 Meter...
Page 80: Limit Point Y Value
:CALCulate:LIMit Subsystem VNA Commands Limit Point Y Value :CALCulate:LIMit:POINt:Y Description: Sets the location of the active limit point on the y-axis at the specified location. Sending this command changes the Move Limit on the front panel to Point if it is currently set to Limit. The <y-parameter> is defined in the current y-axis.
Page 81: Limit State
VNA Commands :CALCulate:LIMit Subsystem Limit State :CALCulate:LIMit[:STATe] Description: Turns the active trace currently selected limit line (upper or lower) ON or OFF. If the value is set to ON or 1, then the active trace selected limit line is turned ON. If the value is set to OFF or 0, then the active trace selected limit line is turned OFF.
Page 82: Limit Type
:CALCulate:LIMit Subsystem VNA Commands Limit Type :CALCulate:LIMit:TYPE Description: Sets the limit line segment type (upper or lower) to be edited. Set the value to 1 for Lower limit segment and to 0 for Upper limit line segment. The query version of the command returns a 1 if the lower limit line is currently active for editing and returns a 0 if the upper limit line is currently active for editing.
Page 83: Add Upper Limit Point
VNA Commands :CALCulate:LIMit Subsystem Add Upper Limit Point :CALCulate<Tr>:LIMit:UPPer:POINt:ADD Description: Adds a new limit point to the upper limit line of the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 84: Upper Limit Next Point Left
:CALCulate:LIMit Subsystem VNA Commands Upper Limit Next Point Left :CALCulate<Tr>:LIMit:UPPer:POINt:LEFT Description: Sets the limit point to the left of the upper limit active point of the given trace <Tr> as the new active point. <Tr> is the trace number in the range 1 to 4.
Page 85: Upper Limit Point X Value
VNA Commands :CALCulate:LIMit Subsystem Upper Limit Point X Value :CALCulate<Tr>:LIMit:UPPer:POINt:X Description: Sets the location of the upper limit point of the given trace <Tr> on the x-axis at the specified location. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then default trace is trace number 1.
Page 86: Upper Limit Point X Value (Continued)
:CALCulate:LIMit Subsystem VNA Commands Upper Limit Point X Value (continued) Example: To set the trace 4 upper limit point to 5000 Hertz (trace 4 in frequency domain): :CALCulate4:LIMit:UPPer:POINt:X 5000 OR to 500 MHz: :CALCulate4:LIMit:UPPer:POINt:X 500 MHz To set the trace 1 upper limit point to 5 Feet (trace 1 in distance domain with current distance unit in meter): :CALCulate:LIMit:UPPer:POINt:X 5 FT OR to 4 Meter...
Page 87: Upper Limit Point Y Value
VNA Commands :CALCulate:LIMit Subsystem Upper Limit Point Y Value :CALCulate<Tr>:LIMit:UPPer:POINt:Y Description: Sets the location of the upper limit point of the given trace <Tr> on the y-axis at the specified location. <Tr> is the trace number in the range 1 to 4. If no trace number is specified then default trace is trace number 1.
Page 88: Upper Limit State
:CALCulate:LIMit Subsystem VNA Commands Upper Limit State :CALCulate<Tr>:LIMit:UPPer[:STATe] Description: Turns the upper limit line of the given trace <Tr> ON or OFF. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then default trace is trace number 1. The query version of the command returns a 1 if the upper limit line of the given trace is ON and returns a Syntax :CALCulate<Tr>:LIMit:UPPer[:STATe] OFF|ON|0|1...
Page 89: Upper Limit X Value
VNA Commands :CALCulate:LIMit Subsystem Upper Limit X Value :CALCulate<Tr>:LIMit:UPPer:X Description: Moves the upper limit of the given trace <Tr> on the x-axis to the given value. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 90: Upper Limit X Value (Continued)
:CALCulate:LIMit Subsystem VNA Commands Upper Limit X Value (continued) Example: To move the trace 4 upper limit to 5000 Hertz (trace 4 in frequency domain): :CALCulate4:LIMit:UPPer:X 5000 OR to 500 MHz: :CALCulate4:LIMit:UPPer:X 500 MHz To move the trace 1 upper limit to 5 feet (trace 1 in distance domain with current distance unit in meter): :CALCulate:LIMit:UPPer:X 5 FT OR to 4 Meter...
Page 91: Upper Limit Y Value
VNA Commands :CALCulate:LIMit Subsystem Upper Limit Y Value :CALCulate<Tr>:LIMit:UPPer:Y Description: Sets the location of the upper limit line of the given trace <Tr> on the y-axis at the given value. This moves the entire upper limit and moves the current active limit point by the given value. <Tr> is the trace number in the range 1 to 4.
Page 92: Limit X Value
:CALCulate:LIMit Subsystem VNA Commands Limit X Value :CALCulate:LIMit:X Description: Sets the location of the active limit point on the x-axis at the specified location. This moves the entire limit and moves the active limit point to the given value. The <x-parameter> given unit must correspond to the current active trace domain type.
Page 93: Limit X Value (Continued)
VNA Commands :CALCulate:LIMit Subsystem Limit X Value (continued) Example: To move the active limit to 5000 Hertz (active trace in frequency domain): :CALCulate:LIMit:X 5000 OR to 500 MHz: :CALCulate:LIMit:X 500MHz To move the active limit to 5 Feet (active trace in distance domain with current distance unit in feet): :CALCulate:LIMit:X 5FT OR to 4 Meter...
Page 94: Limit Y Value
:CALCulate:LIMit Subsystem VNA Commands Limit Y Value :CALCulate:LIMit:Y Description: Sets the location of the active limit line on the y-axis at the given value. This moves the entire limit and moves the current active limit point by the given value. Sending this command changes the Move Limit on the front panel to Limit if it is currently set to Point.
Page 95: Calculate:marker Subsystem
VNA Commands :CALCulate:MARKer Subsystem :CALCulate:MARKer Subsystem This subsystem contains commands to manipulate data markers. Turn All Markers Off :CALCulate:MARKer:AOFF Turns off all markers. This command turns off all markers that are not currently set to off. Marker Data :CALCulate:MARKer:DATA? Description: Reports the marker information. Each marker data is separated by a comma and data are returned similar to that when Readout Format is set to Table.
Page 96: Delta Marker Reference To
:CALCulate:MARKer Subsystem VNA Commands Delta Marker Reference To :CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa:REFerence Description: Sets the specified delta marker reference to the given reference marker specified by <Mk>. <Mk> is the reference marker number in the range of 1 to 8. The query version of the command returns the reference marker number to which the specified delta marker should be referenced.
Page 97: Delta Marker State
VNA Commands :CALCulate:MARKer Subsystem Delta Marker State :CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:STATe] Description: Sets the specified marker as the active marker and turns it on or off. If the value is set to ON or 1, then the specified marker is turned on and is set as a delta marker.
Page 98: Marker Readout Format
:CALCulate:MARKer Subsystem VNA Commands Marker Readout Format :CALCulate:MARKer:DISPlay:FORMat Description: Sets the display readout format for markers. The query version of the command returns “NONE” if the display readout format is set to None, “SCRE” if Screen, “TABL” if Table, and “TRAC” if Trace. Syntax: :CALCulate:MARKer:DISPlay:FORMat NONE|SCREen|TABLe|TRACe :CALCulate:MARKer:DISPlay:FORMat?
Page 99: Marker Readout Style
VNA Commands :CALCulate:MARKer Subsystem Marker Readout Style :CALCulate:MARKer<Mk>:FORMat Description: Sets the specified marker <Mk> readout style. <Mk> is the marker number in the range of 1 to 8. If no marker number is specified, then the marker number (the <Mk> value) defaults to 1. <Style> is the marker readout style and must be one of the following values: GRAPh|LMAGnitude|LOGPhase|PHASe|RLIMaginary|SWR| IMPedance||ADMittance|NIMPedance|NADMittance|...
Page 100: Marker (Maximum) Peak Search
:CALCulate:MARKer Subsystem VNA Commands Marker (Maximum) Peak Search :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum Description: Puts the specified marker at the maximum value in the trace. Note that this turns on the selected marker (if it is not already on) and sets the selected marker as the active marker. Syntax: :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum Cmd Parameter: NA Query Response: NA (no query)
Page 101: Reference Marker State
VNA Commands :CALCulate:MARKer Subsystem Reference Marker State :CALCulate:MARKer<Mk>:REFerence[:STATe] Description: Sets the specified marker <Mk> as the active marker and turns it on or off. If the value is set to ON or 1, the specified marker is turned on and set as a reference marker.
Page 102: Marker On Trace
:CALCulate:MARKer Subsystem VNA Commands Marker On Trace :CALCulate:MARKer<Mk>:SOURce Description: Sets the specified marker <Mk> to the given trace <Tr>. <Mk> is the marker number in the range of 1 to 8. If no marker number is specified, then the marker number (the <Mk> value) defaults to 1. <Tr> is the trace and must be one of the following 9 values: TR1|TR2|TR3|TR4|MEM1|MEM2|MEM3|MEM4|ALL The query version of the command returns “TR1”...
Page 103: Marker Type
VNA Commands :CALCulate:MARKer Subsystem Marker Type :CALCulate:MARKer[1]|2|3|4|5|6|7|8:TYPE Description: Sets the specified marker to the given marker type and makes it the active marker. If set to REF, then the specified marker is turned on and is set as reference marker. If set to DELT, then the specified marker is turned on and is set as a delta marker.
Page 104: Marker X Value
:CALCulate:MARKer Subsystem VNA Commands Marker X Value :CALCulate:MARKer[1]|2|3|4|5|6|7|8:X Description: Sets the location of the marker on the x-axis at the specified location. <x-parameter> is defined in the current x-axis units. The set command sets the specified marker as the active marker. The <x-parameter>...
Page 105: Marker X Value (Continued)
VNA Commands :CALCulate:MARKer Subsystem Marker X Value (continued) Example: To set reference marker #2 (frequency domain) to 5000 hertz on the x-axis: :CALCulate:MARKer2:X 5000 :CALCulate:MARKer2:X 5000Hz To set reference marker #1 to 1.5 GHz on the x-axis: :CALCulate:MARKer1:X 1.5GHz :CALCulate:MARKer1:X 1.5GHz To set reference marker #3 (time domain) to 1.5 nanoseconds on the x-axis: :CALCulate:MARKer3:X 1.5ns...
Page 106: Marker Read Y Value
:CALCulate:MARKer Subsystem VNA Commands Marker Read Y Value :CALCulate:MARKer[1]|2|3|4|5|6|7|8:Y? Description: Reads the current Y value for the specified marker. The units are in the y-axis unit. The command returns the marker readout style followed by the Y value and unit. If an error occurs, such as marker not ON, then the command returns an error code of –400.
Page 107: Marker Read Y Value (Continued)
VNA Commands :CALCulate:MARKer Subsystem Marker Read Y Value (continued) Related Command: :CALCulate:MARKer#:DOMain? :CALCulate:MARKer<Mk>:FORMat <Style> :CALCulate:MARKer[1]|2|3|4|5|6|7|8:X? Front Panel Access: NA MS20xxC PM PN: 10580-00306 Rev. E 3-65...
Page 108: Calculate:math Subsystem
:CALCulate:MATH Subsystem VNA Commands :CALCulate:MATH Subsystem This subsystem contains functions for controlling math operations on the currently selected measurement and memory.Trace Math Function :CALCulate:MATH:FUNCtion Description: Sets the math operations on the currently active trace and the trace that is stored in memory. Note that a trace MUST be stored in Memory. Setting the FUNCtion to NORMal is equivalent of setting the Trace Math to None on the front panel.
Page 109: 3-10 :Calculate:smoothing Subsystem
VNA Commands :CALCulate:SMOothing Subsystem 3-10 :CALCulate:SMOothing Subsystem This subsystem contains functions for trace smoothing. Smoothing :CALCulate<Tr>:SMOothing:APERture Description: Sets the smoothing percentage for the given trace <Tr>. The query form of the command returns the current smoothing percentage. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 110: Calculate:transform Subsystem
:CALCulate:TRANsform Subsystem VNA Commands 3-11 :CALCulate:TRANsform Subsystem Front panel soft keys that are related to distance measurements, such as the Additional Dist Setup soft key, appear in menus only when the Setup Domain is set up for distance. Maximum Distance :CALCulate:TRANsform:DISTance:MAXimum? Description: This command returns the maximum distance in millimeters if the current distance unit is set to meter, and otherwise returns the...
Page 111: Start Distance
VNA Commands :CALCulate:TRANsform Subsystem Start Distance :CALCulate:TRANsform:DISTance:STARt Description: Sets the start distance for DTF measurements. The query version of this command returns the start distance in millimeters if the current distance unit is set to meter, and otherwise returns the start distance in feet.
Page 112: Distance Units
:CALCulate:TRANsform Subsystem VNA Commands Distance Units :CALCulate:TRANsform:DISTance:UNIT Description: Sets the units to be used for DTF measurements. The query version of this command returns the string “METER” if the current distance unit is set to meter, and otherwise returns the string “FEET”. Syntax: :CALCulate:TRANsform:DISTance:UNIT METers|FEET :CALCulate:TRANsform:DISTance:UNIT? Cmd Parameter: <char>...
Page 113: Distance Domain Window Shape
VNA Commands :CALCulate:TRANsform Subsystem Distance Domain Window Shape :CALCulate:TRANsform:DISTance:WINDow Description: Sets the distance domain window shape (used for pre-processing the frequency domain data) for all traces. Setting the window to RECTangular sets the window shape to rectangular. Setting the window to NSL sets the window shape to Nominal Side Lobe view. Setting the window to LSL sets the window shape to Low Side Lobe view.
Page 114: Maximum Time
:CALCulate:TRANsform Subsystem VNA Commands Maximum Time :CALCulate:TRANsform:TIME:MAXimum? Description: This command returns the maximum time in nanoseconds. This value is set based on the number of data points and the start and stop frequencies. Syntax: :CALCulate:TRANsform:TIME:MAXimum? Cmd Parameter: NA (query only) Query Response: <NR3>...
Page 115: Start Time
VNA Commands :CALCulate:TRANsform Subsystem Start Time :CALCulate:TRANsform:TIME:STARt Description: Sets the start time. The query version returns the current start time in nanoseconds. Syntax: :CALCulate:TRANsform:TIME:STARt :CALCulate:TRANsform:TIME:STARt? Cmd Parameter: <NRf> seconds Query Response: <NR3> nanoseconds Range: –100 ms to +100 ms Default Value: 0 ps Default Unit: Seconds (s) when setting, nanoseconds (ns) for query Example: To set the start time to 10 microseconds: :CALC:TRAN:TIME:STAR 10us...
Page 116: Reflection Calculation For Time Domain
:CALCulate:TRANsform Subsystem VNA Commands Reflection Calculation for Time Domain :CALCulate:TRANsform:TIME:TRIP Description: Sets the trip length of the time transform for the reflection parameters or S ). For these reflection parameters, the x-axis scale can either represent a one-way path (the time required to reach the end of the DUT only –...
Page 117: Time Domain Processing Mode
VNA Commands :CALCulate:TRANsform Subsystem Time Domain Processing Mode :CALCulate:TRANsform:TIME:TYPE:AUTO Description: Sets the time domain transformation mode to either Auto (use parameters ON or 1) or bandpass only (use parameters OFF or 0). In Auto mode, the instrument uses lowpass time domain processing if the instrument settings allow that (which typically occurs when the sweep is a harmonic sweep).
Page 118: Time Domain Window Shape
:CALCulate:TRANsform Subsystem VNA Commands Time Domain Window Shape :CALCulate:TRANsform:TIME:WINDow Description: Sets the time domain window shape (which is used for pre-processing the frequency domain data) for all traces. Setting the window to RECTangular sets the window shape to rectangular. Setting the window to NSL sets the window shape to Nominal Side Lobe view.
Page 119: Get Distance List
VNA Commands :CALCulate:TRANsform Subsystem Get Distance List :CALCulate<Tr>:TRANsform:DISTance:DATA? Description: Produces the distance list in meters for the given trace. <Tr> is the trace number in the range 1 to 8 (1 to 4 for Traces TR1 to TR4 and 5 to 8 for Memory M1 to M4). If no trace number is specified, then the <Tr>...
Page 120: Band Pass Mode Response
:CALCulate:TRANsform Subsystem VNA Commands Band Pass Mode Response :CALCulate<Tr>:TRANsform:TIME:BPASs:STIMulus Description: Sets the response type to be used in the band pass transformation process for the given trace. The response type is set to either Standard or Phasor Impulse. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 121: Get Time List
VNA Commands :CALCulate:TRANsform Subsystem Get Time List :CALCulate<Tr>:TRANsform:TIME:DATA? Description: Produces the time list in nanoseconds for the given trace. <Tr> is the trace number in the range 1 to 8 (1 to 4 for Traces TR1 to TR4 and 5 to 8 for Memory M1 to M4). If no trace number is specified, then the <Tr>...
Page 122: Low Pass Mode Response
:CALCulate:TRANsform Subsystem VNA Commands Low Pass Mode Response :CALCulate<Tr>:TRANsform:TIME:LPASs:STIMulus Description: Sets the response type to be used in the low pass transformation process for the given trace. The response type is set to either Impulse or Step. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 123: 3-12 :Display Subsystem
VNA Commands :Display Subsystem 3-12 :Display Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. Trace Display :DISPlay[:WINDow]:TRACe TRACe|MEMory|BOTH Description: Sets the display type for the current active trace. Setting the display type to TRAC displays the trace only.
Page 124: Group Delay Aperture
:Display Subsystem VNA Commands Group Delay Aperture :DISPlay:WINDow:TRACe:Y[:SCALe]:GDAPerture Description: Sets the Group Delay aperture value (which is common to all traces). The query version of this command produces the Group Delay aperture as its output. Syntax: :DISPlay:WINDow:TRACe:Y[:SCALe]:GDAPerture <integer> :DISPlay:WINDow:TRACe:Y[:SCALe]:GDAPerture? Cmd Parameter: <NR1> <integer> Query Response: <NR1>...
Page 125: Scale Resolution Per Division
VNA Commands :Display Subsystem Scale Resolution Per Division :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:PDIVision Description: Sets the scale per division for the y-axis. For Group Delay, sets the scale (time/division) for the y-axis. For Phase, sets the scale (degree/division) for the y-axis. For Log Magnitude, Log Mag/2, and Log Polar, sets the scale (dB/division) for the y-axis.
Page 126: Scale Resolution Per Division (Continued)
:Display Subsystem VNA Commands Scale Resolution Per Division (continued) Default Unit: Current active value unit (For time, the default for setting is seconds, but the query is always returned in nanoseconds (ns).) Although these values are not used for Smith Chart or Inverted Smith Chart, when you query or set through SCPI, the instrument always returns a value.
Page 127: Scale Reference Level (Continued)
VNA Commands :Display Subsystem Scale Reference Level (continued) Default Value: Log Magnitude: 0 dB SWR: 1 Phase: 0° Group Delay: 0 ps Real: 0 Imag: 0 Log Mag/2: 0 dB Smith Chart: 10 Inverted Smith Chart: 10 Log Polar: 0 dB Linear Polar: 1 Real Impedance: 50 ohm Imaginary Impedance: 0 ohm...
Page 128: Scale Reference Line
:Display Subsystem VNA Commands Scale Reference Line :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:RPOSition Description: Sets the reference line scale value for the y-axis. Syntax: :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:RPOSition <integer> :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:RPOSition? Cmd Parameter: <NR1> <integer> Query Response: <NR1> <integer> Range: Log Magnitude: 0 to 10 SWR: 0 to 10 Phase: 0 to 8 Group Delay: 0 to 10 Real: 0 to 10...
Page 129: Smith Chart Scalable Type
VNA Commands :Display Subsystem Smith Chart Scalable Type :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:SMCHart Description: Sets the Smith Chart or Inverted Smith Chart display scale type of the given trace number specified by <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1.
Page 130: 3-13 :Format Subsystem
:Format Subsystem VNA Commands 3-13 :Format Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, then it is noted in the command description. Numeric Data Format :FORMat[:READings][:DATA] Description: This command specifies the format in which data is returned in certain...
Page 131: 3-14 :Initiate Subsystem
VNA Commands :INITiate Subsystem 3-14 :INITiate Subsystem This subsystem controls the triggering of measurements. Continuous/Single Sweep :INITiate:CONTinuous Description: Sets the sweep to continuous. If the instrument is currently on hold, and if sweep type is set to continuous, then setting to ON restarts the sweep.
Page 132: Hold Sweep
:INITiate Subsystem VNA Commands Hold Sweep :INITiate:HOLD Description: Sets the sweep to hold. If the instrument is currently sweeping, then setting a value of ON or 1 pauses the sweep. If the instrument is currently not sweeping, and if sweep type is set to continuous, then setting a value of OFF or 0, restarts the sweep.
Page 133: 3-15 :Input Subsystem
VNA Commands :INPut Subsystem 3-15 :INPut Subsystem This subsystem controls characteristics of the input port. IF Gain Mode Setting :INPut:GAIN:MODE Description: Sets the method by which the instrument adjusts the gain of the IF path. In AUTO mode, the instruments adjusts the gain depending on the input signal level in order to maximize the dynamic range of the instrument.
Page 134: Internal Bias Tee Current
:INPut Subsystem VNA Commands Internal Bias Tee Current :INPut<port_no>:BIAS:CURRent Description: Sets the internal bias tee current limit for the specified port. When this limit is exceeded, the Bias Tee trips (turns OFF). <port_no> is the specified internal bias tee port number, 1 to 2. The query version of this command returns either the measured internal current or the set internal current limit (both are returned in milliampere units).
Page 135: External Bias Tee Tripped State
VNA Commands :INPut Subsystem External Bias Tee Tripped State :INPut:BIAS:EXTernal:TRIPped[:STATe]? Description: Returns whether the external bias tee is tripped. Returns 1 for tripped, otherwise returns 0. Syntax: :INPut:BIAS:EXTernal:TRIPped[:STATe]? Cmd Parameter: NA (query only) Query Response : <boolean> [0|1] Front Panel Access: NA External Bias Tee Voltage :INPut<port_no>:BIAS:EXTernal:VOLTage?
Page 136: Internal Bias Tee Port Selection
:INPut Subsystem VNA Commands Internal Bias Tee Port Selection :INPut:BIAS:PORT:SELect Description: Specifies the internal bias tee port. Syntax: :INPut:BIAS:PORT:SELect 1|2 :INPut:BIAS:PORT:SELect? Cmd Parameter: <char> 1|2 Query Response: <char> 1|2 Default Value: 2 Front Panel Access: Shift-3 (Sweep), Configure Ports, Bias Tee Setup, Int Port Selection Bias Tee State :INPut:BIAS:STATe Description: Enables or disables the bias tee.
Page 137: Internal Bias Tee Voltage
VNA Commands :INPut Subsystem Internal Bias Tee Voltage :INPut<port_no>:BIAS:VOLTage Description: Sets the voltage of the internal bias tee for the specified port number. <port_no> is the specified internal bias tee port number, 1 or 2. The query version of this command returns either the measured internal bias tee voltage or the set internal bias tee voltage (both are returned in Volts).
Page 138: 3-16 :Mmemory Subsystem
:MMEMory Subsystem VNA Commands 3-16 :MMEMory Subsystem The Mass MEMory subsystem contains functions that provide access to the instrument setup and data storage. Table 3-4. :MMEMory Subsystem Parameter Keyword Form Parameter Data or Units Notes :MMEMory Refer to “:MMEMory:LOAD Subsystem” :LOAD on page 3-97 Refer to...
Page 139: 3-17 :Mmemory:load Subsystem
VNA Commands :MMEMory:LOAD Subsystem 3-17 :MMEMory:LOAD Subsystem The Mass MEMory LOAD subsystem contains commands to transfer from the mass memory device to the internal memory. Recall and Save for both setup and measurement, as described in this section, are Note specific for vector network analyzer modes, not for spectrum analyzer mode.
Page 140: Recall Measurement
:MMEMory:LOAD Subsystem VNA Commands Recall Measurement :MMEMory:LOAD:TRACe Description: Recalls a previously stored measurement trace from the current storage location. The saved measurement trace that is to be loaded is specified by <file name>. <file name> must be enclosed in either single quotes (‘...
Page 141: 3-18 :Mmemory:store Subsystem
VNA Commands :MMEMory:STORe Subsystem 3-18 :MMEMory:STORe Subsystem The Mass MEMory STORe subsystem contains commands to transfer from the internal memory to the mass memory device. Save Setup :MMEMory:STORe:STATe Description: Stores the current setup into the file that is specified by <file name>.
Page 142: Save Measurement
:MMEMory:STORe Subsystem VNA Commands Save Measurement :MMEMory:STORe:TRACe The integer parameters that are used in this command are specific to the vector Note network analyzer modes, not for spectrum analyzer mode. Description: Stores the trace into the file that is specified by <file name>. <file name>...
Page 143: 3-19 [:Sense] Subsystem
VNA Commands [:SENSe] Subsystem 3-19 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not to signal-oriented parameters. Table 3-5. [:SENSe] Subsystem Keyword Parameter Data or Units [:SENSe] Refer to “[:SENSe]:APPLication Subsystem” on page 3-102 :APPLication Refer to “[:SENSe]:AVERage Subsystem”...
Page 144: 3-20 [:Sense]:Application Subsystem
[:SENSe]:APPLication Subsystem VNA Commands 3-20 [:SENSe]:APPLication Subsystem This subsystem contains application specific commands. Application Self Test [:SENSe]:APPLication:TST? Description: Executes an application self test and reports whether any errors were detected. A return value of “0” indicates that the test was completed without detecting any error.
Page 145: 3-21 [:Sense]:Average Subsystem
VNA Commands [:SENSe]:AVERage Subsystem 3-21 [:SENSe]:AVERage Subsystem This subsystem contains commands that are related to the combination of the data from consecutive sweeps. Use commands in this subsystem to control sweep-to-sweep averaging and max hold functionality. Restart Averaging [:SENSe]:AVERage:CLEar Description: No query. Clears and restarts averaging of the measurement data. Note that sweep averaging count must be set to greater than 1 for averaging to restart.
Page 146: 3-22 [:Sense]:Calibration Subsystem
[:SENSe]:CALibration Subsystem VNA Commands 3-22 [:SENSe]:CALibration Subsystem This subsystem controls the system calibration. Calibration State [:SENSe]:CALibration:STATe? Description: Reports the calibrated state. This command returns a 0 if there is no valid calibration, otherwise it returns the bit of the S parameters that has a valid calibration.
Page 147: 3-23 [:Sense]:Correction Subsystem
VNA Commands [:SENSe]:CORRection Subsystem 3-23 [:SENSe]:CORRection Subsystem This subsystem provides commands for losses or gains external to the instrument. Table 3-6. [:SENSe]:CORRection Subsystem Keyword Parameter Data or Units [:SENSe] :CORRection Refer to “[:SENSe]:CORRection:CKIT Subsystem” on page 3-108 :CKIT Refer to “[:SENSe]:CORRection:COLLect Subsystem”...
Page 148: Error Correction Data (Continued)
[:SENSe]:CORRection Subsystem VNA Commands Error Correction Data (continued) The format of the block data that is returned can be specified by the command :FORMat:DATA. The response begins with an ASCII header that specifies the number of data bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header.
Page 149: Calibration Correction State
VNA Commands [:SENSe]:CORRection Subsystem Calibration Correction State [:SENSe]:CORRection[:STATe] Description: Turns the calibration error correction ON or OFF. Note that error correction can be turned ON only if valid calibration is available. Syntax: [:SENSe]:CORRection[:STATe] OFF|ON [:SENSe]:CORRection[:STATe]? Parameter: OFF|ON Cmd Parameter: <boolean> OFF|ON|0|1 Query Response: <bNR1>...
Page 150: 3-24 [:Sense]:Correction:ckit Subsystem
[:SENSe]:CORRection:CKIT Subsystem VNA Commands 3-24 [:SENSe]:CORRection:CKIT Subsystem This subsystem provides commands that modify and configure the device under test (DUT). Table 3-7. [:SENSe]:CORRection:CKIT Subsystem Keyword Parameter Data or Units [:SENSe] :CORRection :CKIT Refer to “[:SENSe]:CORRection:CKIT:USER Subsystem” :USER{1-4} on page 3-114 Calibration Connector Information [:SENSe]:CORRection:CKIT:INFormation? Description: Returns a string of information of the given calibration connector.
Page 151 VNA Commands [:SENSe]:CORRection:CKIT Subsystem COAX <connector> [connector-name] Description NMALe SLN50A or N-Conn(M) OSLN50A-8 or Cal Kit: OSLN50A-8 or OSLN50A-18 OSLN50A-18 Query Response: <block> (returns comma-delimted ASCII format) NMALe TOSLN50A or N-Conn(M) TOSLN50A-8 or Cal Kit: TOSLN50A-8 or TOSLN50A-18 TOSLN50A-18 Query Response: <block> (returns comma-delimted ASCII format) NFEMale...
Page 152 [:SENSe]:CORRection:CKIT Subsystem VNA Commands COAX <connector> [connector-name] Description KFEMale OSLKF50 K-Conn(F) Cal Kit: OSLKF50 If no connector-name is given, then information will default to this. Query Response: <block> (returns comma-delimted ASCII format) KFEMale TOSLKF50A or K-Conn(F) TOSLKF50A-20 Cal Kit: TOSLKF50A-20 Query Response: <block>...
Page 153 VNA Commands [:SENSe]:CORRection:CKIT Subsystem COAX <connector> [connector-name] Description TNCFemale TNC(F) Cal Kit: 1091-5x & 1015-54 If no connector-name is given, then information will default to this. Query Response: <block> (returns comma-delimted ASCII format) SMAMale 3650 SMA(M) Cal Kit: 3650 SMAFemale 3650 SMA(F) Cal Kit: 3650...
Page 154 [:SENSe]:CORRection:CKIT Subsystem VNA Commands WAVEGUIDE <connector> Description WG11 WG11A/WR229/R40 Cal Kit: xxUM40 Query Response: <block> (returns comma-delimted ASCII format) WG12 WG12/WR187/R48 Cal Kit: xxUM48 or xxUA187 Query Response: <block> (returns comma-delimted ASCII format) WG13 WG13/WR159/R58 Cal Kit: xxUM58 Query Response: <block> (returns comma-delimted ASCII format) WG14 WG14/WR137/R70...
Page 155 VNA Commands [:SENSe]:CORRection:CKIT Subsystem WAVEGUIDE <connector> Description USR2 User 1 Cal Kit information for the current calibration method. Query Response: <block> (returns comma-delimted ASCII format) USR3 User 1 Cal Kit information for the current calibration method. Query Response: <block> (returns comma-delimted ASCII format) USR4 User 1 Cal Kit information for the current...
Page 156: 3-25 [:Sense]:Correction:ckit:user Subsystem
[:SENSe]:CORRection:CKIT:USER Subsystem VNA Commands 3-25 [:SENSe]:CORRection:CKIT:USER Subsystem This subsystem contains commands to configure the user device under test (DUT). DUT User Inductance Coefficient value [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX:SOLT:L0|1|2|3 Description: Sets the DUT inductance value for the specified Short component of the user-defined SOLT Cal Kit. Syntax: [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX:SOLT: L0|1|2|3 <inductance>...
Page 157: Dut User Cutoff Frequency
Range: 5 kHz to 20 GHz for MS2028C, MS2038C 5 kHz to 15 GHz for MS2027C, MS2037C 5 kHz to 6 GHz for MS2026C, MS2036C Example: To set the DUT cutoff frequency for User 1 with calibration method SSLT to 1 GHz:...
Page 158: Dut User Open Offset
[:SENSe]:CORRection:CKIT:USER Subsystem VNA Commands DUT User Open Offset [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX|WGUide:SOLT :OPEN Description: Sets the DUT capacitance value for the specified user. Syntax: [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX|WGUide :SOLT:OPEN <length> [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX|WGUide :SOLT:OPEN? Cmd Parameter: <NRf> <length> (millimeters) Query Response: <NR3> <length> (millimeters) Example: To set the DUT open offset for User 1 with line type coax to 3 mm: :SENS:CORR:CKIT:USER:COAX:SOLT:OPEN 3 Front Panel Access: NA...
Page 159: Dut User Short Offset (Ssst)
VNA Commands [:SENSe]:CORRection:CKIT:USER Subsystem DUT User Short Offset (SSST) [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX|WGUide :SSST:SHORt[1]|2|3 Description: Syntax: [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX|WGUide :SSST:SHORt[1]|2|3 <length> [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX|WGUide :SSST:SHORt[1]|2|3? Cmd Parameter: <NRf> <length> (millimeters) Query Response: <NR3> <length> (millimeters) Example: To set the DUT short offset 2 for User 1 with line type coax and calibration method SSST to 3 mm: :SENSe:CORRection:CKIT:USER:COAX:SSST:SHORt2 3 Front Panel...
Page 160: 3-26 [:Sense]:Correction:collect Subsystem
[:SENSe]:CORRection:COLLect Subsystem VNA Commands 3-26 [:SENSe]:CORRection:COLLect Subsystem This subsystem controls the system calibration. To properly perform a calibration, several parameters must be set. The table below lists all of the required commands. First, use the :MEDium and :CONNector subcommands to specify the calibration line type and the DUT port setup.
Page 161: Calibration Steps
VNA Commands [:SENSe]:CORRection:COLLect Subsystem Calibration Steps [:SENSe]:CORRection:COLLect[:ACQUire] Description: Performs a measurement of the given steps. <cal steps> is the calibration step to be performed and must be one of the following values: OPEN|SHORT|SHORT1|SHORT2|SHORT3|LOAD| THRU|ISOLation <port_no> is the port number, 1, 2, or 3. For calibration step OPEN, SHORT, SHORT1, SHORT2, SHORT3, and LOAD, valid port number is 1 or 2.
Page 162: Calibration Steps And Calibration Types
[:SENSe]:CORRection:COLLect Subsystem VNA Commands Calibration Steps and Calibration Types: For each calibration Type, the following tables (Table 3-8, Table 3-9, and Table 3-10) list the allowable calibration steps and port_no to be used in command [:SENSe]:CORRection:COLLect[:ACQUire] <cal steps>,<port_no>. The calibration steps are different for each calibration Method, and the port_no is different for each calibration Type.
Page 163: Calibration Steps And Calibration Types (Continued)
VNA Commands [:SENSe]:CORRection:COLLect Subsystem Calibration Steps and Calibration Types (continued): Table 3-9. SSLT Calibration Method Calibration Type SHORT1 SHORT2 LOAD THRU ISOL RF2P (Full 2 Port – S RFP1 (Full S - Port 1) — — RFP2 (Full S - Port 2) —...
Page 164: Calibration Steps And Calibration Types (Continued):
[:SENSe]:CORRection:COLLect Subsystem VNA Commands Calibration Steps and Calibration Types (continued): Table 3-10. SSST Calibration Method Calibration Type SHORT1 SHORT2 SHORT3 THRU ISOL RF2P (Full 2 Port – S RFP1 (Full S - Port 1) — — RFP2 (Full S - Port 2) —...
Page 165: Calibration Step Status
VNA Commands [:SENSe]:CORRection:COLLect Subsystem Calibration Step Status [:SENSe]:CORRection:COLLect:ACQUire:STATus? Description: This command requests information about the current calibration step or the specified calibration step. If no calibration step is specified, then it returns a 1 if the current calibration step has completed, otherwise it returns a 0.
Page 166: Dut Port Setup
[:SENSe]:CORRection:COLLect Subsystem VNA Commands DUT Port Setup [:SENSe]:CORRection:COLLect:CONNector<port_no> Description: Sets the connector family for the given port number. <port_no> is the port number, 1 or 2. <connector> defines the connector family and can be given in either long or short form. [connector-name] is a string that defines the name that is associated with the given <connector>...
Page 167 VNA Commands [:SENSe]:CORRection:COLLect Subsystem The tables below list the connector and valid connector name that are associated with the calibration line type COAX. Note that User cal kit and Waveguide do not have a calibration name associated with them. COAX <connector>...
Page 168 [:SENSe]:CORRection:COLLect Subsystem VNA Commands COAX <connector> [connector-name] Description KMALe TOSLK50A or K-Conn(M) TOSLK50A-20 Cal Kit: TOSLK50A-20 Query Response string: “KMAL(TOSLK50A-20)” KFEMale OSLKF50 K-Conn(F) Cal Kit: OSLKF50 If no connector-name is given, then connector will be set to this. Query response string: “KFEM” KFEMale TOSLKF50A or K-Conn(F)
Page 169 VNA Commands [:SENSe]:CORRection:COLLect Subsystem COAX <connector> [connector-name] Description SMAMale 3650 SMA(M) Cal Kit: 3650 If no connector-name is given, then connector will be set to this. Query response string: “SMAM” SMAFemale 3650 SMA(F) Cal Kit: 3650 If no connector-name is given, then connector will be set to this.
Page 170 [:SENSe]:CORRection:COLLect Subsystem VNA Commands WAVEGUIDE <connector> Description WG20 WG20/WR42/R22 Cal Kit: xxUM220 or xxUA42 Query Response string: “WG20” USR1 Query response string: “USR1” USR2 Query response string: “USR2” USR3 Query response string: “USR3” USR4 Query response string: “USR4” Syntax: [:SENSe]:CORRection:COLLect:CONNector<port_no> <connector>, [connector-name string] [:SENSe]:CORRection:COLLect:CONNector<port_no>?
Page 171: Configure Calibration Type
VNA Commands [:SENSe]:CORRection:COLLect Subsystem Configure Calibration Type [:SENSe]:CORRection:COLLect:CTYPe Description: Configures the calibration types. <cal type1> specifies the type of calibration (1-port, 2-port, response, etc) and must be one of the following values: RF2P|RFP1|RFP2|RFBP|TRFP|TRRP|TRBP|RRP1|RRP2|RRBP| |2PFP|2PRP Refer to the table of calibration types at “[:SENSe]:CORRection:COLLect:TYPE”...
Page 172: Calibration Type
[:SENSe]:CORRection:COLLect Subsystem VNA Commands Calibration Type [:SENSe]:CORRection:COLLect:TYPE Description: Compare with “[:SENSe]:CORRection:COLLect:CTYPe” on page 3-129, which has more functions than this command. This command is being kept for backwards compatibility. It configures the calibrate type. <cal type> is the calibration type and must be one of the following values: RF2P|RFP1|RFP2|RFBP|TRFP|TRRP|TRBP|RRP1|RRP2|RRBP|2PFP| 2PRP...
Page 173: Calibration Thru Line Length
VNA Commands [:SENSe]:CORRection:COLLect Subsystem Calibration Thru Line Length [SENSe:]CORRection:COLLect:EDELay:DISTance Description: Set the Calibration Thru Line Length. <line length> is in distance. Syntax: [SENSe:]CORRection:COLLect:EDELay:DISTance <line length> [:SENSe]:CORRection:COLLect:EDELay:DISTance? Cmd Parameter: <NRf> <line length> Query Response: <NR3> <line length> (returned in millimeters) Default Value: 0 Default Unit: Meter (m) when setting, millimeters (mm) for query.
Page 174: Calibration Interpolation
[:SENSe]:CORRection:COLLect Subsystem VNA Commands Calibration Thru Line Length [SENSe:]CORRection:COLLect:EDELay:TIME Description: Sets the Calibration Thru Line Delay in units of time. Syntax: [SENSe:]CORRection:COLLect:EDELay:TIME <line delay> [:SENSe]:CORRection:COLLect:EDELay:TIME? Cmd Parameter: <NRf> <line delay> Query Response: <NR3> <line delay> (time returned in nanoseconds) Range: –100 ms to +100 ms Default Value: 0 Default Unit: Seconds (s) when setting, nanoseconds (ns) for query.
Page 175: Calibration Line Type
VNA Commands [:SENSe]:CORRection:COLLect Subsystem Calibration Line Type [:SENSe]:CORRection:COLLect:MEDium Description: Sets the calibration line type. Syntax: [:SENSe]:CORRection:COLLect:MEDium COAX|WGUide [:SENSe]:CORRection:COLLect:MEDium? Cmd Parameter: <char> COAX|WGUide Query Response: <char> COAX|WGU Default Value: COAX Front Panel Access: Shift-2 (Calibrate), Line Type Calibration Method [:SENSe]:CORRection:COLLect:METHod Description: Sets the calibration method. Syntax: [:SENSe]:CORRection:COLLect:METHod SOLT|SSLT|SSST [:SENSe]:CORRection:COLLect:METHod? Parameter: SOLT|SSLT|SSST...
Page 176: Calibration Status
[:SENSe]:CORRection:COLLect Subsystem VNA Commands Calibration Status [:SENSe]:CORRection:COLLect:STATus? Description: This command requests information about the calibration status. The command returns 0 if none, 1 if calibration has already started, 2 if calibration has been aborted, 3 if a calibration is currently calculating, and 4 if a calibration has been completed.
Page 177: Calibration Type
VNA Commands [:SENSe]:CORRection:COLLect Subsystem Calibration Type [:SENSe]:CORRection:COLLect:TYPE Refer to “[:SENSe]:CORRection:COLLect:TYPE” on page 3-130. The command was moved to enable easier comparison with “[:SENSe]:CORRection:COLLect:CTYPe” on page 3-129. MS20xxC PM PN: 10580-00306 Rev. E 3-135...
Page 178: 3-27 [:Sense]:Frequency Subsystem
Query Response: <NR3> <freq> (hertz) Range: 5 kHz to 20 GHz for MS2028C, MS2038C 5 kHz to 15 GHz for MS2027C, MS2037C 5 kHz to 6 GHz for MS2026C, MS2036C Default Value: 10000002500 Hz for MS2028C, MS2038C 7500002500 Hz for MS2027C, MS2037C...
Page 179: Frequency Span
Query Response: <NR3> <freq> (hertz) Range: 0 Hz to 19999995000 Hz for MS2028C, MS2038C 0 Hz to 14999995000 Hz for MS2027C, MS2037C 0 Hz to 5999995000 GHz for MS2026C, MS2036C Default Value: 19999995000 Hz for MS2028C, MS2038C 14999995000 Hz for MS2027C, MS2037C...
Page 180: Time Suggested Frequency Span
[:SENSe]:FREQuency Subsystem VNA Commands Time Suggested Frequency Span [:SENSe]:FREQuency:TSPAn? Description: This command returns the suggested frequency span based on the start and stop time. The span returned by this command is for the Transmission or the Reflection Note (Round-Trip) response. The span for Reflection (One-Way) response is half of this value.
Page 181: Start Frequency
Query Response: <NR3> <freq> (hertz) Range: 5 kHz to 20 GHz for MS2028C, MS2038C 5 kHz to 15 GHz for MS2027C, MS2037C 5 kHz to 6 GHz for MS2026C, MS2036C Default Value: 5000 Hz Default Unit: Hz Example: Sets the start frequency to 10000 HZ:...
Page 182: Stop Frequency
Query Response: <NR3> <freq> (hertz) Range: 5 kHz to 20 GHz for MS2028C, MS2038C 5 kHz to 15 GHz for MS2027C, MS2037C 5 kHz to 6 GHz for MS2026C, MS2036C Default Value: 20000000000 Hz for MS2028C, MS2038C 15000000000 Hz for MS2027C, MS2037C...
Page 183: Get Frequency List
VNA Commands [:SENSe]:RFON[:STATe] Subsystem Get Frequency List :SENSe<Tr>:FREQuency:DATA? Description: Producers the frequency list in Hz for the given trace. <Tr> is the trace number in the range 1 to 8 (1 to 4 for Traces TR1 to TR4 and 5 to 8 for Memory M1 to M4).
Page 184: 3-29 [:Sense]:Roscillator Subsystem
[:SENSe]:ROSCillator Subsystem VNA Commands 3-29 [:SENSe]:ROSCillator Subsystem This subsystem contains commands that allow control of the reference frequency oscillator. Reference Frequency Oscillator :SENSe:ROSCillator[:SOURce] Description: Sets the reference frequency oscillator source to either INTernal or EXTernal. The query version of this command returns the string “INT” if the current reference oscillator source is set to internal and returns the string “EXT”...
Page 185: 3-30 [:Sense]:Sweep Subsystem
VNA Commands [:SENSe]:SWEep Subsystem 3-30 [:SENSe]:SWEep Subsystem This subsystem includes commands that affect the sweep parameters of the instrument. IF Bandwidth [:SENSe]:SWEep:IFBW Description: Sets the IF Bandwidth. The <freq value> in Hz must be one of the following 13 values: 100000|50000|20000|10000|5000|2000|1000|500|200| 100|50|20|10 The query form of this command returns the frequency in Hz.
Page 186: Number Of Sweep Points
[:SENSe]:SWEep Subsystem VNA Commands Number of Sweep Points [:SENSe]:SWEep:POINts Description: Sets the total number of measurement points per sweep. Note that a sweep with a lower number of data points is completed in less time than a sweep with a higher number of data points. Syntax: [:SENSe]:SWEep:POINts <integer>...
Page 187: 3-31 [:Sense]:Trace Subsystem
VNA Commands [:SENSe]:TRACe Subsystem 3-31 [:SENSe]:TRACe Subsystem This subsystem includes commands that provide general settings for each trace. Trace Domain [:SENSe]:TRACe<Tr>:DOMain Description: Defines the domain for the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 188: Trace Select
[:SENSe]:TRACe Subsystem VNA Commands Trace Select [:SENSe]:TRACe<Tr>:SELect Description: Selects the given trace, <Tr>, as the active trace. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. Note that this may also change the total number of traces.
Page 189: S Parameter
VNA Commands [:SENSe]:TRACe Subsystem S Parameter [:SENSe]:TRACe<Tr>:SPARams Description: Defines the S-parameter for the given trace, <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this command returns “S11”...
Page 190: Active Trace
:SOURce Subsystem VNA Commands Active Trace [:SENSe]:TRACe:SELect? Description: This command returns the current active trace number in the format TR#. Syntax: [:SENSe]:TRACe:SELect? Cmd Parameter: NA (query only) Query Response: <char> [TR1|TR2|TR3|TR4] Example: To query for the active trace number: :SENS:TRAC:SEL? Front Panel Access: Measure, Active Trace 3-32 :SOURce Subsystem...
Page 191: 3-33 :Source:correction:rvelocity Subsystem
VNA Commands :SOURce:CORRection:RVELocity Subsystem 3-33 :SOURce:CORRection:RVELocity Subsystem Commands in this subsystem deal with the parameters of the physical media of the Device Under Test. Propagation Velocity :SOURce:CORRection:RVELocity Description: Sets the propagation velocity of the cable for DTF measurements. Syntax: :SOURce:CORRection:RVELocity <number> :SOURce:CORRection:RVELocity? Cmd Parameter: <NRf>...
Page 192: Cutoff Freq
Cmd Parameter: <NRf> <number> (hertz) Query Response: <NR3> <number> (hertz) Range: 5 kHz to 20 GHz for MS2028C, MS2038C 5 kHz to 15 GHz for MS2027C, MS2037C 5 kHz to 6 GHz for MS2026C, MS2036C Default Value: 5000 Hz Default Unit: Hz Front Panel...
Page 193: Waveguide Loss
VNA Commands :SOURce:CORRection:RVELocity Subsystem Waveguide Loss :SOURce:CORRection:RVELocity:WGLoss Description: Sets the waveguide loss for DTF measurements. The query version of this command returns the waveguide loss in dB/m. Syntax: :SOURce:CORRection:RVELocity:WGLoss <number> :SOURce:CORRection:RVELocity:WGLoss? Cmd Parameter: <NRf> <number> (unitless) Query Response: <NR3> <number> (unitless) Range: 0.0 to 5 Default Value: 0.0 Front Panel...
Page 194: 3-34 :Status Subsystem
:STATus Subsystem VNA Commands 3-34 :STATus Subsystem The commands in this subsystem relate to the current operating state of the instrument. Query Operation Status :STATus:OPERation? Description: This command requests information about the current status of the instrument. Each bit of the return value represents some operation. Only a subset of the bits are implemented for each application.
Page 195: 3-35 :System Subsystem
VNA Commands :SYSTem Subsystem 3-35 :SYSTem Subsystem The commands in this subsystem relate to the current operating state of the instrument. Motherboard Temperature :SYSTem:MBTemperature? Description: This command returns the current mother board temperature in degrees Celsius. Syntax: :SYSTem:MBTemperature? Cmd Parameter: NA (query only) Query Response: <NR3>...
Page 196: Trace Header Transfer
Trace Subsystem VNA Commands Trace Header Transfer :TRACe:PREamble? Description: Returns trace header information for the specified trace. Data can be transferred from the 4 available display traces. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory.
Page 197: Trace Header Transfer (Continued)
VNA Commands Trace Subsystem Trace Header Transfer (continued) Table 3-12. Trace Header Parameters (Sheet 1 of 9) Parameter Name Description Instrument serial # UNIT_NAME Instrument name TYPE The data type (Setup or Data) DATE Trace date/time APP_NAME Application name APP_VER Application firmware (FW) version SUB_MODE Sub Mode type, where:...
Page 198 Trace Subsystem VNA Commands Table 3-12. Trace Header Parameters (Sheet 2 of 9) Parameter Name Description TRACE_GRAPH_TYPES Graph types for all 4 traces. This uses a bit mask shift, where the bit shift mask is defined as: GRAPH_TYPE_BIT_SHIFT 16 GRAPH_TYPE_BIT_MASK 0xFFFF DOMAIN Active Trace domain type, where: 0 is frequency domain,...
Page 199 VNA Commands Trace Subsystem Table 3-12. Trace Header Parameters (Sheet 3 of 9) Parameter Name Description SMITH_REF_IMPED Reference Impedance. Where: 50 ohm = 0. and 75 ohm = 1 This also applies to Inverted Smith Chart. TOTAL_CHANNELS Trace Format. Available trace format are: Single = 1, Dual = 2, Tri = 3, Quad = 4 ACTIVE_TRACE Current active trace.
Page 200 Trace Subsystem VNA Commands Table 3-12. Trace Header Parameters (Sheet 4 of 9) Parameter Name Description CABLE The index of the selected cable list, where 0 is the first in the list. DIST_UNITS Distance units. Available distance units are: Meter = 0, Feet = 1 IFBW The index of the selected IFBW list, where 0 is the first in the list.
Page 201 VNA Commands Trace Subsystem Table 3-12. Trace Header Parameters (Sheet 5 of 9) Parameter Name Description MARKER_READOUT_FORMAT Marker Readout Format. Available readout formats are: None = 0 Trace =1 Screen = 2 Table = 3 PORT_x_REF_PLANE_LENGTH Reference Plane Length, where x is the port number.
Page 202 Trace Subsystem VNA Commands Table 3-12. Trace Header Parameters (Sheet 6 of 9) Parameter Name Description TRACE_x_LOG_POLAR_RESOLUTION Log Polar Resolution, where x is the trace number. Returned value is in dB. TRACE_x_LOG_POLAR_REFERENCE Log Polar Reference value, where x is the trace number.
Page 203 VNA Commands Trace Subsystem Table 3-12. Trace Header Parameters (Sheet 7 of 9) Parameter Name Description TRACE_x_WINDOWING Windowing, where x is the trace number. Available windowing settings are: Rectangular = 0, Nominal Side Lobe = 1, Low Side Lobe = 2, Minimum Side Lobe = 3 TRACE_x_GD_APERTURE Group Delay Aperture, where x is the trace number.
Page 204 Trace Subsystem VNA Commands Table 3-12. Trace Header Parameters (Sheet 8 of 9) Parameter Name Description TRACE_x_IMAG_REFERENCE Imaginary Reference value, where x is the trace number. Returned value is 1000 times the reference value. TRACE_x_IMAG_REFERENCE_LINE Imaginary Reference line, where x is the trace number.
Page 205 VNA Commands Trace Subsystem Table 3-12. Trace Header Parameters (Sheet 9 of 9) Parameter Name Description PWRCAL_LOW_RF_LOW_TARGET Internal use only PWRCAL_UPPER_RF_HIGH_TARGET Internal use only PWRCAL_UPPER_RF_LOW_TARGET Internal use only PWRCAL_UW_RF_HIGH_TARGET Internal use only PWRCAL_UW_RF_LOW_TARGET Internal use only USER_DEFINED_CAL_KIT_NAME Internal use only USER_DEFINED_CAL_KIT Internal use only TRACE_LABEL_STATE...
Page 206: Trace Header Transfer (Continued)
Trace Subsystem VNA Commands Trace Header Transfer (continued) Table 3-13. Trace Header Marker Parameters Markers Parameter Name Description MKR_MWVNA_Xx Marker x X value (where x is the marker number 1 to 8) MKR_MWVNA_POINTx Marker x display point MKR_MWVNA_REALx Marker x Real value MKR_MWVNA_IMAGx Marker x Imaginary value MKR_MWVNA_READOUTx...
Page 207: Trace Header Transfer (Continued)
VNA Commands Trace Subsystem Trace Header Transfer (continued) Table 3-14. Trace Header Limits Parameters Limits Parameter Name Description LIMIT_MWVNA_FLAGS_UPx Upper(UP)/Lower(LO) Limit flags for trace x: LIMIT_MWVNA_FLAGS_LOx LIMIT_LEFT_OF_SCREEN ..0x00000001 LIMIT_RIGHT_OF_SCREEN ... 0x00000002 LIMIT_IS_ON ..... 0x00000004 LIMIT_IS_RELATIVE ..0x00000008 LIMIT_ALARM_IS_ON ..0x00000010 LIMIT_LIMIT_UNITIALIZED .
Page 208 Trace Subsystem VNA Commands 3-166 PN: 10580-00306 Rev. E MS20xxC PM...
Page 209: Chapter 4-Vector Voltmeter Commands
Chapter 4 — Vector Voltmeter Commands Introduction This chapter describes commands for Vector Voltmeter mode. Only the commands that are listed in this chapter and in Chapter 8, “All Mode Commands” can be used in Vector Voltmeter mode. Using commands from other modes may produce unexpected results. Notational conventions are described in Section 2-10 “Command and Query Notational Conventions”...
Page 210: Vvm Commands
VVM Commands Vector Voltmeter Commands VVM Commands Table 4-1. VVM Commands Subsystems Keyword Parameter Data or Units Refer to “:MMEMory:STORe Subsystem” on page 4-6 :MMEMory Refer to “:TRACe VVM Subsystem” on page 4-8 :TRACe [:SENSe] Refer to “[:SENSe]:VVM Subsystem” on page 4-11 :VVM Refer to “[:SENSe:]:VVM:CABLe Subsystem”...
Page 211: Mmemory Subsystem
Vector Voltmeter Commands :MMEMory Subsystem :MMEMory Subsystem The Mass MEMory subsystem contains functions that provide access to the instrument setup and data storage. Table 4-2. :MMEMory Subsystem Parameter Keyword Form Parameter Data or Units Notes :MMEMory Refer to “:MMEMory:LOAD Subsystem” :LOAD on page 4-4 Refer to...
Page 212: Mmemory:load Subsystem
:MMEMory:LOAD Subsystem Vector Voltmeter Commands :MMEMory:LOAD Subsystem The Mass MEMory LOAD subsystem contains commands to transfer from the mass memory device to the internal memory. Recall and Save for both setup and measurement, as described in this section, are Note specific for vector network analyzer modes, not for spectrum analyzer mode.
Page 213: Recall Measurement
Vector Voltmeter Commands :MMEMory:LOAD Subsystem Recall Measurement :MMEMory:LOAD:TRACe Description: Recalls a previously stored measurement trace from the current storage location. The saved measurement trace that is to be loaded is specified by <file name>. <file name> must be enclosed in either single quotes (‘...
Page 214: Mmemory:store Subsystem
:MMEMory:STORe Subsystem Vector Voltmeter Commands :MMEMory:STORe Subsystem The Mass MEMory STORe subsystem contains commands to transfer from the internal memory to the mass memory device. Save Setup :MMEMory:STORe:STATe Description: Stores the current setup into the file that is specified by14 <file name>.
Page 215: Save Measurement
Vector Voltmeter Commands :MMEMory:STORe Subsystem Save Measurement :MMEMory:STORe:TRACe This command is specific for vector network analyzer modes, not for spectrum Note analyzer mode. Description: Stores the trace into the file that is specified by <file name>. <file name> must be enclosed in either single quotes (‘ ’) or double quotes (“...
Page 216: Trace Vvm Subsystem
:TRACe VVM Subsystem Vector Voltmeter Commands :TRACe VVM Subsystem This subsystem contains commands pertaining to the Vector Voltmeter mode. Table 4-3. :TRACe VVM Subsystem Commands Parameter Keyword Form Parameter Data or Units Notes :TRACe <char> Returns block data Query Only :PREamble? Trace Header Transfer :TRACe:PREamble?
Page 217: Trace Header Transfer (Continued)
Vector Voltmeter Commands :TRACe VVM Subsystem Trace Header Transfer (continued) Example Response Format: [#800001070SN=83320012,UNIT_NAME=,TYPE=DATA,DATE=1999-11-30-02-00-10-10, APP_NAME=MWVNA,APP_VER=T0.00.1001,VVM_MODE=0.000000,VVM_CW_FREQ= 0.005000,VVM_MEAS_TYPE=0.000000,VVM_RETURN_MEAS_FORMAT=0.000000, VVM_CABLE=1.000000,VVM_PORT_1_SAVE_RETURN_REF=0.000000,VVM_PORT_1_ SAVE_INSERTION_REF=0.000000,VVM_PORT_2_SAVE_RETURN_REF=0.000000,VVM_ PORT_2_SAVE_INSERTION_REF=0.000000,VVM_PORT_1_RETURN_REF_AMP= 0.000000,VVM_PORT_1_RETURN_REF_PHASE=0.000000,VVM_PORT_1_RETURN_REF_ VSWR=1000.000000,VVM_PORT_1_RETURN_REF_REAL=0.000000,VVM_PORT_1_ RETURN_REF_IMAG=0.000000,VVM_PORT_1_INSERTION_REF_AMP=0.000000,VVM_ PORT_1_INSERTION_REF_PHASE=0.000000,VVM_PORT_1_RETURN_REF_RAW_ REAL=1000000.000000,VVM_PORT_1_RETURN_REF_RAW_IMAG=0.000000,VVM_PORT _2_RETURN_REF_AMP=0.000000,VVM_PORT_2_RETURN_REF_PHASE=0.000000,VVM_ PORT_2_RETURN_REF_VSWR=1000.000000,VVM_PORT_2_RETURN_REF_REAL= 0.000000,VVM_PORT_2_RETURN_REF_IMAG=0.000000,VVM_PORT_2_INSERTION_ REF_AMP=0.000000,VVM_PORT_2_INSERTION_REF_PHASE=0.000000,VVM_PORT_2_ RETURN_REF_RAW_REAL=1000000.000000, VVM_PORT_2_RETURN_REF_RAW_IMAG=0.000000, CAL_PORT=1] Trace Header Parameters Table 4-4 describes parameters that can be returned by the :TRACe:PREamble? command. Table 4-4.
Page 218 :TRACe VVM Subsystem Vector Voltmeter Commands Table 4-4. Trace Header Parameters (Sheet 2 of 2) Parameter Name Description VVM_CABLE Selected Cable number 1 to 12 VVM_PORT_X_SAVE_RETURN_REF Saved status for Port x Return reference, where x = 1 or 2 VVM_PORT_X_SAVE_INSERTION_REF Saved status for Port x Insertion reference, where x = 1 or 2 VVM_PORT_X_RETURN_REF_AMP...
Page 219: Sense]:Vvm Subsystem
Vector Voltmeter Commands [:SENSe]:VVM Subsystem [:SENSe]:VVM Subsystem This subsystem contains commands pertaining to the Vector Voltmeter mode. Table 4-5. [:SENSe]:VVM Subsystem Commands Keyword Parameter Data or Units [:SENSe] :VVM Refer to “[:SENSe:]:VVM:CABLe Subsystem” on page 4-14. :CABLe Refer to “[:SENSe]:VVM:FREQuency Subsystem” on page 4-15 :FREQuency Refer to “[:SENSe:]:VVM:REFerence Subsystem”...
Page 220: Measurement Mode
[:SENSe]:VVM Subsystem Vector Voltmeter Commands Measurement Mode [:SENSe]:VVM:MODE CW|TABLe Description: Sets the VVM measurement mode. The query format of the command returns the VVM measurement mode. Query: [:SENSe]:VVM:MODE? Syntax: [:SENSe]:VVM:MODE CW|TABLe Cmd Parameter: <char> CW|TABLe Query Response: <char> CW|TABL Default Value: CW Example: To set the mode to Table: :SENSe:VVM:MODE TABLe Front Panel...
Page 221: Measurement Type
Vector Voltmeter Commands [:SENSe]:VVM Subsystem Measurement Type [:SENSe]:VVM:TYPE RETurn|INSertion Description: Sets the VVM measurement type. The query format of the command returns the VVM measurement type. Query: [:SENSe]:VVM:TYPE? Syntax: [:SENSe]:VVM:TYPE RETurn|INSertion Parameter: RETurn|INSertion Cmd Parameter: <char> RETurn|INSertion Query Response: <char> RET|INS Default Value: RET Example: To set the type to Insertion: :SENSe:VVM:TYPE INSertion...
Page 222: Sense:]:Vvm:cable Subsystem
[:SENSe:]:VVM:CABLe Subsystem Vector Voltmeter Commands [:SENSe:]:VVM:CABLe Subsystem This subsystem contains commands to select and query the VVM cable. Cable [:SENSe]:VVM:CABLe:SELect 1|2|3|4|5|6|7|8|9|10|11|12 Description: Selects the VVM cable. The query format of the command returns the current VVM cable number. Query: [:SENSe]:VVM:CABLe:SELect? Syntax: [:SENSe]:VVM:CABLe:SELect 1|2|3|4|5|6|7|8|9|10|11|12 Cmd Parameter: <char>...
Page 223: Sense]:Vvm:frequency Subsystem
Cmd Parameter: <NRf> <freq> (hertz) Query Response: <NR3> <freq> (hertz) Range: 5 kHz to 20 GHz for MS2028C, MS2038C 5 kHz to 15 GHz for MS2027C, MS2037C 5 kHz to 6 GHz for MS2026C, MS2036C Default Value: 5000 Hz Default Unit: Hz Front Panel...
Page 224: 4-10 [:Sense:]:Vvm:reference Subsystem
[:SENSe:]:VVM:REFerence Subsystem Vector Voltmeter Commands 4-10 [:SENSe:]:VVM:REFerence Subsystem This subsystem contains commands to set and clear the reference VVM data. Clear Reference [:SENSe]:VVM:REFerence:CLEar Description: No query. Clears the reference data for the current port and measurement type. Syntax: [:SENSe]:VVM:REFerence:CLEar Cmd Parameter: NA Default Value: No Reference Example: To clear the Reference: :SENSe:VVM:REFerence:CLEar...
Page 225: Fetch:vvm Subsystem
Vector Voltmeter Commands :FETCh:VVM Subsystem 4-11 :FETCh:VVM Subsystem This subsystem contains commands to fetch the VVM reference data and relative data. Table 4-6. :FETCh:VVM Subsystem Commands Keyword Parameter Data or Units :FETCh :VVM Refer to “FETCh:VVM:REFerence Subsystem” on page 4-20 :REFerence MS20xxC PM PN: 10580-00306 Rev.
Page 226: Data
:FETCh:VVM Subsystem Vector Voltmeter Commands Data :FETCh:VVM:DATA? Description: Query only. Returns the most recent VVM measurement results. Data is returned as 2 or 4 comma-separated values depending upon the measurement type, measurement format, measurement mode, port, and the reference setting. A “–” is returned for any data that is not valid at that instance.
Page 227 Vector Voltmeter Commands :FETCh:VVM Subsystem Table 4-7. VVM Measurement Results (Sheet 2 of 2) Then Data Values If the measurement type is then data is returned as Relative Real Return, and if the 4 comma-delimited values Relative Imaginary measurement mode is CW Reference Real with save new reference set, Reference Imaginary.
Page 228: 4-12 Fetch:vvm:reference Subsystem
FETCh:VVM:REFerence Subsystem Vector Voltmeter Commands 4-12 FETCh:VVM:REFerence Subsystem This subsystem contains commands to fetch VVM reference data. Reference Data :FETCh:VVM:REFerence:DATA? Description: Query only. Returns the reference data depending upon the measurement type, the measurement format, and the current port. Syntax: :FETCh:VVM:REFerence:DATA? Query Response: NA (comma separated values) Example: To fetch the VVM reference data: :FETCh:VVM:REFerence:DATA?
Page 229: Chapter 5-Power Monitor Commands
Chapter 5 — Power Monitor Commands Introduction This chapter describes commands for Power Monitor mode. Only the commands that are listed in this chapter and in Chapter 8, “All Mode Commands” can be used in Power Monitor mode. Using commands from other modes may produce unexpected results. Notational conventions are described in Section 2-10 “Command and Query Notational Conventions”...
Page 230: Trace Power Monitor Subsystem
:TRACe Power Monitor Subsystem Power Monitor Commands :TRACe Power Monitor Subsystem This subsystem contains commands pertaining to the Vector Voltmeter mode. Trace Header Transfer :TRACe:PREamble? Description: Returns trace header information. The response begins with an ASCII header. The header specifies the number of following bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header.
Page 231: Trace Header Parameters
Power Monitor Commands :TRACe Power Monitor Subsystem Trace Header Parameters Table 5-2 describes parameters that can be returned by the :TRACe:PREamble? command. Table 5-2. Trace Header Parameters Parameter Name Description Instrument Serial # UNIT_NAME Instrument name DATE Trace date/time APP_NAME Application name APP_VER Application firmware (FW) version...
Page 232: Calculate Subsystem
:CALCulate Subsystem Power Monitor Commands :CALCulate Subsystem This subsystem contains commands for the power monitor mode. Table 5-3. :CALCulate Subsystem Keyword Parameter Data or Units :CALCulate Refer to “:CALCulate:PMONitor Subsystem” on page 5-5 :PMONitor Refer to “:CALCulate:PMONitor:RELative Subsystem” on page 5-7 :RELative Refer to “:CALCulate:PMONitor:ZERO Subsystem”...
Page 233: Calculate:pmonitor Subsystem
Power Monitor Commands :CALCulate:PMONitor Subsystem :CALCulate:PMONitor Subsystem This subsystem contains commands for the power monitor mode. Table 5-4. :CALCulate:PMONitor Subsystem Keyword Parameter Data or Units :CALCulate :PMONitor Refer to “:CALCulate:PMONitor:RELative Subsystem” on page 5-7 :RELative Refer to “:CALCulate:PMONitor:ZERO Subsystem” on page 5-8 :ZERO Offset :CALCulate:PMONitor:OFFSet...
Page 234 :CALCulate:PMONitor Subsystem Power Monitor Commands Units :CALCulate:PMONitor:UNITs Description: Sets the units to a particular type depending upon whether the relative power level is turned ON or OFF. Setting the value to DBM or to WATT when the relative power level is OFF sets the display units accordingly.
Page 235: Relative State
Power Monitor Commands :CALCulate:PMONitor:RELative Subsystem :CALCulate:PMONitor:RELative Subsystem This subsystem contains commands to turn the relative power level on and off. Relative State :CALCulate:PMONitor:RELative[:STATe] Description: Enables/disables the Relative power level. Setting the value to ON or 1 turns on the relative power level. Setting the value to OFF or 0 turns off the relative power level.
Page 236: Calculate:pmonitor:zero Subsystem
:CALCulate:PMONitor:ZERO Subsystem Power Monitor Commands :CALCulate:PMONitor:ZERO Subsystem This subsystem contains commands to turn the zero power level on/off. Zero State :CALCulate:PMONitor:ZERO[:STATe] Description: Enables and disables the Zero power level. Setting the value to ON or 1 turns On the Zero power level. Setting the value to OFF or 0 turns Off the Zero power level.
Page 237: Fetch:pmonitor Subsystem
Power Monitor Commands :FETCh:PMONitor Subsystem :FETCh:PMONitor Subsystem This subsystem contains commands to fetch the power monitor reference power level data, zero power level data and the displayed power level data. Table 5-5. :FETCh:PMONitor Subsystem Keyword Parameter Data or Units :FETCh :PMONitor Refer to “:FETCh:PMONitor:RELative Subsystem”...
Page 238: Fetch:pmonitor:relative Subsystem
:FETCh:PMONitor:RELative Subsystem Power Monitor Commands :FETCh:PMONitor:RELative Subsystem This subsystem contains commands to fetch the power monitor reference power level. Reference Power Level :FETCh:PMONitor:RELative:DATA? Description: Fetches the reference power level data. The returned value is in dBm. Syntax: :FETCh:PMONitor:RELative:DATA? Cmd Parameter: NA (query only) Query Response: <NR3>...
Page 239: 5-10 :Fetch:pmonitor:zero Subsystem
Power Monitor Commands :FETCh:PMONitor:ZERO Subsystem 5-10 :FETCh:PMONitor:ZERO Subsystem This subsystem contains commands to fetch the power monitor zero power level. Zero Power Level :FETCh:PMONitor:ZERO:DATA? Description: Fetches the zero power level data in nanowatts. The returned value is in nW (nanowatts). Syntax: :FETCh:PMONitor:ZERO:DATA? Cmd Parameter: NA (query only) Query Response: <NR3>...
Page 240 :FETCh:PMONitor:ZERO Subsystem Power Monitor Commands 5-12 PN: 10580-00306 Rev. E MS20xxC PM...
Page 241: Chapter 6-Spectrum Analyzer Commands
Chapter 6 — Spectrum Analyzer Commands Introduction This chapter describes commands for Spectrum Analyzer mode. Only the commands that are listed in this chapter and in Chapter 8, “All Mode Commands” can be used in Spectrum Analyzer mode. Using commands from other modes may produce unexpected results. Notational conventions are described in Section 2-10 “Command and Query Notational Conventions”...
Page 242: Abort Subsystem
:ABORt Subsystem Spectrum Analyzer Commands :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Description: Restarts the current sweep and/or measurement. Resets the trigger system. If :INITiate:CONTinuous is OFF (in other words, the instrument is in single sweep mode), then send the command :INITiate[:IMMediate] to trigger the next sweep.
Page 243: Move Limit To Current Center Frequency
Spectrum Analyzer Commands :CALCulate Subsystem :CALCulate Subsystem The commands in this subsystem process data that has been collected via the SENSe subsystem. Limit Alarm :CALCulate:LIMit:ALARm Description: Enables or disables the currently active limit line alarm. Setting the value to ON or 1 turns on the limit alarm. Setting the value to OFF or 0 turns off the limit alarm.
Page 244: Create Limit Envelope
:CALCulate Subsystem Spectrum Analyzer Commands Create Limit Envelope :CALCulate:LIMit:ENVelope:CREate Title: Create Limit Envelope Description: Creates a limit envelope. This generates a limit line that formed a mask just above or below the existing signals. Note that this command turns on the currently selected limit line if it is not already on. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Page 245: Number Of Limit Envelope Points
Spectrum Analyzer Commands :CALCulate Subsystem Number of Limit Envelope Points :CALCulate:LIMit:ENVelope:POINt Description: Sets the number of inflection point for the currently active limit envelope. Use :CALCulate:LIMit:TYPe to set the currently active limit line. Parameter: <number> Syntax: :CALCulate:LIMit:ENVelope:POINt <number> :CALCulate:LIMit:ENVelope:POINt? Range: 2 to 41 Default Value: 21 Example: To set the number of inflection point to 31: :CALCulate:LIMit:ENVelope:POINt 31...
Page 246: Update Limit Envelope Frequency
:CALCulate Subsystem Spectrum Analyzer Commands Update Limit Envelope Frequency :CALCulate:LIMit:ENVelope:UPDate:X Description: Updates limit envelope frequency. Note that this command is valid only if the limit envelope shape is set to a square. Use :CALCulate:LIMit:TYPe to set the currently active limit line. Syntax: :CALCulate:LIMit:ENVelope:UPDate:X Example: To adjust the envelope frequency: :CALCulate:LIMit:ENVelope:UPDate:X...
Page 247: Lower Limit Alarm
Spectrum Analyzer Commands :CALCulate Subsystem Lower Limit Alarm :CALCulate:LIMit:LOWer:ALARm Description: Enables/disables the lower limit alarm. It is a combination of the commands :CALCulate:LIMit:TYPe 1; :CALCulate:LIMit:ALARm ON|OFF. Setting the value to ON or 1 turns on the lower limit alarm. Setting the value to OFF or 0 turns off the lower limit alarm.
Page 248: Lower Limit State
:CALCulate Subsystem Spectrum Analyzer Commands Lower Limit State :CALCulate:LIMit:LOWer[:STATe] Description: Turns the lower limit line ON or OFF. It is a combination of the commands :CALCulate:LIMit:TYPe 1; :CALCulate:LIMit:STATe ON|OFF. The query version of the command returns a 1 if the lower limit line is ON and returns a 0 if OFF.
Page 249: Limit Line Type
Spectrum Analyzer Commands :CALCulate Subsystem Limit Line Type :CALCulate:LIMit:LTYPe Description: Sets the currently active limit line type. Absolutes limit lines set the limit inflection points based upon the entered frequencies for each point. Relative limit lines set the limit inflection points relative to the current center frequency.
Page 250: Delete Limit Point
:CALCulate Subsystem Spectrum Analyzer Commands Delete Limit Point :CALCulate:LIMit:POINt:DELete Description: Deletes the currently active limit point. The active point becomes the point that is immediately to the left of the point that was deleted. Note that deletion is only valid if there are more than 2 limit points. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Page 251: Limit Point X Value
Spectrum Analyzer Commands :CALCulate Subsystem Limit Point X Value :CALCulate:LIMit:POINt:X Description: Sets the location of the active limit point on the x-axis at the specified location. <x-parameter> is defined in the current x-axis. Note that this changes the Move Limit on the front panel to Point if it is currently set to Limit.
Page 252: Limit Point Y Value
:CALCulate Subsystem Spectrum Analyzer Commands Limit Point Y Value :CALCulate:LIMit:POINt:Y Description: Sets the location of the active limit point on the y-axis at the specified location. <y-parameter> is defined in the current y-axis. Note that this changes the Move Limit on the front panel to Point if it is currently set to Limit.
Page 253: Set Limit Line Upper Or Lower
Spectrum Analyzer Commands :CALCulate Subsystem Set Limit Line Upper or Lower :CALCulate:LIMit:TYPe Description: Sets the currently active limit line to either upper or lower. Subsequent limit line operations are performed on the selected limit line. Syntax: :CALCulate:LIMit:TYPe 0|1 :CALCulate:LIMit:TYPe? Cmd Parameter: <number> 0|1 (0 = upper limit line, 1 = lower limit line) Query Response: <number>...
Page 254: Upper Limit Fail State
:CALCulate Subsystem Spectrum Analyzer Commands Upper Limit Fail State :CALCulate:LIMit:UPPer:FAIL? Description: Query whether the upper limit line has failed or not. The command returns a 0 on success, returns a 1 on fail, and returns a 2 if the upper limit line is OFF or the alarm is OFF.
Page 255: Move Limit
Spectrum Analyzer Commands :CALCulate Subsystem To turn off upper limit: :CALCulate:LIMit:UPPer OFF :CALCulate:LIMit:UPPer 0 :CALCulate:LIMit:UPPer:STATe 0 Related Command: :CALCulate:LIMit[:STATe] Front Panel Access: Shift-6 (Limit), On/Off Move Limit :CALCulate:LIMit:VALue Description: Sets the currently active limit line value. This command moves an entire single or multi-segment limit line up or down by the given <value>.
Page 256: Limit X Value
:CALCulate Subsystem Spectrum Analyzer Commands Limit X Value :CALCulate:LIMit:X Description: Sets the location of the active limit line on the x-axis at the specified location. This moves the entire limit and moves the active limit point to the given value. <x-parameter> is defined in the current x-axis. Note that this changes the Move Limit on the front panel to Limit if it is currently set to Point.
Page 257: Limit Line Y Value
Spectrum Analyzer Commands :CALCulate Subsystem Limit Line Y Value :CALCulate:LIMit:Y Description: Sets the location of the active limit line on the y-axis at the specified location. This moves the entire limit and moves the current active limit point by the given value. <y-parameter> is defined in the current y-axis.
Page 258: Limit State
:CALCulate Subsystem Spectrum Analyzer Commands Limit State :CALCulate:LIMit[:STATe] Description: Turns the currently selected limit line (upper or lower) ON or OFF. If the value is set to ON or 1, then the currently selected limit line is ON. If the value is set to OFF or 0, then the currently selected limit line is OFF.
Page 259: Peak Threshold
Spectrum Analyzer Commands :CALCulate Subsystem Peak Threshold :CALCulate:MARKer:PEAK:THReshold Description: Sets the peak/valley threshold as a percentage of the display. :CALCulate:MARKer:MAXimum:LEFT and :CALCulate:MARKer:MAXimum:RIGHt use this value to determine whether a particular display point qualifies as a peak. Syntax: :CALCulate:MARKer:PEAK:THReshold <percentage> :CALCulate:MARKer:PEAK:THReshold? Cmd Parameter: <percentage>...
Page 260: Marker Table State
:CALCulate Subsystem Spectrum Analyzer Commands Marker Table State :CALCulate:MARKer:TABLe[:STATe] Description: Turns the Marker Table on or off. Setting the value to ON or 1 turns on the marker table. Setting the value to OFF or 0 turns off the marker table.
Page 261: Marker Noise
Spectrum Analyzer Commands :CALCulate Subsystem Marker Noise :CALCulate:MARKer{1|2|3|4|5|6}:DELTa:NOISe[:STATe] Description: Turns the delta marker noise on or off. Note that if counter marker is set to on when setting marker noise to on, then counter marker is set to off. This command is not valid in zero span. The query version of this command returns a 1 if the specified delta marker is noise marker and returns a 0 if not.
Page 262: Delta Marker X Value
:CALCulate Subsystem Spectrum Analyzer Commands Delta Marker X Value :CALCulate:MARKer{1|2|3|4|5|6}:DELTa:X Description: Sets the location of the delta marker on the x-axis at the specified offset location, <x-parameter>, which is the offset value from the reference marker position on the x-axis. <x-parameter> is defined in the current x-axis units.
Page 263: Delta Marker To Span
Spectrum Analyzer Commands :CALCulate Subsystem Delta Marker to Span :CALCulate:MARKer{1|2|3|4|5|6}:DELTa[:SET]:SPAN Description: Sets the total span width to the value of the specified delta marker. Note that this command is valid only if delta marker is on. Syntax: :CALCulate:MARKer{1|2|3|4|5|6}:DELTa[:SET]:SPAN Example: To set the span to the value of delta marker #4: :CALCulate:MARKer4:DELTa:SPAN Front Panel Access: Marker, More Peak Options, Delta Marker to Span...
Page 264: Marker Counter
:CALCulate Subsystem Spectrum Analyzer Commands Marker Counter :CALCulate:MARKer{1|2|3|4|5|6}:FCOunt[:STATe] Description: Turns the marker frequency counter on or off. The marker counter is turned off when the selected marker is turned off. If delta marker is on when setting marker counter to on, then delta marker is turned off. If noise marker is set to on when setting marker counter to on, then noise marker is set to off.
Page 265: Marker (Maximum) Peak Search
Spectrum Analyzer Commands :CALCulate Subsystem Marker (Maximum) Peak Search :CALCulate:MARKer{1|2|3|4|5|6}:MAXimum Description: Puts the specified marker at the maximum amplitude in the trace. Syntax: :CALCulate:MARKer{1|2|3|4|5|6}:MAXimum Front Panel Access: Marker, Marker [1/2/3/4/5/6], Peak Search Marker, Marker [1/2/3/4/5/6], More Peak Options, Peak Search Marker (Maximum) Peak Search Left :CALCulate:MARKer{1|2|3|4|5|6}:MAXimum:LEFT Description: Puts the specified marker on the next highest peak to the left of the...
Page 266: Marker (Maximum) Peak Search Right
:CALCulate Subsystem Spectrum Analyzer Commands Marker (Maximum) Peak Search Right :CALCulate:MARKer{1|2|3|4|5|6}:MAXimum:RIGHt Description: Puts the specified marker on the next highest peak to the right of the current peak. The next highest peak must be above the peak threshold. If no point meets that criterion, the marker is set to the last point on the trace.
Page 267: Marker X Value
Spectrum Analyzer Commands :CALCulate Subsystem Marker X Value :CALCulate:MARKer{1|2|3|4|5|6}:X Description: Sets the location of the marker on the x-axis at the specified location. <x-parameter> is defined in the current x-axis units. The query version of the command returns the location of the marker on the x-axis. Note that the marker is snapped to the data point closest to the specified value.
Page 268: Marker Frequency To Center
:CALCulate Subsystem Spectrum Analyzer Commands Marker Frequency to Center :CALCulate:MARKer{1|2|3|4|5|6}[:SET]:CENTer Description: Sets the center frequency equal to the frequency of the specified marker. Note that this results in a change to the start and stop frequencies and may also result in a change to the span. Note that this command is not valid in zero span.
Page 269: Configure Subsystem
Spectrum Analyzer Commands :CONFigure Subsystem :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. It sets the instrument to single sweep mode, waiting for an :INITiate command. It does not initiate the taking of a measurement.
Page 270: Configure Channel Power
:CONFigure Subsystem Spectrum Analyzer Commands Configure Channel Power :CONFigure:CHPower Description: Configures the default channel power measurement. Disables any other active one-button measurements, including ACPR, occupied bandwidth, AM/FM demodulation, and C/I. Sets the integration bandwidth equal to the span. Sets the detection method to RMS. Sets the instrument to single sweep mode (:INITiate:CONTinuous OFF).
Page 271: Configure Occupied Bandwidth
Spectrum Analyzer Commands :CONFigure Subsystem Configure Occupied Bandwidth :CONFigure:OBWidth Description: Configures the default occupied bandwidth measurement. Disables any other active one-button measurements, including channel power, ACPR, AM/FM demodulation, and C/I. Sets the method to %. Sets the % of power to 99%. Sets the instrument to single sweep mode (:INITiate:CONTinuous OFF).
Page 272: Display Subsystem
:DISPlay Subsystem Spectrum Analyzer Commands :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. Display Grid :DISPlay:GRID Description: Turns the sweep window grid lines On or Off. Syntax: :DISPlay:GRID 0|1|ON|OFF Cmd Parameter: <boolean>...
Page 273: Reference Level
Spectrum Analyzer Commands :DISPlay Subsystem Reference Level :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel Description: Sets the reference level amplitude value for the y-axis. Note that this may cause a change in attenuation if the automatic input attenuation coupling is enabled. Syntax: :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel <amplitude> :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel? Cmd Parameter: <amplitude> Query Response: <amplitude>...
Page 274: Fetch Subsystem
:FETCh Subsystem Spectrum Analyzer Commands :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They do not switch to another measurement. To make a new measurement, use the :INITiate command. To get new measurement data, use the :READ or :MEASure query commands.
Page 275: Fetch Channel Power Density
Spectrum Analyzer Commands :FETCh Subsystem Fetch Channel Power Density :FETCh:CHPower:DENSity? Description: Returns the most recent channel power density measurement result. It returns only the channel power density, not the channel power. Use :FETCh:CHPower? to get both channel power and channel power density.
Page 276: Fetch Occupied Bandwidth Frequency
:FETCh Subsystem Spectrum Analyzer Commands Fetch Occupied Bandwidth Frequency :FETCh:OBWidth:FREQuency? Description: Returns the most recent occupied bandwidth lower frequency and upper frequency. Data is returned as 2 comma-separated values: lower frequency and upper frequency in Hz. Syntax: :FETCh:OBWidth:FREQuency? Cmd Parameter: NA (query only) Default Unit: Hz Related Command: :FETCh:CHPower? :FETCh:CHPower:CHPower?
Page 277: Format Subsystem
Spectrum Analyzer Commands :FORMat Subsystem :FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, it is noted in the command description. MS20xxC PM PN: 10580-00306 Rev.
Page 278: Numeric Data Format
:FORMat Subsystem Spectrum Analyzer Commands Numeric Data Format :FORMat[:READings][:DATA] Description: This command specifies the format in which data is returned in certain commands. The optional <length> parameter is needed for REAL format only. It defines the length of the floating point number in bits. Valid values are 32 and 64.
Page 279: Initiate Subsystem
Spectrum Analyzer Commands :INITiate Subsystem :INITiate Subsystem This subsystem controls the triggering of measurements. Continuous/Single Sweep :INITiate:CONTinuous Description: Specifies whether the sweep/measurement is triggered continuously. If the value is set to ON or 1, then another sweep/measurement is triggered as soon as the current one is complete. If continuous is set to OFF or 0, then the instrument enters the “idle”...
Page 280: Trigger Sweep/Measurement
:INITiate Subsystem Spectrum Analyzer Commands Trigger Sweep/Measurement :INITiate[:IMMediate] Description: Initiates a sweep/measurement. If :INITiate:CONTinuous is set to ON, then this command is ignored. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data. When this command is sent, the “sweep complete” bit of :STATus:OPERation? is set to 0, indicating that the measurement is not complete.
Page 281: Measure Subsystem
Spectrum Analyzer Commands :MEASure Subsystem :MEASure Subsystem These commands take the instrument from its current state, enable the specified measurement, and put the instrument into single sweep mode. They correct any parameters that are invalid given the new measurement state such that a valid measurement can take place.
Page 282: Measure Channel Power
:MEASure Subsystem Spectrum Analyzer Commands Measure Channel Power :MEASure:CHPower:CHPower? Description: Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns the channel power result. To measure both channel power and channel power density, use :MEASure:CHPower? It is a combination of the commands :CONFigure:CHPower;...
Page 283: Measure Channel Power Density
Spectrum Analyzer Commands :MEASure Subsystem Measure Channel Power Density :MEASure:CHPower:DENSity? Description: Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns the channel power density result. To measure both channel power and channel power density use :MEASure:CHPower? It is a combination of the commands :CONFigure:CHPower;...
Page 284: Measure Channel Power/Density
:MEASure Subsystem Spectrum Analyzer Commands Measure Channel Power/Density :MEASure:CHPower? Description: Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement, and returns the channel power and channel power density results. It is a combination of the commands :CONFigure:CHPower; :READ:CHPower? For a description of the default channel power measurement parameters, refer to :CONFigure:CHPower.
Page 285: Measure Occupied Bandwidth
Spectrum Analyzer Commands :MEASure Subsystem Measure Occupied Bandwidth :MEASure:OBWidth? Description: Sets the active measurement to occupied bandwidth, sets the default measurement parameters, triggers a new measurement and returns the occupied bandwidth, percent of power and dB down results. It is a combination of the commands :CONFigure:OBWidth;...
Page 286: 6-10 :Mmemory Subsystem
:MMEMory Subsystem Spectrum Analyzer Commands 6-10 :MMEMory Subsystem The Mass MEMory subsystem contains functions that provide access to the instrument setup and data storage. Recall Limit :MMEMory:LOAD:LIMit Description: Recalls a previously stored limit from the current storage location. The saved limit setting that is to be loaded is specified by <file name>. <file name>...
Page 287: Recall Measurement
Spectrum Analyzer Commands :MMEMory Subsystem Recall Measurement :MMEMory:LOAD:TRACe Description: The instrument must be in the mode of the saved trace in order to recall that trace. Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current storage location.
Page 288: Save Limit
:MMEMory Subsystem Spectrum Analyzer Commands Save Limit :MMEMory:STORe:LIMit Description: Stores the current limit setup into the file specified by <file name>. <file name> should be enclosed in either single quotes (‘ ’) or double quotes (“ ”) and should not contain a file extension. Use the command :MMEMory:MSIS to set the current storage location.
Page 289: Save Measurement
Spectrum Analyzer Commands :MMEMory Subsystem Save Measurement :MMEMory:STORe:TRACe Description: Stores the trace into the file that is specified by <file name>. <file name> should be enclosed in either single quotes (‘ ’) or double quotes (“ ”) and should not contain a file extension. Use the command :MMEMory:MSIS to set the current storage location.
Page 290: Read Subsystem
:READ Subsystem Spectrum Analyzer Commands 6-11 :READ Subsystem This set of commands combines the :ABORt, :INITiate and :FETCh commands. It aborts any current triggering sequence and sets the trigger state to idle. It then initiates a new active measurement (in other words, begins the collection of new data). When the measurement is complete, it returns the result.
Page 291: Read Channel Power Density
Spectrum Analyzer Commands :READ Subsystem Read Channel Power Density :READ:CHPower:DENSity? Description: Triggers a new channel power measurement and returns the channel power density result. It is a combination of the commands :ABORT; :INITiate; :FETCh:CHPower:DENSity? It returns only the channel power density, not the channel power. Use the command :READ:CHPower? to get both channel power and channel power density.
Page 292: Read Occupied Bandwidth
:READ Subsystem Spectrum Analyzer Commands Read Occupied Bandwidth :READ:OBWidth? Description: Triggers a new occupied bandwidth measurement and returns the results: occupied bandwidth, percent of power and dB down. It is a combination of the commands :ABORT; :INITiate; :FETCh:OBWidth? The occupied bandwidth measurement must be the active measurement (specified by :CONFigure:OBWidth).
Page 293: 6-12 :Trace Subsystem
Spectrum Analyzer Commands :TRACe Subsystem 6-12 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. Trace Copy :TRACe:COPY Description: Copies Trace A to either Trace B or Trace C. Copying Trace A to Trace B is equivalent to pressing the Shift-5 (Trace), Trace B Operations, A→B on the front panel.
Page 294: Trace Header Transfer
:TRACe Subsystem Spectrum Analyzer Commands Trace Header Transfer :TRACe:PREamble? Description: Returns trace header information for the specified trace. Data can be transferred to and from the 3 available display traces. Use the commands in the :MMEMory subsystem to store and recall traces from the instrument memory.
Page 295 Spectrum Analyzer Commands :TRACe Subsystem Trace Header Parameters Table 6-2 describes parameters that can be returned by the :TRACe:PREamble? command. Table 6-2. Trace Header Parameters (Sheet 1 of 4) Parameter Name Description Instrument serial # UNIT_NAME Instrument name DESCR Trace name DATE Trace date/time BASE_VER...
Page 296 :TRACe Subsystem Spectrum Analyzer Commands Table 6-2. Trace Header Parameters (Sheet 2 of 4) Parameter Name Description TRACE_B_VIEW_NOT_BLANK: TRACE_B_WRITE_NOT_HOLD: 0x0000000000010000 0x0000000000020000 TRACE_B_DATA_VALID: TRACE_C_VIEW_NOT_BLANK: 0x0000000000040000 0x0000000100000000 TRACE_C_WRITE_NOT_HOLD: TRACE_C_DATA_VALID: 0x0000000200000000 0x0000000400000000 TRACE_C_IS_B_MINUS_A_ON: TRACE_C_IS_A_MINUS_B_ON: 0x0000001000000000 0x0000002000000000 TRACE_COUNT Number of traces averaged UI_DATA_POINTS Number of display points IMPEDANCE Input impedance REFERENCE_FREQUENCY...
Page 297 Spectrum Analyzer Commands :TRACe Subsystem Table 6-2. Trace Header Parameters (Sheet 3 of 4) Parameter Name Description ACPR_MAIN_CH_PWR ACPR measured main channel power ACPR_UPPER_CH_PWR ACPR measured upper channel power ACPR_LOWER_CH_ PWR ACPR measured lower channel power ACPR_LOWER_CH_ LINE_MARKER_INFO Mask off 16 bits at a time to get the display point location of the 2 ACPR lower channel display indicators ACPR_MAIN_CH_LINE_ MARKER_INFO...
Page 298 :TRACe Subsystem Spectrum Analyzer Commands Table 6-2. Trace Header Parameters (Sheet 4 of 4) Parameter Name Description SPA_MKR_FLAG_ON_OFF: 0x00000001 SPA_MKR_FLAG_DELTA_MKR: 0x00000002 SPA_MKR_FLAG_SELECTED: 0x00000004 SPA_MKR_FLAG_DATA_INVALID: 0x00000008 SPA_MKR_FLAG_DATA_STALE: 0x00000010 SPA_MKR_FLAG_FIXED: 0x00000020 SPA_MKR_FLAG_MASK: 0x000000FF SPA_MKR_FLAG_DISPL_AMPL_HZ: 0x00000100 SPA_MKR_FLAG_DISPL_AMPL_PER_HZ: SPA_MKR_FLAG_DISP_FLAG: 0x00000F00 0x00000200 SPA_MKR_FLAG_RELATIVE: 0x00001000 SPA_MKR_STANDARD: 0x10000000 SPA_MKR_FIELD_STRENGHT: 0x20000000 SPA_MKR_NOISE: 0x30000000 SPA_MKR_COUNTER: 0x40000000...
Page 299: Trace Data Transfer
Spectrum Analyzer Commands :TRACe Subsystem Trace Data Transfer :TRACe[:DATA] Description: This command transfers data from the controlling program to the instrument. The query form transfers trace data from the instrument to the controller. When transferred to the instrument, data is enclosed in parentheses as (<header><block>), and when transferred from the instrument, data is formatted as <header><block>.
Page 300: Trace View State
:TRACe Subsystem Spectrum Analyzer Commands Trace View State :TRACe{1|2|3}:DISPlay[:STATe] Description: Specifies whether the designated trace should be displayable (visible) or hidden. TRACe1 corresponds to Trace A, TRACe2 corresponds to Trace B, and TRACe3 corresponds to Trace C. Setting the value to ON or to 1 sets the designated trace to be visible.
Page 301: Trace Write State
Spectrum Analyzer Commands :TRACe Subsystem Trace Write State :TRACe{1|2|3}:WRITe[:STATe] Description: Specifies whether the designated trace state should be set to write or to hold. TRACe1 corresponds to Trace A, TRACe2 corresponds to Trace B, and TRACe3 corresponds to Trace C. Setting the state to ON or to 1 sets the specified trace to write.
Page 302: Trace A Operation
:TRACe Subsystem Spectrum Analyzer Commands Trace A Operation :TRACe1:OPERation Description: This command specifies how successive traces are combined to produce the resulting display values. Setting the operation to NORMal is equivalent to pressing Shift-5 (Trace), Trace A Operations, Normal→A on the front panel. This displays a trace based on the detection method selected.
Page 303: Trace B Operation
Spectrum Analyzer Commands :TRACe Subsystem Trace B Operation :TRACe2:OPERation Description: This command specifies how successive traces are combined to produce the resulting display values. Setting the operation to MAXHold is equivalent to pressing Shift-5 (Trace), Trace B Operations, Max Hold→B on the front panel. This displays the largest signal for each display point over multiple sweeps.
Page 304: Trace C Operation
:TRACe Subsystem Spectrum Analyzer Commands Trace C Operation :TRACe3:OPERation Description: This command specifies how successive traces are combined to produce the resulting display values. Setting the operation to MAXHold is equivalent to pressing Shift-5 (Trace), Trace C Operations, Max Hold→C on the front panel. This displays the largest signal for each display point over multiple sweeps.
Page 305: 6-13 :Trigger Subsystem
Spectrum Analyzer Commands :TRIGger Subsystem 6-13 :TRIGger Subsystem This subsystem contains commands related to the triggering of instrument functions for the purposes of synchronization. Related commands appear in the :ABORt and :INITiate subsystems. Trigger Source :TRIGger[:SEQuence]:SOURce Description: This command defines the trigger source. IMMediate triggering is the equivalent of free-run triggering.
Page 306: Video Trigger Position (Time)
:TRIGger Subsystem Spectrum Analyzer Commands Video Trigger Position (time) :TRIGger[:SEQuence]:VIDeo:DELay Description: This command sets the video triggering delay as either a percentage of the display or in time units. If setting the delay by time is desired, then time units must be specified when sending the command. The query version of this command returns the video triggering delay as a percentage Syntax: :TRIGger[:SEQuence]:VIDeo:DELay <percentage>...
Page 307: 6-14 :Unit Subsystem
Spectrum Analyzer Commands :UNIT Subsystem 6-14 :UNIT Subsystem The unit subsystem is used to modify the default units used for related parameters. These changes affect parameters in both commands and responses. Measurement Units :UNIT:POWer Description: Sets the default amplitude units for input, output, and display. Available units: dBm, dBV, dBmV, dBuV, V, W.
Page 308: 6-15 [:Sense] Subsystem
[:SENSe] Subsystem Spectrum Analyzer Commands 6-15 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. ACPR Adjacent Channel Bandwidth [:SENSe]:ACPower:BANDwidth|BWIDth:ADJacent Description: Sets the adjacent channel bandwidth for the ACPR measurement. Syntax: [:SENSe]:ACPower:BANDwidth|BWIDth:ADJacent <freq> [:SENSe]:ACPower:BANDwidth|BWIDth:ADJacent? Cmd Parameter: <freq> Query Response: <freq>...
Page 309: Acpr Channel Spacing
Spectrum Analyzer Commands [:SENSe] Subsystem ACPR Channel Spacing [:SENSe]:ACPower:BANDwidth|BWIDth:SPACing Description: Sets the channel spacing for the ACPR measurement. Syntax: [:SENSe]:ACPower:BANDwidth|BWIDth:SPACing <freq> [:SENSe]:ACPower:BANDwidth|BWIDth:SPACing? Cmd Parameter: <freq> Query Response: <freq> Range: 1 Hz to 9 GHz for MS2036C 1 Hz to 15 GHz for MS2037C 1 Hz to 20 GHz for MS2038C Default Value: 10.35 MHz Default Unit: Hz...
Page 310: Number Of Traces To Average
[:SENSe] Subsystem Spectrum Analyzer Commands Number of Traces to Average [:SENSe]:AVERage:COUNt Description: Sets the number of traces to average. Syntax: [:SENSe]:AVERage:COUNt <integer> [:SENSe]:AVERage:COUNt? Cmd Parameter: <integer> Query Response: <integer> Range: 2 to 65535 Default Value: 10 Front Panel Access: Shift-5 (Trace), Trace A Operations, # of Averages 6-70 PN: 10580-00306 Rev.
Page 311: Trace Mode (Normal/Average/Max Hold/Min Hold)
Spectrum Analyzer Commands [:SENSe] Subsystem Trace Mode (Normal/Average/Max Hold/Min Hold) [:SENSe]:AVERage:TYPE Description: Specifies how successive traces are combined to produce the resulting display value. Setting the TYPE to NONE is the equivalent of setting the trace mode to “Normal→A” on the front panel. The displayed value for a point is the current measured value for that point.
Page 312: Video Bandwidth
[:SENSe] Subsystem Spectrum Analyzer Commands Video Bandwidth [:SENSe]:BANDwidth|BWIDth:VIDeo Description: Sets the video bandwidth. Note that using this command turns the automatic video bandwidth setting OFF. Syntax: [:SENSe]:BANDwidth|BWIDth:VIDeo <freq> [:SENSe]:BANDwidth|BWIDth:VIDeo? Cmd Parameter: <freq> Query Response: <freq> Range: 1 Hz to 3 MHz in a 1:3 sequence Default Value: 1 MHz Default Unit: Hz Related Command: [:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO...
Page 313: Video Bandwidth To Resolution Bandwidth Ratio
Spectrum Analyzer Commands [:SENSe] Subsystem Video Bandwidth to Resolution Bandwidth Ratio [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio Description: Sets the ratio of the video bandwidth to the resolution bandwidth for use when the video-to-resolution bandwidth coupling is enabled. Note that the front panel interface sets the inverse ratio: the resolution bandwidth to the video bandwidth, which is an integer.
Page 314: Resolution Bandwidth
[:SENSe] Subsystem Spectrum Analyzer Commands Resolution Bandwidth [:SENSe]:BANDwidth|BWIDth[:RESolution] Description: Sets the resolution bandwidth. Note that using this command turns the automatic resolution bandwidth setting OFF. Syntax: [:SENSe]:BANDwidth|BWIDth[:RESolution] <freq> [:SENSe]:BANDwidth|BWIDth[:RESolution]? Cmd Parameter: <freq> Query Response: <freq> Range: 10 Hz to 3 MHz in a 1:3 sequence Default Value: 3 MHz Default Unit: Hz Related Command: [:SENSe]:BANDwidth|BWIDth[:RESolution]:AUTO...
Page 315: Resolution Bandwidth To Span Ratio
Spectrum Analyzer Commands [:SENSe] Subsystem Resolution Bandwidth to Span Ratio [:SENSe]:BANDwidth|BWIDth[:RESolution]:RATio Description: Sets the ratio of the resolution bandwidth to the span for use when the resolution-bandwidth-to-span coupling is enabled. Note that the front panel interface sets the inverse ratio: the span to the resolution bandwidth.
Page 316: Channel Power Measurement State
[:SENSe] Subsystem Spectrum Analyzer Commands Channel Power Measurement State [:SENSe]:CHPower:STATe Description: Sets the state of the channel power measurement, ON or OFF. When using :CONFigure:CHPower, the state is automatically set to ON. Syntax: [:SENSe]:CHPower:STATe OFF|ON|0|1 [:SENSe]:CHPower:STATe? Cmd Parameter: <boolean> OFF|ON|0|1 Query Response: <bNR1>...
Page 317: Input Impedance
(dBm versus dBV versus Volts, and so forth). If the value of <integer> is 50, then no correction is performed. If the value of <integer> is 75, then correction is based on Anritsu adapter 12N50-75B. To place the instrument in Other or offset mode, send a 2. After the instrument is in the “Other”...
Page 318: Detection Type
[:SENSe] Subsystem Spectrum Analyzer Commands Detection Type [:SENSe]:DETector[:FUNCtion] Description: Sets the detection method for calculating each display point. Each display point represents several measurements. The detection type determines how the display point is derived from its associated measurements. POSitive Peak detection displays the maximum value of the associated measurements.
Page 319: Center Frequency
Spectrum Analyzer Commands [:SENSe] Subsystem Center Frequency [:SENSe]:FREQuency:CENTer Description: Sets the center frequency. Note that changing the value of the center frequency changes the value of the coupled parameters: Start Frequency and Stop Frequency. It may also change the value of the span.
Page 320: Signal Standard
The list can be seen on the instrument by pressing the Signal Standard soft key in the Freq menu. The list can also be downloaded remotely and viewed by using Anritsu Master Software Tools. For example, if the desired Signal Standard is P-GSM 900 - Uplink, then the value of the <string>...
Page 321: Frequency Span - Full
Spectrum Analyzer Commands [:SENSe] Subsystem Frequency Span – Full [:SENSe]:FREQuency:SPAN:FULL Description: Sets the frequency span to full span. Note that changing the value of the frequency span changes the value of the coupled parameters, Start Frequency and Stop Frequency, and may change the Center Frequency. Syntax: [:SENSe]:FREQuency:SPAN:FULL Query Response: NA (no query) Default Value: 9 GHz for MS2036C...
Page 322: Start Frequency
[:SENSe] Subsystem Spectrum Analyzer Commands Start Frequency [:SENSe]:FREQuency:STARt Description: Sets the start frequency. Note that in the spectrum analyzer, changing the value of the start frequency changes the value of the coupled parameters, Center Frequency and Span. Syntax: [:SENSe]:FREQuency:STARt <freq> [:SENSe]:FREQuency:STARt? Cmd Parameter: <freq>...
Page 323: Stop Frequency
Spectrum Analyzer Commands [:SENSe] Subsystem Stop Frequency [:SENSe]:FREQuency:STOP Description: Sets the stop frequency. Note that in the spectrum analyzer, changing the value of the stop frequency changes the value of the coupled parameters, Center Frequency and Span. Syntax: [:SENSe]:FREQuency:STOP <freq> [:SENSe]:FREQuency:STOP? Cmd Parameter: <freq>...
Page 324: Field Strength Antenna
[:SENSe] Subsystem Spectrum Analyzer Commands Field Strength Antenna [:SENSe]:FSTRength:ANTenna Description: Selects an antenna from the antenna list to use for field strength measurement result calculations. The <antenna> argument is a 1-based index of the position of the desired antenna in the instrument current antenna list.
Page 325: Occupied Bandwidth Measurement Method
Spectrum Analyzer Commands [:SENSe] Subsystem Occupied Bandwidth Measurement Method [:SENSe]:OBWidth:METHod Description: Sets the method for calculating occupied bandwidth. XDB calculates the occupied bandwidth based on points that are a specified number of dB below the carrier. Issue command [:SENSe]:OBWidth:XDB to set the number of dB to be used.
Page 326: Occupied Bandwidth Measurement State
[:SENSe] Subsystem Spectrum Analyzer Commands Occupied Bandwidth Measurement State [:SENSe]:OBWidth:STATe Description: Sets the state of the occupied bandwidth measurement, ON or OFF. When using :CONFigure:OBWidth, the state is automatically set to Syntax: [:SENSe]:OBWidth:STATe OFF|ON|0|1 [:SENSe]:OBWidth:STATe? Cmd Parameter: <boolean> OFF|ON|0|1 Query Response: <bNR1> 0|1 Default Value: OFF Related Command: :CONFigure:OBWidth Front Panel...
Page 327: Input Attenuation
Spectrum Analyzer Commands [:SENSe] Subsystem Input Attenuation [:SENSe]:POWer[:RF]:ATTenuation Description: Sets the input attenuation. Note that issuing this command sets the automatic input attenuation OFF. Syntax: [:SENSe]:POWer[:RF]:ATTenuation <rel ampl> [:SENSe]:POWer[:RF]:ATTenuation? Cmd Parameter: <rel ampl> Query Response: <rel ampl> Range: 0 dB to 65 dB Default Value: 30 dB Default Unit: dB Related Command: [:SENSe]:POWer[:RF]:ATTenuation:AUTO...
Page 328: Preamp State
[:SENSe] Subsystem Spectrum Analyzer Commands Preamp State [:SENSe]:POWer[:RF]:GAIN[:STATe] Description: Sets the state of the preamplifier (preamp). Note that this may cause a change in the reference level or attenuation or both. Syntax: [:SENSe]:POWer[:RF]:GAIN[:STATe] OFF|ON|0|1 [:SENSe]:POWer[:RF]:GAIN[:STATe]? Cmd Parameter: <boolean> OFF|ON|0|1 Query Response: <bNR1> 0|1 Default Value: OFF Front Panel Access: Amplitude, Pre Amp...
Page 329: Minimum Sweep Time
Spectrum Analyzer Commands [:SENSe] Subsystem Minimum Sweep Time [:SENSe]:SWEep:TIME[:LLIMit] Description: Sets the value of the minimum sweep time parameter. The sweep is completed in the shortest time possible, greater than the specified time. To sweep as fast as possible, enter the minimum value that is allowed for the sweep time.
Page 330 [:SENSe] Subsystem Spectrum Analyzer Commands 6-90 PN: 10580-00306 Rev. E MS20xxC PM...
Page 331: Chapter 7-Am/Fm/Pm Commands
Chapter 7 — AM/FM/PM Commands Introduction This chapter describes commands for AM/FM/PM Analyzer mode. Only the commands that are listed in this chapter and in Chapter 8, “All Mode Commands” can be used in AM/FM/PM Analyzer mode. Using commands from other modes may produce unexpected results. Notational conventions are described in Section 2-10 “Command and Query Notational Conventions”...
Page 332: Calculate Subsystem
:CALCulate Subsystem AM/FM/PM Commands :CALCulate Subsystem The commands in this subsystem process data that has been collected via the SENSe subsystem. :CALCulate:MARKer{1|2|3|4|5|6}[:STATe] OFF|ON|0|1 :CALCulate:MARKer{1|2|3|4|5|6}[:STATe]? Title: Marker State Description: Sets the specified marker on/off. Parameter: OFF|ON|0|1 Parameter Type: <boolean> Default Value: OFF Example: To turn off reference marker #1: :CALCulate:MARKer1:STATe OFF Front Panel...
Page 333 AM/FM/PM Commands :CALCulate Subsystem :CALCulate:MARKer{1|2|3|4|5|6}:DELTa:X <x-parameter> :CALCulate:MARKer{1|2|3|4|5|6}:DELTa:X? Title: Delta Marker X Value Description: Sets the location of the delta marker on the x-axis at the specified location <x-parameter> plus the reference marker x-axis. <x-parameter> is defined in the current x-axis units. The query version of the command returns the location of the delta marker on the x-axis.
Page 334 :CALCulate Subsystem AM/FM/PM Commands :CALCulate:MARKer{1|2|3|4|5|6}:MAXimum Title: Marker (Maximum) Peak Search Description: Puts the specified marker at the maximum amplitude in the trace. Front Panel Access: Marker, Marker [1/2/3/4/5/6], Peak Search Marker, Marker [1/2/3/4/5/6], More Peak Options, Peak Search :CALCulate:MARKer{1|2|3|4|5|6}[:SET]:RLEVel Title: Marker to Reference Level Description: Sets the reference level equal to the measured amplitude of the specified marker.
Page 335 AM/FM/PM Commands :CALCulate Subsystem :CALCulate:MARKer{1|2|3|4|5|6}:Y? Title: Marker Read Y Value Description: In RF spectrum view, the value is returned in dBm. In Audio Spectrum or Audio Waveform view, the value is returned in % for AM, Hz for FM and Radians for PM. Default Unit: Current y-axis unit :CALCulate:MARKer:AOFF Title: Turn All Markers Off...
Page 336: Display Subsystem
:DISPlay Subsystem AM/FM/PM Commands :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <rel ampl> :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision? Title: Scale Description: Sets the scale (dB/division) for the y-axis in RF Spectrum view. Parameter: <rel ampl>...
Page 337: Format Subsystem
AM/FM/PM Commands :FORMat Subsystem :FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, it is noted in the command description. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,[<length>] :FORMat[:READings][:DATA]? Title: Numeric Data Format...
Page 338 :FORMat Subsystem AM/FM/PM Commands Both INTeger and REAL formats return a definite block length. Each transfer begins with an ASCII header such as #42204 for INTeger,32 and REAL,32 and #44408 for REAL,64. The first digit represents the number of following digits in the header (in this example, 4). The remainder of the header indicates the number of bytes that follow the header (in this example, 2204 for INT,32 and REAL,32 and 4408 for REAL,64).
Page 339: Initiate Subsystem
AM/FM/PM Commands :INITiate Subsystem :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate[:IMMediate] Title: Trigger Sweep/Measurement Description: Initiates a sweep/measurement. If :INITiate:CONTinuous is set to ON, this command is ignored. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data.
Page 340: Mmemory Subsystem
:MMEMory Subsystem AM/FM/PM Commands :MMEMory Subsystem The Mass MEMory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:DELete <file name> Title: Delete Setup/Measurement Description: Removes the measurement or setup file specified by <file name> from the current mass storage device.
Page 341 AM/FM/PM Commands :MMEMory Subsystem :MMEMory:LOAD:TRACe <integer>,<file name> Title: Recall Measurement Description: The instrument must be in the mode of the saved trace in order to recall that trace.Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current storage location.
Page 342 :MMEMory Subsystem AM/FM/PM Commands :MMEMory:STORe:TRACe <integer>,<file name> Title: Save Measurement Description: Stores the trace into the file specified by <file name>. <file name> should be enclosed in either single quotes (‘ ’) or double quotes (“ ”) and should not contain a file extension. Use the command MMEMory:MSIS to set the current storage location.
Page 343: Trace Subsystem
AM/FM/PM Commands :TRACe Subsystem :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe[:DATA]? Title: Trace Data Transfer Description: This command transfers data from the controlling program to the instrument. The query form transfers trace data from the instrument to the controller.
Page 344: Sense] Subsystem
[:SENSe] Subsystem AM/FM/PM Commands [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:AFPanalyzer:AVERage:COUNt <avg count> [:SENSe]:AFPanalyzer:AVERage:COUNt? Title: Measurement Average Description: Sets the average count for the measurement data in the summary mode. The query format of this command returns the value only in the summary mode.
Page 345 AM/FM/PM Commands [:SENSe] Subsystem [:SENSe]:AFPanalyzer:DEMod:TYPE AM|FM|PM [:SENSe]:AFPanalyzer:DEMod:TYPE? Title: Demodulation Type Description: This command sets the demodulation type. Parameter: AM|FM|PM Default Value: AM Example: To set the demodulation type to FM: SENSe:AFPanalyzer:DEMod:TYPE FM Front Panel Access: Setup, Demod Type [:SENSe]:AFPanalyzer:FM:SCALe <percentage> [:SENSe]:AFPanalyzer:FM:SCALe? Title: FM Y-axis reference level percentage Description: This command sets the Y-axis reference level as the percentage of the IF...
Page 346 [:SENSe] Subsystem AM/FM/PM Commands [:SENSe]:AFPanalyzer:IFBW:AUTO 0|1 [:SENSe]:AFPanalyzer:IFBW:AUTO? Title: IF bandwidth coupling Description: Sets the state of the coupling of the IF bandwidth to the span. Setting the value to 1 will result in the IF bandwidth being coupled to the span. That is, when the span changes, the IF bandwidth changes.
Page 347 AM/FM/PM Commands [:SENSe] Subsystem [:SENSe]:AFPanalyzer:SPAN <freq> [:SENSe]:AFPanalyzer:SPAN? Title: Audio Frequency Span Description: Sets the audio frequency span in the audio spectrum view. Valid values are 2 kHz, 5 kHz, 10 kHz, 20 kHz and 70 kHz. Parameter: <freq> Default Unit: Hz Front Panel Access: Shift-4 (Measure), Audio Spectrum, Span [:SENSe]:AFPanalyzer:SWEep:TIME <time>...
Page 348 Signal Standard submenu button in the Freq menu. The list can also be downloaded remotely and viewed using Anritsu Master Software Tools. For example, if the desired Signal Standard is: P-GSM 900 - Uplink then the value of the <string> would be “P-GSM 900 - Uplink”.
Page 349 AM/FM/PM Commands [:SENSe] Subsystem [:SENSe]:FREQuency:SPAN <freq> [:SENSe]:FREQuency:SPAN? Title: Frequency Span Description: Sets the frequency span. Minimum value and the maximum value are 10 kHz and 10 MHz respectively. Note that changing the value of the frequency span may change the Center Frequency. Parameter: <freq>...
Page 350 [:SENSe] Subsystem AM/FM/PM Commands [:SENSe]:FREQuency:STEP[:INCRement] <freq> [:SENSe]:FREQuency:STEP[:INCRement]? Title: Frequency Step Description: Sets the frequency step to the given frequency value. Parameter: <freq> Default Value: 1 MHz Default Unit: Hz Range: 1 Hz to 9 GHz for MS2036C 1 Hz to 15 GHz for MS2037C 1 Hz to 20 GHz for MS2038C Front Panel Access: Freq, Freq Step...
Page 351 AM/FM/PM Commands [:SENSe] Subsystem [:SENSe]:OBWidth:PERCent <percentage> [:SENSe]:OBWidth:PERCent? Title: Occupied Bandwidth Percent of Power Description: This command sets the percentage of carrier power used to measure the occupied bandwidth. This value is used in the measurement if :SENSe:OBWidth:METHod is set to PERCent. Parameter: <percentage>...
Page 352 [:SENSe] Subsystem AM/FM/PM Commands 7-22 PN: 10580-00306 Rev. E MS20xxC PM...
Page 353: Introduction
Chapter 8 — All Mode Commands Introduction The commands that are listed in this chapter are functional in the following instrument modes of operation: • Vector Network Analyzer • Spectrum Analyzer • Vector Voltmeter • Power Monitor Notational conventions are described in Section 2-10 “Command and Query Notational Conventions”...
Page 354: Instrument Subsystem
:INSTrument Subsystem All Mode Commands :INSTrument Subsystem One instrument may contain many logical instruments (“modes”). This subsystem controls the selection of the current instrument mode. Query Available Modes :INSTrument:CATalog:FULL? Description: Returns a comma-separated list of available modes. Mode names are enclosed in double quotes (“...
Page 355 Access: Shift-9 (Mode) Switching modes can take longer than 60 seconds, depending on the application. Note Anritsu Company advises you to set the remote PC time-out to 120 seconds in order to avoid unexpected time-out errors. MS20xxC PM PN: 10580-00306 Rev. E...
Page 356: Select Mode By Name
Access: Shift-9 (Mode) Switching modes can take longer than 60 seconds, depending on the application. Note Anritsu Company advises you to set the remote PC time-out to 120 seconds in order to avoid unexpected time-out errors. PN: 10580-00306 Rev. E...
Page 357: Mmemory Subsystem
All Mode Commands :MMEMory Subsystem :MMEMory Subsystem The Mass MEMory subsystem contains functions that provide access to the instrument setup and data storage. Table 8-2. :MMEMory Subsystem Parameter Keyword Form Parameter Data or Units Notes :MMEMory Refer to “:MMEMory:MSIS Subsystem” :MSIS? on page 8-7 Refer to...
Page 358: Transfer Data
:MMEMory Subsystem All Mode Commands Transfer Data :MMEMory:DATA? Description: Transfers the data stored in the given file from the instrument to the controlling program. Data is transferred in the form of <header><block>. The ASCII <header> specifies the number of data bytes. It appears as #AX, where A is the number of digits in X, and X is the number of bytes in <block>.
Page 359: Mmemory:msis Subsystem
All Mode Commands :MMEMory:MSIS Subsystem :MMEMory:MSIS Subsystem The Mass MEMory “Mass Storage IS” subsystem contains commands for selecting a mass storage device that is used by all of the :MMEMory commands. Storage Location :MMEMory:MSIS Description: Sets the storage location. Setting the storage location to INTernal sets the current storage location to be the internal memory.
Page 360: Copy To Destination
:MMEMory:MSIS Subsystem All Mode Commands Copy to Destination :MMEMory:MSIS:DESTination Description: Sets the destination to where measurements and setups in the current storage location are to be copied. Setting the location to INTernal copies the files that are stored at the current storage location into the internal memory when the command :MMEMory:MSIS:COPY is sent.
Page 361: Mmemory:store Subsystem
All Mode Commands :MMEMory:STORe Subsystem :MMEMory:STORe Subsystem The Mass MEMory STORe subsystem contains commands to transfer from the internal memory to the mass memory device. Save Screen as JPEG :MMEMory:STORe:JPEG Description: Saves the current screen measurement as a JPEG file, which is specified by <file name>...
Page 362: System Subsystem
:SYSTem Subsystem All Mode Commands :SYSTem Subsystem This subsystem contains commands that affect instrument functionality. This functionality does not directly relate to data collection, display, or transfer. Query Installed Options :SYSTem:OPTions? Description: Returns a string of the installed options. Options are separated by a “/”. The string returns “NONE”...
Page 363: Sense]:Gps Subsystem
All Mode Commands [:SENSe]:GPS Subsystem [:SENSe]:GPS Subsystem This subsystem contains commands that relate to the optional GPS (Global Positioning System) on the instrument. GPS On/Off [:SENSe]:GPS Description: Enables/disables optional GPS capability. The query version returns 0 when the GPS is Off and returns 1 when the GPS is On. Requires Option 31.
Page 364: Gps Antenna Voltage
[:SENSe]:GPS Subsystem All Mode Commands Requires Option 31. Syntax: [:SENSe]:GPS:CURRent? Cmd Parameters: NA (query only) Query Responses: <integer> Front Panel Access: Shift 8 (System), GPS, GPS Info GPS Antenna Voltage [:SENSe]:GPS:VOLTage Description: Sets and Reads the voltage setting for the GPS antenna. To set the voltage to 3.3 V, send the 0 parameter after the command.
Page 365: Fetch:gps Subsystem
All Mode Commands :FETCh:GPS Subsystem :FETCh:GPS Subsystem The commands in this subsystem return the most recent measured GPS data. Fetch GPS Fix Data :FETCh:GPS? Description: Returns the most recent GPS fix information from the optional GPS receiver. The results are returned as a set of comma-delimited values in the following format: <fix status>, <date/time>, <latitude>, <longitude>...
Page 366 :FETCh:GPS Subsystem All Mode Commands 8-14 PN: 10580-00306 Rev. E MS20xxC PM...
Page 367: Appendix A-Example
Appendix A — Example Introduction This appendix provides coding examples of C/C++ and Visual Basic, and also provides an example of reading trace data in the format that is used by LabVIEW. C/C++ This example is run on the command line. It sends the *IDN? query to the instrument and prints the response to the console.
Page 368 C/C++ Example // IdnExample.cpp : Microsoft Visual Studio-Generated Example Based on Example 2-1 in the NI-VISA User Manual Usage : IdnExample “TCPIP::xxx.xxx.xxx.xxx::inst0::INSTR” where xxx.xxx.xxx.xxx is the IP address of the instrument. Output : The string identity string returned from the instrument.
Page 369 Example C/C++ /* Store the address. */ pAddress = argv[1]; /* Begin by initializing the system*/ status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) /* Error Initializing VISA...exiting*/ printf(”Can't initialize VISA\n”); return –1; /* Open communication with TCP/IP device at xxx.xxx.xxx.xxx*/ /* NOTE: For simplicity, we will not show error checking*/ /* TODO: Add error handling.
Page 370 C/C++ Example /* Close down the system */ /* TODO: Add error handling. */ status = viClose(instr); status = viClose(defaultRM); return 0; PN: 10580-00306 Rev. E MS20xxC PM...
Page 371: Visual Basic
Example Visual Basic Visual Basic This function can be called in a Visual Basic program. It sends the *IDN? query to the instrument and returns the byte count and ASCII response string. Rem This example is based on Example 2-1 from the NI-VISA User Manual. Public Sub IdnMain(ByVal address As String, ByRef byteCount As String, ByRef returnBytes As String) Const BUFFER_SIZE = 200...
Page 372: Visual Basic
Visual Basic Example Rem Set the timeout for message-based communication Rem TODO: Add error handling. stat = viSetAttribute(sesn, VI_ATTR_TMO_VALUE, 120000) Rem Ask the device for identification Rem TODO: Add error handling. stat = viWrite(sesn, “*IDN?”, 5, retCount) stat = viRead(sesn, buffer, BUFFER_SIZE, retCount) Rem TODO: Add code to process the data.
Page 373: A-4 Visual Basic
Example Visual Basic Visual Basic This function can be called in a Visual Basic program. It demonstrates connection and setting parameters in the instrument while using Ethernet Socket protocol. Public Sub CommunicationWithTCPIPSocket() Const MAX_CNT = 200 Dim stat As Variant Dim dfltRM As Variant Dim sesn As Variant Dim retCount As Long...
Page 374 Visual Basic Example stat = viOpen(dfltRM, "TCPIP0::" & ipAddress & "::" & Port & "::SOCKET", VI_NULL, VI_NULL, sesn) Rem Set some visa attributes Rem recommandation timeout >= 90 sec stat = viSetAttribute(sesn, VI_ATTR_TMO_VALUE, 90000) stat = viSetAttribute(sesn, VI_ATTR_SEND_END_EN, VI_TRUE) Rem VI_ATTR_SUPPRESS_END_EN has to set to False during Ethernet Socket communication stat = viSetAttribute(sesn, VI_ATTR_SUPPRESS_END_EN, VI_FALSE) stat = viClear(sesn)
Page 375: Ms20Xxc Pm Pn: 10580-00306 Rev. E
Example Visual Basic stat = viWrite(sesn, sInputString, Len(sInputString), retCount) 'read back the strat frequency sInputString = ":SENSe:FREQuency:STARt?" & vbLf stat = viWrite(sesn, sInputString, Len(sInputString), retCount) Buffer = "" stat = viRead(sesn, Buffer, MAX_CNT, retCount) 'Set stop frequency sInputString = "SENSe:FREQuency:STOP 7 GHz" & vbLf stat = viWrite(sesn, sInputString, Len(sInputString), retCount) 'read back the stop frequency sInputString = ":SENSe:FREQuency:STOP?"...
Page 376: Labview
LabVIEW™ Example LabVIEW™ This example shows how to read the trace data from the instrument in 32-bit integer format. The output is an array of data point magnitudes. Figure A-1 on page A-11 shows the data capture and conversion to 32-bit integers in the format used by LabVIEW. Figure A-2 on page A-12 shows the details of the conversion.
Page 377: Ms20Xxc Pm Pn: 10580-00306 Rev. E
Example LabVIEW™ Figure A-1. Data Capture MS20xxC PM PN: 10580-00306 Rev. E A-11...
Page 378 LabVIEW™ Example Figure A-2. Data Conversion A-12 PN: 10580-00306 Rev. E MS20xxC PM...
Page 379: Appendix B-List Of All Scpi Commands
List of All SCPI Commands Appendix B — List of All SCPI Commands :ABORt..........SPA 6-2 :CALCulate:FILTer[:GATE]:COUPled[:STATe] .
Page 380 List of All SCPI Commands :CALCulate:LIMit:POINt:X ....... VNA 3-36 :CALCulate:LIMit:POINt:Y ....... . SPA 6-12 :CALCulate:LIMit:POINt:Y .
Page 381: Ms20Xxc Pm Pn: 10580-00306 Rev. E
List of All SCPI Commands :CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:STATe] ..VNA 3-55 :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum ... VNA 3-58 :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MINimum ... VNA 3-58 :CALCulate:MARKer[1]|2|3|4|5|6|7|8:TYPE .
Page 382 List of All SCPI Commands :CALCulate:MARKer{1|2|3|4|5|6}[:STATe] OFF|ON|0|1 AM/FM/PM 7-2 :CALCulate:MARKer{1|2|3|4|5|6}[:STATe] ....SPA 6-28 :CALCulate:MARKer{1|2|3|4|5|6}[:STATe]?... . AM/FM/PM 7-2 :CALCulate:MARKer<Mk>:DOMain? .
Page 383 List of All SCPI Commands :CALCulate<Tr>:FILTer[:GATE]:DISTance:SHAPe ... . . VNA 3-8 :CALCulate<Tr>:FILTer[:GATE]:DISTance:SPAN ....VNA 3-9 :CALCulate<Tr>:FILTer[:GATE]:DISTance:STARt... . . VNA 3-10 :CALCulate<Tr>:FILTer[:GATE]:DISTance:STATe.
Page 384 List of All SCPI Commands :CALCulate<Tr>:LIMit:UPPer:POINt:RIGHt....VNA 3-42 :CALCulate<Tr>:LIMit:UPPer:POINt:X ..... VNA 3-43 :CALCulate<Tr>:LIMit:UPPer:POINt:Y .
Page 385 List of All SCPI Commands :DISPlay[:WINDow]:TRACe:FORMat ......VNA 3-81 :FETCh:ACPower? ........SPA 6-34 :FETCh:CHPower:CHPower?.
Page 386 List of All SCPI Commands :INPut<port_no>:BIAS:EXTernal:CURRent? ....VNA 3-92 :INPut<port_no>:BIAS:EXTernal:VOLTage? ....VNA 3-93 :INPut<port_no>:BIAS:VOLTage.
Page 387 List of All SCPI Commands :MMEMory:STORe:STATe ......All Modes 4-6 :MMEMory:STORe:STATe ....... . . SPA 6-48 :MMEMory:STORe:TRACe .
Page 388 List of All SCPI Commands :TRACe[:DATA]? ........VNA 3-153 :TRACe[:DATA]? .
Page 389 List of All SCPI Commands [:SENSe]:AFPanalyzer:SUMMary:DATA? ....AM/FM/PM 7-17 [:SENSe]:AFPanalyzer:SWEep:TIME <time> [:SENSe]:AFPanalyzer:SWEep:TIME? ....AM/FM/PM 7-17 [:SENSe]:APPLication:TST:RESult? .
Page 390 List of All SCPI Commands [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX|WGUide :SSST:SHORt[1]|2|3 ........VNA 3-117 [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:WGUide:SSLT|SSST :FCUToff .
Page 391 List of All SCPI Commands [:SENSe]:FREQuency:SIGStandard:NAMe <string> [:SENSe]:FREQuency:SIGStandard:NAMe?... . . AM/FM/PM 7-18 [:SENSe]:FREQuency:SIGStandard:NAMe ....SPA 6-80 [:SENSe]:FREQuency:SPAN <freq>...
Page 392 List of All SCPI Commands [:SENSe]:OBWidth:STATe ....... . . SPA 6-86 [:SENSe]:OBWidth:XDB <rel ampl>...
Page 393 SCPI Commands by Mode Appendix C — SCPI Commands by Mode General Information 1 Programming with SCPI 1 VNA Commands 1 :CALCulate<Tr>:DATA? ........VNA 3-2 :CALCulate:FILTer[:GATE]:COUPled[:STATe] .
Page 394 SCPI Commands by Mode :CALCulate<Tr>:LIMit:LOWer:POINt:ADD....VNA 3-25 :CALCulate<Tr>:LIMit:LOWer:POINt:DELete ....VNA 3-25 :CALCulate<Tr>:LIMit:LOWer:POINt:LEFT .
Page 395 SCPI Commands by Mode :CALCulate:MARKer:AOFF....... . VNA 3-53 :CALCulate:MARKer:DATA? ....... VNA 3-53 :CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa:REFerence .
Page 396 SCPI Commands by Mode :CALCulate:TRANsform:TIME:WINDow ....VNA 3-76 :CALCulate<Tr>:TRANsform:DISTance:DATA? ....VNA 3-77 :CALCulate<Tr>:TRANsform:TIME:BPASs:STIMulus .
Page 397 SCPI Commands by Mode [:SENSe]:APPLication:TST:RESult? ......VNA 3-102 [:SENSe]:AVERage:CLEar ....... . VNA 3-103 [:SENSe]:AVERage:COUNt .
Page 398 SCPI Commands by Mode [:SENSe]:CORRection:COLLect:INTerpolation[:STATe] ..VNA 3-132 [:SENSe]:CORRection:COLLect:MEDium ....VNA 3-133 [:SENSe]:CORRection:COLLect:METHod ....VNA 3-133 [:SENSe]:CORRection:COLLect:SAVe .
Page 399 SCPI Commands by Mode :SOURce:CORRection:RVELocity:WGLoss ....VNA 3-151 :STATus:OPERation? ........VNA 3-152 :SYSTem:MBTemperature? .
Page 400 SCPI Commands by Mode :FETCh:PMONitor:ZERO:DATA? ......PMon 5-11 Spectrum Analyzer Commands 1 :ABORt ..........SPA 6-2 :CALCulate:LIMit:ALARm .
Page 401 SCPI Commands by Mode :CALCulate:LIMit:VALue ....... . . SPA 6-15 :CALCulate:LIMit:VERTical:ADD.
Page 402 SCPI Commands by Mode :CONFigure? ..........SPA 6-31 :DISPlay:GRID .
Page 403 SCPI Commands by Mode :TRACe:EXCHange TRACE2,TRACE3 ..... . . SPA 6-53 :TRACe:PREamble? ........SPA 6-54 :TRACe[:DATA].
Page 404 SCPI Commands by Mode [:SENSe]:FREQuency:CENTer......SPA 6-79 [:SENSe]:FREQuency:SIGStandard:CHANnel ....SPA 6-79 [:SENSe]:FREQuency:SIGStandard:NAMe.
Page 405 SCPI Commands by Mode :CALCulate:MARKer{1|2|3|4|5|6}[:SET]:RLEVel ..AM/FM/PM 7-4 :CALCulate:MARKer{1|2|3|4|5|6}:X <x-parameter> :CALCulate:MARKer{1|2|3|4|5|6}:X? ....AM/FM/PM 7-4 :CALCulate:MARKer{1|2|3|4|5|6}:Y? ....AM/FM/PM 7-5 :CALCulate:MARKer:AOFF.
Page 406 SCPI Commands by Mode [:SENSe]:AFPanalyzer:IFBW:AUTO? ....AM/FM/PM 7-16 [:SENSe]:AFPanalyzer:PM:SCALe <Radians> [:SENSe]:AFPanalyzer:PM:SCALe? ....AM/FM/PM 7-16 [:SENSe]:AFPanalyzer:RFSPectrum:DATA?.
Page 407 SCPI Commands by Mode :MMEMory:DELete........All Modes 8-6 :MMEMory:MSIS .
Page 408 SCPI Commands by Mode C-16 PN: 10580-00306 Rev. E MS20xxC PM...
Page 410 Anritsu Company 490 Jarvis Drive Anritsu utilizes recycled paper and environmentally conscious inks and toner. Morgan Hill, CA 95037-2809 http://www.anritsu.com...

This manual is also suitable for:

Ms2027c Ms2036c Ms2038c Ms2037c Ms2028c

Anritsu MS2026C Programming Manual

Chapter 1-General Information

Chapter 2-Programming With SCPI

Chapter 3 -VNA Commands

Chapter 4-Vector Voltmeter Commands

Chapter 5-Power Monitor Commands

Quick Links

Related Manuals for Anritsu MS2026C

Summary of Contents for Anritsu MS2026C