Rigol RSA3030E-TG, RSA3015E, RSA3030E, RSA3015E-TG Programming Guide

Programming Guide

RSA3000E Series Real-time

Spectrum Analyzer

Aug. 2019

RIGOL (SUZHOU) TECHNOLOGIES INC.

RIGOL

Guaranty and Declaration

Copyright

© 2019 RIGOL (SUZHOU) TECHNOLOGIES INC. All Rights Reserved.

Trademark Information

RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES INC.

Publication Number

PGD24100-1110

Software Version

00.01.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 relea sed 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 a nd 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

RSA3000E Programming Guide I

RIGOL

Tip

For the latest version of this manual, download it from the official website of RIGOL (www.rigol.com).

Document Overview

This manual introduces how to program and control RIGOL RSA3000E series spectrum analyzer by using
SCPI commands through USB and 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 Systems for GPSA and RTSA Modes

This chapter introduces the syntax, function, parameters, and usage of each command of RSA3000E series
in GPSA and RTSA modes.

Chapter 3 Command System for EMI Mode

This chapter introduces the commands of R SA3000E series in EMI mode.

Chapter 4 Command System for VSA Mode
This chapter introduces the commands of RSA3000E series in VSA mode.

Chapter 5 Programming Examples

This chapter illustrates how to control the RSA3000E series by programming in the development
environments such as Visual C++, Visual Basic, and LabVIEW.

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 fron t or rear panel are usual ly denoted by the f ormat of "Connector Name (Bo ld)
+ 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 Cent er Freq.

Content Conventions in this Manual:

The RSA3000E series spectrum analyzer includes the following models. Unless otherwise specified, this
manual takes RSA3030E-TG as an example to illustrate the usage of each command of RSA3000E series
spectrum analyzer.

II RSA3000E Programming Guide

RIGOL

Model

Frequency Range

Tracking Generator

RSA3030E

9 kHz to 3 GHz

None

RSA3015E

9 kHz to 1.5 GHz

None

RSA3030E-TG

9 kHz to 3 GHz

3 GHz

RSA3015E-TG

9 kHz to 1.5 GHz

1.5 GHz

RSA3000E Programming Guide III

RIGOL Contents

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 D escription ............................................................................................................. 1-4

Parameter Type .................................................................................................................. 1-5

Command Abbreviation ....................................................................................................... 1-5

Chapter 2 Command Systems for GPSA and RTSA Modes ................................................. 2-1

:CALCulate Commands .............................................................................................................. 2-2

:CALCulate:BANDwidth|BWIDth:NDB ................................................................................... 2-4

:CALCulate:BANDwidth|BWIDth:RESult? .............................................................................. 2-4

:CALCulate:BANDwidth|BWIDth:RLEFt? ............................................................................... 2-5

:CALCulate:BANDwidth|BWIDth:RRIGht? ............................................................................. 2-5

:CALCulate:BANDwidth|BWIDth [:STATe] ............................................................................. 2-5

:CALCulate:LLINe:ALL:DELete ............................................................................................. 2-6

:CALCulate:LLINe:TEST ...................................................................................................... 2-6

:CALCulate:LLINe<n>:AMPLitude:CMODe:RELative .............................................................. 2-7

:CALCulate:LLINe<n>:BUILd .............................................................................................. 2-7

:CALCulate:LLINe<n>:COPY ............................................................................................... 2-8

:CALCulate:LLINe<n>:DATA................................................................................................ 2-8

:CALCulate:LLINe<n>:DELete ............................................................................................. 2-9

:CALCulate:LLINe<n>:DISPlay ............................................................................................ 2-9

:CALCulate:LLINe<n>:FAIL? ............................................................................................. 2-10

:CALCulate:LLINe<n>:FREQuency:CMODe:RELative ........................................................... 2-10

:CALCulate:LLINe<n>:MARGin .......................................................................................... 2-11

:CALCulate:LLINe<n>:MARGin:STATe ................................................................................ 2-11

:CALCulate:LLINe<n>:TRACe ............................................................................................ 2-12

:CALCulate:LLINe<n>:TYPE .............................................................................................. 2-12

:CALCulate:MARKer:AOFF ................................................................................................. 2-13

:CALCulate:MARKer:COUPle[:STATe] .................................................................................. 2-13

:CALCulate:MARKer:PEAK:EXCursion.................................................................................. 2-13

:CALCulate:MARKer:PEAK:EXCursion:STATe........................................................................ 2-14

:CALCulate:MARKer:PEAK:SEARch:MODE ........................................................................... 2-14

:CALCulate:MARKer:PEAK:SORT ........................................................................................ 2-15

:TRACe:MATH:PEAK:SORT ................................................................................................ 2-15

:CALCulate:MARKer:PEAK:TABLe:READout ......................................................................... 2-16

:TRACe:MATH:PEAK:THReshold ......................................................................................... 2-16

:CALCulate:MARKer:PEAK:TABLe[:STATe] ........................................................................... 2-16

:TRACe:MATH:PEAK:TABLe:STATe ..................................................................................... 2-16

:CALCulate:MARKer:PEAK:THReshold ................................................................................. 2-17

:CALCulate:MARKer:PEAK:THReshold:STATe ....................................................................... 2-17

:CALCulate:MARKer:TABLe[:STATe] ................................................................................... 2-18

:CALCulate:MARKer:TRCKing[:STATe] ................................................................................ 2-18

:CALCulate:MARKer<n>:CPSearch[:STATe] ........................................................................ 2-19

:CALCulate:MARKer<n>:FCOunt:GATetime ........................................................................ 2-20

:CALCulate:MARKer<n>:FCOunt:GATetime:AUTO ............................................................... 2-20

:CALCulate:MARKer<n>:FCOunt[:STATe] ........................................................................... 2-21

:CALCulate:MARKer<n>:FCOunt:X? ................................................................................... 2-21

:CALCulate:MARKer<n>:FUNCtion ..................................................................................... 2-22

:CALCulate:MARKer<n>:FUNCtion:BAND:LEFT ................................................................... 2-22

IV RSA3000E Programming Guide

Contents RIGOL

:CALCulate:MARKer<n>:FUNCtion:BAND:RIGHt ................................................................. 2-23

:CALCulate:MARKer<n>:FUNCtion:BAND:SPAN .................................................................. 2-24

:CALCulate:MARKer<n>:FUNCtion:BAND:SPAN:AUTO ........................................................ 2-24

:CALCulate:MARKer<n>:LINes[:STATe] ............................................................................. 2-25

:CALCulate:MARKer<n>:MAXimum:LEFT ........................................................................... 2-25

:CALCulate:MARKer<n>:MAXimum[:MAX] ......................................................................... 2-26

:CALCulate:MARKer<n>:MAXimum:NEXT .......................................................................... 2-26

:CALCulate:MARKer<n>:MAXimum:RIGHt ......................................................................... 2-27

:CALCulate:MARKer<n>:MINimum .................................................................................... 2-27

:CALCulate:MARKer<n>:MODE ......................................................................................... 2-28

:CALCulate:MARKer<n>:PTPeak ....................................................................................... 2-28

:CALCulate:MARKer<n>:REFerence................................................................................... 2-29

:CALCulate:MARKer<n>[:SET]:CENTer .............................................................................. 2-29

:CALCulate:MARKer<n>[:SET]:DELTa:CENTer .................................................................... 2-30

:CALCulate:MARKer<n>[:SET]:DELTa:SPAN ....................................................................... 2-30

:CALCulate:MARKer<n>[:SET]:RLEVel ............................................................................... 2-31

:CALCulate:MARKer<n>[:SET]:STARt ................................................................................ 2-31

:CALCulate:MARKer<n>[:SET]:STEP ................................................................................. 2-32

:CALCulate:MARKer<n>[:SET]:STOP ................................................................................. 2-32

:CALCulate:MARKer<n>:STATe ......................................................................................... 2-33

:CALCulate:MARKer<n>:TRACe ........................................................................................ 2-33

:CALCulate:MARKer<n>:TRACe:AUTO ............................................................................... 2-34

:CALCulate:MARKer<n>:X ................................................................................................ 2-35

:CALCulate:MARKer<n>:X:READout .................................................................................. 2-35

:CALCulate:MARKer<n>:X:READout:AUTO ........................................................................ 2-36

:CALCulate:MARKer<n>:Y ................................................................................................ 2-37

:CALCulate:MARKer<n>:Z:POSition ................................................................................... 2-37

:CALCulate:MATH ............................................................................................................. 2-38

:CALCulate:NTData[:STATe] .............................................................................................. 2-39

:CALibration Commands .......................................................................................................... 2-40

:CALibration:[ALL] ............................................................................................................ 2-40

:CALibration:AUTO ........................................................................................................... 2-40

:CONFigure Commands ........................................................................................................... 2-41

:CONFigure? .................................................................................................................... 2-41

:CONFigure:ACPower ....................................................................................................... 2-42

:CONFigure:CNRatio ......................................................................................................... 2-42

:CONFigure:DENSity ......................................................................................................... 2-42

:CONFigure:DSPEctrogram ............................................................................................... 2-43

:CONFigure:EBWidth ........................................................................................................ 2-43

:CONFigure:HDISt ............................................................................................................ 2-43

:CONFigure:LPSTep .......................................................................................................... 2-43

:CONFigure:MCHPower ..................................................................................................... 2-44

:CONFigure:NORMal ......................................................................................................... 2-44

:CONFigure:OBWidth ........................................................................................................ 2-44

:CONFigure:PSGRam ........................................................................................................ 2-45

:CONFigure:PSPectrum ..................................................................................................... 2-45

