Rigol RSA3045, RSA3030, RSA3045-TG, RSA3030-TG Programming Guide

RIGOL

Programming Guide

RSA3000 Series Real-time

Spectrum Analyzer

Jan. 29, 2018

RIGOL TECHNOLOGIES, INC.

RIGOL

Guaranty and Declaration

Trademark Information

RIGOL is a registered trademark of RIGOL TECHNO LOGI E S, INC.

Publication Number

PGD21101-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:2008 standard and the ISO14001: 2004 standard. Other international standard conformance certifications are in progress.

If you have any problem or requirement when using our products or this manual, please contact RIGOL. E-mail: service@rigol.com Website: www.rigol.com

RSA3000 Programming Guide I

RIGOL

Tip

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

Model

Frequency Range

Tracking Generator

RSA3045

9 kHz to 4.5 GHz

None

RSA3030

9 kHz to 3 GHz

None

RSA3045-TG

9 kHz to 4.5 GHz

4.5 GHz

RSA3030-TG

9 kHz to 3 GHz

3 GHz

Document Overview

This manual introduces how to program and control RIGOL RSA3000 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 System

This chapter introduces the syntax, function, parameters, a nd usage of each command.

Chapter 3 Programming Examples

This chapter illustrates how to control the RSA3000 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 us ually denoted by the f ormat of "Menu Word (Bold) + Character Sh ading". 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 RSA3000 series spectrum analyzer includes the following models. Unless otherwise specified, this manual takes RSA3045 as an example to illustr ate the usage of each command of RS A3000 series spectrum analyzer.

II RSA3000 Programming Guide

Contents RIGOL

Contents

Guaranty and Declaration ......................................................................................................... I

Document Overview ................................................................................................................. II

Chapter 1 Programming Overview...................................................................................... 1-1

Build Remote Communication .................................................................................................... 1-2

Remote Control Method ............................................................................................................ 1-3

SCPI Command Overview .......................................................................................................... 1-4

Syntax ............................................................................................................................... 1-4

Symbol Description ............................................................................................................ 1-4

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

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

Chapter 2 Command System ............................................................................................... 2-1

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

:CALCulate: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

RSA3000 Programming Guide III

RIGOL Contents

: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

IV RSA3000 Programming Guide

Contents RIGOL

: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:WINDow:TRACe:Y[:SCALe]:RLEVel <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

RSA3000 Programming Guide V

RIGOL Contents

*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: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:LIMit .................................................................................................... 2-94

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

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

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

:MMEMory:STORe:SCReen ................................................................................................ 2-95

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

:MMEMory:STORe:TRACe .................................................................................................. 2-96

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

:OUTPut Commands ................................................................................................................ 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

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

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

VI RSA3000 Programming Guide

Contents RIGOL

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

:TRACe:AVERage:COUNt ................................................................................................ 2-117

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

:INPut:IMPedance .......................................................................................................... 2-129

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

RSA3000 Programming Guide VII

RIGOL Contents

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

:SOURce Commands ............................................................................................................. 2-168

:SOURce:CORRection:OFFSet .......................................................................................... 2-168

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

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

VIII RSA3000 Programming Guide

Contents RIGOL

:SOURce:TRACe:STORref ............................................................................................... 2-169

:STATus Commands .............................................................................................................. 2-170

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

:STATus:OPERation:ENABle ............................................................................................. 2-171

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

:STATus:PRESet ............................................................................................................. 2-172

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

:STATus:QUEStionable:ENABle ........................................................................................ 2-172

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

:SYSTem Commands ............................................................................................................. 2-174

:SYSTem:BEEPer:STATe .................................................................................................. 2-175

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

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

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

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

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

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

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

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

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

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

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

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

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

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

:SYSTem:DATE............................................................................................................... 2-182

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

:SYSTem:LANGuage ....................................................................................................... 2-183

:SYSTem:LKEY ............................................................................................................... 2-183

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

:SYSTem:PON:TYPE ....................................................................................................... 2-184

:SYSTem:PRESet ............................................................................................................ 2-185

:SYSTem:PRESet:SAVE ................................................................................................... 2-185

:SYSTem:PRESet:TYPE ................................................................................................... 2-185

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

:SYSTem:SCPI:DISPlay ................................................................................................... 2-186

:SYSTem:SHOW ............................................................................................................. 2-186

:SYSTem:TIME ............................................................................................................... 2-187

:TRACe Commands ............................................................................................................... 2-188

