RIGOL Programming Guide RSA5000 Series Real-time Spectrum Analyzer Jan. 26, 2018 RIGOL TECHNOLOGIES, INC.
RIGOL Guaranty and Declaration Copyright © 2017 RIGOL TECHNOLOGIES, INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL TECHNOLOGIES, INC. Publication Number PGD20102-1110 Software Version 00.01.00 Software upgrade might change or add product features. Please acquire the latest version of the manual from RIGOL website or contact RIGOL to upgrade the software. Notices RIGOL products are covered by P.R.C. and foreign patents, issued and pending.
RIGOL Document Overview This manual introduces how to program and control RIGOL RSA5000 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.
Contents RIGOL Contents Guaranty and Declaration ......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 Programming Overview......................................................................................1-1 Build Remote Communication .......................................................................
RIGOL Contents :CALCulate:MARKer:FUNCtion:BAND:RIGHt ................................................................. 2-23 :CALCulate:MARKer:FUNCtion:BAND:SPAN .................................................................. 2-24 :CALCulate:MARKer:FUNCtion:BAND:SPAN:AUTO ........................................................ 2-25 :CALCulate:MARKer:LINes[:STATe].............................................................................. 2-25 :CALCulate:MARKer:MAXimum:LEFT ............
Contents RIGOL :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle ........................................................ 2-51 :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:PDIVision ..................................................... 2-51 :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RLEVel ......................................................... 2-52 :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RPOSition ..................................................... 2-52 :DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:PDIVision .............
RIGOL Contents *ESE................................................................................................................................ 2-82 *ESR? .............................................................................................................................. 2-83 *IDN? .............................................................................................................................. 2-83 *OPC ............................................................................
Contents RIGOL :READ:TOIntercept? ....................................................................................................... 2-108 :READ:TOIntercept:IP3? ................................................................................................. 2-108 :READ:TPOWer? ............................................................................................................ 2-109 [:SENSe] Commands.............................................................................................
RIGOL Contents [:SENSe]:FREQuency:SPAN ............................................................................................. 2-141 [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio .............................................. 2-141 [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio:AUTO .................................... 2-142 [:SENSe]:FREQuency:SPAN:FULL .................................................................................... 2-142 [:SENSe]:FREQuency:SPAN:PREVious ...........
Contents RIGOL :SOURce:TRACe:STORref ............................................................................................... 2-170 :STATus Commands .............................................................................................................. 2-171 :STATus:OPERation:CONDition?....................................................................................... 2-172 :STATus:OPERation:ENABle ..........................................................................................
RIGOL Contents :TRIGger[:SEQuence]:EXTernal:DELay:STATe ............................................................ 2-202 :TRIGger[:SEQuence]:EXTernal:SLOPe ...................................................................... 2-203 :TRIGger[:SEQuence]:FMT:APTRigger ............................................................................. 2-203 :TRIGger[:SEQuence]:FMT:CRITeria ................................................................................ 2-204 :TRIGger[:SEQuence]:FMT:DELay .
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.
RIGOL Chapter 1 Programming Overview Build Remote Communication RSA5000 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.
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 RSA5000 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 RSA5000 remotely.
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).
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.
Chapter 2 Command System RIGOL Chapter 2 Command System This chapter introduces the commands of the RSA5000 series spectrum analyzer. Contents in this chapter: :CALCulate Commands :CALibration Commands :CONFigure Commands :COUPle Commands :DISPlay Commands :FETCh Commands :FORMat Commands IEEE 488.
RIGOL Chapter 2 Command System :CALCulate Commands Command List: :CALCulate:BANDwidth|BWIDth:NDB :CALCulate:BANDwidth|BWIDth:RESult? :CALCulate:BANDwidth|BWIDth:RLEFt? :CALCulate:BANDwidth|BWIDth:RRIGht? :CALCulate:BANDwidth|BWIDth [:STATe] :CALCulate:LLINe:ALL:DELete :CALCulate:LLINe:TEST :CALCulate:LLINe:AMPLitude:CMODe:RELative :CALCulate:LLINe:BUILd :CALCulate:LLINe:COPY :CALCulate:LLINe:DATA :CALCulate:LLINe:DELete :CALCulate:LLINe:DI
Chapter 2 Command System :CALCulate:MARKer:FCOunt:GATetime:AUTO :CALCulate:MARKer:FCOunt[:STATe] :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:N
RIGOL Chapter 2 Command System :CALCulate:BANDwidth|BWIDth:NDB Syntax :CALCulate:BANDwidth|BWIDth:NDB :CALCulate:BANDwidth|BWIDth:NDB? Description Sets the N value in N dB BW measurement. Queries the N value in N dB BW measurement. Parameter Name Type Consecutive Real Number Range -140 dB to -0.01 dB Default -3.01 dB Remarks This command is invalid for the PvT measurement mode in RTSA. Return Format The query returns the N value in scientific notation.
RIGOL Chapter 2 Command System :CALCulate:BANDwidth|BWIDth:RLEFt? Syntax :CALCulate:BANDwidth|BWIDth:RLEFt? Description Queries the frequency value of the frequency point that is located at the left side of the current marker with N dB fall or rise in its peak amplitude. Remarks This command is invalid for the PvT measurement mode in RTSA. Return Format The query returns the frequency value in scientific notation (with Hz as the unit).
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the N dB BW measurement function. :CALCulate:BANDwidth:STATe ON or :CALCulate:BANDwidth:STATe 1 :CALCulate:BWIDth:STATe ON or :CALCulate:BWIDth:STATe 1 The following query returns 1. :CALCulate:BANDwidth:STATe? :CALCulate:BWIDth:STATe? :CALCulate:LLINe:ALL:DELete Syntax :CALCulate:LLINe:ALL:DELete Description Deletes all the limit line data.
RIGOL Chapter 2 Command System :CALCulate:LLINe:AMPLitude:CMODe:RELative Syntax :CALCulate:LLINe:AMPLitude:CMODe:RELative OFF|ON|0|1 :CALCulate:LLINe:AMPLitude:CMODe:RELative? Description Enables or disables the coupling functions between the selected limit line data points and the reference level. Queries the status of the coupling functions between the selected limit line data points and the reference level.
RIGOL Chapter 2 Command System :CALCulate:LLINe:COPY Syntax :CALCulate:LLINe:COPY LLINE1|LLINE2|LLINE3|LLINE4|LLINE5|LLINE6 Description Copies the selected limit line to the current limit line. Parameter Name Type Discrete —— Keyword Range 1|2|3|4|5|6 LLINE1|LLINE2|LLINE3|LLINE4|LLINE5|LLINE6 Default —— —— Remarks If the limit line to be copied that you select is the same as the current limit line, no operation should be performed.
RIGOL Chapter 2 Command System The following query returns 50,100,0,100,150,1,200,200,1. :CALCulate:LLINe2:DATA? :CALCulate:LLINe:DELete Syntax :CALCulate:LLINe:DELete Description Deletes the selected limit line. Parameter Name Type Discrete Range 1|2|3|4|5|6 Default —— Example The following command deletes Limit Line 2.
RIGOL Chapter 2 Command System :CALCulate:LLINe:FAIL? Syntax :CALCulate:LLINe:FAIL? Description Queries the measurement results of the selected limit line and its associated trace. Parameter Name Type Discrete Range 1|2|3|4|5|6 Default —— Remarks If you enable the test for the displayed trace and its corresponding limit line, and each displayed trace has its corresponding limit line enabled, then you can run the command to query whether the trace test passes.
RIGOL Chapter 2 Command System :CALCulate:LLINe:MARGin Syntax :CALCulate:LLINe:MARGin :CALCulate:LLINe:MARGin? Description Sets the margin for the selected limit line. Queries the margin for the selected limit line. Parameter Name Type Discrete Consecutive Real Number Range 1|2|3|4|5|6 -40 dB to 0 dB Default —— 0 dB Return Format The query returns the margin for the limit line in scientific notation.
RIGOL Chapter 2 Command System :CALCulate:LLINe:TRACe Syntax :CALCulate:LLINe:TRACe 1|2|3|4|5|6 :CALCulate:LLINe:TRACe? Description Sets the trace to be tested against the current limit line. Queries the trace to be tested against the current limit line. Parameter Name —— Type Discrete Discrete Range 1|2|3|4|5|6 1|2|3|4|5|6 Default —— Refer to "Remarks" Remarks Limit Line 1 and 2: The default is Trace 1. Limit Line 3 and 4: The default is Trace 2.
RIGOL Chapter 2 Command System :CALCulate:LLINe2:TYPE UPPer The following query returns UPP. :CALCulate:LLINe2:TYPE? :CALCulate:MARKer:AOFF Syntax :CALCulate:MARKer:AOFF Description Turns off all the enabled markers. :CALCulate:MARKer:COUPle[:STATe] Syntax :CALCulate:MARKer:COUPle[:STATe] OFF|ON|0|1 :CALCulate:MARKer:COUPle[:STATe]? Description Enables or disables the couple marker function. Queries the state of the couple marker function.
RIGOL Chapter 2 Command System :CALCulate:MARKer:PEAK:EXCursion Syntax :CALCulate:MARKer:PEAK:EXCursion :CALCulate:MARKer:PEAK:EXCursion? Description Sets the amplitude of the peak. Its unit is dB. Queries the peak amplitude. Parameter Name Type Consecutive Real Number Range 0 dB to 100 dB Default 6 dB Return Format The query returns the peak amplitude in scientific notation. Example The following command sets the peak amplitude to 12 dB.
RIGOL Chapter 2 Command System :CALCulate:MARKer:PEAK:SEARch:MODE Syntax :CALCulate:MARKer:PEAK:SEARch:MODE PARameter|MAXimum :CALCulate:MARKer:PEAK:SEARch:MODE? Description Sets the peak search mode. Queries the peak search mode. Parameter Name —— Type Keyword Range PARameter|MAXimum Default MAXimum 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.
RIGOL Chapter 2 Command System :CALCulate:MARKer:PEAK:SORT :TRACe:MATH:PEAK:SORT Syntax :CALCulate:MARKer:PEAK:SORT FREQuency|AMPLitude :CALCulate:MARKer:PEAK:SORT? :TRACe:MATH:PEAK:SORT FREQuency| AMPLitude :TRACe:MATH:PEAK:SORT? Description Sets the sorting order of the data displayed in the peak table. Queries the sorting order of the data displayed in the peak table.
RIGOL Chapter 2 Command System Remarks ALL|NORMal: lists all the peaks defined by the peak criteria, and displays data based on the current sorting order in the peak table. GTDLine|DLMore: lists the peaks that are greater than the defined display line and that meet the peak criteria. LTDLine|DLLess: lists the peaks that are smaller than the defined display line and that meet the peak criteria. Return Format The query returns ALL (NORM), GTDL (DLM), or LTDL (DLL).
RIGOL Chapter 2 Command System :CALCulate:MARKer:PEAK:THReshold Syntax :CALCulate:MARKer:PEAK:THReshold :CALCulate:MARKer:PEAK:THReshold? Description Sets the peak threshold, and its default unit is dBm. 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 dB.
RIGOL Chapter 2 Command System :CALCulate:MARKer:TABLe[:STATe] Syntax :CALCulate:MARKer:TABLe[:STATe] OFF|ON|0|1 :CALCulate:MARKer:TABLe[:STATe]? Description Enables or disables the marker table. Queries the status of the marker table. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Return Format The query returns 0 or 1. Example The following command disables the marker table. :CALCulate:MARKer:TABLe:STATe OFF or :CALCulate:MARKer:TABLe:STATe 0 The following query returns 0.
RIGOL Chapter 2 Command System :CALCulate:MARKer:CPSearch[:STATe] Syntax :CALCulate:MARKer:CPSearch[:STATe] OFF|ON|0|1 :CALCulate:MARKer:CPSearch[:STATe]? Description Enables or disables continuous peak search function, and marks the peak value with n. Queries the status of continuous peak search function. Parameter Name —— Type Discrete Bool Range 1|2|3|4|5|6|7|8 OFF|ON|0|1 Default —— OFF|0 Return Format The query returns 0 or 1.
RIGOL Chapter 2 Command System :CALCulate:MARKer:FCOunt:GATetime:AUTO Syntax :CALCulate:MARKer:FCOunt:GATetime:AUTO OFF|ON|0|1 :CALCulate:MARKer:FCOunt:GATetime:AUTO? Description Turns on or off the auto gate time for Marker n. Queries the status of the auto gate time for Marker n. 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. Return Format The query returns 1 or 0.
RIGOL Chapter 2 Command System :CALCulate:MARKer:FCOunt:X? Syntax :CALCulate:MARKer:FCOunt:X? Description Queries the readout of the frequency counter of the specified marker. Parameter Name Type Discrete Range 1|2|3|4|5|6|7|8 Default —— Remarks This command is only available for GPSA mode. Return Format The query returns the readout in integer. Its unit is Hz. When the frequency counter function is disabled, the command returns NAN.
RIGOL Chapter 2 Command System :CALCulate:MARKer:FUNCtion:BAND:LEFT Syntax :CALCulate:MARKer:FUNCtion:BAND:LEFT :CALCulate:MARKer:FUNCtion:BAND:LEFT? Description Sets the left edge frequency or time of the signal involved in the calculation for the band function. Queries the left edge frequency or time of the signal involved in the calculation for the band function.
RIGOL Chapter 2 Command System Return Format The query returns the right edge frequency or time of the signal in scientific notation. Example The following command sets the right edge frequency of the signal involved in the calculation for the Marker 1 band function to 4 GHz. :CALCulate:MARKer1:FUNCtion:BAND:RIGHt 4000000000 The following query returns 4.000000000e+09.
RIGOL Chapter 2 Command System :CALCulate:MARKer:FUNCtion:BAND:SPAN:AUTO Syntax :CALCulate:MARKer:FUNCtion:BAND:SPAN:AUTO OFF|ON|0|1 :CALCulate:MARKer:FUNCtion:BAND:SPAN:AUTO? Description Enables or disables the band span auto function. Queries the status of band span auto function. Parameter Name -- Type Discrete Bool Range 1|2|3|4|5|6|7|8 OFF|ON|0|1 Default -ON|1 Remarks This command is only valid when the corresponding bandwidth function is enabled.
RIGOL Chapter 2 Command System :CALCulate:MARKer1:LINes:STATe ON or :CALCulate:MARKer1:LINes:STATe 1 The following query returns 1. :CALCulate:MARKer1:LINes:STATe? :CALCulate:MARKer:MAXimum:LEFT Syntax :CALCulate:MARKer:MAXimum:LEFT Description Searches for and marks the nearest peak which is located at the left side of the current peak and meets the peak search condition.
RIGOL Chapter 2 Command System :CALCulate:MARKer:MAXimum:NEXT Syntax :CALCulate:MARKer:MAXimum:NEXT Description Searches for and marks the peak whose amplitude on the trace is next to that of the current peak and which meets the peak search condition. Parameter Name Type Discrete Range 1|2|3|4|5|6|7|8 Default —— Remarks When no peak is found, a prompt message "No peak found" is displayed on the screen. Example The following command performs one next peak search, and marks with Marker 2.
RIGOL Chapter 2 Command System :CALCulate:MARKer:MINimum Syntax :CALCulate: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.
RIGOL Chapter 2 Command System :CALCulate:MARKer:PTPeak Syntax :CALCulate:MARKer:PTPeak Description Performs the peak-peak search and marks it with a specified marker. Parameter Name Type Discrete Range 1|2|3|4|5|6|7|8 Default —— Remarks After the command is executed, the marker mode of the specified marker selects "Delta" automatically. The peak search results will be marked by the reference marker (by default, the next marker), and the minimum search will be marked by the Delta marker.
RIGOL Chapter 2 Command System :CALCulate:MARKer[:SET]:CENTer Syntax :CALCulate:MARKer[:SET]:CENTer Description Sets the frequency of the specified marker to the center frequency 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 will be set to the frequency of the marker.
RIGOL Chapter 2 Command System :CALCulate:MARKer[:SET]:DELTa:SPAN Syntax :CALCulate:MARKer[:SET]:DELTa:SPAN Description Sets the frequency difference of the specified Delta marker to the span of the analyzer. Parameter Name Type Range Default Discrete 1|2|3|4|5|6|7|8 —— 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.
RIGOL Chapter 2 Command System :CALCulate:MARKer[:SET]:STARt Syntax :CALCulate:MARKer[:SET]:STARt Description Sets the frequency of the specified marker to the start frequency 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 start frequency will be set to the frequency of the marker.
RIGOL Chapter 2 Command System :CALCulate:MARKer[:SET]:STOP Syntax :CALCulate:MARKer[:SET]:STOP Description Sets the frequency of the specified marker to the stop frequency 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 stop frequency will be set to the frequency of the marker. If the specified marker mode is Delta, the stop frequency will be set to the frequency of the Delta marker.
RIGOL Chapter 2 Command System :CALCulate:MARKer:TRACe Syntax :CALCulate:MARKer:TRACe :CALCulate:MARKer:TRACe? Description Sets the marker trace for the specified marker. Queries the marker trace for the specified marker. Parameter Name Type Discrete Discrete Range 1|2|3|4|5|6|7|8 1|2|3|4|5|6 Default —— 1 Remarks indicates the marker trace, and its range is from Trace 1 to Trace 6. The selected trace must be enabled.
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command sets the marker trace of Marker 1 to Auto. :CALCulate:MARKer1:TRACe:AUTO ON or :CALCulate:MARKer1:TRACe:AUTO 1 The following query returns 1. :CALCulate:MARKer1:TRACe:AUTO? :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.
RIGOL Chapter 2 Command System :CALCulate:MARKer:X:READout Syntax :CALCulate:MARKer:X:READout FREQuency|TIME|ITIMe|PERiod :CALCulate:MARKer:X:READout? Description Sets the readout mode of the X axis of the specified marker. Queries the readout mode of the X axis of the specified marker. Parameter Name —— Type Discrete Keyword Range 1|2|3|4|5|6|7|8 FREQuency|TIME|ITIMe|PERiod Default —— Refer to "Remarks" Remarks FREQuency: indicates frequency.
RIGOL Chapter 2 Command System Example The following command enables the auto readout mode of Marker 1 in the X-axis. :CALCulate:MARKer1:X:READout:AUTO ON or :CALCulate:MARKer1:X:READout:AUTO 1 The following query returns 1. :CALCulate:MARKer1:X:READout:AUTO? :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.
RIGOL Chapter 2 Command System :CALCulate:MARKer:Z:POSition Syntax :CALCulate:MARKer:Z:POSition :CALCulate:MARKer:Z:POSition? Description Sets the trace number of the trace where the marker stays in the Spectrogram view. Queries the trace number of the trace where the marker stays in the Spectrogram view.
RIGOL Chapter 2 Command System Remarks PDIFference: indicates the power difference between Operand 1 and Operand 2. PSUM: indicates the power sum between Operand 1 and Operand 2. LOFFset: indicates the sum between Operand 1 and the offset parameter . LMOFFset: indicates the difference between Operand 1 and the offset parameter . LDIFference: indicates that Operand 1 (Op1) minus Operand 2 (Op2), and then plus the reference parameter value .
RIGOL Chapter 2 Command System :CALibration Commands Command List: :CALibration:[ALL] :CALibration:AUTO :CALibration:[ALL] Syntax :CALibration:[ALL] Description Executes self-calibration immediately. Remarks If the self-calibration succeeded, the command :CALibration:[ALL]? returns 0; if failed, the command :CALibration:[ALL]? returns 1. Example The following command executes the self-calibration immediately.
Chapter 2 Command System RIGOL :CONFigure Commands Command List: :CONFigure? :CONFigure:ACPower* :CONFigure:CNRatio* :CONFigure:DENSity :CONFigure:DSPEctrogram :CONFigure:EBWidth* :CONFigure:HDISt* :CONFigure:LPSTep :CONFigure:MCHPower* :CONFigure:NORMal :CONFigure:OBWidth* :CONFigure:PSGRam :CONFigure:PSPectrum :CONFigure:PVT :CONFigure:SANalyzer :CONFigure:SPECtrogram :CONFigure:TOI* :CONFigure:TPOWer* Remarks: The commands with * are
RIGOL Chapter 2 Command System :CONFigure:ACPower Syntax :CONFigure:ACPower Description Sets the analyzer to be in the ACP measurement state. Remarks This command is only available for GPSA mode. Running this command will discontinue the current measurement and restore the specified measurement of the instrument to the default factory state. After changing any measurement setup, running the :READ Commands will initialize the measurement, and you do not have to set the measurement to the default.
Chapter 2 Command System RIGOL :CONFigure:DSPEctrogram Syntax :CONFigure:DSPEctrogram Description Sets the analyzer to be in the Density Spectrogram measurement state. Remarks This command is only available for RTSA mode. Running this command will discontinue the current measurement and restore the specified measurement of the instrument to the default factory state. :CONFigure:EBWidth Syntax :CONFigure:EBWidth Description Sets the analyzer to be in the EBW measurement state.
RIGOL Chapter 2 Command System :CONFigure:MCHPower Syntax :CONFigure:MCHPower Description Sets the analyzer to be in the MCHP measurement state. Remarks This command is only available for GPSA mode. Running this command will discontinue the current measurement and restore the specified measurement of the instrument to the default factory state. After changing any measurement setup, running the :READ Commands will initialize the measurement, and you do not have to set the measurement to the default.
Chapter 2 Command System RIGOL :CONFigure:PSGRam Syntax :CONFigure:PSGRam Description Sets the analyzer to be in the PvT Spectrogram measurement state. Remarks This command is only available for RTSA mode. Running this command will discontinue the current measurement and restore the specified measurement of the instrument to the default factory state. :CONFigure:PSPectrum Syntax :CONFigure:PSPectrum Description Sets the analyzer to be in the PvT Spectrum measurement state.
RIGOL Chapter 2 Command System :CONFigure:SPECtrogram Syntax :CONFigure:SPECtrogram Description Sets the analyzer to be in the Spectrogram measurement state. Remarks This command is only available for RTSA mode. Running this command will discontinue the current measurement and restore the specified measurement of the instrument to the default factory state. :CONFigure:TOI Syntax :CONFigure:TOI Description Sets the analyzer to be in the TOI measurement state.
Chapter 2 Command System RIGOL :COUPle Commands Command List: :COUPle :COUPle Syntax :COUPle ALL Description Sets all the manual/auto settings in the current measurement mode to "Auto".
RIGOL Chapter 2 Command System :DISPlay Commands Command List: :DISPlay:BACKlight :DISPlay:ENABle :DISPlay:GRATicule[:STATe] :DISPlay:HDMI[:STATe] :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:PDIVision :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RLEVel :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RPOSition :DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:PDIVision :DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:RLEVel :DISPlay:VIEW:DENSity:AADJust
RIGOL Chapter 2 Command System :DISPlay:BACKlight Syntax :DISPlay:BACKlight :DISPlay:BACKlight? Description Sets the brightness of the backlight of LCD. Queries the brightness of the backlight of LCD. Parameter Name Type Integer Range 1 to 100 Default 100 Return Format The query returns the brightness of the LCD backlight in integer. Example The following command sets the brightness of the LCD backlight to 50. :DISPlay:BACKlight 50 The following query returns 50.
RIGOL Chapter 2 Command System :DISPlay:GRATicule[:STATe] Syntax :DISPlay:GRATicule[:STATe] OFF|ON|0|1 :DISPlay:GRATicule[:STATe]? Description Enables or disables the display of the graticule. Queries the display of the graticule. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Return Format The query returns 0 or 1. Example The following command enables display of the graticule. :DISPlay:GRATicule:STATe ON or :DISPlay:GRATicule:STATe 1 The following query returns 1.
RIGOL Chapter 2 Command System :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle Syntax :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle OFF|ON|0|1 :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle? Description Enables or disables the auto scale function for the horizontal axis in the PvT view. Queries the status of the auto scale function for the horizontal axis in the PvT view.
RIGOL Chapter 2 Command System :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. Parameter Name Type Consecutive Real Number Range -1 s to 40 s Default 0 μs Remarks This command is only valid when the PvT view in RTSA mode is selected.
RIGOL Chapter 2 Command System :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. Parameter Name
RIGOL Chapter 2 Command System :DISPlay:VIEW:DENSity:AADJust Syntax :DISPlay:VIEW:DENSity:AADJust Description Sets the highest density hue to the highest density value found in the current bitmap; sets the lowest density hue to the lowest non-zero density value found in the current bitmap. Remarks This command is only available for Density and Density Spectrogram in RTSA mode.
RIGOL Chapter 2 Command System :DISPlay:VIEW:DENSity:CPALettes Syntax :DISPlay:VIEW:DENSity:CPALettes COOL|WARM|RADar|FIRE|FROSt :DISPlay:VIEW:DENSity:CPALettes? Description Sets the color palette of Density. Queries the color palette of Density. Parameter Name —— Type Keyword Range COOL|WARM|RADar|FIRE|FROSt Default WARM Remarks This command is only available for Density and Density Spectrogram in RTSA mode. Return Format The query returns COOL, WARM, RAD, FIRE, or FROS.
RIGOL Chapter 2 Command System :DISPlay:VIEW:DENSity:LDHue Syntax :DISPlay:VIEW:DENSity:LDHue :DISPlay:VIEW:DENSity:LDHue? Description Sets the lowest density hue. Queries the lowest density hue. Parameter Name Type Consecutive Real Number Range 0 to 99.9 Default 0 Remarks This command is only available for Density and Density Spectrogram in RTSA mode. Return Format The query returns the lowest density hue in scientific notation.
RIGOL Chapter 2 Command System :DISPlay:VIEW:DENSity:PERSistence:INFinite Syntax :DISPlay:VIEW:DENSity:PERSistence:INFinite OFF|ON|0|1 :DISPlay:VIEW:DENSity:PERSistence:INFinite? Description Enables or disables the infinite mode of the persistence time. Queries the status of the infinite mode of the persistence time. Parameter Name Type —— Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for Density and Density Spectrogram in RTSA mode. Return Format The query returns 0 or 1.
RIGOL Chapter 2 Command System Example The following commands sets the current view to Spectrogram. :DISPlay:VIEW:SELect SPECtrogram The following query returns SPEC. :DISPlay:VIEW:SELect? :DISPlay:VIEW:SPECtrogram:AADJust Syntax :DISPlay:VIEW:SPECtrogram:AADJust Description Auto adjusts the reference hue position and bottom hue position based on the highest amplitude value and the lowest amplitude value found in the spectrogram, respectively.
RIGOL Chapter 2 Command System :DISPlay:VIEW:SPECtrogram:HUE Syntax :DISPlay:VIEW:SPECtrogram:HUE :DISPlay:VIEW:SPECtrogram:HUE? Description Sets the reference hue. Queries the reference hue. Parameter Name Type Consecutive Real Number Range 0 to 359.9 Default 0 Remarks The reference hue indicates the hue value at the top of the color bar in the spectrogram. This command is only available for Spectrogram in RTSA mode or the view that contains the spectrogram.
RIGOL Chapter 2 Command System The following query returns 146. :DISPlay:VIEW:SPECtrogram:POSition? :DISPlay:VIEW:SPECtrogram:REFerence Syntax :DISPlay:VIEW:SPECtrogram:REFerence :DISPlay:VIEW:SPECtrogram:REFerence? Description Sets the position of the reference hue displayed in the graticule. Queries the position of the reference hue displayed in the graticule.
RIGOL Chapter 2 Command System Example The following command enables coupling the marker to the trace. :DISPlay:VIEW:SPECtrogram:TRACe:COUPle ON or :DISPlay:VIEW:SPECtrogram:TRACe:COUPle 1 The following query returns 1. :DISPlay:VIEW:SPECtrogram:TRACe:COUPle? :DISPlay:VIEW:SPECtrogram:TRACe:SELection Syntax :DISPlay:VIEW:SPECtrogram:TRACe:SELection TIME|TNUMber :DISPlay:VIEW:SPECtrogram:TRACe:SELection? Description Sets the selection method for the displayed trace.
RIGOL Chapter 2 Command System 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. Example The following command selects the PvT window in the PvT Spectrum view. :DISPlay:WINDow:SELect PVT The following query returns PVT. :DISPlay:WINDow:SELect? :DISPlay:WINDow:TRACe:Y:DLINe Syntax :DISPlay:WINDow:TRACe:Y:DLINe :DISPlay:WINDow:TRACe:Y:DLINe? Description Sets the position of the display line.
RIGOL Chapter 2 Command System :DISPlay:WINDow:TRACe:Y:DLINe:STATe Syntax :DISPlay:WINDow:TRACe:Y:DLINe:STATe OFF|ON|0|1 :DISPlay:WINDow:TRACe:Y:DLINe:STATe? Description Turns on or off the display line. Queries the status of the display line. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Return Format The query returns 0 or 1. Example The following command enables the display line.
RIGOL Chapter 2 Command System :DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition Syntax :DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition :DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition? Description Sets the reference position of normalization. Queries the reference position of normalization. Parameter Name Type Integer Range 0% to 100% Default 100% Remarks This command is only available for RSA5065-TG/RSA5032-TG working in GPSA mode.
RIGOL Chapter 2 Command System :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel Syntax :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel? Description Sets the reference level. Queries the reference level. Parameter Name Type Consecutive Real Number Range -170 dBm to 30 dBm Default 0 dBm Return Format The query returns the reference level in scientific notation. Example The following command sets the reference level to -10 dB.
RIGOL Chapter 2 Command System :DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing Syntax :DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing LINear|LOGarithmic :DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing? Description Sets the Y-axis scale type. Queries the Y-axis scale type. Parameter Name —— Type Keyword Range LINear|LOGarithmic Default LOGarithmic Remarks LINear: indicates linear. LOGarithmic: indicates log. Return Format The query returns LIN or LOG. Example The following command sets the Y-axis scale type to LOG.
Chapter 2 Command System RIGOL :FETCh Commands Command List: :FETCh:ACPower? :FETCh:ACPower:LOWer? :FETCh:ACPower:MAIN? :FETCh:ACPower:UPPer? :FETCh:CNRatio? :FETCh:CNRatio:CARRier? :FETCh:CNRatio:CNRatio? :FETCh:CNRatio:NOISe? :FETCh:EBWidth? :FETCh:HARMonics:AMPLitude:ALL? :FETCh:HARMonics:AMPLitude? :FETCh:HARMonics[:DISTortion]? :FETCh:HARMonics:FREQuency:ALL? :FETCh:HARMonics:FREQuency? :FETCh:HARMonics:FUNDamental? :FETCh:OBWidth?
RIGOL Chapter 2 Command System :FETCh:ACPower? Syntax :FETCh:ACPower? Description Queries the results of adjacent channel power measurement. Remarks This command is only valid when the adjacent channel power measurement in GPSA mode is enabled. The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer.
Chapter 2 Command System RIGOL :FETCh:ACPower:MAIN? Syntax :FETCh:ACPower:MAIN? Description Queries the main channel power of the adjacent channel power measurement. Remarks This command is only valid when the adjacent channel power measurement in GPSA mode is enabled. The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer.
RIGOL Chapter 2 Command System :FETCh:CNRatio? Syntax :FETCh:CNRatio? Description Queries the results of C/N ratio measurement. Remarks This command is only valid when the C/N ratio measurement in GPSA mode is enabled. The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer.
Chapter 2 Command System RIGOL :FETCh:CNRatio:CNRatio? Syntax :FETCh:CNRatio:CNRatio? Description Queries the results of C/N ratio measurement. Remarks This command is only valid when the C/N ratio measurement in GPSA mode is enabled. This command will select data from the latest measurement results, and then transmit the data to the output buffer. Return Format The query returns the C/N ratio in scientific notation. Example The following query returns 8.956909000e-02.
RIGOL Chapter 2 Command System :FETCh:EBWidth? Syntax :FETCh:EBWidth? Description Queries the result of the emission bandwidth measurement. Remarks This command is only valid when the emission bandwidth measurement in GPSA mode is enabled. This command will select data from the latest measurement results, and then transmit the data to the output buffer. Return Format The query returns the emission bandwidth in integer, and its unit is Hz. Example The following query returns 5.000000000e+04.
RIGOL Chapter 2 Command System :FETCh:HARMonics:AMPLitude? Syntax :FETCh:HARMonics:AMPLitude? Description Queries the amplitude of the specified harmonic. Parameter Name Type Integer Range 1 to 10 Default —— Remarks This command is only valid when the harmonic distortion measurement in GPSA mode is enabled. The amplitude unit of the return value is consistent with the current Y-axis unit. The query returns --- when the harmonic read does not have data.
RIGOL Chapter 2 Command System :FETCh:HARMonics:FREQuency:ALL? Syntax :FETCh:HARMonics:FREQuency:ALL? Description Queries the frequencies of the first 10 harmonics. The first harmonic is the fundamental waveform. Remarks This command is only valid when the harmonic distortion measurement in GPSA mode is enabled. This command will select data from the latest measurement results, and then transmit the data to the output buffer.
Chapter 2 Command System RIGOL :FETCh:HARMonics:FUNDamental? Syntax :FETCh:HARMonics:FUNDamental? Description Queries the frequency of the fundamental waveform. Remarks This command is only valid when the harmonic distortion measurement in GPSA mode is enabled. This command has the same function as :FETCh:HARMonics:FREQuency? 1. This command will select data from the latest measurement results, and then transmit the data to the output buffer.
RIGOL Chapter 2 Command System :FETCh:OBWidth:OBWidth? Syntax :FETCh:OBWidth:OBWidth? Description Queries the occupied bandwidth. Remarks This command is only valid when the occupied bandwidth measurement in GPSA mode is enabled. This command will select data from the latest measurement results, and then transmit the data to the output buffer. Return Format The query returns the occupied bandwidth in scientific notation. Its unit is Hz. Example The following query returns 1.860000000e+06.
RIGOL Chapter 2 Command System :FETCh:SANalyzer? Syntax :FETCh:SANalyzer? Description Queries the measurement results or trace data in the cache area. Parameter Name Type Discrete Range 1|2|3|4|5|6 Default —— Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only valid in GPSA mode. Return Format The query returns the measurement data of Trace n in scientific notation.
RIGOL Chapter 2 Command System :FETCh:TOIntercept:IP3? Syntax :FETCh:TOIntercept:IP3? Description The query returns the minor value of the intercepts of the Third Order Lower and Third Order Upper. Remarks This command is only valid when the TOI measurement in GPSA mode is enabled. This command will select data from the latest measurement results, and then transmit the data to the output buffer. Return Format The query returns the minor one in scientific notation. Example The following query returns -8.
RIGOL Chapter 2 Command System :FORMat Commands Command List: :FORMat:BORDer :FORMat[:TRACe][:DATA] :FORMat:BORDer Syntax :FORMat:BORDer NORMal|SWAPped :FORMat:BORDer? Description Selects the binary data byte order for data transmission. Queries the binary data byte order for data transmission.
RIGOL Chapter 2 Command System :FORMat[:TRACe][:DATA] Syntax :FORMat[:TRACe][:DATA] ASCii|INTeger,32|REAL,32|REAL,64 :FORMat[:TRACe][:DATA]? Description Sets the input/output format of the trace data. Queries the input/output format of the trace data. Parameter Name —— Type Keyword Range ASCii|INTeger,32|REAL,32|REAL,64 Default ASCii Remarks ASCii: ASCII characters, separated by commas. INTeger,32: binary 32-bit integer values. REAL,32: binary 32-bit real values. REAL,64: binary 64-bit real values.
Chapter 2 Command System RIGOL IEEE 488.2 Common Commands IEEE 488.2 common commands are used to operate or query the status registers. For the structure of the status register, refer to ":STATus Commands".
RIGOL Chapter 2 Command System *CLS Syntax *CLS Description Clears all the event registers and status byte registers. *ESE Syntax *ESE *ESE? Description Sets the enable register for the standard event status register. Queries the enable register for the standard event status register. Parameter Name Type Integer Range Refer to "Remarks" Default 0 Remarks Bit 2, bit 3, bit 4, and bit 7 are reserved; you can set their values but they will not affect the system.
Chapter 2 Command System RIGOL *ESR? Syntax *ESR? Description Queries and clears the event register for the standard event status register. Remarks Bit 1 and bit 6 in the standard event status register are not in use, and are regarded as 0. The query returns a decimal value that corresponds to the binary values ranging from 00000000 (0 in decimal) to 11111111 (255 in decimal) and of which bit 1 and bit 6 are 0. Return Format The query returns an integer.
RIGOL Chapter 2 Command System *OPC Syntax *OPC *OPC? Description Sets bit 0 (Operation Complete, OPC) in the standard event status register to 1 after the current operation is finished. Queries whether the current operation is finished. Return Format The query returns 1 after the current operation is finished; otherwise, the query returns 0. *RCL Syntax *RCL Description Recalls the selected register.
RIGOL Chapter 2 Command System *SAV Syntax *SAV Description Saves the current instrument state to the selected register. Parameter Name Type Integer Range 1 to 16 Default —— Example The following command saves the current instrument state to Register 1. *SAV 1 *SRE Syntax *SRE *SRE? Description Sets the enable register for the status byte register. Queries the enable register for the status byte register.
RIGOL Chapter 2 Command System *STB? Syntax *STB? Description Queries the event register for the status byte register. Remarks Bit 0 and Bit 1 in the status byte register are not in use, and are regarded as 0. The query returns a decimal value that corresponds to the binary values ranging from 00000000 (0 in decimal) to 11111111 (255 in decimal) and of which Bit 0 and Bit 1 are 0. Return Format The query returns an integer. The integer equals to the binary-weighted sum of all the bits set in the register.
RIGOL Chapter 2 Command System :INITiate Commands Command List: :INITiate:CONTinuous :INITiate[:IMMediate] Remarks: The commands with * are only available for the RSA5000 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.
RIGOL Chapter 2 Command System :INSTrument Commands Command List: :INSTrument:COUPle:FREQuency:CENTer :INSTrument:DEFault :INSTrument:NSELect :INSTrument[:SELect] :INSTrument:COUPle:FREQuency:CENTer Syntax :INSTrument:COUPle:FREQuency:CENTer ALL|NONE :INSTrument:COUPle:FREQuency:CENTer? Description Turns on or off the global center frequency of the instrument. Queries the setting status of the global center frequency of the instrument.
RIGOL Chapter 2 Command System :INSTrument:NSELect :INSTrument[:SELect] Syntax :INSTrument:NSELect 1|2 :INSTrument:NSELect? :INSTrument[:SELect] SA|RTSA :INSTrument[:SELect]? Description Selects the working mode of the instrument. Queries the working mode of the instrument. Parameter Name —— —— Type Discrete Keyword Range 1|2 SA|RTSA Default 1 SA Remarks The above parameters 1|2 correspond to SA|RTSA, respectively.
RIGOL Chapter 2 Command System :MMEMory Commands Command List: :MMEMory:DELete :MMEMory:LOAD:FMT :MMEMory:LOAD:LIMit :MMEMory:LOAD:STATe :MMEMory:LOAD:TRACe :MMEMory:LOAD:TRACe:DATA :MMEMory:MOVE :MMEMory:STORe:LIMit :MMEMory:STORe:MTABle :MMEMory:STORe:PTABle :MMEMory:STORe:RESults :MMEMory:STORe:SCReen :MMEMory:STORe:STATe :MMEMory:STORe:TRACe :MMEMory:STORe:TRACe:DATA Remarks: The mode name in the following path contains "gpsa" and rtsa" modes.
RIGOL Chapter 2 Command System :MMEMory:LOAD:FMT Syntax :MMEMory:LOAD:FMT
RIGOL Chapter 2 Command System :MMEMory:LOAD:STATe Syntax :MMEMory:LOAD:STATe Description Imports the specified state file (.sta). Parameter Name Type ASCII String Range —— Default —— Remarks This operation fails if the specified file does not exist. Example The following command imports the state file (state1.sta) to the instrument. :MMEMory:LOAD:STATe state1.sta :MMEMory:LOAD:TRACe Syntax :MMEMory:LOAD:TRACe , Description Imports the specified trace file (.
RIGOL Chapter 2 Command System :MMEMory:LOAD:TRACe:DATA Syntax :MMEMory:LOAD:TRACe:DATA , Description Imports the specified measurement data file (.csv). Parameter Name Type Keyword ASCII String Range TRACE1|TRACE2|TRACE3|TRACE4|TRACE5|TRACE6 —— Default —— —— Remarks This operation fails if the specified file does not exist. Example The following command imports the measurement data file (trace1.csv) to Trace1. :MMEMory:LOAD:TRACe:DATA TRACE1,trace1.
RIGOL Chapter 2 Command System :MMEMory:STORe:LIMit Syntax :MMEMory:STORe:LIMit , Description Saves the currently edited limit line with a specified filename suffixed with ".csv" by default (you do not have to add the suffix manually) to a default path (/"mode name"/limit). Parameter Name Type Keyword ASCII String Range LLINE1|LLINE2|LLINE3|LLINE4|LLINE5|LLINE6 —— Default —— —— Remarks If the specified file already exists, overwrite it.
RIGOL Chapter 2 Command System :MMEMory:STORe:PTABle Syntax :MMEMory:STORe:PTABle Description Saves the peak table with a specified filename suffixed with ".csv" by default (you do not have to add the suffix manually) to the default path (/"mode name"/measdata). Parameter Name Type ASCII String Range —— Default —— Remarks If the specified file already exists, overwrite it.
RIGOL Chapter 2 Command System :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/.
RIGOL Chapter 2 Command System :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 Keyword ASCII String Range TRACE1|TRACE2|TRACE3|TRACE4|TRACE5|TRACE6 —— Default —— —— Remarks If the specified file already exists, overwrite it.
RIGOL Chapter 2 Command System :OUTPut Commands Command List: :OUTPut[:EXTernal][:STATe] :OUTPut[:EXTernal][:STATe] Syntax :OUTPut[:EXTernal][:STATe] OFF|ON|0|1 :OUTPut[:EXTernal][:STATe]? Description Enables or disables the output of the tracking generator. Queries the on/off status of the tracking generator. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for RSA5065-TG/RSA5032-TG working in GPSA mode.. Return Format The query returns 0 or 1.
Chapter 2 Command System RIGOL :READ Commands Both the :READ and :FETCh Commands are used to acquire the measurement results. The difference is that the :FETCh Commands acquire the measurement results immediately, whereas the :READ commands start a measurement and return the measurement results after the measurement operation is finished.
RIGOL Chapter 2 Command System :READ:ACPower? Syntax :READ:ACPower? Description Executes one adjacent channel power measurement and returns the measurement results. Remarks The power unit of the returned value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode.
Chapter 2 Command System RIGOL :READ:ACPower:MAIN? Syntax :READ:ACPower:MAIN? Description Executes one adjacent channel power measurement and returns the main channel power. Remarks The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode. Return Format The query returns the main channel power in scientific notation.
RIGOL Chapter 2 Command System :READ:CNRatio:CARRier? Syntax :READ:CNRatio:CARRier? Description Executes one C/N ratio measurement and returns the carrier power. Remarks The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode. Return Format The query returns the carrier power in scientific notation. For example, -1.
Chapter 2 Command System RIGOL :READ:EBWidth? Syntax :READ:EBWidth? Description Executes one emission bandwidth measurement and returns the measurement results. 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 emission bandwidth measurement results in scientific notation, and its unit is Hz. For example, 5.
RIGOL Chapter 2 Command System :READ:HARMonics:AMPLitude? Syntax :READ:HARMonics:AMPLitude? Description Executes one harmonic distortion measurement and returns the amplitude of the specified harmonic. Parameter Name Type Integer Range 1 to 10 Default —— Remarks 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.
RIGOL Chapter 2 Command System :READ:HARMonics:FREQuency:ALL? Syntax :READ:HARMonics:FREQuency:ALL? Description Executes one harmonic distortion measurement and returns the frequencies 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. 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.
RIGOL Chapter 2 Command System :READ:HARMonics:FUNDamental? Syntax :READ:HARMonics:FUNDamental? Description Executes one harmonic distortion measurement and returns the frequency of the fundamental waveform. Remarks This command has the same function as :READ:HARMonics:FREQuency? 1. 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.
RIGOL Chapter 2 Command System :READ:OBWidth:OBWidth:FERRor? Syntax :READ:OBWidth:OBWidth:FERRor? Description Executes one occupied bandwidth measurement and returns the transmit frequency error. 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 transmit frequency error in scientific notation. The unit is Hz. For example, 2.
RIGOL Chapter 2 Command System :READ:TOIntercept? Syntax :READ:TOIntercept? Description Executes one TOI measurement and returns the measurement results. Remarks The amplitude 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.
Chapter 2 Command System RIGOL :READ:TPOWer? Syntax :READ:TPOWer? Description Executes one T-power measurement and returns the measurement results. Remarks The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode. Return Format The query returns the T-power measurement result in scientific notation. For example, -1.
RIGOL Chapter 2 Command System [: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 :TRACe:AVERage:COUNt [:SENSe]:AVERage:COUNt:CURR
Chapter 2 Command System [:SENSe]:DEMod [:SENSe]:DEMod:GAIN:AUTO [:SENSe]:DEMod:GAIN:INCRement [:SENSe]:DEMod:STATe [:SENSe]:DETector:TRACe:PVTime [:SENSe]:DETector[:FUNCtion] [:SENSe]:DETector:TRACe [:SENSe]:DETector:TRACe:AUTO [:SENSe]:EBWidth:AVERage:COUNt* [:SENSe]:EBWidth:AVERage[:STATe]* [:SENSe]:EBWidth:AVERage:TCONtrol* [:SENSe]:EBWidth:FREQuency:SPAN* [:SENSe]:EBWidth:MAXHold:STATe* [:SENSe]:EBWidth:XDB* [:SENSe]:FREQuency:CENTer
RIGOL [:SENSe]:OBWidth:MAXHold:STATe* [:SENSe]:OBWidth:PERCent* [:SENSe]:POWer[:RF]:ATTenuation [:SENSe]:POWer[:RF]:ATTenuation:AUTO [:SENSe]:POWer[:RF]:GAIN[:STATe] [:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer] [:SENSe]:SIGCapture:2FSK:AMPDown* [:SENSe]:SIGCapture:2FSK:AMPUp* [:SENSe]:SIGCapture:2FSK:MARK1:FREQ* [:SENSe]:SIGCapture:2FSK:MARK1:SWitch[:STATe]* [:SENSe]:SIGCapture:2FSK:MARK2:FREQ* [:SENSe]:SIGCapture:2FSK:MARK2:SWitch[:STATe]* [:SENSe]:SIGCapture:
RIGOL Chapter 2 Command System [:SENSe]:ACPower:AVERage:COUNt Syntax [:SENSe]:ACPower:AVERage:COUNt [:SENSe]:ACPower:AVERage:COUNt? Description Sets the average count of the ACP measurement. Queries the average count of the ACP measurement. Parameter Name Type Integer Range 1 to 1,000 Default 10 Remarks This command is only valid when the adjacent channel power measurement in GPSA mode is enabled. Return Format The query returns the average count in integer.
RIGOL Chapter 2 Command System [:SENSe]:ACPower:AVERage:TCONtrol Syntax [:SENSe]:ACPower:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:ACPower:AVERage:TCONtrol? Description Selects the average mode of the adjacent channel power measurement. Queries the average mode of the adjacent channel power measurement. Parameter Name Type —— Keyword Range EXPonential|REPeat Default EXPonential Remarks EXPonential: indicates the exponential average. REPeat: indicates the repeat average.
RIGOL Chapter 2 Command System Example The following command sets the bandwidth of the adjacent channel to 1 MHz. :SENSe:ACPower:BANDwidth:ACHannel 1000000 The following query returns 1.000000000e+06. :SENSe:ACPower:BANDwidth:ACHannel? [:SENSe]:ACPower:BANDwidth:INTegration Syntax [:SENSe]:ACPower:BANDwidth:INTegration [:SENSe]:ACPower:BANDwidth:INTegration? Description Sets the bandwidth of the main channel. Queries the bandwidth of the main channel.
RIGOL Chapter 2 Command System 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
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System [:SENSe]:ACQuisition:TIME:PVTime:AUTO Syntax [:SENSe]:ACQuisition:TIME:PVTime:AUTO OFF|ON|0|1 [:SENSe]:ACQuisition:TIME:PVTime:AUTO? Description Enables or disables the auto acquisition time for producing a single trace. Queries the status of the auto acquisition time for producing a single trace. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Remarks This command is only available for PvT, PvT Spectrum, and PvT Spectrogram in RTSA mode.
RIGOL Chapter 2 Command System The following query returns 100. :SENSe:AVERage:COUNt? :TRACe:AVERage:COUNt? [:SENSe]:AVERage:COUNt:CURRent? :TRACe:AVERage:COUNt:CURRent? Syntax [:SENSe]:AVERage:COUNt:CURRent? :TRACe:AVERage:COUNt:CURRent? Description Queries the current average times of the average trace. Return Format The query returns the current trace average count in integer.
RIGOL Chapter 2 Command System [:SENSe]:AVERage:TYPE:AUTO Syntax [:SENSe]:AVERage:TYPE:AUTO OFF|ON|0|1 [:SENSe]:AVERage:TYPE:AUTO? Description Enables or disables the auto state for the average type of the swept SA analysis measurement. Queries the on/off auto state for the average type of the swept SA analysis measurement. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for GPSA mode. Return Format The query returns 0 or 1.
RIGOL Chapter 2 Command System The following query returns 1. :SENSe:BANDwidth:EMIFilter:STATe? :SENSe:BWIDth:EMIFilter:STATe? [:SENSe]:BANDwidth|BWIDth[:RESolution] Syntax [:SENSe]:BANDwidth|BWIDth[:RESolution] [:SENSe]:BANDwidth|BWIDth[:RESolution]? Description Sets the resolution bandwidth (RBW). Queries the resolution bandwidth. Parameter Name Type Discrete Range 1 Hz to 10 MHz (at 1-3-10 step) Default 3 MHz Remarks The setting command is only available for GPSA mode.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System [:SENSe]:BANDwidth|BWIDth[:RESolution]:SELect:AUTO[:STATe] Syntax [:SENSe]:BANDwidth|BWIDth[:RESolution]:SELect:AUTO[:STATe] OFF|ON|0|1 [:SENSe]:BANDwidth|BWIDth[:RESolution]:SELect:AUTO[:STATe]? Description Enables or disables the auto setting mode of RBW. Queries the status of the auto setting mode of RBW. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Remarks This command is only available for RTSA mode. Return Format The query returns 0 or 1.
RIGOL Chapter 2 Command System :SENSe:BWIDth:SHAPe GAUSsian The following query returns GAUS. :SENSe:BANDwidth:SHAPe? :SENSe:BWIDth:SHAPe GAUSsian [:SENSe]:BANDwidth|BWIDth:VIDeo Syntax [:SENSe]:BANDwidth|BWIDth:VIDeo [:SENSe]:BANDwidth|BWIDth:VIDeo? Description Sets the video bandwidth (VBW). Queries the video bandwidth. Parameter Name Type Discrete Range 1 Hz to 10 MHz (at 1-3-10 step) Default 3 MHz Remarks This command is only available for GPSA mode.
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the auto setting mode of VBW. :SENSe:BANDwidth:VIDeo:AUTO ON or :SENSe:BANDwidth:VIDeo:AUTO 1 :SENSe:BWIDth:VIDeo:AUTO ON or :SENSe:BWIDth:VIDeo:AUTO 1 The following query returns 1.
RIGOL Chapter 2 Command System [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio:AUTO Syntax [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio:AUTO OFF|ON|0|1 [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio:AUTO? Description Enables or disables the auto setting mode of V/R ratio. Queries the status of the auto setting mode of V/R ratio. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Remarks This command is valid for the swept SA measurement in GPSA mode. Return Format The query returns 0 or 1.
RIGOL Chapter 2 Command System The following query returns 100. :SENSe:CNRatio:AVERage:COUNt? [:SENSe]:CNRatio:AVERage[:STATe] Syntax [:SENSe]:CNRatio:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:CNRatio:AVERage[:STATe]? Description Enables or disables the average measurement function of the C/N ratio measurement. Queries the status of the average measurement function of the C/N ratio measurement.
RIGOL Chapter 2 Command System This command is only valid when the C/N ratio measurement in GPSA mode is enabled. Return Format The query returns EXP or REP. Example The following command sets repeat average to the average mode. :SENSe:CNRatio:AVERage:TCONtrol REPeat The following query returns REP. :SENSe:CNRatio:AVERage:TCONtrol? [:SENSe]:CNRatio:BANDwidth:INTegration Syntax [:SENSe]:CNRatio:BANDwidth:INTegration [:SENSe]:CNRatio:BANDwidth:INTegration? Description Sets the carrier bandwidth.
RIGOL Chapter 2 Command System [:SENSe]:CNRatio:BANDwidth:NOISe Syntax [:SENSe]:CNRatio:BANDwidth:NOISe [:SENSe]:CNRatio:BANDwidth:NOISe? Description Sets the noise bandwidth. Queries the noise bandwidth. Parameter Name Type Consecutive Real Number Range 3 Hz to 2.166666 GHz Default 2 MHz Remarks This command is only valid when the C/N ratio measurement in GPSA mode is enabled. Return Format The query returns the noise bandwidth in integer. Its unit is Hz.
RIGOL Chapter 2 Command System :INPut:IMPedance [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] Syntax :INPut:IMPedance 50|75 :INPut:IMPedance? [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] 50|75 [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]? Description Sets the input impedance for voltage-to-power conversion. The unit is Ω. Queries the input impedance for voltage-to-power conversion.
RIGOL Chapter 2 Command System [:SENSe]:DEMod Syntax [:SENSe]:DEMod AM|FM|OFF [:SENSe]:DEMod? Description Sets the demodulation type or disables the demodulation. Queries the demodulation type. Parameter Name —— Type Keyword Range AM|FM|OFF Default OFF Remarks AM: indicates the amplitude modulation. FM: indicates the frequency modulation. OFF: indicates off. When AM or FM is selected, the spectrum analyzer enables the demodulation function automatically.
RIGOL Chapter 2 Command System Example The following command enables the auto setting mode of signal gain. :SENSe:DEMod:GAIN:AUTO ON or :SENSe:DEMod:GAIN:AUTO 1 The following query returns 1. :SENSe:DEMod:GAIN:AUTO? [:SENSe]:DEMod:GAIN:INCRement Syntax [:SENSe]:DEMod:GAIN:INCRement [:SENSe]:DEMod:GAIN:INCRement? Description Sets the signal gain. Queries the signal gain.
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the demodulation function. :SENSe:DEMod:STATe 1 or :SENSe:DEMod:STATe ON The following query returns 1. :SENSe:DEMod:STATe? [:SENSe]:DETector:TRACe:PVTime Syntax [:SENSe]:DETector:TRACe:PVTime AVERage|NEGative|POSitive|SAMPle [:SENSe]:DETector:TRACe:PVTime? Description Sets the detector type of the trace in the PvT view. Queries the detector type of the trace in the PvT view.
RIGOL Chapter 2 Command System [:SENSe]:DETector[:FUNCtion] [:SENSe]:DETector:TRACe Syntax [:SENSe]:DETector[:FUNCtion] AVERage(VAVerage)|NEGative|NORMal|POSitive|SAMPle|QPEak|RAVerage (RMS) [:SENSe]:DETector[:FUNCtion]? [:SENSe]:DETector:TRACe AVERage(VAVerage)|NEGative|NORMal|POSitive|SAMPle|QPEak|RAVerage (RMS) [:SENSe]:DETector:TRACe? Description Sets the detector type for the specified trace. Queries the detector type for the specified trace.
RIGOL Chapter 2 Command System [:SENSe]:DETector:TRACe:AUTO Syntax [:SENSe]:DETector:TRACe:AUTO OFF|ON|0|1 [:SENSe]:DETector:TRACe:AUTO? Description Enables or disables the Detector Auto function for the specified trace. Queries the status of the Detector Auto function for the specified trace. Parameter Name —— Type Discrete Bool Range 1|2|3|4|5|6 OFF|ON|0|1 Default 1 ON|1 Return Format The query returns 0 or 1. Example The following command enables the Detector Auto function for Trace 1.
RIGOL Chapter 2 Command System [:SENSe]:EBWidth:AVERage[:STATe] Syntax [:SENSe]:EBWidth:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:EBWidth:AVERage[:STATe]? Description Enables or disables the average measurement function of the emission bandwidth measurement. Queries the status of the average measurement function of the emission bandwidth measurement. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only valid when the emission bandwidth measurement in GPSA mode is enabled.
RIGOL Chapter 2 Command System Example The following command sets the average mode to Repeat. :SENSe:EBWidth:AVERage:TCONtrol REPeat The following query returns REP. :SENSe:EBWidth:AVERage:TCONtrol? [:SENSe]:EBWidth:FREQuency:SPAN Syntax [:SENSe]:EBWidth:FREQuency:SPAN [:SENSe]:EBWidth:FREQuency:SPAN? Description Sets the span of the emission bandwidth measurement. Queries the span of the emission bandwidth measurement. Parameter Name Type Consecutive Real Number Range 10 Hz to 6.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System [:SENSe]:FREQuency:CENTer Syntax [:SENSe]:FREQuency:CENTer [:SENSe]:FREQuency:CENTer? Description Sets the center frequency. Queries the center frequency. Parameter Name Type Consecutive Real Number Range (Smin/2)[2] to (Fmax - Smin/2) Default Fmax[1]/2 Note[1]: The maximum frequency Fmax is determined by the instrument model. RSA5000 includes two models: 3.2 GHz and 6.5 GHz. Note[2]: Smin indicates the minimum span in non-zero span.
RIGOL Chapter 2 Command System [:SENSe]:FREQuency:CENTer:STEP[:INCRement] Syntax [:SENSe]:FREQuency:CENTer:STEP[:INCRement] [:SENSe]:FREQuency:CENTer:STEP[:INCRement]? Description Sets the CF step. Queries the CF step. Parameter Name Type Consecutive Real Number Range -Fmax to Fmax Default Fmax/10 Return Format The query returns the center frequency step in scientific notation. The unit is Hz. Example The following command sets the CF step to 100 kHz.
RIGOL Chapter 2 Command System [:SENSe]:FREQuency:SPAN Syntax [:SENSe]:FREQuency:SPAN [:SENSe]:FREQuency:SPAN? Description Sets the span. Queries the span. Parameter Name Type Consecutive Real Number Range GPSA mode: 0 Hz, 10 Hz to Fmax RTSA mode: 5 kHz to 25 MHz 5 kHz to 40 MHz (Option RSA5000-B40) Default GPSA mode: Fmax RTSA mode: 25 MHz 40 MHz (Option RSA5000-B40) Remarks The span can be set to 0 only in GPSA mode.
RIGOL Chapter 2 Command System The following query returns 100. :SENSe:FREQuency:SPAN:BANDwidth:RESolution:RATio? [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio:AUTO Syntax [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio:AUTO OFF|ON|0|1 [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio:AUTO? Description Enables or disables the auto setting mode of span/RBW ratio. Queries the status of the auto setting mode of span/RBW ratio.
RIGOL Chapter 2 Command System [:SENSe]:FREQuency:SPAN:ZERO Syntax [:SENSe]:FREQuency:SPAN:ZERO Description Sets the span to 0 (zero span). Remarks This command is only available for GPSA mode. [:SENSe]:FREQuency:STARt Syntax [:SENSe]:FREQuency:STARt [:SENSe]:FREQuency:STARt? Description Sets the start frequency. Queries the start frequency. Parameter Name Type Consecutive Real Number Range 0 Hz to Fmax [1] Note[1]: 0 Hz to (Fmax-10 Hz) in non-zero span.
RIGOL Chapter 2 Command System 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. :SENSe:FREQuency:STOP 10000000 The following query returns 1.000000000e+07.
RIGOL Chapter 2 Command System [:SENSe]:HDISt:AVERage[:STATe] Syntax [:SENSe]:HDISt:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:HDISt:AVERage[:STATe]? Description Enables or disables the average measurement function of the harmonic distortion measurement. Queries the status of the average measurement function of the harmonic distortion measurement. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only valid when the harmonic distortion measurement in GPSA mode is enabled.
RIGOL Chapter 2 Command System Example The following command sets the average mode to Repeat. :SENSe:HDISt:AVERage:TCONtrol REPeat The following query returns REP. :SENSe:HDISt:AVERage:TCONtrol? [:SENSe]:HDISt:NUMBers Syntax [:SENSe]:HDISt:NUMBers [:SENSe]:HDISt:NUMBers? Description Sets the number of harmonics to be measured. Queries the number of harmonics to be measured.
RIGOL Chapter 2 Command System Return Format The query returns the sweep time in scientific notation. The unit is s. Example The following command sets the sweep time to 100 ms. :SENSe:HDISt:TIME 0.1 The following query returns 1.000000000e-01. :SENSe:HDISt:TIME? [:SENSe]:MCHPower:AVERage:COUNt Syntax [:SENSe]:MCHPower:AVERage:COUNt [:SENSe]:MCHPower:AVERage:COUNt? Description Sets the average count of the multi-channel power measurement.
RIGOL Chapter 2 Command System Remarks This command is only valid when the multi-channel power measurement in GPSA mode is enabled. Return Format The query returns 0 or 1. Example The following command enables the average measurement function. :SENSe:MCHPower:AVERage:STATe ON or :SENSe:MCHPower:AVERage:STATe 1 The following query returns 1.
RIGOL Chapter 2 Command System [: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.
RIGOL Chapter 2 Command System [: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.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System 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. Queries the status of the preamplifier.
RIGOL Chapter 2 Command System 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.
RIGOL Chapter 2 Command System 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. Queries the frequency value at Marker 1.
RIGOL Chapter 2 Command System [:SENSe]:SIGCapture:2FSK:MARK1:SWitch[:STATe] Syntax [:SENSe]:SIGCapture:2FSK:MARK1:SWitch[:STATe] OFF|ON|0|1 [:SENSe]:SIGCapture:2FSK:MARK1:SWitch[:STATe]? Description Enables or disables Mark 1. Queries the on/off status of Marker 1. Parameter Name -- Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for RTSA mode and valid when the SSC function is enabled. Return Format The query returns 0 or 1.
RIGOL Chapter 2 Command System [:SENSe]:SIGCapture:2FSK:MARK2:SWitch[:STATe] Syntax [:SENSe]:SIGCapture:2FSK:MARK2:SWitch[:STATe] OFF|ON|0|1 [:SENSe]:SIGCapture:2FSK:MARK2:SWitch[:STATe]? Description Enables or disables Mark 2. Queries the on/off status of Marker 2. Parameter Name -- Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks This command is only available for RTSA mode and valid when the SSC function is enabled. Return Format The query returns 0 or 1.
RIGOL Chapter 2 Command System [:SENSe]:SIGCapture:2FSK:PEAKAmp? Syntax [:SENSe]:SIGCapture:2FSK:PEAKAmp? Description Queries the amplitude of the nth peak in the SSC measurement results. Parameter Name Type Integer Range 1 to 6 Default 1 Remarks This command is only available for RTSA mode and valid when the SSC function is enabled. Return Format The query returns the amplitude of the nth peak (i.g. the value of the parameter ) in scientific notation.
RIGOL Chapter 2 Command System [:SENSe]:SIGCapture:2FSK:PF? Syntax [:SENSe]:SIGCapture:2FSK:PF? Description Queries the test result of the Pass/Fail function. Remarks This command is only available for RTSA mode and valid when the SSC function is enabled. Return Format The query returns PASS or FAIL. Example The following query returns PASS.
RIGOL Chapter 2 Command System [:SENSe]:SIGCapture:2FSK:RESet Syntax [:SENSe]:SIGCapture:2FSK:RESet Description Performs the reset operation, deletes the original signal, and restarts to capture the signal. Remarks This command is only available for RTSA mode and valid when the SSC function is enabled.
RIGOL Chapter 2 Command System [:SENSe]:SWEep:POINts Syntax [:SENSe]:SWEep:POINts [:SENSe]:SWEep:POINts? Description Sets the number of sweep points. Queries the number of sweep points. Parameter Name Type Integer Range 101 to 10,001 Default 801 Remarks This command is only available for GPSA mode. Return Format The query returns the number of sweep points in integer. Example The following command sets the number of sweep points to 650.
RIGOL Chapter 2 Command System [:SENSe]:SWEep:TIME:AUTO Syntax [:SENSe]:SWEep:TIME:AUTO OFF|ON|0|1 [:SENSe]:SWEep:TIME:AUTO? Description Enables or disables auto sweep time. Queries the status of the auto sweep time. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Remarks This command is only available for GPSA mode. Return Format The query returns 0 or 1. Example The following command enables the auto sweep time.
RIGOL Chapter 2 Command System [:SENSe]:TOI:AVERage:COUNt Syntax [:SENSe]:TOI:AVERage:COUNt [:SENSe]:TOI:AVERage:COUNt? Description Sets the average count of the TOI measurement. Queries the average count of the TOI measurement. Parameter Name Type Integer Range 1 to 1,000 Default 10 Remarks This command is only valid when the TOI measurement in GPSA mode is enabled. Return Format The query returns the average count in integer.
RIGOL Chapter 2 Command System [:SENSe]:TOI:AVERage:TCONtrol Syntax [:SENSe]:TOI:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:TOI:AVERage:TCONtrol? Description Selects the average mode of the TOI measurement. Queries the average mode of the TOI measurement. Parameter Name Type —— Keyword Range EXPonential|REPeat Default EXPonential Remarks EXPonential: indicates the exponential average. REPeat: indicates the repeat average.
RIGOL Chapter 2 Command System Example The following command sets the span to 1 MHz. :SENSe:TOI:FREQuency:SPAN 1000000 The following query returns 1.000000000e+06. :SENSe:TOI:FREQuency:SPAN? [:SENSe]:TPOWer:AVERage:COUNt Syntax [:SENSe]:TPOWer:AVERage:COUNt [:SENSe]:TPOWer:AVERage:COUNt? Description Sets the average count of the T-power measurement. Queries the average count of the T-power measurement.
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the average measurement. :SENSe:TPOWer:AVERage:STATe ON or :SENSe:TPOWer:AVERage:STATe 1 The following query returns 1. :SENSe:TPOWer:AVERage:STATe? [:SENSe]:TPOWer:AVERage:TCONtrol Syntax [:SENSe]:TPOWer:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:TPOWer:AVERage:TCONtrol? Description Sets the average mode of the T-power measurement. Queries the average mode of the T-power measurement.
RIGOL Chapter 2 Command System [:SENSe]:TPOWer:LLIMit Syntax [:SENSe]:TPOWer:LLIMit
RIGOL Chapter 2 Command System The following query returns AVER. :SENSe:TPOWer:MODE? [:SENSe]:TPOWer:RLIMit Syntax [:SENSe]:TPOWer:RLIMit [:SENSe]:TPOWer:RLIMit? Description Sets the stop line for the T-power measurement. Queries the stop line for the T-power measurement. Parameter Name Type Consecutive Real Number Range current value of start line to current value of sweep time Default 1 ms Remarks This command is only valid when the T-power measurement in GPSA mode is enabled.
RIGOL Chapter 2 Command System :SOURce Commands Command List: :SOURce:CORRection:OFFSet :SOURce[:EXTernal]:POWer[:LEVel][:IMMediate][:AMPLitude] :SOURce:TRACe:REFerence:STATe :SOURce:TRACe:STORref Remarks: The :SOURce commands are only available for RSA5065-TG/RSA5032-TG working in GPSA mode. :SOURce:CORRection:OFFSet Syntax :SOURce:CORRection:OFFSet :SOURce:CORRection:OFFSet? Description Sets the offset of the output amplitude of the tracking generator.
RIGOL Chapter 2 Command System Return Format The query returns the output amplitude in scientific notation. Example The following command sets the output amplitude to -10 dB. :SOURce:EXTernal:POWer:LEVel:IMMediate:AMPLitude -10 The following query returns -1.000000000e+01. :SOURce:EXTernal:POWer:LEVel:IMMediate:AMPLitude? :SOURce:TRACe:REFerence:STATe Syntax :SOURce:TRACe:REFerence:STATe OFF|ON|0|1 :SOURce:TRACe:REFerence:STATe? Description Sets whether to display the reference trace of normalization.
Chapter 2 Command System RIGOL :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.
RIGOL Chapter 2 Command System :STATus:OPERation:CONDition? Syntax :STATus:OPERation:CONDition? Description Queries the condition register of the Operation Status Register. Return Format The query returns the condition register in integer. For example, 24. :STATus:OPERation:ENABle Syntax :STATus:OPERation:ENABle :STATus:OPERation:ENABle? Description Sets the enable register of the Operation Status Register. Queries the enable register of the Operation Status Register.
Chapter 2 Command System RIGOL 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.
RIGOL Chapter 2 Command System :STATus:QUEStionable:ENABle Syntax :STATus:QUEStionable:ENABle :STATus:QUEStionable:ENABle? Description Sets the enable register of the Questionable Status Register. Queries the enable register of the Questionable Status Register. Parameter Name Type Integer Range Refer to "Remarks" Default 0 Remarks The following table lists the bit definitions for the questionable status register.
Chapter 2 Command System RIGOL :STATus:QUEStionable[:EVENt]? Syntax :STATus:QUEStionable[:EVENt]? Description Queries the event register of the Questionable Status Register. Return Format Queries the event register of the Questionable Status Register in integer. For example, 0.
RIGOL Chapter 2 Command System :SYSTem Commands Command List: :SYSTem:BEEPer:STATe :SYSTem:COMMunicate:LAN[:SELF]:APPLy :SYSTem:COMMunicate:LAN[:SELF]:AUToip:STATe :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe :SYSTem:COMMunicate:LAN[:SELF]:IP:ADDRess :SYSTem:COMMunicate:LAN[:SELF]:IP:DNS:AUTO[:STATe] :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSBack :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSPreferred :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSServer :SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway
RIGOL Chapter 2 Command System :SYSTem:BEEPer:STATe Syntax :SYSTem:BEEPer:STATe OFF|ON|0|1 :SYSTem:BEEPer:STATe? Description Turns on or off the beeper. Queries the status of the beeper. Parameter Name Type —— Bool Range OFF|ON|0|1 Default OFF|0 Return Format The query returns 0 or 1. Example The following command turns on the beeper. :SYSTem:BEEPer:STATe ON or :SYSTem:BEEPer:STATe 1 The following query returns 1.
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the auto IP setting mode. :SYSTem:COMMunicate:LAN:SELF:AUToip:STATe ON or :SYSTem:COMMunicate:LAN:SELF:AUToip:STATe 1 The following query returns 1. :SYSTem:COMMunicate:LAN:SELF:AUToip:STATe? :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe Syntax :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe OFF|ON|0|1 :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe? Description Enables or disables the DHCP configuration mode.
RIGOL Chapter 2 Command System Remarks The format of is "nnn.nnn.nnn.nnn". The range for the first segment (nnn) of the address is from 1 to 223 (except 127); and the range for the other three segments is from 0 to 255. This command is only valid in manual IP setting mode. Return Format The query returns the current IP address in the format of "nnn.nnn.nnn.nnn". Example The following command sets the IP address to "172.16.3.199". :SYSTem:COMMunicate:LAN:SELF:IP:ADDRess 172.16.3.
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSBack Syntax :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSBack :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSBack? Description Sets the backup address for the DNS. Queries the backup address for the DNS. Parameter Name Type ASCII String Range Refer to "Remarks" Default —— Remarks The format of is "nnn.nnn.nnn.nnn".
RIGOL Chapter 2 Command System Example The following command sets the preferred DNS address to "172.16.2.2". :SYSTem:COMMunicate:LAN:SELF:IP:DNSPreferred 172.16.2.2 :SYSTem:COMMunicate:LAN:SELF:IP:DNSServer 172.16.2.2 The following query returns 172.16.2.2.
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask Syntax :SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask :SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask? Description Sets the subnet mask. Queries the subnet mask. Parameter Name Type ASCII String Range Refer to "Remarks" Default —— 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.
RIGOL Chapter 2 Command System 1 The following query returns 1. :SYSTem:COMMunicate:LAN:SELF:MANuip:STATe? :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.
RIGOL Chapter 2 Command System :SYSTem:CONFigure:INFormation? Syntax :SYSTem:CONFigure:INFormation? Description Queries the system information of the spectrum analyzer. Remarks The system information includes the model, serial number, software and hardware version number, and firmware version number. Return Format The query returns the system information. For example, Model:RSA5065 SN:RSA5B192000020 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.
RIGOL Chapter 2 Command System :SYSTem:FSWitch[:STATe] Syntax :SYSTem:FSWitch[:STATe] OFF|ON|0|1 :SYSTem:FSWitch[:STATe]? Description Sets the power switch on the front panel to be turned on or off. Queries whether the power switch on the front panel is turned on or off. Parameter Name —— Type Bool Range OFF|ON|0|1 Default ON|1 Return Format The query returns 0 or 1. Example The following command sets the power switch on the front panel is turned off.
RIGOL Chapter 2 Command System :SYSTem:LKEY Syntax :SYSTem:LKEY
RIGOL Chapter 2 Command System :SYSTem:PON:TYPE Syntax :SYSTem:PON:TYPE PRESet|LAST :SYSTem:PON:TYPE? Description Selects the setting type the instrument recalls at power-on. Queries what setting type the instrument recalls at power-on. Parameter Name —— Type Keyword Range PRESet|LAST Default PRESet Remarks PRESet: indicates preset settings, including factory default settings and 6 user-defined settings. LAST: indicates the last setting. Return Format The query returns PRES or LAST.
RIGOL Chapter 2 Command System :SYSTem:PRESet:TYPE Syntax :SYSTem:PRESet:TYPe FACTory|USER1|USER2|USER3|USER4|USER5|USER6 :SYSTem:PRESet:TYPe? Description Selects the preset type of the system to be the factory mode or any one of the items from User1 to User6. Queries the preset type of the system. Parameter Name Type —— Keyword Range FACTory|USER1|USER2|USER3|USER4|USER5|USER6 Default FACTory Return Format The query returns FACT, USER1, USER2, USER3, USER4, USER5, or USER6.
RIGOL Chapter 2 Command System :SYSTem:SCPI:DISPlay Syntax :SYSTem:SCPI:DISPlay OFF|ON|0|1 :SYSTem:SCPI:DISPlay? Description Enables or disables the SCPI display. Queries the status for the SCPI display. Parameter Name —— Type Bool Range OFF|ON|0|1 Default OFF|0 Remarks When you use the SCPI commands to control the instrument remotely, turning on the SCPI display will go to the specified menu of the corresponding command; turning off the SCPI Display will not go to the specified menu.
RIGOL Chapter 2 Command System :SYSTem:SHOW SYSTem The following query returns SYST. :SYSTem:SHOW? :SYSTem:TIME Syntax :SYSTem:TIME ,, :SYSTem:TIME? Description Sets the system time of the instrument. Queries the system time of the instrument. Parameter Name Type ASCII String ASCII String ASCII String Range 00 to 23 00 to 59 00 to 59 Default —— —— —— Return Format The query returns the current system time in the format of "HH,MM,SS".
Chapter 2 Command System RIGOL :TRACe Commands Command List: :TRACe:CLEar:ALL :TRACe[:DATA] :TRACe:MATH:A :TRACe:MATH:B :TRACe:MATH:CONSt :TRACe:MATH:PEAK[:DATA]? :TRACe:MATH:PEAK:POINts? :TRACe:MATH:REFerence :TRACe:MATH:STATe :TRACe:MATH:TYPE :TRACe:PRESet:ALL :TRACe:DISPlay:STATe :TRACe:MODE :TRACe:TYPE :TRACe:UPDate:STATe :TRACe:CLEar:ALL Syntax :TRACe:CLEar:ALL Description Clears all the traces, that is, all the points on the trace
RIGOL Chapter 2 Command System :TRACe[:DATA] Syntax :TRACe[:DATA] TRACE1|TRACE2|TRACE3|TRACE4|TRACE5|TRACE6,| :TRACe[:DATA]? TRACE1|TRACE2|TRACE3|TRACE4|TRACE5|TRACE6 Description Load the user data into the specified trace. Query the logarithmic data of the specified trace.
RIGOL Chapter 2 Command System 11111111111111111111010011…… Note: As the PC software converts the binary data returned to ASCII character, the return value is unrecognizable code when the PC software is used to execute the query command. :TRACe:DATA? TRACE2 Remark: [1] The format of the data block is "Data Block Header + Data Block"; wherein, the format of the data block header is as follows.
RIGOL Chapter 2 Command System :TRACe:MATH:B Syntax :TRACe:MATH:B T1|T2|T3|T4|T5|T6 :TRACe:MATH:B? Description Sets Op2 in the trace math operation formula to Trace 1, Trace 2, Trace 3, Trace 4, Trace 5, or Trace 6. Queries which trace is Op2 represented in the trace math operation formula. Parameter Name Type —— Keyword Range T1|T2|T3|T4|T5|T6 Default T2 Return Format The query returns T1, T2, T3, T4, T5, or T6. Example The following command sets Op2 to Trace 1.
RIGOL Chapter 2 Command System :TRACe:MATH:PEAK[:DATA]? Syntax :TRACe:MATH:PEAK[:DATA]? Description Queries the frequencies (Hz) and amplitudes (the unit is the same as the current Y-axis unit) of the peaks in the peak table. Remarks This command only queries Trace 1. Return Format The query returns the frequencies and amplitudes of the peaks in the peak table in the following format. At most, 20 pairs of frequencies and amplitudes can be returned. For example, 1.000000000e+09,-1.463000000e+01,9.
RIGOL Chapter 2 Command System :TRACe:MATH:STATe Syntax :TRACe:MATH:STATe OFF|ON|0|1 :TRACe:MATH:STATe? Description Enables or disables the math operation. Queries the status of the math operation of the trace. 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 math operation of the trace. :TRACe:MATH:STATe 1 or :TRACe:MATH:STATe ON The following query returns 1.
RIGOL Chapter 2 Command System :TRACe:PRESet:ALL Syntax :TRACe:PRESet:ALL Description Resets all the traces. Remarks Enables Trace 1, and sets other traces to be in blank state. This does not affect the trace type and the detector type. :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.
RIGOL Chapter 2 Command System :TRACe:MODE :TRACe:TYPE Syntax :TRACe:MODE WRITe|AVERage|MAXHold|MINHold :TRACe:MODE? :TRACe:TYPE WRITe|AVERage|MAXHold|MINHold :TRACe:TYPE? Description Sets the type of the specified trace. Queries the type of the specified trace. Parameter Name Type Discrete —— Keyword Range 1|2|3|4|5|6 WRITe|AVERage|MAXHold|MINHold Default —— WRITe Remarks WRITe: indicates clear/write. AVERage: indicates average. MAXHold: indicates the maximum hold.
RIGOL Chapter 2 Command System :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. 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 thru Trace 6 are disabled (OFF). Return Format The query returns 1 or 0.
RIGOL Chapter 2 Command System :TRIGger Commands Command List: :TRIGger[:SEQuence]:ATRigger :TRIGger[:SEQuence]:ATRigger:STATe :TRIGger[:SEQuence]:EXTernal:DELay :TRIGger[:SEQuence]:EXTernal:DELay:STATe :TRIGger[:SEQuence]:EXTernal:SLOPe :TRIGger[:SEQuence]:FMT:APTRigger :TRIGger[:SEQuence]:FMT:CRITeria :TRIGger[:SEQuence]:FMT:DELay :TRIGger[:SEQuence]:FMT:DELay:STATe :TRIGger[:SEQuence]:FMT:MASK :TRIGger[:SEQuence]:FMT:MASK:EDIT :TRIGger[:SEQuence]:FM
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:ATRigger Syntax :TRIGger[:SEQuence]:ATRigger :TRIGger[:SEQuence]:ATRigger? Description Sets the time that the analyzer will wait for the trigger to be initiated automatically. Queries the time that the analyzer will wait for the trigger to be initiated automatically. Parameter Name Type Consecutive Real Number Range 1 ms to 100 s Default 100 ms Remarks This command is only valid when the auto triggering function is enabled.
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:EXTernal:DELay Syntax :TRIGger[:SEQuence]:EXTernal:DELay :TRIGger[:SEQuence]:EXTernal:DELay? Description Sets the delay time for the external trigger. Queries the delay time for the external trigger. Parameter Name Type Discrete Consecutive Real Number Range 1|2 0 μs to 500 ms Default —— 1 μs Remarks When the parameter n is set to 1, it indicates External Trigger 1; when set to 2, it indicates External Trigger 2.
RIGOL Chapter 2 Command System :TRIGger:SEQuence:EXTernal1:DELay:STATe ON or :TRIGger:SEQuence:EXTernal1:DELay:STATe 1 The following query returns 1. :TRIGger:SEQuence:EXTernal1:DELay:STATe? :TRIGger[:SEQuence]:EXTernal:SLOPe Syntax :TRIGger:SEQuence:EXTernal:SLOPe POSitive|NEGative :TRIGger:SEQuence:EXTernal:SLOPe? Description Sets the trigger edge for the external trigger. Queries the trigger edge for the external trigger.
RIGOL Chapter 2 Command System "Outside", the maximum value of the parameter is 1. In the Spectrogram measurement mode, the maximum value of the parameter is 10,000. In the PvT measurement mode, the maximum value of the parameter is 5,000. This command is only valid when you select FMT to be the trigger source in RTSA mode. Return Format The query returns the number of acquisition times in integer. Example The following command sets the number of acquisition times to 5.
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:FMT:DELay Syntax :TRIGger[:SEQuence]:FMT:DELay :TRIGger[:SEQuence]:FMT:DELay? Description Sets the delay time for FMT. Queries the delay time for FMT. Parameter Name Type Consecutive Real Number Range 0 us to 500 ms Default 1 μs Remarks When "Inside" or "Outside" is selected to be the trigger criteria, the FMT trigger delay command is invalid.
RIGOL Chapter 2 Command System The following query returns 1. :TRIGger:SEQuence:FMT:DELay:STATe? :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.
RIGOL Chapter 2 Command System :TRIGger:SEQuence:FMT:MASK:EDIT UPPer The following query returns UPP. :TRIGger:SEQuence:FMT:MASK:EDIT? :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.
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:FMT:MASK:RELative:FREQuency Syntax :TRIGger[:SEQuence]:FMT:MASK:RELative:FREQuency ON|OFF|1|0 :TRIGger[:SEQuence]:FMT:MASK:RELative:FREQuency? Description Sets whether the frequencies of the mask points are coupled to the center frequency of the instrument. Queries whether the frequencies of the mask points are coupled to the center frequency of the instrument.
RIGOL Chapter 2 Command System This command is only valid when you select FMT to be the trigger source in RTSA mode. Example The following command creates a upper mask from trace1. :TRIGger:SEQuence:FMT:MASK1:BUILd TRACE1 :TRIGger[:SEQuence]:FMT:MASK:DATA Syntax :TRIGger[:SEQuence]:FMT:MASK:DATA ,{,, } :TRIGger[:SEQuence]:FMT:MASK:DATA? Description Edits the mask parameters. Queries the mask parameters.
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:FMT:MASK:NEW Syntax :TRIGger[:SEQuence]:FMT:MASK:NEW Description Clears the currently activated mask and creates a default new mask. Parameter Name Type Discrete Range 1|2 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.
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:HOLDoff:STATe Syntax :TRIGger[:SEQuence]:HOLDoff:STATe OFF|ON|0|1 :TRIGger[:SEQuence]:HOLDoff:STATe? Description Enables or disables 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. Example The following command enables the trigger holdoff function.
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:VIDeo:DELay Syntax :TRIGger[:SEQuence]:VIDeo:DELay :TRIGger[:SEQuence]:VIDeo:DELay? Description Sets the delay time for the video trigger. Queries the delay time for the video trigger. Parameter Name Type Consecutive Real Number Range Default 0 μs to 500 ms 1 μs Remarks This command is only valid when the video trigger delay function is enabled in GPSA mode.
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:VIDeo:LEVel Syntax :TRIGger:SEQuence:VIDeo:LEVel :TRIGger:SEQuence:VIDeo:LEVel? Description Sets the trigger level of the video trigger. Queries the trigger level of the video trigger. Parameter Name Type Consecutive Real Number Range -140 dBm to 30 dBm Default -25 dBm Remarks This command is only valid when the following conditions are met: in GPSA mode; selecting the video trigger.
RIGOL Chapter 2 Command System The following query returns POS. :TRIGger:SEQuence:VIDeo:SLOPe? :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.
RIGOL Chapter 2 Command System :UNIT Command Command List: :UNIT:POWer :UNIT:POWer Syntax :UNIT:POWer DBM|DBMV|DBUV|V|W :UNIT:POWer? Description Sets the unit of the Y axis. Queries the unit of the Y axis. Parameter Name —— Type Keyword Range DBM|DBMV|DBUV|V|W Default Refer to "Remarks" Remarks The default log unit is dBm. The default linear unit is V. Return Format The query returns DBM, DBMV, DBUV, V, or W. Example The following command sets the amplitude unit to Watts.
Chapter 3 Programming Examples RIGOL Chapter 3 Programming Examples This chapter lists some programming examples to illustrate how to use commands to realize the common functions of the spectrum analyzer in the development environments such as Visual C++ 6.0, Visual Basic 6.0, and LabVIEW 2010. Also, the chapter lists some examples to illustrate how to control the spectrum analyzer to realize the common functions in Linux operating system. These examples are programmed based on NI-VISA library.
RIGOL Chapter 3 Programming Examples Programming Instructions This section introduces the problems that might occur during the programming process as well as their solutions. If these problems occur, please resolve them according to the corresponding instructions. 1. When you build a working environment via the network, it is recommended that you build a pure local area network. 2. If the local area network environment is complicated (e.g.
Chapter 3 Programming Examples RIGOL Visual C++ 6.0 Programming Example Enter the Visual C++6.0 programming environment, and perform the following procedures. 1. Create a MFC project based on a dialog box and name it "DemoForRSA" in this example. 2. Click Project Settings to open the "Project Setting" dialog box. In the dialog box, click the Link tab, add "visa32.lib" under Object/library modules, then click OK to close the dialog box. 3. Click Tools Options to open the "Options" dialog box.
RIGOL Chapter 3 Programming Examples By now, VISA library has been added. 4. Add the Text, Edit, and Button controls, as shown in the figure below. 5. Add the control variables. Click View ClassWizard, and then click the Member Variables tab to add the following three variables: Address CString m_strInstrAddr Command CString m_strCommand Return CString m_strResult 6. Encapsulate the read and write operations of VISA. 1) Encapsulate the write operation of VISA for easier operation.
Chapter 3 Programming Examples RIGOL // Change the address's data style from CString to char* SendAddr = strAddr.GetBuffer(strAddr.GetLength()); strcpy(SendAddr,strAddr); strAddr.ReleaseBuffer(); // Change the command's data style from CString to char* SendBuf = strContent.GetBuffer(strContent.GetLength()); strcpy(SendBuf,strContent); strContent.
RIGOL Chapter 3 Programming Examples 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.
Chapter 3 Programming Examples RIGOL } 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.
RIGOL Chapter 3 Programming Examples bool bReadOK = true; // Change the address's data style from CString to char* SendAddr = strAddr.GetBuffer(strAddr.GetLength()); strcpy(SendAddr,strAddr); strAddr.
RIGOL Chapter 3 Programming Examples 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.
RIGOL Chapter 3 Programming Examples } 8. //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.
Chapter 3 Programming Examples RIGOL Visual Basic 6.0 Programming Example Enter the Visual Basic 6.0 programming environment, and perform the following procedures. 1. Build a standard application program project (Standard EXE), and name it "DemoForRSA". 2. Open Project Add File…. Search for the visa32.bas file from the include folder in the installation path of NI-VISA, and then add the file to the project. The visa32.bas module contains all VISA functions and constant statements.
RIGOL Chapter 3 Programming Examples Dim rSize As Long 'Initialize the system status = viOpenDefaultRM(dfltRM) 'Failed to initialize the system If (status < VI_SUCCESS) Then MsgBox " No VISA resource was opened!" Exit Sub End If 'Open the VISA instrument status = viOpen(dfltRM, rsrcName, VI_NULL, VI_NULL, sesn) 'Failed to open the instrument If (status < VI_SUCCESS) Then MsgBox "Failed to open the instrument!" Exit Sub End If 'Write command to the instrument status = viWrite(sesn, strCmd, Len(strCmd), rSi
Chapter 3 Programming Examples RIGOL MsgBox " Failed to open the instrument! " Exit Function End If 'Read from the instrument stasus = viRead(sesn, strTemp0, 256, rSize) 'Reading failed If (status < VI_SUCCESS) Then MsgBox " Failed to read from the instrument! " Exit Function End If 'Close the system status = viClose(sesn) status = viClose(dfltRM) 'Remove the space at the end of the string strTemp1 = Left(strTemp0, rSize) InstrRead = strTemp1 End Function 5. Add the control event codes.
RIGOL Chapter 3 Programming Examples j = InStr(strRet, "RSA") If (j >= 0) Then bFindRSA = True Exit For End If Call viFindNext(fList + i - 1, rsrcName(i)) Next i 'Display If (bFindRSA = True) Then TxtInsAddr.Text = rsrcName(i) Else TxtInsAddr.Text = "" End If End Sub 2) Write Operation 'Write the command to the instrument Private Sub CmdWrite_Click() If (TxtInsAddr.Text = "") Then MsgBox ("Please write the instrument address!") End If InstrWrite TxtInsAddr.Text, TxtCommand.Text End Sub 3) 6.
Chapter 3 Programming Examples RIGOL LabVIEW 2010 Programming Example Enter the Labview 2010 programming environment, and perform the following procedures. 1. Create a VI file, and name it "DemoForRSA". 2. Add controls to the front panel interface, including the Address field, Command field, and Return field, the Connect button, the Write button, the Read button, and the Exit button. 3. Click Show Block Diagram under the Window menu to create an event structure. 4.
RIGOL 2) 3-16 Chapter 3 Programming Examples Write operation (including error confirmation) RSA5000 Programming Guide
Chapter 3 Programming Examples 3) RIGOL Read operation (including error correction advice) RSA5000 Programming Guide 3-17
RIGOL 3-18 Chapter 3 Programming Examples 4) Exit 5) Run the program, and then the following interface is displayed below. Click the VISA resource name from the drop-down list under Address, and click Connect to connect the instrument. Then, input a command in the Command field. Click Write to write the command to the instrument. If the command is a query (e.g.*IDN?), click Write to write the command into the instrument, and then click Read. The return value is displayed in the Return field.
Chapter 3 Programming Examples RIGOL exit the program. Linux Programming Example This section illustrates how to program and control the spectrum analyzer to realize the common functions in Linux operating system. Programming Preparations 1. Programming environment: Operating system: Fedroa 8 (Linux-2.6.23) GCC version: gcc-4.1.2 2. Install the VISA library. First, check whether your PC has installed NI's VISA library. If not, download it from NI website (http://www.ni.com/visa/).
RIGOL Chapter 3 Programming Examples 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.
Chapter 3 Programming Examples 4. RIGOL Use either of the following two methods to add the library location to the search path of the library, so that the program can load the installed library file automatically. Method 1: Specify the search path of the library in the environment variable LD_LIBRARY_PATH. Operation Method: Add the library file path /usr/local/lib to the LD_LIBRARY_PATH variable in the /etc/profile file, as shown in the figure below.
RIGOL Chapter 3 Programming Examples Linux Programming Procedures 1. Edit the DemoForRSA.h header file and declare a class to encapsulate the operation and property of the instrument. #ifndef DEMO_FOR_RSA_H #define DEMO_FOR_RSA_H #include #include #include #include //#include
Chapter 3 Programming Examples RIGOL string strInstr = ""; ViChar instrDesc[1000]; unsigned long i = 0; bool bFindRSA = false; memset(instrDesc,0,1000); //Turn on the VISA device status = viOpenDefaultRM(&defaultRM); if (status < VI_SUCCESS) { cout<<"No VISA equipment!"<
RIGOL Chapter 3 Programming Examples string str; //Address conversion, convert the string type to char* SendAddr = const_cast(strAddr.c_str()); //Address conversion, convert the string type to char* SendBuf = const_cast(strContent.
Chapter 3 Programming Examples RIGOL status = viRead(instr, RecBuf, MAX_REC_SIZE, &retCount); //Turn off the device status = viClose(instr); status = viClose(defaultRM); sprintf(result,"%s",RecBuf); pstrResult = result; free(result); return bReadOK; } void makeupper( string &instr) { string outstr = ""; if(instr == "") { exit(0); } for(int i = 0;i < instr.length();i++) { instr[i] = toupper(instr[i]); } } 3. Edit the function file mainloop.cpp to complete the flow control. #include "DemoForRSA.
RIGOL Chapter 3 Programming Examples && demo.m_strCommand[2]='a' && demo.m_strCommand[3]='d') { //demo.InstrWrite(demo.m_strInstrAddr,"*IDN?"); //demo.InstrRead(demo.m_strInstrAddr,demo.m_strResult); cout<<"read result:"<
Chapter 3 Programming Examples RIGOL rm demo $(obj) 5. Run 1) 2) 3) 4) 5) the results. #make ./demo When the program runs, the instrument is connected automatically. If no instrument is found, a prompt message "No VISA equipment!" is displayed, and the system exits the program. If the instrument is found and successfully connected, the following interface is displayed, as shown in the figure below. Input write (for example, write<*IDN?>) to write the command into the spectrum analyzer.
RIGOL Chapter 4 Appendix Chapter 4 Appendix Appendix A: Default Settings Sending the *RST command can restore the instrument to default settings, as shown in the table below.
RIGOL Trigger Mask Trigger Criteria Active Mask Frequency Amplitude Build From Trace X Offset Y Offset X Axis Type Y Axis Type Trace Selected Trace Trace Type Trace Det Detector Auto Trace Update Trace Display Math Function Op1 Op2 Offset Reference TG[1] Output Amplitude Amplitude Offset Normalize Reference Level Reference Position Reference Trace Mode Measurement Mode Mode Setup Global CF Mode Meas[2] Measurement Function Chapter 4 Appendix ----------- Upper Enter Upper 0 Hz 0 dB Trace1 0 Hz 0 dB Relat
RIGOL Chapter 4 Appendix Select Limit Limit Type X To CF Y To Ref Margin Test Trace Test Limits Limit State T-Power Avg Number Avg Mode Avg State TP Type Start Line Stop Line ACP Avg Number Avg Mode Avg State Main Chan BW Adj Chan BW Chan Spacing Multichan Pwr Avg Number Avg Mode Avg State Channel Span Channel Sheet Channel Freq Occupied BW Avg Number Avg Mode Avg State Max Hold OBW Span Power Ratio Emission BW Avg Number Avg Mode Avg State Max Hold EBW Span EBW X dB C/N Ratio Avg Number Avg Mode Avg Stat
RIGOL Harmonic ST 1 ms TOI Avg Number Off, 10 Avg Mode Exponential Avg State On TOI Span 2 MHz Measure Setup[2](RTSA) Normal Avg Number 100 Test Limits Off Select Limit Limit1 Limit State Off Test Trace Trace1 Limit Type Upper X to CF Relative Y to Ref Relative Margin Off, 0 dB Frequency 0 Hz Amplitude 0 dBm Build From Trace Trace1 X Offset 0 Hz Y Offset 0 dB Density Avg Number 100 Persistence 300 ms Pers Inf Off Color Palettes Warm Highest Density Hue 100 Lowest Density Hue 0 Curve Nonlinearity 75 Hue Tru
RIGOL Chapter 4 Appendix Line State Couple Markers Marker Table Peak Cont Peak Pk-Pk Search Peak Threshold Peak Excursion Threshold Line Peak Table Peak Table Sort Table Readout Marker Func N dB Bandwidth Band Function Marker Counter Switch Gate Time System[3] Power On Preset Type Align Auto LAN Setting Mode Display Line Graticule HDMI HDMI Resolution LCD LCD Backlight Power Switch Beep Switch User key Language Off Off Off Off Off Off Off Maximum Value On, -90 dBm On, 6 dB Off Off Amplitude All Off Ma
RIGOL Chapter 4 Appendix Appendix B: Warranty RIGOL TECHNOLOGIES, INC. (hereinafter referred to as RIGOL) warrants that the product will be free from defects in materials and workmanship within the warranty period. If a product proves defective within the warranty period, RIGOL guarantees free replacement or repair for the defective product. To get repair service, please contact with your nearest RIGOL sales or service office.