Rigol SA5000 Series Operating instructions

RIGOL
Programming Guide
Vector Signal Analysis
Measurement Application
Applicable to RSA5000-VSA
Jan. 2019
RIGOL (SUZHOU) TECHNOLOGIES, INC.

RIGOL
VSA Programming Guide I
Guaranty and Declaration
Copyright
© 2018 RIGOL (SUZHOU) TECHNOLOGIES, INC. All Rights Reserved.
Trademark Information
RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES, INC.
Publication Number
PGD22100-1110
Software Version
00.02.00
Software upgrade might change or add product features. Please acquire the latest version of the manual
from RIGOL website or contact RIGOL to upgrade the software.
Notices
RIGOL products are covered by P.R.C. and foreign patents, issued and pending.
RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at
the company’s sole decision.
Information in this publication replaces all previously released materials.
Information in this publication is subject to change without notice.
RIGOL shall not be liable for either incidental or consequential losses in connection with the furnishing,
use, or performance of this manual, as well as any information contained.
Any part of this document is forbidden to be copied, photocopied, or rearranged without prior written
approval of RIGOL.
Product Certification
RIGOL guarantees that this product conforms to the national and industrial standards in China as well as
the ISO9001:2015 standard and the ISO14001:2015 standard. Other international standard conformance
certifications are in progress.
Contact Us
If you have any problem or requirement when using our products or this manual, please contact RIGOL.
E-mail: [e-mail]
Website: www.rigol.com

RIGOL
II VSA Programming Guide
Document Overview
This manual introduces how to program and control RIGOL RSA5000 series spectrum analyzer (VSA mode)
by using SCPI commands through the USB or LAN interface.
Main Topics in this Manual:
Chapter 1 Programming Overview
This chapter introduces how to set up remote communication between the spectrum analyzer and the PC,
the remote control methods, the syntax, symbols, parameters, and abbreviation rules of the SCPI
commands.
Chapter 2 Command System
This chapter introduces the syntax, function, parameters, and usage of each command in VSA mode for the
RSA5000 series.
Tip
For the latest version of this manual, download it from the official website of
RIGOL
(www.rigol.com).
Format Conventions in this Manual:
1. Keys:
The keys on the front panel are usually denoted by the format of "Key Name (Bold) + Text Box". For
example, FREQ denotes the FREQ key.
2. Menu Keys:
The menu softkeys are usually denoted by the format of "Menu Word (Bold) + Character Shading". For
example, Center Freq denotes the center frequency menu item under the FREQ function key.
3. Connectors:
The connectors on the front or rear panel are usually denoted by the format of "Connector Name (Bold)
+ Square Brackets (Bold)". For example, [Gen Output 50Ω].
4. Operation Procedures:
indicates the next step of operation. For example, FREQ Center Freq indicates pressing FREQ
on the front panel and then pressing the menu softkey Center Freq.
Content Conventions in this Manual:
The RSA5000 series spectrum analyzer includes the following models. Unless otherwise specified, this
manual takes RSA5065 as an example to illustrate the usage of each command.
Model
Frequency Range
TG
RSA5065
9 kHz to 6.5 GHz
None
RSA5032
9 kHz to 3.2 GHz
None
RSA5065-TG
9 kHz to 6.5 GHz
6.5 GHz
RSA5032-TG
9 kHz to 3.2 GHz
3.2 GHz