:TRACe:CLEar:ALL ......................................................................................................... 2-188

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

:TRACe:MATH:A ............................................................................................................. 2-190

:TRACe:MATH:B ............................................................................................................. 2-190

:TRACe:MATH:CONSt ..................................................................................................... 2-191

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

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

:TRACe:MATH:REFerence ............................................................................................... 2-192

:TRACe:MATH:STATe ...................................................................................................... 2-192

:TRACe:MATH:TYPE ....................................................................................................... 2-193

:TRACe:PRESet:ALL ....................................................................................................... 2-193

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

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

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

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

:TRIGger Commands ............................................................................................................ 2-196

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

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

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

RSA3000 Programming Guide IX

RIGOL Contents

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

:TRIGger2:MODE ........................................................................................................... 2-210

:UNIT Command ................................................................................................................... 2-211

:UNIT:POWer ................................................................................................................. 2-211

Chapter 3 Programming Examples .................................................................................... 3-1

Programming Instructions .......................................................................................................... 3-2

Programming Preparations ......................................................................................................... 3-2

Visual C++ 6.0 Programming Example ....................................................................................... 3-3

Visual Basic 6.0 Programming Example ..................................................................................... 3-11

LabVIEW 2010 Programming Example ...................................................................................... 3-15

Linux Programming Example .................................................................................................... 3-19

Programming Preparations ................................................................................................ 3-19

Linux Programming Procedures ......................................................................................... 3-22

Chapter 4 Appendix ............................................................................................................ 4-1

Appendix A: Default Settings ..................................................................................................... 4-1

Appendix B: Warranty................................................................................................................ 4-6

X RSA3000 Programming Guide

Chapter 1 Programming Overview RIGOL

Chapter 1 Programming Overview

Contents in this chapter:

 Build Remote Communication  Remote Control Method  SCPI Command Overview

RSA3000 Programming Guide 1-1

RIGOL Chapter 1 Programming Overview

Build Remote Communication

RSA3000 supports communication with PC via USB and LAN interface for remote control. This chapter introduces in details how to use Ultra Sigma to send commands through the USB interface to control the analyzer.

Operation Procedures:

1. Install Ultra Sigma (PC) software.

You can download Ultra Sigma from the official website of RIGOL (www.rigol.com) and install the software according to the installation wizard.

2. Connect the analyzer to the PC and configure the interface parameters for the instrument

RSA3000 supports three communication interfaces: USB and LAN.

USB DEVICE LAN

Figure 1-1 RSA3000 Communication Interface

(1) Remote communication via USB:

Use the USB cable to connect the USB DEVICE interface on the rear panel of RSA3000 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 RSA3000 to the local area network by using a network cable.  Press System  Interface  LAN to configure the IP address, subnet ma sk, default

gateway, and DNS for the instrument.

3. Check whether the connection is successful.

Run Ultra Sigma, and the n 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 RSA3000 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 R SA 3000 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

You can use the PC software to send commands to control RSA3000 remotely. RIGOL Ultra Sigma is recommended. You can download the software from RIGOL official website (www.rigol.com).

RSA3000 Programming Guide 1-3

RIGOL Chapter 1 Programming Overview

SCPI Command Overview

SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming language that is built upon the existing standard IEEE 488.1 and IEEE 488.2 and conforms to various standards, such as the floating point operation rule in IEEE 754 standard, ISO 646 7-bit coded character set for information interchange (equivalent to ASCII programming). This chapter introduces the syntax, symbols, parameters, and abbreviation rules of the SCPI commands.

Syntax

The SCPI commands provide a hierarchical tree structure, and consist of multiple subsystems. Each command subsystem 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 l ine to ind ic ate a qu ery; the command s an d parameters 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 available for setting. "?" represents query. 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:DA TE <year>,<month>,<day>.

Symbol Description

The following four symbols are not pa rt of the SCPI command, and they are not sent with the commands, but taken as delimiters to better describe the parameters in the command.

1. Braces { } The parameters enclosed in the braces are optional. You do not have to set it, also you can set for one or more times.

2. Vertical Bar | The vertical bar is used to separate multiple parameters. When using the command, you must select one of the parameters. For example, in the command :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 RSA3000 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 discontinuous.

6. ASCII String The parameter can be the combinations of ASCII characters.

Command Abb r eviation

