Instructions

ManualsBrandsRigol ManualsLaboratory EquipmentRigol RSA3030E-TG Spectrum analyzer Manufacturer's standards (no certificate) 3 GHz

Programming Guide

RSA3000E Series Real-time

Spectrum Analyzer

Aug. 2019

RIGOL (SUZHOU) TECHNOLOGIES INC.

Summary of content (459 pages)

PAGE 1
Programming Guide RSA3000E Series Real-time Spectrum Analyzer Aug. 2019 RIGOL (SUZHOU) TECHNOLOGIES INC.
PAGE 2
PAGE 3
RIGOL Guaranty and Declaration Copyright © 2019 RIGOL (SUZHOU) TECHNOLOGIES INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES INC. Publication Number PGD24100-1110 Software Version 00.01.00 Software upgrade might change or add product features. Please acquire the latest version of the manual from RIGOL website or contact RIGOL to upgrade the software. Notices       RIGOL products are covered by P.R.C.
PAGE 4
RIGOL Document Overview This manual introduces how to program and control RIGOL RSA3000E series spectrum analyzer by using SCPI commands through USB and LAN interface. Main Topics in this Manual: Chapter 1 Programming Overview This chapter introduces how to set up remote communication between the spectrum analyzer and the PC, the remote control methods, the syntax, symbols, parameters, and abbreviation rules of the SCPI commands.
PAGE 5
RIGOL Model RSA3030E RSA3015E RSA3030E-TG RSA3015E-TG RSA3000E Programming Guide Frequency Range 9 kHz to 3 GHz 9 kHz to 1.5 GHz 9 kHz to 3 GHz 9 kHz to 1.5 GHz Tracking Generator None None 3 GHz 1.
PAGE 6
RIGOL Contents Contents Guaranty and Declaration.......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 Programming Overview ..................................................................................... 1-1 Build Remote Communication ......................................................................
PAGE 7
Contents RIGOL :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 8
RIGOL Contents :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle ......................................................... 2-51 :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:PDIVision ...................................................... 2-51 :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RLEVel .......................................................... 2-52 :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RPOSition ..................................................... 2-52 :DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:PDIVision ..........
PAGE 9
Contents RIGOL *ESE ............................................................................................................................... 2-82 *ESR? ............................................................................................................................. 2-83 *IDN? ............................................................................................................................. 2-83 *OPC...............................................................................
PAGE 10
RIGOL Contents :READ:OBWidth:OBWidth:FERRor? .................................................................................. 2-106 :READ:SANalyzer?.................................................................................................... 2-107 :READ:TOIntercept? ....................................................................................................... 2-107 :READ:TOIntercept:IP3? .................................................................................................
PAGE 11
RIGOL Contents [:SENSe]:EBWidth:AVERage[:STATe] ............................................................................... 2-139 [:SENSe]:EBWidth:AVERage:TCONtrol ............................................................................. 2-139 [:SENSe]:EBWidth:FREQuency:SPAN ............................................................................... 2-140 [:SENSe]:EBWidth:MAXHold:STATe .................................................................................
PAGE 12
RIGOL Contents [:SENSe]:SIGCapture:2FSK:PFSWitch[:STATe] .................................................................. 2-167 [:SENSe]:SIGCapture:2FSK:RESet ................................................................................... 2-167 [:SENSe]:SIGCapture:2FSK:SIGNal .................................................................................. 2-168 [:SENSe]:SWEep:POINts .................................................................................................
PAGE 13
Contents RIGOL :SYSTem:PRESet:TYPE ................................................................................................... 2-195 :SYSTem:PRESet:USER:SAVE .......................................................................................... 2-196 :SYSTem:SCPI:DISPlay ................................................................................................... 2-196 :SYSTem:SECurity:CLEar ................................................................................................
PAGE 14
RIGOL Contents :CALCulate:FSCan:MARKer:PEAK:EXCursion:STATe ............................................................... 3-5 :CALCulate:FSCan:MARKer:PEAK:SEARch:MODE .................................................................. 3-6 :CALCulate:FSCan:MARKer:PEAK:SEARch:THReshold ............................................................ 3-7 :CALCulate:FSCan:MARKer:PEAK:SEARch:THReshold:STATe .................................................. 3-7 :CALCulate:FSCan:MARker:FUNCtion:MAMarker? ......
PAGE 15
Contents RIGOL :CALibration Commands .......................................................................................................... 3-31 :CALibration:[ALL] ............................................................................................................ 3-31 :CALibration:AUTO ........................................................................................................... 3-31 :COUPle Command .................................................................................
PAGE 16
RIGOL Contents :MMEMory:STORe:STATe ................................................................................................... 3-57 :MMEMory:STORe:TRACe .................................................................................................. 3-58 :MMEMory:STORe:TRACe:DATA ......................................................................................... 3-58 [:SENSe] Commands .........................................................................................................
PAGE 17
Contents RIGOL [:SENSe]:METer:PHOLd:TYPE ........................................................................................... 3-87 [:SENSe]:METer:DETector ......................................................................................... 3-88 [:SENSe]:POWer[:RF]:ATTenuation ................................................................................... 3-88 [:SENSe]:POWer[:RF]:GAIN[:STATe] .................................................................................
PAGE 18
RIGOL Contents :DISPlay:BACKlight ........................................................................................................... 4-19 :DISPlay:DDEMod:TRACe:DDEMod:EYE:COUNt ........................................................... 4-19 :DISPlay:DDEMod:TRACe:DDEMod:SYMBol:FORMat .................................................... 4-20 :DISPlay:DDEMod:TRACe:FEED .................................................................................. 4-20 :DISPlay:DDEMod:TRACe:FORMat ..
PAGE 19
Contents RIGOL [:SENSe]:DDEMod:RTTrace:DETector ............................................................................... 4-48 [:SENSe]:DDEMod:SRATe ................................................................................................. 4-48 [:SENSe]:DDEMod:STANdard:PRESet ................................................................................ 4-49 [:SENSe]:DDEMod:SWEep:POINts ....................................................................................
PAGE 20
PAGE 21
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 22
RIGOL Chapter 1 Programming Overview Build Remote Communication RSA3000E 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 23
Chapter 1 Programming Overview RIGOL Remote Control Method 1. User-defined programming You can refer to the SCPI (Standard Commands for Programmable Instruments) commands listed in Chapter 2 in this manual to control RSA3000E by programming in LabVIEW, Visual C++, and other development environments. For details, refer to descriptions in Chapter 4 in this manual. 2. Send SCPI commands via the PC software You can use the PC software to send commands to control RSA3000E remotely.
PAGE 24
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 25
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 26
PAGE 27
Chapter 2 Command Systems for GPSA and RTSA Modes RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes This chapter introduces the commands of the RSA3000E series spectrum analyzer. Contents in this chapter:  :CALCulate Commands  :CALibration Commands  :CONFigure Commands  :COUPle Commands  :DISPlay Commands  :FETCh Commands  :FORMat Commands  IEEE 488.
PAGE 28
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :CALCulate Commands Command List:  :CALCulate:BANDwidth|BWIDth:NDB  :CALCulate:BANDwidth|BWIDth:RESult?  :CALCulate:BANDwidth|BWIDth:RLEFt?  :CALCulate:BANDwidth|BWIDth:RRIGht?  :CALCulate:BANDwidth|BWIDth [:STATe]  :CALCulate:LLINe:ALL:DELete  :CALCulate:LLINe:TEST  :CALCulate:LLINe:AMPLitude:CMODe:RELative  :CALCulate:LLINe:BUILd  :CALCulate:LLINe:COPY  :CALCulate:LLINe:DATA  :CALCulate:LLINe:DELete
PAGE 29
Chapter 2 Command Systems for GPSA and RTSA Modes  :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:MAR
PAGE 30
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 31
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 32
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 33
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 34
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 35
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 36
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 37
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 38
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 39
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 40
RIGOL Parameter Name Chapter 2 Command Systems for GPSA and RTSA Modes 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 41
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 command.
PAGE 42
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 43
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 44
RIGOL Parameter Name —— Chapter 2 Command Systems for GPSA and RTSA Modes 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 45
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 46
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 47
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 48
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 49
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 50
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 51
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 52
RIGOL Parameter Name Chapter 2 Command Systems for GPSA and RTSA Modes 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 53
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 54
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 55
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 56
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 57
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 58
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 59
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 60
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 61
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 62
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 63
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 64
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 65
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 66
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 67
Chapter 2 Command Systems for GPSA and RTSA Modes 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
PAGE 68
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 69
Chapter 2 Command Systems for GPSA and RTSA Modes 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 70
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 71
Chapter 2 Command Systems for GPSA and RTSA Modes 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 72
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 73
Chapter 2 Command Systems for GPSA and RTSA Modes 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 74
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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  :DISP
PAGE 75
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 76
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 77
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 78
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 79
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes "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 80
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 81
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 82
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 83
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 84
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 85
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 86
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 87
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 88
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 89
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 90
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 RSA3030E-TG/RSA3015E-TG working in GPSA mode.
PAGE 91
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 92
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 93
Chapter 2 Command Systems for GPSA and RTSA Modes 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:FUNDamen
PAGE 94
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 95
Chapter 2 Command Systems for GPSA and RTSA Modes 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 96
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 97
Chapter 2 Command Systems for GPSA and RTSA Modes 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 98
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 99
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 100
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 101
Chapter 2 Command Systems for GPSA and RTSA Modes 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 102
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 103
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 104
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 105
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 106
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 107
Chapter 2 Command Systems for GPSA and RTSA Modes 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 108
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes *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 109
Chapter 2 Command Systems for GPSA and RTSA Modes 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 110
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes *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 111
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes *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 112
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes *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.
PAGE 113
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 114
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 115
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 116
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :MMEMory Commands Command List:  :MMEMory:DELete  :MMEMory:LOAD:CORRection  :MMEMory:LOAD:FMT  :MMEMory:LOAD:LIMit  :MMEMory:LOAD:STATe  :MMEMory:LOAD:TRACe  :MMEMory:LOAD:TRACe:DATA  :MMEMory:MOVE  :MMEMory:STORe:CORRection  :MMEMory:STORe:LIMit  :MMEMory:STORe:MTABle  :MMEMory:STORe:PTABle  :MMEMory:STORe:RESults  :MMEMory:STORe:SCReen  :MMEMory:STORe:STATe  :MMEMory:STORe:TRACe  :MMEMory:STORe:TRACe:
PAGE 117
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :MMEMory:LOAD:CORRection Syntax :MMEMory:LOAD:CORRection 1|2|3|4, Description Loads the data from the specified file (suffixed with .csv) to carry out amplitude correction. Parameter Name - Type Discrete ASCII String Range 1|2|3|4 -- Default --- Remarks The parameter 1|2|3|4 corresponds to ANTenna|CABLe|OTHer|USER. This operation fails if the file with the specified filename does not exist.
PAGE 118
RIGOL Parameter Name Chapter 2 Command Systems for GPSA and RTSA Modes Type Keyword ASCII String Range LLINE1|LLINE2|LLINE3|LLINE4|LLINE5|LLINE6 —— Default —— —— Remarks This operation fails if the specified file does not exist. Example The following command imports the limit line file (upp1.csv) to Limit1. :MMEMory:LOAD:LIMit LLINE1,upp1.csv :MMEMory:LOAD:STATe Syntax :MMEMory:LOAD:STATe Description Imports the specified state file (.sta).
PAGE 119
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 120
RIGOL Parameter Name - Chapter 2 Command Systems for GPSA and RTSA Modes Type Discrete ASCII String Range 1|2|3|4 -- Default --- Remarks The parameter 1|2|3|4 corresponds to ANTenna|CABLe|OTHer|USER. If the specified file already exists, overwrite it. This command is only available for GPSA mode. Example The following command saves the amplitude correction data with the filename "ANT" to the folder (/gpsa/correction).
PAGE 121
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Example The following command saves the marker table with the specified filename "MAK1" to the folder (/gpsa/measdata). :MMEMory:STORe:MTABle MAK1 :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).
PAGE 122
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :MMEMory:STORe:SCReen Syntax :MMEMory:STORe:SCReen Description Saves the current screen image with the specified filename suffixed with ".jpg", ".png/", or ".bmp" to the default path (/"mode name"/screen). Parameter Name Type ASCII String Range —— Default —— Remarks If the specified file already exists, overwrite it. If a suffix (.jpg/.png/.
PAGE 123
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :MMEMory:STORe:TRACe Syntax :MMEMory:STORe:TRACe , Description Saves the specified trace+state file with filename suffixed with ".trs" to the default path (/"mode name"/tracestate). Parameter Name Type Range Keyword TRACE1|TRACE2|TRACE3|TRACE4|TRACE5|TRACE6 ASCII String —— Remarks If the specified file already exists, overwrite it.
PAGE 124
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :OUTPut Command 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 RSA3030E-TG/RSA3015E-TG working in GPSA mode.
PAGE 125
Chapter 2 Command Systems for GPSA and RTSA Modes 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 126
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 127
Chapter 2 Command Systems for GPSA and RTSA Modes 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.
PAGE 128
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 129
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 130
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 131
Chapter 2 Command Systems for GPSA and RTSA Modes 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 132
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 133
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 134
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 135
Chapter 2 Command Systems for GPSA and RTSA Modes 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:CURR
PAGE 136
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes  [:SENSe]:CORRection:CSET:DATA:MERGe  [:SENSe]:CORRection:CSET:DELete  [:SENSe]:CORRection:CSET[:STATe]  [:SENSe]:CORRection:CSET:X:SPACing  :INPut:IMPedance  [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]  [:SENSe]:CORRection:SA[:RF]:GAIN  [:SENSe]:DEMod  [:SENSe]:DEMod:GAIN:AUTO  [:SENSe]:DEMod:GAIN:INCRement  [:SENSe]:DEMod:STATe  [:SENSe]:DETector:TRACe:PVTime  [:SENSe]:DETector[:FUNCtion] 
PAGE 137
Chapter 2 Command Systems for GPSA and RTSA Modes  [:SENSe]:FREQuency:TUNE:IMMediate  [:SENSe]:HDISt:AVERage:COUNt*  [:SENSe]:HDISt:AVERage[:STATe]*  [:SENSe]:HDISt:AVERage:TCONtrol*  [:SENSe]:HDISt:NUMBers*  [:SENSe]:HDISt:TIME*  [:SENSe]:MCHPower:AVERage:COUNt*  [:SENSe]:MCHPower:AVERage[:STATe]*  [:SENSe]:MCHPower:AVERage:TCONtrol*  [:SENSe]:MCHPower:FREQuency:CENTer*  [:SENSe]:MCHPower:CHAnnel:ADD*  [:SENSe]:MCHPower:CHAnnel:DELete*  [:SENSe]:MCHPower:CHAnnel:DELet
PAGE 138
RIGOL  [:SENSe]:SWEep:TIME  [:SENSe]:SWEep:TIME:AUTO  [:SENSe]:SWEep:TIME:AUTO:RULes  [:SENSe]:TOI:AVERage:COUNt*  [:SENSe]:TOI:AVERage[:STATe]*  [:SENSe]:TOI:AVERage:TCONtrol*  [:SENSe]:TOI:FREQuency:SPAN*  [:SENSe]:TPOWer:AVERage:COUNt*  [:SENSe]:TPOWer:AVERage[:STATe]*  [:SENSe]:TPOWer:AVERage:TCONtrol*  [:SENSe]:TPOWer:LLIMit*  [:SENSe]:TPOWer:MODE*  [:SENSe]:TPOWer:RLIMit*  [:SENSe]:VSWR:FREFlect**  [:SENSe]:VSWR:NREFlect**  [:SENSe]:VSWR:RESet**  [:SE
PAGE 139
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [: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.
PAGE 140
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [: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 141
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 142
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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. :SENSe:ACPower:CSPacing? [:SENSe]:ACQuisition:TIME Syntax [:SENSe]:ACQuisition:TIME [:SENSe]:ACQuisition:TIME? Description Sets the acquisition time for producing one single trace or one bitmap. The unit is s.
PAGE 143
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 144
RIGOL Parameter Name —— Chapter 2 Command Systems for GPSA and RTSA Modes 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. Return Format The query returns 0 or 1. Example The following command enables the auto acquisition time for producing all the traces. :SENSe:ACQuisition:TIME:PVTime:AUTO ON or :SENSe:ACQuisition:TIME:PVTime:AUTO 1 The following query returns 1.
PAGE 145
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [: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 146
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [: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 147
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 148
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 149
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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. Example The following command enables the auto setting mode of RBW. :SENSe:BANDwidth:RESolution:SELect:AUTO:STATe ON or :SENSe:BANDwidth:RESolution:SELect:AUTO:STATe 1 :SENSe:BWIDth:RESolution:SELect:AUTO:STATe ON or :SENSe:BWIDth:RESolution:SELect:AUTO:STATe 1 The following query returns 1.
PAGE 150
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [: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. Return Format The query returns the video bandwidth in scientific notation. Its unit is Hz.
PAGE 151
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes The following query returns 1. :SENSe:BANDwidth:VIDeo:AUTO? :SENSe:BWIDth:VIDeo:AUTO? [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio Syntax [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio? Description Sets the V/R ratio, that is, the ratio of VBW to RBW. Queries the V/R ratio. Parameter Name Type Discrete Range 0.
PAGE 152
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Example The following command enables the auto setting mode of V/R ratio. :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 153
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Remarks This command is only valid when the C/N ratio measurement in GPSA mode is enabled. Return Format The query returns 0 or 1. Example The following command enables the average measurement function. :SENSe:CNRatio:AVERage:STATe 1 or :SENSe:CNRatio:AVERage:STATe ON The following query returns 1.
PAGE 154
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:CNRatio:BANDwidth:INTegration Syntax [:SENSe]:CNRatio:BANDwidth:INTegration [:SENSe]:CNRatio:BANDwidth:INTegration? Description Sets the carrier bandwidth. Queries the carrier bandwidth. Parameter Name Type Consecutive Real Number Range 3 Hz to 1 GHz Default 2 MHz Remarks This command is only valid when the C/N ratio measurement in GPSA mode is enabled. The carrier bandwidth is correlated with the noise bandwidth.
PAGE 155
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes The following query returns 1000000. :SENSe:CNRatio:BANDwidth:NOISe? [:SENSe]:CNRatio:OFFSet Syntax [:SENSe]:CNRatio:OFFSet [:SENSe]:CNRatio:OFFSet? Description Sets the center frequency difference (offset frequency) between the carrier waveform and the noise. Queries the offset frequency.
PAGE 156
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Parameter Name -- Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for GPSA mode. When the function is disabled, settings for all the corrections are disabled. When the function is enabled, settings for all the corrections are enabled, and the "Antenna" correction is enabled by default. To enable or disable settings for each correction, refer to the [:SENSe]:CORRection:CSET[:STATe] command.
PAGE 157
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:CORRection:CSET:DATA:MERGe Syntax [:SENSe]:CORRection:CSET:DATA:MERGe ,,{,} Description Adds correction data to the current correction curve. Parameter Name Type Discrete Consecutive Real Number Consecutive Real Number Range 1|2|3|4 0 Hz to 3 GHz -120 dBm to +100 dBm Default ---- Remarks This command is only available for GPSA mode.
PAGE 158
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:CORRection:CSET[:STATe] Syntax [:SENSe]:CORRection:CSET[:STATe] OFF|ON|0|1 [:SENSe]:CORRection:CSET[:STATe]? Description Enables or disables the specified amplitude correction function. Queries the status of the specified amplitude correction function. Parameter Name -- Type Discrete Bool Range 1|2|3|4 OFF|ON|0|1 Default -OFF|0 Remarks This command is only available for GPSA mode.
PAGE 159
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Example The following command sets the frequency interpolation mode to LINear. :SENSe:CORRection:CSET1:X:SPACing LINear The following query returns LIN.
PAGE 160
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Return Format The query returns the external gain value in scientific notation. The unit is dB. Example The following command set the external gain value to 20 dB. :SENSe:CORRection:SA:RF:GAIN 20 The following query returns 2.000000000e+01. :SENSe:CORRection:SA:RF:GAIN? [:SENSe]:DEMod Syntax [:SENSe]:DEMod AM|FM|OFF [:SENSe]:DEMod? Description Sets the demodulation type or disables the demodulation. Queries the demodulation type.
PAGE 161
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Remarks This command is only valid when the demodulation function (i.g. AM or FM is selected to be the demodulation type) in GPSA mode is enabled. Return Format The query returns 0 or 1. 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.
PAGE 162
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:DEMod:STATe Syntax [:SENSe]:DEMod:STATe OFF|ON|0|1 [:SENSe]:DEMod:STATe? Description Enables or disables the demodulation function. Queries the status of the demodulation function. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks When the demodulation function is enabled, the analyzer selects AM as the demodulation type by default. This command is only available for GPSA mode. Return Format The query returns 0 or 1.
PAGE 163
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Example The following command sets the trace detector type to Positive. :SENSe:DETector:TRACe:PVTime POSitive The following query returns POS.
PAGE 164
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [: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.
PAGE 165
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [: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.
PAGE 166
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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.
PAGE 167
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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. :SENSe:EBWidth:MAXHold:STATe ON or :SENSe:EBWidth:MAXHold:STATe 1 The following query returns 1.
PAGE 168
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Parameter Name Type Integer Range 0 to (131072 or set maximum capture length, whichever is smaller) Default 1024 Remarks This command is only available for RTSA mode. Return Format The query returns the IQ capture data length acquired from the instrument each time. Example The following command sets the IQ capture data length acquired from the instrument each time. :SENSe:FCAPture:BLOCk 100 The following query returns 100.
PAGE 169
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:FCAPture:POINter Syntax [:SENSe]:FCAPture:POINter [:SENSe]:FCAPture:POINter? Description Sets the current position pointer of the IQ data capture. Queries the current position pointer of the IQ data capture. Parameter Name Type Integer Range 0 to (a value smaller than the maximum capture length) Default 0 Remarks This command is only available for RTSA mode.
PAGE 170
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Remarks This command is only available for RTSA mode. [:SENSe]:INITiate:FCAPture Syntax [:SENSe]:INITiate:FCAPture Description Initiates the IQ capture. Remarks This command is only available for RTSA mode. [:SENSe]:FREQuency:CENTer Syntax [:SENSe]:FREQuency:CENTer [:SENSe]:FREQuency:CENTer? Description Sets the center frequency. Queries the center frequency.
PAGE 171
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:FREQuency:CENTer:STEP:AUTO Syntax [:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1 [:SENSe]:FREQuency:CENTer:STEP:AUTO? Description Enables or disables the auto setting mode of the CF step. Queries the status of the auto setting mode of the CF step. 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 the auto setting mode of the CF step.
PAGE 172
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:FREQuency:OFFSet Syntax [:SENSe]:FREQuency:OFFSet [:SENSe]:FREQuency:OFFSet? Description Sets the frequency offset. Queries the frequency offset. Parameter Name Type Consecutive Real Number Range -500 GHz to 500 GHz Default 0 Hz Remarks The change of this parameter only changes the display values of the center frequency, start frequency, and stop frequency; but does not affect any hardware settings of the spectrum analyzer.
PAGE 173
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :SENSe:FREQuency:SPAN 20000000 The following query returns 2.000000000e+07. :SENSe:FREQuency:SPAN? [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio Syntax [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio? Description Sets the ratio of span to RBW. Queries the ratio of span to RBW.
PAGE 174
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Example The following command enables the auto setting mode of span/bandwidth ratio. :SENSe:FREQuency:SPAN:BANDwidth:RESolution:RATio:AUTO ON or :SENSe:FREQuency:SPAN:BANDwidth:RESolution:RATio:AUTO 1 The following query returns 1. :SENSe:FREQuency:SPAN:BANDwidth:RESolution:RATio:AUTO? [:SENSe]:FREQuency:SPAN:FULL Syntax [:SENSe]:FREQuency:SPAN:FULL Description Sets the maximum span (full span).
PAGE 175
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Parameter Name Type Consecutive Real Number GPSA mode RTSA mode Range 0 Hz to Fmax (zero span) 0 Hz to (Fmax - 10 Hz) (non-zero span) 0 Hz to (Fmax - 5 kHz) Default center frequency-span/2 Return Format The query returns the start frequency in scientific notation. The unit is Hz. Example The following command sets the start frequency to 100 MHz. :SENSe:FREQuency:STARt 100000000 The following query returns 1.000000000e+08.
PAGE 176
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Remarks This command is invalid when the advance measurement function (AMK) is enabled in GPSA mode or when in RTSA mode. [:SENSe]:HDISt:AVERage:COUNt Syntax [:SENSe]:HDISt:AVERage:COUNt [:SENSe]:HDISt:AVERage:COUNt? Description Sets the average count of the harmonic distortion measurement. Queries the average count of the harmonic distortion measurement.
PAGE 177
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Example The following command enables the average measurement function. :SENSe:HDISt:AVERage:STATe ON or :SENSe:HDISt:AVERage:STATe 1 The following query returns 1. :SENSe:HDISt:AVERage:STATe? [: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.
PAGE 178
RIGOL Parameter Name Chapter 2 Command Systems for GPSA and RTSA Modes Type Integer Range 2 to 10 Default 10 Remarks This command is only valid when the harmonic distortion measurement in GPSA mode is enabled. Return Format The query returns the number of harmonics in integer. Example The following command sets the number of harmonics to 5. :SENSe:HDISt:NUMBers 5 The following query returns 5.
PAGE 179
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:MCHPower:AVERage:COUNt Syntax [:SENSe]:MCHPower:AVERage:COUNt [:SENSe]:MCHPower:AVERage:COUNt? Description Sets the average count of the multi-channel power measurement. Queries the average count of the multi-channel power measurement. Parameter Name Type Integer Range 1 to 1,000 Default 10 Remarks This command is only valid when the multi-channel power measurement in GPSA mode is enabled.
PAGE 180
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:MCHPower:AVERage:TCONtrol Syntax [:SENSe]:MCHPower:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:MCHPower:AVERage:TCONtrol? Description Selects the average mode of the multi-channel power measurement. Queries the average mode of the multi-channel power measurement. Parameter Name —— Type Keyword Range EXPonential|REPeat Default EXPonential Remarks EXPonential: indicates the exponential average. REPeat: indicates the repeat average.
PAGE 181
Chapter 2 Command Systems for GPSA and RTSA Modes RIGOL Example The following command sets the center frequency of the selected channel to 1 MHz. :SENSe:CHPower:FREQuency:CENTer 1000000 The following query returns 1.000000000e+06. :SENSe:CHPower:FREQuency:CENTer? [:SENSe]:MCHPower:CHAnnel:ADD Syntax [:SENSe]:MCHPower:CHAnnel:ADD Description Adds a channel to the channel editing table. Remarks This command is only valid when the multi-channel power measurement is enabled in GPSA mode.
PAGE 182
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:MCHPower:FREQuency:SPAN Syntax [:SENSe]:MCHPower:FREQuency:SPAN [:SENSe]:MCHPower:FREQuency:SPAN? Description Sets the channel span of the multi-channel power measurement. Queries the channel span of the multi-channel power measurement.
PAGE 183
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:OBWidth:AVERage:COUNt Syntax [:SENSe]:OBWidth:AVERage:COUNt [:SENSe]:OBWidth:AVERage:COUNt? Description Sets the average count of the occupied bandwidth measurement. Queries the average count of the occupied bandwidth measurement. Parameter Name Type Integer Range 1 to 1,000 Default 10 Remarks This command is only valid when the occupied bandwidth measurement in GPSA mode is enabled.
PAGE 184
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:OBWidth:AVERage:TCONtrol Syntax [:SENSe]:OBWidth:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:OBWidth:AVERage:TCONtrol? Description Selects the average mode of the occupied bandwidth measurement. Queries the average mode of the occupied bandwidth measurement. Parameter Name —— Type Keyword Range EXPonential|REPeat Default EXPonential Remarks EXPonential: indicates the exponential average. REPeat: indicates the repeat average.
PAGE 185
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Example The following command sets the span to 1 MHz. :SENSe:OBWidth:FREQuency:SPAN 1000000 The following query returns 1.000000000e+06. :SENSe:OBWidth:FREQuency:SPAN? [:SENSe]:OBWidth:MAXHold:STATe Syntax [:SENSe]:OBWidth:MAXHold:STATe OFF|ON|0|1 [:SENSe]:OBWidth:MAXHold:STATe? Description Enables or disables Max Hold of the occupied bandwidth measurement. Queries the Max Hold state of the occupied bandwidth measurement.
PAGE 186
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Remarks This command is only valid when the occupied bandwidth measurement in GPSA mode is enabled. The range of is from 1 to 99.99. Therefore, set the range of the corresponding parameter for the analyzer to "1%-99.99%". Return Format The query returns the percentage in scientific notation. Example The following command sets the power ratio to 90%. :SENSe:OBWidth:PERCent 90 The following query returns 9.000000000e+01.
PAGE 187
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Return Format The query returns 0 or 1. Example The following command disables the auto setting mode of the input attenuation. :SENSe:POWer:RF:ATTenuation:AUTO OFF or :SENSe:POWer:RF:ATTenuation:AUTO 0 The following query returns 0. :SENSe:POWer:RF:ATTenuation:AUTO? [:SENSe]:POWer[:RF]:GAIN[:STATe] Syntax [:SENSe]:POWer[:RF]:GAIN[:STATe] OFF|ON|0|1 [:SENSe]:POWer[:RF]:GAIN[:STATe]? Description Enable or disable the preamplifier.
PAGE 188
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Example The following command sets the maximum power of the input mixer to -20 dBm. :SENSe:POWer:RF:MIXer:RANGe:UPPer -20 The following query returns -2.000000000e+01. :SENSe:POWer:RF:MIXer:RANGe:UPPer? [:SENSe]:SIGCapture:2FSK:AMPDown Syntax [:SENSe]:SIGCapture:2FSK:AMPDown [:SENSe]:SIGCapture:2FSK:AMPDown? Description Sets the lower limit of the amplitude of 2FSK signal. Queries the lower limit of the amplitude of 2FSK signal.
PAGE 189
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Return Format The query returns the amplitude upper limit in scientific notation. Example The following command sets the amplitude upper limit to -20 dBm. :SENSe:SIGCapture:2FSK:AMPUp -20 The following query returns -2.000000000e+01. :SENSe:SIGCapture:2FSK:AMPUp? [:SENSe]:SIGCapture:2FSK:MARK1:FREQ Syntax [:SENSe]:SIGCapture:2FSK:MARK1:FREQ [:SENSe]:SIGCapture:2FSK:MARK1:FREQ? Description Sets the frequency value at Marker 1.
PAGE 190
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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. Example The following command enables Marker 1. :SENSe:SIGCapture:2FSK:MARK1:SWitch:STATe ON or :SENSe:SIGCapture:2FSK:MARK1:SWitch:STATe 1 The following query returns 1.
PAGE 191
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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. Example The following command enables Marker 2. :SENSe:SIGCapture:2FSK:MARK2:SWitch:STATe ON or :SENSe:SIGCapture:2FSK:MARK2:SWitch:STATe 1 The following query returns 1.
PAGE 192
RIGOL Parameter Name Chapter 2 Command Systems for GPSA and RTSA Modes 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. Example The following command queries the amplitude of the nth peak in the SSC measurement results, and returns 1.960000000e+01.
PAGE 193
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Return Format The query returns PASS or FAIL. Example The following query returns PASS. :SENSe:SIGCapture:2FSK:PF? [:SENSe]:SIGCapture:2FSK:PFSWitch[:STATe] Syntax [:SENSe]:SIGCapture:2FSK:PFSWitch[:STATe] OFF|ON|0|1 [:SENSe]:SIGCapture:2FSK:PFSWitch[:STATe]? Description Enables or disables the Pass/Fail function. Queries the on/off status of the Pass/Fail function.
PAGE 194
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:SIGCapture:2FSK:SIGNal Syntax [:SENSe]:SIGCapture:2FSK:SIGNal 0|1|2 [:SENSe]:SIGCapture:2FSK:SIGNal? Description Selects the signal whose Limit value is required to be modified in the pass/fail test. Queries the signal whose Limit value is required to be modified in the pass/fail test. Parameter Name -- Type Discrete Range 0|1|2 Default 0 Remarks 0: selects to modify Signal 1. 1: selects to modify Signal 2. 2: selects to modify Signal 3.
PAGE 195
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes The following query returns 650. :SENSe:SWEep:POINts? [:SENSe]:SWEep:TIME Syntax [:SENSe]:SWEep:TIME [:SENSe]:SWEep:TIME? Description Sets the sweep time. Queries the sweep time. Parameter Name Type Consecutive Real Number Range 1 ms to 4,000 s (non-zero span) 1 μs to 6,000 s (zero span) Default 1 ms Remarks This command is only available for GPSA mode. Return Format The query returns the sweep time in scientific notation.
PAGE 196
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Example The following command enables the auto sweep time. :SENSe:SWEep:TIME:AUTO ON or :SENSe:SWEep:TIME:AUTO 1 The following query returns 1. :SENSe:SWEep:TIME:AUTO? [:SENSe]:SWEep:TIME:AUTO:RULes Syntax [:SENSe]:SWEep:TIME:AUTO:RULes NORMal|ACCuracy [:SENSe]:SWEep:TIME:AUTO:RULes? Description Selects the sweep type. Queries the sweep type. Parameter Name Type —— Keyword Range NORMal|ACCuracy Default NORMal Remarks NORMal: indicates normal.
PAGE 197
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Return Format The query returns the average count in integer. Example The following command sets the average count to 100. :SENSe:TOI:AVERage:COUNt 100 The following query returns 100. :SENSe:TOI:AVERage:COUNt? [:SENSe]:TOI:AVERage[:STATe] Syntax [:SENSe]:TOI:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:TOI:AVERage[:STATe]? Description Enables or disables the average measurement function of the TOI measurement.
PAGE 198
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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]:TOI: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]:TOI:AVERage:COUNt).
PAGE 199
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [: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. Parameter Name Type Integer Range 1 to 1,000 Default 10 Remarks This command is only valid when the T-power measurement in GPSA mode is enabled. Return Format The query returns the average count in integer.
PAGE 200
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [: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. Parameter Name Type —— Keyword Range EXPonential|REPeat Default EXPonential Remarks EXPonential: indicates the exponential average. REPeat: indicates the repeat average.
PAGE 201
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Example The following command sets the start line to 5 ms. :SENSe:TPOWer:LLIMit 0.005 The following query returns 5.000000000e-03. :SENSe:TPOWer:LLIMit? [:SENSe]:TPOWer:MODE Syntax [:SENSe]:TPOWer:MODE AVERage|PEAK|RMS [:SENSe]:TPOWer:MODE? Description Sets the power type for the T-power measurement. Queries the power type for the T-power measurement.
PAGE 202
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Remarks This command is only valid when the T-power measurement in GPSA mode is enabled. Return Format The query returns the stop line in scientific notation. The unit is s. Example The following command sets the stop line to 10 ms. :SENSe:TPOWer:RLIMit 0.01 The following query returns 1.000000000e-02.
PAGE 203
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [:SENSe]:VSWR:STATe Syntax [:SENSe]:VSWR:STATe OFF|ON|0|1 [:SENSe]:VSWR:STATe? Description Enables or disables the VSWR measurement function. Queries the status of the VSWR measurement function. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only valid when the VSWR mesurement is enabled in GPSA mode. Return Format The qurey returns 0 or 1. Example The following command enables the VSWR measurement function.
PAGE 204
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 RSA3030E-TG/RSA3015E-TG working in GPSA mode.
PAGE 205
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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.
PAGE 206
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 207
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 208
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 209
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 210
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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:COMMunic
PAGE 211
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 212
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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.
PAGE 213
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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".
PAGE 214
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 215
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 216
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 217
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 218
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 RSA3030E-TG/RSA3015E-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 219
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 220
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Example The following command installs the option RSA3000E-PA. :SYSTem:LKEY RSA3000E-PA@8AD12B8EBC5DF492D1D4289B7CBA5B6150BF6F5D752D645C36D74530B05F39B49C461B 23A50D6C94A34E06782AC4380070B0D1A86BA84E02768391FFD70C2103 :SYSTem:OPTion:STATe? Syntax :SYSTem:OPTion:STATe?
PAGE 221
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 222
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 223
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :SYSTem:SHOW Syntax :SYSTem:SHOW OFF|SYSTem|OPTion|LICense :SYSTem:SHOW? Description Displays the system-related information. Queries the system-related information. 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.
PAGE 224
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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, al
PAGE 225
Chapter 2 Command Systems for GPSA and RTSA Modes 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 226
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes [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 227
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 228
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 229
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 230
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 231
Chapter 2 Command Systems for GPSA and RTSA Modes RIGOL 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 232
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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
PAGE 233
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 234
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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.
PAGE 235
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 236
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes "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.
PAGE 237
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 238
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 239
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 240
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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.
PAGE 241
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes Parameter Name Type Discrete Consecutive Real Number Consecutive Real Number Range 1|2 0 Hz to 3 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 242
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 243
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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.
PAGE 244
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 245
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes 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 246
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 247
RIGOL Chapter 2 Command Systems for GPSA and RTSA Modes :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 248
PAGE 249
Chapter 3 Command System for EMI Mode RIGOL Chapter 3 Command System for EMI Mode This chapter introduces the commands of the RSA series spectrum analyzer in EMI mode. Contents in this chapter:  :CALCulate Commands  :CALibration Commands  :COUPle Command  :CONFigure Command  :DISPlay Commands  :FETCh Command  :FORMat Commands  IEEE 488.
PAGE 250
RIGOL Chapter 3 Command System for EMI Mode :CALCulate Commands Command List:  :CALCulate:EMI:SLISt:DELete  :CALCulate:FSCan:MAMarker[:SET]:SLISt  :CALCulate:FSCan:MARKer:AOFF  :CALCulate:FSCan:MARKer:COUPle[:STATe]  :CALCulate:FSCan:MARKer:PEAK:EXCursion  :CALCulate:FSCan:MARKer:PEAK:EXCursion:STATe  :CALCulate:FSCan:MARKer:PEAK:SEARch:MODE  :CALCulate:FSCan:MARKer:PEAK:SEARch:THReshold  :CALCulate:FSCan:MARKer:PEAK:SEARch:THReshold:STATe  :CALCulate:FSCan:MARker:FUNCtion:MA
PAGE 251
Chapter 3 Command System for EMI Mode  :CALCulate:LLINe:ALL:DELete  :CALCulate:LLINe:TEST  :CALCulate:LLINe:AMPLitude:CMODe:RELative  :CALCulate:LLINe:BUILd  :CALCulate:LLINe:CONTrol:INTerpolate:TYPE  :CALCulate:LLINe:COPY  :CALCulate:LLINe:DATA  :CALCulate:LLINe:DELete  :CALCulate:LLINe:DISPlay  :CALCulate:LLINe:FAIL?  :CALCulate:LLINe:FREQuency:CMODe:RELative  :CALCulate:LLINe:MARGin  :CALCulate:LLINe:MARGin:STATe  :CALCulate:LLINe
PAGE 252
RIGOL Chapter 3 Command System for EMI Mode :CALCulate:EMI:SLISt:DELete Syntax :CALCulate:EMI:SLISt:DELete ALL|CURRent|MARKed|UNMarked Description Sets the signal type to be deleted. Parameter Name -- Type Discrete Range ALL|CURRent|MARKed|UNMarked Default CURRent Remarks ALL: deletes all the signals in the signal table. CURRent: deletes the currently selected signal from the signal table. MARKed: deletes all the marked signals from the signal table.
PAGE 253
RIGOL Chapter 3 Command System for EMI Mode Parameter Name -- Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks When you enable the couple marker function, moving any marker will enable other markers (except the Off marker) to move with it. Return Format The query returns 0 or 1. Example The following command disables the couple marker function. :CALCulate:FSCan:MARKer:COUPle:STATe OFF or :CALCulate:FSCan:MARKer:COUPle:STATe 0 The following query returns 0.
PAGE 254
RIGOL Chapter 3 Command System for EMI Mode 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 the peak excursion function. :CALCulate:FSCan:MARKer:PEAK:EXCursion:STATe ON or :CALCulate:FSCan:MARKer:PEAK:EXCursion:STATe 1 The following query returns 1.
PAGE 255
RIGOL Chapter 3 Command System for EMI Mode :CALCulate:FSCan:MARKer:PEAK:SEARch:THReshold Syntax :CALCulate:FSCan:MARKer:PEAK:SEARch:THReshold :CALCulate:FSCan:MARKer:PEAK:SEARch:THReshold? Description Sets the peak threshold. Queries the peak threshold. Parameter Name Type Consecutive Real Number Range -200 dBm to 0 dBm Default -90 dBm Return Format The query returns the peak threshold in scientific notation. Example The following command sets the peak threshold to -100 dBm.
PAGE 256
RIGOL Chapter 3 Command System for EMI Mode :CALCulate:FSCan:MARker:FUNCtion:MAMarker? Syntax :CALCulate:FSCan:MARker:FUNCtion:MAMarker? Description Queries the result measured at the marker. Parameter Name Type Discrete Range 1|2|3|4|5|6|7|8 Default -- Return Format The query returns the result measured at the marker in scientific notation, including detector 1 amplitude value, detector 2 amplitude value, detector 3 amplitude value and frequency value at the marker.
PAGE 257
RIGOL Chapter 3 Command System for EMI Mode 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 left peak search, and marks with Marker 2.
PAGE 258
RIGOL Chapter 3 Command System for EMI Mode :CALCulate:FSCan:MARKer:MINimum Syntax :CALCulate:FSCan:MARKer:MINimum Description Searches for and marks the peak with the minimum amplitude on the trace. 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 minimum search, and marks it with Marker 2.
PAGE 259
RIGOL Chapter 3 Command System for EMI Mode :CALCulate:FSCan:MARKer:REFerence Syntax :CALCulate:FSCan:MARKer:REFerence :CALCulate:FSCan: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 reference marker is the marker next to it.
PAGE 260
RIGOL Parameter Name Chapter 3 Command System for EMI Mode Type Discrete Range 1|2|3|4|5|6|7|8 Default -- Example The following command sets the frequency at Marker 1 to the frequency of the meter. :CALCulate:FSCan:MARKer1:SET:METer :CALCulate:FSCan:MARKer:TO:METer Syntax :CALCulate:FSCan:MARKer:TO:METer Description Sets the frequency of the meter to the frequency at the currently selected marker.
PAGE 261
RIGOL Chapter 3 Command System for EMI Mode :CALCulate:FSCan:SLISt:APPend:METer Syntax :CALCulate:FSCan:MARKer[:SET]:SLISt Description Adds the frequency of the meter to the signal table. :CALCulate:FSCan:SLISt:DELete:SIGNal Syntax :CALCulate:FSCan:SLISt:DELete:SIGNal Description Deletes the selected signal(s) from the signal table. Parameter Name Type Integer Range 1 to 2,000 Default -- Example The following command deletes Signal 20 from the signal table.
PAGE 262
RIGOL Parameter Name Chapter 3 Command System for EMI Mode Type Integer Range 1 to 2,000 Default -- Example The following command clears the mark of Signal 20 in the signal table. :CALCulate:FSCan:SLISt:MARK:CLEar:SIGNal 20 :CALCulate:FSCan:SLISt:MARK:SIGNal Syntax :CALCulate:FSCan:SLISt:MARK:SIGNal Description Marks the specified signal. Parameter Name Type Integer Range 1 to 2,000 Default -- Example The following command marks Signal 20 in the signal table.
PAGE 263
RIGOL Chapter 3 Command System for EMI Mode Parameter Name Type Integer Range 1 to 2,000 Default -- Example The following command sets the frequency of the meter to the frequency of Signal 20. :CALCulate:FSCan:SLISt:SET:METer 20 :CALCulate:FSCan:SLISt:SORT:AUTO Syntax :CALCulate:FSCan:SLISt:SORT:AUTO OFF|ON|0|1 :CALCulate:FSCan:SLISt:SORT:AUTO? Description Enables or disables the auto sort function. Queries the status of the auto sort function.
PAGE 264
RIGOL Chapter 3 Command System for EMI Mode The following query returns DET1. :CALCulate:FSCan:SLISt:SORT:DAMPlitude? :CALCulate:FSCan:SLISt:SORT:DLDelta Syntax :CALCulate:FSCan:SLISt:SORT:DLDelta DET1|DET2|DET3 :CALCulate:FSCan:SLISt:SORT:DLDelta? Description Sets the detector limit delta amplitude mode for the signal. Queries the detector limit delta amplitude mode for the signal. Parameter Name -- Type Keyword Range DET1|DET2|DET3 Default -- Return Format The query returns DET1, DET2, or DET3.
PAGE 265
RIGOL Chapter 3 Command System for EMI Mode :CALCulate:FSCan:SLISt:SORT:TYPE Syntax :CALCulate:FSCan:SLISt:SORT:TYPE FREQuency|DAMPlitude|DLDelta :CALCulate:FSCan:SLISt:SORT:TYPE? Description Sets the sort mode of the signal. Queries the sort mode of the signal. Parameter Name -- Type Keyword Range FREQuency|DAMPlitude|DLDelta Default FREQuency Remarks FREQuency: indicates the frequency. DAMPlitude: indicates the detector amplitude. DLDelta: indicates the detector limit delta amplitude.
PAGE 266
RIGOL Chapter 3 Command System for EMI Mode :CALCulate:FSCan:SLISt:ZOOM:OUT Syntax :CALCulate:FSCan:SLISt:ZOOM:OUT Description Returns the coordinate display of the current signal to its previous display set before the Signal Zoom. :CALCulate:LLINe:ALL:DELete Syntax :CALCulate:LLINe:ALL:DELete Description Deletes all the limit line data. :CALCulate:LLINe:TEST Syntax :CALCulate:LLINe:TEST OFF|ON|0|1 :CALCulate:LLINe:TEST? Description Enables or disables the limit line test function.
PAGE 267
RIGOL Chapter 3 Command System for EMI Mode reference level. Parameter Name -- Type Discrete Bool Range 1|2|3|4|5|6 OFF|ON|0|1 Default -OFF|0 Remarks OFF|0: disables the coupling function. That is, "Fixed" is selected under Y to Ref, and the amplitude of the current limit line editing point is not be affected by the reference level. ON|1: enables the coupling function.
PAGE 268
RIGOL Parameter Name -- Chapter 3 Command System for EMI Mode Type Keyword Range LOGarithmic|LINear Default LINear Return Format The query returns LOG or LIN. Example The following command sets the frequency interpolation mode of Limit Line 1 to LINear. :CALCulate:LLINe1:CONTrol:INTerpolate:TYPE LINear The following query returns LIN.
PAGE 269
RIGOL Chapter 3 Command System for EMI Mode Remarks : indicates frequency. : indicates the amplitude. By default, its unit is dBm. The same X value can be configured with at most two amplitude values. : can be configured with 1. It indicates that the current point connects with the previous point to determine the limit line. Return Format Queries the returned limit line data that you are editing currently.
PAGE 270
RIGOL Chapter 3 Command System for EMI Mode Example The following command turns on Limit Line 2. :CALCulate:LLINe2:DISPlay ON or :CALCulate:LLINe2:DISPlay 1 The following query returns 1. :CALCulate:LLINe2:DISPlay? :CALCulate:LLINe:FAIL? Syntax :CALCulate:LLINe:FAIL? Description Queries the measurement results of the selected limit line and its associated trace.
PAGE 271
RIGOL Chapter 3 Command System for EMI Mode Return Format The query returns 0 or 1. Example The following command disables the coupling functions between data points of Limit Line 2 and the midspan frequency. :CALCulate:LLINe2:FREQuency:CMODe:RELative OFF or :CALCulate:LLINe2:FREQuency:CMODe:RELative 0 The following query returns 0.
PAGE 272
RIGOL Chapter 3 Command System for EMI Mode Return Format The query returns 0 or 1. Example The following command turns on the margin for Limit Line 2. :CALCulate:LLINe2:MARGin:STATe ON or :CALCulate:LLINe2:MARGin:STATe 1 The following query returns 1. :CALCulate:LLINe2:MARGin:STATe? :CALCulate:LLINe:OFFSet:X Syntax :CALCulate:LLINe:OFFSet:X :CALCulate:LLINe:OFFSet:X? Description Sets the frequency offset of the specified limit line.
PAGE 273
RIGOL Chapter 3 Command System for EMI Mode Example The following command sets the amplitude offset of Limit Line 2 to 20 dB. :CALCulate:LLINe2:OFFSet:Y 20 The following query returns 2.000000000e+01. :CALCulate:LLINe2:OFFSet:Y? :CALCulate:LLINe:TRACe Syntax :CALCulate:LLINe:TRACe 1|2|3 :CALCulate:LLINe:TRACe? Description Sets the trace for the current limit line test. Queries the trace for the current limit line test.
PAGE 274
RIGOL Chapter 3 Command System for EMI Mode Return Format The query returns 0 or 1. Example The following command enables the peak threshold line. :CALCulate:MARker:PEAK:SEARch:THReshold:LINe ON or :CALCulate:MARker:PEAK:SEARch:THReshold:LINe 1 The following query returns 1.
PAGE 275
RIGOL Chapter 3 Command System for EMI Mode 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 marke. Return Format The query returns 0 or 1. Example The following command enables Marker 1. :CALCulate:MARKer1:STATe ON or :CALCulate:MARKer1:STATe 1 The following query returns 1.
PAGE 276
RIGOL Parameter Name Chapter 3 Command System for EMI Mode Type Discrete Range 1|2|3|4|5|6|7|8 Default -- :CALCulate:METer:LIMit:ALL:FAIL? Syntax :CALCulate:METer:LIMit:ALL:FAIL? Description Queries the measurement results of all the limit lines and their associated meters. Remarks If no limit line is set for the meter, the query returns 0. It is only applicable to the meter whose limit lines are enabled. If one limit line is disabled, then it will not be tested.
PAGE 277
RIGOL Chapter 3 Command System for EMI Mode Return Format The query returns the peak power values of three meters in scientific notation. The values are separated by commas. :CALCulate:METer:LIMit[:DATA] Syntax :CALCulate:METer:LIMit[:DATA] :CALCulate:METer:LIMit[:DATA]? Description Sets the limits of the specified meter. Queries the limits of the specified meter.
PAGE 278
RIGOL Chapter 3 Command System for EMI Mode :CALCulate:METer:LIMit:STATe Syntax :CALCulate:METer:LIMit:STATe OFF|ON|0|1 :CALCulate:METer:LIMit:STATe? Description Enables or disables the limit line of the specified meter. Queries the status of the limit line of the specified meter. Parameter Name -- Type Discrete Bool Range 1|2|3 OFF|ON|0|1 Default -OFF|0 Return Format The query returns 0 or 1. Example The following command enables the limit line of Meter 1.
PAGE 279
RIGOL Chapter 3 Command System for EMI Mode :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 280
RIGOL Chapter 3 Command System for EMI Mode :COUPle Command Command List:  :COUPle :COUPle Syntax :COUPle ALL Description Sets all the manual/auto settings in the current measurement mode to be "Auto".
PAGE 281
Chapter 3 Command System for EMI Mode RIGOL :CONFigure Command Command List:  :CONFigure?  :CONFigure:FSCan :CONFigure? Syntax :CONFigure? Description Queries the current measurement function. Return Format The query returns FSCan. :CONFigure:FSCan Syntax :CONFigure:FSCan Description Sets the spectrum analyzer to the frequency scanning measurement state.
PAGE 282
RIGOL Chapter 3 Command System for EMI Mode :DISPlay Commands Command List:  :DISPlay:BACKlight  :DISPlay:ENABle  :DISPlay:FSCan:VIEW:METer:FLINe  :DISPlay:FSCan:VIEW:METer[:STATe]  :DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision  :DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:RLEVel  :DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:RLEVel:OFFSet  :DISPlay:FSCan:WINDow:MAMarker[:STATe]  :DISPlay:GRATicule[:STATe]  :DISPlay:HDMI[:STATe]  :DISPlay:METer[:STATe]  :DISPlay:VIEW:
PAGE 283
RIGOL Chapter 3 Command System for EMI Mode :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 be 50. :DISPlay:BACKlight 50 The following query returns 50.
PAGE 284
RIGOL Chapter 3 Command System for EMI Mode :DISPlay:FSCan:VIEW:METer:FLINe Syntax :DISPlay:FSCan:VIEW:METer:FLINe OFF|ON|0|1 :DISPlay:FSCan:VIEW:METer:FLINe? Description Enables or disables the display of the meter frequency line. Queries the display status of the meter frequency line. 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 the display of the meter frequency line.
PAGE 285
RIGOL Chapter 3 Command System for EMI Mode :DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision Syntax :DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision :DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision? Description Sets the Y-axis scale type. Queries the Y-axis scale type. Parameter Name Type Consecutive Real Number Range 0.1 dB to 20 dB Default 10 dB Return Format The query returns the Y-axis scale value in scientific notation.
PAGE 286
RIGOL Chapter 3 Command System for EMI Mode :DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:RLEVel:OFFSet Syntax :DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:RLEVel:OFFSet :DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:RLEVel:OFFSet? Description Sets the reference level offset. Queries the reference level offset.
PAGE 287
RIGOL Chapter 3 Command System for EMI Mode :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 288
RIGOL Chapter 3 Command System for EMI Mode :DISPlay:METer[:STATe] Syntax :DISPlay:METer[:STATe] OFF|ON|0|1 :DISPlay:METer[:STATe]? Description Enables or disables the specified meter. Queries the status of the specified meter. Parameter Name -- Type Bool Range OFF|ON|0|1 Default Refer to "Remarks" Remarks The meter1 is enabled by default, while the meter2 and meter3 are disabled by default. Return Format The query returns 0 or 1. Example The following command enables Meter 2.
PAGE 289
RIGOL Chapter 3 Command System for EMI Mode :DISPlay:WINDow:TRACe:Y:DLINe Syntax :DISPlay:WINDow:TRACe:Y:DLINe :DISPlay:WINDow:TRACe:Y:DLINe? Description Sets the position of the display line. Queries the position of the display line. Parameter Name Type Consecutive Real Number Range Current amplitude range Default 81.99 dBuV Remarks By default, the display line is disabled. When the display line is enabled for the first time, its position is 81.99 dBuV.
PAGE 290
RIGOL Chapter 3 Command System for EMI Mode :DISPlay[:WINDow]:TRACe:MODE Syntax :DISPlay[:WINDow]:TRACe:MODE WRITe|AVERage|MAXHold|MINHold :DISPlay[:WINDow]:TRACe:MODE? Description Sets the type of the specified trace. Queries the type of the specified trace. Parameter Name -- Type Discrete Keyword Range 1|2|3 WRITe|AVERage|MAXHold|MINHold Default -WRITe Remarks WRITe: indicates clear/write. AVERage: indicates average. MAXHold: indicates the maximum hold.
PAGE 291
Chapter 3 Command System for EMI Mode RIGOL :FETCh Command Command List:  :FETCh:FSCan? :FETCh:FSCan? Syntax :FETCh:FSCan? Description Queries the frequency scan measurement results (returns the signal table information).
PAGE 292
RIGOL Chapter 3 Command System for EMI Mode :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 293
RIGOL Chapter 3 Command System for EMI Mode :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.
PAGE 294
RIGOL Chapter 3 Command System for EMI Mode IEEE 488.2 Common Commands IEEE 488.2 common commands are used to operate or query the status registers. For details of the commands, refer to Page "2-81".
PAGE 295
Chapter 3 Command System for EMI Mode RIGOL :INITiate Commands Command List:  :INITiate:FSCan:CLEar:IMMediate  :INITiate:PAUSe  :INITiate:RESume  :INITiate1:CONTinuous  :INITiate2:CONTinuous  :INITiate2:IMMediate  :INITiate2:RESTart :INITiate:FSCan:CLEar:IMMediate Syntax :INITiate:FSCan:CLEar:IMMediate Description Deletes all the signals in the signal table and launches the selected scan sequence.
PAGE 296
RIGOL Parameter Name -- Chapter 3 Command System for EMI Mode Type Bool Range OFF|ON|0|1 Default ON|1 Return Format The query returns 0 or 1. Example The following command sets the measurement mode of the meter to CONTinuous. :INITiate1:CONTinuous ON or :INITiate1:CONTinuous 1 The following query returns 1. :INITiate1:CONTinuous? :INITiate2:CONTinuous Syntax :INITiate2:CONTinuous OFF|ON|0|1 :INITiate2:CONTinuous? Description Selects continuous (ON|1) or single (OFF|0) sweep mode.
PAGE 297
RIGOL Chapter 3 Command System for EMI Mode :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 298
RIGOL Chapter 3 Command System for EMI Mode :INSTrument:NSELect :INSTrument[:SELect] Syntax :INSTrument:NSELect 1|2|3|4 :INSTrument:NSELect? :INSTrument[:SELect] SA|RTSA|VSA|EMI :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|3|4 SA|RTSA|VSA|EMI Default 1 SA Remarks The above parameters 1|2|3|4 correspond to SA|RTSA|VSA|EMI, respectively.
PAGE 299
Chapter 3 Command System for EMI Mode RIGOL :MMEMory Commands Command List:  :MMEMory:DELete  :MMEMory:LOAD:CORRection  :MMEMory:LOAD:LIMit  :MMEMory:LOAD:SCAN  :MMEMory:LOAD:SLISt  :MMEMory:LOAD:STATe  :MMEMory:LOAD:TRACe  :MMEMory:LOAD:TRACe:DATA  :MMEMory:MOVE  :MMEMory:STORe:CORRection  :MMEMory:STORe:LIMit  :MMEMory:STORe:SCAN  :MMEMory:STORe:SCReen  :MMEMory:STORe:SLISt  :MMEMory:STORe:STATe  :MMEMory:STORe:TRACe  :MMEMory:STORe:TRACe:DATA Remarks: Th
PAGE 300
RIGOL Chapter 3 Command System for EMI Mode :MMEMory:DELete Syntax :MMEMory:DELete Description Deletes a specified file. Parameter Name Type ASCII String Range -- Default -- Remarks should contain the path and the filename. This operation fails if the file with the specified filename does not exist. Example The following command deletes the "state1.sta" file in the "/emi/state" folder. :MMEMory:DELete /emi/state/state1.
PAGE 301
RIGOL Chapter 3 Command System for EMI Mode Parameter Name Type Keyword ASCII String Range LLINE1|LLINE2|LLINE3|LLINE4|LLINE5|LLINE6 -- Default --- Remarks This operation fails if the file with the specified filename does not exist. Example The following command loads the limit line file (upp1.csv) to Limit Line 1. :MMEMory:LOAD:LIMit LLINE1,upp1.csv :MMEMory:LOAD:SCAN Syntax :MMEMory:LOAD:SCAN Description Loads the specified scan table file (.csv).
PAGE 302
RIGOL Chapter 3 Command System for EMI Mode :MMEMory:LOAD:STATe Syntax :MMEMory:LOAD:STATe Description Loads the specified state file (.sta). Parameter Name Type ASCII String Range -- Default -- Remarks This operation fails if the file with the specified filename does not exist. Example The following command loads the state file (state1.sta) to the instrument. :MMEMory:LOAD:STATe state1.
PAGE 303
RIGOL Chapter 3 Command System for EMI Mode Remarks This operation fails if the file with the specified filename does not exist. Example The following command loads the measurement data file (trace1.csv) to Trace1. :MMEMory:LOAD:TRACe:DATA TRACE1,trace1.csv :MMEMory:MOVE Syntax :MMEMory:MOVE , Description Renames the specified file as .
PAGE 304
RIGOL Chapter 3 Command System for EMI Mode :MMEMory:STORe:LIMit Syntax :MMEMory:STORe:LIMit , Description Saves the currently edited limit line with a specified filename suffixed with ".csv" by default to the 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 305
RIGOL Chapter 3 Command System for EMI Mode Parameter Name Type ASCII String Range -- Default -- Remarks If the specified file already exists, overwrite it. If a suffix (.jpg/.png/.bmp) is added to the filename, you can save the current screen image with a different format based on its different suffix. If no suffix is added to the filename, then by default, the current screen image is saved in the currently selected format.
PAGE 306
RIGOL Chapter 3 Command System for EMI Mode Remarks If the specified file already exists, overwrite it. Example The following command saves the current instrument state with the filename "state.sta" to the folder (/emi/state). :MMEMory:STORe:STATe state :MMEMory:STORe:TRACe Syntax :MMEMory:STORe:TRACe , Description Saves the specified trace+state file with filename suffixed with ".trs" to the default path (/"mode name"/tracestate).
PAGE 307
Chapter 3 Command System for EMI Mode RIGOL [:SENSe] Commands Command List:  [:SENSe]:AVERage:COUNt  [:SENSe]:AVERage:TYPE  [:SENSe]:AVERage:TYPE:AUTO  [:SENSe]:BANDwidth|BWIDth:EMIFilter:STATe  [:SENSe]:BANDwidth|BWIDth[:RESolution]  [:SENSe]:BANDwidth|BWIDth[:RESolution]:AUTO  [:SENSe]:CORRection:CSET:ALL:DELete  [:SENSe]:CORRection:CSET:ALL[:STATe]  [:SENSe]:CORRection:CSET:DATA  [:SENSe]:CORRection:CSET:DATA:MERGe  [:SENSe]:CORRection:CSET:DELete  [:SENSe]:COR
PAGE 308
RIGOL  [:SENSe]:FSCan:SCAN:POINT  [:SENSe]:FSCan:SCAN:POWer:GAIN[:STATe]  [:SENSe]:FSCan:SCAN:STARt  [:SENSe]:FSCan:SCAN:STATe  [:SENSe]:FSCan:SCAN:STOP  [:SENSe]:FSCan:SCAN:TIME  [:SENSe]:FSCan:SCAN:TIME:AUTO  [:SENSe]:FSCan:SEARch:MODE  [:SENSe]:FSCan:SEARch:PEAK:COUNt  [:SENSe]:FSCan:SEARch:PEAK:COUNt:STATe  [:SENSe]:FSCan:SEARch:SUBRange:COUNt  [:SENSe]:FSCan:SEQuence  [:SENSe]:FSCan:SEQuence:REMeasure  [:SENSe]:FSCan:SLISt:COUPle:METer 
PAGE 309
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:AVERage:COUNt Syntax [:SENSe]:AVERage:COUNt [:SENSe]:AVERage:COUNt? Description Sets the trace average count of the current measurement. Queries the trace average count of the current measurement. Parameter Name Type Integer Range 1 to 10,000 Default 1 Return Format The query returns the average count in integer. Example The following command sets the average count to 100. :SENSe:AVERage:COUNt 100 The following query returns 100.
PAGE 310
RIGOL Chapter 3 Command System for EMI Mode [: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 current measurement. Queries the on/off auto state for the average type of the current measurement. Parameter Name -- Type Bool Range OFF|ON|0|1 Default ON|1 Return Format The query returns 0 or 1.
PAGE 311
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:BANDwidth|BWIDth[:RESolution] Syntax [:SENSe]:BANDwidth|BWIDth[:RESolution] [:SENSe]:BANDwidth|BWIDth[:RESolution]? Description Sets the resolution bandwidth (RBW) of the meter frequency. Queries the resolution bandwidth of the meter frequency.
PAGE 312
RIGOL Chapter 3 Command System for EMI Mode When the EMC measurement standard is "None", this command is invalid. When the EMC measurement standard is "CISPR", select the Auto RBW mode by default. 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 313
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:CORRection:CSET:DATA Syntax [:SENSe]:CORRection:CSET:DATA ,,{,} [:SENSe]:CORRection:CSET:DATA? Description Creates an amplitude correction curve by using the specified data. Queries the specified amplitude correction data.
PAGE 314
RIGOL Chapter 3 Command System for EMI Mode Example The following command adds two points to the current correction curve. :SENSe:CORRection:CSET1:DATA 900E6,0.3,1.0E9,0.35 [:SENSe]:CORRection:CSET:DELete Syntax [:SENSe]:CORRection:CSET:DELete Description Deletes the specified amplitude correction setting. Parameter Name Type Discrete Range 1|2|3|4 Default -- Remarks : 1 indicates antenna; 2 indicates cable; 3 indicates other, and 4 indicates user.
PAGE 315
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:CORRection:CSET:X:SPACing Syntax [:SENSe]:CORRection:CSET:X:SPACing LINear|LOGarithmic [:SENSe]:CORRection:CSET:X:SPACing? Description Selects the frequency interpolation mode for amplitude correction. Queries the frequency interpolation mode for amplitude correction.
PAGE 316
RIGOL Chapter 3 Command System for EMI Mode Return Format The query returns 50 or 75. Example The following command sets the input impedance is 75 Ω. :INPut:IMPedance 75 or :SENSe:CORRection:IMPedance:INPut:MAGNitude 75 The following query returns 75. :INPut:IMPedance? or :SENSe:CORRection:IMPedance:INPut:MAGNitude? [:SENSe]:CORRection:SA[:RF]:GAIN Syntax [:SENSe]:CORRection:SA[:RF]:GAIN [:SENSe]:CORRection:SA[:RF]:GAIN? Description Sets the external gain. Queries the external gain.
PAGE 317
RIGOL Chapter 3 Command System for EMI Mode Example The following command enables the Detector Auto function for Trace 1. :SENSe:DETector:TRACe1:AUTO ON or :SENSe:DETector:TRACe1:AUTO 1 The following query returns 1. :SENSe:DETector:TRACe1:AUTO? [:SENSe]:EMC:STANdard[:SELect] Syntax [:SENSe]:EMC:STANdard[:SELect] NONE|CISPr [:SENSe]:EMC:STANdard[:SELect]? Description Sets the EMC standard. Queries the EMC standard.
PAGE 318
RIGOL Chapter 3 Command System for EMI Mode :SENSe:FREQuency:CENTer 1000000 The following query returns 1.000000000e+06. :SENSe:FREQuency:CENTer? [:SENSe]:FREQuency:MIDSpan Syntax [:SENSe]:FREQuency:MIDSpan [:SENSe]:FREQuency:MIDSpan? Description Sets the midspan center frequency. Queries the midspan center frequency.
PAGE 319
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FREQuency:STARt Syntax [:SENSe]:FREQuency:STARt [:SENSe]:FREQuency:STARt? Description Sets the start frequency. Queries the start frequency. Parameter Name Type Consecutive Real Number Range 0 Hz to (Fmax - 10 Hz) Default midspan frequency - span/2 Return Format The query returns the start frequency in scientific notation. The unit is Hz. Example The following command sets the start frequency to 100 MHz.
PAGE 320
RIGOL Chapter 3 Command System for EMI Mode [: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 Range 10 Hz to Fmax Default midspan frequency + span/2 Return Format The query returns the stop frequency in scientific notation. The unit is Hz. Example The following command sets the stop frequency to 10 MHz.
PAGE 321
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FSCan:DETector:TRACe Syntax [:SENSe]:FSCan:DETector:TRACe AVERage|NEGative|POSitive|CAVerage |QPEak|RAVerage [:SENSe]:FSCan:DETector:TRACe? Description Sets the detector type for the specified trace. Queries the detector type for the specified trace. Parameter Name -- Type Discrete Range 1|2|3 AVERage|NEGative|POSitive| CAVerage|QPEak|RAVerage Keyword Default 1 POSitive Remarks AVERage: indicates the voltage average.
PAGE 322
RIGOL Chapter 3 Command System for EMI Mode RAVerage: indicates the RMS average. AVERage: indicates the voltage average. NEGative: indicates the negative peak. OFF: indicates disabling the detector. By default, the detector 1 type is positive peak; the detector 2 type is quasi peak; the detector 3 type is CISPR average. Return Format The query returns POS, QPE, CAV, RAV, AVER, NEG, or OFF. Example The following command sets the detector type of Detector 1 in the final measurement to POSitive.
PAGE 323
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FSCan:FINal:DETector:LDELta Syntax [:SENSe]:FSCan:FINal:DETector:LDELta [:SENSe]:FSCan:FINal:DETector:LDELta? Description Sets the limit line used by the specified detector in the final measurement. Queries the limit line used by the specified detector in the final measurement.
PAGE 324
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FSCan:SCAN:ABORT Syntax [:SENSe]:FSCan:SCAN:ABORT Description Stops the current scan sequence. [:SENSe]:FSCan:SCAN:BANDwidth|BWIDth:EMIFilter:STATe Syntax [:SENSe]:FSCan:SCAN:BANDwidth|BWIDth:EMIFilter:STATe OFF|ON|0|1 [:SENSe]:FSCan:SCAN:BANDwidth|BWIDth:EMIFilter:STATe? Description Enables or disables the EMI filter within the specified range. Queries the status of the EMI filter within the specified range.
PAGE 325
RIGOL Chapter 3 Command System for EMI Mode Parameter Name Type Discrete Discrete Range 1|2|3|4|5|6|7|8|9|10 100 Hz to 10 MHz (at 1-3-10 step) Default 3|4|5 120 kHz Remarks When the EMC measurement standard is "None" and "Gauss" filter is selected, the RBW range is as above. When "EMI" filter is selected, resolution bandwidth can only be 200 Hz, 9 kHz, 120 kHz, or 1 MHz. Return Format The query returns the resolution bandwidth for the specified range in scientific notation. Its unit is Hz.
PAGE 326
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FSCan:SCAN:INPut:ATTenuation Syntax [:SENSe]:FSCan:SCAN:INPut:ATTenuation [:SENSe]:FSCan:SCAN:INPut:ATTenuation? Description Sets the attenuation value for the specified range. Queries the attenuation value for the specified range. Parameter Name Type Discrete Integer Range 1|2|3|4|5|6|7|8|9|10 0 dB to 50 dB Default 3|4|5 10 dB Return Format The query returns the attenuation in integer. The unit is dB.
PAGE 327
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FSCan:SCAN:POINT Syntax [:SENSe]:FSCan:SCAN:POINT [:SENSe]:FSCan:SCAN:POINT? Description Sets the number of scan points for the specified range. Queries the number of scan points for the specified range.
PAGE 328
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FSCan:SCAN:STARt Syntax [:SENSe]:FSCan:SCAN:STARt [:SENSe]:FSCan:SCAN:STARt? Description Sets the start frequency for the specified range. Queries the start frequency for the specified range. Parameter Name Type Discrete Consecutive Real Number Range 1|2|3|4|5|6|7|8|9|10 0 Hz to 3 GHz Default 3|4|5 30 MHz Return Format The query returns the start frequency for the specified range in scientific notation. The unit is Hz.
PAGE 329
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FSCan:SCAN:STOP Syntax [:SENSe]:FSCan:SCAN:STOP [:SENSe]:FSCan:SCAN:STOP? Description Sets the stop frequency for the specified range. Queries the stop frequency for the specified range. Parameter Name Type Discrete Consecutive Real Number Range 1|2|3|4|5|6|7|8|9|10 0 Hz to 3 GHz Default 3|4|5 1 GHz Return Format The query returns the stop frequency for the specified range in scientific notation. The unit is Hz.
PAGE 330
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FSCan:SCAN:TIME:AUTO Syntax [:SENSe]:FSCan:SCAN:TIME:AUTO ON|OFF|1|0 [:SENSe]:FSCan:SCAN:TIME:AUTO? Description Enables or disables the auto scan time for the specified sweep range. Queries the status of the auto scan time for the specified sweep range. Parameter Name -- Type Discrete Bool Range 1|2|3|4|5|6|7|8|9|10 OFF|ON|0|1 Default 3|4|5 ON|1 Return Format The query returns 0 or 1.
PAGE 331
RIGOL Chapter 3 Command System for EMI Mode :SENSe:FSCan:SEARch:MODE? [:SENSe]:FSCan:SEARch:PEAK:COUNt Syntax [:SENSe]:FSCan:SEARch:PEAK:COUNt [:SENSe]:FSCan:SEARch:PEAK:COUNt? Description Sets the number of peaks that are required during signal search. Queries the number of peaks that are required during signal search. Parameter Name Type Integer Range 1 to 2000 Default 25 Remarks This command is only valid when the peak count is enabled.
PAGE 332
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FSCan:SEARch:SUBRange:COUNt Syntax [:SENSe]:FSCan:SEARch:SUBRange:COUNt [:SENSe]:FSCan:SEARch:SUBRange:COUNt? Description Sets the number of subranges in the signal search. Queries the number of subranges in the signal search. Parameter Name Type Integer Range 1 to 50 Default 25 Return Format The query returns the number of subranges in integer. Example The following command sets the number of subranges in the signal search to 3.
PAGE 333
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FSCan:SEQuence:REMeasure Syntax [:SENSe]:FSCan:SEQuence:REMeasure CURRent|MARKed|ALL [:SENSe]:FSCan:SEQuence:REMeasure? Description Sets the type of the final measurement. Queries the type of the final measurement. Parameter Name Type -Keyword Range CURRent|MARKed|ALL Default CURRent Remarks CURRent: indicates the selected signal. MARKed: indicates the marked signal. ALL: indicates all the signals. Return Format The query returns CURR, MARK, or ALL.
PAGE 334
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:FSCan:TRACe:TYPE Syntax [:SENSe]:FSCan:TRACe:TYPE WRITe|AVERage|MAXHold|MINHold [:SENSe]:FSCan:TRACe:TYPE? Description Sets the type of the trace. Queries the type of the trace. Parameter Name -- Type Keyword Range WRITe|AVERage|MAXHold|MINHold Default WRITe Remarks WRITe: indicates clear/write. AVERage: indicates average. MAXHold: indicates the maximum hold. MINHold: indicates the minimum hold.
PAGE 335
RIGOL Chapter 3 Command System for EMI Mode [:SENSe]:METer:PHOLd:ADJustable Syntax [:SENSe]:METer:PHOLd:ADJustable [:SENSe]:METer:PHOLd:ADJustable? Description Sets the peak hold time of the meter. Queries the peak hold time of the meter. Parameter Name Type Consectutive Real Number Range 500 ms to 100 s Default 2s Return Format The query returns the peak hold time in scientific notation. Example The following command sets the peak hold time of the meter to 0.8 s.
PAGE 336
RIGOL Chapter 3 Command System for EMI Mode Example The following command sets the max hold time of the meter to INFinite. :SENSe:METer:PHOLd:TYPE INFinite The following query returns INF. :SENSe:METer:PHOLd:TYPE? [:SENSe]:METer:DETector Syntax [:SENSe]:METer:DETector POSitive|QPEak|CAVerage|RAVerage|AVERage|NEGative [:SENSe]:METer:DETector? Description Sets the detector type of the specified meter. Queries the detector type of the specified meter.
PAGE 337
RIGOL Chapter 3 Command System for EMI Mode Parameter Name Type Integer Range 0 dB to 50 dB Default 10 dB Return Format The query returns the attenuation in integer. The unit is dB. Example The following command set the attenuation to 20 dB. :SENSe:POWer:RF:ATTenuation 20 The following query returns 20.
PAGE 338
RIGOL Chapter 3 Command System for EMI Mode :STATus Commands For the details about the :STATus commands, refer to 2-180.
PAGE 339
Chapter 3 Command System for EMI Mode RIGOL :SYSTem Commands For the details about the :SYSTem commands, refer to 2-184.
PAGE 340
RIGOL Chapter 3 Command System for EMI Mode :TRACe Commands Command List:  :TRACe[:DATA]  :TRACe:DISPlay[:STATe]  :TRACe:UPDate:STATe :TRACe[:DATA] Syntax :TRACe[:DATA]? TRACE1|TRACE2|TRACE3 Description Queries the log data of the specified trace.
PAGE 341
RIGOL Chapter 3 Command System for EMI Mode :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 setting state for the specified trace. Parameter Name Type Discrete -Bool Range 1|2|3 OFF|ON|0|1 Default -Refer to "Remarks" Remarks By default, Trace 1 is enabled (ON), and Trace 2 through Trace 3 are disabled (OFF). Return Format The query returns 1 or 0.
PAGE 342
RIGOL Chapter 3 Command System for EMI Mode :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]:HOLDoff  :TRIGger[:SEQuence]:HOLDoff:STATe  :TRIGger[:SEQuence]:SOURce  :TRIGger2:MODE :TRIGger[:SEQuence]:ATRigger Syntax :TRIGger[:SEQuence]:ATRigger :TRIGger[:SEQuence]:ATRigger? Descriptio
PAGE 343
RIGOL Chapter 3 Command System for EMI Mode :TRIGger[:SEQuence]:ATRigger:STATe Syntax :TRIGger[:SEQuence]:ATRigger:STATe OFF|ON|0|1 :TRIGger[:SEQuence]:ATRigger:STATe? Description Enables or disables the auto trigger function. Queries the setting status of auto trigger function. Parameter Name -- Type Bool Range OFF|ON|0|1 Default OFF|0 Return Format The query returns 1 or 0. Example The following command enables the auto trigger function.
PAGE 344
RIGOL Chapter 3 Command System for EMI Mode :TRIGger[:SEQuence]:EXTernal:DELay:STATe Syntax :TRIGger[:SEQuence]:EXTernal:DELay:STATe OFF|ON|0|1 :TRIGger[:SEQuence]:EXTernal:DELay:STATe? Description Enables or disables the external trigger delay function. Queries the setting state of the external trigger delay function.
PAGE 345
RIGOL Chapter 3 Command System for EMI Mode Example The following command sets the trigger edge of External Trigger 1 to be Positive. :TRIGger:SEQuence:EXTernal1:SLOPe POSitive The following query returns POS. :TRIGger:SEQuence:EXTernal1:SLOPe? :TRIGger[:SEQuence]:HOLDoff Syntax :TRIGger[:SEQuence]:HOLDoff :TRIGger[:SEQuence]:HOLDoff? Description Sets the trigger holdoff time. Queries the trigger holdoff time.
PAGE 346
RIGOL Chapter 3 Command System for EMI Mode Example The following command enables the trigger holdoff function. :TRIGger:SEQuence:HOLDoff:STATe ON or :TRIGger:SEQuence:HOLDoff:STATe 1 The following query returns 1. :TRIGger:SEQuence:HOLDoff:STATe? :TRIGger[:SEQuence]:SOURce Syntax :TRIGger[:SEQuence]:SOURce EXTernal1|EXTernal2|IMMediate :TRIGger[:SEQuence]:SOURce? Description Sets the trigger source. Queries the trigger source.
PAGE 347
Chapter 3 Command System for EMI Mode RIGOL OUT|1: indicates the output interface. Return Format The query returns 0 or 1. Example The following command sets External Trigger 2 to be the input interface. :TRIGger2:MODE IN The following query returns 0.
PAGE 348
RIGOL Chapter 3 Command System for EMI Mode :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 349
Chapter 4 Command System for VSA Mode RIGOL Chapter 4 Command System for VSA Mode This chapter introduces the commands of the RSA5000E series spectrum analyzer in VSA mode. Contents in this chapter:  :CALCulate Commands  :CALibration Commands  :CONFigure Commands  :DISPlay Commands  :FETCh Commands  :FORMat Commands  IEEE 488.
PAGE 350
RIGOL Chapter 4 Command System for VSA Mode :CALCulate Commands Command List:  :CALCulate:DDEMod:MARKer:AOFF  :CALCulate:DDEMod:MARKer:COUPle[:STATe]  :CALCulate:DDEMod:MARKer:TABLe[:STATe]  :CALCulate:DDEMod:MARKer:CPSearch[:STATe]  :CALCulate:DDEMod:MARKer:FUNCtion  :CALCulate:DDEMod:MARKer:FUNCtion:BAND:LEFT  :CALCulate:DDEMod:MARKer:FUNCtion:BAND:RIGHt  :CALCulate:DDEMod:MARKer:FUNCtion:BAND:SPAN  :CALCulate:DDEMod:MARKer:MAXimum  :CALCulate:DDEMod:MARKer
PAGE 351
RIGOL Chapter 4 Command System for VSA Mode :CALCulate:DDEMod:MARKer:AOFF Syntax :CALCulate:DDEMod:MARKer:AOFF Description Turns off all the enabled markers. :CALCulate:DDEMod:MARKer:COUPle[:STATe] Syntax :CALCulate:DDEMod:MARKer:COUPle[:STATe] OFF|ON|0|1 :CALCulate:DDEMod:MARKer:COUPle[:STATe]? Description Enables or disables the couple marker function. Queries the state of the couple marker function.
PAGE 352
RIGOL Chapter 4 Command System for VSA Mode Example The following command disables the marker table. :CALCulate:DDEMod:MARKer:TABLe:STATe OFF or :CALCulate:DDEMod:MARKer:TABLe:STATe 0 The following query returns 0.
PAGE 353
RIGOL Chapter 4 Command System for VSA Mode Return Format The query returns BPOW or OFF. Example The following command sets the measurement type of Marker 1 to band power. :CALCulate:DDEMod:MARKer1:FUNCtion BPOW The following query returns BPOW.
PAGE 354
RIGOL Parameter Name Chapter 4 Command System for VSA Mode Type Discrete Consecutive Real Number Range 1|2|3|4|5|6|7|8 band left to +∞ Default -center frequency+bandwidth/2 Remarks This command is only valid when you open the marker on the frequency domain data and enable the corresponding bandwidth function. This command is used to set the right edge time when you select the time-domain data source.
PAGE 355
RIGOL Chapter 4 Command System for VSA Mode :CALCulate:DDEMod:MARKer:MAXimum Syntax :CALCulate:DDEMod:MARKer:MAXimum Description Performs one peak search, and marks with the specified marker. 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 peak search, and marks with Marker 2.
PAGE 356
RIGOL Chapter 4 Command System for VSA Mode Remarks When no peak is found, a prompt message "No peak found" is displayed on the screen. Example The following command performs one next peak search, and marks with Marker 2. :CALCulate:DDEMod:MARKer2:MAXimum:NEXT :CALCulate:DDEMod:MARKer:MAXimum:PREVious Syntax :CALCulate:DDEMod:MARKer:MAXimum:PREVious Description Searches for the peak whose amplitude on the trace is next higher than that of the current peak and marks it with the specified marker.
PAGE 357
RIGOL Chapter 4 Command System for VSA Mode :CALCulate:DDEMod:MARKer:MINimum Syntax :CALCulate:DDEMod:MARKer:MINimum Description Searches for the peak with the minimum amplitude on the trace and marks it with the specified marker. 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 minimum search, and marks it with Marker 2.
PAGE 358
RIGOL Chapter 4 Command System for VSA Mode :CALCulate:DDEMod:MARKer:REFerence Syntax :CALCulate:DDEMod:MARKer:REFerence :CALCulate:DDEMod: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 reference marker is the marker next to it.
PAGE 359
RIGOL Chapter 4 Command System for VSA Mode The following query returns 2. :CALCulate:DDEMod:MARKer1:TRACe? :CALCulate:DDEMod:MARKer:X Syntax :CALCulate:DDEMod:MARKer:X :CALCulate:DDEMod: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 360
RIGOL Parameter Name Chapter 4 Command System for VSA Mode Type Discrete Consecutive Real Number Range 1|2|3|4|5|6|7|8 -- Default --- Remarks Only when "Fixed" is selected for the marker mode and "I-Q" or "Constellation" is selected for the trace format, the command is valid. Return Format The query returns the marker's quadrature component (imaginary) of the Y value in scientific notation. Example The following command sets the quadrature component Y value of Marker 1 to 0.435.
PAGE 361
RIGOL Chapter 4 Command System for VSA Mode :CALCulate:MARKer[:SET]:CENTer Syntax :CALCulate:MARKer[:SET]:CENTer Description Sets the center frequency of the analyzer to the frequency of the specified marker. 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 will be set to the frequency of the marker.
PAGE 362
RIGOL Parameter Name Chapter 4 Command System for VSA Mode 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 363
RIGOL Chapter 4 Command System for VSA Mode between the Delta marker and the reference marker. Example The following command sets the center frequency step of the analyzer to the frequency of Marker 4 (Position). :CALCulate:MARKer4:SET:STEP :CALCulate:MARKer[:SET]:STOP Syntax :CALCulate:MARKer[:SET]:STOP Description Sets the stop frequency of the analyzer to the frequency of the specified marker.
PAGE 364
RIGOL Chapter 4 Command System for VSA Mode :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 365
Chapter 4 Command System for VSA Mode RIGOL :CONFigure Commands Command List:  :CONFIgure:BERate  :CONFigure:DDEMod :CONFIgure:BERate Syntax :CONFIgure:BERate Description Sets the analyzer to be in the bit error rate measurement state. :CONFigure:DDEMod Syntax :CONFigure:DDEMod Description Sets the analyzer to be in the digital demodulation measurement state.
PAGE 366
RIGOL Chapter 4 Command System for VSA Mode :DISPlay Commands Command List:  :DISPlay:BACKlight  :DISPlay:DDEMod:TRACe:DDEMod:EYE:COUNt  :DISPlay:DDEMod:TRACe:DDEMod:SYMBol:FORMat  :DISPlay:DDEMod:TRACe:FEED  :DISPlay:DDEMod:TRACe:FORMat  :DISPlay:DDEMod:TRACe:X[:SCALe]:COUPle  :DISPlay:DDEMod:TRACe:X[:SCALe]:RLEVel  :DISPlay:DDEMod:TRACe:X[:SCALe]:RPOSition  :DISPlay:DDEMod:TRACe:X[:SCALe]:SPAN  :DISPlay:DDEMod:TRACe:Y[:SCALe]:AUTO:ONCE  :DISPlay:D
PAGE 367
RIGOL Chapter 4 Command System for VSA Mode :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 368
RIGOL Chapter 4 Command System for VSA Mode :DISPlay:DDEMod:TRACe:DDEMod:SYMBol:FORMat Syntax :DISPlay:DDEMod:TRACe:DDEMod:SYMBol:FORMat HEXadecimal|BINary :DISPlay:DDEMod:TRACe:DDEMod:SYMBol:FORMat? Description Sets the symbol format of the specified trace. Queries the symbol format of the specified trace. Parameter Name -- Type Discrete Keyword Range 1|2|3|4 HEXadecimal|BINary Default -BINary Remarks HEXadecimal: indicates the hexadecimal format. BINary: indicates the binary format.
PAGE 369
RIGOL Chapter 4 Command System for VSA Mode The following query returns SYMB. :DISPlay:DDEMod:TRACe1:FEED? :DISPlay:DDEMod:TRACe:FORMat Syntax :DISPlay:DDEMod:TRACe:FORMat IEYE|QEYE|CONS|MLOG|REAL|IMAGinary|VECTor|PHASe|UPHas|MLINear :DISPlay:DDEMod:TRACe:FORMat? Description Sets the display format of the specified trace. Queries the display format of the specified trace.
PAGE 370
RIGOL Parameter Name -- Chapter 4 Command System for VSA Mode Type Discrete Bool Range 1|2|3|4 OFF|ON|0|1 Default -ON|1 Remarks ON: sets to Auto mode. The instrument adjusts the X-axis reference value and X-axis width to an optimal state. OFF: sets to Manual mode. You need to set the X-axis reference value and X-axis width manually. Return Format The query returns 0 or 1. Example The following command enables the X Scale auto mode of Trace 1.
PAGE 371
RIGOL Chapter 4 Command System for VSA Mode :DISPlay:DDEMod:TRACe:X[:SCALe]:RPOSition Syntax :DISPlay:DDEMod:TRACe:X[:SCALe]:RPOSition LEFT|CENTer|RIGHt :DISPlay:DDEMod:TRACe:X[:SCALe]:RPOSition? Description Sets the position from which the X-axis scale reference value is calculated for the specified trace. Queries the position from which the X-axis scale reference value is calculated for the specified trace.
PAGE 372
RIGOL Chapter 4 Command System for VSA Mode :DISPlay:DDEMod:TRACe1:X:SCALe:SPAN 50 The following query returns 5.000000000e+01. :DISPlay:DDEMod:TRACe1:X:SCALe:SPAN? :DISPlay:DDEMod:TRACe:Y[:SCALe]:AUTO:ONCE Syntax :DISPlay:DDEMod:TRACe:Y[:SCALe]:AUTO:ONCE Description Sets the Y-axis reference level and the Y-axis scale value automatically to ensure that the signal can be fully displayed for better observation of the trace.
PAGE 373
RIGOL Chapter 4 Command System for VSA Mode :DISPlay:DDEMod:TRACe:Y[:SCALe]:RLEVel Syntax :DISPlay:DDEMod:TRACe:Y[:SCALe]:RLEVel :DISPlay:DDEMod:TRACe:Y[:SCALe]:RLEVel? Description Sets the Y-axis reference of the specified trace. Queries the Y-axis reference of the specified trace. Parameter Name Type Discrete Consecutive Real Number Range 1|2|3|4 -1e+12 to 1e+12 Default -0 Remarks The reference unit is determined by the Y-axis unit.
PAGE 374
RIGOL Chapter 4 Command System for VSA Mode :DISPlay:DDEMod:WINDow:FORMat Syntax :DISPlay:DDEMod:WINDow:FORMat SINGle|LRWindow|UDWindow|LRDWindow|UDRWindow|QUAD :DISPlay:DDEMod:WINDow:FORMat? Description Sets the trace window layout. Queries the trace window layout. Parameter Name Type -Keyword Range SINGle|LRWindow|UDWindow|LRDWindow|UDRWindow|QUAD Default QUAD Remarks SINGle: indicates the single window. LRWindow: indicates left and right windows. UDWindow: indicates top and bottom windows.
PAGE 375
RIGOL Chapter 4 Command System for VSA Mode :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 376
RIGOL Chapter 4 Command System for VSA Mode :FETCh Commands Command List:  :FETCh:BER?  :FETCh:DDEMod? :FETCh:BER? Syntax :FETCh:BER? Description Queries the bit error rate measurement results. :FETCh:DDEMod? Syntax :FETCh:DDEMod? Description Queries the digital demodulation measurement results.
PAGE 377
RIGOL Chapter 4 Command System for VSA Mode :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 378
RIGOL Chapter 4 Command System for VSA Mode 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. Return Format The query returns ASC,8, INT,32, REAL,32, or REAL,64. Example The following command sets the input/output format of the trace data to REAL,32. :FORMat:TRACe:DATA REAL,32 The following query returns REAL,32.
PAGE 379
Chapter 4 Command System for VSA Mode RIGOL IEEE 488.2 Common Commands IEEE 488.2 common commands are used to operate or query the status registers. For details of the commands, refer to Page "2-81".
PAGE 380
RIGOL Chapter 4 Command System for VSA Mode :INITiate Command Command List:  :INITiate:BER:RESTart  :INITiate:CONTinuous :INITiate:BER:RESTart Syntax :INITiate:BER:RESTart Description Restarts the BER test. Remarks This command is valide only when the BER Test measurement function is selected. :INITiate:CONTinuous Syntax :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Description Selects continuous (ON|1) or single (OFF|0) sweep mode. Queries the current sweep mode.
PAGE 381
RIGOL Chapter 4 Command System for VSA Mode :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 382
RIGOL Chapter 4 Command System for VSA Mode :INSTrument:NSELect :INSTrument[:SELect] Syntax :INSTrument:NSELect 1|2|3|4 :INSTrument:NSELect? :INSTrument[:SELect] SA|RTSA|VSA|EMI :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|3|4 SA|RTSA|VSA|EMI Default 1 SA Remarks The above parameters 1|2|3|4 correspond to SA|RTSA|VSA|EMI, respectively.
PAGE 383
RIGOL Chapter 4 Command System for VSA Mode :MMEMory Commands Command List:  :MMEMory:DELete  :MMEMory:LOAD:FMT  :MMEMory:LOAD:STATe  :MMEMory:LOAD:TRACe:DATA  :MMEMory:MOVE  :MMEMory:STORe:FMT  :MMEMory:STORe:SCReen  :MMEMory:STORe:STATe  :MMEMory:STORe:TRACe:DATA Remarks: The mode name in the path specified in this manual is "VSA" mode. :MMEMory:DELete Syntax :MMEMory:DELete Description Deletes a specified file.
PAGE 384
RIGOL Parameter Name Chapter 4 Command System for VSA Mode Type Keyword ASCII String Range UPPer|LOWer —— Default —— —— Remarks This operation fails if the specified file does not exist. Example The following command loads the FMT file (mask1.csv) to the upper mask. :MMEMory:LOAD:FMT upper,mask1.csv :MMEMory:LOAD:STATe Syntax :MMEMory:LOAD:STATe Description Loads the specified state file (.sta).
PAGE 385
RIGOL Chapter 4 Command System for VSA Mode :MMEMory:MOVE Syntax :MMEMory:MOVE , Description Renames the specified file as . Parameter Name Type ASCII String ASCII String Range --- Default --- Remarks and should contain the path and the filename. This operation fails if the file with the specified filename does not exist. Example The following command renames the state file (state1.
PAGE 386
RIGOL Parameter Name Chapter 4 Command System for VSA Mode Type ASCII String Range -- Default -- Remarks If the specified file already exists, overwrite it. If a suffix (.jpg/.png/.bmp) is added to the filename, you can save the current screen image with a different format based on its different suffix. If no suffix is added to the filename, then by default, the current screen image is saved in the currently selected format.
PAGE 387
Chapter 4 Command System for VSA Mode RIGOL Remarks If the specified file already exists, overwrite it. Example The following command saves Trace1 measurement data with the specified filename "mydata.csv" to the folder (/vsa/data).
PAGE 388
RIGOL Chapter 4 Command System for VSA Mode [:SENSe] Commands Command List:  [:SENSe]:ACQuisition:TIME  :INPut:IMPedance  [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]  [:SENSe]:CORRection:SA[:RF]:GAIN  [:SENSe]:DDEMod:ALPHa  [:SENSe]:DDEMod:FFT:WINDow[:TYPE]  [:SENSe]:DDEMod:FILTer:MEASurement  [:SENSe]:DDEMod:FILTer:MEASurement:USER[:DATA]  [:SENSe]:DDEMod:FILTer:REFerence  [:SENSe]:DDEMod:FILTer:REFerence:USER[:DATA]  [:SENSe]:DDEMod:FSK:DEViation:REFerence  [
PAGE 389
RIGOL Chapter 4 Command System for VSA Mode [:SENSe]:ACQuisition:TIME Syntax [:SENSe]:ACQuisition:TIME [:SENSe]:ACQuisition:TIME? Description Sets the acquisition time for producing one single trace. Queries the acquisition time for producing one single trace. Parameter Name Type Consecutive Real Number Range 100 ms to 40 s Default 99.9946 ms Return Format The query returns the acquisition time in scientific notation. Example The following command sets the acquisition time to 10 s.
PAGE 390
RIGOL Chapter 4 Command System for VSA Mode [:SENSe]:CORRection:SA[:RF]:GAIN Syntax [:SENSe]:CORRection:SA[:RF]:GAIN [:SENSe]:CORRection:SA[:RF]:GAIN? Description Sets the external gain. Queries the external gain. Parameter Name Type Consecutive Real Number Range -120 dB to 120 dB Default 0 dB Return Format The query returns the external gain value in scientific notation. The unit is dB. Example The following command sets the external gain value to 20 dB.
PAGE 391
RIGOL Chapter 4 Command System for VSA Mode [:SENSe]:DDEMod:FFT:WINDow[:TYPE] Syntax [:SENSe]:DDEMod:FFT:WINDow[:TYPE] UNIForm|HANNing|GAUSsian|FLATtop [:SENSe]:DDEMod:FFT:WINDow[:TYPE]? Description Sets the type of the FFT window function. Queries the type of the FFT window function. Parameter Name Type -Keyword Range UNIForm|HANNing|GAUSsian|FLATtop Default UNIForm Return Format The query returns UNIF, HANN, GAUS, or FLAT.
PAGE 392
RIGOL Chapter 4 Command System for VSA Mode [:SENSe]:DDEMod:FILTer:MEASurement:USER[:DATA] Syntax [:SENSe]:DDEMod:FILTer:MEASurement:USER[:DATA] {,} [:SENSe]:DDEMod:FILTer:MEASurement:USER[:DATA]? Description Sets the data of the specified measurement user-defined filter. Queries the data of the specified measurement user-defined filter.
PAGE 393
RIGOL Chapter 4 Command System for VSA Mode Example The following command sets the reference filter to GAUSsian. :SENSe:DDEMod:FILTer:REFerence GAUSsian The following query returns GAUS. :SENSe:DDEMod:FILTer:REFerence? [:SENSe]:DDEMod:FILTer:REFerence:USER[:DATA] Syntax [:SENSe]:DDEMod:FILTer:REFerence:USER[:DATA] {,} [:SENSe]:DDEMod:FILTer:REFerence:USER[:DATA]? Description Sets the data of the specified reference user-defined filter.
PAGE 394
RIGOL Chapter 4 Command System for VSA Mode Return Format The query returns the reference frequency offset in scientific notation. The unit is Hz. Example The following command sets the reference frequency offset to 1 MHz. :SENSe:DDEMod:FSK:DEViation:REFerence 1000000 The following query returns 1.000000000e+06.
PAGE 395
RIGOL Chapter 4 Command System for VSA Mode Parameter Name Type Consecutive Real Number Range -- Default -- Remarks Before performing the BER test, load the BER test reference file (.xml) first. should contain the path and the filename. Return Format The query returns the BER test filename. Example The following command loads the BER test file "ber1.xml" from the path "/vsa/BerTest". :SENSe:DDEMod:LOAD:KNOWndata /vsa/BerTest/ber1.xml The following query returns ber1.
PAGE 396
RIGOL Parameter Name Chapter 4 Command System for VSA Mode Type Discrete Range 4|8 Default 4 Return Format The query returns points/symbol in integer. Example The following command sets points/symbol to 4. :SENSe:DDEMod:PPSYmbol 4 The following query returns 4.
PAGE 397
RIGOL Chapter 4 Command System for VSA Mode Parameter Name Type Consecutive Real Number Range Refer to "Remarks" Default 1 MHz Remarks The minimum symbol rate is 1 kHz. The maximum symbol rate SRmax = SPmax × 1.28/(points/symbol). Wherein, SPmax is the maximum span. Return Format The query returns the symbol rate in scientific notation. Example The following command sets the symbol rate to 1 MHz. :SENSe:DDEMod:SRATe 1000000 The following query returns 1.000000000e+06.
PAGE 398
RIGOL Chapter 4 Command System for VSA Mode Remarks The minimum capture length is 10. The maximum capture length MImax is determined by points/symbol. When setting points/symbol to 4, MImax is 4096; when setting points/symbol to 8, MImax is 2048. Return Format The query returns the number of symbols in integer. Example The following command sets the number of symbols to 200. :SENSe:DDEMod:SWEep:POINts 200 The following query returns 200.
PAGE 399
RIGOL Chapter 4 Command System for VSA Mode Parameter Name Type Integer Range 0 to 16384 Default 0 Remarks This command is valide only when the burst search function is enabled. Return Format The query returns the burst search run-in in integer. Example The following command sets the burst search run-in to 50。 :SENSe:DDEMod:SYNC:BURSt:RUNIn 50 The following query returns 50.
PAGE 400
RIGOL Parameter Name Chapter 4 Command System for VSA Mode Type Consecutive Real Number Range 50 us to 16.3840 ms Default 50 us Return Format The query returns the burst search length in scientific notation. Example The following command sets the burst search length to 200 μs. :SENSe:DDEMod:SYNC:SLENgth 0.0002 The following query returns 2.000000000e-04.
PAGE 401
RIGOL Chapter 4 Command System for VSA Mode Return Format The query returns the bit pattern for the sync search in strings. Example The following command sets the bit pattern for the sync search to 1011010. :SENSe:DDEMod:SYNC:SWORd:PATTern 1011010 The following query returns 1011010. :SENSe:DDEMod:SYNC:SWORd:PATTern? [:SENSe]:DDEMod:SYNC:SWORd:STATe Syntax [:SENSe]:DDEMod:SYNC:SWORd:STATe OFF|ON|0|1 [:SENSe]:DDEMod:SYNC:SWORd:STATe? Description Enables or disables the sync word search.
PAGE 402
RIGOL Chapter 4 Command System for VSA Mode Example The following command sets the center frequency to 2 MHz. :SENSe:FREQuency:CENTer 2000000 The following query returns 2.000000000e+06. :SENSe:FREQuency:CENTer? [:SENSe]:FREQuency:CENTer:STEP:AUTO Syntax [:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1 [:SENSe]:FREQuency:CENTer:STEP:AUTO? Description Enables or disables the auto setting mode of the CF step. Queries the status of the auto setting mode of the CF step.
PAGE 403
RIGOL Chapter 4 Command System for VSA Mode The following query returns 1.000000000e+05. :SENSe:FREQuency:CENTer:STEP:INCRement? [:SENSe]:FREQuency:SPAN? Syntax [:SENSe]:FREQuency:SPAN? Description Queries the frequency span of the current channel. Return Format The query returns the span in scientific notation. The unit is Hz. Example The following query returns 3.125000000e+06.
PAGE 404
RIGOL Chapter 4 Command System for VSA Mode [: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 Range 3.125 kHz to Fmax Default center frequency + span/2 Return Format The query returns the stop frequency in scientific notation. The unit is Hz. Example The following command sets the stop frequency to 10 MHz.
PAGE 405
Chapter 4 Command System for VSA Mode RIGOL :STATus Commands For the details about the :STATus commands, refer to 2-180.
PAGE 406
RIGOL Chapter 4 Command System for VSA Mode :SYSTem Commands For the details about the :SYSTem commands, refer to 2-184.
PAGE 407
RIGOL Chapter 4 Command System for VSA Mode :TRACe Command Command List:  :TRACe[:DATA]? :TRACe[:DATA]? Syntax :TRACe[:DATA]? Description Queries the data of the specified trace. Parameter Name Type Discrete Range 1|2|3|4 Default -- Remarks The format of the user data is set by the :FORMat[:TRACe][:DATA] command. Return Format The query returns the data of the specified trace. The format of the returned data is determined by the settings of the :FORMat[:TRACe][:DATA] command.
PAGE 408
RIGOL Chapter 4 Command System for VSA Mode :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:CRITeria  :TRIGger[:SEQuence]:FMT:DELay  :TRIGger[:SEQuence]:FMT:DELay:STATe  :TRIGger[:SEQuence]:FMT:MASK  :TRIGger[:SEQuence]:FMT:MASK:EDIT  :TRIGger[:SEQuence]:FMT:MASK:RELative:AMPLitude
PAGE 409
RIGOL Chapter 4 Command System for VSA Mode Return Format The query returns the time value in scientific notation. The unit is s. Example The following command sets the time to 10 ms. :TRIGger:SEQuence:ATRigger 0.01 The following query returns 1.000000000e-02. :TRIGger:SEQuence:ATRigger? :TRIGger[:SEQuence]:ATRigger:STATe Syntax :TRIGger[:SEQuence]:ATRigger:STATe OFF|ON|0|1 :TRIGger[:SEQuence]:ATRigger:STATe? Description Enables or disables the auto trigger function.
PAGE 410
RIGOL Chapter 4 Command System for VSA Mode This command is only valid when the external trigger delay function is enabled. Return Format The query returns the delay time for the external trigger in scientific notation. The unit is s. Example The following command sets the delay time for External Trigger 1 to 100 ms. :TRIGger:SEQuence:EXTernal1:DELay 0.1 The following query returns 1.000000000e-01.
PAGE 411
RIGOL Chapter 4 Command System for VSA Mode Parameter Name -- Type Discrete Keyword Range 1|2 POSitive|NEGative Default -POSitive Remarks When the parameter n is set to 1, it indicates External Trigger 1; when set to 2, it indicates External Trigger 2. POSitive: indicates the rising edge. NEGative: indicates the falling edge. Return Format The query returns POS or NEG. Example The following command sets the trigger edge of External Trigger 1 to POSitive.
PAGE 412
RIGOL Chapter 4 Command System for VSA Mode :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 413
RIGOL Chapter 4 Command System for VSA Mode :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. Return Format The query returns UPP, LOW, or BOTH.
PAGE 414
RIGOL Chapter 4 Command System for VSA Mode :TRIGger[:SEQuence]:FMT:MASK:RELative:AMPLitude Syntax :TRIGger[:SEQuence]:FMT:MASK:RELative:AMPLitude OFF|ON|0|1 :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 415
RIGOL Chapter 4 Command System for VSA Mode 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.
PAGE 416
RIGOL Parameter Name Chapter 4 Command System for VSA Mode Type Discrete Consecutive Real Number Consecutive Real Number Range 1|2 0 Hz to 3 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.
PAGE 417
RIGOL Chapter 4 Command System for VSA Mode Remarks If the specified file already exists, overwrite it. When is set to 1, edit the upper mask; when set to 2, edit the lower mask. Example The following command saves the upper mask FMT file with the filename (mask1.csv) to the "/vsa/mask" folder. :TRIGger:SEQuence:FMT:MASK1:NAME mask1 The following query returns mask1.
PAGE 418
RIGOL Chapter 4 Command System for VSA Mode The following query returns 1.000000000e-01. :TRIGger:SEQuence:HOLDoff? :TRIGger[:SEQuence]:HOLDoff:STATe Syntax :TRIGger[:SEQuence]:HOLDoff:STATe OFF|ON|0|1 :TRIGger[:SEQuence]:HOLDoff:STATe? Description Turns on or off the trigger holdoff function. Queries the status of the trigger holdoff function. Parameter Name -- Type Bool Range OFF|ON|0|1 Default OFF|0 Return Format The query returns 1 or 0.
PAGE 419
RIGOL Chapter 4 Command System for VSA Mode :TRIGger[:SEQuence]:SOURce Syntax :TRIGger[:SEQuence]:SOURce EXTernal1|EXTernal2|IMMediate|FMT|POWer :TRIGger[:SEQuence]:SOURce? Description Sets the trigger source. Queries the trigger source. Parameter Name -- Type Keyword Range EXTernal1|EXTernal2|IMMediate|FMT|POWer Default IMMediate Remarks EXTernal1: indicates External Trigger 1. EXTernal2: indicates External Trigger 2. IMMediate: indicates the free-run trigger.
PAGE 420
RIGOL Chapter 4 Command System for VSA Mode :TRIGger2:MODE IN The following query returns 0.
PAGE 421
Chapter 5 Programming Examples RIGOL Chapter 5 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 422
RIGOL Chapter 5 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 423
Chapter 5 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 424
RIGOL Chapter 5 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 425
Chapter 5 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 426
RIGOL Chapter 5 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 427
Chapter 5 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 428
RIGOL Chapter 5 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 429
Chapter 5 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 430
RIGOL Chapter 5 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 431
Chapter 5 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 432
RIGOL Chapter 5 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 433
Chapter 5 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 434
RIGOL Chapter 5 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 435
Chapter 5 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 436
RIGOL 2) 5-16 Chapter 5 Programming Examples Write operation (including error confirmation) RSA3000E Programming Guide
PAGE 437
Chapter 5 Programming Examples 3) RIGOL Read operation (including error correction advice) RSA3000E Programming Guide 5-17
PAGE 438
RIGOL 5-18 Chapter 5 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 439
Chapter 5 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 440
RIGOL Chapter 5 Programming Examples spectrum analyzer to make its address to be within the same network segment where the PC resides. 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 441
Chapter 5 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 442
RIGOL Chapter 5 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 443
Chapter 5 Programming Examples RIGOL #endif 2. Edit the DemoForRSA.cpp file to realize various operations of the instrument. #include "visa.h" #include "DemoForRSA.
PAGE 444
RIGOL Chapter 5 Programming Examples } } break; //Acquire the next device status = viFindNext(*findList,instrDesc); if (bFindRSA == false) { printf("RSA device not found!\n"); return false; } } return true; bool DemoForRSA::InstrWrite(string strAddr, string strContent) //Write operation { ViSession defaultRM,instr; ViStatus status; ViUInt32 retCount; char * SendBuf = NULL; char * SendAddr = NULL; bool bWriteOK = false; string str; //Address conversion, convert the string type to char* SendAddr = con
PAGE 445
Chapter 5 Programming Examples RIGOL bool bReadOK = false; unsigned char RecBuf[MAX_REC_SIZE]; string str; memset(RecBuf,0,MAX_REC_SIZE); result=char*)malloc(MAX_REC_SIZE*sizeof(char)); memset(result,0,MAX_REC_SIZE); //Address conversion, convert the string type to char* SendAddr=const_cast(strAddr.c_str()); //Turn on the VISA device status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { // Error Initializing VISA...
PAGE 446
RIGOL Chapter 5 Programming Examples int main() { DemoForRSA demo; char temp[50]; if(!demo.ConnectInstr()) { cout<<"can not connect the equipment!"<>demo.m_strCommand; cin.getline(temp,50); demo.m_strCommand=temp; if(demo.m_strCommand[0]='r' && demo.m_strCommand[1]='e' && demo.m_strCommand[2]='a' && demo.m_strCommand[3]='d') { //demo.
PAGE 447
Chapter 5 Programming Examples } RIGOL cout<<"Bad command!"<
PAGE 448
PAGE 449
RIGOL Chapter 6 Appendix Chapter 6 Appendix Appendix A: Default Settings Sending the *RST command can restore the instrument to default settings, as shown in the table below.
PAGE 450
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 Setup Global CF Mode Meas Measurement Function Chapter 6 Appendix ---------- Enter Upper 1.
PAGE 451
RIGOL Chapter 6 Appendix 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 State Offset Freq Noise BW Carrier BW Harmo Dist[2] Avg Number Avg Mode Avg State No.
PAGE 452
RIGOL 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 Signal Ampt Up Ampt Down Marker Selected Marker Marker Mode Reference Marker Marker Trace Marker Trace Auto Marke
PAGE 453
RIGOL Chapter 6 Appendix Peak Table Sort Table Readout Display Line 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 Volume SCPI Display User key Language Amplitude All -25 dBm Amplitude All -25 dBm Off, -3.01 dB Off Off On, 100 ms Off, -3.
PAGE 454
RIGOL Chapter 6 Appendix Parameter Name EMI Parameter Value FREQ Frequency(Meter) 515 MHz Midspan Freq 515 MHz Start Freq Auto, 30 MHz Stop Freq Auto, 1 GHz Scale Type Log SPAN Span 970 MHz AMPT Ref Level 106.
PAGE 455
RIGOL Chapter 6 Appendix Margin Freq Interpolation Frequency Amplitude Build From Copy From X Offset Y Offset Select Signal Delete Sort Signals Sort Order Auto Sort Search Criteria Peak Num Subrange Num Select Range Range Start Freq Stop Freq Points Scan Time RBW Filter Type Attenuation RF Preamp Scan Table Scan Sequence (Re)measure Select Detector Dwell Time Detector Limit for Delta Marker Selected Marker Marker Mode Reference Marker Marker Trace Marker Frequency Line State Couple Markers Peak Peak Thres
PAGE 456
RIGOL Preset Type Align Auto LAN Setting Mode Display Line Graticule HDMI HDMI Resolution LCD LCD Backlight Meters Display Meters Freq Line Next Range Display Power Switch Beep Switch Volume SCPI Display User key Language Chapter 6 Appendix Default On DHCP Off, 81.99 dBuV On On 1280*720 60Hz On 100% On On Off Default Off 50 On Off English Note[1]: Not affected by Preset settings.
PAGE 457
RIGOL Chapter 6 Appendix Parameter Name FREQ Center Freq Start Freq Stop Freq CF Step SPAN X Scale Ref Value Width AMPT Ref Value Scale/Div Range Y Axis Unit Copy Y Scale BW FFT Window Trigger Trigger Source Slope Trigger Delay Power Trigger Hold-off Auto Trig Mask Type Trigger Mask Trigger Criteria Active Mask Frequency Amplitude X Offset Y Offset X Axis Type Y Axis Type Trace Selected Trace Capture Data Trace Format Eye Length Symbol Format Trace Det Mode Setup Global CF Meas Measurement Function Meas S
PAGE 458
RIGOL Ref Filter Alpha/BT Burst Search Length Burst Search Run-In Burst Search Sync Analyze Length Sync Search Sync Offset Window Layout Marker Selected Marker Marker Mode Reference Marker Marker Trace Couple Markers Marker Table Marker X Peak Cont Peak Marker Func Band Function Band Span System[1] Power On Preset Type Align Auto LAN Setting Mode Graticule HDMI HDMI Resolution LCD LCD Backlight Power Switch Beep Switch Volume SCPI Display User key Language Chapter 6 Appendix Raised Cosine 0.
PAGE 459
Chapter 6 Appendix RIGOL Appendix B: Warranty RIGOL (SUZHOU) 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.