Contents RIGOL
VSA Programming Guide III
Contents
Guaranty and Declaration ......................................................................................................... I
Document Overview .................................................................................................................II
Chapter 1 Programming Overview......................................................................................1-1
Build Remote Communication....................................................................................................1-2
Remote Control Method ............................................................................................................1-3
SCPI Command Overview..........................................................................................................1-4
Syntax...............................................................................................................................1-4
Symbol Description ............................................................................................................1-4
Parameter Type..................................................................................................................1-5
Command Abbreviation ......................................................................................................1-5
Chapter 2 Command System...............................................................................................2-1
:CALCulate Commands..............................................................................................................2-2
:CALCulate:DDEMod:MARKer:AOFF.....................................................................................2-3
:CALCulate:DDEMod:MARKer:COUPle[:STATe] .....................................................................2-3
:CALCulate:DDEMod:MARKer:TABLe[:STATe] .......................................................................2-3
:CALCulate:DDEMod:MARKer<n>:CPSearch[:STATe]............................................................2-4
:CALCulate:DDEMod:MARKer<n>:FUNCtion ........................................................................2-4
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:LEFT ......................................................2-5
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:RIGHt.....................................................2-5
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:SPAN......................................................2-6
:CALCulate:DDEMod:MARKer<n>:MAXimum .......................................................................2-7
:CALCulate:DDEMod:MARKer<n>:MAXimum:LEFT...............................................................2-7
:CALCulate:DDEMod:MARKer<n>:MAXimum:NEXT ..............................................................2-7
:CALCulate:DDEMod:MARKer<n>:MAXimum:PREVious.........................................................2-8
:CALCulate:DDEMod:MARKer<n>:MAXimum:RIGHt .............................................................2-8
:CALCulate:DDEMod:MARKer<n>:MINimum........................................................................2-8
:CALCulate:DDEMod:MARKer<n>:MODE .............................................................................2-9
:CALCulate:DDEMod:MARKer<n>:REFerence.......................................................................2-9
:CALCulate:DDEMod:MARKer<n>:TRACe .......................................................................... 2-10
:CALCulate:DDEMod:MARKer<n>:X .................................................................................. 2-11
:CALCulate:DDEMod:MARKer<n>:Y:IMAGinary.................................................................. 2-11
:CALCulate:DDEMod:MARKer<n>:Y[:REAL]....................................................................... 2-12
:CALCulate:MARKer<n>[:SET]:CENTer.............................................................................. 2-12
:CALCulate:MARKer<n>[:SET]:DELTa:CENTer.................................................................... 2-13
:CALCulate:MARKer<n>[:SET]:RLEVel............................................................................... 2-13
:CALCulate:MARKer<n>[:SET]:STARt................................................................................ 2-14
:CALCulate:MARKer<n>[:SET]:STEP................................................................................. 2-14
:CALCulate:MARKer<n>[:SET]:STOP................................................................................. 2-15
:CALibration Commands.......................................................................................................... 2-16
:CALibration:[ALL]............................................................................................................ 2-16
:CALibration:AUTO........................................................................................................... 2-16
:CONFigure Commands........................................................................................................... 2-17
:CONFIgure:BERate ......................................................................................................... 2-17
:CONFigure:DDEMod........................................................................................................ 2-17
:DISPlay Commands ............................................................................................................... 2-18
:DISPlay:BACKlight........................................................................................................... 2-19
:DISPlay:DDEMod:TRACe<n>:DDEMod:EYE:COUNt........................................................... 2-19
:DISPlay:DDEMod:TRACe<n>:DDEMod:SYMBol:FORMat.................................................... 2-20
:DISPlay:DDEMod:TRACe<n>:FEED.................................................................................. 2-20
:DISPlay:DDEMod:TRACe<n>:FORMat.............................................................................. 2-21
:DISPlay:DDEMod:TRACe<n>:X[:SCALe]:COUPle .............................................................. 2-21
:DISPlay:DDEMod:TRACe<n>:X[:SCALe]:RLEVel ............................................................... 2-22
:DISPlay:DDEMod:TRACe<n>:X[:SCALe]:RPOSition........................................................... 2-23