:CONFigure:PVT ............................................................................................................... 2-45

:CONFigure:SANalyzer ...................................................................................................... 2-45

:CONFigure:SPECtrogram ................................................................................................. 2-46

:CONFigure:TOI ............................................................................................................... 2-46

:CONFigure:TPOWer ........................................................................................................ 2-46

:COUPle Commands ................................................................................................................ 2-47

:COUPle .......................................................................................................................... 2-47

:DISPlay Commands ............................................................................................................... 2-48

:DISPlay:BACKlight ........................................................................................................... 2-49

:DISPlay:ENABle .............................................................................................................. 2-49

:DISPlay:GRATicule[:STATe] .............................................................................................. 2-50

:DISPlay:HDMI[:STATe] .................................................................................................... 2-50

RSA3000E Programming Guide V

RIGOL Contents

:DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle ......................................................... 2-51

:DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:PDIVision ...................................................... 2-51

:DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RLEVel .......................................................... 2-52

:DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RPOSition ..................................................... 2-52

:DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:PDIVision ...................................................... 2-53

:DISPlay:PVTime : WIN Do w: TR ACe :Y[ : SCA Le] :RLE Vel <real > .............................................. 2-53

:DISPlay:VIEW:DENSity:AADJust ....................................................................................... 2-54

:DISPlay:VIEW:DENSity:CNONlinear .................................................................................. 2-54

:DISPlay:VIEW:DENSity:CPALettes ..................................................................................... 2-55

:DISPlay:VIEW:DENSity:HDHue ......................................................................................... 2-55

:DISPlay:VIEW:DENSity:LDHue ......................................................................................... 2-56

:DISPlay:VIEW:DENSity:PERSistence ................................................................................. 2-56

:DISPlay:VIEW:DENSity:PERSistence:INFinite ..................................................................... 2-57

:DISPlay:VIEW[:SELect] .................................................................................................... 2-57

:DISPlay:VIEW:SPECtrogram:AADJust ................................................................................ 2-58

:DISPlay:VIEW:SPECtrogram:BOTTom ............................................................................... 2-58

:DISPlay:VIEW:SPECtrogram:HUE ..................................................................................... 2-59

:DISPlay:VIEW:SPECtrogram:POSition ............................................................................... 2-59

:DISPlay:VIEW:SPECtrogram:REFerence ............................................................................ 2-60

:DISPlay:VIEW:SPECtrogram:TRACe:COUPle ...................................................................... 2-60

:DISPlay:VIEW:SPECtrogram:TRACe:SELection ................................................................... 2-61

:DISPlay:WINDow:SELect ................................................................................................. 2-62

:DISPlay:WINDow:TRACe:Y:DLINe .................................................................................... 2-62

:DISPlay:WINDow:TRACe:Y:DLINe:STATe .......................................................................... 2-63

:DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel .................................................................... 2-63

:DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition ................................................................ 2-64

:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision .................................................................. 2-64

:DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel ...................................................................... 2-65

:DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel:OFFSet .......................................................... 2-65

:DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing .................................................................... 2-66

:FETCh Commands .................................................................................................................. 2-67

:FETCh:ACPower? ............................................................................................................. 2-68

:FETCh:ACPower:LOWer? .................................................................................................. 2-68

:FETCh:ACPower:MAIN? ................................................................................................... 2-69

:FETCh:ACPower:UPPer? ................................................................................................... 2-69

:FETCh:CNRatio? .............................................................................................................. 2-70

:FETCh:CNRatio:CARRier? ................................................................................................. 2-70

:FETCh:CNRatio:CNRatio? ................................................................................................. 2-71

:FETCh:CNRatio:NOISe? ................................................................................................... 2-71

:FETCh:EBWidth? ............................................................................................................. 2-72

:FETCh:HARMonics:AMPLitude:ALL? .................................................................................. 2-72

:FETCh:HARMonics :AMP L it ude ? <n > ................................................................................. 2-73

:FETCh:HARMonics[:DISTortion]? ...................................................................................... 2-73

:FETCh:HARMonics:FREQuency:ALL? ................................................................................. 2-74

:FETCh:HARMonics :FRE Q ue ncy ? <n > ................................................................................ 2-74

:FETCh:HARMonics:FUNDamental? .................................................................................... 2-75

:FETCh:OBWidth? ............................................................................................................. 2-75

:FETCh:OBWidth:OBWidth? ............................................................................................... 2-76

:FETCh:OBWidth:OBWidth:FERRor? ................................................................................... 2-76

:FETCh:SANalyzer<n>? .................................................................................................... 2-77

:FETCh:TOIntercept? ........................................................................................................ 2-77

:FETCh:TOIntercept:IP3? .................................................................................................. 2-78

:FETCh:TPOWer? .............................................................................................................. 2-78

:FORMat Commands ............................................................................................................... 2-79

:FORMat:BORDer ............................................................................................................. 2-79

:FORMat[:TRACe][:DATA] ................................................................................................. 2-80

IEEE 488.2 Common Commands .............................................................................................. 2-81

*CLS ................................................................................................................................ 2-82

VI RSA3000E Programming Guide

Contents RIGOL

*ESE ............................................................................................................................... 2-82

*ESR? ............................................................................................................................. 2-83

*IDN? ............................................................................................................................. 2-83

*OPC ............................................................................................................................... 2-84

*RCL ............................................................................................................................... 2-84

*RST ............................................................................................................................... 2-84

*SAV ............................................................................................................................... 2-85

*SRE ............................................................................................................................... 2-85

*STB? ............................................................................................................................. 2-86

*TRG .............................................................................................................................. 2-86

*TST? ............................................................................................................................. 2-86

*WAI ............................................................................................................................... 2-86

:INITiate Commands ............................................................................................................... 2-87

:INITiate:CONTinuous ...................................................................................................... 2-87

:INITiate[:IMMediate] ...................................................................................................... 2-87

:INSTrument Commands ......................................................................................................... 2-88

:INSTrument:COUPle:FREQuency:CENTer .......................................................................... 2-88

:INSTrument:DEFault ....................................................................................................... 2-88

:INSTrument:NSELect ....................................................................................................... 2-89

:INSTrument[:SELect] ...................................................................................................... 2-89

:MMEMory Commands ............................................................................................................ 2-90

:MMEMory:DELete ............................................................................................................ 2-90

:MMEMory:LOAD:CORRection ........................................................................................... 2-91

:MMEMory:LOAD:FMT ...................................................................................................... 2-91

:MMEMory:LOAD:LIMit ..................................................................................................... 2-91

:MMEMory:LOAD:STATe .................................................................................................... 2-92

:MMEMory:LOAD:TRACe ................................................................................................... 2-92

:MMEMory:LOAD:TRACe:DATA .......................................................................................... 2-93

:MMEMory:MOVE ............................................................................................................. 2-93

:MMEMory:STORe:CORRection .......................................................................................... 2-93

:MMEMory:STORe:LIMit .................................................................................................... 2-94

:MMEMory:STORe:MTABle ................................................................................................ 2-94

:MMEMory:STORe:PTABle ................................................................................................. 2-95

:MMEMory:STORe:RESults ................................................................................................ 2-95

:MMEMory:STORe:SCReen ................................................................................................ 2-96

:MMEMory:STORe:STATe .................................................................................................. 2-96

:MMEMory:STORe:TRACe ................................................................................................. 2-97

:MMEMory:STORe:TRACe:DATA ........................................................................................ 2-97

:OUTPut Command ................................................................................................................. 2-98

:OUTPut[:EXTernal][:STATe] ............................................................................................. 2-98

:READ Commands .................................................................................................................. 2-99

:READ:ACPower? ........................................................................................................... 2-100

:READ:ACPower:LOWer? ................................................................................................ 2-100

:READ:ACPower:MAIN? .................................................................................................. 2-100

:READ:ACPower:UPPer?.................................................................................................. 2-101

:READ:CNRatio? ............................................................................................................. 2-101

:READ:CNRatio:CARRier? ................................................................................................ 2-101

:READ:CNRatio:CNRatio? ................................................................................................ 2-102

:READ:CNRatio:NOISe? .................................................................................................. 2-102

:READ:EBWidth? ............................................................................................................ 2-102

:READ:HARMonics:AMPLitude:ALL? ................................................................................. 2-103

:READ:HARMonics:AMPLitude? <n> ................................................................................ 2-103

:READ:HARMonics[:DISTortion]? ..................................................................................... 2-104

:READ:HARMonics:FREQuency:ALL? ................................................................................ 2-104

:READ:HARMonics:FREQuency ? <n> .............................................................................. 2-104

:READ:HARMonics:FUNDamental? ................................................................................... 2-105

:READ:OBWidth?............................................................................................................ 2-105

:READ:OBWidth:OBWidth? ............................................................................................. 2-106

RSA3000E Programming Guide VII

RIGOL Contents

:READ:OBWidth:OBWidth:FERRor? .................................................................................. 2-106

:READ:SANalyzer<n>?.................................................................................................... 2-107

:READ:TOIntercept? ....................................................................................................... 2-107

:READ:TOIntercept:IP3? ................................................................................................. 2-108

:READ:TPOWer? ............................................................................................................. 2-108

[:SENSe] Commands ............................................................................................................. 2-109

[:SENSe]:ACPower:AVERage:COUNt ................................................................................ 2-113

[:SENSe]:ACPower:AVERage[:STATe] ............................................................................... 2-113

[:SENSe]:ACPower:AVERage:TCONtrol ............................................................................. 2-114

