User manual

ManualsBrandsRIGOL ManualsLaboratory Test EquipmentRSA3030-TGSpectrum Analyser, Frequency Fange ,

RIGOL

Programming Guide

RSA3000 Series Real-time

Spectrum Analyzer

Jan. 29, 2018

RIGOL TECHNOLOGIES, INC.

Summary of content (264 pages)

PAGE 1
RIGOL Programming Guide RSA3000 Series Real-time Spectrum Analyzer Jan. 29, 2018 RIGOL TECHNOLOGIES, INC.
PAGE 2
PAGE 3
RIGOL Guaranty and Declaration Copyright © 2017 RIGOL TECHNOLOGIES, INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL TECHNOLOGIES, 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.
PAGE 4
RIGOL 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.
PAGE 5
Contents RIGOL Contents Guaranty and Declaration ......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 Programming Overview......................................................................................1-1 Build Remote Communication .......................................................................
PAGE 6
RIGOL Contents :CALCulate:MARKer:FUNCtion:BAND:RIGHt ................................................................. 2-23 :CALCulate:MARKer:FUNCtion:BAND:SPAN .................................................................. 2-24 :CALCulate:MARKer:FUNCtion:BAND:SPAN:AUTO ........................................................ 2-24 :CALCulate:MARKer:LINes[:STATe].............................................................................. 2-25 :CALCulate:MARKer:MAXimum:LEFT ............
PAGE 7
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 .............
PAGE 8
RIGOL Contents *ESE................................................................................................................................ 2-82 *ESR? .............................................................................................................................. 2-83 *IDN? .............................................................................................................................. 2-83 *OPC ............................................................................
PAGE 9
Contents RIGOL :READ:TOIntercept? ....................................................................................................... 2-107 :READ:TOIntercept:IP3? ................................................................................................. 2-108 :READ:TPOWer? ............................................................................................................ 2-108 [:SENSe] Commands.............................................................................................
PAGE 10
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 ...........
PAGE 11
Contents RIGOL :SOURce:TRACe:STORref ............................................................................................... 2-169 :STATus Commands .............................................................................................................. 2-170 :STATus:OPERation:CONDition?....................................................................................... 2-171 :STATus:OPERation:ENABle ..........................................................................................
PAGE 12
RIGOL Contents :TRIGger[:SEQuence]:EXTernal:DELay:STATe ............................................................ 2-198 :TRIGger[:SEQuence]:EXTernal:SLOPe ...................................................................... 2-199 :TRIGger[:SEQuence]:FMT:APTRigger ............................................................................. 2-199 :TRIGger[:SEQuence]:FMT:CRITeria ................................................................................ 2-200 :TRIGger[:SEQuence]:FMT:DELay .
PAGE 13
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.
PAGE 14
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.
PAGE 15
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 RSA3000 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.
PAGE 16
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).
PAGE 17
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.
PAGE 18
PAGE 19
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.
PAGE 20
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:AMPLitude:CMODe:RELative  :CALCulate:LLINe:BUILd  :CALCulate:LLINe:COPY  :CALCulate:LLINe:DATA  :CALCulate:LLINe:DELete  :CALCulate:LLINe:DI
PAGE 21
Chapter 2 Command System  :CALCulate:MARKer:FCOunt:X?  :CALCulate:MARKer:FUNCtion  :CALCulate:MARKer:FUNCtion:BAND:LEFT  :CALCulate:MARKer:FUNCtion:BAND:RIGHt  :CALCulate:MARKer:FUNCtion:BAND:SPAN  :CALCulate:MARKer:FUNCtion:BAND:SPAN:AUTO  :CALCulate:MARKer:LINes[:STATe]  :CALCulate:MARKer:MAXimum:LEFT  :CALCulate:MARKer:MAXimum[:MAX]  :CALCulate:MARKer:MAXimum:NEXT  :CALCulate:MARKer:MAXimum:RIGHt  :CALCulate:MARKer:MINimum  :CALCu
PAGE 22
RIGOL Chapter 2 Command System :CALCulate:BANDwidth|BWIDth:NDB Syntax :CALCulate:BANDwidth|BWIDth:NDB :CALCulate:BANDwidth|BWIDth:NDB? Description Sets the N value in N dB BW measurement. Queries the N value in N dB BW measurement. Parameter Name Type Consecutive Real Number Range -140 dB to -0.01 dB Default -3.01 dB Remarks This command is invalid for the PvT measurement mode in RTSA. Return Format The query returns the N value in scientific notation.
PAGE 23
RIGOL Chapter 2 Command System :CALCulate:BANDwidth|BWIDth:RLEFt? Syntax :CALCulate:BANDwidth|BWIDth:RLEFt? Description Queries the frequency value of the frequency point that 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).
PAGE 24
RIGOL Chapter 2 Command System 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.
PAGE 25
RIGOL Chapter 2 Command System :CALCulate:LLINe:AMPLitude:CMODe:RELative Syntax :CALCulate:LLINe:AMPLitude:CMODe:RELative OFF|ON|0|1 :CALCulate:LLINe: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.
PAGE 26
RIGOL Chapter 2 Command System :CALCulate:LLINe:COPY Syntax :CALCulate:LLINe:COPY LLINE1|LLINE2|LLINE3|LLINE4|LLINE5|LLINE6 Description Copies the selected limit line to the current limit line. Parameter Name Type Discrete —— Keyword Range 1|2|3|4|5|6 LLINE1|LLINE2|LLINE3|LLINE4|LLINE5|LLINE6 Default —— —— Remarks If the limit line to be copied that you select is the same as the current limit line, no operation should be performed.
PAGE 27
RIGOL Chapter 2 Command System The following query returns 50,100,0,100,150,1,200,200,1. :CALCulate:LLINe2:DATA? :CALCulate:LLINe:DELete Syntax :CALCulate:LLINe:DELete Description Deletes the selected limit line. Parameter Name Type Discrete Range 1|2|3|4|5|6 Default —— Example The following command deletes Limit Line 2.
PAGE 28
RIGOL Chapter 2 Command System :CALCulate:LLINe:FAIL? Syntax :CALCulate:LLINe:FAIL? Description Queries the measurement results of the selected limit line and its associated trace. Parameter Name Type Discrete Range 1|2|3|4|5|6 Default —— 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.
PAGE 29
RIGOL Chapter 2 Command System :CALCulate:LLINe:MARGin Syntax :CALCulate:LLINe:MARGin :CALCulate:LLINe:MARGin? Description Sets the margin for the selected limit line. Queries the margin for the selected limit line. Parameter Name Type Discrete Consecutive Real Number Range 1|2|3|4|5|6 -40 dB to 0 dB Default —— 0 dB Return Format The query returns the margin for the limit line in scientific notation.
PAGE 30
RIGOL Chapter 2 Command System :CALCulate:LLINe:TRACe Syntax :CALCulate:LLINe:TRACe 1|2|3|4|5|6 :CALCulate:LLINe: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 Name —— Type Discrete Discrete Range 1|2|3|4|5|6 1|2|3|4|5|6 Default —— Refer to "Remarks" Remarks Limit Line 1 and 2: The default is Trace 1. Limit Line 3 and 4: The default is Trace 2.
PAGE 31
RIGOL Chapter 2 Command System :CALCulate:LLINe2:TYPE UPPer The following query returns UPP. :CALCulate:LLINe2:TYPE? :CALCulate:MARKer:AOFF Syntax :CALCulate:MARKer:AOFF Description Turns off all the enabled markers. :CALCulate:MARKer:COUPle[:STATe] Syntax :CALCulate:MARKer:COUPle[:STATe] OFF|ON|0|1 :CALCulate:MARKer:COUPle[:STATe]? Description Enables or disables the couple marker function. Queries the state of the couple marker function.
PAGE 32
RIGOL Parameter Name Chapter 2 Command System Type Consecutive Real Number Range 0 dB to 100 dB Default 6 dB Return Format The query returns the peak offset in scientific notation. Example The following command sets the peak offset to 12 dB. :CALCulate:MARKer:PEAK:EXCursion 12 The following query returns 1.200000e+01.
PAGE 33
RIGOL Chapter 2 Command System Remarks  PARameter: indicates parameter. If "parameter" is selected under search mode, the system will search for the peak of the specified parameter on the trace.  MAXimum: indicates maximum. If "maximum" is selected under search mode, the system will search for the maximum value on the trace. The command is only valid for the peak search executed by sending the :CALCulate:MARKer:MAXimum[:MAX] command.
PAGE 34
RIGOL Chapter 2 Command System :CALCulate:MARKer:PEAK:TABLe:READout :TRACe:MATH:PEAK:THReshold Syntax :CALCulate:MARKer:PEAK:TABLe:READout ALL|GTDLine|LTDLine :CALCulate:MARKer:PEAK:TABLe:READout? :TRACe:MATH:PEAK:THReshold NORMal|DLMore|DLLess :TRACe:MATH:PEAK:THReshold? Description Sets the peak criteria that the displayed peak must meet. Queries the peak criteria that the displayed peak must meet.
PAGE 35
RIGOL Chapter 2 Command System Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Return Format The query returns 0 or 1. Example The following command enables the peak table. :CALCulate:MARKer:PEAK:TABLe:STATe ON or :CALCulate:MARKer:PEAK:TABLe:STATe 1 :TRACe:MATH:PEAK:TABLe:STATe ON or :TRACe:MATH:PEAK:TABLe:STATe 1 The following query returns 1.
PAGE 36
RIGOL Parameter Name —— Chapter 2 Command System Type Bool Range OFF|ON|0|1 Default ON|1 Return Format The query returns 0 or 1. Example The following command enables the peak threshold function. :CALCulate:MARKer:PEAK:THReshold:STATe ON or :CALCulate:MARKer:PEAK:THReshold:STATe 1 The following query returns 1.
PAGE 37
RIGOL Chapter 2 Command System Remarks When the signal track is enabled, the instrument will execute a peak search after each sweep, and set the frequency value at the current peak to the center frequency to keep the signal always displayed at the center of the screen. This command is only available for GPSA mode. Return Format The query returns 0 or 1. Example The following command enables the signal track.
PAGE 38
RIGOL Chapter 2 Command System :CALCulate:MARKer:FCOunt:GATetime Syntax :CALCulate:MARKer:FCOunt:GATetime :CALCulate:MARKer:FCOunt:GATetime? Description Sets the gate time for Marker n. The unit is s. Queries the gate time for Marker n. Parameter Name Type Discrete Consecutive Real Number Range 1|2|3|4|5|6|7|8 1 μs to 500 ms Default —— 100 ms Remarks This command is only available for GPSA mode.
PAGE 39
RIGOL Chapter 2 Command System :CALCulate:MARKer:FCOunt[:STATe] Syntax :CALCulate:MARKer:FCOunt[:STATe] OFF|ON|0|1 :CALCulate:MARKer:FCOunt[:STATe]? Description Enables or disables the frequency counter function of the specified marker. Queries the status of the frequency counter function of the specified marker. Parameter Name Type Discrete —— Bool Range 1|2|3|4|5|6|7|8 OFF|ON|0|1 Default —— OFF|0 Remarks This command is only available for GPSA mode.
PAGE 40
RIGOL Chapter 2 Command System :CALCulate:MARKer:FUNCtion Syntax :CALCulate:MARKer:FUNCtion NOISe|BPOWer|BDENsity|OFF :CALCulate:MARKer:FUNCtion? Description Selects the special measurement type for the specified marker. Queries the special measurement type of the specified marker. Parameter Name —— Type Discrete Keyword Range 1|2|3|4|5|6|7|8 NOISe|BPOWer|BDENsity|OFF Default —— OFF Remarks NOISe: indicates the noise measurement. BPOWer: indicates the bandwidth power.
PAGE 41
RIGOL Chapter 2 Command System Example The following command sets the left edge frequency of the signal involved in the calculation for the Marker 1 band function to 2 MHz. :CALCulate:MARKer1:FUNCtion:BAND:LEFT 2000000 The following query returns 2.000000000e+06.
PAGE 42
RIGOL Chapter 2 Command System :CALCulate:MARKer:FUNCtion:BAND:SPAN Syntax :CALCulate:MARKer:FUNCtion:BAND:SPAN :CALCulate:MARKer:FUNCtion:BAND:SPAN? Description Sets the bandwidth or the time span of the signal involved in the calculation for the band function. Queries the bandwidth or the time span of the signal involved in the calculation for the band function.
PAGE 43
RIGOL Chapter 2 Command System Return Format The query returns 1 or 0. Example The following command enables the band span auto function of Marker 1. :CALCulate:MARKer1:FUNCtion:BAND:SPAN:AUTO ON or :CALCulate:MARKer1:FUNCtion:BAND:SPAN:AUTO 1 The following query returns 1.
PAGE 44
RIGOL Parameter Name Chapter 2 Command System Type Discrete Range 1|2|3|4|5|6|7|8 Default —— Remarks When no peak is found, a prompt message "No peak found" is displayed on the screen. Example The following command performs one left peak search, and marks with Marker 2.
PAGE 45
RIGOL Chapter 2 Command System :CALCulate:MARKer:MAXimum:RIGHt Syntax :CALCulate:MARKer:MAXimum:RIGHt Description Searches for and marks the nearest peak which is located at the right side of the current peak and meets the peak search condition. Parameter Name Type Discrete Range 1|2|3|4|5|6|7|8 Default —— Remarks When no peak is found, a prompt message "No peak found" is displayed on the screen. Example The following command performs one right peak search, and marks with Marker 2.
PAGE 46
RIGOL Chapter 2 Command System :CALCulate:MARKer:MODE Syntax :CALCulate:MARKer:MODE POSition|DELTa|FIXed|OFF :CALCulate:MARKer:MODE? Description Sets the type of the specified marker. Queries the type of the specified marker. Parameter Name Type Discrete —— Keyword Range 1|2|3|4|5|6|7|8 POSition|DELTa|FIXed|OFF Default —— OFF Remarks POSition: indicates the normal marker. DELTa: indicates difference between two data points. FIXed: indicates that the marker is fixed.
PAGE 47
RIGOL Chapter 2 Command System :CALCulate:MARKer:REFerence Syntax :CALCulate:MARKer:REFerence :CALCulate:MARKer:REFerence? Description Sets the reference marker for the specified marker. Queries the reference marker for the specified marker. Parameter Name Type Discrete Range 1|2|3|4|5|6|7|8 Integer 1 to 8 Default —— By default, the marker following the specified marker is considered to be the reference marker.
PAGE 48
RIGOL Chapter 2 Command System :CALCulate:MARKer[:SET]:DELTa:CENTer Syntax :CALCulate:MARKer[:SET]:DELTa:CENTer Description Sets the frequency difference of the specified Delta marker to the center frequency of the analyzer. Parameter Name Type Discrete Range 1|2|3|4|5|6|7|8 Default —— Remarks It is only valid when the current marker mode is "Delta". This function is invalid in zero span. This command is invalid for the PvT measurement mode in RTSA.
PAGE 49
RIGOL Chapter 2 Command System :CALCulate:MARKer[:SET]:RLEVel Syntax :CALCulate:MARKer[:SET]:RLEVel Description Sets the amplitude of the specified marker to the reference level of the analyzer. Parameter Name Type Discrete Range 1|2|3|4|5|6|7|8 Default —— Remarks If the marker mode of the specified marker is Position or Fixed, the reference level will be set to the amplitude of the marker.
PAGE 50
RIGOL Chapter 2 Command System :CALCulate:MARKer[:SET]:STEP Syntax :CALCulate:MARKer[:SET]:STEP Description Sets the frequency of the specified marker to the center frequency step of the analyzer. Parameter Name Type Discrete Range 1|2|3|4|5|6|7|8 Default —— Remarks If the marker mode of the specified marker is Position or Fixed, the center frequency step will be set to the frequency of the marker.
PAGE 51
RIGOL Chapter 2 Command System :CALCulate:MARKer:STATe Syntax :CALCulate:MARKer:STATe OFF|ON|0|1 :CALCulate:MARKer:STATe? Description Enables or disables the specified marker. Queries the status for the specified marker. Parameter Name —— Type Discrete Bool Range 1|2|3|4|5|6|7|8 OFF|ON|0|1 Default —— OFF|0 Remarks If the specified marker is disabled currently, by default, the marker mode is "Position" when you send the command to enable the marker.
PAGE 52
RIGOL Chapter 2 Command System Return Format The query returns any integer from 1 to 6. If the marker trace is set to "Auto", the query command returns a trace number on which the marker is placed. Example The following command sets the marker trace of Marker 1 to Trace 2. :CALCulate:MARKer1:TRACe 2 The following query returns 2.
PAGE 53
RIGOL Chapter 2 Command System :CALCulate:MARKer:X Syntax :CALCulate:MARKer:X :CALCulate:MARKer:X? Description Sets the X-axis value of the specified marker. Its default unit is Hz. Queries the X-axis value of the specified marker.
PAGE 54
RIGOL Chapter 2 Command System Remarks FREQuency: indicates frequency. It is the default readout mode in non-zero span mode. TIME: indicates time. It is the default readout mode in zero span mode. ITIMe: indicates the reciprocal of time. It is available only in zero span mode and a Delta marker is selected. PERiod: indicates period. It is not available in zero span mode. The PvT does not support this command. Return Format The query returns FREQ, TIME, ITIM, or PER.
PAGE 55
RIGOL Chapter 2 Command System :CALCulate:MARKer:Y Syntax :CALCulate:MARKer:Y :CALCulate:MARKer:Y? Description Sets the Y-axis value of the specified fixed marker. Queries the Y-axis value of the specified marker, and its default unit is dBm. Parameter Name Type Discrete Consecutive Real Number Range 1|2|3|4|5|6|7|8 -170 dBm to 30 dBm Default —— —— Remarks This setting command is only available when there is only one marker and it is a fixed marker.
PAGE 56
RIGOL Chapter 2 Command System Example The following command sets the trace number of the trace where the marker1 stays in to 100. :CALCulate:MARKer1:Z:POSition 100 The following query returns 100.
PAGE 57
RIGOL Chapter 2 Command System :CALCulate:MATH TRACE1,PDIFference,TRACE4,TRACE5,, The following query returns PDIFference. :CALCulate:MATH? TRACE1 :CALCulate:NTData[:STATe] Syntax :CALCulate:NTData[:STATe] OFF|ON|0|1 :CALCulate:NTData[:STATe]? Description Enables or disables the normalize function. Queries the status of normalization. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for RSA3045-TG/RSA3030-TG working in GPSA mode.
PAGE 58
RIGOL Chapter 2 Command System :CALibration Commands Command List:  :CALibration:[ALL]  :CALibration:AUTO :CALibration:[ALL] Syntax :CALibration:[ALL] Description Executes self-calibration immediately. Remarks If the self-calibration succeeded, the command :CALibration:[ALL]? returns 0; if failed, the command :CALibration:[ALL]? returns 1. Example The following command executes the self-calibration immediately.
PAGE 59
Chapter 2 Command System RIGOL :CONFigure Commands Command List:  :CONFigure?  :CONFigure:ACPower*  :CONFigure:CNRatio*  :CONFigure:DENSity  :CONFigure:DSPEctrogram  :CONFigure:EBWidth*  :CONFigure:HDISt*  :CONFigure:LPSTep  :CONFigure:MCHPower*  :CONFigure:NORMal  :CONFigure:OBWidth*  :CONFigure:PSGRam  :CONFigure:PSPectrum  :CONFigure:PVT  :CONFigure:SANalyzer  :CONFigure:SPECtrogram  :CONFigure:TOI*  :CONFigure:TPOWer* Remarks: The commands with * are
PAGE 60
RIGOL Chapter 2 Command System :CONFigure:ACPower Syntax :CONFigure:ACPower Description Sets the analyzer to be in the ACP measurement state. Remarks This command is only available for GPSA mode. Running this command will discontinue the current measurement and restore the specified measurement of the instrument to the default factory state. After changing any measurement setup, running the :READ Commands will initialize the measurement, and you do not have to set the measurement to the default.
PAGE 61
Chapter 2 Command System RIGOL :CONFigure:DSPEctrogram Syntax :CONFigure:DSPEctrogram Description Sets the analyzer to be in the Density Spectrogram measurement state. Remarks This command is only available for RTSA mode. Running this command will discontinue the current measurement and restore the specified measurement of the instrument to the default factory state. :CONFigure:EBWidth Syntax :CONFigure:EBWidth Description Sets the analyzer to be in the EBW measurement state.
PAGE 62
RIGOL Chapter 2 Command System :CONFigure:MCHPower Syntax :CONFigure:MCHPower Description Sets the analyzer to be in the MCHP measurement state. Remarks This command is only available for GPSA mode. Running this command will discontinue the current measurement and restore the specified measurement of the instrument to the default factory state. After changing any measurement setup, running the :READ Commands will initialize the measurement, and you do not have to set the measurement to the default.
PAGE 63
Chapter 2 Command System RIGOL :CONFigure:PSGRam Syntax :CONFigure:PSGRam Description Sets the analyzer to be in the PvT Spectrogram measurement state. Remarks This command is only available for RTSA mode. Running this command will discontinue the current measurement and restore the specified measurement of the instrument to the default factory state. :CONFigure:PSPectrum Syntax :CONFigure:PSPectrum Description Sets the analyzer to be in the PvT Spectrum measurement state.
PAGE 64
RIGOL Chapter 2 Command System :CONFigure:SPECtrogram Syntax :CONFigure:SPECtrogram Description Sets the analyzer to be in the Spectrogram measurement state. Remarks This command is only available for RTSA mode. Running this command will discontinue the current measurement and restore the specified measurement of the instrument to the default factory state. :CONFigure:TOI Syntax :CONFigure:TOI Description Sets the analyzer to be in the TOI measurement state.
PAGE 65
Chapter 2 Command System RIGOL :COUPle Commands Command List:  :COUPle :COUPle Syntax :COUPle ALL Description Sets all the manual/auto settings in the current measurement mode to "Auto".
PAGE 66
RIGOL Chapter 2 Command System :DISPlay Commands Command List:  :DISPlay:BACKlight  :DISPlay:ENABle  :DISPlay:GRATicule[:STATe]  :DISPlay:HDMI[:STATe]  :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle  :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:PDIVision  :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RLEVel  :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RPOSition  :DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:PDIVision  :DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:RLEVel  :DISPlay:VIEW:DENSity:AADJust
PAGE 67
RIGOL Chapter 2 Command System :DISPlay:BACKlight Syntax :DISPlay:BACKlight :DISPlay:BACKlight? Description Sets the brightness of the backlight of LCD. Queries the brightness of the backlight of LCD. Parameter Name Type Integer Range 1 to 100 Default 100 Return Format The query returns the brightness of the LCD backlight in integer. Example The following command sets the brightness of the LCD backlight to 50. :DISPlay:BACKlight 50 The following query returns 50.
PAGE 68
RIGOL Chapter 2 Command System :DISPlay:GRATicule[:STATe] Syntax :DISPlay:GRATicule[:STATe] OFF|ON|0|1 :DISPlay:GRATicule[:STATe]? Description Enables or disables the display of the graticule. Queries the display of the graticule. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Return Format The query returns 0 or 1. Example The following command enables display of the graticule. :DISPlay:GRATicule:STATe ON or :DISPlay:GRATicule:STATe 1 The following query returns 1.
PAGE 69
RIGOL Chapter 2 Command System :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle Syntax :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle OFF|ON|0|1 :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle? Description Enables or disables the auto scale function for the horizontal axis in the PvT view. Queries the status of the auto scale function for the horizontal axis in the PvT view.
PAGE 70
RIGOL Chapter 2 Command System The following query returns 4.000000000e-07. :DISPlay:PVTime:WINDow:TRACe:X:SCALe:PDIVision? :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RLEVel Syntax :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RLEVel :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RLEVel? Description Sets the reference time for the horizontal axis in the PvT view. Queries the reference time for the horizontal axis in the PvT view.
PAGE 71
RIGOL Chapter 2 Command System "Left". :DISPlay:PVTime:WINDow:TRACe:X:SCALe:RPOSition LEFT The following query returns LEFT. :DISPlay:PVTime:WINDow:TRACe:X:SCALe:RPOSition? :DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:PDIVision Syntax :DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:PDIVision :DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:PDIVision? Description Sets the unit per division in the vertical axis of the PvT view. Queries the unit per division in the vertical axis of the PvT view.
PAGE 72
RIGOL Chapter 2 Command System Return Format The query returns the reference level for the vertical axis in scientific notation. Example The following command sets the reference level for the vertical axis in the PvT view to 100 dBm. :DISPlay:PVTime:WINDow:TRACe:Y:SCALe:RLEVel 100 The following query returns 1.000000000e+02.
PAGE 73
RIGOL Chapter 2 Command System :DISPlay:VIEW:DENSity:CPALettes Syntax :DISPlay:VIEW:DENSity:CPALettes COOL|WARM|RADar|FIRE|FROSt :DISPlay:VIEW:DENSity:CPALettes? Description Sets the color palette of Density. Queries the color palette of Density. Parameter Name —— Type Keyword Range COOL|WARM|RADar|FIRE|FROSt Default WARM Remarks This command is only available for Density and Density Spectrogram in RTSA mode. Return Format The query returns COOL, WARM, RAD, FIRE, or FROS.
PAGE 74
RIGOL Chapter 2 Command System :DISPlay:VIEW:DENSity:LDHue Syntax :DISPlay:VIEW:DENSity:LDHue :DISPlay:VIEW:DENSity:LDHue? Description Sets the lowest density hue. Queries the lowest density hue. Parameter Name Type Consecutive Real Number Range 0 to 99.9 Default 0 Remarks This command is only available for Density and Density Spectrogram in RTSA mode. Return Format The query returns the lowest density hue in scientific notation.
PAGE 75
RIGOL Chapter 2 Command System :DISPlay:VIEW:DENSity:PERSistence:INFinite Syntax :DISPlay:VIEW:DENSity:PERSistence:INFinite OFF|ON|0|1 :DISPlay:VIEW:DENSity:PERSistence:INFinite? Description Enables or disables the infinite mode of the persistence time. Queries the status of the infinite mode of the persistence time. Parameter Name Type —— Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for Density and Density Spectrogram in RTSA mode. Return Format The query returns 0 or 1.
PAGE 76
RIGOL Chapter 2 Command System Example The following commands sets the current view to Spectrogram. :DISPlay:VIEW:SELect SPECtrogram The following query returns SPEC. :DISPlay:VIEW:SELect? :DISPlay:VIEW:SPECtrogram:AADJust Syntax :DISPlay:VIEW:SPECtrogram:AADJust Description Auto adjusts the reference hue position and bottom hue position based on the highest amplitude value and the lowest amplitude value found in the spectrogram, respectively.
PAGE 77
RIGOL Chapter 2 Command System :DISPlay:VIEW:SPECtrogram:HUE Syntax :DISPlay:VIEW:SPECtrogram:HUE :DISPlay:VIEW:SPECtrogram:HUE? Description Sets the reference hue. Queries the reference hue. Parameter Name Type Consecutive Real Number Range 0 to 359.9 Default 0 Remarks The reference hue indicates the hue value at the top of the color bar in the spectrogram. This command is only available for Spectrogram in RTSA mode or the view that contains the spectrogram.
PAGE 78
RIGOL Chapter 2 Command System The following query returns 146. :DISPlay:VIEW:SPECtrogram:POSition? :DISPlay:VIEW:SPECtrogram:REFerence Syntax :DISPlay:VIEW:SPECtrogram:REFerence :DISPlay:VIEW:SPECtrogram:REFerence? Description Sets the position of the reference hue displayed in the graticule. Queries the position of the reference hue displayed in the graticule.
PAGE 79
RIGOL Chapter 2 Command System Example The following command enables coupling the marker to the trace. :DISPlay:VIEW:SPECtrogram:TRACe:COUPle ON or :DISPlay:VIEW:SPECtrogram:TRACe:COUPle 1 The following query returns 1. :DISPlay:VIEW:SPECtrogram:TRACe:COUPle? :DISPlay:VIEW:SPECtrogram:TRACe:SELection Syntax :DISPlay:VIEW:SPECtrogram:TRACe:SELection TIME|TNUMber :DISPlay:VIEW:SPECtrogram:TRACe:SELection? Description Sets the selection method for the displayed trace.
PAGE 80
RIGOL Chapter 2 Command System :DISPlay:WINDow:SELect Syntax :DISPlay:WINDow:SELect SPECtrum|PVT :DISPlay:WINDow:SELect? Description Selects a window in the current view. Queries the currently selected window type. Parameter Name —— Type Keyword Range SPECtrum|PVT Default —— Remarks This command is only available for Density Spectrogram, PvT Spectrum, or PvT Spectrogram in RTSA mode. Return Format The query returns SPEC or PVT.
PAGE 81
RIGOL Chapter 2 Command System :DISPlay:WINDow:TRACe:Y:DLINe:STATe Syntax :DISPlay:WINDow:TRACe:Y:DLINe:STATe OFF|ON|0|1 :DISPlay:WINDow:TRACe:Y:DLINe:STATe? Description Turns on or off the display line. Queries the status of the display line. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Return Format The query returns 0 or 1. Example The following command enables the display line.
PAGE 82
RIGOL Chapter 2 Command System :DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition Syntax :DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition :DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition? Description Sets the reference position of normalization. Queries the reference position of normalization. Parameter Name Type Range Integer 0% to 100% Default 100% Remarks This command is only available for RSA3045-TG/RSA3030-TG working in GPSA mode.
PAGE 83
RIGOL Chapter 2 Command System :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel Syntax :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel? Description Sets the reference level. Queries the reference level. Parameter Name Type Consecutive Real Number Range -170 dBm to 30 dBm Default 0 dBm Return Format The query returns the reference level in scientific notation. Example The following command sets the reference level to -10 dB.
PAGE 84
RIGOL Chapter 2 Command System :DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing Syntax :DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing LINear|LOGarithmic :DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing? Description Sets the Y-axis scale type. Queries the Y-axis scale type. Parameter Name —— Type Keyword Range LINear|LOGarithmic Default LOGarithmic Remarks LINear: indicates linear. LOGarithmic: indicates log. Return Format The query returns LIN or LOG. Example The following command sets the Y-axis scale type to LOG.
PAGE 85
Chapter 2 Command System RIGOL :FETCh Commands Command List:  :FETCh:ACPower?  :FETCh:ACPower:LOWer?  :FETCh:ACPower:MAIN?  :FETCh:ACPower:UPPer?  :FETCh:CNRatio?  :FETCh:CNRatio:CARRier?  :FETCh:CNRatio:CNRatio?  :FETCh:CNRatio:NOISe?  :FETCh:EBWidth?  :FETCh:HARMonics:AMPLitude:ALL?  :FETCh:HARMonics:AMPLitude?  :FETCh:HARMonics[:DISTortion]?  :FETCh:HARMonics:FREQuency:ALL?  :FETCh:HARMonics:FREQuency?  :FETCh:HARMonics:FUNDamental?  :FETCh:OBWidth?
PAGE 86
RIGOL Chapter 2 Command System :FETCh:ACPower? Syntax :FETCh:ACPower? Description Queries the results of adjacent channel power measurement. Remarks This command is only valid when the adjacent channel power measurement in GPSA mode is enabled. The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer.
PAGE 87
Chapter 2 Command System RIGOL :FETCh:ACPower:MAIN? Syntax :FETCh:ACPower:MAIN? Description Queries the main channel power of the adjacent channel power measurement. Remarks This command is only valid when the adjacent channel power measurement in GPSA mode is enabled. The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer.
PAGE 88
RIGOL Chapter 2 Command System :FETCh:CNRatio? Syntax :FETCh:CNRatio? Description Queries the results of C/N ratio measurement. Remarks This command is only valid when the C/N ratio measurement in GPSA mode is enabled. The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer.
PAGE 89
Chapter 2 Command System RIGOL :FETCh:CNRatio:CNRatio? Syntax :FETCh:CNRatio:CNRatio? Description Queries the results of C/N ratio measurement. Remarks This command is only valid when the C/N ratio measurement in GPSA mode is enabled. This command will select data from the latest measurement results, and then transmit the data to the output buffer. Return Format The query returns the C/N ratio in scientific notation. Example The following query returns 8.956909000e-02.
PAGE 90
RIGOL Chapter 2 Command System :FETCh:EBWidth? Syntax :FETCh:EBWidth? Description Queries the result of the emission bandwidth measurement. Remarks This command is only valid when the emission bandwidth measurement in GPSA mode is enabled. This command will select data from the latest measurement results, and then transmit the data to the output buffer. Return Format The query returns the emission bandwidth in integer, and its unit is Hz. Example The following query returns 5.000000000e+04.
PAGE 91
RIGOL Chapter 2 Command System :FETCh:HARMonics:AMPLitude? Syntax :FETCh:HARMonics:AMPLitude? Description Queries the amplitude of the specified harmonic. Parameter Name Type Integer Range 1 to 10 Default —— Remarks This command is only valid when the harmonic distortion measurement in GPSA mode is enabled. The amplitude unit of the return value is consistent with the current Y-axis unit. The query returns --- when the harmonic read does not have data.
PAGE 92
RIGOL Chapter 2 Command System :FETCh:HARMonics:FREQuency:ALL? Syntax :FETCh:HARMonics:FREQuency:ALL? Description Queries the frequencies of the first 10 harmonics. The first harmonic is the fundamental waveform. Remarks This command is only valid when the harmonic distortion measurement in GPSA mode is enabled. This command will select data from the latest measurement results, and then transmit the data to the output buffer.
PAGE 93
Chapter 2 Command System RIGOL :FETCh:HARMonics:FUNDamental? Syntax :FETCh:HARMonics:FUNDamental? Description Queries the frequency of the fundamental waveform. Remarks This command is only valid when the harmonic distortion measurement in GPSA mode is enabled. This command has the same function as :FETCh:HARMonics:FREQuency? 1. This command will select data from the latest measurement results, and then transmit the data to the output buffer.
PAGE 94
RIGOL Chapter 2 Command System :FETCh:OBWidth:OBWidth? Syntax :FETCh:OBWidth:OBWidth? Description Queries the occupied bandwidth. Remarks This command is only valid when the occupied bandwidth measurement in GPSA mode is enabled. This command will select data from the latest measurement results, and then transmit the data to the output buffer. Return Format The query returns the occupied bandwidth in scientific notation. Its unit is Hz. Example The following query returns 1.860000000e+06.
PAGE 95
RIGOL Chapter 2 Command System :FETCh:SANalyzer? Syntax :FETCh:SANalyzer? Description Queries the measurement results or trace data in the cache area. Parameter Name Type Discrete Range 1|2|3|4|5|6 Default —— Remarks This command is only valid in GPSA mode. This command will select data from the latest measurement results, and then transmit the data to the output buffer. Return Format The query returns the measurement data of Trace n in scientific notation.
PAGE 96
RIGOL Chapter 2 Command System :FETCh:TOIntercept:IP3? Syntax :FETCh:TOIntercept:IP3? Description The query returns the minor value of the intercepts of the Third Order Lower and Third Order Upper. Remarks This command is only valid when the TOI measurement in GPSA mode is enabled. This command will select data from the latest measurement results, and then transmit the data to the output buffer. Return Format The query returns the minor one in scientific notation. Example The following query returns -8.
PAGE 97
RIGOL Chapter 2 Command System :FORMat Commands Command List:  :FORMat:BORDer  :FORMat[:TRACe][:DATA] :FORMat:BORDer Syntax :FORMat:BORDer NORMal|SWAPped :FORMat:BORDer? Description Selects the binary data byte order for data transmission. Queries the binary data byte order for data transmission.
PAGE 98
RIGOL Chapter 2 Command System :FORMat[:TRACe][:DATA] Syntax :FORMat[:TRACe][:DATA] ASCii|INTeger,32|REAL,32|REAL,64 :FORMat[:TRACe][:DATA]? Description Sets the input/output format of the trace data. Queries the input/output format of the trace data. Parameter Name —— Type Keyword Range ASCii|INTeger,32|REAL,32|REAL,64 Default ASCii Remarks ASCii: ASCII characters, separated by commas. INTeger,32: binary 32-bit integer values. REAL,32: binary 32-bit real values. REAL,64: binary 64-bit real values.
PAGE 99
Chapter 2 Command System RIGOL IEEE 488.2 Common Commands IEEE 488.2 common commands are used to operate or query the status registers. For the structure of the status register, refer to ":STATus Commands".
PAGE 100
RIGOL Chapter 2 Command System *CLS Syntax *CLS Description Clears all the event registers and status byte registers. *ESE Syntax *ESE *ESE? Description Sets the enable register for the standard event status register. Queries the enable register for the standard event status register. Parameter Name Type Integer Range Refer to "Remarks" Default 0 Remarks Bit 2, bit 3, bit 4, and bit 7 are reserved; you can set their values but they will not affect the system.
PAGE 101
Chapter 2 Command System RIGOL *ESR? Syntax *ESR? Description Queries and clears the event register for the standard event status register. Remarks Bit 1 and bit 6 in the standard event status register are not in use, and are regarded as 0. The query returns a decimal value that corresponds to the binary values ranging from 00000000 (0 in decimal) to 11111111 (255 in decimal) and of which bit 1 and bit 6 are 0. Return Format The query returns an integer.
PAGE 102
RIGOL Chapter 2 Command System *OPC Syntax *OPC *OPC? Description Sets bit 0 (Operation Complete, OPC) in the standard event status register to 1 after the current operation is finished. Queries whether the current operation is finished. Return Format The query returns 1 after the current operation is finished; otherwise, the query returns 0. *RCL Syntax *RCL Description Recalls the selected register.
PAGE 103
RIGOL Chapter 2 Command System *SAV Syntax *SAV Description Saves the current instrument state to the selected register. Parameter Name Type Integer Range 1 to 16 Default —— Example The following command saves the current instrument state to Register 1. *SAV 1 *SRE Syntax *SRE *SRE? Description Sets the enable register for the status byte register. Queries the enable register for the status byte register.
PAGE 104
RIGOL Chapter 2 Command System *STB? Syntax *STB? Description Queries the event register for the status byte register. Remarks Bit 0 and Bit 1 in the status byte register are not in use, and are regarded as 0. The query returns a decimal value that corresponds to the binary values ranging from 00000000 (0 in decimal) to 11111111 (255 in decimal) and of which Bit 0 and Bit 1 are 0. Return Format The query returns an integer. The integer equals to the binary-weighted sum of all the bits set in the register.
PAGE 105
RIGOL Chapter 2 Command System :INITiate Commands Command List:  :INITiate:CONTinuous  :INITiate[:IMMediate] Remarks: The commands with * are only available for the RSA3000 series that has been installed with advanced measurement kit option. :INITiate:CONTinuous Syntax :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Description Selects continuous (ON|1) or single (OFF|0) measurement mode. Queries the current measurement mode.
PAGE 106
RIGOL Chapter 2 Command System :INSTrument Commands Command List:  :INSTrument:COUPle:FREQuency:CENTer  :INSTrument:DEFault  :INSTrument:NSELect  :INSTrument[:SELect] :INSTrument:COUPle:FREQuency:CENTer Syntax :INSTrument:COUPle:FREQuency:CENTer ALL|NONE :INSTrument:COUPle:FREQuency:CENTer? Description Turns on or off the global center frequency of the instrument. Queries the setting status of the global center frequency of the instrument.
PAGE 107
RIGOL Chapter 2 Command System :INSTrument:NSELect :INSTrument[:SELect] Syntax :INSTrument:NSELect 1|2 :INSTrument:NSELect? :INSTrument[:SELect] SA|RTSA :INSTrument[:SELect]? Description Selects the working mode of the instrument. Queries the working mode of the instrument. Parameter Name —— —— Type Discrete Keyword Range 1|2 SA|RTSA Default 1 SA Remarks The above parameters 1|2 correspond to SA|RTSA, respectively.
PAGE 108
RIGOL Chapter 2 Command System :MMEMory Commands Command List:  :MMEMory:DELete  :MMEMory:LOAD:FMT  :MMEMory:LOAD:LIMit  :MMEMory:LOAD:STATe  :MMEMory:LOAD:TRACe  :MMEMory:LOAD:TRACe:DATA  :MMEMory:MOVE  :MMEMory:STORe:LIMit  :MMEMory:STORe:MTABle  :MMEMory:STORe:PTABle  :MMEMory:STORe:RESults  :MMEMory:STORe:SCReen  :MMEMory:STORe:STATe  :MMEMory:STORe:TRACe  :MMEMory:STORe:TRACe:DATA Remarks: The mode name in the following path contains "gpsa" and rtsa" modes.
PAGE 109
RIGOL Chapter 2 Command System :MMEMory:LOAD:FMT Syntax :MMEMory:LOAD:FMT , Description Loads the edited FMT file (.csv). Parameter Name Type Keyword ASCII String Range UPPer|LOWer —— Default —— —— Remarks This operation fails if the specified file does not exist. This command is only available for RTSA mode. Example The following command loads the FMT file (mask1.csv) to the upper mask. :MMEMory:LOAD:FMT upper,mask1.
PAGE 110
RIGOL Chapter 2 Command System :MMEMory:LOAD:STATe Syntax :MMEMory:LOAD:STATe Description Imports the specified state file (.sta). Parameter Name Type ASCII String Range —— Default —— Remarks This operation fails if the specified file does not exist. Example The following command imports the state file (state1.sta) to the instrument. :MMEMory:LOAD:STATe state1.sta :MMEMory:LOAD:TRACe Syntax :MMEMory:LOAD:TRACe , Description Imports the specified trace file (.
PAGE 111
RIGOL Chapter 2 Command System :MMEMory:LOAD:TRACe:DATA Syntax :MMEMory:LOAD:TRACe:DATA , Description Imports the specified measurement data file (.csv). Parameter Name Type Keyword ASCII String Range TRACE1|TRACE2|TRACE3|TRACE4|TRACE5|TRACE6 —— Default —— —— Remarks This operation fails if the specified file does not exist. Example The following command imports the measurement data file (trace1.csv) to Trace1. :MMEMory:LOAD:TRACe:DATA TRACE1,trace1.
PAGE 112
RIGOL Chapter 2 Command System :MMEMory:STORe:LIMit Syntax :MMEMory:STORe:LIMit , Description Saves the currently edited limit line with a specified filename suffixed with ".csv" by default (you do not have to add the suffix manually) to a default path (/"mode name"/limit). Parameter Name Type Keyword ASCII String Range LLINE1|LLINE2|LLINE3|LLINE4|LLINE5|LLINE6 —— Default —— —— Remarks If the specified file already exists, overwrite it.
PAGE 113
RIGOL Chapter 2 Command System :MMEMory:STORe:PTABle Syntax :MMEMory:STORe:PTABle Description Saves the peak table with a specified filename suffixed with ".csv" by default (you do not have to add the suffix manually) to the default path (/"mode name"/measdata). Parameter Name Type ASCII String Range —— Default —— Remarks If the specified file already exists, overwrite it.
PAGE 114
RIGOL Parameter Name Chapter 2 Command System Type ASCII String Range —— Default —— Remarks If the specified file already exists, overwrite it. If a suffix (.jpg/.png/.bmp) following the filename exists, you can save the current screen image with a different format based on its different suffix. If no suffix is followed with the filename, then by default, the current screen image is saved in the currently selected format.
PAGE 115
RIGOL Chapter 2 Command System Remarks If the specified file already exists, overwrite it. Example The following command saves the current instrument state and Trace 1 with the filename "mystate.trs" to the folder (/gpsa/tracestate). :MMEMory:STORe:TRACe TRACE1,mystate :MMEMory:STORe:TRACe:DATA Syntax :MMEMory:STORe:TRACe:DATA , Description Saves the trace measurement results with a specified filename suffixed with ".csv" to the default path (/"mode name"/measdata).
PAGE 116
RIGOL Chapter 2 Command System :OUTPut Commands Command List:  :OUTPut[:EXTernal][:STATe] :OUTPut[:EXTernal][:STATe] Syntax :OUTPut[:EXTernal][:STATe] OFF|ON|0|1 :OUTPut[:EXTernal][:STATe]? Description Enables or disables the output of the tracking generator. Queries the on/off status of the tracking generator. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for RSA3045-TG/RSA3030-TG working in GPSA mode. Return Format The query returns 0 or 1.
PAGE 117
Chapter 2 Command System RIGOL :READ Commands Both the :READ and :FETCh Commands are used to acquire the measurement results. The difference is that the :FETCh Commands acquire the measurement results immediately, whereas the :READ commands start a measurement and return the measurement results after the measurement operation is finished.
PAGE 118
RIGOL Chapter 2 Command System :READ:ACPower? Syntax :READ:ACPower? Description Executes one adjacent channel power measurement and returns the measurement results. Remarks The power unit of the returned value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode.
PAGE 119
Chapter 2 Command System RIGOL :READ:ACPower:UPPer? Syntax :READ:ACPower:UPPer? Description Executes one adjacent channel power measurement and returns the upper channel power. Remarks The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode. Return Format The query returns the upper channel power in scientific notation.
PAGE 120
RIGOL Chapter 2 Command System :READ:CNRatio:CNRatio? Syntax :READ:CNRatio:CNRatio? Description Executes one C/N ratio measurement and returns the C/N ratio. Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode. Return Format The query returns the C/N ratio in scientific notation. For example, 8.
PAGE 121
RIGOL Chapter 2 Command System :READ:HARMonics:AMPLitude:ALL? Syntax :READ:HARMonics:AMPLitude:ALL? Description Executes one harmonic distortion measurement and returns the amplitudes of the first 10 harmonics. Remarks If the number of harmonics under measurement is less than 10, the harmonics that are not measured do not have return values. The amplitude unit of the return value is consistent with the current Y-axis unit.
PAGE 122
RIGOL Chapter 2 Command System :READ:HARMonics[:DISTortion]? Syntax :READ:HARMonics[:DISTortion]? Description Executes one harmonic distortion measurement and returns the percentage of the total harmonic distortion. Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode. Return Format Queries the percentage of the total harmonic distortion in scientific notation. For example, 2.
PAGE 123
Chapter 2 Command System RIGOL This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode. Return Format The query returns the frequency of the specified harmonic in scientific notation. The unit is Hz. For example, 4.
PAGE 124
RIGOL Chapter 2 Command System :READ:OBWidth:OBWidth? Syntax :READ:OBWidth:OBWidth? Description Executes one occupied bandwidth measurement and returns the occupied bandwidth. Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode. Return Format The query returns the occupied bandwidth in scientific notation. Its unit is Hz. For example, 1.
PAGE 125
RIGOL Chapter 2 Command System :READ:SANalyzer? Syntax :READ:SANalyzer? Description Queries the measurement results or trace data in the buffer. Parameter Name Type Discrete Range 1|2|3|4|5|6 Default —— Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode. Return Format The query returns the measurement data of Trace n in scientific notation.
PAGE 126
RIGOL Chapter 2 Command System :READ:TOIntercept:IP3? Syntax :READ:TOIntercept:IP3? Description Executes one TOI measurement and returns the value of the intercept of the Third Order Lower or the Third Order Upper, whichever is smaller. Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode. Return Format The query returns the minor one in scientific notation. For example, -8.
PAGE 127
Chapter 2 Command System RIGOL [:SENSe] Commands Command List:  [:SENSe]:ACPower:AVERage:COUNt  [:SENSe]:ACPower:AVERage[:STATe]  [:SENSe]:ACPower:AVERage:TCONtrol  [:SENSe]:ACPower:BANDwidth:ACHannel  [:SENSe]:ACPower:BANDwidth:INTegration  [:SENSe]:ACPower:CSPacing  [:SENSe]:ACQuisition:TIME  [:SENSe]:ACQuisition:TIME:AUTO  [:SENSe]:ACQuisition:TIME:PVTime  [:SENSe]:ACQuisition:TIME:PVTime:AUTO  [:SENSe]:AVERage:COUNt  [:SENSe]:AVERage:COUNt:CURRent?  :TRACe:AVERage:C
PAGE 128
RIGOL  [:SENSe]:DEMod  [:SENSe]:DEMod:GAIN:AUTO  [:SENSe]:DEMod:GAIN:INCRement  [:SENSe]:DEMod:STATe  [:SENSe]:DETector:TRACe:PVTime  [:SENSe]:DETector[:FUNCtion]  [:SENSe]:DETector:TRACe  [:SENSe]:DETector:TRACe:AUTO  [:SENSe]:EBWidth:AVERage:COUNt*  [:SENSe]:EBWidth:AVERage[:STATe]*  [:SENSe]:EBWidth:AVERage:TCONtrol*  [:SENSe]:EBWidth:FREQuency:SPAN*  [:SENSe]:EBWidth:MAXHold:STATe*  [:SENSe]:EBWidth:XDB*  [:SENSe]:FREQuency:CENTer  [:SENSe]:FREQuency
PAGE 129
Chapter 2 Command System  [:SENSe]:OBWidth:MAXHold:STATe*  [:SENSe]:OBWidth:PERCent*  [:SENSe]:POWer[:RF]:ATTenuation  [:SENSe]:POWer[:RF]:ATTenuation:AUTO  [:SENSe]:POWer[:RF]:GAIN[:STATe]  [:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer]  [:SENSe]:SIGCapture:2FSK:AMPDown*  [:SENSe]:SIGCapture:2FSK:AMPUp*  [:SENSe]:SIGCapture:2FSK:MARK1:FREQ*  [:SENSe]:SIGCapture:2FSK:MARK1:SWitch[:STATe]*  [:SENSe]:SIGCapture:2FSK:MARK2:FREQ*  [:SENSe]:SIGCapture:2FSK:MARK2:SWitch[:STATe]*  [
PAGE 130
RIGOL Chapter 2 Command System [:SENSe]:ACPower:AVERage:COUNt Syntax [:SENSe]:ACPower:AVERage:COUNt [:SENSe]:ACPower:AVERage:COUNt? Description Sets the average count of the ACP measurement. Queries the average count of the ACP measurement. Parameter Name Type Integer Range 1 to 1,000 Default 10 Remarks This command is only valid when the adjacent channel power measurement in GPSA mode is enabled. Return Format The query returns the average count in integer.
PAGE 131
RIGOL Chapter 2 Command System [:SENSe]:ACPower:AVERage:TCONtrol Syntax [:SENSe]:ACPower:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:ACPower:AVERage:TCONtrol? Description Selects the average mode of the adjacent channel power measurement. Queries the average mode of the adjacent channel power measurement. Parameter Name Type —— Keyword Range EXPonential|REPeat Default EXPonential Remarks EXPonential: indicates the exponential average. REPeat: indicates the repeat average.
PAGE 132
RIGOL Chapter 2 Command System Example The following command sets the bandwidth of the adjacent channel to 1 MHz. :SENSe:ACPower:BANDwidth:ACHannel 1000000 The following query returns 1.000000000e+06. :SENSe:ACPower:BANDwidth:ACHannel? [:SENSe]:ACPower:BANDwidth:INTegration Syntax [:SENSe]:ACPower:BANDwidth:INTegration [:SENSe]:ACPower:BANDwidth:INTegration? Description Sets the bandwidth of the main channel. Queries the bandwidth of the main channel.
PAGE 133
RIGOL Chapter 2 Command System Remarks This command is only valid when the adjacent channel power measurement in GPSA mode is enabled. Return Format The query returns the channel spacing in scientific notation. Its unit is Hz. Example The following command sets the channel spacing to 1 MHz. :SENSe:ACPower:CSPacing 1000000 The following query returns 1.000000000e+06.
PAGE 134
RIGOL Parameter Name —— Chapter 2 Command System Type Bool Range OFF|ON|0|1 Default ON|1 Remarks This command is only available for Normal, Density, Spectrogram, and Density Spectrogram in RTSA mode. Return Format The query returns 0 or 1. Example The following command enables the auto acquisition time for producing one single trace or one bitmap. :SENSe:ACQuisition:TIME:AUTO ON or :SENSe:ACQuisition:TIME:AUTO 1 The following query returns 1.
PAGE 135
RIGOL Chapter 2 Command System [:SENSe]:ACQuisition:TIME:PVTime:AUTO Syntax [:SENSe]:ACQuisition:TIME:PVTime:AUTO OFF|ON|0|1 [:SENSe]:ACQuisition:TIME:PVTime:AUTO? Description Enables or disables the auto acquisition time for producing a trace. Queries the status of the auto acquisition time for producing a trace. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Remarks This command is only available for PvT, PvT Spectrum, and PvT Spectrogram in RTSA mode.
PAGE 136
RIGOL Chapter 2 Command System The following query returns 100. :SENSe:AVERage:COUNt? :TRACe:AVERage:COUNt? [:SENSe]:AVERage:COUNt:CURRent? :TRACe:AVERage:COUNt:CURRent? Syntax [:SENSe]:AVERage:COUNt:CURRent? :TRACe:AVERage:COUNt:CURRent? Description Queries the current average times of the average trace. Return Format The query returns the current trace average count in integer.
PAGE 137
RIGOL Chapter 2 Command System [:SENSe]:AVERage:TYPE:AUTO Syntax [:SENSe]:AVERage:TYPE:AUTO OFF|ON|0|1 [:SENSe]:AVERage:TYPE:AUTO? Description Enables or disables the auto state for the average type of the swept SA analysis measurement. Queries the on/off auto state for the average type of the swept SA analysis measurement. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for GPSA mode. Return Format The query returns 0 or 1.
PAGE 138
RIGOL Chapter 2 Command System The following query returns 1. :SENSe:BANDwidth:EMIFilter:STATe? :SENSe:BWIDth:EMIFilter:STATe? [:SENSe]:BANDwidth|BWIDth[:RESolution] Syntax [:SENSe]:BANDwidth|BWIDth[:RESolution] [:SENSe]:BANDwidth|BWIDth[:RESolution]? Description Sets the resolution bandwidth (RBW). Queries the resolution bandwidth.
PAGE 139
RIGOL Chapter 2 Command System This command is only available for GPSA mode. Return Format The query returns 0 or 1. Example The following command enables the auto setting mode of RBW. :SENSe:BANDwidth:RESolution:AUTO ON or :SENSe:BANDwidth:RESolution:AUTO 1 :SENSe:BWIDth:RESolution:AUTO ON or :SENSe:BWIDth:RESolution:AUTO 1 The following query returns 1.
PAGE 140
RIGOL Chapter 2 Command System [:SENSe]:BANDwidth|BWIDth[:RESolution]:SELect:AUTO[:STATe] Syntax [:SENSe]:BANDwidth|BWIDth[:RESolution]:SELect:AUTO[:STATe] OFF|ON|0|1 [:SENSe]:BANDwidth|BWIDth[:RESolution]:SELect:AUTO[:STATe]? Description Enables or disables the auto setting mode of RBW. Queries the status of the auto setting mode of RBW. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Remarks This command is only available for RTSA mode. Return Format The query returns 0 or 1.
PAGE 141
RIGOL Chapter 2 Command System :SENSe:BANDwidth:SHAPe GAUSsian :SENSe:BWIDth:SHAPe GAUSsian The following query returns GAUS. :SENSe:BANDwidth:SHAPe? :SENSe:BWIDth:SHAPe GAUSsian [:SENSe]:BANDwidth|BWIDth:VIDeo Syntax [:SENSe]:BANDwidth|BWIDth:VIDeo [:SENSe]:BANDwidth|BWIDth:VIDeo? Description Sets the video bandwidth (VBW). Queries the video bandwidth. Parameter Name Type Discrete Range 1 Hz to 10 MHz (at 1-3-10 step) Default 3 MHz Remarks This command is only available for GPSA mode.
PAGE 142
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the auto setting mode of VBW. :SENSe:BANDwidth:VIDeo:AUTO ON or :SENSe:BANDwidth:VIDeo:AUTO 1 :SENSe:BWIDth:VIDeo:AUTO ON or :SENSe:BWIDth:VIDeo:AUTO 1 The following query returns 1.
PAGE 143
RIGOL Chapter 2 Command System [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio:AUTO Syntax [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio:AUTO OFF|ON|0|1 [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio:AUTO? Description Enables or disables the auto setting mode of V/R ratio. Queries the status of the auto setting mode of V/R ratio. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Remarks This command is valid for the swept SA measurement in GPSA mode. Return Format The query returns 0 or 1.
PAGE 144
RIGOL Chapter 2 Command System The following query returns 100. :SENSe:CNRatio:AVERage:COUNt? [:SENSe]:CNRatio:AVERage[:STATe] Syntax [:SENSe]:CNRatio:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:CNRatio:AVERage[:STATe]? Description Enables or disables the average measurement function of the C/N ratio measurement. Queries the status of the average measurement function of the C/N ratio measurement.
PAGE 145
RIGOL Chapter 2 Command System This command is only valid when the C/N ratio measurement in GPSA mode is enabled. Return Format The query returns EXP or REP. Example The following command sets repeat average to the average mode. :SENSe:CNRatio:AVERage:TCONtrol REPeat The following query returns REP. :SENSe:CNRatio:AVERage:TCONtrol? [:SENSe]:CNRatio:BANDwidth:INTegration Syntax [:SENSe]:CNRatio:BANDwidth:INTegration [:SENSe]:CNRatio:BANDwidth:INTegration? Description Sets the carrier bandwidth.
PAGE 146
RIGOL Parameter Name Chapter 2 Command System Type Consecutive Real Number Range[1] 33 Hz to 1.5 GHz Note[1]: If option RSA3000-BW1 is installed, the available range is from 3 Hz to 1.5 GHz. Default 2 MHz Remarks This command is only valid when the C/N ratio measurement in GPSA mode is enabled. Return Format The query returns the noise bandwidth in integer. Its unit is Hz. Example The following command sets the noise bandwidth to 1 MHz.
PAGE 147
RIGOL Chapter 2 Command System :INPut:IMPedance [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] Syntax :INPut:IMPedance 50|75 :INPut:IMPedance? [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] 50|75 [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]? Description Sets the input impedance for voltage-to-power conversion. The unit is Ω. Queries the input impedance for voltage-to-power conversion.
PAGE 148
RIGOL Chapter 2 Command System [:SENSe]:DEMod Syntax [:SENSe]:DEMod AM|FM|OFF [:SENSe]:DEMod? Description Sets the demodulation type or disables the demodulation. Queries the demodulation type. Parameter Name —— Type Keyword Range AM|FM|OFF Default OFF Remarks AM: indicates the amplitude modulation. FM: indicates the frequency modulation. OFF: indicates off. When AM or FM is selected, the spectrum analyzer enables the demodulation function automatically.
PAGE 149
RIGOL Chapter 2 Command System Example The following command enables the auto setting mode of signal gain. :SENSe:DEMod:GAIN:AUTO ON or :SENSe:DEMod:GAIN:AUTO 1 The following query returns 1. :SENSe:DEMod:GAIN:AUTO? [:SENSe]:DEMod:GAIN:INCRement Syntax [:SENSe]:DEMod:GAIN:INCRement [:SENSe]:DEMod:GAIN:INCRement? Description Sets the signal gain. Queries the signal gain.
PAGE 150
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the demodulation function. :SENSe:DEMod:STATe 1 or :SENSe:DEMod:STATe ON The following query returns 1. :SENSe:DEMod:STATe? [:SENSe]:DETector:TRACe:PVTime Syntax [:SENSe]:DETector:TRACe:PVTime AVERage|NEGative|POSitive|SAMPle [:SENSe]:DETector:TRACe:PVTime? Description Sets the detector type of the trace in the PvT view. Queries the detector type of the trace in the PvT view.
PAGE 151
RIGOL Chapter 2 Command System [:SENSe]:DETector[:FUNCtion] [:SENSe]:DETector:TRACe Syntax [:SENSe]:DETector[:FUNCtion] AVERage（VAVerage）|NEGative|NORMal|POSitive|SAMPle|QPEak|RAVerage （RMS） [:SENSe]:DETector[:FUNCtion]? [:SENSe]:DETector:TRACe AVERage（VAVerage）|NEGative|NORMal|POSitive|SAMPle|QPEak|RAVerage （RMS） [:SENSe]:DETector:TRACe? Description Sets the detector type for the specified trace. Queries the detector type for the specified trace.
PAGE 152
RIGOL Chapter 2 Command System [:SENSe]:DETector:TRACe:AUTO Syntax [:SENSe]:DETector:TRACe:AUTO OFF|ON|0|1 [:SENSe]:DETector:TRACe:AUTO? Description Enables or disables the Detector Auto function for the specified trace. Queries the status of the Detector Auto function for the specified trace. Parameter Name —— Type Discrete Bool Range 1|2|3|4|5|6 OFF|ON|0|1 Default 1 ON|1 Return Format The query returns 0 or 1. Example The following command enables the Detector Auto function for Trace 1.
PAGE 153
RIGOL Chapter 2 Command System [:SENSe]:EBWidth:AVERage[:STATe] Syntax [:SENSe]:EBWidth:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:EBWidth:AVERage[:STATe]? Description Enables or disables the average measurement function of the emission bandwidth measurement. Queries the status of the average measurement function of the emission bandwidth measurement. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only valid when the emission bandwidth measurement in GPSA mode is enabled.
PAGE 154
RIGOL Chapter 2 Command System Example The following command sets the average mode to Repeat. :SENSe:EBWidth:AVERage:TCONtrol REPeat The following query returns REP. :SENSe:EBWidth:AVERage:TCONtrol? [:SENSe]:EBWidth:FREQuency:SPAN Syntax [:SENSe]:EBWidth:FREQuency:SPAN [:SENSe]:EBWidth:FREQuency:SPAN? Description Sets the span of the emission bandwidth measurement. Queries the span of the emission bandwidth measurement. Parameter Name Type Consecutive Real Number Range[1] 100 Hz to 4.
PAGE 155
RIGOL Chapter 2 Command System When Max Hold is enabled, each measurement result is compared with the previous result, and then display whichever is the maximum. When Max Hold is disabled, the current measurement result is displayed. Max Hold and average measurement are mutually exclusive. When Max Hold is enabled, the average measurement will be automatically disabled. Return Format The query returns 0 or 1. Example The following command enables the Max Hold.
PAGE 156
RIGOL Chapter 2 Command System [:SENSe]:FREQuency:CENTer Syntax [:SENSe]:FREQuency:CENTer [:SENSe]:FREQuency:CENTer? Description Sets the center frequency. Queries the center frequency. Parameter Name Type Consecutive Real Number Range 0 Hz to Fmax[1] (zero span) GPSA mode 50 Hz to (Fmax - 50 Hz) (non-zero span) [2] RTSA mode 2.5 kHz to (Fmax - 2.5 kHz) Default Fmax/2 Note[1]: Fmax (maximum measurement frequency) is determined by the model of the spectrum analyzer.
PAGE 157
RIGOL Chapter 2 Command System [:SENSe]:FREQuency:CENTer:STEP[:INCRement] Syntax [:SENSe]:FREQuency:CENTer:STEP[:INCRement] [:SENSe]:FREQuency:CENTer:STEP[:INCRement]? Description Sets the CF step. Queries the CF step. Parameter Name Type Consecutive Real Number Range -Fmax to Fmax Default Fmax/10 Return Format The query returns the center frequency step in scientific notation. The unit is Hz. Example The following command sets the CF step to 100 kHz.
PAGE 158
RIGOL Chapter 2 Command System [:SENSe]:FREQuency:SPAN Syntax [:SENSe]:FREQuency:SPAN [:SENSe]:FREQuency:SPAN? Description Sets the span. Queries the span. Parameter Name Type Consecutive Real Number Range GPSA mode : 0 Hz，100 Hz to Fmax RTSA mode[2]: 5 kHz to 10 MHz [1] Default GPSA mode: Fmaxz RTSAmode[3]: 10 MHz Note[1]: When the span of the analyzer is set to 0 Hz, the spectrum analyzer enters the zero span mode.
PAGE 159
RIGOL Chapter 2 Command System Example The following command sets the span/RBW ratio to 100. :SENSe:FREQuency:SPAN:BANDwidth:RESolution:RATio 100 The following query returns 100. :SENSe:FREQuency:SPAN:BANDwidth:RESolution:RATio? [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio:AUTO Syntax [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio:AUTO OFF|ON|0|1 [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio:AUTO? Description Enables or disables the auto setting mode of span/RBW ratio.
PAGE 160
RIGOL Chapter 2 Command System [:SENSe]:FREQuency:SPAN:ZERO Syntax [:SENSe]:FREQuency:SPAN:ZERO Description Sets the span to 0 (zero span). Remarks This command is only available for GPSA mode. [:SENSe]:FREQuency:STARt Syntax [:SENSe]:FREQuency:STARt [:SENSe]:FREQuency:STARt? Description Sets the start frequency. Queries the start frequency.
PAGE 161
RIGOL Chapter 2 Command System [:SENSe]:FREQuency:STOP Syntax [:SENSe]:FREQuency:STOP [:SENSe]:FREQuency:STOP? Description Sets the stop frequency. Queries the stop frequency. Parameter Name Type Consecutive Real Number GPSA mode RTSA mode Range[1] Default 0 Hz to Fmax (zero span) center 100 Hz to Fmax (non-zero span) [1] frequency+span/2 5 kHz to Fmax Note[1]: In non-zero span, if the option RSA3030-BW1 is installed, the available range is 10 Hz to Fmax.
PAGE 162
RIGOL Parameter Name Chapter 2 Command System Type Integer Range 1 to 1,000 Default 10 Remarks This command is only valid when the harmonic distortion measurement in GPSA mode is enabled. Return Format The query returns the average count in integer. Example The following command sets the average count to 100. :SENSe:HDISt:AVERage:COUNt 100 The following query returns 100.
PAGE 163
RIGOL Chapter 2 Command System [:SENSe]:HDISt:AVERage:TCONtrol Syntax [:SENSe]:HDISt:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:HDISt:AVERage:TCONtrol? Description Sets the average mode of the harmonic distortion measurement. Queries the average mode of the harmonic distortion measurement. Parameter Name —— Type Keyword Range EXPonential|REPeat Default EXPonential Remarks EXPonential: indicates the exponential average. REPeat: indicates the repeat average.
PAGE 164
RIGOL Chapter 2 Command System Example The following command sets the number of harmonics to 5. :SENSe:HDISt:NUMBers 5 The following query returns 5. :SENSe:HDISt:NUMBers? [:SENSe]:HDISt:TIME Syntax [:SENSe]:HDISt:TIME [:SENSe]:HDISt:TIME? Description Sets the sweep time of the harmonic distortion measurement. Queries the sweep time of the harmonic distortion measurement.
PAGE 165
RIGOL Chapter 2 Command System Return Format The query returns the average count in integer. Example The following command sets the average count to 100. :SENSe:MCHPower:AVERage:COUNt 100 The following query returns 100. :SENSe:MCHPower:AVERage:COUNt? [:SENSe]:MCHPower:AVERage[:STATe] Syntax [:SENSe]:MCHPower:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:MCHPower:AVERage[:STATe]? Description Enables or disables the average measurement function of the multi-channel power measurement.
PAGE 166
RIGOL Chapter 2 Command System Remarks EXPonential: indicates the exponential average. REPeat: indicates the repeat average. When "EXPonential" is selected, the result is the exponential average of the measurement results obtained in the past N times (N is specified in [:SENSe]:MCHPower:AVERage:COUNt). When "REPeat" is selected, the result is the arithmetic average of the measurement results obtained in the past N times (N is specified in [:SENSe]:MCHPower:AVERage:COUNt).
PAGE 167
RIGOL Chapter 2 Command System Description Enables or disables the average measurement function of the occupied bandwidth measurement. Queries the status of the average measurement function of the occupied bandwidth measurement. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Remarks This command is only valid when the occupied bandwidth measurement in GPSA mode is enabled. Return Format The query returns 0 or 1. Example The following command enables the average measurement function.
PAGE 168
RIGOL Chapter 2 Command System [:SENSe]:OBWidth:FREQuency:SPAN Syntax [:SENSe]:OBWidth:FREQuency:SPAN [:SENSe]:OBWidth:FREQuency:SPAN? Description Sets the span of the occupied bandwidth measurement. Queries the span of the occupied bandwidth measurement. Parameter Name Type Consecutive Real Number Range[1] 100 Hz to 4.5 GHz Default 2 MHz Note[1]: If option RSA3000-BW1 is installed, the available range is from 10 Hz to 4.5 GHz.
PAGE 169
RIGOL Chapter 2 Command System Example The following command enables the Max Hold. :SENSe:OBWidth:MAXHold:STATe ON or :SENSe:OBWidth:MAXHold:STATe 1 The following query returns 1. :SENSe:OBWidth:MAXHold:STATe? [:SENSe]:OBWidth:PERCent Syntax [:SENSe]:OBWidth:PERCent [:SENSe]:OBWidth:PERCent? Description Sets the percentage the signal power takes up in the whole span power (power ratio). Queries the power ratio of the occupied bandwidth measurement.
PAGE 170
RIGOL Chapter 2 Command System Example The following command sets the attenuation to 20 dB. :SENSe:POWer:RF:ATTenuation 20 The following query returns 20. :SENSe:POWer:RF:ATTenuation? [:SENSe]:POWer[:RF]:ATTenuation:AUTO Syntax [:SENSe]:POWer[:RF]:ATTenuation:AUTO OFF|ON|0|1 [:SENSe]:POWer[:RF]:ATTenuation:AUTO? Description Enables or disables the auto setting mode of the input attenuation. Queries the status of the auto setting mode of the input attenuation.
PAGE 171
RIGOL Chapter 2 Command System [:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer] Syntax [:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer] [:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer]? Description Sets the maximum power of the input mixer. Queries the maximum power of the input mixer. Parameter Name Type Consecutive Real Number Range -50 dBm to -10 dBm Default -10 dBm Return Format The query returns the maximum power of the input mixer in scientific notation. The unit is dBm.
PAGE 172
RIGOL Chapter 2 Command System [:SENSe]:SIGCapture:2FSK:AMPUp Syntax [:SENSe]:SIGCapture:2FSK:AMPUp [:SENSe]:SIGCapture:2FSK:AMPUp? Description Sets the upper limit of the amplitude of 2FSK signal. Queries the upper limit of the amplitude of 2FSK signal. Parameter Name Type Consecutive Real Number Range -100 dBm to 320 dBm Default -10 dBm Remarks This command is only available for RTSA mode and valid when the SSC function is enabled.
PAGE 173
RIGOL Chapter 2 Command System [:SENSe]:SIGCapture:2FSK:MARK1:SWitch[:STATe] Syntax [:SENSe]:SIGCapture:2FSK:MARK1:SWitch[:STATe] OFF|ON|0|1 [:SENSe]:SIGCapture:2FSK:MARK1:SWitch[:STATe]? Description Enables or disables Mark 1. Queries the on/off status of Marker 1. Parameter Name -- Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for RTSA mode and valid when the SSC function is enabled. Return Format The query returns 0 or 1.
PAGE 174
RIGOL Chapter 2 Command System [:SENSe]:SIGCapture:2FSK:MARK2:SWitch[:STATe] Syntax [:SENSe]:SIGCapture:2FSK:MARK2:SWitch[:STATe] OFF|ON|0|1 [:SENSe]:SIGCapture:2FSK:MARK2:SWitch[:STATe]? Description Enables or disables Mark 2. Queries the on/off status of Marker 2. Parameter Name -- Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for RTSA mode and valid when the SSC function is enabled. Return Format The query returns 0 or 1.
PAGE 175
RIGOL Chapter 2 Command System [:SENSe]:SIGCapture:2FSK:PEAKAmp? Syntax [:SENSe]:SIGCapture:2FSK:PEAKAmp? Description Queries the amplitude of the nth peak in the SSC measurement results. Parameter Name Type Integer Range 1 to 6 Default 1 Remarks This command is only available for RTSA mode and valid when the SSC function is enabled. Return Format The query returns the amplitude of the nth peak (i.g. the value of the parameter ) in scientific notation.
PAGE 176
RIGOL Chapter 2 Command System [:SENSe]:SIGCapture:2FSK:PF? Syntax [:SENSe]:SIGCapture:2FSK:PF? Description Queries the test result of the Pass/Fail function. Remarks This command is only available for RTSA mode and valid when the SSC function is enabled. Return Format The query returns PASS or FAIL. Example The following query returns PASS.
PAGE 177
RIGOL Chapter 2 Command System [:SENSe]:SIGCapture:2FSK:RESet Syntax [:SENSe]:SIGCapture:2FSK:RESet Description Performs the reset operation, deletes the original signal, and restarts to capture the signal. Remarks This command is only available for RTSA mode and valid when the SSC function is enabled.
PAGE 178
RIGOL Chapter 2 Command System [:SENSe]:SWEep:POINts Syntax [:SENSe]:SWEep:POINts [:SENSe]:SWEep:POINts? Description Sets the number of sweep points. Queries the number of sweep points. Parameter Name Type Integer Range 101 to 10,001 Default 801 Remarks This command is only available for GPSA mode. Return Format The query returns the number of sweep points in integer. Example The following command sets the number of sweep points to 650.
PAGE 179
RIGOL Chapter 2 Command System [:SENSe]:SWEep:TIME:AUTO Syntax [:SENSe]:SWEep:TIME:AUTO OFF|ON|0|1 [:SENSe]:SWEep:TIME:AUTO? Description Enables or disables auto sweep time. Queries the status of the auto sweep time. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Remarks This command is only available for GPSA mode. Return Format The query returns 0 or 1. Example The following command enables the auto sweep time.
PAGE 180
RIGOL Chapter 2 Command System [:SENSe]:TOI:AVERage:COUNt Syntax [:SENSe]:TOI:AVERage:COUNt [:SENSe]:TOI:AVERage:COUNt? Description Sets the average count of the TOI measurement. Queries the average count of the TOI measurement. Parameter Name Type Integer Range 1 to 1,000 Default 10 Remarks This command is only valid when the TOI measurement in GPSA mode is enabled. Return Format The query returns the average count in integer.
PAGE 181
RIGOL Chapter 2 Command System [:SENSe]:TOI:AVERage:TCONtrol Syntax [:SENSe]:TOI:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:TOI:AVERage:TCONtrol? Description Selects the average mode of the TOI measurement. Queries the average mode of the TOI measurement. Parameter Name Type —— Keyword Range EXPonential|REPeat Default EXPonential Remarks EXPonential: indicates the exponential average. REPeat: indicates the repeat average.
PAGE 182
RIGOL Chapter 2 Command System Example The following command sets the span to 1 MHz. :SENSe:TOI:FREQuency:SPAN 1000000 The following query returns 1.000000000e+06. :SENSe:TOI:FREQuency:SPAN? [:SENSe]:TPOWer:AVERage:COUNt Syntax [:SENSe]:TPOWer:AVERage:COUNt [:SENSe]:TPOWer:AVERage:COUNt? Description Sets the average count of the T-power measurement. Queries the average count of the T-power measurement.
PAGE 183
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the average measurement. :SENSe:TPOWer:AVERage:STATe ON or :SENSe:TPOWer:AVERage:STATe 1 The following query returns 1. :SENSe:TPOWer:AVERage:STATe? [:SENSe]:TPOWer:AVERage:TCONtrol Syntax [:SENSe]:TPOWer:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:TPOWer:AVERage:TCONtrol? Description Sets the average mode of the T-power measurement. Queries the average mode of the T-power measurement.
PAGE 184
RIGOL Parameter Name Chapter 2 Command System Type Consecutive Real Number Range 0 μs to (current value of stop line) Default 0 μs Remarks This command is only valid when the T-power measurement in GPSA mode is enabled. Return Format The query returns the start line in scientific notation. The unit is s. Example The following command sets the start line to 5 ms. :SENSe:TPOWer:LLIMit 0.005 The following query returns 5.000000000e-03.
PAGE 185
RIGOL Chapter 2 Command System [:SENSe]:TPOWer:RLIMit Syntax [:SENSe]:TPOWer:RLIMit [:SENSe]:TPOWer:RLIMit? Description Sets the stop line for the T-power measurement. Queries the stop line for the T-power measurement. Parameter Name Type Consecutive Real Number Range current value of start line to current value of sweep time Default 1 ms Remarks This command is only valid when the T-power measurement in GPSA mode is enabled.
PAGE 186
RIGOL Chapter 2 Command System :SOURce Commands Command List:  :SOURce:CORRection:OFFSet  :SOURce[:EXTernal]:POWer[:LEVel][:IMMediate][:AMPLitude]  :SOURce:TRACe:REFerence:STATe  :SOURce:TRACe:STORref Remarks: The :SOURce commands are only available for RSA3045-TG/RSA3030-TG working in GPSA mode. :SOURce:CORRection:OFFSet Syntax :SOURce:CORRection:OFFSet :SOURce:CORRection:OFFSet? Description Sets the offset of the output amplitude of the tracking generator.
PAGE 187
RIGOL Chapter 2 Command System Return Format The query returns the output amplitude in scientific notation. Example The following command sets the output amplitude to -10 dB. :SOURce:EXTernal:POWer:LEVel:IMMediate:AMPLitude -10 The following query returns -1.000000000e+01. :SOURce:EXTernal:POWer:LEVel:IMMediate:AMPLitude? :SOURce:TRACe:REFerence:STATe Syntax :SOURce:TRACe:REFerence:STATe OFF|ON|0|1 :SOURce:TRACe:REFerence:STATe? Description Sets whether to display the reference trace of normalization.
PAGE 188
RIGOL Chapter 2 Command System :STATus Commands The :STATus commands and IEEE 488.2 Common Commands are used to operate or query the status registers. The structure of the status register is shown in the following figure. The STATus commands are used to set and query the questionable status register and operation status register. IEEE488.2 common commands can be used to operate on the standard event status register and status byte register.
PAGE 189
RIGOL Chapter 2 Command System :STATus:OPERation:CONDition? Syntax :STATus:OPERation:CONDition? Description Queries the condition register of the Operation Status Register. Return Format The query returns the condition register in integer. For example, 24. :STATus:OPERation:ENABle Syntax :STATus:OPERation:ENABle :STATus:OPERation:ENABle? Description Sets the enable register of the Operation Status Register. Queries the enable register of the Operation Status Register.
PAGE 190
RIGOL Chapter 2 Command System Example The following command sets the enable register of the Operation Status Register to 100. :STATus:OPERation:ENABle 100 The following query returns 100. :STATus:OPERation:ENABle? :STATus:OPERation[:EVENt]? Syntax :STATus:OPERation[:EVENt]? Description Queries the event register of the Operation Status Register. Return Format The query returns the event register of the Operation Status Register in integer. For example, 24.
PAGE 191
RIGOL Chapter 2 Command System Parameter Name Type Integer Range Refer to "Remarks" Default 0 Remarks The following table lists the bit definitions for the questionable status register. The bit 0 to bit 8, bit 13 and bit 14 are reserved; they can be set but will not affect the instrument.
PAGE 192
RIGOL Chapter 2 Command System :SYSTem Commands Command List:  :SYSTem:BEEPer:STATe  :SYSTem:COMMunicate:LAN[:SELF]:APPLy  :SYSTem:COMMunicate:LAN[:SELF]:AUToip:STATe  :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe  :SYSTem:COMMunicate:LAN[:SELF]:IP:ADDRess  :SYSTem:COMMunicate:LAN[:SELF]:IP:DNS:AUTO[:STATe]  :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSBack  :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSPreferred  :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSServer  :SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway
PAGE 193
RIGOL Chapter 2 Command System :SYSTem:BEEPer:STATe Syntax :SYSTem:BEEPer:STATe OFF|ON|0|1 :SYSTem:BEEPer:STATe? Description Turns on or off the beeper. Queries the status of the beeper. Parameter Name Type —— Bool Range OFF|ON|0|1 Default OFF|0 Return Format The query returns 0 or 1. Example The following command turns on the beeper. :SYSTem:BEEPer:STATe ON or :SYSTem:BEEPer:STATe 1 The following query returns 1.
PAGE 194
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the auto IP setting mode. :SYSTem:COMMunicate:LAN:SELF:AUToip:STATe ON or :SYSTem:COMMunicate:LAN:SELF:AUToip:STATe 1 The following query returns 1. :SYSTem:COMMunicate:LAN:SELF:AUToip:STATe? :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe Syntax :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe OFF|ON|0|1 :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe? Description Enables or disables the DHCP configuration mode.
PAGE 195
RIGOL Chapter 2 Command System Remarks The format of is "nnn.nnn.nnn.nnn". The range for the first segment (nnn) of the address is from 1 to 223 (except 127); and the range for the other three segments is from 0 to 255. This command is only valid in manual IP setting mode. Return Format The query returns the current IP address in the format of "nnn.nnn.nnn.nnn". Example The following command sets the IP address to "172.16.3.199". :SYSTem:COMMunicate:LAN:SELF:IP:ADDRess 172.16.3.
PAGE 196
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSBack Syntax :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSBack :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSBack? Description Sets the backup address for the DNS. Queries the backup address for the DNS. Parameter Name Type ASCII String Range Refer to "Remarks" Default —— Remarks The format of is "nnn.nnn.nnn.nnn".
PAGE 197
RIGOL Chapter 2 Command System Example The following command sets the preferred DNS address to "172.16.2.2". :SYSTem:COMMunicate:LAN:SELF:IP:DNSPreferred 172.16.2.2 :SYSTem:COMMunicate:LAN:SELF:IP:DNSServer 172.16.2.2 The following query returns 172.16.2.2.
PAGE 198
RIGOL Chapter 2 Command System Remarks The format of is "nnn.nnn.nnn.nnn". The range for the first segment (nnn) is from 0 to 255. This command is only valid in manual IP setting mode. Return Format The query returns the current subnet mask in the format of "nnn.nnn.nnn.nnn". Example The following command sets the subnet mask to "255.255.255.0". :SYSTem:COMMunicate:LAN:SELF:IP:SUBMask 255.255.255.0 The following query returns 255.255.255.0.
PAGE 199
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN[:SELF]:MDNS:STATe Syntax :SYSTem:COMMunicate:LAN[:SELF]:MDNS:STATe OFF|ON|0|1 :SYSTem:COMMunicate:LAN[:SELF]:MDNS:STATe? Description Enables or disables the state of the network information sending. Queries the on/off status of the network information sending. Parameter Name Type —— Bool Range OFF|ON|0|1 Default OFF|0 Remarks ON|1: The state of the network information sending is turned on.
PAGE 200
RIGOL Chapter 2 Command System Main Board:00.01.00 Keyboard:00.01.00 CPU:00.01.00 SPU:00.01.02 WPU:00.01.00 BOOT:00.01.00 OS:00.01.00 Firmware:00.01.00 Note: When you use RSA3045-TG/RSA3030-TG, the query also returns information about "TG Board". :SYSTem:DATE Syntax :SYSTem:DATE ,, :SYSTem:DATE? Description Sets the date of the instrument. Queries the date of the instrument.
PAGE 201
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command sets the power switch on the front panel is turned off. :SYSTem:FSWitch:STATe OFF or :SYSTem:FSWitch:STATe 0 The following query returns 0. :SYSTem:FSWitch:STATe? :SYSTem:LANGuage Syntax :SYSTem:LANGuage ENGLish|CHINese :SYSTem:LANGuage? Description Sets the language of the instrument. Queries the language of the instrument.
PAGE 202
RIGOL Chapter 2 Command System Example The following command installs the option RSA3000-PA. :SYSTem:LKEY RSA3000-PA@8AD12B8EBC5DF492D1D4289B7CBA5B6150BF6F5D752D645C36D74530B05F39B49C461B2 3A50D6C94A34E06782AC4380070B0D1A86BA84E02768391FFD70C2103 :SYSTem:OPTion:STATe? Syntax :SYSTem:OPTion:STATe?
PAGE 203
RIGOL Chapter 2 Command System :SYSTem:PRESet Syntax :SYSTem:PRESet Description Recalls the system's preset settings, and recovers the system to the state specified by the :SYSTem:PRESet:TYPE command. :SYSTem:PRESet:SAVE Syntax :SYSTem:PRESet:SAVE USER1|USER2|USER3|USER4|USER5|USER6 Description Saves the specified user setting.
PAGE 204
RIGOL Chapter 2 Command System :SYSTem:PRESet:USER:SAVE Syntax :SYSTem:PRESet:USER:SAVE Description Saves the current user setting. Remarks If the current preset type is "FACTory", save the current user setting to User1. If the current preset type is "User1 through User6", save the current user setting to the specified user. :SYSTem:SCPI:DISPlay Syntax :SYSTem:SCPI:DISPlay OFF|ON|0|1 :SYSTem:SCPI:DISPlay? Description Enables or disables the SCPI display. Queries the status for the SCPI display.
PAGE 205
RIGOL Chapter 2 Command System Parameter Name —— Type Keyword Range OFF|SYSTem|OPTion|LICense Default OFF Remarks OFF: turns off the system information display. SYSTem: displays the system information. OPTion: displays the option information. LICense: displays the registration information. Return Format The query returns OFF, SYST, OPT, or LIC. Example The following command displays the system information. :SYSTem:SHOW SYSTem The following query returns SYST.
PAGE 206
RIGOL Chapter 2 Command System :TRACe Commands Command List:  :TRACe:CLEar:ALL  :TRACe[:DATA]  :TRACe:MATH:A  :TRACe:MATH:B  :TRACe:MATH:CONSt  :TRACe:MATH:PEAK[:DATA]?  :TRACe:MATH:PEAK:POINts?  :TRACe:MATH:REFerence  :TRACe:MATH:STATe  :TRACe:MATH:TYPE  :TRACe:PRESet:ALL  :TRACe:DISPlay:STATe  :TRACe:MODE  :TRACe:TYPE  :TRACe:UPDate:STATe :TRACe:CLEar:ALL Syntax :TRACe:CLEar:ALL Description Clears all the traces, that is, all the points on the trace
PAGE 207
Chapter 2 Command System RIGOL Explanation 1. Use the :FORMat[:TRACe][:DATA] command to set the format of the user data. 2. : Data block[1]. Select this parameter when the data format is ASCii. The two neighboring data points are separated by a comma (1 byte) and a space (1 byte) and each point is expressed in scientific notation; for example, -1.390530e+01 (13 bytes). Up to 801 points can be sent. 3. : Data block[1].
PAGE 208
RIGOL Chapter 2 Command System [2] In the two examples here, 801 points are transmitted and the queries return 801 points. However, due to the limited space, the succeeding data is omitted here. The return values in the above examples are acquired when the trace stops sweeping. :TRACe:MATH:A Syntax :TRACe:MATH:A T1|T2|T3|T4|T5|T6 :TRACe:MATH:A? Description Sets Op1 in the trace math operation formula to Trace 1, Trace 2, Trace 3, Trace 4, Trace 5, or Trace 6.
PAGE 209
RIGOL Chapter 2 Command System :TRACe:MATH:CONSt Syntax :TRACe:MATH:CONSt :TRACe:MATH:CONSt? Description Sets the log offset in the trace math operation formula. Queries the log offset in the trace math operation formula. Parameter Name Type Consecutive Real Number Range -100 dB to 100 dB Default 0 dB Return Format The query returns the log offset in scientific notation. Example The following command sets the log offset to 50 dB. :TRACe:MATH:CONSt 50 The following query returns 5.
PAGE 210
RIGOL Chapter 2 Command System :TRACe:MATH:REFerence Syntax :TRACe:MATH:REFerence :TRACe:MATH:REFerence? Description Sets the log reference in the trace math operation formula. Queries the log reference in the trace math operation formula. Parameter Name Type Consecutive Real Number Range -170 dBm to 30 dBm Default 0 dBm Return Format The query returns the log reference in scientific notation. Example The following command sets the log reference to 50 dBm.
PAGE 211
RIGOL Chapter 2 Command System :TRACe:MATH:TYPE Syntax :TRACe:MATH:TYPE A+B|A-B|A+CONST|A-CONST|A-B+REF :TRACe:MATH:TYPE? Description Sets the operation type of the trace. Queries the operation type of the trace.
PAGE 212
RIGOL Chapter 2 Command System :TRACe:DISPlay:STATe Syntax :TRACe:DISPlay[:STATe] OFF|ON|0|1 :TRACe:DISPlay[:STATe]? Description Enables or disables the display of the specified trace. Queries the status for the specified trace. Parameter Name Type Discrete —— Bool Range 1|2|3|4|5|6 OFF|ON|0|1 Default —— Refer to "Remarks" Remarks By default, Trace 1 is enabled (ON), and Trace 2 through Trace 6 are disabled (OFF). Return Format The query returns 1 or 0.
PAGE 213
RIGOL Chapter 2 Command System Return Format The query returns WRIT, AVER, MAXH, or MINH. Example The following command sets the type of Trace 1 to Max Hold. :TRACe1:MODE MAXHold :TRACe1:TYPE MAXHold The following query returns MAXH. :TRACe1:MODE? :TRACe1:TYPE? :TRACe:UPDate:STATe Syntax :TRACe:UPDate:STATe OFF|ON|0|1 :TRACe:UPDate:STATe? Description Enables or disables the update of the specified trace. Queries the status for the update of the specified trace.
PAGE 214
RIGOL Chapter 2 Command System :TRIGger Commands Command List:  :TRIGger[:SEQuence]:ATRigger  :TRIGger[:SEQuence]:ATRigger:STATe  :TRIGger[:SEQuence]:EXTernal:DELay  :TRIGger[:SEQuence]:EXTernal:DELay:STATe  :TRIGger[:SEQuence]:EXTernal:SLOPe  :TRIGger[:SEQuence]:FMT:APTRigger  :TRIGger[:SEQuence]:FMT:CRITeria  :TRIGger[:SEQuence]:FMT:DELay  :TRIGger[:SEQuence]:FMT:DELay:STATe  :TRIGger[:SEQuence]:FMT:MASK  :TRIGger[:SEQuence]:FMT:MASK:EDIT  :TRIGger[:SEQuence]:FM
PAGE 215
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:ATRigger Syntax :TRIGger[:SEQuence]:ATRigger :TRIGger[:SEQuence]:ATRigger? Description Sets the time that the analyzer will wait for the trigger to be initiated automatically. Queries the time that the analyzer will wait for the trigger to be initiated automatically. Parameter Name Type Consecutive Real Number Range 1 ms to 100 s Default 100 ms Remarks This command is only valid when the auto triggering function is enabled.
PAGE 216
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:EXTernal:DELay Syntax :TRIGger[:SEQuence]:EXTernal:DELay :TRIGger[:SEQuence]:EXTernal:DELay? Description Sets the delay time for the external trigger. Queries the delay time for the external trigger. Parameter Name Type Discrete Consecutive Real Number Range 1|2 0 μs to 500 ms Default —— 1 μs Remarks When the parameter n is set to 1, it indicates External Trigger 1; when set to 2, it indicates External Trigger 2.
PAGE 217
RIGOL Chapter 2 Command System :TRIGger:SEQuence:EXTernal1:DELay:STATe ON or :TRIGger:SEQuence:EXTernal1:DELay:STATe 1 The following query returns 1. :TRIGger:SEQuence:EXTernal1:DELay:STATe? :TRIGger[:SEQuence]:EXTernal:SLOPe Syntax :TRIGger:SEQuence:EXTernal:SLOPe POSitive|NEGative :TRIGger:SEQuence:EXTernal:SLOPe? Description Sets the trigger edge for the external trigger. Queries the trigger edge for the external trigger.
PAGE 218
RIGOL Chapter 2 Command System "Outside", the maximum value of the parameter is 1. In the Spectrogram measurement mode, the maximum value of the parameter is 10,000. In the PvT measurement mode, the maximum value of the parameter is 5,000. This command is only valid when you select FMT to be the trigger source in RTSA mode. Return Format The query returns the number of acquisition times in integer. Example The following command sets the number of acquisition times to 5.
PAGE 219
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:FMT:DELay Syntax :TRIGger[:SEQuence]:FMT:DELay :TRIGger[:SEQuence]:FMT:DELay? Description Sets the delay time for FMT. Queries the delay time for FMT. Parameter Name Type Consecutive Real Number Range 0 us to 500 ms Default 1 μs Remarks When "Inside" or "Outside" is selected to be the trigger criteria, the FMT trigger delay command is invalid.
PAGE 220
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:FMT:MASK Syntax :TRIGger[:SEQuence]:FMT:MASK UPPer|LOWer|BOTH :TRIGger[:SEQuence]:FMT:MASK? Description Sets the mask to be used for the current trigger. Queries the mask to be used for the current trigger. Parameter Name —— Type Keyword Range UPPer|LOWer|BOTH Default UPPer Remarks This command is only valid when you select FMT to be the trigger source in RTSA mode. Return Format The query returns UPP, LOW, or BOTH.
PAGE 221
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:FMT:MASK:RELative:AMPLitude Syntax :TRIGger[:SEQuence]:FMT:MASK:RELative:AMPLitude ON|OFF|1|0 :TRIGger[:SEQuence]:FMT:MASK:RELative:AMPLitude? Description Sets whether the amplitudes of the mask points are coupled to the reference level of the instrument. Queries whether the amplitudes of the mask points are coupled to the reference level of the instrument.
PAGE 222
RIGOL Chapter 2 Command System ON|1: enables the coupling function. That is, when "Relative" is selected under X Axis Type, the frequency of the current mask point is the difference between the point and the current center frequency. If you modify the state of this parameter after the mask has been set, the frequency of the mask should make corresponding changes based on the state of the parameter, so as to keep the relations between the mask and the center frequency of the instrument unchanged.
PAGE 223
RIGOL Chapter 2 Command System Parameter Name Type Discrete Consecutive Real Number Consecutive Real Number Range 1|2 0 Hz to 4.5 GHz -1,000 dBm to 1,000 dBm Default —— Remarks When is set to 1, it indicates that the upper mask is being edited; when it is set to 2, it indicates that the lower mask is being edited. This command is only valid when you select FMT to be the trigger source in RTSA working mode.
PAGE 224
RIGOL Chapter 2 Command System the lower mask is being edited. This command is only valid when you select FMT to be the trigger source in RTSA working mode. :TRIGger[:SEQuence]:HOLDoff Syntax :TRIGger[:SEQuence]:HOLDoff :TRIGger[:SEQuence]:HOLDoff? Description Sets the trigger holdoff time. Queries the trigger holdoff time.
PAGE 225
RIGOL Chapter 2 Command System The following query returns 1. :TRIGger:SEQuence:HOLDoff:STATe? :TRIGger[:SEQuence]:SOURce Syntax :TRIGger[:SEQuence]:SOURce EXTernal1|EXTernal2|IMMediate|VIDeo|FMT|POWer :TRIGger[:SEQuence]:SOURce? Description Sets the trigger source. Queries the trigger source. Parameter Name —— Type Keyword Range EXTernal1|EXTernal2|IMMediate|VIDeo|FMT|POWer Default IMMediate Remarks EXTernal1: indicates External Trigger 1. EXTernal2: indicates External Trigger 2.
PAGE 226
RIGOL Chapter 2 Command System Return Format The query returns the delay time for video trigger in scientific notation. The unit is s. Example The following command sets the delay time for the video trigger to 100 ms. :TRIGger:SEQuence:VIDeo:DELay 0.1 The following query returns 1.000000e-01.
PAGE 227
RIGOL Chapter 2 Command System Remarks This command is only valid when the following conditions are met: in GPSA mode; selecting the video trigger. Return Format The query returns the trigger level in scientific notation. Example The following command sets the trigger level of the video trigger to 10 dBm. :TRIGger:SEQuence:VIDeo:LEVel 10 The following query returns 1.000000e+01.
PAGE 228
RIGOL Chapter 2 Command System :TRIGger2:MODE Syntax :TRIGger2:MODE IN|OUT|0|1 :TRIGger2:MODE? Description Sets the interface type of External Trigger 2. Queries the interface type of External Trigger 2. Parameter Name Type —— Keyword Range IN|OUT|0|1 Default IN|0 Remarks IN|0: indicates the input interface. OUT|1: indicates the output interface. Return Format The query returns 0 or 1. Example The following command sets External Trigger 2 to the input interface.
PAGE 229
RIGOL Chapter 2 Command System :UNIT Command Command List:  :UNIT:POWer :UNIT:POWer Syntax :UNIT:POWer DBM|DBMV|DBUV|V|W :UNIT:POWer? Description Sets the unit of the Y axis. Queries the unit of the Y axis. Parameter Name —— Type Keyword Range DBM|DBMV|DBUV|V|W Default Refer to "Remarks" Remarks The default log unit is dBm. The default linear unit is V. Return Format The query returns DBM, DBMV, DBUV, V, or W. Example The following command sets the amplitude unit to Watts.
PAGE 230
PAGE 231
Chapter 3 Programming Examples RIGOL Chapter 3 Programming Examples This chapter lists some programming examples to illustrate how to use commands to realize the common functions of the spectrum analyzer in the development environments such as Visual C++ 6.0, Visual Basic 6.0, and LabVIEW 2010. Also, the chapter lists some examples to illustrate how to control the spectrum analyzer to realize the common functions in Linux operating system. These examples are programmed based on NI-VISA library.
PAGE 232
RIGOL Chapter 3 Programming Examples Programming Instructions This section introduces the problems that might occur during the programming process as well as their solutions. If these problems occur, please resolve them according to the corresponding instructions. 1. When you build a working environment via the network, it is recommended that you build a pure local area network. 2. If the local area network environment is complicated (e.g.
PAGE 233
Chapter 3 Programming Examples RIGOL Visual C++ 6.0 Programming Example Enter the Visual C++6.0 programming environment, and perform the following procedures. 1. Create a MFC project based on a dialog box and name it "DemoForRSA" in this example. 2. Click Project  Settings to open the "Project Setting" dialog box. In the dialog box, click the Link tab, add "visa32.lib" under Object/library modules, then click OK to close the dialog box. 3. Click Tools  Options to open the "Options" dialog box.
PAGE 234
RIGOL Chapter 3 Programming Examples By now, VISA library has been added. 4. Add the Text, Edit, and Button controls, as shown in the figure below. 5. Add the control variables. Click View  ClassWizard, and then click the Member Variables tab to add the following three variables: Address CString m_strInstrAddr Command CString m_strCommand Return CString m_strResult 6. Encapsulate the read and write operations of VISA. 1) Encapsulate the write operation of VISA for easier operation.
PAGE 235
Chapter 3 Programming Examples RIGOL // Change the address's data style from CString to char* SendAddr = strAddr.GetBuffer(strAddr.GetLength()); strcpy(SendAddr,strAddr); strAddr.ReleaseBuffer(); // Change the command's data style from CString to char* SendBuf = strContent.GetBuffer(strContent.GetLength()); strcpy(SendBuf,strContent); strContent.
PAGE 236
RIGOL Chapter 3 Programming Examples //Open the instrument status = viOpen(defaultRM, SendAddr, VI_NULL, VI_NULL, &instr); //Read from the instrument status = viRead(instr, RecBuf, MAX_REC_SIZE, &retCount); //Close the system status = viClose(instr); status = viClose(defaultRM); (*pstrResult).Format("%s",RecBuf); } 3) return bReadOK; Encapsulate the read operation with exception handling function of VISA.
PAGE 237
Chapter 3 Programming Examples RIGOL return status; } bool CDemoForRSADlg::InstrWriteEx(CString strAddr, CString strContent) //Write operation with exception handling { ViStatus status; ViUInt32 retCount; char * SendBuf = NULL; bool bWriteOK = true; // Change the address's data style from CString to char* SendBuf = strContent.GetBuffer(strContent.GetLength()); strcpy(SendBuf,strContent); strContent.
PAGE 238
RIGOL Chapter 3 Programming Examples unsigned char RecBuf[MAX_REC_SIZE]; bool bReadOK = true; // Change the address's data style from CString to char* SendAddr = strAddr.GetBuffer(strAddr.GetLength()); strcpy(SendAddr,strAddr); strAddr.
PAGE 239
Chapter 3 Programming Examples RIGOL bool bFindRSA = false; status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { // Error Initializing VISA...exiting MessageBox("No VISA instrument was opened ! "); return ; } memset(instrDesc,0,1000); // Find resource status = viFindRsrc(defaultRM,expr,findList, retcnt, instrDesc); for (i = 0;i < (*retcnt);i++) { // Get instrument name strSrc.
PAGE 240
RIGOL Chapter 3 Programming Examples { } 8. void CDemoForRSADlg::OnBtRead() //Read operation //TODO: Add your control notification handler code here UpdateData(true); InstrRead(m_strInstrAddr,&m_strResult); UpdateData(false); Run the results. 1) Click Connect to search for the spectrum analyzer; 2) Input "*IDN?" in the "Command" edit box; 3) Click Write to write the command into the spectrum analyzer; 4) Click Read to read the return value. The execution result is as shown in the figure below.
PAGE 241
Chapter 3 Programming Examples RIGOL Visual Basic 6.0 Programming Example Enter the Visual Basic 6.0 programming environment, and perform the following procedures. 1. Build a standard application program project (Standard EXE), and name it "DemoForRSA". 2. Open Project  Add File…. Search for the visa32.bas file from the include folder in the installation path of NI-VISA, and then add the file to the project. The visa32.bas module contains all VISA functions and constant statements.
PAGE 242
RIGOL Chapter 3 Programming Examples Dim rSize As Long 'Initialize the system status = viOpenDefaultRM(dfltRM) 'Failed to initialize the system If (status < VI_SUCCESS) Then MsgBox " No VISA resource was opened！" Exit Sub End If 'Open the VISA instrument status = viOpen(dfltRM, rsrcName, VI_NULL, VI_NULL, sesn) 'Failed to open the instrument If (status < VI_SUCCESS) Then MsgBox "Failed to open the instrument！" Exit Sub End If 'Write command to the instrument status = viWrite(sesn, strCmd, Len(strCmd), rSi
PAGE 243
Chapter 3 Programming Examples RIGOL MsgBox " Failed to open the instrument! " Exit Function End If 'Read from the instrument stasus = viRead(sesn, strTemp0, 256, rSize) 'Reading failed If (status < VI_SUCCESS) Then MsgBox " Failed to read from the instrument! " Exit Function End If 'Close the system status = viClose(sesn) status = viClose(dfltRM) 'Remove the space at the end of the string strTemp1 = Left(strTemp0, rSize) InstrRead = strTemp1 End Function 5. Add the control event codes.
PAGE 244
RIGOL Chapter 3 Programming Examples j = InStr(strRet, "RSA") If (j >= 0) Then bFindRSA = True Exit For End If Call viFindNext(fList + i - 1, rsrcName(i)) Next i 'Display If (bFindRSA = True) Then TxtInsAddr.Text = rsrcName(i) Else TxtInsAddr.Text = "" End If End Sub 2) Write Operation 'Write the command to the instrument Private Sub CmdWrite_Click() If (TxtInsAddr.Text = "") Then MsgBox ("Please write the instrument address！") End If InstrWrite TxtInsAddr.Text, TxtCommand.Text End Sub 3) 6.
PAGE 245
Chapter 3 Programming Examples RIGOL LabVIEW 2010 Programming Example Enter the Labview 2010 programming environment, and perform the following procedures. 1. Create a VI file, and name it "DemoForRSA". 2. Add controls to the front panel interface, including the Address field, Command field, and Return field, the Connect button, the Write button, the Read button, and the Exit button. 3. Click Show Block Diagram under the Window menu to create an event structure. 4.
PAGE 246
RIGOL 2) 3-16 Chapter 3 Programming Examples Write operation (including error confirmation) RSA3000 Programming Guide
PAGE 247
Chapter 3 Programming Examples 3) RIGOL Read operation (including error correction advice) RSA3000 Programming Guide 3-17
PAGE 248
RIGOL 3-18 Chapter 3 Programming Examples 4) Exit 5) Run the program, and then the following interface is displayed below. Click the VISA resource name from the drop-down list under Address, and click Connect to connect the instrument. Then, input a command in the Command field. Click Write to write the command to the instrument. If the command is a query (e.g.*IDN?), click Write to write the command into the instrument, and then click Read. The return value is displayed in the Return field.
PAGE 249
Chapter 3 Programming Examples RIGOL exit the program. Linux Programming Example This section illustrates how to program and control the spectrum analyzer to realize the common functions in Linux operating system. Programming Preparations 1. Programming environment: Operating system: Fedroa 8 (Linux-2.6.23) GCC version: gcc-4.1.2 2. Install the VISA library. First, check whether your PC has installed NI's VISA library. If not, download it from NI website (http://www.ni.com/visa/).
PAGE 250
RIGOL Chapter 3 Programming Examples For example, if the network address and DNS setting configured for the PC are as shown in the figures below, then, the network address of the spectrum analyzer should be configured as follows. IP Address: 172.16.3.X* Default Gateway: 172.16.3.1 Subnet Mask: 255.255.255.0 DNS: 172.16.2.2 Note*: X can be any value not in use from 2 to 254.
PAGE 251
Chapter 3 Programming Examples 4. RIGOL Use either of the following two methods to add the library location to the search path of the library, so that the program can load the installed library file automatically. Method 1: Specify the search path of the library in the environment variable LD_LIBRARY_PATH. Operation Method: Add the library file path /usr/local/lib to the LD_LIBRARY_PATH variable in the /etc/profile file, as shown in the figure below.
PAGE 252
RIGOL Chapter 3 Programming Examples Linux Programming Procedures 1. Edit the DemoForRSA.h header file and declare a class to encapsulate the operation and property of the instrument. #ifndef DEMO_FOR_RSA_H #define DEMO_FOR_RSA_H #include #include #include #include //#include
PAGE 253
Chapter 3 Programming Examples RIGOL string strInstr = ""; ViChar instrDesc[1000]; unsigned long i = 0; bool bFindRSA = false; memset(instrDesc,0,1000); //Turn on the VISA device status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { cout<<"No VISA equipment!"<
PAGE 254
RIGOL Chapter 3 Programming Examples string str; //Address conversion, convert the string type to char* SendAddr = const_cast(strAddr.c_str()); //Address conversion, convert the string type to char* SendBuf = const_cast(strContent.
PAGE 255
Chapter 3 Programming Examples RIGOL status = viRead(instr, RecBuf, MAX_REC_SIZE, &retCount); //Turn off the device status = viClose(instr); status = viClose(defaultRM); sprintf(result,"%s",RecBuf); pstrResult = result; free(result); return bReadOK; } void makeupper( string &instr) { string outstr = ""; if(instr == "") { exit(0); } for(int i = 0;i < instr.length();i++) { instr[i] = toupper(instr[i]); } } 3. Edit the function file mainloop.cpp to complete the flow control. #include "DemoForRSA.
PAGE 256
RIGOL Chapter 3 Programming Examples && demo.m_strCommand[2]='a' && demo.m_strCommand[3]='d') { //demo.InstrWrite(demo.m_strInstrAddr,"*IDN?"); //demo.InstrRead(demo.m_strInstrAddr,demo.m_strResult); cout<<"read result:"<
PAGE 257
Chapter 3 Programming Examples RIGOL rm demo $(obj) 5. Run 1) 2) 3) 4) 5) the results. #make ./demo When the program runs, the instrument is connected automatically. If no instrument is found, a prompt message "No VISA equipment!" is displayed, and the system exits the program. If the instrument is found and successfully connected, the following interface is displayed, as shown in the figure below. Input write (for example, write<*IDN?>) to write the command into the spectrum analyzer.
PAGE 258
PAGE 259
RIGOL Chapter 4 Appendix Chapter 4 Appendix Appendix A: Default Settings Sending the *RST command can restore the instrument to default settings, as shown in the table below.
PAGE 260
RIGOL Trigger Criteria Active Mask Frequency Amplitude Build From Trace X Offset Y Offset X Axis Type Y Axis Type Trace Selected Trace Trace Type Trace Det Detector Auto Trace Update Trace Display Math Function Op1 Op2 Offset Reference TG[1] Output Amplitude Amplitude Offset Normalize Reference Level Reference Position Reference Trace Mode Measurement Mode Mode Setup Global CF Mode Meas Measurement Function Chapter 4 Appendix ---------- Enter Upper 0 Hz -100 dBm Trace1 0 Hz 0 dB Fixed Fixed Trace1 Clea
PAGE 261
RIGOL Chapter 4 Appendix Limit Type X To CF Y To Ref Margin Test Trace Test Limits Limit State T-Power[2] Avg Number Avg Mode Avg State TP Type Start Line Stop Line ACP[2] Avg Number Avg Mode Avg State Main Chan BW Adj Chan BW Chan Spacing Multichan Pwr[2] Avg Number Avg Mode Avg State Channel Span Channel Sheet Channel Freq Occupied BW[2] Avg Number Avg Mode Avg State Max Hold OBW Span Power Ratio Emission BW[2] Avg Number Avg Mode Avg State Max Hold EBW Span EBW X dB C/N Ratio[2] Avg Number Avg Mode Avg
PAGE 262
RIGOL TOI[2] Avg Number Avg Mode Avg State TOI Span Measure Setup(RTSA) Normal Avg Number Test Limits Select Limit Limit State Test Trace Limit Type X to CF Y to Ref Margin Frequency Amplitude Build From Trace X Offset Y Offset Density Avg Number Persistence Pers Inf Color Palettes Highest Density Hue Lowest Density Hue Curve Nonlinearity Hue Truncate Spectrogram Avg Number Display Trace Trace Selection Couple Marker Trace Ref Hue Ref Hue Pos Bottom Hue Pos SSC Max Hold Mark Line1 Mark Line2 Pass/Fail Sign
PAGE 263
RIGOL Chapter 4 Appendix Couple Markers Marker Table Peak Cont Peak Pk-Pk Search Peak Threshold Peak Excursion Threshold Line Peak Table Peak Table Sort Table Readout Marker Func N dB Bandwidth Band Function Marker Counter Gate Time System[3] Power On Preset Type Align Auto LAN Setting Mode Display Line Graticule HDMI HDMI Resolution LCD LCD Backlight Power Switch Beep Switch User key Language Off Off Off Off Off Maximum Value On, -90 dBm On, 6 dB Off Off Amplitude All Off Maximum Value On, -90 dBm On
PAGE 264
RIGOL Chapter 4 Appendix Appendix B: Warranty RIGOL TECHNOLOGIES, INC. (hereinafter referred to as RIGOL) warrants that the product will be free from defects in materials and workmanship within the warranty period. If a product proves defective within the warranty period, RIGOL guarantees free replacement or repair for the defective product. To get repair service, please contact with your nearest RIGOL sales or service office.