RIGOL Contents
IV VSA Programming Guide
:DISPlay:DDEMod:TRACe<n>:X[:SCALe]:SPAN..................................................................2-23
:DISPlay:DDEMod:TRACe<n>:Y[:SCALe]:AUTO:ONCE........................................................2-24
:DISPlay:DDEMod:TRACe<n>:Y[:SCALe]:PDIVision............................................................2-24
:DISPlay:DDEMod:TRACe<n>:Y[:SCALe]:RLEVel................................................................2-25
:DISPlay:DDEMod:TRACe<n>:Y:UNIT:PREFerence.............................................................2-25
:DISPlay:DDEMod:WINDow:FORMat..................................................................................2-26
:DISPlay:ENABle...............................................................................................................2-26
:DISPlay:GRATicule[:STATe]..............................................................................................2-27
:DISPlay:HDMI[:STATe] ....................................................................................................2-27
:FETCh Commands..................................................................................................................2-28
:FETCh:BER?....................................................................................................................2-28
:FETCh:DDEMod?.............................................................................................................2-28
:FORMat Commands ...............................................................................................................2-29
:FORMat:BORDer .............................................................................................................2-29
:FORMat[:TRACe][:DATA].................................................................................................2-29
IEEE 488.2 Common Commands..............................................................................................2-31
*CLS................................................................................................................................2-32
*ESE................................................................................................................................2-32
*ESR?..............................................................................................................................2-32
*IDN?..............................................................................................................................2-33
*OPC...............................................................................................................................2-33
*RCL ...............................................................................................................................2-33
*RST ...............................................................................................................................2-34
*SAV ...............................................................................................................................2-34
*SRE ...............................................................................................................................2-34
*STB?..............................................................................................................................2-35
*TRG...............................................................................................................................2-35
*TST?..............................................................................................................................2-35
*WAI...............................................................................................................................2-36
:INITiate Command.................................................................................................................2-37
:INITiate:BER:RESTart......................................................................................................2-37
:INITiate:CONTinuous ......................................................................................................2-37
:INSTrument Commands..........................................................................................................2-38
:INSTrument:COUPle:FREQuency:CENTer ..........................................................................2-38
:INSTrument:DEFault........................................................................................................2-38
:INSTrument:NSELect.......................................................................................................2-39
:INSTrument[:SELect].......................................................................................................2-39
:MMEMory Commands.............................................................................................................2-40
:MMEMory:DELete............................................................................................................2-40
:MMEMory:LOAD:FMT.......................................................................................................2-40
:MMEMory:LOAD:STATe ....................................................................................................2-41
:MMEMory:LOAD:TRACe:DATA ..........................................................................................2-41
:MMEMory:MOVE..............................................................................................................2-42
:MMEMory:STORe:FMT.....................................................................................................2-42
:MMEMory:STORe:SCReen................................................................................................2-42
:MMEMory:STORe:STATe...................................................................................................2-43
:MMEMory:STORe:TRACe:DATA.........................................................................................2-43
[:SENSe] Commands...............................................................................................................2-44
[:SENSe]:ACQuisition:TIME...............................................................................................2-45
:INPut:IMPedance ............................................................................................................2-45
[:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]......................................................2-45
[:SENSe]:CORRection:SA[:RF]:GAIN..................................................................................2-46
[:SENSe]:DDEMod:ALPHa .................................................................................................2-46
[:SENSe]:DDEMod:FFT:WINDow[:TYPE] ............................................................................2-46
[:SENSe]:DDEMod:FILTer:MEASurement............................................................................2-47
[:SENSe]:DDEMod:FILTer:MEASurement:USER<n>[:DATA].................................................2-48
[:SENSe]:DDEMod:FILTer:REFerence .................................................................................2-48
[:SENSe]:DDEMod:FILTer:REFerence:USER<n>[:DATA]......................................................2-49