[:SENSe]:ACPower:BANDwidth:ACHannel ........................................................................ 2-114

[:SENSe]:ACPower:BANDwidth:INTegration...................................................................... 2-115

[:SENSe]:ACPower:CSPacing ........................................................................................... 2-115

[:SENSe]:ACQuisition:TIME ............................................................................................. 2-116

[:SENSe]:ACQuisition:TIME:AUTO ................................................................................... 2-116

[:SENSe]:ACQuisition:TIME:PVTime ................................................................................. 2-117

[:SENSe]:ACQuisition:TIME:PVTime:AUTO ....................................................................... 2-117

[:SENSe]:AVERage:COUNt .............................................................................................. 2-118

:TRACe:AVERage:COUNt ................................................................................................. 2-118

[:SENSe]:AVERage:COUNt:CURRent? ............................................................................... 2-119

:TRACe:AVERage:COUNt:CURRent? ................................................................................. 2-119

[:SENSe]:AVERage:TYPE ................................................................................................. 2-119

:TRACe<n>:AVERage:TYPE ............................................................................................ 2-119

[:SENSe]:AVERage:TYPE:AUTO ....................................................................................... 2-120

[:SENSe]:BANDwidth|BWIDth:EMIFilter:STATe ................................................................. 2-120

[:SENSe]:BANDwidth|BWIDth[:RESolution] ...................................................................... 2-121

[:SENSe]:BANDwidth|BWIDth[:RESolution]:AUTO ............................................................ 2-121

[:SENSe]:BANDwidth|BWIDth[:RESolution]:SELect ........................................................... 2-122

[:SENSe]:BANDwidth|BWIDth[:RESolution]:SELect:AUTO[:STATe] ..................................... 2-122

[:SENSe]:BANDwidth|BWIDth:SHAPe............................................................................... 2-123

[:SENSe]:BANDwidth|BWIDth:VIDeo ............................................................................... 2-124

[:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO ..................................................................... 2-124

[:SENSe]:BANDwidth|BWIDth:VIDeo:RATio ..................................................................... 2-125

[:SENSe]:BANDwidth|BWIDth:VIDeo:RATio:AUTO ............................................................ 2-125

[:SENSe]:CNRatio:AVERage:COUNt ................................................................................. 2-126

[:SENSe]:CNRatio:AVERage[:STATe] ................................................................................ 2-126

[:SENSe]:CNRatio:AVERage:TCONtrol .............................................................................. 2-127

[:SENSe]:CNRatio:BANDwidth:INTegration ....................................................................... 2-128

[:SENSe]:CNRatio:BANDwidth:NOISe............................................................................... 2-128

[:SENSe]:CNRatio:OFFSet ............................................................................................... 2-129

[:SENSe]:CORRection:CSET:ALL:DELete ........................................................................... 2-129

[:SENSe]:CORRection:CSET:ALL[:STATe] .......................................................................... 2-129

[:SENSe]:CORRection:CSET<n>:DATA ............................................................................. 2-130

[:SENSe]:CORRection:CSET<n>:DATA:MERGe ................................................................. 2-131

[:SENSe]:CORRection:CSET<n>:DELete .......................................................................... 2-131

[:SENSe]:CORRection:CSET<n>[:STATe] ......................................................................... 2-132

[:SENSe]:CORRection:CSET<n>:X:SPACing ..................................................................... 2-132

:INPut:IMPedance .......................................................................................................... 2-133

[:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] .................................................... 2-133

[:SENSe]:CORRection:SA[:RF]:GAIN ................................................................................ 2-133

[:SENSe]:DEMod ............................................................................................................ 2-134

[:SENSe]:DEMod:GAIN:AUTO .......................................................................................... 2-134

[:SENSe]:DEMod:GAIN:INCRement ................................................................................. 2-135

[:SENSe]:DEMod:STATe .................................................................................................. 2-136

[:SENSe]:DETector:TRACe:PVTime .................................................................................. 2-136

[:SENSe]:DETector[:FUNCtion] ........................................................................................ 2-137

[:SENSe]:DETector:TRACe<n> ........................................................................................ 2-137

[:SENSe]:DETector:TRACe<n>:AUTO .............................................................................. 2-138

[:SENSe]:EBWidth:AVERage:COUNt ................................................................................. 2-138

VIII RSA3000E Programming Guide

Contents RIGOL

[:SENSe]:EBWidth:AVERage[:STATe] ............................................................................... 2-139

[:SENSe]:EBWidth:AVERage:TCONtrol ............................................................................. 2-139

[:SENSe]:EBWidth:FREQuency:SPAN ............................................................................... 2-140

[:SENSe]:EBWidth:MAXHold:STATe ................................................................................. 2-140

[:SENSe]:EBWidth:XDB .................................................................................................. 2-141

[:SENSe]:FCAPture:BLOCk .............................................................................................. 2-141

[:SENSe]:FCAPture:LENGth ............................................................................................ 2-142

[:SENSe]:FCAPture:POINter ............................................................................................ 2-143

[:SENSe]:FCAPture:WLENgth? ........................................................................................ 2-143

[:SENSe]:FETCh:FCAPture? ............................................................................................ 2-143

[:SENSe]:INITiate:FCAPture ........................................................................................... 2-144

[:SENSe]:FREQuency:CENTer.......................................................................................... 2-144

[:SENSe]:FREQuency:CENTer:STEP:AUTO ....................................................................... 2-145

[:SENSe]:FREQuency:CENTer:STEP[:INCRement] ............................................................ 2-145

[:SENSe]:FREQuency:OFFSet .......................................................................................... 2-146

[:SENSe]:FREQuency:SPAN ............................................................................................ 2-146

[:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio .............................................. 2-147

[:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio:AUTO .................................... 2-147

[:SENSe]:FREQuency:SPAN:FULL .................................................................................... 2-148

[:SENSe]:FREQuency:SPAN:PREVious ............................................................................. 2-148

[:SENSe]:FREQuency:SPAN:ZERO ................................................................................... 2-148

[:SENSe]:FREQuency:STARt ........................................................................................... 2-148

[:SENSe]:FREQuency:STOP ............................................................................................ 2-149

[:SENSe]:FREQuency:TUNE:IMMediate ........................................................................... 2-149

[:SENSe]:HDISt:AVERage:COUNt .................................................................................... 2-150

[:SENSe]:HDISt:AVERage[:STATe] .................................................................................. 2-150

[:SENSe]:HDISt:AVERage:TCONtrol................................................................................. 2-151

[:SENSe]:HDISt:NUMBers ............................................................................................... 2-151

[:SENSe]:HDISt:TIME ..................................................................................................... 2-152

[:SENSe]:MCHPower:AVERage:COUNt ............................................................................. 2-153

[:SENSe]:MCHPower:AVERage[:STATe] ........................................................................... 2-153

[:SENSe]:MCHPower:AVERage:TCONtrol ......................................................................... 2-154

[:SENSe]:MCHPower:FREQuency:CENTer......................................................................... 2-154

[:SENSe]:MCHPower:CHAnnel:ADD ................................................................................. 2-155

[:SENSe]:MCHPower:CHAnnel:DELete ............................................................................. 2-155

[:SENSe]:MCHPower:CHAnnel:DELete:ALL ...................................................................... 2-155

[:SENSe]:MCHPower:FREQuency:SPAN ........................................................................... 2-156

[:SENSe]:MCHPower:SHEet ............................................................................................ 2-156

[:SENSe]:OBWidth:AVERage:COUNt ................................................................................ 2-157

[:SENSe]:OBWidth:AVERage[:STATe] .............................................................................. 2-157

[:SENSe]:OBWidth:AVERage:TCONtrol ............................................................................ 2-158

[:SENSe]:OBWidth:FREQuency:SPAN .............................................................................. 2-158

[:SENSe]:OBWidth:MAXHold:STATe ................................................................................. 2-159

[:SENSe]:OBWidth:PERCent ........................................................................................... 2-159

[:SENSe]:POWer[:RF]:ATTenuation ................................................................................. 2-160

[:SENSe]:POWer[:RF]:ATTenuation:AUTO ........................................................................ 2-160

[:SENSe]:POWer[:RF]:GAIN[:STATe] ............................................................................... 2-161

[:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer] ................................................................... 2-161

[:SENSe]:SIGCapture:2FSK:AMPDown ............................................................................. 2-162

[:SENSe]:SIGCapture:2FSK:AMPUp ................................................................................. 2-162

[:SENSe]:SIGCapture:2FSK:MARK1:FREQ ........................................................................ 2-163

[:SENSe]:SIGCapture:2FSK:MARK1:SWitch[:STATe] ......................................................... 2-163

[:SENSe]:SIGCapture:2FSK:MARK2:FREQ ........................................................................ 2-164

[:SENSe]:SIGCapture:2FSK:MARK2:SWitch[:STATe] ......................................................... 2-164

[:SENSe]:SIGCapture:2FSK:MAXHold[:STATe] .................................................................. 2-165

[:SENSe]:SIGCapture:2FSK:PEAKAmp? ............................................................................ 2-165

[:SENSe]:SIGCapture:2FSK:PEAKFreq? ............................................................................ 2-166

[:SENSe]:SIGCapture:2FSK:PF? ...................................................................................... 2-166

RSA3000E Programming Guide IX

RIGOL Contents

[:SENSe]:SIGCapture:2FSK:PFSWitch[:STATe] .................................................................. 2-167

[:SENSe]:SIGCapture:2FSK:RESet ................................................................................... 2-167

[:SENSe]:SIGCapture:2FSK:SIGNal .................................................................................. 2-168

[:SENSe]:SWEep:POINts ................................................................................................. 2-168

[:SENSe]:SWEep:TIME ................................................................................................... 2-169

[:SENSe]:SWEep:TIME:AUTO .......................................................................................... 2-169

[:SENSe]:SWEep:TIME:AUTO:RULes ............................................................................... 2-170

[:SENSe]:TOI:AVERage:COUNt ........................................................................................ 2-170

[:SENSe]:TOI:AVERage[:STATe] ...................................................................................... 2-171

[:SENSe]:TOI:AVERage:TCONtrol .................................................................................... 2-171

[:SENSe]:TOI:FREQuency:SPAN ...................................................................................... 2-172

[:SENSe]:TPOWer:AVERage:COUNt ................................................................................. 2-173

[:SENSe]:TPOWer:AVERage[:STATe] ................................................................................ 2-173

[:SENSe]:TPOWer:AVERage:TCONtrol .............................................................................. 2-174

[:SENSe]:TPOWer:LLIMit ................................................................................................ 2-174

[:SENSe]:TPOWer:MODE ................................................................................................ 2-175

[:SENSe]:TPOWer:RLIMit ................................................................................................ 2-175

[:SENSe]:VSWR:FREFlect ................................................................................................ 2-176

[:SENSe]:VSWR:NREFlect ............................................................................................... 2-176

[:SENSe]:VSWR:RESet .................................................................................................... 2-176

[:SENSe]:VSWR:STATe .................................................................................................... 2-177

:SOURce Commands ............................................................................................................. 2-178

:SOURce:CORRection:OFFSet .......................................................................................... 2-178

:SOURce[:EXTernal]:POWer[:LEVel][:IMMediate][:AMPLitude]........................................... 2-178

:SOURce:TRACe:REFerence:STATe................................................................................... 2-179

:SOURce:TRACe:STORref ................................................................................................ 2-179

:STATus Commands ............................................................................................................... 2-180

:STATus:OPERation:CONDition? ....................................................................................... 2-181

:STATus:OPERation:ENABle ............................................................................................. 2-181

:STATus:OPERation[:EVENt]? .......................................................................................... 2-182

:STATus:PRESet .............................................................................................................. 2-182

:STATus:QUEStionable:CONDition? .................................................................................. 2-182

:STATus:QUEStionable:ENABle......................................................................................... 2-182

:STATus:QUEStionable[:EVENt]? ...................................................................................... 2-183

:SYSTem Commands ............................................................................................................. 2-184

:SYSTem:BEEPer:STATe .................................................................................................. 2-185

:SYSTem:COMMunicate:LAN[:SELF]:APPLy ....................................................................... 2-185

:SYSTem:COMMunicate:LAN[:SELF]:AUToip:STATe ............................................................ 2-185

:SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe ............................................................. 2-186

:SYSTem:COMMunicate:LAN[:SELF]:IP:ADDRess .............................................................. 2-186

:SYSTem:COMMunicate:LAN[:SELF]:IP:DNS:AUTO[:STATe] ............................................... 2-187

:SYSTem:COMMunicate:LAN[:SELF]:IP:DNSBack .............................................................. 2-188

:SYSTem:COMMunicate:LAN[:SELF]:IP:DNSPreferred ........................................................ 2-188

:SYSTem:COMMunicate:LAN[:SELF]:IP:DNSServer ............................................................ 2-188

:SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway .............................................................. 2-189

:SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask .............................................................. 2-189

:SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe .......................................................... 2-190

:SYSTem:COMMunicate:LAN[:SELF]:MDNS:STATe ............................................................. 2-191

:SYSTem:COMMunicate:LAN[:SELF]:RESet ....................................................................... 2-191

:SYSTem:CONFigure:INFormation? .................................................................................. 2-191

:SYSTem:DATE ............................................................................................................... 2-192

:SYSTem:FSWitch[:STATe] .............................................................................................. 2-192

:SYSTem:LANGuage ........................................................................................................ 2-193

:SYSTem:LKEY ............................................................................................................... 2-193

:SYSTem:OPTion:STATe? ................................................................................................. 2-194

:SYSTem:PON:TYPE ........................................................................................................ 2-194

:SYSTem:PRESet ............................................................................................................ 2-195

:SYSTem:PRESet:SAVE .................................................................................................... 2-195

X RSA3000E Programming Guide

Contents RIGOL

:SYSTem:PRESet:TYPE ................................................................................................... 2-195

:SYSTem:PRESet:USER:SAVE .......................................................................................... 2-196

:SYSTem:SCPI:DISPlay ................................................................................................... 2-196

:SYSTem:SECurity:CLEar ................................................................................................ 2-196

:SYSTem:SHOW ............................................................................................................. 2-197

:SYSTem:TIME ............................................................................................................... 2-197

:TRACe Commands ............................................................................................................... 2-198

:TRACe:CLEar:ALL ......................................................................................................... 2-198

:TRACe[:DATA] .............................................................................................................. 2-198

:TRACe:MATH:A ............................................................................................................. 2-200

:TRACe:MATH:B ............................................................................................................. 2-200

:TRACe:MATH:CONSt ..................................................................................................... 2-201

:TRACe:MATH:PEAK[:DATA]? ......................................................................................... 2-201

:TRACe:MATH:PEAK:POINts? .......................................................................................... 2-201

:TRACe:MATH:REFerence ............................................................................................... 2-202

:TRACe:MATH:STATe ...................................................................................................... 2-202

:TRACe:MATH:TYPE ....................................................................................................... 2-203

:TRACe:PRESet:ALL ....................................................................................................... 2-203

:TRACe<n>:DISPlay:STATe ............................................................................................ 2-204

:TRACe<n>:MODE ......................................................................................................... 2-204

:TRACe<n>:TYPE .......................................................................................................... 2-204

:TRACe<n>:UPDate:STATe ............................................................................................. 2-205

:TRIGger Commands ............................................................................................................ 2-206

:TRIGger[:SEQuence]:ATRigger ...................................................................................... 2-207

:TRIGger[:SEQuence]:ATRigger:STATe ............................................................................ 2-207

:TRIGger[:SEQuence]:EXTernal<n>:DELay...................................................................... 2-208

:TRIGger[:SEQuence]:EXTernal<n>:DELay:STATe ............................................................ 2-208

:TRIGger[:SEQuence]:EXTernal<n>:SLOPe ..................................................................... 2-209

:TRIGger[:SEQuence]:FMT:APTRigger ............................................................................. 2-209

:TRIGger[:SEQuence]:FMT:CRITeria ................................................................................ 2-210

:TRIGger[:SEQuence]:FMT:DELay ................................................................................... 2-211

:TRIGger[:SEQuence]:FMT:DELay:STATe ......................................................................... 2-211

:TRIGger[:SEQuence]:FMT:MASK .................................................................................... 2-212

:TRIGger[:SEQuence]:FMT:MASK:EDIT ........................................................................... 2-212

:TRIGger[:SEQuence]:FMT:MASK:RELative:AMPLitude ..................................................... 2-213

:TRIGger[:SEQuence]:FMT:MASK:RELative:FREQuency .................................................... 2-213

:TRIGger[:SEQuence]:FMT:MASK<n>:BUILd ................................................................... 2-214

:TRIGger[:SEQuence]:FMT:MASK<n>:DATA .................................................................... 2-214

:TRIGger[:SEQuence]:FMT:MASK<n>:DELete.................................................................. 2-215

:TRIGger[:SEQuence]:FMT:MASK<n>:NEW ..................................................................... 2-215

:TRIGger[:SEQuence]:HOLDoff ....................................................................................... 2-216

:TRIGger[:SEQuence]:HOLDoff:STATe ............................................................................. 2-216

:TRIGger[:SEQuence]:SOURce ........................................................................................ 2-217

:TRIGger[:SEQuence]:VIDeo:DELay ................................................................................ 2-217

:TRIGger[:SEQuence]:VIDeo:DELay:STATe ...................................................................... 2-218

:TRIGger[:SEQuence]:VIDeo:LEVel ................................................................................. 2-218

:TRIGger[:SEQuence]:VIDeo:SLOPe ................................................................................ 2-219

:TRIGger2:MODE ........................................................................................................... 2-220

:UNIT Command................................................................................................................... 2-221

:UNIT:POWer ................................................................................................................. 2-221

Chapter 3 Command System for EMI Mode ........................................................................ 3-1

:CALCulate Commands .............................................................................................................. 3-2

:CALCulate:EMI:SLISt:DELete ............................................................................................. 3-4

:CALCulate:FSCan:MAMarker[:SET]:SLISt ............................................................................ 3-4

:CALCulate:FSCan:MARKer:AOFF ........................................................................................ 3-4

:CALCulate:FSCan:MARKer:COUPle[:STATe] ......................................................................... 3-4

:CALCulate:FSCan:MARKer:PEAK:EXCursion ......................................................................... 3-5

RSA3000E Programming Guide XI

RIGOL Contents

:CALCulate:FSCan:MARKer:PEAK:EXCursion:STATe ............................................................... 3-5

:CALCulate:FSCan:MARKer:PEAK:SEARch:MODE .................................................................. 3-6

:CALCulate:FSCan:MARKer:PEAK:SEARch:THReshold ............................................................ 3-7

:CALCulate:FSCan:MARKer:PEAK:SEARch:THReshold:STATe .................................................. 3-7

:CALCulate:FSCan:MARker<n>:FUNCtion:MAMarker? ........................................................... 3-8

:CALCulate:FSCan:MARKer<n>:MAXimum ........................................................................... 3-8

:CALCulate:FSCan:MARKer<n>:MAXimum:LEFT ................................................................... 3-8

:CALCulate:FSCan:MARKer<n>:MAXimum:NEXT .................................................................. 3-9

:CALCulate:FSCan:MARKer<n>:MAXimum:RIGHt ................................................................. 3-9

:CALCulate:FSCan:MARKer<n>:MINimum .......................................................................... 3-10

:CALCulate:FSCan:MARKer<n>:MODE ............................................................................... 3-10

:CALCulate:FSCan:MARKer<n>:REFerence ......................................................................... 3-11

:CALCulate:FSCan:MARKer<n>[:SET]:SLISt ....................................................................... 3-11

:CALCulate:FSCan:MARKer<n>[:SET]:METer ...................................................................... 3-11

:CALCulate:FSCan:MARKer<n>:TO:METer .......................................................................... 3-12

:CALCulate:FSCan:MARKer<n>:TRACe .............................................................................. 3-12

:CALCulate:FSCan:SLISt:APPend:METer ............................................................................. 3-13

:CALCulate:FSCan:SLISt:DELete:SIGNal ............................................................................. 3-13

:CALCulate:FSCan:SLISt:MARK:ALL ................................................................................... 3-13

:CALCulate:FSCan:SLISt:MARK:CLEar:ALL .......................................................................... 3-13

:CALCulate:FSCan:SLISt:MARK:CLEar:SIGNal ..................................................................... 3-13

:CALCulate:FSCan:SLISt:MARK:SIGNal ............................................................................... 3-14

:CALCulate:FSCan:SLISt:REPLace:METer ............................................................................ 3-14

:CALCulate:FSCan:SLISt:SET:METer .................................................................................. 3-14

:CALCulate:FSCan:SLISt:SORT:AUTO ................................................................................. 3-15

:CALCulate:FSCan:SLISt:SORT:DAMPlitude ........................................................................ 3-15

:CALCulate:FSCan:SLISt:SORT:DLDelta ............................................................................. 3-16

:CALCulate:FSCan:SLISt:SORT:ORDer ............................................................................... 3-16

:CALCulate:FSCan:SLISt:SORT:TYPE ................................................................................. 3-17

:CALCulate:FSCan:SLISt:ZOOM ......................................................................................... 3-17

:CALCulate:FSCan:SLISt:ZOOM:OUT .................................................................................. 3-18

:CALCulate:LLINe:ALL:DELete ........................................................................................... 3-18

:CALCulate:LLINe:TEST .................................................................................................... 3-18

:CALCulate:LLINe<n>:AMPLitude:CMODe:RELative ............................................................ 3-18

:CALCulate:LLINe<n>:BUILd ............................................................................................ 3-19

:CALCulate:LLINe<n>:CONTrol:INTerpolate:TYPE .............................................................. 3-19

:CALCulate:LLINe<n>:COPY ............................................................................................. 3-20

:CALCulate:LLINe<n>:DATA.............................................................................................. 3-20

:CALCulate:LLINe<n>:DELete ........................................................................................... 3-21

:CALCulate:LLINe<n>:DISPlay .......................................................................................... 3-21

:CALCulate:LLINe<n>:FAIL? ............................................................................................. 3-22

:CALCulate:LLINe<n>:FREQuency:CMODe:RELative ........................................................... 3-22

:CALCulate:LLINe<n>:MARGin .......................................................................................... 3-23

:CALCulate:LLINe<n>:MARGin:STATe ................................................................................ 3-23

:CALCulate:LLINe<n>:OFFSet:X ........................................................................................ 3-24

:CALCulate:LLINe<n>:OFFSet:Y ........................................................................................ 3-24

:CALCulate:LLINe<n>:TRACe ............................................................................................ 3-25

:CALCulate:MARker:PEAK:SEARch:THReshold:LINe ............................................................ 3-25

:CALCulate:MARKer<n>:LINes[:STATe].............................................................................. 3-26

:CALCulate:MARKer<n>:STATe ......................................................................................... 3-26

:CALCulate:MARKer<n>:X ................................................................................................ 3-27

:CALCulate:MARKer<n>:Y? ............................................................................................... 3-27

:CALCulate:METer:LIMit:ALL:FAIL? .................................................................................... 3-28

:CALCulate:METer:POWer[:CURRent]? ............................................................................... 3-28

:CALCulate:METer:POWer:PEAK? ....................................................................................... 3-28

:CALCulate:METer<n>:LIMit[:DATA] ................................................................................. 3-29

:CALCulate:METer<n>:LIMit:FAIL? .................................................................................... 3-29

:CALCulate:METer<n>:LIMit:STATe .................................................................................. 3-30

XII RSA3000E Programming Guide

Contents RIGOL

:CALibration Commands .......................................................................................................... 3-31

:CALibration:[ALL] ............................................................................................................ 3-31

:CALibration:AUTO ........................................................................................................... 3-31

:COUPle Command ................................................................................................................. 3-32

:COUPle .......................................................................................................................... 3-32

:CONFigure Command ............................................................................................................ 3-33

:CONFigure? .................................................................................................................... 3-33

:CONFigure:FSCan ........................................................................................................... 3-33

:DISPlay Commands ............................................................................................................... 3-34

:DISPlay:BACKlight ........................................................................................................... 3-35

:DISPlay:ENABle .............................................................................................................. 3-35

:DISPlay:FSCan:VIEW:METer:FLINe .................................................................................. 3-36

:DISPlay:FSCan:VIEW:METer[:STATe] ............................................................................... 3-36

:DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision .............................................. 3-37

:DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:RLEVel .................................................. 3-37

:DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:RLEVel:OFFSet ...................................... 3-38

:DISPlay:FSCan:WINDow:MAMarker[:STATe] .................................................................... 3-38

:DISPlay:GRATicule[:STATe] .............................................................................................. 3-39

:DISPlay:HDMI[:STATe] .................................................................................................... 3-39

:DISPlay:METer<n>[:STATe]............................................................................................ 3-40

:DISPlay:VIEW:WINDow:TRACe:X:SPACing ....................................................................... 3-40

:DISPlay:WINDow:TRACe:Y:DLINe .................................................................................... 3-41

:DISPlay:WINDow:TRACe:Y:DLINe:STATe .......................................................................... 3-41

:DISPlay[:WINDow]:TRACe<n>:MODE ............................................................................. 3-42

:FETCh Command ................................................................................................................... 3-43

:FETCh:FSCan? ................................................................................................................ 3-43

:FORMat Commands ............................................................................................................... 3-44

:FORMat:BORDer ............................................................................................................. 3-44

:FORMat[:TRACe][:DATA] ................................................................................................. 3-45

IEEE 488.2 Common Commands.............................................................................................. 3-46

:INITiate Commands ............................................................................................................... 3-47

:INITiate:FSCan:CLEar:IMMediate ..................................................................................... 3-47

:INITiate:PAUSe ............................................................................................................... 3-47

:INITiate:RESume ............................................................................................................ 3-47

:INITiate1:CONTinuous .................................................................................................... 3-47

:INITiate2:CONTinuous .................................................................................................... 3-48

:INITiate2:IMMediate ....................................................................................................... 3-48

:INITiate2:RESTart ........................................................................................................... 3-48

:INSTrument Commands ......................................................................................................... 3-49

:INSTrument:COUPle:FREQuency:CENTer .......................................................................... 3-49

:INSTrument:DEFault ....................................................................................................... 3-49

:INSTrument:NSELect ....................................................................................................... 3-50

:INSTrument[:SELect] ...................................................................................................... 3-50

:MMEMory Commands ............................................................................................................ 3-51

:MMEMory:DELete ............................................................................................................ 3-52

:MMEMory:LOAD:CORRection ........................................................................................... 3-52

:MMEMory:LOAD:LIMit ..................................................................................................... 3-52

:MMEMory:LOAD:SCAN .................................................................................................... 3-53

:MMEMory:LOAD:SLISt ..................................................................................................... 3-53

:MMEMory:LOAD:STATe .................................................................................................... 3-54

:MMEMory:LOAD:TRACe ................................................................................................... 3-54

:MMEMory:LOAD:TRACe:DATA .......................................................................................... 3-54

:MMEMory:MOVE ............................................................................................................. 3-55

:MMEMory:STORe:CORRection .......................................................................................... 3-55

:MMEMory:STORe:LIMit .................................................................................................... 3-56

:MMEMory:STORe:SCAN ................................................................................................... 3-56

:MMEMory:STORe:SCReen ................................................................................................ 3-56

:MMEMory:STORe:SLISt ................................................................................................... 3-57

RSA3000E Programming Guide XIII

RIGOL Contents

:MMEMory:STORe:STATe ................................................................................................... 3-57

:MMEMory:STORe:TRACe .................................................................................................. 3-58

:MMEMory:STORe:TRACe:DATA ......................................................................................... 3-58

[:SENSe] Commands ............................................................................................................... 3-59

[:SENSe]:AVERage:COUNt ................................................................................................ 3-61

[:SENSe]:AVERage:TYPE ................................................................................................... 3-61

[:SENSe]:AVERage:TYPE:AUTO ......................................................................................... 3-62

[:SENSe]:BANDwidth|BWIDth:EMIFilter:STATe ................................................................... 3-62

[:SENSe]:BANDwidth|BWIDth[:RESolution] ........................................................................ 3-63

[:SENSe]:BANDwidth|BWIDth[:RESolution]:AUTO .............................................................. 3-63

[:SENSe]:CORRection:CSET:ALL:DELete ............................................................................. 3-64

[:SENSe]:CORRection:CSET:ALL[:STATe] ............................................................................ 3-64

[:SENSe]:CORRection:CSET<n>:DATA ............................................................................... 3-65

[:SENSe]:CORRection:CSET<n>:DATA:MERGe ................................................................... 3-65

[:SENSe]:CORRection:CSET<n>:DELete ............................................................................ 3-66

[:SENSe]:CORRection:CSET<n>[:STATe] ........................................................................... 3-66

[:SENSe]:CORRection:CSET<n>:X:SPACing ....................................................................... 3-67

:INPut:IMPedance ............................................................................................................ 3-67

[:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] ...................................................... 3-67

[:SENSe]:CORRection:SA[:RF]:GAIN .................................................................................. 3-68

[:SENSe]:DETector:TRACe<n>:AUTO ................................................................................ 3-68

[:SENSe]:EMC:STANdard[:SELect] ..................................................................................... 3-69

[:SENSe]:FREQuency:CENTer ............................................................................................ 3-69

[:SENSe]:FREQuency:MIDSpan ......................................................................................... 3-70

[:SENSe]:FREQuency:SPAN ............................................................................................... 3-70

[:SENSe]:FREQuency:STARt .............................................................................................. 3-71

[:SENSe]:FREQuency:STARt:AUTO .................................................................................... 3-71

[:SENSe]:FREQuency:STOP ............................................................................................... 3-72

[:SENSe]:FREQuency:STOP:AUTO ..................................................................................... 3-72

[:SENSe]:FSCan:DETector:TRACe<n> ............................................................................... 3-73

[:SENSe]:FSCan:FINal:DETector<n> ................................................................................. 3-73

[:SENSe]:FSCan:FINal:DETector<n>:DWELl ...................................................................... 3-74

[:SENSe]:FSCan:FINal:DETector<n>:LDELta...................................................................... 3-75

[:SENSe]:FSCan:MARKer:COUPle:METer ............................................................................ 3-75

[:SENSe]:FSCan:SCAN:ABORT ........................................................................................... 3-76

[:SENSe]:FSCan:SCAN<n>:BANDwidth|BWIDth:EMIFilter:STATe ......................................... 3-76

[:SENSe]:FSCan:SCAN<n>:BANDwidth[:RESolution] .......................................................... 3-76

[:SENSe]:FSCan:SCAN<n>:BANDwidth[:RESolution]:AUTO ................................................. 3-77

[:SENSe]:FSCan:SCAN<n>:INPut:ATTenuation ................................................................... 3-78

[:SENSe]:FSCan:SCAN<n>:INPut:ATTenuation:AUTO ......................................................... 3-78

[:SENSe]:FSCan:SCAN<n>:POINT ..................................................................................... 3-79

[:SENSe]:FSCan:SCAN<n>:POWer:GAIN[:STATe] ............................................................... 3-79

[:SENSe]:FSCan:SCAN<n>:STARt ..................................................................................... 3-80

[:SENSe]:FSCan:SCAN<n>:STATe ..................................................................................... 3-80

[:SENSe]:FSCan:SCAN<n>:STOP ...................................................................................... 3-81

[:SENSe]:FSCan:SCAN<n>:TIME....................................................................................... 3-81

[:SENSe]:FSCan:SCAN<n>:TIME:AUTO ............................................................................. 3-82

[:SENSe]:FSCan:SEARch:MODE ......................................................................................... 3-82

[:SENSe]:FSCan:SEARch:PEAK:COUNt ............................................................................... 3-83

[:SENSe]:FSCan:SEARch:PEAK:COUNt:STATe .................................................................... 3-83

[:SENSe]:FSCan:SEARch:SUBRange:COUNt ....................................................................... 3-84

[:SENSe]:FSCan:SEQuence ............................................................................................... 3-84

[:SENSe]:FSCan:SEQuence:REMeasure .............................................................................. 3-85

[:SENSe]:FSCan:SLISt:COUPle:METer ................................................................................ 3-85

[:SENSe]:FSCan:TRACe:TYPE ............................................................................................ 3-86

[:SENSe]:METer:DETector:DWELl ...................................................................................... 3-86

[:SENSe]:METer:PHOLd:ADJustable ................................................................................... 3-87

[:SENSe]:METer:PHOLd:RESet .......................................................................................... 3-87

XIV RSA3000E Programming Guide

Contents RIGOL

[:SENSe]:METer:PHOLd:TYPE ........................................................................................... 3-87

[:SENSe]:METer<n>:DETector ......................................................................................... 3-88

[:SENSe]:POWer[:RF]:ATTenuation ................................................................................... 3-88

[:SENSe]:POWer[:RF]:GAIN[:STATe] ................................................................................. 3-89

:STATus Commands ................................................................................................................ 3-90

:SYSTem Commands ............................................................................................................... 3-91

:TRACe Commands ................................................................................................................. 3-92

:TRACe[:DATA] ................................................................................................................ 3-92

:TRACe<n>:DISPlay[:STATe] ............................................................................................ 3-93

:TRACe<n>:UPDate:STATe ............................................................................................... 3-93

:TRIGger Commands .............................................................................................................. 3-94

:TRIGger[:SEQuence]:ATRigger ........................................................................................ 3-94

:TRIGger[:SEQuence]:ATRigger:STATe .............................................................................. 3-95

:TRIGger[:SEQuence]:EXTernal<n>:DELay........................................................................ 3-95

:TRIGger[:SEQuence]:EXTernal<n>:DELay:STATe .............................................................. 3-96

:TRIGger[:SEQuence]:EXTernal<n>:SLOPe ....................................................................... 3-96

:TRIGger[:SEQuence]:HOLDoff ......................................................................................... 3-97

:TRIGger[:SEQuence]:HOLDoff:STATe ............................................................................... 3-97

:TRIGger[:SEQuence]:SOURce .......................................................................................... 3-98

:TRIGger2:MODE ............................................................................................................. 3-98

:UNIT Command................................................................................................................... 3-100

:UNIT:POWer ................................................................................................................. 3-100

Chapter 4 Command System for VSA Mode ........................................................................ 4-1

:CALCulate Commands .............................................................................................................. 4-2

:CALCulate:DDEMod:MARKer:AOFF ..................................................................................... 4-3

:CALCulate:DDEMod:MARKer:COUPle[:STATe] ..................................................................... 4-3

:CALCulate:DDEMod:MARKer:TABLe[:STATe] ....................................................................... 4-3

:CALCulate:DDEMod:MARKer<n>:CPSearch[:STATe] ............................................................ 4-4

:CALCulate:DDEMod:MARKer<n>:FUNCtion ........................................................................ 4-4

:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:LEFT ...................................................... 4-5

:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:RIGHt ..................................................... 4-5

:CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:SPAN ...................................................... 4-6

:CALCulate:DDEMod:MARKer<n>:MAXimum ....................................................................... 4-7

:CALCulate:DDEMod:MARKer<n>:MAXimum:LEFT ............................................................... 4-7

:CALCulate:DDEMod:MARKer<n>:MAXimum:NEXT .............................................................. 4-7

:CALCulate:DDEMod:MARKer<n>:MAXimum:PREVious ......................................................... 4-8

:CALCulate:DDEMod:MARKer<n>:MAXimum:RIGHt ............................................................. 4-8

:CALCulate:DDEMod:MARKer<n>:MINimum ........................................................................ 4-9

:CALCulate:DDEMod:MARKer<n>:MODE ............................................................................. 4-9

:CALCulate:DDEMod:MARKer<n>:REFerence ..................................................................... 4-10

:CALCulate:DDEMod:MARKer<n>:TRACe .......................................................................... 4-10

:CALCulate:DDEMod:MARKer<n>:X .................................................................................. 4-11

:CALCulate:DDEMod:MARKer<n>:Y:IMAGinary .................................................................. 4-11

:CALCulate:DDEMod:MARKer<n>:Y[:REAL] ....................................................................... 4-12

:CALCulate:MARKer<n>[:SET]:CENTer .............................................................................. 4-13

:CALCulate:MARKer<n>[:SET]:DELTa:CENTer .................................................................... 4-13

:CALCulate:MARKer<n>[:SET]:RLEVel ............................................................................... 4-13

:CALCulate:MARKer<n>[:SET]:STARt ................................................................................ 4-14

:CALCulate:MARKer<n>[:SET]:STEP ................................................................................. 4-14

:CALCulate:MARKer<n>[:SET]:STOP ................................................................................. 4-15

:CALibration Commands .......................................................................................................... 4-16

:CALibration:[ALL] ............................................................................................................ 4-16

:CALibration:AUTO ........................................................................................................... 4-16

:CONFigure Commands ........................................................................................................... 4-17

:CONFIgure:BERate ......................................................................................................... 4-17

:CONFigure:DDEMod ........................................................................................................ 4-17

:DISPlay Commands ............................................................................................................... 4-18

RSA3000E Programming Guide XV

RIGOL Contents

:DISPlay:BACKlight ........................................................................................................... 4-19

:DISPlay:DDEMod:TRACe<n>:DDEMod:EYE:COUNt ........................................................... 4-19

:DISPlay:DDEMod:TRACe<n>:DDEMod:SYMBol:FORMat .................................................... 4-20

:DISPlay:DDEMod:TRACe<n>:FEED .................................................................................. 4-20

:DISPlay:DDEMod:TRACe<n>:FORMat .............................................................................. 4-21

:DISPlay:DDEMod:TRACe<n>:X[:SCALe]:COUPle ............................................................... 4-21

:DISPlay:DDEMod:TRACe<n>:X[:SCALe]:RLEVel ................................................................ 4-22

:DISPlay:DDEMod:TRACe<n>:X[:SCALe]:RPOSition ........................................................... 4-23

:DISPlay:DDEMod:TRACe<n>:X[:SCALe]:SPAN .................................................................. 4-23

:DISPlay:DDEMod:TRACe<n>:Y[:SCALe]:AUTO:ONCE ........................................................ 4-24

:DISPlay:DDEMod:TRACe<n>:Y[:SCALe]:PDIVision ............................................................ 4-24

:DISPlay:DDEMod:TRACe<n>:Y[:SCALe]:RLEVel ................................................................ 4-25

:DISPlay:DDEMod:TRACe<n>:Y:UNIT:PREFerence ............................................................. 4-25

:DISPlay:DDEMod:WINDow:FORMat .................................................................................. 4-26

:DISPlay:ENABle ............................................................................................................... 4-26

:DISPlay:GRATicule[:STATe] .............................................................................................. 4-27

:DISPlay:HDMI[:STATe] .................................................................................................... 4-27

:FETCh Commands .................................................................................................................. 4-28

:FETCh:BER? .................................................................................................................... 4-28

:FETCh:DDEMod? ............................................................................................................. 4-28

:FORMat Commands ............................................................................................................... 4-29

:FORMat:BORDer ............................................................................................................. 4-29

:FORMat[:TRACe][:DATA] ................................................................................................. 4-29

IEEE 488.2 Common Commands .............................................................................................. 4-31

:INITiate Command................................................................................................................. 4-32

:INITiate:BER:RESTart ...................................................................................................... 4-32

:INITiate:CONTinuous ...................................................................................................... 4-32

:INSTrument Commands.......................................................................................................... 4-33

:INSTrument:COUPle:FREQuency:CENTer .......................................................................... 4-33

:INSTrument:DEFault ........................................................................................................ 4-33

:INSTrument:NSELect ....................................................................................................... 4-34

:INSTrument[:SELect] ....................................................................................................... 4-34

:MMEMory Commands ............................................................................................................. 4-35

:MMEMory:DELete ............................................................................................................ 4-35

:MMEMory:LOAD:FMT ....................................................................................................... 4-35

:MMEMory:LOAD:STATe .................................................................................................... 4-36

:MMEMory:LOAD:TRACe:DATA .......................................................................................... 4-36

:MMEMory:MOVE .............................................................................................................. 4-37

:MMEMory:STORe:FMT ..................................................................................................... 4-37

:MMEMory:STORe:SCReen ................................................................................................ 4-37

:MMEMory:STORe:STATe ................................................................................................... 4-38

:MMEMory:STORe:TRACe:DATA ......................................................................................... 4-38

[:SENSe] Commands ............................................................................................................... 4-40

[:SENSe]:ACQuisition:TIME ............................................................................................... 4-41

:INPut:IMPedance ............................................................................................................ 4-41

[:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] ...................................................... 4-41

[:SENSe]:CORRection:SA[:RF]:GAIN .................................................................................. 4-42

[:SENSe]:DDEMod:ALPHa ................................................................................................. 4-42

[:SENSe]:DDEMod:FFT:WINDow[:TYPE] ............................................................................ 4-43

[:SENSe]:DDEMod:FILTer:MEASurement ............................................................................ 4-43

[:SENSe]:DDEMod:FILTer:MEASurement:USER<n>[:DATA]................................................. 4-44

[:SENSe]:DDEMod:FILTer:REFerence ................................................................................. 4-44

[:SENSe]:DDEMod:FILTer:REFerence:USER<n>[:DATA] ...................................................... 4-45

[:SENSe]:DDEMod:FSK:DEViation:REFerence ..................................................................... 4-45

[:SENSe]:DDEMod:FSK:DEViation:REFerence:AUTO ........................................................... 4-46

[:SENSe]:DDEMod:LOAD:KNOWndata ............................................................................... 4-46

[:SENSe]:DDEMod:MODulation .......................................................................................... 4-47

[:SENSe]:DDEMod:PPSYmbol ............................................................................................ 4-47

XVI RSA3000E Programming Guide

Contents RIGOL

[:SENSe]:DDEMod:RTTrace:DETector ............................................................................... 4-48

[:SENSe]:DDEMod:SRATe ................................................................................................. 4-48

[:SENSe]:DDEMod:STANdard:PRESet ................................................................................ 4-49

[:SENSe]:DDEMod:SWEep:POINts .................................................................................... 4-49

[:SENSe]:DDEMod:SYNC:ALENgth ..................................................................................... 4-50

[:SENSe]:DDEMod:SYNC:BURSt:RUNIn ............................................................................. 4-50

[:SENSe]:DDEMod:SYNC:BURSt:STATe .............................................................................. 4-51

[:SENSe]:DDEMod:SYNC:SLENgth ..................................................................................... 4-51

[:SENSe]:DDEMod:SYNC:SWORd:OFFSet .......................................................................... 4-52

[:SENSe]:DDEMod:SYNC:SWORd:PATTern ......................................................................... 4-52

[:SENSe]:DDEMod:SYNC:SWORd:STATe ............................................................................ 4-53

[:SENSe]:FREQuency:CENTer............................................................................................ 4-53

[:SENSe]:FREQuency:CENTer:STEP:AUTO ......................................................................... 4-54

[:SENSe]:FREQuency:CENTer:STEP[:INCRement] .............................................................. 4-54

[:SENSe]:FREQuency:SPAN? ............................................................................................. 4-55

[:SENSe]:FREQuency:STARt ............................................................................................. 4-55

[:SENSe]:FREQuency:STOP .............................................................................................. 4-56

[:SENSe]:POWer[:RF]:RANGe ........................................................................................... 4-56

:STATus Commands ................................................................................................................ 4-57

:SYSTem Commands ............................................................................................................... 4-58

:TRACe Command .................................................................................................................. 4-59

:TRACe<n>[:DATA]? ....................................................................................................... 4-59

:TRIGger Commands .............................................................................................................. 4-60

:TRIGger[:SEQuence]:ATRigger ........................................................................................ 4-60

:TRIGger[:SEQuence]:ATRigger:STATe .............................................................................. 4-61

:TRIGger[:SEQuence]:EXTernal<n>:DELay........................................................................ 4-61

:TRIGger[:SEQuence]:EXTernal<n>:DELay:STATe .............................................................. 4-62

:TRIGger[:SEQuence]:EXTernal<n>:SLOPe ....................................................................... 4-62

:TRIGger[:SEQuence]:FMT:CRITeria .................................................................................. 4-63

:TRIGger[:SEQuence]:FMT:DELay ..................................................................................... 4-64

:TRIGger[:SEQuence]:FMT:DELay:STATe ........................................................................... 4-64

:TRIGger[:SEQuence]:FMT:MASK ...................................................................................... 4-65

:TRIGger[:SEQuence]:FMT:MASK:EDIT ............................................................................. 4-65

:TRIGger[:SEQuence]:FMT:MASK:RELative:AMPLitude ....................................................... 4-66

:TRIGger[:SEQuence]:FMT:MASK:RELative:FREQuency ...................................................... 4-66

:TRIGger[:SEQuence]:FMT:MASK<n>:BUILd ..................................................................... 4-67

:TRIGger[:SEQuence]:FMT:MASK<n>:DATA ...................................................................... 4-67

:TRIGger[:SEQuence]:FMT:MASK<n>:DELete.................................................................... 4-68

:TRIGger[:SEQuence]:FMT:MASK<n>:NAME ..................................................................... 4-68

:TRIGger[:SEQuence]:FMT:MASK<n>:NEW ....................................................................... 4-69

:TRIGger[:SEQuence]:HOLDoff ......................................................................................... 4-69

:TRIGger[:SEQuence]:HOLDoff:STATe ............................................................................... 4-70

:TRIGger[:SEQuence]:LEVel ............................................................................................. 4-70

:TRIGger[:SEQuence]:SOURce .......................................................................................... 4-71

:TRIGger2:MODE ............................................................................................................. 4-71

Chapter 5 Programming Examples ..................................................................................... 5-1

Programming Instructions ......................................................................................................... 5-2

Programming Preparations ........................................................................................................ 5-2

Visual C++ 6.0 Programming Example ....................................................................................... 5-3

Visual Basic 6.0 Programming Example .................................................................................... 5-11

LabVIEW 2010 Programming Example ..................................................................................... 5-15

Linux Programming Example ................................................................................................... 5-19

Programming Preparations ................................................................................................ 5-19

Linux Programming Procedures ......................................................................................... 5-22

Chapter 6 Appendix ............................................................................................................ 6-1

Appendix A: Default Settings ..................................................................................................... 6-1

Appendix B: Warranty ............................................................................................................. 6-11

RSA3000E Programming Guide XVII

Chapter 1 Programming Overview RIGOL

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

RSA3000E Programming Guide 1-1

RIGOL Chapter 1 Programming Overview

Build Remote Communicatio n

RSA3000E supports communication with PC via USB and LAN interface for remote control. This chapter
introduces in detai ls how to use Ultra Sigma to send comm ands 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

RSA3000E supports three communication inte rfaces: USB and LAN.

USB DEVICE
LAN

Figure 1-1 RSA3000E Communication Interface

(1) Remote communication via USB:

Use the USB cable to connect the USB DEVICE interface on the rear panel of RSA3000E 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 RSA3000E to the local area network by using a 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.

1-2 RSA3000E Programming Guide

Chapter 1 Programming Overview RIGOL

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 RSA3000E by programming in LabVIEW, Visual C++, and other
development environments. For details, refer to descriptions in Chapter 4 in this manual.

2. Send SCPI commands via the PC software

Yo u can use the PC so ftw are to sen d comman ds to c ontrol RSA3000E remotely. RIGOL Ultra Sigma is
recommended. You can download the software from RIGOL official website (www.rigol.com).

RSA3000E Programming Guide 1-3

RIGOL Chapter 1 Programming Overview

SCPI Command Overview

SCPI (Standard Commands for Programmable Instruments) is a standardiz ed 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 consis ts 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; "?" i s add ed at the en d of the comman d line to in dic ate a qu ery; the comman ds an d p ar ameters
are separated by spaces.

For example,
:CALCulate:BANDwidth:NDB <rel_ampl>
:CALCulate:BANDwidth:NDB?

CALCulate is the root keyword of the command. BANDwidth is the second-level keyword, and NDB is the
third-level keyword. The command line starts with ":", and a colon is also used to separate the
multiple-level keywords. <rel_ampl > r epres ents th e par ameter s a vailable fo r setting. "?" represent s qu ery.
The command :CALCulate:BANDwidth:NDB and the parameter <rel_ampl> are separated by a space.

In some commands with multiple parameters , "," is often us ed to separate these parameters. F or exampl e,
:SYSTem:DATE <yea r>,<month >, <da y >.

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 b races are op tional. You do not hav e to set it, also you c an 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 :CALCulate:MARKer<n>:LINes[:STATe]
OFF|ON|0|1, you can select any of the four available parameters: OFF, ON, 0, or 1.

3. Square Brackets [ ]

The content (command keyword) in the square brack ets can be omit ted. If a keyword is omitted, it will
be set to the default. F or example, for the [:SENSe]:POWer[:RF]:ATTenuation? command, sending any
of the four commands below can generate the same effect:
:POWer:ATTenuation?
:POWer:RF:ATTenuation?
:SENSe:POWer:ATTenuation?
:SENSe:POWer:RF:ATTenuation?

4. Angle Brackets < >
The parameter enclosed in the angle brackets must be replaced by an effective value. For example,
send the :SENSe:FREQuency:CENTer 1000 command in [:SENSe]:FREQuency:CENTer <freq>format.

1-4 RSA3000E Programming Guide

Chapter 1 Programming Overview RIGOL

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 point).

5. Discrete
The parameter could only be one of the specified values and these values are discontin uous.

6. ASCII String
The parameter can be the combinations of ASCII characters.

Command Abb r eviation

All the commands are case-insensitive. T hey 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,
:CALCulate:BANDwidth:NDB? can be abbreviated as :CALC:BAND:NDB? or :calc:band:ndb?

RSA3000E Programming Guide 1-5

Chapter 2 Command Systems for GPSA and RTSA Modes RIGOL

Chapter 2 Command Systems for GPSA and RTSA

Modes

This chapter introduces the commands of the RSA3000E series spectrum analyzer.

Contents in this chapter:

 :CALCulate Commands
 :CALibration Commands
 :CONFigure Commands
 :COUPle Commands
 :DISPlay Commands
 :FETCh Commands
 :FORMat Commands
 IEEE 488.2 Common Commands
 :INITiate Commands
 :INSTrument Commands
 :MMEMory Commands
 :OUTPut Command
 :READ Commands
 [:SENSe] Commands
 :SOURce Commands
 :STATus Commands
 :SYSTem Commands
 :TRACe Commands
 :TRIGger Commands
 :UNIT Command

Remarks:

1. The commands concerning the advanced measurement are only available for the RSA3000E model

2. The commands related to the tracking generator are only available for RSA3030E-TG/RSA3015E-TG.

3. For the command set, unless otherwise specified, the query command returns "N/A" (without

4. This manual takes RSA3030E as an example to illustrate the range of the parameters in each

installed with relevant options. For details, refer to remarks for each command subsystem.
They are only available for GPSA mode.
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).

command.

RSA3000E Programming Guide 2-1

RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes

:CALCulate Commands

Command List:

 :CALCulate:BANDwidth|BWIDth:NDB
 :CALCulate:BANDwidth|BWIDth:RESult?
 :CALCulate:BANDwidth|BWIDth:RLEFt?
 :CALCulate:BANDwidth|BWIDth:RRIGht?
 :CALCulate:BANDwidth|BWIDth [:STATe]
 :CALCulate:LLINe:ALL:DELete
 :CALCulate:LLINe:TEST
 :CALCulate:LLINe<n>:AMPLitude:CMODe:RELative
 :CALCulate:LLINe<n>:BUILd
 :CALCulate:LLINe<n>:COPY
 :CALCulate:LLINe<n>:DATA
 :CALCulate:LLINe<n>:DELete
 :CALCulate:LLINe<n>:DISPlay
 :CALCulate:LLINe<n>:FAIL?
 :CALCulate:LLINe<n>:FREQuency:CMODe:RELative
 :CALCulate:LLINe<n>:MARGin
 :CALCulate:LLINe<n>:MARGin:STATe
 :CALCulate:LLINe<n>:TRACe
 :CALCulate:LLINe<n>:TYPE
 :CALCulate:MARKer:AOFF
 :CALCulate:MARKer:COUPle[:STATe]
 :CALCulate:MARKer:PEAK:EXCursion
 :CALCulate:MARKer:PEAK:EXCursion:STATe
 :CALCulate:MARKer:PEAK:SEARch:MODE
 :CALCulate:MARKer:PEAK:SORT
 :TRACe:MATH:PEAK:SORT
 :CALCulate:MARKer:PEAK:TABLe:READout
 :CALCulate:MARKer:PEAK:TABLe[:STATe]
 :CALCulate:MARKer:PEAK:THReshold
 :CALCulate:MARKer:PEAK:THReshold:STATe
 :CALCulate:MARKer:TABLe[:STATe]
 :CALCulate:MARKer:TRCKing[:STATe]
 :CALCulate:MARKer<n>:CPSearch[:STATe]
 :CALCulate:MARKer<n>:FCOunt:GATetime
 :CALCulate:MARKer<n>:FCOunt:GATetime:AUTO
 :CALCulate:MARKer<n>:FCOunt[:STATe]

2-2 RSA3000E Programming Guide

Chapter 2 Command Systems for GPSA and RTSA Modes RIGOL

 :CALCulate:MARKer<n>:FCOunt:X?
 :CALCulate:MARKer<n>:FUNCtion
 :CALCulate:MARKer<n>:FUNCtion:BAND:LEFT
 :CALCulate:MARKer<n>:FUNCtion:BAND:RIGHt
 :CALCulate:MARKer<n>:FUNCtion:BAND:SPAN
 :CALCulate:MARKer<n>:FUNCtion:BAND:SPAN:AUTO
 :CALCulate:MARKer<n>:LINes[:STATe]
 :CALCulate:MARKer<n>:MAXimum:LEFT
 :CALCulate:MARKer<n>:MAXimum[:MAX]
 :CALCulate:MARKer<n>:MAXimum:NEXT
 :CALCulate:MARKer<n>:MAXimum:RIGHt
 :CALCulate:MARKer<n>:MINimum
 :CALCulate:MARKer<n>:MODE
 :CALCulate:MARKer<n>:PTPeak
 :CALCulate:MARKer<n>:REFerence
 :CALCulate:MARKer<n>[:SET]:CENTer
 :CALCulate:MARKer<n>[:SET]:DELTa:CENTer
 :CALCulate:MARKer<n>[:SET]:DELTa:SPAN
 :CALCulate:MARKer<n>[:SET]:RLEVel
 :CALCulate:MARKer<n>[:SET]:STARt
 :CALCulate:MARKer<n>[:SET]:STEP
 :CALCulate:MARKer<n>[:SET]:STOP
 :CALCulate:MARKer<n>:STATe
 :CALCulate:MARKer<n>:TRACe
 :CALCulate:MARKer<n>:TRACe:AUTO
 :CALCulate:MARKer<n>:X
 :CALCulate:MARKer<n>:X:READout
 :CALCulate:MARKer<n>:X:READout:AUTO
 :CALCulate:MARKer<n>:Y
 :CALCulate:MARKer<n>:Z:POSition
 :CALCulate:MATH
 :CALCulate:NTData[:STATe]

RSA3000E Programming Guide 2-3

RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes

Name

Type

Range

Default

<rel_ampl>

Consecutive Real Number

-140 dB to -0.01 dB

-3.01 dB

:CALCulate:BANDwidth|BWIDth:NDB

Syntax

:CALCulate:BANDwidth|BWIDth:NDB <rel_ampl>
:CALCulate:BANDwidth|BWIDth:NDB?

Description

Sets the N value in N dB BW measurement.
Queries the N value in N dB BW measurement.

Parameter

Remarks

This command is invalid for the PvT measurement mode in RTSA.

Return Format

The query returns the N value in scientific notation.

Example

The following command sets N to -4.
:CALCulate:BANDwidth:NDB -4
:CALCulate:BWIDth:NDB -4

The following query returns -4.000000e+00.
:CALCulate:BANDwidth:NDB?
:CALCulate:BWIDth:NDB?

:CALCulate:BANDwidth|BWIDth:RESult?

Syntax

:CALCulate:BANDwidth|BWIDth:RESult?

Description
Queries the measurement results of the N dB band, and its unit is Hz.

Remarks

This command is invalid for the PvT measurement mode in RTSA.
Return Format

The query returns the bandwidth value in scientific notation (with Hz as the unit).
If the two points which are located at both sides of the current marker with N dB fall or rise in its peak
amplitude are not found, the query returns -1.000000000e+02.

2-4 RSA3000E Programming Guide