All the commands are case-insensitive. They can all be written in upper case or in lower case. For abbreviations, you only need to input all the upper-case letters in the command. For example, :CALCulate:BANDwidth:NDB? can be abbreviated as :CALC:BAND:NDB? or :calc:band:ndb?

RSA3000 Programming Guide 1-5

Chapter 2 Command System RIGOL

Chapter 2 Command System

This chapter introduces the commands of the RSA3000 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 Com mands  :INITiate Commands  :INSTrument Commands  :MMEMory Commands  :OUTPut Commands  :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 RSA3000 model

2. The commands related to the tracking generator are only available for RSA3045-TG/RSA3030-TG.

3. For the command set, unless otherwise specified, the query command returns "N/A" (without

4. This manual takes RSA3045 as an example to illustrate the r ange of the parameters in each command.

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).

RSA3000 Programming Guide 2-1

RIGOL Chapter 2 Command System

: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 RSA3000 Programming Guide

Chapter 2 Command System 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]

RSA3000 Programming Guide 2-3

RIGOL Chapter 2 Command System

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 RSA3000 Programming Guide

Chapter 2 Command System RIGOL

Name

Type

Range

Default

——

Bool

OFF|ON|0|1

OFF|0

:CALCulate:BANDwidth|BWIDth:RLEFt?

Syntax

:CALCulate:BANDwidth|BWIDth:RLEFt?

Description Queries the frequency value of the frequency point th at is located at the left side of the current marker with N dB fall or rise in its peak amplitude.

Remarks

This command is invalid for the PvT measurement mode in RTSA.

Return Format The query returns the frequency value in scientific notation (with Hz as the unit). If the frequency point that is located at the left side of the current marker with N dB fall or rise in its peak amplitude is not found, the query returns -1.000000000e+02.

:CALCulate:BANDwidth|BWIDth:RRIGht?

Syntax

:CALCulate:BANDwidth|BWIDth:RRIGht?

Description Queries the frequency value of the frequency point that is located at the right side of the current marker with N dB fall or rise in its peak amplitude.

Remarks

This command is invalid for the PvT measurement mode in RTSA.

Return Format The query returns the frequency value in scientific notation (with Hz as the unit). If the frequency point that is located at the right side of the current marker with N dB fall or rise in its peak amplitude is not found, the query returns -1.000000000e+02.

:CALCulate:BANDwidth|BWIDth [:STATe]

Syntax

Description

Enables or disables the N dB bandwidth measurement function. Queries the status of the N dB bandwidth measurement function.

Parameter

Remarks

This command is invalid for the PvT measurement mode in RTSA.

RSA3000 Programming Guide 2-5

RIGOL Chapter 2 Command System

Name

Type

Range

Default

——

Bool

OFF|ON|0|1

ON|1

Return Format

The query returns 0 or 1.

Example

The following command enables the N dB BW measurement function. :CALCulate:BANDwidth:STATe ON or :CALCulate:BANDwidth:STATe 1 :CALCulate:BWIDth:STATe ON or :CALCulate:BWIDth:STATe 1

The following query returns 1. :CALCulate:BANDwidth:STATe? :CALCulate:BWIDth:STATe?

:CALCulate:LLINe:ALL:DELete

Syntax

:CALCulate:LLINe:ALL:DELete

Description

Deletes all the limit line data.

:CALCulate:LLINe:TEST

Syntax

:CALCulate:LLINe:TEST OFF|ON|0|1 :CALCulate:LLINe:TEST?

Description

Enables or disables the limit line test function. Queries the status of the limit line test function.

Parameter

Return Format

The query returns 0 or 1. Example

The following command disables the limit line test func ti on. :CALCulate:LLINe:TEST OFF or :CALCulate:LLINe:TEST 0

The following query returns 0。 :CALCulate:LLINe:TEST?

2-6 RSA3000 Programming Guide

Chapter 2 Command System RIGOL

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

——

Bool

OFF|ON|0|1

OFF|0

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

——

Keyword

——

:CALCulate:LLINe<n>:AMPLitude:CMODe:RELative

Syntax

:CALCulate:LLINe<n>:AMPLitude:CMODe:RELative OFF|ON|0|1 :CALCulate:LLINe<n>:AMPLitude:CMODe:RELative?

Description

Enables or disables the coupling functions between the selected limit line data points and the reference level. Queries the status of the coupling functions between the selected limit line data points and the reference level.

Parameter

——

Remarks