Contents RIGOL
VSA Programming Guide V
[:SENSe]:DDEMod:FSK:DEViation:REFerence..................................................................... 2-49
[:SENSe]:DDEMod:FSK:DEViation:REFerence:AUTO........................................................... 2-50
[:SENSe]:DDEMod:LOAD:KNOWndata............................................................................... 2-50
[:SENSe]:DDEMod:MODulation......................................................................................... 2-51
[:SENSe]:DDEMod:MSK:FORMat....................................................................................... 2-51
[:SENSe]:DDEMod:PPSYmbol............................................................................................ 2-52
[:SENSe]:DDEMod:RTTrace:DETector ............................................................................... 2-52
[:SENSe]:DDEMod:SRATe ................................................................................................. 2-53
[:SENSe]:DDEMod:STANdard:PRESet ................................................................................ 2-53
[:SENSe]:DDEMod:SWEep:POINts .................................................................................... 2-54
[:SENSe]:DDEMod:SYNC:ALENgth..................................................................................... 2-54
[:SENSe]:DDEMod:SYNC:BURSt:RUNIn ............................................................................. 2-55
[:SENSe]:DDEMod:SYNC:BURSt:STATe.............................................................................. 2-55
[:SENSe]:DDEMod:SYNC:SLENgth..................................................................................... 2-56
[:SENSe]:DDEMod:SYNC:SWORd:OFFSet .......................................................................... 2-56
[:SENSe]:DDEMod:SYNC:SWORd:PATTern......................................................................... 2-57
[:SENSe]:DDEMod:SYNC:SWORd:STATe............................................................................ 2-57
[:SENSe]:FREQuency:CENTer............................................................................................ 2-57
[:SENSe]:FREQuency:CENTer:STEP:AUTO ......................................................................... 2-58
[:SENSe]:FREQuency:CENTer:STEP[:INCRement] .............................................................. 2-58
[:SENSe]:FREQuency:SPAN?............................................................................................. 2-59
[:SENSe]:FREQuency:STARt ............................................................................................. 2-59
[:SENSe]:FREQuency:STOP .............................................................................................. 2-60
[:SENSe]:POWer[:RF]:RANGe........................................................................................... 2-60
:STATus Commands ................................................................................................................ 2-61
:STATus:OPERation:CONDition? ........................................................................................ 2-62
:STATus:OPERation:ENABle............................................................................................... 2-62
:STATus:OPERation[:EVENt]?............................................................................................ 2-63
:STATus:PRESet ............................................................................................................... 2-63
:STATus:QUEStionable:CONDition?.................................................................................... 2-63
:STATus:QUEStionable:ENABle .......................................................................................... 2-63
:STATus:QUEStionable[:EVENt]? ....................................................................................... 2-64
:SYSTem Commands............................................................................................................... 2-65
:SYSTem:BEEPer:STATe.................................................................................................... 2-66
:SYSTem:COMMunicate:LAN[:SELF]:APPLy ........................................................................ 2-66
:SYSTem:COMMunicate:LAN[:SELF]:AUToip:STATe............................................................. 2-66
:SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe............................................................... 2-67
:SYSTem:COMMunicate:LAN[:SELF]:IP:ADDRess................................................................ 2-67
:SYSTem:COMMunicate:LAN[:SELF]:IP:DNS:STATe............................................................. 2-68
:SYSTem:COMMunicate:LAN[:SELF]:IP:DNSBack................................................................ 2-68
:SYSTem:COMMunicate:LAN[:SELF]:IP:DNSPreferred......................................................... 2-69
:SYSTem:COMMunicate:LAN[:SELF]:IP:DNSServer ............................................................. 2-69
:SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway................................................................ 2-70
:SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask................................................................ 2-70
:SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe............................................................ 2-71
:SYSTem:COMMunicate:LAN[:SELF]:MDNS:STATe .............................................................. 2-71
:SYSTem:COMMunicate:LAN[:SELF]:RESet......................................................................... 2-72
:SYSTem:CONFigure:INFormation?.................................................................................... 2-72
:SYSTem:DATE................................................................................................................. 2-72
:SYSTem:FSWitch[:STATe]................................................................................................ 2-73
:SYSTem:LANGuage ......................................................................................................... 2-73
:SYSTem:LKEY................................................................................................................. 2-74
:SYSTem:OPTion:STATe? .................................................................................................. 2-74
:SYSTem:PON:TYPE ......................................................................................................... 2-75
:SYSTem:PRESet.............................................................................................................. 2-75
:SYSTem:PRESet:SAVE..................................................................................................... 2-75
:SYSTem:PRESet:TYPE ..................................................................................................... 2-76
:SYSTem:PRESet:USER:SAVE............................................................................................ 2-76

