Page 1
RIGOL Programming Guide Vector Signal Analysis Measurement Application Applicable to RSA5000-VSA Jan. 2019 RIGOL (SUZHOU) TECHNOLOGIES, INC.
Page 3
Notices RIGOL products are covered by P.R.C. and foreign patents, issued and pending. RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at the company’s sole decision. Information in this publication replaces all previously released materials.
This chapter introduces the syntax, function, parameters, and usage of each command in VSA mode for the RSA5000 series. For the latest version of this manual, download it from the official website of RIGOL (www.rigol.com). Format Conventions in this Manual: Keys: The keys on the front panel are usually denoted by the format of "Key Name (Bold) + Text Box".
RIGOL Chapter 1 Programming Overview 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.
Operation Procedures: 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. Connect the analyzer to the PC and configure the interface parameters for the instrument RSA5000 supports two communication interfaces: USB and LAN, as shown in the following figure.
For details, refer to descriptions in Chapter 3 in Guide Send SCPI commands via the PC software You can use the PC software to send commands to control RSA5000 remotely. RIGOL Ultra Sigma is recommended. You can download the software from RIGOL official website (www.rigol.com). VSA Programming Guide...
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).
RIGOL Chapter 1 Programming Overview value. For example, send the :SENSe:FREQuency:CENTer 1000 command in [:SENSe]:FREQuency:CENTer <freq> format. Parameter Type The command parameters introduced in this manual include 6 types: Bool, Keyword, Integer, Consecutive Real Number, Discrete, and ASCII String. Bool The parameter can be set to OFF (0) or ON (1).
RIGOL Chapter 2 Command System Chapter 2 Command System This chapter introduces the commands of the RSA5000 series spectrum analyzer in VSA mode. Contents in this chapter: :CALCulate Commands :CALibration Commands :CONFigure Commands :DISPlay Commands :FETCh Commands ...
RIGOL Chapter 2 Command System :CALCulate:DDEMod:MARKer:AOFF Syntax :CALCulate:DDEMod:MARKer:AOFF Description Turns off all the enabled markers. :CALCulate:DDEMod:MARKer:COUPle[:STATe] Syntax :CALCulate:DDEMod:MARKer:COUPle[:STATe] OFF|ON|0|1 :CALCulate:DDEMod:MARKer:COUPle[:STATe]? Description Enables or disables the couple marker function. Queries the state of the couple marker function. Parameter Name Type Range...
RIGOL Chapter 2 Command System Example The following command disables the marker table. :CALCulate:DDEMod:MARKer:TABLe:STATe OFF or :CALCulate:DDEMod:MARKer:TABLe:STATe 0 The following query returns 0. :CALCulate:DDEMod:MARKer:TABLe:STATe? :CALCulate:DDEMod:MARKer<n>:CPSearch[:STATe] Syntax :CALCulate:DDEMod:MARKer<n>:CPSearch[:STATe] OFF|ON|0|1 :CALCulate:DDEMod:MARKer<n>:CPSearch[:STATe]? Description Enables or disables continuous peak search function, and marks the peak value with Marker N.
RIGOL Chapter 2 Command System Return Format The query returns BPOW or OFF. Example The following command sets the measurement type of Marker 1 to band power. :CALCulate:DDEMod:MARKer1:FUNCtion BPOW The following query returns BPOW. :CALCulate:DDEMod:MARKer1:FUNCtion? :CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:LEFT Syntax :CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:LEFT <real> :CALCulate:DDEMod:MARKer<n>:FUNCtion:BAND:LEFT? Description Sets the left edge frequency or time of the signal involved in the calculation for the band function.
RIGOL Chapter 2 Command System Parameter Name Type Range Default <n> Discrete 1|2|3|4|5|6|7|8 <real> Consecutive Real Number band left to +∞ center frequency+bandwidth/2 Remarks This command is only valid when you open the marker on the frequency domain data and enable the corresponding bandwidth function.
RIGOL Chapter 2 Command System :CALCulate:DDEMod:MARKer<n>:MAXimum Syntax :CALCulate:DDEMod:MARKer<n>:MAXimum Description Performs one peak search, and marks with the specified marker. Parameter Name Type Range Default <n> Discrete 1|2|3|4|5|6|7|8 Remarks When no peak is found, a prompt message "No peak found" is displayed on the screen.
RIGOL Chapter 2 Command System Remarks When no peak is found, a prompt message "No peak found" is displayed on the screen. Example The following command performs one next peak search, and marks with Marker 2. :CALCulate:DDEMod:MARKer2:MAXimum:NEXT :CALCulate:DDEMod:MARKer<n>:MAXimum:PREVious Syntax :CALCulate:DDEMod:MARKer<n>:MAXimum:PREVious...
RIGOL Chapter 2 Command System :CALCulate:DDEMod:MARKer<n>:MINimum Description Searches for the peak with the minimum amplitude on the trace and marks it with the specified marker. Parameter Name Type Range Default <n> Discrete 1|2|3|4|5|6|7|8 Remarks When no peak is found, a prompt message "No peak found" is displayed on the screen.
RIGOL Chapter 2 Command System Description Sets the reference marker for the specified marker. Queries the reference marker for the specified marker. Parameter Name Type Range Default <n> Discrete 1|2|3|4|5|6|7|8 By default, the reference marker is <integer> Integer 1 to 8 the marker next to it.
RIGOL Chapter 2 Command System :CALCulate:DDEMod:MARKer<n>:X Syntax :CALCulate:DDEMod:MARKer<n>:X <real> :CALCulate:DDEMod:MARKer<n>: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. Parameter Name Type Range Default <n> Discrete 1|2|3|4|5|6|7|8 <real>...
RIGOL Chapter 2 Command System Return Format The query returns the marker's quadrature component (imaginary) of the Y value in scientific notation. Example The following command sets the quadrature component Y value of Marker 1 to 0.435. :CALCulate:DDEMod:MARKer1:Y:IMAGinary 0.435 The following query returns 4.350000000e-01.
RIGOL Chapter 2 Command System If the specified marker mode is Delta, the center frequency will be set to the frequency of the Delta marker. Example The following command sets the center frequency to the frequency of Marker 1 (Position).
RIGOL Chapter 2 Command System :CALCulate:MARKer<n>[:SET]:STARt Syntax :CALCulate:MARKer<n>[:SET]:STARt Description Sets the start frequency of the analyzer to the frequency of the specified marker. Parameter Name Type Range Default <n> Discrete 1|2|3|4|5|6|7|8 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<n>[:SET]:STOP Syntax :CALCulate:MARKer<n>[:SET]:STOP Description Sets the stop frequency of the analyzer to the frequency of the specified marker. Parameter Name Type Range Default <n> Discrete 1|2|3|4|5|6|7|8 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.
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.
RIGOL Chapter 2 Command System :CONFigure Commands Command List: :CONFIgure:BERate :CONFigure:DDEMod :CONFIgure:BERate Syntax :CONFIgure:BERate Description Sets the analyzer to be in the bit error rate measurement state. :CONFigure:DDEMod Syntax :CONFigure:DDEMod Description Sets the analyzer to be in the digital demodulation measurement state.
RIGOL Chapter 2 Command System :DISPlay:BACKlight Syntax :DISPlay:BACKlight <integer> :DISPlay:BACKlight? Description Sets the brightness of the backlight of LCD. Queries the brightness of the backlight of LCD. Parameter Name Type Range Default <integer> Integer 1 to 100 Return Format The query returns the brightness of the LCD backlight in integer.
RIGOL Chapter 2 Command System :DISPlay:DDEMod:TRACe<n>:DDEMod:SYMBol:FORMat Syntax :DISPlay:DDEMod:TRACe<n>:DDEMod:SYMBol:FORMat HEXadecimal|BINary :DISPlay:DDEMod:TRACe<n>:DDEMod:SYMBol:FORMat? Description Sets the symbol format of the specified trace. Queries the symbol format of the specified trace. Parameter Name Type Range Default <n> Discrete 1|2|3|4 Keyword HEXadecimal|BINary BINary Remarks HEXadecimal: indicates the hexadecimal format.
RIGOL Chapter 2 Command System :DISPlay:DDEMod:TRACe<n>:FORMat Syntax :DISPlay:DDEMod:TRACe<n>:FORMat IEYE|QEYE|CONS|MLOG|REAL|IMAGinary|VECTor|PHASe|UPHas|MLINear :DISPlay:DDEMod:TRACe<n>:FORMat? Description Sets the display format of the specified trace. Queries the display format of the specified trace. Parameter Name Type Range Default <n> Discrete 1|2|3|4 IEYE|QEYE|CONS|MLOG|REAL| Keyword VECTor IMAGinary|VECTor|PHASe|UPHas|MLINear Remarks IEYE: indicates I-Eye.
RIGOL Chapter 2 Command System Remarks ON: sets to Auto mode. The instrument adjusts the X-axis reference value and X-axis width to an optimal state. OFF: sets to Manual mode. You need to set the X-axis reference value and X-axis width manually.
RIGOL Chapter 2 Command System :DISPlay:DDEMod:TRACe<n>:X[:SCALe]:RPOSition Syntax :DISPlay:DDEMod:TRACe<n>:X[:SCALe]:RPOSition LEFT|CENTer|RIGHt :DISPlay:DDEMod:TRACe<n>:X[:SCALe]:RPOSition? Description Sets the position from which the X-axis scale reference value is calculated for the specified trace. Queries the position from which the X-axis scale reference value is calculated for the specified trace.
RIGOL Chapter 2 Command System The following query returns 5.000000000e+01. :DISPlay:DDEMod:TRACe1:X:SCALe:SPAN? :DISPlay:DDEMod:TRACe<n>:Y[:SCALe]:AUTO:ONCE Syntax :DISPlay:DDEMod:TRACe<n>:Y[:SCALe]:AUTO:ONCE Description Sets the Y-axis reference level and the Y-axis scale value automatically to ensure that the signal can be fully displayed for better observation of the trace.
RIGOL Chapter 2 Command System :DISPlay:DDEMod:TRACe<n>:Y[:SCALe]:RLEVel Syntax :DISPlay:DDEMod:TRACe<n>:Y[:SCALe]:RLEVel <real> :DISPlay:DDEMod:TRACe<n>:Y[:SCALe]:RLEVel? Description Sets the Y-axis reference of the specified trace. Queries the Y-axis reference of the specified trace. Parameter Name Type Range Default <n> Discrete 1|2|3|4 <ampl> Consecutive Real Number -1e+12 to 1e+12 Remarks The reference unit is determined by the Y-axis unit.
RIGOL Chapter 2 Command System :DISPlay:DDEMod:WINDow:FORMat Syntax :DISPlay:DDEMod:WINDow:FORMat SINGle|LRWindow|UDWindow|LRDWindow|UDRWindow|QUAD :DISPlay:DDEMod:WINDow:FORMat? Description Sets the trace window layout. Queries the trace window layout. Parameter Name Type Range Default Keyword SINGle|LRWindow|UDWindow|LRDWindow|UDRWindow|QUAD QUAD Remarks SINGle: indicates the single window. LRWindow: indicates left and right windows.
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 Range Default Bool OFF|ON|0|1 ON|1 Return Format The query returns 0 or 1.
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. Parameter Name Type...
Page 44
RIGOL Chapter 2 Command System INTeger,32: binary 32-bit integer values. REAL,32: binary 32-bit real values. REAL,64: binary 64-bit real values. Return Format The query returns ASC,8, INT,32, REAL,32, or REAL,64. Example The following command sets the input/output format of the trace data to REAL,32.
RIGOL Chapter 2 Command System 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". Command List: *CLS *ESE *ESR? ...
RIGOL Chapter 2 Command System *CLS Syntax *CLS Description Clears all the event registers and status byte registers. *ESE Syntax *ESE <value> *ESE? Description Sets the enable register for the standard event status register. Queries the enable register for the standard event status register.
The query returns the ID string in the following format: Rigol Technologies,<model>,<serial number>,XX.XX.XX <model>: instrument model <serial number>: serial number of the instrument XX.XX.XX: software version of the instrument Example The following query returns Rigol Technologies,RSA5065,RSA5A010200001,00.02.00. *IDN? *OPC Syntax *OPC *OPC?
RIGOL Chapter 2 Command System Example The following command recalls Register 1. *RCL 1 *RST Syntax *RST Description Restores the instrument to its factory default settings. *SAV Syntax *SAV <integer> Description Saves the current instrument state to the selected register.
RIGOL Chapter 2 Command System Example The following command sets the enable register for the status byte register to 16. *SRE 16 The following query returns 16. *SRE? *STB? Syntax *STB? Description Queries the event register for the status byte register.
RIGOL Chapter 2 Command System *WAI Syntax *WAI Description Waits for all the pending operations to complete before executing any additional commands. 2-36 VSA Programming Guide...
RIGOL Chapter 2 Command System :INITiate Command Command List: :INITiate:BER:RESTart :INITiate:CONTinuous :INITiate:BER:RESTart Syntax :INITiate:BER:RESTart Description Restarts the BER test. Remarks This command is valide only when the BER Test measurement function is selected. :INITiate:CONTinuous Syntax :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Description Selects continuous (ON|1) or single (OFF|0) sweep mode.
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|3|4 :INSTrument:NSELect? :INSTrument[:SELect] SA|RTSA|VSA|EMI :INSTrument[:SELect]? Description Selects the working mode of the instrument. Queries the working mode of the instrument. Parameter Name Type Range Default Discrete 1|2|3|4 Keyword SA|RTSA|VSA|EMI Remarks The above parameters 1|2|3|4 correspond to SA|RTSA|VSA|EMI, respectively.
RIGOL Chapter 2 Command System Remarks This operation fails if the specified file does not exist. Example The following command loads the FMT file (mask1.csv) to the upper mask. :MMEMory:LOAD:FMT upper,mask1.csv :MMEMory:LOAD:STATe Syntax :MMEMory:LOAD:STATe <file_name> Description Loads the specified state file (.sta).
RIGOL Chapter 2 Command System :MMEMory:MOVE Syntax :MMEMory:MOVE <file_name1>,<file_name2> Description Renames the specified file <file_name1> as <file_name2>. Parameter Name Type Range Default <file_name1> ASCII String <file_name2> ASCII String Remarks <file_name1> and <file_name2> should contain the path and the filename. This operation fails if the file with the specified filename does not exist.
RIGOL Chapter 2 Command System Remarks If the specified file already exists, overwrite it. If a suffix (.jpg/.png/.bmp) is added to the filename, you can save the current screen image with a different format based on its different suffix. If no suffix is added to the filename, then by default, the current screen image is saved in the currently selected format.
If the output impedance of the system under measurement is 75 Ω, you should use a 75 Ω to 50 Ω adapter (option) supplied by RIGOL to connect the analyzer with the system under test, and then set the input impedance to 75 Ω.
RIGOL Chapter 2 Command System [:SENSe]:CORRection:SA[:RF]:GAIN Syntax [:SENSe]:CORRection:SA[:RF]:GAIN <rel_ampl> [:SENSe]:CORRection:SA[:RF]:GAIN? Description Sets the external gain. Queries the external gain. Parameter Name Type Range Default <rel_ampl> Consecutive Real Number -120 dB to 120 dB 0 dB Return Format The query returns the external gain value in scientific notation. The unit is dB.
RIGOL Chapter 2 Command System Description Sets the type of the FFT window function. Queries the type of the FFT window function. Parameter Name Type Range Default Keyword UNIForm|HANNing|GAUSsian|FLATtop UNIForm Return Format The query returns UNIF, HANN, GAUS, or FLAT.
RIGOL Chapter 2 Command System [:SENSe]:DDEMod:FILTer:MEASurement:USER<n>[:DATA] Syntax [:SENSe]:DDEMod:FILTer:MEASurement:USER<n>[:DATA] <ampl>{,<ampl>} [:SENSe]:DDEMod:FILTer:MEASurement:USER<n>[:DATA]? Description Sets the data of the specified measurement user-defined filter. Queries the data of the specified measurement user-defined filter. Parameter Name Type Range Default <n> Discrete 1|2|3|4|5|6 —— <ampl> Consecutive Real Number ——...
RIGOL Chapter 2 Command System :SENSe:DDEMod:FILTer:REFerence GAUSsian The following query returns GAUS. :SENSe:DDEMod:FILTer:REFerence? [:SENSe]:DDEMod:FILTer:REFerence:USER<n>[:DATA] Syntax [:SENSe]:DDEMod:FILTer:REFerence:USER<n>[:DATA] <ampl>{,<ampl>} [:SENSe]:DDEMod:FILTer:REFerence:USER<n>[:DATA]? Description Sets the data of the specified reference user-defined filter. Queries the data of the specified reference user-defined filter. Parameter Name Type...
RIGOL Chapter 2 Command System Example The following command sets the reference frequency offset to 1 MHz. :SENSe:DDEMod:FSK:DEViation:REFerence 1000000 The following query returns 1.000000000e+06. :SENSe:DDEMod:FSK:DEViation:REFerence? [:SENSe]:DDEMod:FSK:DEViation:REFerence:AUTO Syntax [:SENSe]:DDEMod:FSK:DEViation:REFerence:AUTO ON|OFF|1|0 [:SENSe]:DDEMod:FSK:DEViation:REFerence:AUTO? Description Enables or disables the reference frequency offset mode in the FSK modulation.
RIGOL Chapter 2 Command System Return Format The query returns the BER test filename. Example The following command loads the BER test file "ber1.xml" from the path "/vsa/BerTest". :SENSe:DDEMod:LOAD:KNOWndata /vsa/BerTest/ber1.xml The following query returns ber1. :SENSe:DDEMod:LOAD:KNOWndata? [:SENSe]:DDEMod:MODulation Syntax [:SENSe]:DDEMod:MODulation QAM16|QAM32|QAM64|BPSK|QPSK|OQPSK|DQPSK|PSK8|PI4DQPSK|PI8DPSK8|DPSK8|FSK2|FSK4|FSK8|...
RIGOL Chapter 2 Command System Remarks NORMal: indicates that disable the differential coding. DIFFerential: indicates that enable the differential coding. Return Format The query returns NORM or DIFF. Example The following command enables the differential coding. :SENSe:DDEMod:MSK:FORMat DIFFerential The following query returns DIFF.
RIGOL Chapter 2 Command System Return Format The query returns POS, NEG, AVER or SAM. Example The following command sets the detector to POSitive. :SENSe:DDEMod:RTTrace:DETector POSitive The following query returns POS. :SENSe:DDEMod:RTTrace:DETector? [:SENSe]:DDEMod:SRATe Syntax [:SENSe]:DDEMod:SRATe <frequency> [:SENSe]:DDEMod:SRATe? Description Sets the symbol rate of the digital demodulation.
RIGOL Chapter 2 Command System Return Format The query returns GSM, NADC, WCDMA, PDC, PHP, BLUETOOTH, WLAN11B, ZIGBEE2450, TETRA, DECT, APCO, ZIGBEE868, or ZIGBEE915. Example The following command sets the preset standard of the digital demodulation to GSM. :SENSe:DDEMod:STANdard:PRESet GSM...
RIGOL Chapter 2 Command System Return Format The query returns the sync analyze length in integer. Example The following command sets the sync analyze length to 50. :SENSe:DDEMod:SYNC:ALENgth 50 The following query returns 50. :SENSe:DDEMod:SYNC:ALENgth? [:SENSe]:DDEMod:SYNC:BURSt:RUNIn Syntax [:SENSe]:DDEMod:SYNC:BURSt:RUNIn <interger> [:SENSe]:DDEMod:SYNC:BURSt:RUNIn? Description Sets the burst search run-in.
RIGOL Chapter 2 Command System Example The following command enables the burst search. :SENSe:DDEMod:SYNC:BURSt:STATe ON or :SENSe:DDEMod:SYNC:BURSt:STATe 1 The following query returns 1. :SENSe:DDEMod:SYNC:BURSt:STATe? [:SENSe]:DDEMod:SYNC:SLENgth Syntax [:SENSe]:DDEMod:SYNC:SLENgth <time> [:SENSe]:DDEMod:SYNC:SLENgth? Description Sets the burst search length. Queries the burst search length.
RIGOL Chapter 2 Command System [:SENSe]:DDEMod:SYNC:SWORd:PATTern Syntax [:SENSe]:DDEMod:SYNC:SWORd:PATTern <string> [:SENSe]:DDEMod:SYNC:SWORd:PATTern? Description Sets the bit pattern for the sync search. Queries the bit pattern for the sync search. Parameter Name Type Range Default <string> Consecutive Real Number 0 to 32 symbols Return Format The query returns the bit pattern for the sync search in strings.
RIGOL Chapter 2 Command System Description Sets the center frequency. Queries the center frequency. Parameter Name Type Range Default <freq> Consecutive Real Number 1.562 kHz to (Fmax – 1.562 kHz) 1 GHz Note : The maximum measurement frequency Fmax is determined by the instrument model. For RSA5065, Fmax is 6.5 GHz;...
RIGOL Chapter 2 Command System Parameter Name Type Range Default <freq> Consecutive Real Number -Fmax to Fmax Span/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:STOP Syntax [:SENSe]:FREQuency:STOP <freq> [:SENSe]:FREQuency:STOP? Description Sets the stop frequency. Queries the stop frequency. Parameter Name Type Range Default <freq> Consecutive Real Number 3.125 kHz to Fmax center frequency + span/2 Return Format The query returns the stop frequency in scientific notation. The unit is Hz.
RIGOL Chapter 2 Command System :STATus Commands The :STATus commands and IEEE 488.2 Common Commands are used to operate or query the status registers. The structure of the status register is shown in the following figure. The STATus commands are used to set and query the questionable status register and operation status register.
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 <integer> :STATus:OPERation:ENABle? Description Sets the enable register of the operation status register.
RIGOL Chapter 2 Command System Example The following command sets the enable register of the Operation Status Register to 100. :STATus:OPERation:ENABle 100 The following query returns 100. :STATus:OPERation:ENABle? :STATus:OPERation[:EVENt]? Syntax :STATus:OPERation[:EVENt]? Description Queries the event register of the Operation Status Register.
RIGOL Chapter 2 Command System Remarks The definition of the Questionable Status Register is shown in the following table. Bit 0-8, Bit 13, and Bit 14 are reserved. You can set their values but they will not affect the system. Bit 15, Bit 12-9 are not used and they are always treated as 0.
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 on/off status of the beeper. Parameter Name Type Range Default Bool OFF|ON|0|1 OFF|0 Return Format The query returns 0 or 1.
RIGOL Chapter 2 Command System 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. Queries the status of the DHCP configuration mode.
RIGOL Chapter 2 Command System 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.199 The following query returns 172.16.3.199.
RIGOL Chapter 2 Command System Remarks The format of <ip_address> 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.
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway Syntax :SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway <ip_address> :SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway? Description Sets the default gateway. Queries the default gateway. Parameter Name Type Range Default <ip_address> ASCII String Refer to "Remarks" Remarks The format of <ip_address> is "nnn.nnn.nnn.nnn". The range for the first segment (nnn) of the address is from 1 to 223 (except 127);...
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe Syntax :SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe OFF|ON|0|1 :SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe? Description Enables or disables the manual IP setting mode. Queries the status of the manual IP setting mode. Parameter Name Type Range Default Bool OFF|ON|0|1 OFF|0 Remarks The analyzer attempts to acquire the IP address configuration according to the sequence of DHCP, Auto IP, and Manual IP.
RIGOL Chapter 2 Command System The following query returns 1. :SYSTem:COMMunicate:LAN:SELF:MDNS:STATe? :SYSTem:COMMunicate:LAN[:SELF]:RESet Syntax :SYSTem:COMMunicate:LAN[:SELF]:RESet Description Resets the LAN setting: enable the DHCP, disable Auto IP and the Manual IP. :SYSTem:CONFigure:INFormation? Syntax :SYSTem:CONFigure:INFormation? Description Queries the system information of the spectrum analyzer.
RIGOL Chapter 2 Command System Return Format The query returns the current date in the format of "YYYY,MM,DD". Example The following command sets the date of the instrument to 2017/11/16. :SYSTem:DATE 2017,11,16 The following query returns 2017,11,16 :SYSTem:DATE? :SYSTem:FSWitch[:STATe] Syntax...
RIGOL Chapter 2 Command System The following query returns ENGL. :SYSTem:LANGuage? :SYSTem:LKEY Syntax :SYSTem:LKEY <option info>@<license info> :SYSTem:LKEY? <option info> Description Installs and activates the specified option. Queries the serial number of the specified option. Parameter Name Type Range Default <option info>...
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 Range Default Keyword PRESet|LAST PRESet Remarks PRESet: indicates preset settings, including factory mode and 6 user-defined settings.
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 the factory mode or any one of the items from User1 to User6. Queries the preset type of the system. Parameter...
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the SCPI display. :SYSTem:SCPI:DISPlay 1 or :SYSTem:SCPI:DISPlay ON The following query returns 1. :SYSTem:SCPI:DISPlay? :SYSTem:SECurity:CLEar Syntax :SYSTem:SECurity:CLEar Description Clears all the data that you set safely.
RIGOL Chapter 2 Command System :SYSTem:TIME Syntax :SYSTem:TIME <hour>,<minute>,<second> :SYSTem:TIME? Description Sets the system time of the instrument. Queries the system time of the instrument. Parameter Name Type Range Default <hour> ASCII String 00 to 23 <minute> ASCII String 00 to 59 <second>...
RIGOL Chapter 2 Command System :TRACe Command Command List: :TRACe<n>[:DATA]? :TRACe<n>[:DATA]? Syntax :TRACe<n>[:DATA]? Description Queries the log data of the specified trace. Parameter Name Type Range Default <n> Discrete 1|2|3|4 Remarks The format of the user data is set by the :FORMat[:TRACe][:DATA] command.
RIGOL Chapter 2 Command System Return Format The query returns the time value in scientific notation. The unit is s. Example The following command sets the time to 10 ms. :TRIGger:SEQuence:ATRigger 0.01 The following query returns 1.000000000e-02. :TRIGger:SEQuence:ATRigger? :TRIGger[:SEQuence]:ATRigger:STATe Syntax...
RIGOL Chapter 2 Command System Return Format The query returns the delay time for the external trigger in scientific notation. The unit is s. Example The following command sets the delay time for External Trigger 1 to 100 ms. :TRIGger:SEQuence:EXTernal1:DELay 0.1 The following query returns 1.000000000e-01.
RIGOL Chapter 2 Command System Remarks When the parameter n is set to 1, it indicates External Trigger 1; when set to 2, it indicates External Trigger POSitive: indicates the rising edge. NEGative: indicates the falling edge. Return Format The query returns POS or NEG Example The following command sets the trigger edge of External Trigger 1 to POSitive.
RIGOL Chapter 2 Command System Parameter Name Type Range Default <time> Consecutive Real Number 0 us to 500 ms 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 Queries the mask to be used for the current trigger. Parameter Name Type Range Default —— Keyword UPPer|LOWer|BOTH UPPer Remarks This command is only valid when you select FMT to be the trigger source. Return Format The query returns UPP, LOW, or BOTH.
RIGOL Chapter 2 Command System Queries whether the amplitudes of the mask points are coupled to the reference level of the instrument. Parameter Name Type Range Default —— Bool OFF|ON|0|1 OFF|0 Remarks OFF|0: disables the coupling function. That is, when "Fixed" is selected under Y Axis Type, the amplitude of the current mask point will not be affected by the reference level.
RIGOL Chapter 2 Command System Return Format The query returns 1 or 0. Example The following command enables the coupling relationship between the frequencies of the mask points and the instrument's center frequency. :TRIGger:SEQuence:FMT:MASK:RELative:FREQuency ON or :TRIGger:SEQuence:FMT:MASK:RELative:FREQuency 1 The following query returns 1.
RIGOL Chapter 2 Command System Return Format The query returns the mask parameters that are being edited currently in scientific notation. Example The following command edits the two points of the upper mask. :TRIGger:SEQuence:FMT:MASK1:DATA –80000000, –50, 80000000, –50 The following query returns –8.000000e+07, –5.000000e+01, 8.000000e+07, –5.000000e+01 :TRIGger:SEQuence:FMT:MASK1:DATA? :TRIGger[:SEQuence]:FMT:MASK<n>:DELete...
RIGOL Chapter 2 Command System :TRIGger[:SEQuence]:FMT:MASK<n>:NEW Syntax :TRIGger[:SEQuence]:FMT:MASK<n>:NEW Description Clears the currently activated mask and creates a default new mask. Parameter Name Type Range Default <n> Discrete —— Remarks When <n> 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.
RIGOL Chapter 2 Command System Parameter Name Type Range Default Bool OFF|ON|0|1 OFF|0 Return Format The query returns 1 or 0. Example The following command enables the trigger holdoff function. :TRIGger:SEQuence:HOLDoff:STATe ON or :TRIGger:SEQuence:HOLDoff:STATe 1 The following query returns 1.
RIGOL Chapter 2 Command System Remarks EXTernal1: indicates External Trigger 1. EXTernal2: indicates External Trigger 2. IMMediate: indicates the free-run trigger. FMT: indicates the frequency mask trigger. POWer: indicates IF Power Trigger. Return Format The query returns EXT1, EXT2, IMM, FMT, or POW.
RIGOL Chapter 3 Appendix Chapter 3 Appendix Appendix A: Default Settings Sending the *RST command can restore the instrument to default settings, as shown in the table below. Parameter Name VSA Parameter Value FREQ Center Freq 1 GHz Start Freq 998.4375 MHz...
There is no other warranty, expressed or implied, except such as is expressly set forth herein or other applicable warranty card. There is no implied warranty of merchantability or fitness for a particular purpose. Under no circumstances shall RIGOL be liable for any consequential, indirect, ensuing, or special damages for any breach of warranty in any case.