OFF|0: disables the coupling function. That is, "Fixed" is selected under Y to Ref, and the amplitude of the current limit line editing point is not affected by the reference level. ON|1: enables the coupling function. That is, "Relative" is selected under Y to Ref, and the amplitude of the current limit line editing point is the difference between the current point with the current reference level. At this tim e, if th e r efer enc e level changes, the positio n of th e curr ent editi ng poi nt will move up and down with it.

Return Format The query returns 0 or 1.

Example The following command disables the coupling functions between the selected limit line data points and the reference level. :CALCulate:LLINe2:AMPLitude:CMODe:RELative OFF or :CALCulate:LLINe2:AMPLitude:CMODe:RELative 0

The following query returns 0. :CALCulate:LLINe2:AMPLitude:CMODe:RELative?

:CALCulate:LLINe<n>:BUILd

Syntax

Description

Builds the limit line from the selected trace.

Parameter

Example

The following command builds Limit Line 2 from Trace2. :CALCulate:LLINe2:BUILd TRACE2

RSA3000 Programming Guide 2-7

RIGOL Chapter 2 Command System

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

——

Keyword

——

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

<x>

Consecutive Real Number

0 Hz to 4.5 GHz

——

<ampl>

Consecutive Real Number

-1,000 dBm to 1,000 dBm

——

Discrete

0|1

:CALCulate:LLINe<n>:COPY

Syntax

Description

Copies the selected limit line to the current limit line.

Parameter

Remarks

If the limit line to be copied that you select is the same as the current limit line, no operation should be performed.

Example

The following command copies Limit Line 1 to Lim it Line 2. :CALCulate:LLINe2:COPY LLINE1

:CALCulate:LLINe<n>:DATA

Syntax

:CALCulate:LL INe<n>:DATA <x>,<ampl>,<connect>{,<x>,<ampl>,<connect>} :CALCulate:LLINe<n>:DATA?

Description

Edits one limit line, and marks it with n. Queries the limit line data that you are editing currentl y.

Parameter

Remarks

<x>: indicates frequency. <apml>: indicates the amplitude. By default, its unit is dBm . The same X value can be configured with at most two amplitude values. <connect>: can be configured with 0 or 1. When it is configured with 1, it indicates that the current point connects with the previous point to determine the limit line; when configured with 0, it indicates that the current point is disconnected from the previous point. The <connect> value of the first po int can be configured with 0.

Return Format Queries the returned limit line data that you are editing currently.

Example

The following command edits a limit line that contains three points, and marks it Limit Line 2. :CALCulate:LLINe 2: DATA 50,100,0,100,150,1, 20 0, 20 0,1

2-8 RSA3000 Programming Guide

Chapter 2 Command System RIGOL

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

——

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

——

Bool

OFF|ON|0|1

OFF|0

The following query returns 50,100,0,100,150,1,200,200,1. :CALCulate:LLINe2:DATA?

:CALCulate:LLINe<n>:DELete

Syntax

:CALCulate:LLINe<n>:DELete

Description

Deletes the selected limit line.

Parameter

Example

The following command deletes Limit Line 2. :CALCulate:LLINe2:DELete

:CALCulate:LLINe<n>:DISPlay

Syntax

:CALCulate:LLINe<n>:DISPlay OFF|ON|0|1 :CALCulate:LLINe<n>:DISPlay?

Description

Turns on or off the selected limit line. Queries the status of the selected limit line.

Parameter

Return Format

The query returns 0 or 1. Example

The following command turns on Limit Line 2. :CALCulate:LLINe2:DISPlay ON or :CALCulate:LLINe2:DISPlay 1

The following query returns 1. :CALCulate:LLINe2:DISPlay?

RSA3000 Programming Guide 2-9

RIGOL Chapter 2 Command System

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

——

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

——

Bool

OFF|ON|0|1

OFF|0

:CALCulate:LLINe<n>:FAIL?

Syntax

:CALCulate:LLINe<n>:FAIL? Description

Queries the measurement results of the selected limit line and its associated trace.

Parameter

Remarks

If you enable the test for the displayed trace and its corresponding limit line, and each displayed trace has its corresponding limit line enabled, then you can run the command to query whether the trace test passes.

Return Format The query returns 0 (pass) or 1 (fail).

:CALCulate:LLINe<n>:FREQuency:CMODe:RELative

Syntax

:CALCulate:LLINe<n>:FREQuency:CMODe:RELative OFF|ON|0|1 :CALCulate:LLINe<n>:FREQuency:CMODe:RELative?