RIGOL Contents
VI VSA Programming Guide
:SYSTem:SCPI:DISPlay .....................................................................................................2-76
:SYSTem:SECurity:CLEar...................................................................................................2-77
:SYSTem:SHOW ...............................................................................................................2-77
:SYSTem:TIME .................................................................................................................2-78
:TRACe Command...................................................................................................................2-79
:TRACe<n>[:DATA]?........................................................................................................2-79
:TRIGger Commands...............................................................................................................2-80
:TRIGger[:SEQuence]:ATRigger.........................................................................................2-80
:TRIGger[:SEQuence]:ATRigger:STATe...............................................................................2-81
:TRIGger[:SEQuence]:EXTernal<n>:DELay........................................................................2-81
:TRIGger[:SEQuence]:EXTernal<n>:DELay:STATe..............................................................2-82
:TRIGger[:SEQuence]:EXTernal<n>:SLOPe........................................................................2-82
:TRIGger[:SEQuence]:FMT:CRITeria ..................................................................................2-83
:TRIGger[:SEQuence]:FMT:DELay .....................................................................................2-83
:TRIGger[:SEQuence]:FMT:DELay:STATe ...........................................................................2-84
:TRIGger[:SEQuence]:FMT:MASK ......................................................................................2-84
:TRIGger[:SEQuence]:FMT:MASK:EDIT..............................................................................2-85
:TRIGger[:SEQuence]:FMT:MASK:RELative:AMPLitude........................................................2-85
:TRIGger[:SEQuence]:FMT:MASK:RELative:FREQuency.......................................................2-86
:TRIGger[:SEQuence]:FMT:MASK<n>:BUILd .....................................................................2-87
:TRIGger[:SEQuence]:FMT:MASK<n>:DATA.......................................................................2-87
:TRIGger[:SEQuence]:FMT:MASK<n>:DELete....................................................................2-88
:TRIGger[:SEQuence]:FMT:MASK<n>:NAME .....................................................................2-88
:TRIGger[:SEQuence]:FMT:MASK<n>:NEW .......................................................................2-89
:TRIGger[:SEQuence]:HOLDoff .........................................................................................2-89
:TRIGger[:SEQuence]:HOLDoff:STATe ...............................................................................2-89
:TRIGger[:SEQuence]:LEVel..............................................................................................2-90
:TRIGger[:SEQuence]:SOURce..........................................................................................2-90
:TRIGger2:MODE .............................................................................................................2-91
Chapter 3 Appendix............................................................................................................ 3-1
Appendix A: Default Settings .....................................................................................................3-1
Appendix B: Warranty................................................................................................................3-3

Chapter 1 Programming Overview RIGOL
VSA Programming Guide 1-1
Chapter 1 Programming Overview
This chapter introduces how to set up remote communication between the spectrum analyzer and the PC,
the remote control methods, the syntax, symbols, parameters, and abbreviation rules of the SCPI
commands.
Contents in this chapter:
Build Remote Communication
Remote Control Method
SCPI Command Overview

RIGOL Chapter 1 Programming Overview
1-2 VSA Programming Guide
Build Remote Communication
RSA5000 supports communication with PC via USB and LAN interface for remote control. This section
introduces in details how to use Ultra Sigma to send commands through the USB interface to control the
analyzer.
Operation Procedures:
1. Install Ultra Sigma (PC) software
You can download Ultra Sigma from the official website of RIGOL (www.rigol.com) and install the
software according to the installation wizard.
2. Connect the analyzer to the PC and configure the interface parameters for the instrument
RSA5000 supports two communication interfaces: USB and LAN, as shown in the following figure.
Figure 1-1 RSA5000 Communication Interface
(1) Remote communication via USB:
Use the USB cable to connect the USB DEVICE interface on the rear panel of RSA5000 to the USB
HOST interface of the PC.
(2) Remote communication via LAN:
Make sure that your PC has been accessed to the local area network.
Check whether the local area network where your PC resides supports DHCP or auto IP mode.
If not, you need to obtain the available network interface parameters, including the IP
address, subnet mask, default gateway, and DNS.
Connect RSA5000 to the local area network by using the network cable.
Press System Interface LAN to configure the IP address, subnet mask, default
gateway, and DNS for the instrument.
3. Check whether the connection is successful
Run Ultra Sigma, and then search for the resources and right-click the resource name. Select "SCPI
Panel Control" to open the SCPI command control panel. In the SCPI command control panel, input a
correct command. After that, click Send Command first and then click Read Response. Or you can
also directly click Send & Read to verify whether the connection works properly. The following figure
takes USB interface as an example to illustrate it.
USB DEVICE
LAN

Chapter 1 Programming Overview RIGOL
VSA Programming Guide 1-3
Remote Control Method
1. User-defined programming
You can refer to the SCPI (Standard Commands for Programmable Instruments) commands listed in
Chapter 2 in this manual to control RSA5000 by programming in LabVIEW, Visual C++, and other
development environments. For details, refer to descriptions in Chapter 3 in
RSA5000 Programming
Guide
.
2. Send SCPI commands via the PC software
You can use the PC software to send commands to control RSA5000 remotely. RIGOL Ultra Sigma is
recommended. You can download the software from RIGOL official website (www.rigol.com).

