R&S®FSH4/8/13/20
Remote Control via LAN or USB
Software Manual
1173.0089.12 – 33
The Software Manual describes the following R&S®FSH options
● R&S FSH-K40 (1304.5606.02)
The contents are for R&S FSH models:
− R&S FSH4 (1309.6000.04)
− R&S FSH4 (1309.6000.14)
− R&S FSH4 (1309.6000.24)
− R&S FSH8 (1309.6000.08)
− R&S FSH8 (1309.6000.18)
− R&S FSH8 (1309.6000.28)
− R&S FSH13 (1314.2000.13)
− R&S FSH13 (1314.2000.23)
− R&S FSH20 (1314.2000.20)
− R&S FSH20 (1314.2000.30)
− R&S FSH4 (1309.6000.54, equivalent to 1309.6000.04)
− R&S FSH4 (1309.6000.64, equivalent to 1309.6000.14)
− R&S FSH4 (1309.6000.74, equivalent to 1309.6000.24)
− R&S FSH8 (1309.6000.58, equivalent to 1309.6000.08)
− R&S FSH8 (1309.6000.68, equivalent to 1309.6000.18)
− R&S FSH8 (1309.6000.78, equivalent to 1309.6000.28)
− R&S FSH13 (1314.2000.63, equivalent to 1314.2000.13)
− R&S FSH13 (1314.2000.73, equivalent to 1314.2000.23)
− R&S FSH20 (1314.2000.70, equivalent to 1314.2000.20)
− R&S FSH20 (1314.2000.80, equivalent to 1314.2000.30)
The manual also covers the following firmware options:
− R&S FSH-K10 (1304.5864.02)
− R&S FSH-K41 (1304.5612.02)
− R&S FSH-K42 (1309.5629.02)
− R&S FSH-K43 (1304.5635.02)
− R&S FSH-K44 (1309.5658.02)
− R&S FSH-K44(E) (1304.5758.02)
− R&S FSH-K45 (1309.5641.02)
− R&S FSH-K46 (1304.5729.02)
− R&S FSH-K46E (1304.5764.02)
− R&S FSH-K47 (1304.5787.02)
− R&S FSH-K47E (1304.5806.02)
− R&S FSH-K48 (1304.5887.02)
− R&S FSH-K48E (1304.5858.02)
− R&S FSH-K50 (1304.5735.02)
− R&S FSH-K50E (1304.5793.02)
− R&S FSH-K51 (1304.5812.02)
− R&S FSH-K51E (1304.5829.02)
− R&S FSH-K56 (1318.6100.02)
The contents of this manual correspond to firmware version 3.40 or higher.
© 2022 Rohde & Schwarz GmbH & Co. KG
Muehldorfstr. 15, 81671 Munich. Germany
Phone: +49 89 4129-0
E-mail: info@rohde-schwarz.com
Internet: http://www.rohde-schwarz.com
Subject to change – Data without tolerance limits is not binding.
R&S® is a registered trademark of Rohde & Schwarz GmbH & Co. KG.
Trade names are trademarks of the owners.
1173.0089.12 | Version 33 | R&S®FSH
Throughout this manual, products from Rohde & Schwarz are indicated without the ® symbol , e.g. R&S®FSH is indicated as
R&S FSH.
R&S FSH Table of Contents
Software Manual 1173.0089.12 - 33 1
Table of Contents
Documentation Overview ................................................................... 9
1 Introduction ....................................................................................... 11
2 Interfaces and Protocols .................................................................. 12
2.1 LAN Interface ..............................................................................................................13
2.2 USB Interface .............................................................................................................13
2.3 Protocols ....................................................................................................................14
3 Setting Up the Remote Control Connection ................................... 16
3.1 Preparing for Remote Control ..................................................................................16
4 Instrument Model and Command Processing ................................ 17
4.1 Input Unit ....................................................................................................................17
4.2 Command Recognition .............................................................................................18
4.3 Data Base and Instrument Hardware .......................................................................18
4.4 Status Reporting System ..........................................................................................19
4.5 Output Unit .................................................................................................................19
5 SCPI Command Structure and Syntax ............................................ 20
5.1 Structure of a Command ...........................................................................................20
5.1.1 Common Commands ...................................................................................................20
5.1.2 Device-Specific Commands .........................................................................................21
5.1.2.1 Hierarchy ......................................................................................................................21
5.1.2.2 Multiple Keywords ........................................................................................................21
5.1.2.3 Optional Keywords .......................................................................................................22
5.1.2.4 Long and Short Form ...................................................................................................22
5.1.2.5 Parameter ....................................................................................................................23
5.1.2.6 Special Characters.......................................................................................................23
5.1.2.7 Numeric Suffix ..............................................................................................................24
5.1.3 Overview of Syntax Elements ......................................................................................25
5.2 Parameters .................................................................................................................26
5.2.1 Numeric Values ............................................................................................................26
5.2.2 Special Numeric Values ...............................................................................................26
5.2.3 Boolean Parameters ....................................................................................................27
R&S FSH Table of Contents
Software Manual 1173.0089.12 - 33 2
5.2.4 Text ..............................................................................................................................27
5.2.5 Strings ..........................................................................................................................27
5.2.6 Block Data ....................................................................................................................28
5.3 Structure of a Program Message .............................................................................29
5.4 Responses to Queries ...............................................................................................30
6 Command Sequence and Command Synchronization .................. 31
7 Remote Control – Commands ......................................................... 32
7.1 Common Commands .................................................................................................33
7.2 Remote Commands of the Spectrum Analyzer ......................................................36
7.2.1 Configuring the Horizontal Axis ...................................................................................37
7.2.2 Configuring the Vertical Axis ........................................................................................43
7.2.3 Setting the Bandwidths ................................................................................................50
7.2.4 Performing and Triggering Measurements ..................................................................52
7.2.4.1 Performing the Measurement ......................................................................................52
7.2.4.2 Capturing I/Q Data .......................................................................................................55
7.2.4.3 Triggering Measurements ............................................................................................57
7.2.5 Working with Traces ....................................................................................................61
7.2.6 Using Markers ..............................................................................................................67
7.2.6.1 Markers and Delta Markers .........................................................................................67
7.2.6.2 Marker Functions .........................................................................................................75
7.2.7 Using Display Lines and Limit Lines ............................................................................83
7.2.7.1 Display Lines ................................................................................................................83
7.2.7.2 Limit Lines ....................................................................................................................84
7.2.8 Configuring and Using Measurement Functions .........................................................89
7.2.8.1 Working with Channel Tables ......................................................................................89
7.2.8.2 Power Measurements ..................................................................................................92
7.2.8.3 Measuring the Channel Power ....................................................................................96
7.2.8.4 Measuring the Occupied Bandwidth ............................................................................97
7.2.8.5 TDMA Measurements ..................................................................................................98
7.2.8.6 Measuring the Adjacent Channel Leakage Ratio ........................................................99
7.2.8.7 Measuring the Harmonic Distortion ...........................................................................112
7.2.8.8 Measuring the AM Modulation Depth ........................................................................114
7.2.8.9 Measuring the Spectrum Emission Mask ..................................................................116
R&S FSH Table of Contents
Software Manual 1173.0089.12 - 33 3
7.2.8.10 Measuring Spurious Emissions .................................................................................118
7.2.8.11 Using the Segmented Sweep ....................................................................................119
7.2.8.12 Using an Isotropic Antenna ........................................................................................120
7.3 Remote Commands of the Network Analyzer Mode ............................................122
7.3.1 Configuring the Horizontal Axis .................................................................................122
7.3.2 Configuring the Vertical Axis ......................................................................................123
7.3.3 Configuring the Tracking Generator ..........................................................................131
7.3.4 Setting the Bandwidths ..............................................................................................134
7.3.5 Performing and Triggering the Measurement ............................................................134
7.3.6 Working with Traces ..................................................................................................135
7.3.7 Using Markers and Deltamarkers ..............................................................................137
7.3.7.1 Markers and Deltamarkers ........................................................................................137
7.3.7.2 Marker Functions .......................................................................................................139
7.3.8 Configuring the Measurement ...................................................................................141
7.3.8.1 Selecting the Measurement Port ...............................................................................141
7.3.8.2 Selecting the Measurement Mode .............................................................................142
7.3.8.3 Calibrating the Measurement .....................................................................................142
7.3.8.4 Selecting the Result Display ......................................................................................145
7.3.8.5 Selecting the Measurement Format...........................................................................146
7.3.8.6 Configuring the Vector Voltmeter (option R&S FSH-K45) .........................................150
7.4 Remote Commands of the Power Meter ................................................................153
7.4.1 Using Power Sensors ................................................................................................153
7.4.1.1 Setting the Frequency ................................................................................................153
7.4.1.2 Configuring Power Level Readout .............................................................................154
7.4.1.3 Defining the Measurement Time ................................................................................156
7.4.1.4 Zeroing of the Power Sensor .....................................................................................157
7.4.1.5 Forward Power Display ..............................................................................................157
7.4.1.6 Defining the Video Bandwidth ....................................................................................158
7.4.1.7 Reading Out Measurement Results...........................................................................158
7.4.1.8 Selecting a Telecommunication Standard .................................................................159
7.5 Remote Commands of the Distance-to-Fault Mode .............................................161
7.5.1 Configuring the Horizontal Axis .................................................................................162
7.5.2 Configuring the Vertical Axis ......................................................................................163
R&S FSH Table of Contents
Software Manual 1173.0089.12 - 33 4
7.5.3 Configuring the Tracking Generator ..........................................................................163
7.5.4 Setting the Bandwidth ................................................................................................163
7.5.5 Performing and Triggering Measurements ................................................................165
7.5.5.1 Performing the Measurement ....................................................................................165
7.5.6 Working with Traces ..................................................................................................166
7.5.7 Using Markers ............................................................................................................168
7.5.8 Using Limit Lines........................................................................................................169
7.5.9 Configuring and Using Measurement Functions .......................................................170
7.5.9.1 Selecting the Cable Characteristics ...........................................................................170
7.5.9.2 Selecting the Measurement Mode .............................................................................171
7.5.9.3 Reading Out Measurement Results...........................................................................171
7.5.9.4 Calibrating the Measurement .....................................................................................172
7.5.9.5 Working with a DTF List .............................................................................................174
7.6 Remote Commands of the Receiver Mode ............................................................177
7.6.1 Configuring the Horizontal Axis .................................................................................178
7.6.2 Configuring the Vertical Axis ......................................................................................180
7.6.3 Setting the Bandwidth ................................................................................................181
7.6.4 Performing and Triggering the Measurement ............................................................182
7.6.4.1 Performing the Measurement ....................................................................................182
7.6.4.2 Triggering Measurements ..........................................................................................182
7.6.4.3 Using an Isotropic Antenna ........................................................................................183
7.6.5 Working with Traces ..................................................................................................184
7.6.6 Using Markers ............................................................................................................186
7.6.6.1 Markers and Delta Markers .......................................................................................186
7.6.6.2 Marker Functions .......................................................................................................186
7.6.7 Using Limit Lines........................................................................................................187
7.7 Remote Commands of the Digital Modulation Analyzer ......................................188
7.7.1 Performing Measurements on GSM Signals .............................................................189
7.7.1.1 Setting the Frequency ................................................................................................189
7.7.1.2 Setting Amplitude Parameters ...................................................................................189
7.7.1.3 Setting the Bandwidths ..............................................................................................190
7.7.1.4 Working with Traces ..................................................................................................190
7.7.1.5 Performing and Triggering the Measurement ............................................................190
R&S FSH Table of Contents
Software Manual 1173.0089.12 - 33 5
7.7.1.6 Using Markers ............................................................................................................191
7.7.1.7 Working with Channel Tables ....................................................................................191
7.7.1.8 Selecting the Result Display ......................................................................................191
7.7.1.9 Configuring the Measurement ...................................................................................193
7.7.1.10 Getting Measurement Results ...................................................................................194
7.7.1.11 Analyzing Measurement Results ...............................................................................202
7.7.2 Performing Measurements on 3GPP WCDMA Signals .............................................203
7.7.2.1 Setting the Frequency ................................................................................................203
7.7.2.2 Setting Amplitude Parameters ...................................................................................203
7.7.2.3 Setting the Bandwidths ..............................................................................................204
7.7.2.4 Working with Traces ..................................................................................................204
7.7.2.5 Performing and Triggering the Measurement ............................................................204
7.7.2.6 Using Markers ............................................................................................................204
7.7.2.7 Working with Channel Tables ....................................................................................205
7.7.2.8 Selecting the Result Display ......................................................................................205
7.7.2.9 Configuring the Measurement ...................................................................................206
7.7.2.10 Determining Scrambling Codes .................................................................................208
7.7.2.11 Performing a Channel Search ...................................................................................212
7.7.2.12 Using An Isotropic Antenna .......................................................................................212
7.7.2.13 Getting Measurement Results ...................................................................................212
7.7.2.14 Analyzing Measurement Results ...............................................................................215
7.7.2.15 Return Value Codes ..................................................................................................216
7.7.3 Performing Measurements on CDMA2000 Signals ...................................................218
7.7.3.1 Setting the Frequency ................................................................................................218
7.7.3.2 Setting Amplitude Parameters ...................................................................................218
7.7.3.3 Setting the Bandwidths ..............................................................................................219
7.7.3.4 Working with Traces ..................................................................................................219
7.7.3.5 Performing and Triggering the Measurement ............................................................219
7.7.3.6 Using Markers ............................................................................................................220
7.7.3.7 Working with Channel Tables ....................................................................................220
7.7.3.8 Selecting the Result Display ......................................................................................221
7.7.3.9 Configuring the Measurement ...................................................................................222
7.7.3.10 Getting Measurement Results ...................................................................................224
R&S FSH Table of Contents
Software Manual 1173.0089.12 - 33 6
7.7.3.11 Return Value Codes ..................................................................................................226
7.7.4 Performing Measurements on 1xEV-DO Signals ......................................................227
7.7.4.1 Setting the Frequency ................................................................................................227
7.7.4.2 Setting Amplitude Parameters ...................................................................................227
7.7.4.3 Setting the Bandwidths ..............................................................................................228
7.7.4.4 Working with Traces ..................................................................................................228
7.7.4.5 Performing and Triggering the Measurement ............................................................228
7.7.4.6 Using Markers ............................................................................................................229
7.7.4.7 Working with Channel Tables ....................................................................................229
7.7.4.8 Selecting the Result Display ......................................................................................230
7.7.4.9 Configuring the Measurement ...................................................................................230
7.7.4.10 Getting Measurement Results ...................................................................................231
7.7.5 Performing Measurements on TD-SCDMA Signals ..................................................235
7.7.5.1 Setting the Frequency ................................................................................................235
7.7.5.2 Setting Amplitude Parameters ...................................................................................235
7.7.5.3 Setting the Bandwidths ..............................................................................................236
7.7.5.4 Working with Traces ..................................................................................................236
7.7.5.5 Performing and Triggering the Measurement ............................................................236
7.7.5.6 Using Markers ............................................................................................................237
7.7.5.7 Working with Channel Tables ....................................................................................237
7.7.5.8 Selecting the Result Display ......................................................................................237
7.7.5.9 Configuring the Measurement ...................................................................................238
7.7.5.10 Getting Measurement Results ...................................................................................242
7.7.5.11 Return Value Codes ..................................................................................................245
7.7.6 Performing Measurements on LTE Signals ...............................................................246
7.7.6.1 Setting the Frequency ................................................................................................246
7.7.6.2 Setting Amplitude Parameters ...................................................................................248
7.7.6.3 Working with Traces ..................................................................................................248
7.7.6.4 Performing and Triggering the Measurement ............................................................249
7.7.6.5 Selecting the Result Display ......................................................................................249
7.7.6.6 Configuring the Measurement ...................................................................................250
7.7.6.7 Using An Isotropic Antenna .......................................................................................257
7.7.6.8 Getting Measurement Results ...................................................................................257
R&S FSH Table of Contents
Software Manual 1173.0089.12 - 33 7
7.7.6.9 Using the TRACe[:DATA] Command .........................................................................266
7.7.7 Performing Measurements on NB-IoT Signals ..........................................................268
7.7.7.1 Setting the Frequency ................................................................................................268
7.7.7.2 Setting Amplitude Parameters ...................................................................................268
7.7.7.3 Working with Traces ..................................................................................................269
7.7.7.4 Performing and Triggering the Measurement ............................................................269
7.7.7.5 Selecting the Result Display ......................................................................................270
7.7.7.6 Configuring the Measurement ...................................................................................270
7.7.7.7 Getting Measurement Results ...................................................................................276
7.7.7.8 Using the TRACe[:DATA] Command .........................................................................281
7.8 File Management ......................................................................................................283
7.9 Making and Storing Screenshots ...........................................................................291
7.10 Configuring Data Capture .......................................................................................293
7.11 Saving Events ..........................................................................................................295
7.12 Configuring the Instrument ....................................................................................298
7.12.1 Mode Selection ..........................................................................................................298
7.12.2 Controlling the GPS Receiver ....................................................................................300
7.12.3 Controlling a Precision Frequency Reference (R&S FSH-Z114) ..............................305
7.12.4 Display Configuration .................................................................................................307
7.12.5 Audio Settings ............................................................................................................309
7.12.6 Setting up a Network Connection ..............................................................................311
7.12.7 System Settings .........................................................................................................314
7.13 Status Reporting System ........................................................................................325
7.13.1 Structure of an SCPI Status Register ........................................................................325
7.13.1.1 CONDition part ...........................................................................................................325
7.13.1.2 PTRansition part ........................................................................................................326
7.13.1.3 NTRansition part ........................................................................................................326
7.13.1.4 EVENt part .................................................................................................................326
7.13.1.5 ENABle part ...............................................................................................................326
7.13.1.6 Sum bit .......................................................................................................................327
7.13.2 Overview of the Status Register ................................................................................327
7.13.3 Status Byte (STB) & Service Request Enable Register (SRE) .................................329
7.13.4 Event Status Register (ESR) and Event Status Enable Register (ESE) ...................330
R&S FSH Table of Contents
Software Manual 1173.0089.12 - 33 8
7.13.4.1 STATus:OPERation Register ....................................................................................331
7.13.4.2 STATus:QUEStionable Register ................................................................................331
7.13.4.3 STATus:QUEStionable:FREQuency Register ...........................................................332
7.13.4.4 STATus:QUEStionable:LIMit Register .......................................................................332
7.13.4.5 STATus:QUEStionable:POWer Register ...................................................................332
7.13.5 Application of the Status Reporting Systems ............................................................333
7.13.5.1 Service Request .........................................................................................................333
7.13.5.2 Serial Poll ...................................................................................................................333
7.13.5.3 Query by Means of Commands .................................................................................334
7.13.5.4 Error Queue Query ....................................................................................................334
7.13.6 Reset Values of the Status Reporting System ..........................................................335
7.13.7 Remote Commands of the Status Reporting System ................................................336
Alphabetical List of Remote Commands ...................................... 341
Index ................................................................................................ 353
R&S FSH Documentation Overview
Software Manual 1173.0089.12 - 33 9
Documentation Overview
The user documentation for the R&S FSH is divided as follows:
Quick Start Guide
The Quick Start Guide provides basic information on the instrument's functions.
It covers the following topics:
● overview of all elements of the front and rear panels
● basic information on how to set up the R&S FSH
● information on how to operate the R&S FSH in a network
● instructions on how to perform measurements
Operating Manual
The Operating Manual provides a detailed description on the instrument's functions
It covers the following topics:
● instructions on how to set up and operate the R&S FSH in its various operating
modes
● instructions on how to perform measurements with the R&S FSH
● instructions on how to work with the available software options and applications
Service Manual
The Service Manual provides information on maintenance.
It covers the following topics:
● instructions on how to perform a performance test
● instructions on how to repair the R&S FSH including a spare parts list
● mechanical drawings
Release Notes
The release notes describe the installation of the firmware, new and modified
functions, eliminated problems, and last minute changes to the documentation. The
corresponding firmware version is indicated on the title page of the release notes. The
current release notes are provided on the internet.
Internet Site
The internet site at: http://www.rohde-schwarz.com/product/fsh.html provides the most
up to date information on the R&S FSH. The most recent manuals are available as
printable PDF files in the download area.
Also provided for download are firmware updates including the corresponding release
notes, instrument drivers, current data sheets, application notes and image versions.
R&S FSH Documentation Overview
Software Manual 1173.0089.12 - 33 10
Calibration Certificate
The calibration certificates of your device are available online. Visit the R&S FSH
product page and select the item to download the calibration certificate. You will
be forwarded to a Gloris page.
https://gloris.rohde-schwarz.com/calcert
Enter the device ID of your R&S FSH and download the certificate. You can find the
device ID either in the "Setup" menu or on the label on the rear panel.
R&S FSH Introduction
LAN Interface
Software Manual 1173.0089.12 - 33 11
1 Introduction
With the software application R&S FSH-K40 installed on the instrument, it is possible
to operate your R&S FSH via remote control. In this manual you will find all information
necessary to remotely control the R&S FSH.
Enabling the Option
The Remote Control Option R&S FSH-K40 is enabled by entering a key code. The key
code is based on the unique serial number of the instrument. To retrofit an option,
enable it with a key code.
► Press the SETUP key.
► Press the "Installed Options" softkey
► Select "Install Option..." under the "Option Administration" header.
► Confirm with ENTER.
An entry box in the lower right corner of the screen is displayed.
► Type in the the appropriate option key.
► Confirm with ENTER.
If the correct key code is entered, the R&S FSH displays
If an invalid key code is entered, the R&S FSH displays
R&S FSH Interfaces and Protocols
LAN Interface
Software Manual 1173.0089.12 - 33 12
2 Interfaces and Protocols
The R&S FSH supports two different interfaces for remote control.
● LAN Interface: The protocol is based on TCP/IP and supports the VXI-11 standard.
● USB Interface
The connectors are located at the side of the instrument and permit a connection to a
controller for remote control via a local area network (LAN) or directly via USB.
SCPI
SCPI (Standard Commands for Programmable Instruments) commands - messages are used for remote control. Commands that are not taken from the SCPI standard
follow the SCPI syntax rules. The instrument supports the SCPI version 1999. The
SCPI standard is based on standard IEEE 488.2 and aims at the standardization of
device-specific commands, error handling and the status registers. The tutorial
"Automatic Measurement Control - A tutorial on SCPI and IEEE 488.2" from John M.
Pieper (R&S order number 0002.3536.00) offers detailed information on concepts and
definitions of SCPI.
The requirements that the SCPI standard places on command syntax, error handling
and configuration of the status registers are explained in detail in the following
sections. Tables provide a fast overview of the bit assignment in the status registers.
The tables are supplemented by a comprehensive description of the status registers.
VISA
VISA is a standardized software interface library providing input and output functions to
communicate with instruments. The I/O channel (LAN or USB) is selected at
initialization time by means of a channel-specific resource string. For more information
about VISA refer to its user documentation.
The programming examples for remote control are all written in Microsoft® VISUAL
BASIC®. Access to the VISA functions require the declaration of the functions and
constants prior to their use in the project. This can be accomplished either by adding
the modules VISA32.BAS and VPPTYPE.BAS or a reference to the VISA32.DLL to the
project.
R&S FSH Interfaces and Protocols
LAN Interface
Software Manual 1173.0089.12 - 33 13
The modules visa32.bas and vpptype.bas can be found in the following location:
<VXIpnpPath>\WinNT\include (typically C:\VXIpnp\WinNt\include).
Resetting the R&S FSH
Manual operation is designed for maximum possible operating convenience. In
contrast, the priority of remote control is the "predictability" of the device status.
Therefore, control programs should always define an initial device status (e.g. with the
command *RST) and then implement the required settings.
2.1 LAN Interface
To be integrated in a LAN, the instrument is equipped with a standard LAN interface,
consisting of a connector, a network interface and protocols (VXI-11).
Instrument access via VXI-11 is usually achieved from high level programming
platforms by using VISA as an intermediate abstraction layer. VISA encapsulates the
low level VXI-11 (LAN) or USB function calls and thus makes the transport interface
transparent for the user. The necessary VISA library is available as a separate product.
For details contact your local R&S sales representative.
2.2 USB Interface
For remote control via the USB connection, the PC and the instrument must be
connected via the USB interface. The required driver comes with the
R&S InstrumentView software package and is automatically installed on the PC with
the software package.
The driver adresses the instrument via the USB interface with the fix IP address
172.16.10.10.
In addition, a remote control connection via the SCPI interface requires the VISA
library to be installed on the PC.
R&S FSH Interfaces and Protocols
Protocols
Software Manual 1173.0089.12 - 33 14
2.3 Protocols
VXI-11 Basics
The VXI-11 standard is based on the ONC-RPC protocol which in turn relies on TCP/IP
as the network/transport layer. The TCP/IP network protocol and the associated
network services are preconfigured. TCP/IP ensures connection-oriented
communication, where the order of the exchanged messages is adhered to and
interrupted links are identified. With this protocol, messages cannot be lost.
Remote control of an instrument via a network is based on standardized protocols
which follow the OSI reference model (see Fig. below).
Application SCPI
Presentation
Session
Transport
Network
Data Link
Physical
XDR (VXI-11)
ONC-RPC
TCP / UDP
IP
Ethernet/802.3
802.3/10BASE-T
Figure 2-1: Example for LAN remote control based on the OSI reference model
Based on TCP/UDP, messages between the controller and the instrument are
exchanged via open network computing (ONC) - remote procedure calls (RPC). With
XDR (VXI-11), legal RPC messages are known as VXI-11 standard. Based on this
standard, messages are exchanged between the controller and the instrument. The
messages are identical with SCPI commands. They can be organized in four groups:
● program messages (control command to the instrument)
● response messages (values returned by the instrument)
● service request (spontaneous queries of the instrument)
● low-level control messages (interface messages).
A VXI-11 link between a controller and an instrument uses three channels: core, abort
and interrupt channel. Instrument control is mainly performed on the core channel
(program, response and low-level control messages). The abort channel is used for
immediate abort of the core channel; the interrupt channel transmits spontaneous
service requests of the instrument. Link setup itself is very complex. For more details
refer to the VXI-11 specification.
R&S FSH Interfaces and Protocols
Protocols
Software Manual 1173.0089.12 - 33 15
Instrument
Core channel
(program, response,
control messages)
Abort channel (abort)
Interrupt channel
(service request)
Controller
Figure 2-2: VXI-11 channels between instrument and controller
The number of controllers that can address an instrument is practically unlimited in the
network. In the instrument, the individual controllers are clearly distinguished. This
distinction continues up to the application level in the controller, i.e. two applications on
a computer are identified by the instrument as two different controllers.
Controller
Controller
Controller
Instrument
Figure 2-3: Remote control via LAN from several controllers
The controllers can lock and unlock the instrument for exclusive access. This regulates
access to the instrument of several controllers.
R&S FSH Setting Up the Remote Control Connection
Preparing for Remote Control
Software Manual 1173.0089.12 - 33 16
3 Setting Up the Remote Control Connection
3.1 Preparing for Remote Control
The short and simple operating sequence below shows how to put the instrument into
operation and quickly set its basic functions. The current IP address for LAN operation
is shown in the SETUP – Instrument Setup Menu. In case of USB connection the IP
address is fixed to 172.16.10.10.
Refer to the Quick Start Guide for instructions on how to change the IP address.
► Connect the instrument to the LAN or directly to the controller via USB.
► Switch on the instruments.
► Write and start the following program on the controller:
status = viOpenDefaultRM(defaultRM)
'open default resource manager
status = viOpen(DefaultRM, "TCPIP::172.16.10.10", 0, 0, vi)
'in case of USB connection
status = viopen(DefaultRM, "TCPIP::xxx.xxx.xxx.xxx", 0, 0, vi)
'in case of a LAN connection, with xxx.xxx.xxx.xxx = IP address
cmd = "*RST;*CLS"
status = viWrite(vi, Cmd, Len(Cmd), retCount)
'reset instrument and clear status registers
cmd = "FREQ:CENT 100MHz"
status = viWrite(vi, Cmd, Len(Cmd), retCount)
'set center frequency to 100 MHz
cmd = "FREQ:SPAN 10MHz"
status = viWrite(vi, Cmd, Len(Cmd), retCount)
'set span to 10 MHz
cmd = "DISP:TRAC:Y:RLEV -10dBm"
status = viWrite(vi, Cmd, Len(Cmd), retCount)
'set reference level to -10 dBm
viclose vi
viclose default RM
The instrument now performs a sweep in the frequency range of 95 MHz to 105 MHz.
Changing the IP Address
In order to operate the instrument via remote control, it must be accessed via LAN (IP
address) or USB (fixed IP address). If the factory-set remote control address does not
fit in the network environment, it can be changed. Refer to the Quick Start Guide,
chapter "Setting up a LAN or USB Connection to a PC", for instructions on how to
change the IP address.
R&S FSH Instrument Model and Command Processing
Input Unit
Software Manual 1173.0089.12 - 33 17
4 Instrument Model and Command
Processing
The block diagram in Fig. 1-2 shows how SCPI commands are serviced in the
instrument. The individual components work independently and simultaneously. They
communicate with each other by means of so-called "messages".
Input unit with
input buffer
Command
recognition
Instrument
hardware
Instrument
settings database
Output unit with
output buffer
Status reporting
system
USB interface
Ethernet
USB interface
Ethernet
Figure 4-1: Instrument model in the case of remote control
4.1 Input Unit
The input unit receives commands character by character from the controller and
collects them in the input buffer. The input unit sends a message to the command
recognition as soon as the input buffer is full or as soon as it receives a delimiter,
<PROGRAM MESSAGE TERMINATOR>, as defined in IEEE 488.2, or the interface
message DCL.
If the input buffer is full, the traffic is stopped and the data received up to then are
processed. Subsequently the traffic is continued. If, however, the buffer is not yet full
when receiving the delimiter, the input unit can already receive the next command
during command recognition and execution. The receipt of DCL clears the input buffer
and immediately resets the command recognition.
R&S FSH Instrument Model and Command Processing
Command Recognition
Software Manual 1173.0089.12 - 33 18
4.2 Command Recognition
The command recognition analyses the data received from the input unit. It proceeds
in the order in which it receives the data. Only DCL is serviced with priority, for
example GET (Group Execute Trigger) is only executed after the commands received
before. Each recognized command is immediately transferred to the internal instrument
settings data base but not executed immediately.
The command recognition detects syntax errors in the commands and transfers them
to the status reporting system. The rest of a program message after a syntax error is
analyzed further if possible and serviced. After the syntax test, the value range of the
parameter is checked, if required.
If the command recognition detects a delimiter, it passes the command to an execution
unit that performs the instrument settings. In the meantime, the command recognition
is ready to process new commands (overlapping execution). A DCL command is
processed in the same way.
4.3 Data Base and Instrument Hardware
Here the expression "instrument hardware" denotes the part of the instrument fulfilling
the actual instrument function - signal generation, measurement etc. The controller is
not included. The term "data base" denotes a database that manages all the
parameters and associated settings required for setting the instrument hardware.
Setting commands lead to an alteration in the data set. The data set management
enters the new values (e.g. frequency) into the data set, however, only passes them on
to the hardware when requested by the command recognition. This only takes place at
the end of a program message.
The data are checked for compatibility with the current instrument settings before they
are transmitted to the instrument hardware. If the execution is not possible, an
"execution error" is signaled to the status reporting system. The corresponding settings
are discarded.
Before passing on the data to the hardware, the settling bit in the STATus:OPERation
register is set (refer to section "STATus:OPERation Register"). The hardware executes
the settings and resets the bit again as soon as the new state has settled. This fact can
be used to synchronize command servicing.
Queries induce the data set management to send the desired data to the output unit.
R&S FSH Instrument Model and Command Processing
Status Reporting System
Software Manual 1173.0089.12 - 33 19
4.4 Status Reporting System
For detailed information refer to section "Status Reporting System".
4.5 Output Unit
The output unit collects the information requested by the controller, which it receives
from the data base management. It processes it according to the SCPI rules and
makes it available in the output buffer.
If the instrument is addressed as a talker without the output buffer containing data or
awaiting data from the data base management, the output unit sends error message
"Query UNTERMINATED" to the status reporting system. No data are sent to the
controller, the controller waits until it has reached its time limit. This behavior is defined
by IEEE 488.2 and SCPI.
R&S FSH SCPI Command Structure and Syntax
Structure of a Command
Software Manual 1173.0089.12 - 33 20
5 SCPI Command Structure and Syntax
SCPI (Standard Commands for Programmable Instruments) describes a standard
command set for programming instruments, irrespective of the type of instrument or
manufacturer. The goal of the SCPI consortium is to standardize the device-specific
commands to a large extent. For this purpose, a model was developed which defines
the same functions inside a device or for different devices. Command systems were
generated which are assigned to these functions. Thus it is possible to address the
same functions with identical commands. The command systems are of a hierarchical
structure.
SCPI is based on standard IEEE 488.2, i.e. it uses the same syntactic basic elements
as well as the common commands defined in this standard. Part of the syntax of the
device responses is defined with greater restrictions than in standard IEEE 488.2 (see
section "Responses to Queries").
Remote command examples
Not all commands used in the following examples are implemented in the instrument.
5.1 Structure of a Command
The commands consist of a so-called header and, in most cases, one or more
parameters. Header and parameter are separated by a "white space" (ASCII code 0 to
9, 11 to 32 decimal, e.g. blank). The headers may consist of several key words.
Queries are formed by directly appending a question mark to the header.
5.1.1 Common Commands
Common commands consist of a header preceded by an asterisk "*" and one or
several parameters, if any.
Examples
*RST
RESET, resets the device
*ESE 253
EVENT STATUS ENABLE, sets the bits of the event status enable
register
*ESR?
EVENT STATUS QUERY, queries the contents of the event status
register.
R&S FSH SCPI Command Structure and Syntax
Structure of a Command
Software Manual 1173.0089.12 - 33 21
5.1.2 Device-Specific Commands
5.1.2.1 Hierarchy
Device-specific commands are of hierarchical structure. The different levels are
represented by combined headers. Headers of the highest level (root level) have only
one key word. This key word denotes a complete command system.
Example
SENSe
This key word denotes the SENSe command system.
For commands of lower levels, the complete path has to be specified, starting on the
left with the highest level, the individual key words being separated by a colon ":".
Example
SENSe:FREQuency:SPAN 10MHZ
This command lies in the third level of the SENSe system. It sets the frequency span.
SENSe
BANDwidth
FUNCtion
FREQuency DETector
STARt STOP CENTer SPAN OFFSet
Figure 5-1: Tree structure the SCPI command systems using the SENSe system as example
5.1.2.2 Multiple Keywords
Some key words occur in several levels within one command system. Their effect
depends on the structure of the command, i.e. at which position in the header of a
command they are inserted.
Examples
SOURce:FM:POLarity NORMal
This command contains key word POLarity in the third command level. It defines the
polarity between modulator and modulation signal.
SOURce:FM:EXTernal:POLarity NORMal
This command contains key word POLarity in the fourth command level. It defines the
polarity between modulation voltage and the resulting direction of the modulation only
for the external signal source indicated.
R&S FSH SCPI Command Structure and Syntax
Structure of a Command
Software Manual 1173.0089.12 - 33 22
5.1.2.3 Optional Keywords
Some command systems permit certain key words to be inserted into the header or
omitted. These key words are marked by square brackets in the description. The full
command length must be recognized by the instrument for reasons of compatibility
with the SCPI standard. Some commands are considerably shortened by these
optional key words.
Example
[SENSe]:BANDwidth[:RESolution]:AUTO
This command couples the resolution bandwidth of the instrument to other parameters.
The following command has the same effect:
BANDwidth:AUTO
Optional keywords with numeric suffixes
Do not omit an optional keyword if it includes a numeric suffix that is relevant for the
effect of the command.
Example
DISPlay[:WINDow<1...4>]:MAXimize <Boolean>
Command DISP:MAX ON refers to window 1.
In order to refer to a window other than 1, you must include the optional WINDow
parameter with the suffix for the required window.
DISP:WIND2:MAX ON refers to window 2.
5.1.2.4 Long and Short Form
The key words feature a long form and a short form. Either the short form or the long
form can be entered, other abbreviations are not permitted.
Example
STATus:QUEStionable:ENABle 1
is equivalent to
STAT:QUES:ENAB 1
Upper and lower case notation of commands
Upper-case and lower-case notation only serves to distinguish the two forms in the
manual, the instrument itself does not distinguish upper-case and lower-case letters.
R&S FSH SCPI Command Structure and Syntax
Structure of a Command
Software Manual 1173.0089.12 - 33 23
5.1.2.5 Parameter
The parameter must be separated from the header by a "white space". If several
parameters are specified in a command, they are separated by a comma ",". A few
queries permit the parameters MINimum, MAXimum and DEFault to be entered. Refer
to "Parameters" for a detailed description of the various parameters.
Example
SENSe:FREQuency:STOP? MAXimum
Response: 3.5E9
This query requests the maximal value for the stop frequency.
5.1.2.6 Special Characters
|
A vertical stroke in parameter definitions indicates alternative possibilities in the
sense of "or". The effect of the command differs, depending on which parameter
is used.
Example
DISPlay:FORMat SINGle | SPLit
If parameter SINGle is selected, full screen is displayed, in the case of SPLit,
split screen is displayed.
A selection of key words with an identical effect exists for several commands.
These keywords are indicated in the same line; they are separated by a vertical
stroke. Only one of these keywords needs to be included in the header of the
command. The effect of the command is independent of which of the keywords is
used.
Example
SENSe:BANDwidth|BWIDth[:RESolution]
The two following commands with identical meaning can be created. They set the
frequency of the fixed frequency signal to 1 kHz:
SENSe:BAND 1
SENSe:BWID 1
[ ]
Key words in square brackets can be omitted when composing the header. The
full command length must be accepted by the instrument for reasons of
compatibility with the SCPI standards.
Example
[SENSe:]BANDwidth|BWIDth[:RESolution]
SENS:BAND:RES
is equivalent to
BAND
Parameters in square brackets can be incorporated optionally in the command or
omitted as well.
R&S FSH SCPI Command Structure and Syntax
Structure of a Command
Software Manual 1173.0089.12 - 33 24
Example
MMEMory:NETWork:MAP
<string>,<string>[,string>,<string>,<boolean>]
Entries in square brackets are optional or can be omitted.
{ }
Parameters in curly brackets are optional and can be inserted once or several
times, or omitted.
Example
SENSe:LIST:FREQuency <numeric_value>{,<numeric_value>}
The following are valid commands:
SENS:LIST:FREQ 10
SENS:LIST:FREQ 10,20
SENS:LIST:FREQ 10,20,30,40
5.1.2.7 Numeric Suffix
If a device features several functions or features of the same kind, e.g. inputs, the
desired function can be selected by a suffix added to the command. Entries without
suffix are interpreted like entries with the suffix 1. Optional keywords must be specified
if they select a function with the suffix.
Example
SYSTem:COMMunicate:SERial2:BAUD 9600
This command sets the baud rate of a second serial interface.
Suffix counting
In case of remote control, suffix counting may differ from the numbers of the
corresponding selection used in manual operation. SCPI prescribes that suffix
counting starts with 1. Suffix 1 is the default state and used when no specific suffix is
specified.
Some standards define a fixed numbering, starting with 0. With GSM, for instance,
slots are counted from 0 to 7. In the case of remote control, the slots are selected with
the suffixes 1 to 8. If the numbering differs in manual operation and remote control, it is
indicated with the respective command.
R&S FSH SCPI Command Structure and Syntax
Structure of a Command
Software Manual 1173.0089.12 - 33 25
5.1.3 Overview of Syntax Elements
The following table offers an overview of the syntax elements.
:
The colon separates the key words of a command. In a program message the
separating semicolon marks the uppermost command level.
;
The semicolon separates two commands within a program message. It does not
alter the path.
,
The comma separates several parameters of a command.
?
The question mark forms a query.
*
The asterisk marks a common command.
"
Quotation marks introduce a string and terminate it.
#
The hash symbol # introduces binary, octal, hexadecimal and block data.
● Binary: #B10110
● Octal: #O7612
● Hexa: #HF3A7
● Block: #21312
A "white space" (ASCII-Code 0 to 9, 11 to 32 decimal, e.g. blank) separates
header and parameter.
R&S FSH SCPI Command Structure and Syntax
Parameters
Software Manual 1173.0089.12 - 33 26
5.2 Parameters
For most commands a parameter needs to be supplemented. The parameter has to be
separated from the header by a "white space". Possible parameters are:
● Numeric values
● Special numeric values
● Boolean parameters
● Text
● Character strings
● Block data.
The type of parameter required for each command and the allowed range of values are
specified in the command description.
5.2.1 Numeric Values
Numeric values can be entered in any form, i.e. with sign, decimal point and exponent.
Values exceeding the resolution of the instrument are rounded up or down. The
mantissa may comprise up to 255 characters, the exponent must lie inside the value
range -32000 to 32000. The exponent is introduced by an "E" or "e". Entry of the
exponent alone is not permissible. In the case of physical quantities, the unit can be
entered. Permissible unit prefixes are G (giga), MA (mega), MOHM and MHZ are also
possible), K (kilo), M (milli), U (micro) and N (nano). If the unit is missing, the basic unit
is used.
Example
SENSe:FREQuency:STOP 1.5GHz = SENSe:FREQuency:STOP 1.5E9
5.2.2 Special Numeric Values
The texts MINimum, MAXimum, DEFault, UP and DOWN are interpreted as special
numeric values. In case of a query, the numeric value is returned.
● MIN/MAX
MINimum and MAXimum denote the minimum and maximum value.
● DEF
DEFault denotes a preset value which has been stored in the EPROM. This value
conforms to the default setting, as it is called by the *RST command
● UP/DOWN
UP, DOWN increases or reduces the numerical value by one step. The step width
can be specified via an allocated step command for each parameter which can be
set via UP, DOWN.
R&S FSH SCPI Command Structure and Syntax
Parameters
Software Manual 1173.0089.12 - 33 27
● INF/NINF
INFinity, Negative INFinity (NINF) Negative INFinity (NINF) represent the
numerical values -9.9E37 or 9.9E37, respectively. INF and NINF are only sent as
device reponses.
● NAN
Not A Number (NAN) represents the value 9.91E37. NAN is only sent as device
response. This value is not defined. Possible causes are the division of zero by
zero, the subtraction of infinite from infinite and the representation of missing
values.
Example:
Setting command: SENSe:FREQuency:STOP MAXimum
Query: SENSe:FREQuency:STOP?, Response: 3.5E9
5.2.3 Boolean Parameters
Boolean parameters represent two states. The ON state (logically true) is represented
by ON or a numerical value unequal to 0. The OFF state (logically untrue) is
represented by OFF or the numerical value 0. The numerical values are provided as
response for query.
Example
Setting command: CALCulate:MARKer:STATe ON
Query: CALCulate:MARKer:STATe?, Response: 1
5.2.4 Text
Text parameters observe the syntactic rules for key words, i.e. they can be entered
using a short or long form. Like any parameter, they have to be separated from the
header by a white space. In the case of a query, the short form of the text is provided.
Example
Setting command: INPut:COUPling GROund
Query: INPut:COUPling?, Response: GRO
5.2.5 Strings
Strings must always be entered in quotation marks (' or ").
Example
SYSTem:LANGuage "SCPI" or SYSTem:LANGuage 'SCPI'
R&S FSH SCPI Command Structure and Syntax
Parameters
Software Manual 1173.0089.12 - 33 28
5.2.6 Block Data
Block data are a transmission format which is suitable for the transmission of large
amounts of data. A command using a block data parameter has the following structure:
Example
HEADer:HEADer #45168xxxxxxxx
ASCII character # introduces the data block. The next number indicates how many of
the following digits describe the length of the data block. In the example the 4 following
digits indicate the length to be 5168 bytes. The data bytes follow. During the
transmission of these data bytes all end or other control signs are ignored until all
bytes are transmitted.
R&S FSH SCPI Command Structure and Syntax
Structure of a Program Message
Software Manual 1173.0089.12 - 33 29
5.3 Structure of a Program Message
A program message may consist of one or several commands. It is terminated by the
program message terminator which is the NL (New Line) charcter for LAN and USB
connections.
Several commands in a program message must be separated by a semicolon ";". If the
next command belongs to a different command system, the semicolon is followed by a
colon. A colon ":" at the beginning of a command marks the root node of the command
tree.
Example:
CALL InstrWrite(analyzer, "SENSe:FREQuency:CENTer
100MHz;:INPut:ATTenuation 10")
This program message contains two commands. The first one is part of the SENSe
command system and is used to determine the center frequency of the instrument. The
second one is part of the INPut command system and sets the input signal attenuation.
If the successive commands belong to the same system, having one or several levels
in common, the program message can be abbreviated. For that purpose, the second
command after the semicolon starts with the level that lies below the common levels
(see also Fig. 1-1). The colon following the semicolon must be omitted in this case.
Example:
CALL InstrWrite(analyzer, "SENSe:FREQuency:STARt
1E6;:SENSe:FREQuency:STOP 1E9")
This program message is represented in its full length and contains two commands
separated from each other by the semicolon. Both commands are part of the SENSe
command system, subsystem FREQuency, i.e. they have two common levels.
When abbreviating the program message, the second command begins with the level
below SENSe:FREQuency. The colon after the semicolon is omitted. The abbreviated
form of the program message reads as follows:
CALL InstrWrite(analyzer, "SENSe:FREQuency:STARt 1E6;STOP 1E9")
However, a new program message always begins with the complete path.
Example:
CALL InstrWrite(analyzer, "SENSe:FREQuency:STARt 1E6")
CALL InstrWrite(analyzer, "SENSe:FREQuency:STOP 1E9")
R&S FSH SCPI Command Structure and Syntax
Responses to Queries
Software Manual 1173.0089.12 - 33 30
5.4 Responses to Queries
A query is defined for each setting command unless explicitly specified otherwise. It is
formed by adding a question mark to the associated setting command. According to
SCPI, the responses to queries are partly subject to stricter rules than in standard
IEEE 488.2.
● The requested parameter is transmitted without header.
Example
INPut:COUPling?
Response: DC
● Maximum values, minimum values and all further quantities, which are requested
via a special text parameter are returned as numerical values.
Example
SENSe:FREQuency:STOP? MAX
Response: 3.5E9
● Numerical values are output without a unit. Physical quantities are referred to the
basic units or to the units set using the Unit command.
Example
SENSe:FREQuency:CENTer?
Response: 1E6 (for 1 MHz)
● Truth values <Boolean values> are returned as 0 (for OFF) and 1 (for ON).
Example
SENSe:BANDwidth:AUTO?
Response: 1 (for ON)
● Text (character data) is returned in a short form.
Example
SYSTem:COMMunicate:SERial:CONTrol:RTS?
Response STAN (for standard)
R&S FSH Command Sequence and Command Synchronization
Responses to Queries
Software Manual 1173.0089.12 - 33 31
6 Command Sequence and Command
Synchronization
What has been said above makes clear that all commands can potentially be carried
out overlapping. In order to prevent an overlapping execution of commands, one of the
commands *OPC, *OPC? or *WAI must be used. All three commands cause a certain
action only to be carried out after the hardware has been set. By suitable
programming, the controller can be forced to wait for the respective action to occur. For
more information see Table 6-1.
Table 6-1: Synchronization using *OPC, *OPC? and *WAI
Command
Action
Programming the controller
*OPC
Sets the Operation Complete bit in the
ESR after all previous commands have
been executed.
− Setting bit 0 in the ESE
− Setting bit 5 in the SRE
− Waiting for service request (SRQ)
*OPC?
Stops command processing until 1 is
returned. This is only the case after the
Operation Complete bit has been set in
the ESR. This bit indicates that the
previous setting has been completed.
Sending *OPC? directly after the command
whose processing should be terminated before
other commands can be executed.
*WAI
Stops further command processing until
all commands sent before *WAI have
been executed.
Sending *WAI directly after the command whose
processing should be terminated before other
commands are executed.
For a couple of commands the synchronization to the end of command execution is
mandatory in order to obtain the desired result. The affected commands require either
more than one measurement in order to accomplish the desired instrument setting
(e.g. auto range functions), or they require a longer period of time for execution. If a
new command is received during execution of the corresponding function this may
either lead to either to an aborted measurement or to incorrect measurement data.
The following list includes the commands, for which a synchronization via *OPC,
*OPC? or *WAI is mandatory:
Table 6-2: Commands with mandatory synchronization (overlapping commands)
Command
Purpose
INIT
start measurement (sweep)
INIT:CONT OFF
Set to single sweep
CALC:MARK:FUNC:xx?
All Marker function queries
R&S FSH Remote Control – Commands
Responses to Queries
Software Manual 1173.0089.12 - 33 32
7 Remote Control – Commands
The following chapters provide a detailed description of all remote control commands
currently available for the R&S FSH and its firmware options.
Each section describes the commands for one of the operating modes available in the
R&S FSH, beginning with the description of common commands required to operate
the instrument. The structure is based on that of the operating manual.
● Common Commands on page 33
● Remote Commands of the Spectrum Analyzer on page 36
● Remote Commands of the Network Analyzer Mode on page 122
● Remote Commands of the Distance-to-Fault Mode on page 161
● Remote Commands of the Receiver Mode on page 177
● Remote Commands of the Power Meter on page 153
● Remote Commands of the Digital Modulation Analyzer on page 188
Each section is subdivided into various tasks required to perform measurements with
the R&S FSH, also based on the structure of the operating manual. Some commands
like those for controlling markers or configuring the frequency axis are available for all
operating modes. In that case you will find a list of these commands in the
corresponding section. However, a detailed description is provided only in the
commands section of the main application.
Availability of commands
The spectrum and network analyzer modes are implemented in the basic unit. For the
other modes, the corresponding options are required.
Following the remote control commands required to perform specific measurements,
you will find a description of general commands used to set up and control basic
instrument functions. These commands are independent of the operating mode.
Therefore they are listed separately.
● File Management on page 283
● Making and Storing Screenshots on page 291
● Configuring the Instrument on page 298
● Remote Commands of the Status Reporting System on page 336
All chapters begin with a list of commands available in the context of that chapter.
Following that list you will find a detailed description of all commands.
All individual descriptions contain:
● the complete notation and syntax of the command
● the description of the effects of the command
● a list of all parameters available for that command or the type of data the command
returns in case of query commands
● an example of how a program message would look like
● the *RST value
● information on SCPI conformity
An alphabetical list of all available commands is provided at the end of this manual.
R&S FSH Remote Control – Commands
Common Commands
Software Manual 1173.0089.12 - 33 33
7.1 Common Commands
The common commands are taken from the IEEE 488.2 (IEC 625-2) standard. A
particular command has the same effect on different devices. The headers of these
commands consist of an asterisk "*" followed by three letters. Some of the common
commands refer to the "Status Reporting System".
List of commands
● *CLS (p. 33)
● *ESE (p. 33)
● *ESR? (p. 33)
● *IDN? (p. 34)
● *IST? (p. 34)
● *OPC (p. 34)
● *OPT? (p. 34)
● *RST (p. 34)
● *SRE (p. 35)
● *STB? (p. 35)
● *TRG (p. 35)
● *TST? (p. 35)
● *WAI (p. 35)
*CLS
CLEAR STATUS sets the status byte (STB), the standard event register (ESR) and
the EVENt part of the QUEStionable and the OPERation register to zero. The
command does not alter the mask and transition parts of the registers. It clears the
output buffer.
*ESE
EVENT STATUS ENABLE sets the event status enable register to the value
indicated. The query form *ESE? returns the contents of the event status enable
register in decimal form.
Parameter
0 to 255
*ESR?
STANDARD EVENT STATUS QUERY returns the contents of the event status
register in decimal form (0 to 255) and subsequently sets the register to zero.
Parameter
0 to 255
R&S FSH Remote Control – Commands
Common Commands
Software Manual 1173.0089.12 - 33 34
*IDN?
IDENTIFICATION QUERY queries the instrument identification.
You can change the format of the return values with the "SYSTem:FORMat:IDENt
<IDNFormat>" command.Return values
<InstrumentName>,<SerialNumber/Model>,<FirmwareVersion>
Example for R&S FSH:
Rohde&Schwarz,FSH4,100005/024,1.50
*IST?
INDIVIDUAL STATUS QUERY returns the contents of the IST flag in decimal form.
The IST flag is the status bit which is sent during a parallel poll.
Parameter
0 | 1
*OPC
OPERATION COMPLETE sets bit 0 in the event status register after all preceding
commands have been executed. This bit can be used to initiate a service request.
*OPT?
OPTION IDENTIFICATION QUERY queries the options included in the instrument
and returns a list of the options installed. The options are separated from each
other by means of commas.
Parameter
K<number> software options
For a list of all available options and their description refer to the CD-ROM.
Example
K40, K41, K42, K45
*RST
RESET sets the instrument to a defined default status. The command essentially
corresponds to pressing the PRESET key.
R&S FSH Remote Control – Commands
Common Commands
Software Manual 1173.0089.12 - 33 35
*SRE
SERVICE REQUEST ENABLE sets the service request enable register to the
indicated value. Bit 6 (MSS mask bit) remains 0. This command determines under
which conditions a service request is generated. The query form *SRE? reads the
contents of the service request enable register in decimal form. Bit 6 is always 0.
Parameter
0 to 255
*STB?
READ STATUS BYTE QUERY reads out the contents of the status byte in decimal
form.
*TRG
TRIGGER initiates all actions in the currently active test screen expecting a trigger
event. This command corresponds to INITiate[:IMMediate].
*TST?
SELF TEST QUERY initiates the self test of the instrument and outputs an error
code in decimal form.
Parameter
0 = no error
*WAI
WAIT TO CONTINUE permits servicing of subsequent commands only after all
preceding commands have been executed and all signals have settled.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 36
7.2 Remote Commands of the Spectrum Analyzer
This section provides a detailed description of all remote control commands required to
configure and perform measurements with the spectrum analyzer. These commands
are available in spectrum analyzer mode only.
Contents
Configuring the Horizontal Axis on page 37
Configuring the Vertical Axis on page 43
Setting the Bandwidths on page 50
Performing and Triggering Measurements on page 52
Working with Traces on page 61
Using Markers on page 67
Using Display Lines and Limit Lines on page 83
Configuring and Using Measurement Functions on page 89
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 37
7.2.1 Configuring the Horizontal Axis
The following commands configure the horizontal (frequency) axis of the active display.
The suffix <n> in the following commands selects the trace. Its range is {1..2}. Only
relevant for segmented sweep.
List of commands
● [SENSe:]FREQuency:CENTer<n> <Frequency> (p. 37)
● [SENSe:]FREQuency:CENTer:STEP <StepSize> (p. 37)
● [SENSe:]FREQuency:CENTer:STEP:LINK <StepSizeCoupling> (p. 38)
● [SENSe:]FREQuency:INPut:MODE<n> <InputMode> (p. 38)
● [SENSe:]FREQuency:MODE <OperationMode> (p. 40)
● [SENSe:]FREQuency:OFFSet <FrequencyOffset> (p. 40)
● [SENSe:]FREQuency:SPAN<n> <Span> (p. 41)
● [SENSe:]FREQuency:SPAN<n>:AUTO <State> (p. 41)
● [SENSe:]FREQuency:SPAN<n>:FULL (p. 41)
● [SENSe:]FREQuency:STARt<n> <StartFrequency> (p. 42)
● [SENSe:]FREQuency:STOP<n> <StopFrequency> (p. 42)
[SENSe:]FREQuency:CENTer<n> <Frequency>
This command defines the center frequency of the R&S FSH.
In spectrum analyzer mode, the command also defines the measuring frequency
for time domain measurements (span = 0).
Parameter
<Frequency>
Numeric value in Hz.
The range depends on the operating mode and is specified in the data sheet.
Example
FREQ:CENT 100MHz
Defines a center frequency of 100 MHz.
Characteristics
*RST value: f
max
/2 with f
max
= maximum frequency
SCPI: conform
[SENSe:]FREQuency:CENTer:STEP <StepSize>
This command defines the center frequency step size.
Parameter
<StepSize>
Numeric value in Hz.
The range is from 1 Hz to f
max
.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 38
Example
FREQ:CENT:STEP 120MHz
Defines a CF step size of 120 MHz.
Characteristics
*RST value: – (AUTO 0.1*SPAN is switched on)
SCPI: conform
[SENSe:]FREQuency:CENTer:STEP:LINK <StepSizeCoupling>
This command couples and decouples the center frequency step size to the span.
For time domain measurements, the command couples the step size to the
resolution bandwidth.
Parameter
<StepSizeCoupling>
DIVTen
Couples the step size to the span (10 %).
OFF
Turns the coupling off (manual step size).
Example
FREQ:CENT:STEP:LINK DIVT
Couples the step size to 10% of the span.
Characteristics
*RST value: DIVTen
SCPI: device-specific
[SENSe:]FREQuency:INPut:MODE<n> <InputMode>
This command selects the frequency mode. Select the Channel frequency mode
only if you want to work with channel tables. In this case, the input of the center
frequency is not a frequency value, but a channel number.
Parameter
<InputMode>
FREQuency
Sets the frequency input mode to frequency input (in Hz).
CHANnel
Sets the frequency input mode to selection of a channel.
Example
FREQ:INP:MODE CHAN
Sets the frequency mode to work with channel tables.
Characteristics
*RST value: FREQ
SCPI: device-specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 39
[SENSe:]FREQuency:MODE <OperationMode>
This command the measurement domain (frequency or time).
In the time domain (CW and FIXed), set the frequency with:
- [SENSe:]FREQuency:CENTer<n> <Frequency>
In the frequency domain (SWEep), set it with
- [SENSe:]FREQuency:CENTer<n> <Frequency>
- [SENSe:]FREQuency:SPAN<n> <Span>
- [SENSe:]FREQuency:STARt<n> <StartFrequency>
- [SENSe:]FREQuency:STOP<n> <StopFrequency>
Parameter
<OperationMode>
CW
Selects the time domain (span = 0)
FIXed
Selects the time domain (span = 0)
SWEep
Selects the frequency domain (span > 0).
Example
FREQ:MODE SWE
Activates frequency domain measurements.
Characteristics
*RST value: SWEep
SCPI: conform
[SENSe:]FREQuency:OFFSet <FrequencyOffset>
This command defines a frequency offset.
Parameter
<FrequencyOffset>
Numeric value in the range from -100 GHz to 100 GHz.
Example
FREQ:OFFS 1GHZ
Defines a frequency offset of 1 GHz.
Characteristics
*RST value: 0 Hz
SCPI: conform
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 40
[SENSe:]FREQuency:SPAN<n> <Span>
This command defines the frequency span.
If you set a span of 0 Hz in spectrum mode, the R&S FSH starts a measurement in
the time domain.
Parameter
<Span>
Numeric value in Hz. The value range is specified in the data sheet.
Example
FREQ:SPAN 10MHz
Defines a span of 10 MHz.
Characteristics
*RST value: f
max
with f
max
= maximum frequency
SCPI: conform
[SENSe:]FREQuency:SPAN<n>:AUTO <State>
This command turns the automatic calculation of the ideal span on and off.
Parameter
<State>
ON | OFF
Example
FREQ:SPAN:AUTO ON
Turns automatic span determination on and off.
Characteristics
*RST value: OFF
SCPI: device-specific
[SENSe:]FREQuency:SPAN<n>:FULL
This command restores the full span.
This command is an event and therefore has no query and no *RST value.
Example
FREQ:SPAN:FULL
Restores full span.
Characteristics
*RST value: –
SCPI: conform
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 41
[SENSe:]FREQuency:STARt<n> <StartFrequency>
This command defines the start frequency for measurements in the frequency
domain (span > 0).
Parameter
<StartFrequency>
Numeric value in Hz.
The range depends on the operating mode and is specified in the datasheet.
Example
FREQ:STAR 20MHz
Defines a start frequency of 20 MHz.
Characteristics
*RST value: 0
SCPI: conform
[SENSe:]FREQuency:STOP<n> <StopFrequency>
This command defines the stop frequency for measurements in the frequency
domain (span > 0).
Parameter
<StopFrequency>
Numeric value in Hz.
The range depends on the operating mode and is specified in the datasheet.
Example
FREQ:STOP 2000MHz
Defines a stop frequency of 2 GHz
Characteristics
*RST value: f
max
SCPI: conform
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 42
7.2.2 Configuring the Vertical Axis
The following commands configure the vertical (level) axis and level parameters of the
active display.
The suffix <c> at TRANsducer selects the primary or secondary transducer. The range
is <1…2>.
The suffix <n> in the following commands selects the trace. Its range is {1..2}. Only
relevant for segmented sweep.
List of commands
● DISPlay[:WINDow]:TRACe<n>:Y[:SCALe]:ADJust (p. 43)
● DISPlay[:WINDow]:TRACe<n>:Y:SPACing <Scaling> (p. 43)
● DISPlay[:WINDow]:TRACe<n>:Y[:SCALe] <DisplayRange> (p. 44)
● DISPlay[:WINDow]:TRACe<n>:Y[:SCALe]:RLEVel <ReferenceLevel> (p. 44)
● DISPlay[:WINDow]:TRACe<n>:Y[:SCALe]:RLEVel:OFFSet <Offset> (p. 45)
● DISPlay[:WINDow]:TRACe:Y[:SCALe]:RPOSition <ReferencePosition> (p. 45)
● INPut<n>:ATTenuation <Attenuation> (p. 45)
● INPut<n>:ATTenuation:MODE <AttenuationMode> (p. 46)
● INPut<n>:ATTenuation:AUTO <State> (p. 46)
● INPut<n>:GAIN:STATe <State> (p. 47)
● INPut:IMPedance <Impedance> (p. 47)
● [SENSe:]CORRection:TRANsducer<c>[:STATe] <State> (p. 47)
● [SENSe:]CORRection:TRANsducer<c>:SELect <TransducerFactor> (p. 48)
● [SENSe:]CORRection:TRANsducer<c>:UNIT? (p. 48)
● UNIT<n>:POWer <Unit> (p. 49)
DISPlay[:WINDow]:TRACe<n>:Y[:SCALe]:ADJust
This command automatically scales the vertical axis for optimum display results.
This command is an event and therefore has no query and no *RST value.
Example
DISP:TRAC:Y:ADJ
Adjusts the y-axis.
Characteristics
*RST value: SCPI: device-specific
DISPlay[:WINDow]:TRACe<n>:Y:SPACing <Scaling>
This command selects the scaling of the vertical axis.
Parameter
<Scaling>
LOGarithmic
Selects a logarithmic scale.
LINear
Selects a linear scale (%).
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 43
Example
DISP:TRAC:Y:SPAC LIN
Selects linear scaling of the level axis.
Characteristics
*RST value: LOGarithmic
SCPI: conform
DISPlay[:WINDow]:TRACe<n>:Y[:SCALe] <DisplayRange>
This command defines the display range of the vertical axis.
Note that you have to set a logarithmic scaling before you can use this command
with DISPlay[:WINDow]:TRACe<n>:Y:SPACing. For a linear scale, you can
not modify the display range as it is fixed.
Parameter
<DisplayRange>
numeric value in the range from 10 dB to 200 dB
Example
DISP:TRAC:Y 110dB
Sets the display range to 110 dB.
Characteristics
*RST value: 100dB
SCPI: device–specific
DISPlay[:WINDow]:TRACe<n>:Y[:SCALe]:RLEVel <ReferenceLevel>
This command defines the reference level.
With a reference level offset ≠ 0, the value range of the reference level is modified
by the offset.
Parameter
<ReferenceLevel>
numeric value that sets the reference level; the unit depends on UNIT<n>:POWer.
The available value range is specified in the data sheet.
Example
DISP:TRAC:Y:RLEV –60dBm
Sets the reference level to -60 dBm.
Characteristics
*RST value: –20dBm
SCPI: conform
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 44
DISPlay[:WINDow]:TRACe<n>:Y[:SCALe]:RLEVel:OFFSet <Offset>
This command defines a reference level offset.
Parameter
<Offset>
numeric value (dB) that sets the reference level offset
The available value range is from -200dB to 200dB.
Example
DISP:TRAC:Y:RLEV:OFFS –10dB
Characteristics
*RST value: 0dB
SCPI: conform
DISPlay[:WINDow]:TRACe:Y[:SCALe]:RPOSition <ReferencePosition>
This command defines the position of the reference level on the display grid.
First, you have to set a logarithmic scale for the vertical axis with
DISPlay[:WINDow]:TRACe<n>:Y:SPACing. For a linear scale, you can not
modify the reference position.
Parameter
<ReferencePosition>
numeric value (%) that defines the reference position
The available value range is from 1 to 10.
Example
DISP:TRAC:Y:RPOS 5
Sets the reference position to the 5th grid line.
Characteristics
*RST value:10
SCPI: conform
INPut<n>:ATTenuation <Attenuation>
This command defines the input attenuation.
In spectrum mode, the attenuation is coupled to the reference level. If you set the
attenuation independently, the R&S FSH turns off this coupling.
The R&S FSH adjusts the reference level if it can not be set for the current RF
attenuation.
Parameter
<Attenuation>
Numeric value in in the range from 0 dB to 40 dB in 5 dB steps.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 45
Example
INP:ATT 30dB
Defines an attenuation of 30 dB and deactivates coupling to the reference level.
Characteristics
*RST value: 0 dB (AUTO is ON)
SCPI: conform
INPut<n>:ATTenuation:MODE <AttenuationMode>
This command selects the attenuation mode.
Parameter
<AttenuationMode>
LDIStortion
Selects "Auto Low Distortion" mode.
LNOise
Selects "Auto Low Noise" mode.
Example
INP:ATT:MODE LNO
Sets the attenuation mode to Auto Low Noise.
Characteristics
*RST value: LNOise
SCPI: device-specific
INPut<n>:ATTenuation:AUTO <State>
This command couples and decouples input attenuation to the reference level.
Parameter
<State>
ON | OFF
Example
INP:ATT:AUTO ON
Couples the attenuation set on the attenuator to the reference level.
Characteristics
*RST value: ON
SCPI: conform
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 46
INPut<n>:GAIN:STATe <State>
This command turns the preamplifier on and off.
Parameter
<State>
ON | OFF
Example
INP:GAIN:STAT ON
Activates the preamplifier
Characteristics
*RST value: OFF
SCPI: conform
INPut:IMPedance <Impedance>
This command selects the nominal input impedance. The set impedance is taken
into account in all level indications of results.
The setting 75 Ω should be selected, if the 50 Ω input impedance is
transformed to a higher impedance using a 75 Ω adapter of the RAZ type (= 25 Ω
in series to the input impedance of the instrument). The correction value in this
case is 1.76 dB = 10 log (75Ω / 50Ω).
Parameter
<Impedance>
50 | 75
Example
INP:IMP 75
Sets the input impedance to 75 Ohm.
Characteristics
*RST value: 50 Ω
SCPI: conform
[SENSe:]CORRection:TRANsducer<c>[:STATe] <State>
This command turns a transducer factor on and off.
Before turning it on, you have to select a transducer factor with
[SENSe:]CORRection:TRANsducer<c>:SELect.
Parameter
<State>
ON | OFF
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 47
Example
CORR:TRAN1 ON
Activates the primary transducer
Characteristics
*RST value: OFF
SCPI: device-specific
[SENSe:]CORRection:TRANsducer<c>:SELect <TransducerFactor>
This command selects a transducer factor.
If <name> does not exist yet, a new transducer factor is created.
The suffix<1...2> specifies the primary or secondary transducer.
Parameter
<Transducerfactor>
string containing the file name of the transducer factor.
If the file does not exist, the R&S FSH creates a new transducer factor.
Example
CORR:TRAN2:SEL 'FSH-Z38.sectrd'
Selects the FSH-Z38 secondary transducer factor.
Characteristics
*RST value: SCPI: device-specific
[SENSe:]CORRection:TRANsducer<c>:UNIT?
This command queries the unit of the current transducer factor.
Example
CORR:TRAN2:UNIT?
Queries the unit of the primary transducer.
Characteristics
*RST value: SCPI: device-specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 48
UNIT<n>:POWer <Unit>
This command selects the unit of the vertical axis.
The availability of units depends on the operating mode and type of measurement.
Parameter
<Unit>
DBM | DBUV | DBMV | V | W | DUVM | DUAM | V_M | W_M2
Note that the availability of units depends on the operating mode.
Example
UNIT:POW DBUV
Sets the power unit to dBμV.
Characteristics
*RST value: DBM
SCPI: conform
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 49
7.2.3 Setting the Bandwidths
The following commands configure the filter bandwidths of the R&S FSH. Note that
both groups of commands (BANDwidth and BWIDth) are the same.
The suffix <n> in the following commands selects the trace. Its range is {1..2}. Only
relevant for segmented sweep.
List of commands
● [SENSe:]BANDwidth|BWIDth<n>[:RESolution] <ResBW> (p. 50)
● [SENSe:]BANDwidth|BWIDth<n>[:RESolution]:AUTO <State> (p. 50)
● [SENSe:]BANDwidth|BWIDth<n>:VIDeo <VideoBW> (p. 51)
● [SENSe:]BANDwidth|BWIDth<n>:VIDeo:AUTO <State> (p. 51)
[SENSe:]BANDwidth|BWIDth<n>[:RESolution] <ResBW>
This command defines the resolution bandwidth.
Parameter
<ResBW>
Numeric value in Hz.
The available value range is from 1 Hz to 3 MHz in 1 - 3 - 10 steps. In addition, you
can select a 200 kHz and 5 MHz bandwidth.
In zero span, the R&S FSH also provides a 10 MHz and 20 MHz bandwidth.
Example
BAND 100 kHz
Sets the resolution bandwidth to 100 kHz
Characteristics
*RST value: - (AUTO is set to ON)
SCPI: conform
[SENSe:]BANDwidth|BWIDth<n>[:RESolution]:AUTO <State>
This command couples and decouples the resolution bandwidth to the span.
Parameter
<State>
ON | OFF
Example
BAND:AUTO OFF
Decouples the resolution bandwidth from the span.
Characteristics
*RST value: ON
SCPI: conform
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 50
[SENSe:]BANDwidth|BWIDth<n>:VIDeo <VideoBW>
This command defines the video bandwidth.
Parameter
<VideoBW>
Numeric value in Hz.
The available value range is from 1 Hz to 3 MHz in 1 - 3 steps.
Example
BAND:VID 10kHz
Sets the video bandwidth to 10 kHz.
Characteristics
*RST value: - (AUTO is set to ON)
SCPI: conform
[SENSe:]BANDwidth|BWIDth<n>:VIDeo:AUTO <State>
This command couples and decouples the video bandwidth to the resolution
bandwidth.
Parameter
<State>
ON | OFF
Example
BAND:VID:AUTO OFF
Turns off video bandwidth coupling.
Characteristics
*RST value: ON
SCPI: conform
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 51
7.2.4 Performing and Triggering Measurements
The following commands control the actual measurement process, including trigger
functionality.
7.2.4.1 Performing the Measurement
The following commands initialize a measurement and set up the sweep.
The suffix <n> in the following commands selects the trace. Its range is {1..2}. Only
relevant for segmented sweep.
List of commands
● *WAI (p. 35)
● ABORt (p. 52)
● INITiate[:IMMediate] (p. 52)
● INITiate:CONTinuous <SweepMode> (p. 53)
● [SENSe:]SWEep:COUNt<n> <SweepCount> (p. 53)
● [SENSe:]SWEep:POINts? (p. 54)
● [SENSe:]SWEep:TIME<n> <SweepTime> (p. 54)
● [SENSe:]SWEep:TIME<n>:AUTO <State> (p. 54)
ABORt
This command aborts the current measurement and resets the trigger system.
This command is an event and therefore has no query and no *RST value.
Example
ABOR;
INIT:IMM
Aborts a measurement and starts a new one.
Characteristics
RST value: –
SCPI: conform
INITiate[:IMMediate]
The command initiates a new measurement sequence.
With sweep count > 0 or average count > 0, this means a restart of the indicated
number of measurements. With trace functions MAXHold, MINHold and AVERage,
the previous results are reset on restarting the measurement.
In single sweep mode, synchronization to the end of the indicated number of
measurements can be achieved with the command *OPC, *OPC? or *WAI. In
continuous–sweep mode, synchronization to the sweep end is not possible since
the overall measurement never ends.
This command is an event and therefore has no query and no *RST value.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 52
Example
INIT:CONT OFF
DISP:WIND:TRAC:MODE AVER
Turns single sweep mode and trace averaging on.
INIT;*WAI
Starts the measurement and waits for the end of the sweep.
Characteristics
*RST value: –
SCPI: conform
INITiate:CONTinuous <SweepMode>
This command selects the sweep mode.
Parameter
<SweepMode>
ON
Selects continuous sweeps.
OFF
Selects single sweep.
Example
INIT:CONT OFF
Turns on single sweep mode.
Characteristics
*RST value: ON
SCPI: conform
[SENSe:]SWEep:COUNt<n> <SweepCount>
This command defines the number of sweeps included in a single sweep. It also
defines the number of sweeps the R&S FSH uses to average traces or calculate
maximum values.
The R&S FSH performs one sweep for sweep count 0 or 1.
Parameter
<SweepCount>
0 to 999
Example
SWE:COUN 64
Defines a sweep count of 64 sweeps.
INIT:CONT OFF
INIT;*WAI
Turns on single sweep mode, starts the sweep and waits for its end.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 53
Characteristics
*RST value: 1
SCPI: conform
[SENSe:]SWEep:POINts?
This command queries the number of measurement points in a single sweep.
This command is a query and therefore has no *RST value.
Return value
Number of sweep points.
Example
SWE:POIN?
Returns the number of sweep points.
Characteristics
*RST value: –
SCPI: conform
[SENSe:]SWEep:TIME<n> <SweepTime>
This command defines the sweep time.
If you set a sweep time in spectrum mode with this command, the R&S FSH
decouples the sweep time from the span and the resolution and video bandwidths.
Parameter
<SweepTime>
Numeric value in seconds.
The available value range is specified in the datasheet.
Example
SWE:TIME 10s
Sets the sweep time to 10 s
Characteristics
*RST value: - (AUTO is set to ON)
SCPI: conform
[SENSe:]SWEep:TIME<n>:AUTO <State>
This command couples and decouples the sweep time to the span and the
resolution and video bandwidths.
Parameter
<State>
ON | OFF
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 54
Example
SWE:TIME:AUTO ON
Switches on the coupling to frequency span and bandwidths.
Characteristics
*RST value: ON
SCPI: conform
7.2.4.2 Capturing I/Q Data
The following commands control I/Q data capture.
List of commands
● TRACe:IQ:DATA:MEMory? [<OffsetSamples>,<Samples>] (p. 55)
● TRACe:IQ:RLENgth <Samples> (p. 56)
● TRACe:IQ:SRATe <SampleRate> (p. 56)
● TRACe:IQ[:STATe] <State> (p. 56)
TRACe:IQ:DATA:MEMory? [<OffsetSamples>,<Samples>]
This command queries the I/Q data in the capture buffer.
By default, it returns all samples in the capture buffer. You can, however, narrow
down the amount of data that the command returns using the optional parameters.
This command is a query and therefore has no *RST value.
Parameter
<OffsetSamples>
Defines the first sample to return in relation to the first sample in the capture buffer.
<Samples>
Defines the number of samples to return.
Return value
<IQData>
Measured value pair (I,Q) for each sample that has been recorded. The order is
I,I,I,I,(…),Q,Q,Q,Q,(…)
Example
TRAC:IQ ON
Turn on I/Q data capture.
TRAC:IQ:RLEN 10000
TRAC:IQ:SRAT 1000000
Capture 10000 samples with 1 MHz sample rate.
INIT:CONT OFF
INIT;*WAI
Selects single sweep and initiate measurement.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 55
TRAC:IQ:DATA:MEM? 1000,5000
Queries 5000 samples, beginning with the 1000th sample.
Characteristics
*RST value: SCPI: device-specific
TRACe:IQ:RLENgth <Samples>
This command defines the number of samples to capture.
Parameter
<Samples>
Number of samples in the range from 1 to 524288.
Example
TRAC:IQ:RLEN 10000
Capture 10000 samples.
*RST value: 1000
SCPI: device-specific
TRACe:IQ:SRATe <SampleRate>
This command defines the sample rate.
The maximum sample rate depends on the instrument variant you have. It is either
38.4 MHz or 15 MHz.
Parameter
<SampleRate>
Sample rate in Hz.
Example
TRAC:IQ:SRAT 1000000
Define a 1 MHz sample rate.
TRAC:IQ:SRAT MAX
TRAC:IQ:SRAT?
Query maximum sample rate
*RST value: 10 MHz
SCPI: device-specific
TRACe:IQ[:STATe] <State>
This command turns I/Q capture mode on and off.
Parameter
<State>
ON | OFF.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 56
Example
TRAC:IQ ON
Turn on I/Q capture mode.
*RST value: OFF
SCPI: device-specific
7.2.4.3 Triggering Measurements
The following commands set up trigger conditions if you are using a trigger for the
measurement.
The suffix <n> in the following commands selects the trace. Its range is {1..2}. Only
relevant for segmented sweep.
List of commands
● [SENSe:]SWEep:EGATe <State> (p. 57)
● [SENSe:]SWEep:EGATe:HOLDoff <GateDelay> (p. 58)
● [SENSe:]SWEep:EGATe:LENGth <GateLength> (p. 58)
● [SENSe:]SWEep:EGATe:TIME <SweepTime> (p. 58)
● TRIGger[:SEQuence]:CLOCk[:FREQuency] <ClockRate> (p. 59)
● TRIGger<n>[:SEQuence]:HOLDoff[:TIME] <TriggerDelay> (p. 59)
● TRIGger<n>[:SEQuence]:LEVel:VIDeo <TriggerLevel> (p. 59)
● TRIGger<n>[:SEQuence]:SLOPe <TriggerSlope> (p. 60)
● TRIGger<n>[:SEQuence]:SOURce <TriggerSource> (p. 60)
[SENSe:]SWEep:EGATe <State>
This command turns a gated trigger on and off.
Parameter
<State>
ON | OFF
Example
SWE:EGAT ON
Activates the gated trigger.
Characteristics
*RST value: off
SCPI: device-specific
[SENSe:]SWEep:EGATe:HOLDoff <GateDelay>
This command defines the length of the gate delay.
Parameter
<GateDelay>
Numeric value in the range from 0 s to 100 s.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 57
Example
SWE:EGAT:HOLD 2.5
Sets a gate delay of 2.5 seconds.
Characteristics
*RST value: 0 s
SCPI: device-specific
[SENSe:]SWEep:EGATe:LENGth <GateLength>
This command defines the gate length.
Parameter
<GateLength>
Numeric value in the range from 10 µs to 100 s.
Example
SWE:EGAT:LENG 2.5
Sets a gate length of 2.5 seconds.
Characteristics
*RST value: 400 µs
SCPI: device-specific
[SENSe:]SWEep:EGATe:TIME <SweepTime>
This command defines the sweep time for the gated trigger.
Parameter
<SweepTime>
Numeric value in seconds.
Example
SWE:GATE:TIME 4ms
Sets a sweep time of 4 ms for the gated trigger.
Characteristics
*RST value: 400 µs
SCPI: device-specific
TRIGger[:SEQuence]:CLOCk[:FREQuency] <ClockRate>
This command defines the clock rate of the internal trigger.
Parameter
<ClockRate>
Clock rate that defines the trigger intervals in Hz.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 58
Example
TRIG:CLOC 100
Triggers a measurement every 100 ms.
Characteristics
*RST value: 100 Hz
SCPI: device-specific
TRIGger<n>[:SEQuence]:HOLDoff[:TIME] <TriggerDelay>
This command defines the length of the trigger delay.
Parameter
<TriggerDelay>
Numeric value in the range from 0 s to 100 s.
Example
TRIG:HOLD 500us
Sets the trigger delay to 500 µs.
Characteristics
*RST value: 0 s
SCPI: conform
TRIGger<n>[:SEQuence]:LEVel:VIDeo <TriggerLevel>
This command defines the level of the video trigger.
Video trigger is available for time domain measurements (span = 0).
Parameter
<TriggerLevel>
Numeric value in the range from 0 % to 100 %.
Example
TRIG:LEV:VID 50PCT
Sets the trigger level to 50%.
Characteristics
*RST value: 50 PCT
SCPI: device–specific
TRIGger<n>[:SEQuence]:SLOPe <TriggerSlope>
This command selects the slope of the trigger signal.
The trigger slope applies to all trigger sources.
Parameter
<TriggerSlope>
POSitive | NEGative
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 59
Example
TRIG:SLOP NEG
Characteristics
*RST value: POSitive
SCPI: conform
TRIGger<n>[:SEQuence]:SOURce <TriggerSource>
This command selects the trigger source.
Parameter
<TriggerSource>
IMMediate
Selects Free Run measurements.
EXTernal
Selects an external trigger.
INTernal
Internal trigger.
VIDeo
Selects the video trigger.
For more information see R&S FSH operating manual chapter "Setting the Sweep"
Example
TRIG:SOUR EXT
Selects the external trigger input as source of the trigger signal
Characteristics
*RST value: IMMediate
SCPI: conform
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 60
7.2.5 Working with Traces
The following commands set up the trace and the various functions associated with it,
e.g. trace mathematics or the selection of the detector.
The suffix <n> in the following commands selects the trace. Its range is {1..2}. Only
relevant for segmented sweep.
List of commands
● CALCulate:MATH<n>[:EXPRession][:DEFine] <Expression> (p. 61)
● CALCulate:MATH<n>:COPY:MEMory (p. 61)
● CALCulate:MATH<n>:STATe <State> (p. 62)
● DISPlay[:WINDow]:TRACe<n>[:STATe] <State> (p. 62)
● DISPlay[:WINDow]:TRACe<n>:MEMory[:STATe] <State> (p. 62)
● DISPlay[:WINDow]:TRACe<n>:MODE <TraceMode> (p. 63)
● FORMat:BORDer <ByteOrder> (p. 63)
● [SENSe:]DETector<n>[:FUNCtion] <Detector> (p. 64)
● [SENSe:]DETector<n>[:FUNCtion]:AUTO <State> (p. 64)
● TRACe<n>[:DATA]? <Destination> (p. 64)
● TRACe<n>:DATA:MEMory? <Trace> (p. 65)
● FORMat[:DATA] <DataFormat> (p. 66)
CALCulate:MATH<n>[:EXPRession][:DEFine] <Expression>
This command defines the mathematical expression for relating traces to trace 1.
You have to activate trace mathematics with CALCulate:MATH<n>:STATe
<State> first.
Parameter
<Expression>
(IMPLied - memory)
Subtracts the trace in memory from the current trace.
(memory - IMPlied)
Subtracts the current trace from the trace in memory.
Example
CALC:MATH (MTRACE–TRACE)
Selects the subtraction of the current trace from trace in the memory.
Characteristics
*RST value: –
SCPI: conform
CALCulate:MATH<n>:COPY:MEMory
This command stores the selected trace into the memory trace of the R&S FSH.
This command is an event and therefore has no query and no *RST value.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 61
Example
CALC:MATH:COPY:MEM
Copies the trace into the memory.
Characteristics
*RST value: SCPI: device-specific
CALCulate:MATH<n>:STATe <State>
This command turns trace mathematics on and off.
Parameter
<State>
ON | OFF
Example
CALC:MATH:STAT ON
Switches on the trace mathematics.
Characteristics
*RST value: OFF
SCPI: conform
DISPlay[:WINDow]:TRACe<n>[:STATe] <State>
This command turns a trace on and off.
Parameter
<State>
ON | OFF
Example
DISP:TRAC2 ON
Turns the trace on.
Characteristics
*RST value: ON for TRACe1, OFF for TRACe2
SCPI: conform
DISPlay[:WINDow]:TRACe<n>:MEMory[:STATe] <State>
This command turns the memory trace on and off.
Parameter
<State>
ON | OFF
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 62
Example
DISP:TRAC:MEM ON
Activates the memory trace.
Characteristics
*RST value: OFF
SCPI: device-specific
DISPlay[:WINDow]:TRACe<n>:MODE <TraceMode>
This command selects the trace mode.
If you are using the average, max hold or min hold trace mode, you can set the
number of measurements with [SENSe:]SWEep:COUNt<n> <SweepCount>. Note
that synchronization to the end of the average count is possible only in single
sweep mode.
Parameter
<TraceMode>
AVERage | MAXHold | MINHold | VIEW | WRITe
You can turn off the trace with DISPlay[:WINDow]:TRACe<n>[:STATe]
<State>.
For more information see the operating manual, chapter "Trace Mode".
Example
INIT:CONT OFF
SWE:COUN 16
Turn on single sweep mode and sets the number of measurements to 16.
DISP:TRAC:MODE MAXH
Activates MAXHold mode for the trace.
INIT;*WAI
Starts the measurement and waits for the end of the 16 sweeps.
Characteristics
*RST value: WRITe
SCPI: device–specific
FORMat:BORDer <ByteOrder>
This command selects the format of binary data.
Parameters
<ByteOrder>
SWAPped
The least significant byte is transferred first (little endian).
NORMal
The most significant byte is transferred first big endian).
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 63
Example
FORM:BORD NORM
Changes the byte order to normal mode
Characteristics
*RST value SWAPped
SCPI: conform
[SENSe:]DETector<n>[:FUNCtion] <Detector>
This command selects the detector.
Parameter
<Detector>
APEak | NEGative | POSitive | SAMPle | RMS
For more information see the operating manual, chapter "Detectors".
Example
DET POS
Sets the detector to "positive peak".
Characteristics
*RST value: POS
SCPI: conform
[SENSe:]DETector<n>[:FUNCtion]:AUTO <State>
This command couples and decouples the detector to the trace mode.
Parameter
<State>
ON | OFF
Example
DET:AUTO OFF
Turns off automatic detector selection.
Characteristics
*RST value: ON
SCPI: conform
TRACe<n>[:DATA]? <Destination>
This command queries the trace data of the current measurement.
It also transfers data from a file to a particular trace.
With FORMat[:DATA] <DataFormat> command, you can set the data format.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 64
Parameter
<Destination>
TRACE1
Queries the data of trace 1.
TRACE2
Queries the data of trace 2.
LIST
Queries the peak list of the measurement.
Return value
The R&S FSH returns 631 values. Each value corresponds to one pixel of a trace.
The unit depends on the measurement and the unit you have set with
UNIT<n>:POWer <Unit>.
Note:
If you use the auto peak detector, the command reads out positive peak values
only.
Example
TRAC:DATA? TRACE1
Reads out the data for trace 1
Characteristics
*RST value: SCPI: conform
TRACe<n>:DATA:MEMory? <Trace>
This command queries the memory trace data.
You can set the data format with the FORMat[:DATA] <DataFormat>.
To query memory trace data, you have to create a memory trace first with
DISPlay[:WINDow]:TRACe<n>:MEMory[:STATe] <State>.
Parameter
<Trace>
TRACE1
Queries the data of memory trace 1.
TRACE2
Queries the data of memory trace 2.
TRACE3
Queries the data of memory trace 3.
TRACE4
Queries the data of memory trace 4.
Only traces that are actually in the trace memory can be exported.
Return value
The R&S FSH returns 631 values. Each value corresponds to one pixel of a trace.
The result and unit depends on the measurement format.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 65
Example
DISP:TRAC2:MODE AVER
CALC:MATH2:COPY:MEM
TRAC:DATA:MEM? TRACE1
Reads out the data for memory trace 1.
Characteristics
*RST value: SCPI: conform
FORMat[:DATA] <DataFormat>
This command selects the data format that is used for transmission of trace data
from the R&S FSH to the controlling computer.
Note that the command has no effect for data that you send to the R&S FSH. The
R&S FSH automatically recognizes the data it receives, regardless of the format.
Parameter
<DataFormat>
ASCii
Returns the data in ASCII format, separated by commas.
REAL,32
Returns the data as 32-bit IEEE 754 floating point numbers in the "definite
length block format".
In REAL,32 format, a string of return values would look like:
#42524<value 1><value 2>...<value n>
with
#4
Number of digits of the following number of data bytes (= 4 in this example)
2524
Number of following data bytes (2524, corresponds to the 631 sweep points of the
R&S FSH.
<value>
4-byte floating point value
Example
FORM ASC
Selects the ASCii data format.
Characteristics
*RST value: ASCii
SCPI: conform
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 66
7.2.6 Using Markers
● Markers and Delta Markers on page 67
● Marker Functions on page 75
7.2.6.1 Markers and Delta Markers
The following commands are for setting and controlling markers and deltamarkers.
In spectrum mode, the suffix <n> at CALCulate selects the trace. Its range is {1..2}.
The suffix <m> at MARKer is in the range {1..6} and selects the marker or deltamarker.
List of commands
● CALCulate<n>:DELTamarker<m>[:STATe] <State> (p. 67)
● CALCulate<n>:DELTamarker<m>:AOFF (p. 68)
● CALCulate<n>:DELTamarker<m>:MAXimum[:PEAK] (p. 68)
● CALCulate<n>:DELTamarker<m>:MAXimum:NEXT (p. 68)
● CALCulate<n>:DELTamarker<m>:MINimum[:PEAK] (p. 69)
● CALCulate<n>:DELTamarker<m>:X <Coordinate> (p. 69)
● CALCulate<n>:DELTamarker<m>:X:RELative <Distance> (p. 70)
● CALCulate<n>:DELTamarker<m>:Y? (p. 70)
● CALCulate<n>:MARKer<m>[:STATe] <State> (p. 71)
● CALCulate<n>:MARKer<m>:AOFF (p. 71)
● CALCulate<n>:MARKer<m>:MAXimum[:PEAK] (p. 71)
● CALCulate<n>:MARKer<m>:MAXimum:NEXT (p. 72)
● CALCulate<n>:MARKer<m>:MINimum[:PEAK] (p. 72)
● CALCulate<n>:MARKer<m>:X <Coordinate> (p. 72)
● CALCulate<n>:MARKer<m>:X:SLIMits[:STATe] <State> (p. 73)
● CALCulate<n>:MARKer<m>:X:SLIMits:LEFT <SearchLimit> (p. 73)
● CALCulate<n>:MARKer<m>:X:SLIMits:RIGHt <Searchlimit> (p. 74)
● CALCulate<n>:MARKer<m>:Y? (p. 74)
CALCulate<n>:DELTamarker<m>[:STATe] <State>
This command turns delta markers on and off.
If you set the suffix at DELTamarker to 1, or use no suffix, the R&S FSH interprets
this as delta marker 2 because the first marker has to be a normal marker. If more
than one normal marker (2 to 6) are already active, the command turns these
marker into delta markers. If no delta marker is active yet, the command activates
the delta marker and positions it on the trace maximum.
Parameter
<State>
ON | OFF
Example
CALC:DELT3 ON
Turns delta marker 3 on or turn marker 3 into a delta marker.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 67
Characteristics
RST value: OFF
SCPI: device–specific
CALCulate<n>:DELTamarker<m>:AOFF
This command turns off all active delta markers.
This command is an event and therefore has no query and no *RST value.
Example
CALC:DELT:AOFF
Turns off all delta markers.
Characteristics
RST value: –
SCPI: device–specific
CALCulate<n>:DELTamarker<m>:MAXimum[:PEAK]
This command positions a delta marker on the current trace maximum.
If necessary, the corresponding delta marker is activated first.
This command is an event and therefore has no *RST value and no query.
Example
CALC:DELT3:MAX
Moves delta marker 3 to the maximum peak.
Characteristics
RST value: –
SCPI: device–specific
CALCulate<n>:DELTamarker<m>:MAXimum:NEXT
This command positions a delta marker on the next smaller trace maximum.
If necessary, the corresponding delta marker is activated first.
This command is an event and therefore has no *RST value and no query.
Example
CALC:DELT2:MAX:NEXT
Moves delta marker 2 to the next smaller maximum peak.
Characteristics
RST value: –
SCPI: device–specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 68
CALCulate<n>:DELTamarker<m>:MINimum[:PEAK]
This command positions a delta marker on the current trace minimum.
If necessary, the corresponding delta marker is activated first.
This command is an event and therefore has no *RST value and no query.
Example
CALC:DELT3:MIN
Moves delta marker 3 to the trace minimum.
Characteristics
RST value: –
SCPI: device–specific
CALCulate<n>:DELTamarker<m>:X <Coordinate>
This command positions a delta marker on a particular coordinate on the horizontal
axis.
Note that it is possible to place the marker outside the visible trace. In that case,
this value is invalid.
If necessary, the corresponding delta marker is activated first.
Parameter
<Coordinate>
Numeric value that indicates the coordinate on the horizontal axis.
The range corresponds to the maximum span.
The unit depends on the measurement, e.g. Hz for measurements in the frequency
domain and seconds for measurements in the time domain.
Example
CALC:DELT:MOD REL
Delta marker positions are relative to marker 1.
CALC:DELT2:X 10.7MHz
Positions delta marker 2 10.7 MHz to the right of marker 1.
CALC:DELT2:X?
CALC:DELT2:X:REL?
Queries the absolute and relative position of delta marker 2.
Characteristics
RST value: –
SCPI: device–specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 69
CALCulate<n>:DELTamarker<m>:X:RELative <Distance>
This command positions a delta marker on a position relative to the reference
marker.
If necessary, the corresponding delta marker is activated first.
Parameter
<Distance>
Numeric value that defines the distance of the marker to the reference marker
The range depends on the current scaling of the horizontal axis.
The unit depends on the measurement, e.g. Hz for measurements in the frequency
domain and seconds for measurements in the time domain.
Example
CALC:DELT3:X:REL 5 kHz
Sets the delta marker at a distance of 5 kHz to the reference position.
Characteristics
RST value: –
SCPI: device–specific
CALCulate<n>:DELTamarker<m>:Y?
This command queries the vertical position of a delta marker. The result is always
a relative value in relation to marker 1.
If necessary, the corresponding delta marker is activated first.
To get a valid result, you have to perform a complete sweep with synchronization
to the sweep end between activating the delta marker and reading out the result.
This is only possible in single sweep mode.
Return value
<MarkerPosition>
In spectrum analyzer mode, the unit depends on the unit you have set and the
scaling of the vertical axis.
Parameter or measuring functions
Output unit
DBM | DBPW | DBUV | DBMV | DBUA
dB (lin/log)
WATT | VOLT | AMPere
dB (lin), % (log)
Example
INIT:CONT OFF
CALC:DELT2 ON
Turns on single sweep mode and delta marker 2.
INIT;*WAI
Starts a sweep and waits for its end.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 70
CALC:DELT2:Y?
Queries the position of delta marker 2.
Characteristics
RST value: –
SCPI: device–specific
CALCulate<n>:MARKer<m>[:STATe] <State>
This command turns markers on and off.
If you do not use a suffix at MARKer, marker 1 is selected. If one or more delta
markers (2 to 6) are already active, the command turns these delta markers into
normal markers.
Parameter
<State>
ON | OFF
Example
CALC:MARK3 ON
Turns on marker 3.
Characteristics
*RST value: OFF
SCPI: device–specific
CALCulate<n>:MARKer<m>:AOFF
This command turns off all active markers, delta markers and active marker
measurement functions.
This command is an event and therefore has no query and no *RST value.
Example
CALC:MARK:AOFF
Switches off all markers.
Characteristics
*RST value: –
SCPI: device–specific
CALCulate<n>:MARKer<m>:MAXimum[:PEAK]
This command positions a marker on the current trace maximum.
If necessary, the corresponding marker is activated first.
This command is an event and therefore has no *RST value and no query.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 71
Example
CALC:MARK2:MAX
Moves marker 2 to the maximum peak.
Characteristics
*RST value: –
SCPI: device–specific
CALCulate<n>:MARKer<m>:MAXimum:NEXT
This command positions a marker on the next smaller trace maximum.
If necessary, the corresponding marker is activated first.
This command is an event and therefore has no *RST value and no query.
Example
CALC:MARK2:MAX:NEXT
Moves marker 2 to the next smaller maximum peak.
Characteristics
*RST value: –
SCPI: device–specific
CALCulate<n>:MARKer<m>:MINimum[:PEAK]
This command positions a marker on the current trace minimum.
If necessary, the corresponding marker is activated first.
This command is an event and therefore has no *RST value and no query.
Example
CALC:MARK2:MIN
Moves marker 2 to the trace minimum.
Characteristics
*RST value: –
SCPI: device–specific
CALCulate<n>:MARKer<m>:X <Coordinate>
This command positions a marker on a particular coordinate on the horizontal axis.
If one or more delta markers (2 to 6) are already active, the command turns these
delta markers into normal markers.
Note that it is possible to place the marker outside the visible trace. In that case,
this value is invalid.
If necessary, the corresponding delta marker is activated first.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 72
Parameter
<Coordinate>
Numeric value indicating the coordinate on the horizontal axis.
The range corresponds to the maximum span.
The unit in spectrum analyzer mode depends on the measurement, e.g. Hz for
measurements in the frequency domain and seconds for measurements in the time
domain.
Example
CALC:MARK2:X 10.7MHz
Positions marker 2 to frequency 10.7 MHz.
Characteristics
*RST value: –
SCPI: device–specific
CALCulate<n>:MARKer<m>:X:SLIMits[:STATe] <State>
This command turns marker search limits on and off.
If you perform a measurement in zero span, this command, this command limits
the evaluation range on the trace.
The numeric suffix at MARKer is irrelevant.
Parameter
<State>
ON | OFF
Example
See CALCulate<n>:MARKer<m>:X:SLIMits:RIGHt <Searchlimit>.
Characteristics
*RST value: OFF
SCPI: device–specific
CALCulate<n>:MARKer<m>:X:SLIMits:LEFT <SearchLimit>
This command defines the left limit of the marker search range.
To use the command, you first have to turn on search limits with
CALCulate<n>:MARKer<m>:X:SLIMits[:STATe] <State>.
If you perform a measurement in zero span, this command, this command limits
the evaluation range on the trace.
The numeric suffix at MARKer is irrelevant.
Parameter
<SearchLimit>
Numeric value that sets the left marker search limit.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 73
The value range corresponds to the maximum span.
The unit in spectrum analyzer mode depends on the measurement, e.g. Hz for
measurements in the frequency domain and seconds for measurements in the time
domain.
Example
See CALCulate<n>:MARKer<m>:X:SLIMits:RIGHt <Searchlimit>.
Characteristics
*RST value: – (is set to the left diagram border when switching on search limits)
SCPI: device–specific
CALCulate<n>:MARKer<m>:X:SLIMits:RIGHt <Searchlimit>
This command defines the right limit of the marker search range.
To use the command, you first have to turn on search limits with
CALCulate<n>:MARKer<m>:X:SLIMits[:STATe] <State>.
If you perform a measurement in zero span, this command, this command limits
the evaluation range on the trace.
The numeric suffix at MARKer is irrelevant.
Parameter
<SearchLimit>
Numeric value that sets the right marker search limit.
The value range corresponds to the maximum span.
The unit depends on the measurement, e.g. Hz for measurements in the frequency
domain and seconds for measurements in the time domain.
Example
CALC:MARK:X:SLIM ON
CALC:MARK:X:SLIM:LEFT 10MHz
CALC:MARK:X:SLIM:RIGH 100MHz
Turns search limits on and defines a search range from 10 MHz to 100 MHz.
Characteristics
*RST value: – (is set to the right diagram border when switching on search limits)
SCPI: device–specific
CALCulate<n>:MARKer<m>:Y?
This command queries the absolute vertical position of a marker.
If necessary, the corresponding marker is activated first.
To get a valid result, you have to perform a complete sweep with synchronization
to the sweep end between activating the delta marker and reading out the result.
This is only possible in single sweep mode.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 74
Return values
<MarkerPosition>
numeric value of the marker position
In spectrum mode, the unit depends on UNIT<n>:POWer.
Example
INIT:CONT OFF
CALC:MARK2 ON
Turns on single sweep mode and marker 2.
INIT;*WAI
Starts a sweep and waits for the end.
CALC:MARK2:Y?
Queries the position of marker 2.
Characteristics
*RST value: –
SCPI: device–specific
7.2.6.2 Marker Functions
The following commands perform various kinds of analysis at the marker position.
The suffix <m> at MARKer is irrelevant, except where noted.
List of commands
● CALCulate:MARKer<m>:COUNt:FREQuency? (p. 76)
● CALCulate:MARKer<m>:COUNt:RESolution:MODE <Resolution> (p. 76)
● CALCulate:MARKer<m>:COUNt[:STATe] <State> (p. 76)
● CALCulate:MARKer<m>:FREQuency:MODE <InputMode> (p. 77)
● CALCulate:MARKer<m>:FUNCtion:CENTer (p. 78)
● CALCulate:MARKer<m>:FUNCtion:DEModulation[:STATe] <State> (p. 78)
● CALCulate:MARKer<m>:FUNCtion:DEModulation:HOLDoff <Time> (p. 78)
● CALCulate:MARKer<m>:FUNCtion:DEModulation:SELect <Demodulation> (p.79)
● CALCulate:MARKer<m>:FUNCtion:NDBDown <Distance> (p. 79)
● CALCulate:MARKer<m>:FUNCtion:NDBDown:FREQuency? (p. 79)
● CALCulate:MARKer<m>:FUNCtion:NDBDown:RESult? (p. 80)
● CALCulate:MARKer<m>:FUNCtion:NDBDown:STATe <State> (p. 80)
● CALCulate:MARKer<m>:FUNCtion:NOISe[:STATe] <State> (p. 81)
● CALCulate:MARKer<m>:FUNCtion:NOISe:RESult? (p. 81)
● CALCulate:MARKer<m>:FUNCtion:REFerence (p. 82)
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 75
CALCulate:MARKer<m>:COUNt:FREQuency?
This command performs a frequency measurement at the marker position and
returns the result.
To get a valid result, you have to perform a complete sweep with synchronization
to the sweep end to make sure that the R&S FSH actually reaches the frequency
you want to measure. This is only possible in single sweep mode.
Before you can use the command, you have to turn on the frequency counter with
CALCulate:MARKer<m>:COUNt[:STATe] <State>.
Example
See CALCulate:MARKer<m>:COUNt[:STATe] <State>.
Characteristics
*RST value: –
SCPI: device–specific
CALCulate:MARKer<m>:COUNt:RESolution:MODE <Resolution>
This command selects the resolution of the frequency counter.
Parameter
<State>
HIGH | LOW
Parameter
<Resolution>
HIGH
Frequency counter resolution 0.1 mHz.
LOW
Frequency counter resolution: 0.1 Hz.
Example
See CALCulate:MARKer<m>:COUNt[:STATe] <State>.
Characteristics
*RST value: –
SCPI: device–specific
CALCulate:MARKer<m>:COUNt[:STATe] <State>
This command turns the frequency counter at the marker position on and off.
You can read out the result with CALCulate:MARKer<m>:COUNt:FREQuency?.
Frequency counting is possible only for one marker at a time. If it is activated for
another marker, it is automatically deactivated for the previous marker.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 76
To get a valid result, you have to perform a complete sweep with synchronization
to the sweep end to make sure that the R&S FSH actually reaches the frequency
you want to measure. This is only possible in single sweep mode.
The suffix <m> selects the marker.
Parameter
<State>
ON | OFF
Example
INIT:CONT OFF
CALC:MARK ON
Turns on single sweep mode and marker 1.
CALC:MARK:COUN:RES:MODE HIGH
Selects the resolution of the frequency counter for marker 1.
CALC:MARK:COUN ON
Turns on the frequency counter for marker 1.
INIT;*WAI
CALC:MARK:COUN:FREQ?
Performs a measurement and queries the results of the frequency counter.
Characteristics
*RST value: OFF
SCPI: device–specific
CALCulate:MARKer<m>:FREQuency:MODE <InputMode>
This command selects the marker frequency display mode.
Parameter
<InputMode>
FREQuency
Sets the marker frequency mode to frequency input (in Hz).
CHANnel
Sets the marker frequency mode to channel input (as a channel number).
Example
CALC:MARK:FREQ:MODE FREQ
Selects the frequency display mode.
Characteristics
*RST value: FREQ
SCPI: device-specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 77
CALCulate:MARKer<m>:FUNCtion:CENTer
This command matches the center frequency to the frequency of a marker
If you use a delta marker, the R&S FSH turns it into a normal marker.
The suffix <m> selects the marker.
This command is an event and therefore has no *RST value and no query.
Example
CALC:MARK1:FUNC:CENT
Matches the center frequency to the frequency of marker 1.
Characteristics
*RST value: SCPI: device-specific
CALCulate:MARKer<m>:FUNCtion:DEModulation[:STATe] <State>
This command turns the audio demodulator on and off when the measurement hits
a marker position.
With a span greater than 0, you can define a hold time at the marker position with
CALCulate:MARKer<m>:FUNCtion:DEModulation:HOLDoff <Time>.
In zero span the demodulation is on permanently.
Parameter
<State>
ON | OFF
Example
CALC:MARK3:FUNC:DEM ON
Switches on the demodulation for marker 3.
Characteristics
*RST value: OFF
SCPI: device–specific
CALCulate:MARKer<m>:FUNCtion:DEModulation:HOLDoff <Time>
This command defines the hold time at the marker position for the demodulation
with span > 0.
Parameter
<Time>
Numeric value in the range from 10 ms to 500 s.
Example:
CALC:MARK:FUNC:DEM:HOLD 3s
Sets a hold time of 3 seconds.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 78
Characteristics:
*RST value: – (DEModulation is set to OFF)
SCPI: device–specific
CALCulate:MARKer<m>:FUNCtion:DEModulation:SELect <Demodulation>
This command selects the type of demodulation type for the audio demodulator.
Parameter
<Demodulation>
AM | FM
Example
CALC:MARK:FUNC:DEM:SEL FM
Selects FM demodulation.
Characteristics
*RST value: AM
SCPI: device–specific
CALCulate:MARKer<m>:FUNCtion:NDBDown <Distance>
This command defines the distance of the n dB down markers to the reference
marker.
Parameter
<Distance>
Distance of the temporary markers to the reference marker in dB.
Example
See CALCulate:MARKer<m>:FUNCtion:NDBDown:STATe <State>
Characteristics
*RST value: 3 dB
SCPI: device-specific
CALCulate:MARKer<m>:FUNCtion:NDBDown:FREQuency?
This command queries the horizontal position of the n dB down markers.
Return value
<frequency1>
Absolute frequency of the n dB marker to the left of the reference marker in
Hz.
<frequency2>
Absolute frequency of the n dB marker to the right of the reference marker in
Hz.
Example
See CALCulate:MARKer<m>:FUNCtion:NDBDown:STATe <State>
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 79
Characteristics
*RST value: SCPI: device-specific
CALCulate:MARKer<m>:FUNCtion:NDBDown:RESult?
This command queries the frequency spacing or bandwidth of the n dB down
markers.
Return value
<Bandwidth>
Bandwidth in Hz.
Example
See CALCulate:MARKer<m>:FUNCtion:NDBDown:STATe <State>
Characteristics
*RST value: SCPI: device-specific
CALCulate:MARKer<m>:FUNCtion:NDBDown:STATe <State>
This command turns the n dB Down marker function on and off.
Parameter
<State>
ON | OFF
Example
CALC:MARK:FUNC:NDBD:STAT ON
Turns on the n dB marker function.
CALC:MARK:FUNC:NDBD 3
Positions two temporary markers 3 dB below a reference marker.
CALC:MARK:FUNC:NDBD:FREQ?
Queries the frequency position of the n dB Down markers; would return e.g.
100000000,200000000
CALC:MARK:FUNC:NDBD:RES?
Queries the measurement result; would return e.g.
100000000
Characteristics
*RST value: OFF
SCPI: device-specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 80
CALCulate:MARKer<m>:FUNCtion:NOISe[:STATe] <State>
This command turns the noise measurement for all markers on and off.
You can query the results of the noise power density at the marker position with
CALCulate:MARKer<m>:FUNCtion:NOISe:RESult?.
Parameter
<State>
ON | OFF
Example
See CALCulate:MARKer<m>:FUNCtion:NOISe:RESult?.
Characteristics
*RST value: OFF
SCPI: device–specific
CALCulate:MARKer<m>:FUNCtion:NOISe:RESult?
This command queries the result of the noise measurement.
To get a valid result, you have to perform a complete sweep with synchronization
to the sweep end before reading out the result. This is only possible in single
sweep mode.
This command is an event and therefore has no *RST value and no query.
Return value
<NoiseLevel>
The unit depends on UNIT<n>:POWer.
Example
INIT:CONT OFF
Turns on single sweep mode.
CALC:MARK2 ON
CALC:MARK2:FUNC:NOIS ON
Turns on marker 2 and assigns the noise measurement to that marker.
INIT;*WAI
CALC:MARK2:NOIS:RES?
Performs the measurement and queries the noise marker results.
Characteristics
*RST value: –
SCPI: device–specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 81
CALCulate:MARKer<m>:FUNCtion:REFerence
This command matches the reference level to the power level of a marker
If you use a delta marker, the R&S FSH turns it into a normal marker.
This command is an event and therefore has no *RST value and no query.
Example
CALC:MARK1:FUNC:REF
Matches the reference level to the power level of marker 1.
Characteristics
*RST value: SCPI: device-specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 82
7.2.7 Using Display Lines and Limit Lines
7.2.7.1 Display Lines
The following commands define the position of the display line.
The suffix <n> at CALCulate selects the trace. Its range is {1..2}. Only relevant for
segmented sweep.
List of commands
● CALCulate<n>:DLINe <Amplitude> (p. 83)
● CALCulate<n>:DLINe:STATe <State> (p. 83)
CALCulate<n>:DLINe <Amplitude>
This command defines the position of a display line.
Parameter
<Amplitude>
Numeric value with a variable range and unit.
You can use any unit you want, the R&S FSH then converts the unit to the
currently selected unit. If you omit a unit, the R&S FSH uses the currently selected
unit.
Example
CALC:DLIN –20dBm
Sets the display line threshold to -20 dBm.
Characteristics
*RST value: – (STATe to OFF)
SCPI: device–specific
CALCulate<n>:DLINe:STATe <State>
This command turns display lines on and off.
Parameter
<State>
ON | OFF
Example
CALC:DLIN:STAT OFF
Turns on the display line.
Characteristics
*RST value: OFF
SCPI: device–specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 83
7.2.7.2 Limit Lines
The following commands define limit lines and perform the corresponding limit checks.
The suffix <n> in the following commands selects the trace. Its range is {1..2}. Only
relevant for segmented sweep.
The suffix <k> at LIMit selects the limit line and is in the range <1…2>.
List of commands
● CALCulate<n>:LIMit<k>:BEEP[:STATe] <State> (p. 84)
● CALCulate<n>:LIMit<k>:COMMent? (p. 84)
● CALCulate<n>:LIMit<k>:DEFine (p. 85)
● CALCulate<n>:LIMit<k>:DELete (p. 86)
● CALCulate<n>:LIMit<k>:FAIL? (p. 86)
● CALCulate<n>:LIMit<k>:LOWer:SELect <LimitLine> (p. 86)
● CALCulate<n>:LIMit<k>:LOWer:THReshold <Level> (p. 87)
● CALCulate<n>:LIMit<k>:STATe <State> (p. 87)
● CALCulate<n>:LIMit<k>:UNIT:X? (p. 87)
● CALCulate<n>:LIMit<k>:UNIT[:Y]? (p. 88)
● CALCulate<n>:LIMit<k>:UPPer:SELect <LimitLine> (p. 88)
● CALCulate<n>:LIMit<k>:UPPer:THReshold <Level> (p. 88)
CALCulate<n>:LIMit<k>:BEEP[:STATe] <State>
This command turns the beeper that beeps if a limit line is violated on and off.
Parameter
<State>
ON | OFF
Example
CALC:LIM:BEEP ON
Activates the audio beep.
Characteristics
*RST value: OFF
SCPI: device-specific
CALCulate<n>:LIMit<k>:COMMent?
This command queries the description of a limit line.
This command is a query and therefore has no RST value.
Return value
<Comment>
String containing the description of the limit line.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 84
Example
CALC:LIM:COMM?
Queries the description of limit line 1.
Characteristics
*RST value: SCPI: device-specific
CALCulate<n>:LIMit<k>:DEFine
<Name>,<Comment>,<Unit>,<Scale>,<Unit>,<x1>,<y1>[,<xn>,<yn>]
This command defines the shape of a limit line.
After you have defined the shape of the limit line you still have to activate it with
CALCulate<n>:LIMit<k>:UPPer:SELect <LimitLine> before it takes effect.
Parameters
<Name>
String containing the name of the limit line.
Note: if a limit line with the same name already exists, it will be overwritten.
<Comment>
String containing a comment for the limit line.
<X-unit>
Unit of the x-axis. HZ | S | M
<Scale>
Scale of the x-axis: ABS | REL
<Y-unit>
Unit of the y-axis: DB | DBM | DBUV | DBMV | DBUVM | DBUAM | VSWR | V | W
<x1>,<xn>
Data points on the x-axis.
Note: a limit line may consist of up to 100 horizontal data points.
<y1>,<yn>
Data points on the y-axis.
Example
CALC:LIM:DEF 'Line','Example',HZ,ABS,DBM,10000000,-10,
10000000,0,20000000,0
Defines a limit line with three data points.
Characteristics
*RST value: SCPI: device-specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 85
CALCulate<n>:LIMit<k>:DELete
This command deletes a limit line.
This command is an event and therefore has no *RST value and no query.
Example
CALC:LIM2:DEL
Deletes the second limit line
Characteristics
*RST value: SCPI: device-specific
CALCulate<n>:LIMit<k>:FAIL?
This command queries the result of a limit check.
To get a valid result, you have to perform a complete sweep with synchronization
to the sweep end before reading out the result. This is only possible in single
sweep mode.
Return value
0 for PASS and 1 for FAIL
Example
INIT;*WAI
CALC:LIM1:FAIL?
Performs a measurement and queries the result of the check for limit line 1.
Characteristics
*RST value: SCPI: conform
CALCulate<n>:LIMit<k>:LOWer:SELect <LimitLine>
This command selects the lower limit line.
This command is an event and therefore has no *RST value and no query.
Parameter
<LimitLine>
String containing the file name of the lower limit line.
Example
CALC:LIM:LOW:SEL 'GSM_Lower.rellim'
Selects the lower limit line.
Characteristics
*RST value:
SCPI: conform
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 86
CALCulate<n>:LIMit<k>:LOWer:THReshold <Level>
This command defines the level of a lower threshold limit line.
Parameter
<Level>
Numeric value whose unit depends on the unit you have currently selected for the
vertical axis.
Example
CALC:LIM:LOW:THR -10DBM
Defines a threshold of -10 dBm
Characteristics
*RST value: SCPI: device-specific
CALCulate<n>:LIMit<k>:STATe <State>
This command turns a limit check on and off.
You can query the result of the limit check with
CALCulate<n>:LIMit<k>:FAIL?.
Parameter
<State>
ON | OFF
Example
CALC:LIM:STAT ON
Switches on the limit check for limit line 1.
Characteristics
*RST value: OFF
SCPI: conform
CALCulate<n>:LIMit<k>:UNIT:X?
This command queries the horizontal unit of a limit line.
This command is a query and therefore has no *RST value.
Example
CALC:LIM:UNIT:X?
Queries the x-unit of the first limit line.
Characteristics
*RST value: SCPI: device-specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 87
CALCulate<n>:LIMit<k>:UNIT[:Y]?
This command queries the vertical unit of a limit line.
This command is a query and therefore has no *RST value.
Example
CALC:LIM1:UNIT?
Queries the y-unit of the first limit line.
Characteristics
*RST value: SCPI: device-specific
CALCulate<n>:LIMit<k>:UPPer:SELect <LimitLine>
This command selects the upper limit line.
This command is an event and therefore has no *RST value and no query.
Parameter
<LimitLine>
string containing the file name of the upper limit line
Example
CALC:LIM:UPP:SEL 'GSM_Upper.rellim'
Selects the upper limit line.
Characteristics
*RST value: SCPI: conform
CALCulate<n>:LIMit<k>:UPPer:THReshold <Level>
This command defines the level of an upper threshold limit line.
Parameter
<Level>
Numeric value whose unit depends on the unit you have currently selected for the
vertical axis.
Example
CALC:LIM:UPP:THR -10DBM
Defines a threshold of -10 dBm
Characteristics
*RST value: SCPI: device-specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 88
7.2.8 Configuring and Using Measurement Functions
The R&S FSH provides measurement functions that allow you to perform advanced
measurements and can also be controlled remotely.
General measurement functions:
● Working with Channel Tables on page 89
Power measurements:
● Power Measurements on page 92
● Measuring the Channel Power on page 96
● Measuring the Occupied Bandwidth on page 97
● TDMA Measurements on page 98
● Measuring the Adjacent Channel Leakage Ratio on page 99
● Measuring the Spectrum Emission Mask on page 116
● Measuring Spurious Emissions on page 118
● Using the Segmented Sweep on page 119
Other measurements
● Measuring the Harmonic Distortion on page 112
● Measuring the AM Modulation Depth on page 114
Isotropic Antenna
● Using an Isotropic Antenna on page 120
7.2.8.1 Working with Channel Tables
Use the following commands to work with channel tables.
The suffix <n> in the following commands selects the trace. Its range is {1..2}. Only
relevant for segmented sweep.
List of commands
● [SENSe:]CHANnel<n> <ChannelNumber> (p. 90)
● [SENSe:]CHANnel:TABLe:SELect <ChannelTable> (p. 90)
● [SENSe]:CHANnel<n>:TABLe:SELect:DOWNlink <ChannelTable> (p. 91)
● [SENSe]:CHANnel<n>:TABLe:SElect:UPLink <ChannelTable> (p. 91)
● [SENSe]:CHANnel<n>:TABLe:SET <Direction> (p. 91)
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 89
[SENSe:]CHANnel<n> <ChannelNumber>
This command selects the channel to be analyzed.
You have to set the frequency mode with [SENSe:]FREQuency:INPut:MODE to
channel first.
Parameter
<ChannelNumber>
numeric value that selects the number of the channel to be analyzed
Example
See [SENSe:]CHANnel:TABLe:SELect <ChannelTable>.
Characteristics
*RST value:depends on the channel table
SCPI: conform
[SENSe:]CHANnel:TABLe:SELect <ChannelTable>
This command selects a channel table configured for the link direction you have
selected with [SENSe]:CHANnel<n>:TABLe:SET <Direction>.
Note that if you have previously selected a channel table with
[SENSe]:CHANnel<n>:TABLe:SELect:DOWNlink <ChannelTable> or
[SENSe]:CHANnel<n>:TABLe:SElect:UPLink <ChannelTable>, this
command replaces that file.
Parameter
<ChannelTable>
String containing the file name of the channel table.
Example
CHAN:TABL:SET UP
Selects channel tsble selection for uplink signals.
CHAN:TABL:SEL 'TV China.CHNTAB'
Loads the channel table with the name 'TV China' for the uplink.
CHAN:TABL:SEL 'TV Italy.chntab'
or
CHAN:TABL:SEL:UPL 'TV Italy.chntab'
Both commands replace the uplink channel table 'TV China' with 'TV Italy'.
Downlink channel tables are not affected by the commands sent so far.
FREQ:INP:MODE CHAN
CHAN 10
Select a particular uplink channel (e.g. #10) instead of a (center) frequency.
To select an additional downlink channel table, use either:
CHAN:TABL:SET DOWN
CHAN:TABL:SEL 'TV Italy.chntab'
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 90
or
CHAN:TABL:SEL:DOWN 'TV Italy.chntab'
Characteristics
*RST value: ' '
SCPI: device-specific
[SENSe]:CHANnel<n>:TABLe:SELect:DOWNlink <ChannelTable>
This command selects a channel table configured for downlink signals.
Parameter
<ChannelTable>
string containing the name of the channel table.
Example
See [SENSe:]CHANnel:TABLe:SELect <ChannelTable>.
Characteristics
*RST value: ' '
SCPI: device-specific
[SENSe]:CHANnel<n>:TABLe:SElect:UPLink <ChannelTable>
This command selects a channel table configured for uplink signals.
Parameter
<ChannelTable>
string containing the name of the channel table.
Example
See [SENSe:]CHANnel:TABLe:SELect <ChannelTable>.
Characteristics
*RST value: ' '
SCPI: device-specific
[SENSe]:CHANnel<n>:TABLe:SET <Direction>
This command selects the link direction for measurements with channel tables.
Parameter
<Direction>
DOWN
Selects the downlink.
UP
Selects the uplink.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 91
Example
See [SENSe:]CHANnel:TABLe:SELect <ChannelTable>.
Characteristics
*RST value: UP
SCPI: device-specific
7.2.8.2 Power Measurements
The following commands configure power measurements. To perform the actual
measurement, use the commands described in section "Performing and Triggering
Measurements".
The suffix <n> in the following commands selects the trace. Its range is {1..2}. Only
relevant for segmented sweep.
List of commands
● CALCulate:MARKer:FUNCtion:POWer:SELect <Measurement> (p. 92)
● CALCulate:MARKer:FUNCtion:POWer[:STATe] <State> (p. 93)
● CALCulate<n>:MARKer:FUNCtion:POWer:PRESet <Standard> (p. 93)
● CALCulate<n>:MARKer:FUNCtion:POWer:PRESet:CHECk? (p. 93)
● CALCulate<n>:MARKer:FUNCtion:LEVel:ONCE (p. 94)
● CALCulate<n>:MARKer:FUNCtion:POWer:RESult? <Measurement> (p. 94)
CALCulate:MARKer:FUNCtion:POWer:SELect <Measurement>
This command selects a power measurement and turns the measurement on.
Parameter
ACPower |
MCACpower
Adjacent Channel Leakage Ratio measurement (ACLR or ACP)
CPOWer
Chanel power measurement
OBANdwidth |
OBWidth
Occupied Bandwidth measurement
TDMA
TDMA power measurement
Example
CALC:MARK:FUNC:POW:SEL CPOW
Selects the channel power measurement
Characteristics
*RST value: –
SCPI: device–specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 92
CALCulate:MARKer:FUNCtion:POWer[:STATe] <State>
This command turns a power measurement on and off.
You can select a power measurement with
CALCulate:MARKer:FUNCtion:POWer:SELect <Measurement>.
Parameter
ON
Turns the power measurement on.
OFF
Performs a basic spectrum measurement.
Example
CALC:MARK:FUNC:POW OFF
Switches off the power measurement.
Characteristics
*RST value: OFF
SCPI: device–specific
CALCulate<n>:MARKer:FUNCtion:POWer:PRESet <Standard>
This command selects one of the predefined configurations for a
telecommunications standard. This command only works if you have turned on
power measurements with CALCulate:MARKer:FUNCtion:POWer[:STATe]
<State>.
The configuration for a standard is in line with the specifications and includes
parameters like weighting filter, channel bandwidth and spacing, resolution and
video bandwidth, as well as detector and sweep time.
Parameter
<Standard>
string containing the file name of the standard
Example
CALC:MARK:FUNC:POW:PRES '3GPP WCDMA.chpstd'
Selects the 3GPP WCDMA standard for channel power measurements.
Characteristics
*RST value: SCPI: device-specific
CALCulate<n>:MARKer:FUNCtion:POWer:PRESet:CHECk?
This command checks if the current settings are in line with the settings defined by
the standard selected with CALCulate<n>:MARKer:FUNCtion:POWer:PRESet
<Standard>.
Note that the command only checks those parameters that are defined by the
standard.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 93
This command is a query and therefore has no *RST value.
Return value
0
R&S FSH settings violate a standard configuration.
1
R&S FSH settings comply with the standard.
Example
CALC:MARK:FUNC:POW:PRES:CHEC?
Queries compliance to the standard currently in use.
Characteristics
*RST value: SCPI: device-specific
CALCulate<n>:MARKer:FUNCtion:LEVel:ONCE
This command adjusts the reference level to the measured signal power.
This automatic routine makes sure that the that the signal power level does not
overload the R&S FSH or limit the dynamic range by too small a S/N ratio.
To determine the best reference level, the R&S FSH aborts current measurements
and performs a series of test sweeps. After it has finished the test, it continues with
the actual measurement.
This command is an event and therefore has no *RST value and no query.
Example
CALC:MARK:FUNC:LEV:ONCE
Initiates an automatic level adjust routine.
Characteristics
*RST value: SCPI: device–specific
CALCulate<n>:MARKer:FUNCtion:POWer:RESult? <Measurement>
This command queries the results of power measurements.
To get a valid result, you have to perform a complete sweep with synchronization
to the sweep end before reading out the result. This is only possible in single
sweep mode.
Before you can use this command, you have to select the power measurement
with CALCulate:MARKer:FUNCtion:POWer:SELect <Measurement> and
activate it with CALCulate:MARKer:FUNCtion:POWer[:STATe] <State>.
This command is a query and therefore has no *RST value.
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 94
Parameter and return value
ACPower |
MCACpower
Returns the results for ACLR measurements
The number of return values depends on the number of TX and adjacent
channel. The order of return values is:
− power of the transmission channel
− power of the lower adjacent channel
− power of the upper adjacent channel
− power of the lower alternate channel 1
− power of the upper alternate channel 2
− etc.
The unit of the return values depends on the scaling of the vertical axis:
− logarithmic scaling returns the power in the currently selected unit (see
UNIT<n>:POWer).
− linear scaling returns the power in W.
CPOWer
Returns the results for channel power measurements
The return value is the power of the channel. The unit depends on the
scaling of the vertical axis:
− logarithmic scaling returns the power in the currently selected unit (see
UNIT<n>:POWer).
− linear scaling returns the power in W.
OBANdwidth |
OBWidth
Returns the results for measurements of the occupied bandwidth.
The return value is the occupied bandwidth in Hz.
TDMA
Returns the results for TDMA power measurements.
The return value is the power of the signal. The unit depends on the scaling
of the vertical axis:
− logarithmic scaling returns the power in the currently selected unit (see
UNIT<n>:POWer).
− linear scaling returns the power in W.
Example of occupied bandwidth measurement
POW:BAND 90PCT
Defines the occupied bandwidth (90%).
INIT:CONT OFF
INIT;*WAI
CALC:MARK:FUNC:POW:RES? OBW
Turns on single sweep mode, performs a measurement and queries the results.
Characteristics
*RST value: SCPI: device–specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 95
7.2.8.3 Measuring the Channel Power
The following commands configure channel power measurements. To perform the
actual measurement, use the commands described in section "Performing and
Triggering Measurements".
The suffix <m> at MARKer is irrelevant.
The suffix <n> in the following commands selects the trace. Its range is {1..2}. Only
relevant for segmented sweep.
List of commands
● CALCulate<n>:MARKer<m>:FUNCtion:CPOWer:BANDwidth <Bandwidth> (p. 96)
● CALCulate<n>:MARKer<m>:FUNCtion:CPOWer:MODE <DisplayMode> (p. 96)
● CALCulate<n>:MARKer<m>:FUNCtion:CPOWer:UNIT <Unit> (p. 97)
● CALCulate<n>:MARKer<m>:FUNCtion:POWer:RESult:PHZ <State> (p. 97)
CALCulate<n>:MARKer<m>:FUNCtion:CPOWer:BANDwidth <Bandwidth>
This command defines the channel bandwidth for channel power measurements.
Parameter
<Bandwidth>
Numeric value in Hz.
Example
CALC:MARK:FUNC:CPOW:BAND 4 MHZ
Sets the channel bandwidth to 4 MHz.
Characteristics
*RST value: 3.84 MHz
SCPI: device-specific
CALCulate<n>:MARKer<m>:FUNCtion:CPOWer:MODE <DisplayMode>
This command selects the display mode for channel power measurements.
Parameter
<DisplayMode>
CLR
Displays the currently measured value (Clear / Write).
MAX
Displays the highest measured value (Max Hold).
Example
CALC:MARK:FUNC:CPOW:MODE CLR
Selects clear/write trace mode
Characteristics
*RST value: CLR
SCPI: device-specific
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 96
CALCulate<n>:MARKer<m>:FUNCtion:CPOWer:UNIT <Unit>
This command selects the unit of the vertical axis for channel power
measurements.
Parameter
<Unit>
DBM | DBMV | DBUV | VOLT | WATT | V | W
Example
CALC:MARK:FUNC:CPOW:UNIT DBM
Sets the unit to dBm.
Characteristics
*RST value: dBm
SCPI: device-specific
CALCulate<n>:MARKer<m>:FUNCtion:POWer:RESult:PHZ <State>
This command turns the display of the channel power per Hertz on and off.
Parameter
ON | OFF
Example
CALC:MARK:FUNC:POW:RES:PHZ ON
Displays the measured Channel Power / Hz.
Characteristics
*RST value: dBm
SCPI: device-specific
7.2.8.4 Measuring the Occupied Bandwidth
The following commands configure the measurement of the Occupied Bandwidth. To
perform the actual measurement, use the commands described in section "Performing
and Triggering Measurements".
The suffix <m> at MARKer is irrelevant.
The suffix <n> in the following commands selects the trace. Its range is {1..2}. Only
relevant for segmented sweep.
List of commands
● CALCulate<n>:MARKer<m>:FUNCtion:OBAN:BANDwidth <Bandwidth> (p. 98)
● CALCulate<n>:MARKer<m>:FUNCtion:OBAN:BANDwidth:PCT <OBW> (p. 98)
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 97
CALCulate<n>:MARKer<m>:FUNCtion:OBAN:BANDwidth <Bandwidth>
This command defines the channel bandwidth for occupied bandwidth
measurements.
Instead of OBANwidth, you can also use the alias OBWidth
Parameter
<Bandwidth
Numeric value in Hz.
Example
CALC:MARK:FUNC:OBW:BAND 1 MHZ
Sets the channel bandwidth to 1 MHz
Characteristics
*RST value: 3.84 MHz
SCPI: device-specific
CALCulate<n>:MARKer<m>:FUNCtion:OBAN:BANDwidth:PCT <OBW>
This command defines the percentage of the total power that defines the occupied
bandwidth.
Instead of OBANwidth, you can also use the alias OBWidth
Parameter
<Percentage>
Numeric value in the range from 10% to 99.9%.
Example
CALC:MARK:FUNC:OBW:BAND:PCT 95
Sets the power percentage to 95%
Characteristics
*RST value: 99%
SCPI: device-specific
7.2.8.5 TDMA Measurements
The following commands configure TDMA measurements. To perform the actual
measurement, use the commands described in section "Performing and Triggering
Measurements".
The suffix <m> at MARKer is irrelevant.
List of commands
● CALCulate:MARKer<m>:FUNCtion:TDMA:BURSt <BurstLength> (p. 99)
R&S FSH Remote Control – Commands
Remote Commands of the Spectrum Analyzer
Software Manual 1173.0089.12 - 33 98
CALCulate:MARKer<m>:FUNCtion:TDMA:BURSt <BurstLength>
This command defines the burst length of the TDMA signal.
Parameter
<BurstLength>
Numeric value in seconds.
The value range depends on the current sweep time.
Example
CALC:MARK:FUNC:TDMA:BURS 80 US
Sets the burst length to 80 us.
Characteristics
*RST value: 470 us
SCPI: device-specific
7.2.8.6 Measuring the Adjacent Channel Leakage Ratio
The following commands configures Adjacent Channel Leakage Ratio (ACLR)
measurements. To perform the actual measurement, use the commands described in
section "Performing and Triggering Measurements".
The suffix <y> selects one of the 11 alternate channels. The range is <1…11>.
The suffix <k> at LIMit is irrelevant.
● Configuring and Performing the ACLR Measurement on page 99
● ACLR Limit Check on page 106
Configuring and Performing the ACLR Measurement
The following commands configure and perform the ACLR measurements.
List of commands
● CALCulate:MARKer:FUNCtion:ACPower:UNIT <Unit> (p. 100)
● [SENSe:]POWer:ACHannel:ACPairs <ChannelPairs> (p. 100)
● [SENSe:]POWer:ACHannel:BANDwidth[:CHANnel] <Bandwidth> (p. 100)
● [SENSe:]POWer:ACHannel:BANDwidth:ACHannel <Bandwidth> (p. 101)
● [SENSe:]POWer:ACHannel:BANDwidth:ALTernate<y> <Bandwidth> (p. 101)
● [SENSe:]POWer:ACHannel:MODE <PowerMode> (p. 102)
● [SENSe:]POWer:ACHannel:PRESet:RLEVel (p. 102)
● [SENSe:]POWer:ACHannel:REFerence:TXCHannel:AUTO <RefChannel> (p. 102)
● [SENSe:]POWer:ACHannel:REFerence:TXCHannel:MANual <RefChannel> (p.
103)
● [SENSe:]POWer:ACHannel:SPACing[:ACHannel] (p. 103)
● [SENSe:]POWer:ACHannel:SPACing:ALTernate<y> <Spacing> (p. 105)
● [SENSe:]POWer:ACHannel:SPACing:CHANnel<Tx> <Spacing> (p. 105)
● [SENSe:]POWer:ACHannel:TXCHannel:COUNt <TxChannels> (p. 105)
Loading...