Description

Enables or disables the coupling functions between the selected limit line data points and the center frequency. Queries the status of the coupling functions between the selected limit line data points and the center frequency.

Parameter

Remarks

OFF|0: disables the coupling function. That is, "Fixed" is selected under X to CF, and the frequency of the current limit line editing point is not affected by the center frequency. ON|1: enables the coupling function. That is, "Relative" is selected under X to CF, and the amplitude of the current limit line editing point is the difference between th e current point with th e current center f requency. At this time, if the center frequency changes, the position of the current editing point will move left and right with it.

Return Format The query returns 0 or 1.

Example The following command disables the coupling functions between data points of Limit Line 2 and the center frequency. :CALCulate:LLINe2:FREQuency:CMODe:RELative OFF or :CALCulate:LLINe2:FREQuency:CMO D e:RELative 0

The following query returns 0. :CALCulate:LLINe2:FREQuency:CMODe:RELative?

2-10 RSA3000 Programming Guide

Chapter 2 Command System RIGOL

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

——

<rel_ampl>

Consecutive Real Number

-40 dB to 0 dB

0 dB

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

——

Bool

OFF|ON|0|1

OFF|0

:CALCulate:LLINe<n>:MARGin

Syntax

:CALCulate:LL INe<n>:MARGin <r el _am p l> :CALCulate:LLINe<n>:MARGin?

Description

Sets the margin for the selected limit line. Queries the margin for the selected limit line.

Parameter

Return Format

The query returns the margin for the limit line in scientific notation.

Example

The following command sets the margin for Limit Line 2 to 1 dB. :CALCulate:LLINe2:MARGin 1 dB

The following query returns 1.000000e+00. :CALCulate:LLINe2:MARGin?

:CALCulate:LLINe<n>:MARGin:STATe

Syntax

:CALCulate:LLINe<n>:MARGin:STATe OFF|ON|0|1 :CALCulate:LLINe<n>:MARGin:STATe?

Description

Enables or disables the margin for the selected limit line. Queries the status of the margin for the selected limit line.

Parameter

Return Format

The query returns 0 or 1.

Example

The following command turns on the margin for Limit Line 2. :CALCulate:LLINe2:MARGin:STATe ON or :CALCulate:LLINe2:MARGin:S TATe 1

The following query returns 1. :CALCulate:LLINe2:MARGin:STATe?

RSA3000 Programming Guide 2-11

RIGOL Chapter 2 Command System

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

——

Discrete

1|2|3|4|5|6

Refer to "Remarks"

Name

Type

Range

Default

<n>

Discrete

1|2|3|4|5|6

——

Keyword

UPPer|LOWer

Refer to "Remarks"

:CALCulate:LLINe<n>:TRACe

Syntax

:CALCulate:LLINe<n>:TRACe 1|2|3|4|5|6 :CALCulate:LLINe<n>:TRACe?

Description

Sets the trace to be tested against the current limit line. Queries the trace to be tested against the current limit line.

Parameter

Remarks

Limit Line 1 and 2: The default is Trace 1. Limit Line 3 and 4: The default is Trace 2. Limit Line 5 and 6: The default is Trace 3.

Return Format The query returns 1, 2, 3, 4, 5, or 6.

Example

The following command sets that Trace 2 is tested against Limit Line 3. :CALCulate:LLINe 3: TR AC e 2

The following query returns 2. :CALCulate:LLINe3:TRACe?

:CALCulate:LLINe<n>:TYPE

Syntax

:CALCulate:LLINe<n>:TYPE UPPer|LOWer :CALCulate:LLINe<n>:TYPE?

Description

Sets the type of the specified limit line. Queries the type of the specified limit line.

Parameter

Remarks

Limit Line 1, Limit Line 3, and Limit Line 5 belong to the upper type; Limit Line 2, Limit Line 4, and Limit Line 6 belong to the lower type.

Return Format The query returns UPP or LOW.

Example

The following command sets Limit Line 2 to the upper type.

2-12 RSA3000 Programming Guide

+ 234 hidden pages

Rigol RSA3045, RSA3030, RSA3045-TG, RSA3030-TG Programming Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

Guaranty and Declaration

Document Overview

Chapter 1 Programming Overview

Build Remote Communication

Remote Control Method

SCPI Command Overview

Syntax

Symbol Description

Parameter Type

Command Abb r eviation

Chapter 2 Command System

:CALCulate Commands

: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