RIGOL Chapter 1 Programming Overview
1-4 VSA Programming Guide
SCPI Command Overview
SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming
language that is built upon the existing standard IEEE 488.1 and IEEE 488.2 and conforms to various
standards, such as the floating point operation rule in IEEE 754 standard, ISO 646 7-bit coded character set
for information interchange (equivalent to ASCII programming). This chapter introduces the syntax,
symbols, parameters, and abbreviation rules of the SCPI commands.
Syntax
The SCPI commands provide a hierarchical tree structure, and consist of multiple subsystems. Each
command subsystem consists of one root keyword and one or more sub-keywords. The command line
usually starts with ":"; the keywords are separated by ":" and are followed by the parameter settings
available; "?" is added at the end of the command line to indicate a query; the commands and parameters
are separated by space.
For example,
:SENSe:FREQuency:CENTer <freq>
:SENSe:FREQuency:CENTer?
SENSe is the root keyword of the command. FREQuency and CENTer are the second-level and third-level
keywords respectively. The command line starts with ":", and a colon is also used to separate the
multiple-level keywords. <freq> represents the parameters available for setting. "?" represents query. The
command :SENSe:FREQuency:CENTer and the parameter <freq> are separated by a space.
In some commands with parameters, "," is often used to separate each parameter. For example,
:SYSTem:DATE <year>,<month>,<day>.
Symbol Description
The following four symbols are not part of the SCPI command, and they are not sent with the commands,
but taken as delimiters to better describe the parameters in the command.
1. Braces { }
The parameters enclosed in the braces are optional. You do not have to set it, also you can set for one
or more times.
2. Vertical Bar |
The vertical bar is used to separate multiple parameters. When using the command, you must select
one of the parameters. For example,
In the command :SYSTem:FSWitch[:STATe] OFF|ON|0|1, you can select any of the four available
parameters: OFF, ON, 0, or 1.
3. Square Brackets [ ]
The contents (command keywords) in the square brackets can be omitted. If the keyword is omitted, it
will be set to the default. For example,
for the [:SENSe]:POWer[:RF]:RANGe? command, sending any of the four commands below can
generate the same effect:
:POWer:RANGe?
:POWer:RF:RANGe?
:SENSe:POWer:RANGe?
:SENSe:POWer:RF:RANGe?
4. Angle Brackets < >
When sending the command, the parameter enclosed in the angle-bracket must contain an effective

Chapter 1 Programming Overview RIGOL
VSA Programming Guide 1-5
value. For example,
send the :SENSe:FREQuency:CENTer 1000 command in [:SENSe]:FREQuency:CENTer <freq> format.
Parameter Type
The command parameters introduced in this manual include 6 types: Bool, Keyword, Integer, Consecutive
Real Number, Discrete, and ASCII String.
1. Bool
The parameter can be set to OFF (0) or ON (1).
2. Keyword
The parameter can be any of the values listed.
3. Integer
Unless otherwise specified, the parameter can be any integer within the effective value range. Note:
Do not set the parameter to a decimal, otherwise, errors will occur.
4. Consecutive Real Number
Unless otherwise specified, the parameter could be any value within the effective value range
according to the accuracy requirement (by default, there are 9 digits after the decimal points).
5. Discrete
The parameter could only be one of the specified values and these values are discontinuous.
6. ASCII String
The parameter can be the combinations of ASCII characters.
Command Abbreviation
All the commands are case-insensitive. They can all be written in upper case or in lower case. For
abbreviations, you only need to input all the upper-case letters in the command. For example,
the :SYSTem:BEEPer:STATe? command can be abbreviated as :SYST:BEEP:STAT? or :syst:beep:stat?.

Chapter 2 Command System RIGOL
VSA Programming Guide 2-1
Chapter 2 Command System
This chapter introduces the commands of the RSA5000 series spectrum analyzer in VSA mode.
Contents in this chapter:
:CALCulate Commands
:CALibration Commands
:CONFigure Commands
:DISPlay Commands
:FETCh Commands
:FORMat Commands
IEEE 488.2 Common Commands
:INITiate Command
:INSTrument Commands
:MMEMory Commands
[:SENSe] Commands
:STATus Commands
:SYSTem Commands
:TRACe Command
:TRIGger Commands
Remarks:
1. For the command set, unless otherwise specified, the query command returns "N/A" (without
quotations in its return format) if no specified option is installed. If the queried function is disabled or
improper type match is found, the query command will return "Error" (without quotations in its return
format).
2. This manual takes RSA5065 as an example to illustrate the range of the parameters in each command.

RIGOL Chapter 2 Command System
2-2 VSA Programming Guide
:CALCulate Commands
Command List:
:CALCulate:DDEMod:MARKer:AOFF
:CALCulate:DDEMod:MARKer:COUPle[:STATe]
:CALCulate:DDEMod:MARKer:TABLe[:STATe]
:CALCulate:DDEMod:MARKer<n>:CPSearch[:STATe]
:CALCulate:DDEMod:MARKer<n>:FUNCtion
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:LEFT
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:RIGHt
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:SPAN
:CALCulate:DDEMod:MARKer<n>:MAXimum
:CALCulate:DDEMod:MARKer<n>:MAXimum:LEFT
:CALCulate:DDEMod:MARKer<n>:MAXimum:NEXT
:CALCulate:DDEMod:MARKer<n>:MAXimum:PREVious
:CALCulate:DDEMod:MARKer<n>:MAXimum:RIGHt
:CALCulate:DDEMod:MARKer<n>:MINimum
:CALCulate:DDEMod:MARKer<n>:MODE
:CALCulate:DDEMod:MARKer<n>:REFerence
:CALCulate:DDEMod:MARKer<n>:TRACe
:CALCulate:DDEMod:MARKer<n>:X
:CALCulate:DDEMod:MARKer<n>:Y:IMAGinary
:CALCulate:DDEMod:MARKer<n>:Y[:REAL]
:CALCulate:MARKer<n>[:SET]:CENTer
:CALCulate:MARKer<n>[:SET]:DELTa:CENTer
:CALCulate:MARKer<n>[:SET]:RLEVel
:CALCulate:MARKer<n>[:SET]:STARt
:CALCulate:MARKer<n>[:SET]:STEP
:CALCulate:MARKer<n>[:SET]:STOP

Chapter 2 Command System RIGOL
VSA Programming Guide 2-3
:CALCulate:DDEMod:MARKer:AOFF
Syntax
:CALCulate:DDEMod:MARKer:AOFF
Description
Turns off all the enabled markers.
:CALCulate:DDEMod:MARKer:COUPle[:STATe]
Syntax
:CALCulate:DDEMod:MARKer:COUPle[:STATe] OFF|ON|0|1
:CALCulate:DDEMod:MARKer:COUPle[:STATe]?
Description
Enables or disables the couple marker function.
Queries the state of the couple marker function.
Parameter
Name
Type
Range
Default
--
Bool
OFF|ON|0|1
OFF|0
Remarks
When you enable the couple marker function, moving any marker will make other markers (that are not
fixed or off) move along with it.
Return Format
The query returns 0 or 1.
Example
The following command disables the couple marker function.
:CALCulate:DDEMod:MARKer:COUPle:STATe OFF or :CALCulate:DDEMod:MARKer:COUPle:STATe 0
The following query returns 0.
:CALCulate:DDEMod:MARKer:COUPle:STATe?
:CALCulate:DDEMod:MARKer:TABLe[:STATe]
Syntax
:CALCulate:DDEMod:MARKer:TABLe[:STATe] OFF|ON|0|1
:CALCulate:DDEMod:MARKer:TABLe[:STATe]?
Description
Enables or disables the marker table.
Queries the state of the marker table.
Parameter
Name
Type
Range
Default
--
Bool
OFF|ON|0|1
OFF|0
Return Format
The query returns 0 or 1.

RIGOL Chapter 2 Command System
2-4 VSA Programming Guide
Example
The following command disables the marker table.
:CALCulate:DDEMod:MARKer:TABLe:STATe OFF or :CALCulate:DDEMod:MARKer:TABLe:STATe 0
The following query returns 0.
:CALCulate:DDEMod:MARKer:TABLe:STATe?
:CALCulate:DDEMod:MARKer<n>:CPSearch[:STATe]
Syntax
:CALCulate:DDEMod:MARKer<n>:CPSearch[:STATe] OFF|ON|0|1
:CALCulate:DDEMod:MARKer<n>:CPSearch[:STATe]?
Description
Enables or disables continuous peak search function, and marks the peak value with Marker N.
Queries the status of continuous peak search function.
Parameter
Name
Type
Range
Default
<n>
Discrete
1
|
2|3
|
4|5|6|7|8
--
--
Bool
OFF|ON|0|1
OFF|0
Return Format
The query returns 0 or 1.
Example
The following command enables the continuous peak search function, and marks the peak value with
Marker 1.
:CALCulate:DDEMod:MARKer1:CPSearch:STATe ON or :CALCulate:DDEMod:MARKer1:CPSearch:STATe 1
The following query returns 1.
:CALCulate:DDEMod:MARKer1:CPSearch:STATe?
:CALCulate:DDEMod:MARKer<n>:FUNCtion
Syntax
:CALCulate:DDEMod:MARKer<n>:FUNCtion BPOWer|OFF
:CALCulate:DDEMod:MARKer<n>:FUNCtion?
Description
Selects the special measurement type for the specified marker.
Queries the special measurement type of the specified marker.
Parameter
Name
Type
Range
Default
<n>
Discrete
1|2|3|4|5|6|7|8
--
--
Keyword
BPOWer|OFF
OFF
Remarks
BPOWer: indicates the bandwidth power.
OFF: turns off all the measurements.
This command is only valid when you open the marker on the frequency domain data.

Chapter 2 Command System RIGOL
VSA Programming Guide 2-5
Return Format
The query returns BPOW or OFF.
Example
The following command sets the measurement type of Marker 1 to band power.
:CALCulate:DDEMod:MARKer1:FUNCtion BPOW
The following query returns BPOW.
:CALCulate:DDEMod:MARKer1:FUNCtion?
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:LEFT
Syntax
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:LEFT <real>
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:LEFT?
Description
Sets the left edge frequency or time of the signal involved in the calculation for the band function.
Queries the left edge frequency or time of the signal involved in the calculation for the band function.
Parameter
Name
Type
Range
Default
<n>
Discrete
1|2|3|4|5|6|7|8
--
<real>
Consecutive Real Number
0 to band right
center frequency-bandwidth/2
Remarks
This command is only valid when you open the marker on the frequency domain data and enable the
corresponding bandwidth function.
This command is used to set the left edge time when you select the time-domain data source.
Return Format
The query returns the left edge frequency or time of the signal in scientific notation.
Example
The following command sets the left edge frequency of the signal involved in the calculation for the Marker
1 band function to 2 MHz.
:CALCulate:DDEMod:MARKer1:FUNCtion:BAND:LEFT 2000000
The following query returns 2.000000000e+06.
:CALCulate:DDEMod:MARKer1:FUNCtion:BAND:LEFT?
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:RIGHt
Syntax
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:RIGHt <real>
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:RIGHt?
Description
Sets the right edge frequency or time of the signal involved in the calculation for the band function.
Queries the right edge frequency or time of the signal involved in the calculation for the band function.

RIGOL Chapter 2 Command System
2-6 VSA Programming Guide
Parameter
Name
Type
Range
Default
<n>
Discrete
1|2|3|4|5|6|7|8
--
<real>
Consecutive Real Number
band left to +∞
center frequency+bandwidth/2
Remarks
This command is only valid when you open the marker on the frequency domain data and enable the
corresponding bandwidth function.
This command is used to set the right edge time when you select the time-domain data source.
Return Format
The query returns the right edge frequency or time of the signal in scientific notation.
Example
The following command sets the right edge frequency of the signal involved in the calculation for the
Marker 1 band function to 4 GHz.
:CALCulate:DDEMod:MARKer1:FUNCtion:BAND:RIGHt 4000000000
The following query returns 4.000000000e+09.
:CALCulate:DDEMod:MARKer1:FUNCtion:BAND:RIGHt?
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:SPAN
Syntax
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:SPAN <freq>
:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:SPAN?
Description
Sets the bandwidth or the time span of the signal involved in the calculation for the band function.
Queries the bandwidth or the time span of the signal involved in the calculation for the band function.
Parameter
Name
Type
Range
Default
<n>
Discrete
1|2|3|4|5|6|7|8
--
<freq>
Consecutive Real Number
0 to +∞
span/20
Remarks
This command is only valid when you open the marker on the frequency domain data and enable the
corresponding bandwidth function.
This command is used to set the time span when you select the time-domain data source.
Return Format
The query returns the bandwidth of the signal involved in the calculation for the band function in scientific
notation.
Example
The following command sets the bandwidth of the signal involved in the calculation for the Marker 1 band
function to 500 MHz.
:CALCulate:DDEMod:MARKer1:FUNCtion:BAND:SPAN 500000000
The following query returns 5.000000000e+08.
:CALCulate:DDEMod:MARKer1:FUNCtion:BAND:SPAN?