Page 1 RIGOL Programming Guide RSA3000 Series Real- time Spectrum Analyzer Jan. 29, 2018 RIGOL TECHNOLOGI ES, I NC. www.valuetronics.com...
Page 2 www.valuetronics.com...
Page 3: Guaranty And Declaration
I SO9001: 2008 standard and the I SO14001: 2004 standard. Other international standard conformance certif ications are in progress. Contact Us I f you have any problem or requirement when using our products or this manual, please contact RIGOL E-mail: service@rigol.com Website: www.rigol.com RSA3000 Programming Guide www.valuetronics.com...
Page 4: Document Overview
Content Conventions in this Manual: The RSA3000 series spectrum analyzer includes the following models. Unless otherwise specif ied, this manual takes RSA3045 as an example to illustrate the usage of each command of RSA3000 series spectrum analyzer. Model...
Page 5: Table Of Contents
Contents RIGOL Contents Guaranty and Declaration ......................I Document Overview ......................... I I Chapter 1 Programming Overview ..................1- 1 Build Remote Communication ....................1-2 Remote Control Method ......................1-3 SCPI Command Overview ......................1-4 Syntax ..........................1-4 Symbol Description ......................1-4 Parameter Type ........................
Page 6 RIGOL Contents :CALCulate:MARKer< n> : FUNCtion:BAND:RI GHt ..............2-23 :CALCulate:MARKer< n> : FUNCtion:BAND: SPAN ..............2-24 :CALCulate:MARKer< n> : FUNCtion:BAND: SPAN:AUTO ............2-24 :CALCulate:MARKer< n> : LI Nes[ :STATe] ................2-25 :CALCulate:MARKer< n> : MAXimum: LEFT ................2-25 :CALCulate:MARKer< n> : MAXimum[ :MAX] ................. 2-26 :CALCulate:MARKer<...
Page 7 Contents RIGOL :DI SPlay:PVTime: WI NDow: TRACe:X[ : SCALe] :COUPle ............2-51 :DI SPlay:PVTime: WI NDow: TRACe:X[ : SCALe] :PDI Vision ............. 2-51 :DI SPlay:PVTime: WI NDow: TRACe:X[ : SCALe] :RLEVel ............2-52 :DI SPlay:PVTime: WI NDow: TRACe:X[ : SCALe] :RPOSition ............. 2-52 :DI SPlay:PVTime: WI NDow: TRACe:Y[ : SCALe] :PDI Vision .............
Page 8 RIGOL Contents * ESE ..........................2-82 * ESR? ..........................2-83 * I DN? ..........................2-83 * OPC ..........................2-84 * RCL ..........................2-84 * RST ..........................2-84 * SAV ..........................2-85 * SRE ..........................2-85 * STB? ..........................2-86 * TRG ..........................2-86 * TST? ..........................
Page 9 Contents RIGOL :READ: TOI ntercept? ....................... 2-107 :READ: TOI ntercept:I P3? ....................2-108 :READ: TPOWer? ......................2-108 [ :SENSe] Commands......................2-109 [ :SENSe] :ACPower:AVERage:COUNt ................2-112 [ :SENSe] :ACPower:AVERage[ :STATe] ................2-112 [ :SENSe] :ACPower:AVERage:TCONtrol ................2-113 [ :SENSe] :ACPower:BANDwidth:ACHannel ................ 2-113 [ :SENSe] :ACPower:BANDwidth:I NTegration ..............
Page 10 RIGOL Contents [ :SENSe] :FREQuency: SPAN ..................... 2-140 [ :SENSe] :FREQuency: SPAN:BANDwidth[ :RESolution] :RATio ..........2-140 [ :SENSe] :FREQuency: SPAN:BANDwidth[ :RESolution] :RATio:AUTO ........2-141 [ :SENSe] :FREQuency: SPAN:FULL ..................2-141 [ :SENSe] :FREQuency: SPAN:PREVious ................2-141 [ :SENSe] :FREQuency: SPAN:ZERO ................... 2-142 [ :SENSe] :FREQuency: STARt ....................
Page 11 Contents RIGOL :SOURce: TRACe:STORref ....................2-169 :STATus Commands ......................2-170 :STATus:OPERation:CONDition?..................2-171 :STATus:OPERation:ENABle ..................... 2-171 :STATus:OPERation[ :EVENt] ? ..................2-172 :STATus:PRESet ......................2-172 :STATus:QUEStionable:CONDition? .................. 2-172 :STATus:QUEStionable:ENABle ..................2-172 :STATus:QUEStionable[ :EVENt] ? ..................2-173 :SYSTem Commands ......................2-174 :SYSTem:BEEPer:STATe ....................2-175 :SYSTem:COMMunicate:LAN[ :SELF] :APPLy ..............
Page 12 RIGOL Contents :TRI Gger[ :SEQuence] :EXTernal< n> : DELay: STATe ............2-198 :TRI Gger[ :SEQuence] :EXTernal< n> : SLOPe ..............2-199 :TRI Gger[ :SEQuence] :FMT: APTRigger ................2-199 :TRI Gger[ :SEQuence] :FMT: CRI Teria ................2-200 :TRI Gger[ :SEQuence] :FMT: DELay ................... 2-201 :TRI Gger[ :SEQuence] :FMT: DELay:STATe .................
Page 13: Chapter 1 Programming Overview
Chapter 1 Programming Overview RIGOL Chapter 1 Programming Overview This chapter introduces how to set up remote communication between the spectrum analyzer and the PC, the remote control methods, the syntax, symbols, parameters, and abbreviation rules of the SCPI commands.
Page 14: Build Remote Communication
I nstall Ultra Sigma ( PC) softw are. You can download Ultra Sigma from the off icial 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 RSA3000 supports three communication interfaces: USB and LAN.
Page 15: Remote Control Method
Send SCPI commands via the PC softw are You can use the PC software to send commands to control RSA3000 remotely. Ultra Sigma is RIGOL recommended. You can download the software from RIGOL off icial website (www.rigol.com). RSA3000 Programming Guide www.valuetronics.com...
Page 16: Scpi Command Overview
RIGOL Chapter 1 Programming Overview SCPI Command Overview SCPI (Standard Commands for Programmable I nstruments) is a standardized instrument programming language that is built upon the existing standard I EEE 488.1 and I EEE 488.2 and conforms to various standards, such as the floating point operation rule in I EEE 754 standard, I SO 646 7-bit coded character set for information interchange (equivalent to ASCI I programming).
Page 17: Parameter Type
Chapter 1 Programming Overview RIGOL Parameter Type The command parameters introduced in this manual include 6 types: Bool, Keyword, I nteger, Consecutive Real Number, Discrete, and ASCI I String. Bool The parameter can be set to OFF (0) or ON (1).
Page 18 www.valuetronics.com...
Page 19: Chapter 2 Command System
Chapter 2 Command System RIGOL Chapter 2 Command System This chapter introduces the commands of the RSA3000 series spectrum analyzer. Contents in this chapter:  :CALCulate Commands  :CALibration Commands  :CONFigure Commands  :COUPle Commands  :DI SPlay Commands ...
Page 20: Calculate Commands
RIGOL Chapter 2 Command System :CALCulate Commands Command List:  :CALCulate:BANDwidth| BWI Dth: NDB  :CALCulate:BANDwidth| BWI Dth:RESult?  :CALCulate:BANDwidth| BWI Dth:RLEFt?  :CALCulate:BANDwidth| BWI Dth:RRI Ght?  :CALCulate:BANDwidth| BWI Dth [ : STATe]  :CALCulate:LLI Ne:ALL: DELete  :CALCulate:LLI Ne:TEST ...
Page 21 Chapter 2 Command System RIGOL  :CALCulate:MARKer< n> : FCOunt: X?  :CALCulate:MARKer< n> : FUNCtion  :CALCulate:MARKer< n> : FUNCtion:BAND: LEFT  :CALCulate:MARKer< n> : FUNCtion:BAND:RI GHt  :CALCulate:MARKer< n> : FUNCtion:BAND: SPAN  :CALCulate:MARKer< n> : FUNCtion:BAND: SPAN:AUTO ...
Page 22: Calculate:bandwidth| Bwi Dth: Ndb
RIGOL Chapter 2 Command System :CALCulate:BANDw idth| BWI Dth:NDB Syntax :CALCulate:BANDwidth| BWI Dth: NDB < rel_ampl> :CALCulate:BANDwidth| BWI Dth: NDB? Description Sets the N value in N dB BW measurement. Queries the N value in N dB BW measurement. Parameter...
Page 23: Calculate:bandwidth| Bwi Dth:rleft
Chapter 2 Command System RIGOL :CALCulate:BANDw idth| BWI Dth:RLEFt? Syntax :CALCulate:BANDwidth| BWI Dth: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.
Page 24: Calculate:lli Ne:all:delete
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:BWI Dth: STATe ON or :CALCulate:BWI Dth: STATe 1 The following query returns 1.
Page 25: Calculate:lli Ne< N> :Amplitude:cmode:relative
Chapter 2 Command System RIGOL :CALCulate:LLI Ne< n> :AMPLitude:CMODe:RELative Syntax :CALCulate:LLI Ne< n> :AMPLitude:CMODe:RELative OFF| ON| 0| 1 :CALCulate:LLI Ne< n> :AMPLitude:CMODe:RELative? Description Enables or disables the coupling functions between the selected limit line data points and the reference level.
Page 26: Calculate:lli Ne< N> :Copy
RIGOL Chapter 2 Command System :CALCulate:LLI Ne< n> :COPY Syntax :CALCulate:LLI Ne< n> :COPY LLI NE1| LLI NE2| LLI NE3| LLI NE4| LLI NE5| LLI NE6 Description Copies the selected limit line to the current limit line. Parameter Name Type...
Page 27: Calculate:lli Ne< N> :Delete
Chapter 2 Command System RIGOL The following query returns 50,100,0,100,150,1,200,200,1. :CALCulate:LLI Ne2: DATA? :CALCulate:LLI Ne< n> :DELete Syntax :CALCulate:LLI Ne< n> : DELete Description Deletes the selected limit line. Parameter Name Type Range Default < n> Discrete 1| 2| 3| 4| 5| 6 ——...
Page 28: Calculate:lli Ne< N> :Fai L
RIGOL Chapter 2 Command System :CALCulate:LLI Ne< n> :FAI L? Syntax :CALCulate:LLI Ne< n> : FAI L? Description Queries the measurement results of the selected limit line and its associated trace. Parameter Name Type Range Default < n> Discrete 1| 2| 3| 4| 5| 6 ——...
Page 29: Calculate:lli Ne< N> :Margin
Chapter 2 Command System RIGOL :CALCulate:LLI Ne< n> :MARGin Syntax :CALCulate:LLI Ne< n> : MARGin < rel_ampl> :CALCulate:LLI Ne< n> : MARGin? Description Sets the margin for the selected limit line. Queries the margin for the selected limit line. Parameter...
Page 30: Calculate:lli Ne< N> :Trace
RIGOL Chapter 2 Command System :CALCulate:LLI Ne< n> :TRACe Syntax :CALCulate:LLI Ne< n> : TRACe 1| 2| 3| 4| 5| 6 :CALCulate:LLI Ne< n> : TRACe? Description Sets the trace to be tested against the current limit line. Queries the trace to be tested against the current limit line.
Page 31: Calculate:marker:aoff
Chapter 2 Command System RIGOL :CALCulate:LLI Ne2: TYPE UPPer The following query returns UPP . :CALCulate:LLI Ne2: 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.
Page 32: Calculate:marker:peak:excursion:state
RIGOL Chapter 2 Command System Parameter Name Type Range Default < rel_ampl> Consecutive Real Number 0 dB to 100 dB 6 dB Return Format The query returns the peak offset in scientific notation. Example The following command sets the peak offset to 12 dB.
Page 33: Calculate:marker:peak:sort
Chapter 2 Command System RIGOL Remarks  PARameter: indicates parameter. I f "parameter" is selected under search mode, the system will search for the peak of the specif ied parameter on the trace.  MAXimum: indicates maximum. I f "maximum" is selected under search mode, the system will search for the maximum value on the trace.
Page 34: Calculate:marker:peak:table:readout
RIGOL Chapter 2 Command System :CALCulate:MARKer:PEAK:TABLe:READout :TRACe:MATH:PEAK:THReshold Syntax :CALCulate:MARKer:PEAK: TABLe:READout ALL| GTDLine| LTDLine :CALCulate:MARKer:PEAK: TABLe:READout? :TRACe:MATH:PEAK: THReshold NORMal| DLMore| DLLess :TRACe:MATH:PEAK: THReshold? Description Sets the peak criteria that the displayed peak must meet. Queries the peak criteria that the displayed peak must meet.
Page 35: Calculate:marker:peak:threshold
Chapter 2 Command System RIGOL Parameter Name Type Range Default —— Bool OFF| ON| 0| 1 OFF| 0 Return Format The query returns 0 or 1. Example The following command enables the peak table. :CALCulate:MARKer:PEAK: TABLe:STATe ON or :CALCulate:MARKer:PEAK:TABLe:STATe 1 :TRACe:MATH:PEAK: TABLe:STATe ON or :TRACe: MATH:PEAK: TABLe:STATe 1 The following query returns 1.
Page 36: Calculate:marker:table[ :State]
RIGOL Chapter 2 Command System Parameter Name Type Range Default —— Bool OFF| ON| 0| 1 ON| 1 Return Format The query returns 0 or 1. Example The following command enables the peak threshold function. :CALCulate:MARKer:PEAK:THReshold:STATe ON or :CALCulate:MARKer:PEAK: THReshold: STATe 1 The following query returns 1.
Page 37: Calculate:marker< N> :Cpsearch[ :State]
Chapter 2 Command System RIGOL Remarks When the signal track is enabled, the instrument will execute a peak search after each sweep, and set the frequency value at the current peak to the center frequency to keep the signal always displayed at the center of the screen.
Page 38: Calculate:marker< N> :Fcount:gatetime
RIGOL Chapter 2 Command System :CALCulate:MARKer< n> :FCOunt:GATetime Syntax :CALCulate:MARKer< n> : FCOunt: GATetime < time> :CALCulate:MARKer< n> : FCOunt: GATetime? Description Sets the gate time for Marker n. The unit is s. Queries the gate time for Marker n.
Page 39: Calculate:marker< N> :Fcount[ :State]
Chapter 2 Command System RIGOL :CALCulate:MARKer< n> :FCOunt[ :STATe] Syntax :CALCulate:MARKer< n> : FCOunt[ : STATe] OFF| ON| 0| 1 :CALCulate:MARKer< n> : FCOunt[ : STATe] ? Description Enables or disables the frequency counter function of the specif ied marker.
Page 40: Calculate:marker< N> :Function
RIGOL Chapter 2 Command System :CALCulate:MARKer< n> :FUNCtion Syntax :CALCulate:MARKer< n> : FUNCtion NOI Se| BPOWer| BDENsity| OFF :CALCulate:MARKer< n> : FUNCtion? Description Selects the special measurement type for the specified marker. Queries the special measurement type of the specified marker.
Page 41: Calculate:marker< N> :Function:band:ri Ght
Chapter 2 Command System RIGOL Example The following command sets the left edge frequency of the signal involved in the calculation for the Marker 1 band function to 2 MHz. :CALCulate:MARKer1: FUNCtion:BAND:LEFT 2000000 The following query returns 2.000000000e+ 06. :CALCulate:MARKer1: FUNCtion:BAND:LEFT? :CALCulate:MARKer<...
Page 42: Calculate:marker< N> :Function:band:span
RIGOL Chapter 2 Command System :CALCulate:MARKer< n> :FUNCtion:BAND:SPAN Syntax :CALCulate:MARKer< n> : FUNCtion:BAND: SPAN < freq> :CALCulate:MARKer< n> : FUNCtion:BAND: SPAN? Description Sets the bandwidth or the time span of the signal involved in the calculation for the band function.
Page 43: Calculate:marker< N> :Li Nes[ :State]
Chapter 2 Command System RIGOL Return Format The query returns 1 or 0. Example The following command enables the band span auto function of Marker 1. :CALCulate:MARKer1: FUNCtion:BAND:SPAN:AUTO ON or :CALCulate:MARKer1:FUNCtion:BAND: SPAN:AUTO 1 The following query returns 1. :CALCulate:MARKer1: FUNCtion:BAND:SPAN:AUTO? :CALCulate:MARKer<...
Page 44: Calculate:marker< N> :Maximum[ :Max]
RIGOL Chapter 2 Command System 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. Example The following command performs one left peak search, and marks with Marker 2.
Page 45: Calculate:marker< N> :Maximum:ri Ght
Chapter 2 Command System RIGOL :CALCulate:MARKer< n> :MAXimum:RI GHt Syntax :CALCulate:MARKer< n> : MAXimum:RI GHt Description Searches for and marks the nearest peak which is located at the right side of the current peak and meets the peak search condition.
Page 46: Calculate:marker< N> :Mode
RIGOL Chapter 2 Command System :CALCulate:MARKer< n> :MODE Syntax :CALCulate:MARKer< n> : MODE POSition| DELTa| FI Xed| OFF :CALCulate:MARKer< n> : MODE? Description Sets the type of the specif ied marker. Queries the type of the specif ied marker. Parameter...
Page 47: Calculate:marker< N> :Reference
Chapter 2 Command System RIGOL :CALCulate:MARKer< n> :REFerence Syntax :CALCulate:MARKer< n> :REFerence < integer> :CALCulate:MARKer< n> :REFerence? Description Sets the reference marker for the specif ied marker. Queries the reference marker for the specif ied marker. Parameter Name Type Range Default <...
Page 48: Calculate:marker< N> [ :Set] :Delta:center
RIGOL Chapter 2 Command System :CALCulate:MARKer< n> [ :SET] :DELTa:CENTer Syntax :CALCulate:MARKer< n> [ : SET] :DELTa:CENTer Description Sets the frequency difference of the specified Delta marker to the center frequency of the analyzer. Parameter Name Type Range Default < n>...
Page 49: Calculate:marker< N> [ :Set] :Rlevel
Chapter 2 Command System RIGOL :CALCulate:MARKer< n> [ :SET] :RLEVel Syntax :CALCulate:MARKer< n> [ : SET] :RLEVel Description Sets the amplitude of the specified marker to the reference level of the analyzer. Parameter Name Type Range Default < n> Discrete 1| 2| 3| 4| 5| 6| 7| 8 ——...
Page 50: Calculate:marker< N> [ :Set] :Step
RIGOL Chapter 2 Command System :CALCulate:MARKer< n> [ :SET] :STEP Syntax :CALCulate:MARKer< n> [ : SET] :STEP Description Sets the frequency of the specified marker to the center frequency step of the analyzer. Parameter Name Type Range Default < n>...
Page 51: Calculate:marker< N> :State
Chapter 2 Command System RIGOL :CALCulate:MARKer< n> :STATe Syntax :CALCulate:MARKer< n> : STATe OFF| ON| 0| 1 :CALCulate:MARKer< n> : STATe? Description Enables or disables the specif ied marker. Queries the status for the specif ied marker. Parameter Name Type...
Page 52: Calculate:marker< N> :Trace:auto
RIGOL Chapter 2 Command System Return Format The query returns any integer from 1 to 6. I f the marker trace is set to "Auto", the query command returns a trace number on which the marker is placed. Example The following command sets the marker trace of Marker 1 to Trace 2.
Page 53: Calculate:marker< N> :X
Chapter 2 Command System RIGOL :CALCulate:MARKer< n> :X Syntax :CALCulate:MARKer< n> : X < param> :CALCulate:MARKer< n> : X? Description Sets the X-axis value of the specified marker. I ts default unit is Hz. Queries the X-axis value of the specified marker.
Page 54: Calculate:marker< N> :X:readout:auto
RIGOL Chapter 2 Command System Remarks FREQuency: indicates frequency. I t is the default readout mode in non-zero span mode. TI ME: indicates time. I t is the default readout mode in zero span mode. I TI Me: indicates the reciprocal of time. I t is available only in zero span mode and a Delta marker is selected.
Page 55: Calculate:marker< N> :Y
Chapter 2 Command System RIGOL :CALCulate:MARKer< n> :Y Syntax :CALCulate:MARKer< n> :Y < amp> :CALCulate:MARKer< n> :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.
Page 56: Calculate:math
RIGOL Chapter 2 Command System Example The following command sets the trace number of the trace where the marker1 stays in to 100. :CALCulate:MARKer1: Z:POSition 100 The following query returns 100. :CALCulate:MARKer1: Z:POSition? :CALCulate:MATH Syntax :CALCulate:MATH < trace_destination> ,< function_math> ,< trace1_operation> ,< trace2_operation> ,< rel_offset> ,< rel_refer ence>...
Page 57: Calculate:ntdata[ :State]
Chapter 2 Command System RIGOL :CALCulate:MATH TRACE1,PDI Fference,TRACE4,TRACE5,, The following query returns PDI Fference. :CALCulate:MATH? TRACE1 :CALCulate:NTData[ :STATe] Syntax :CALCulate:NTData[ :STATe] OFF| ON| 0| 1 :CALCulate:NTData[ :STATe] ? Description Enables or disables the normalize function. Queries the status of normalization.
Page 58: Calibration Commands
RIGOL Chapter 2 Command System :CALibration Commands Command List:  :CALibration:[ ALL]  :CALibration:AUTO :CALibration:[ ALL] Syntax :CALibration:[ ALL] Description Executes self-calibration immediately. Remarks I f the self-calibration succeeded, the command :CALibration:[ ALL] ? returns 0; if failed, the command : CALibration:[ ALL] ? returns 1.
Page 59: Configure Commands
 :CONFigure: SPECtrogram  :CONFigure: TOI *  :CONFigure: TPOWer* Remarks: The commands with * are only available for the RSA3000 series that has been installed with advanced measurement kit option. :CONFigure? Syntax :CONFigure? Description Queries the current measurement function.
Page 60: Configure:acpower
RIGOL Chapter 2 Command System :CONFigure:ACPow er 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 specif ied measurement of the instrument to the default factory state.
Page 61: Configure:dspectrogram
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 specif ied measurement of the instrument to the default factory state.
Page 62: Configure:mchpower
RIGOL Chapter 2 Command System :CONFigure:MCHPow er 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 specif ied measurement of the instrument to the default factory state.
Page 63: Configure:psgram
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 specif ied measurement of the instrument to the default factory state.
Page 64: Configure:spectrogram
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 specif ied measurement of the instrument to the default factory state.
Page 65: Couple Commands
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". RSA3000 Programming Guide 2-47 www.valuetronics.com...
Page 66: Di Splay Commands
RIGOL Chapter 2 Command System :DI SPlay Commands Command List:  :DI SPlay:BACKlight  :DI SPlay:ENABle  :DI SPlay:GRATicule[ : STATe]  :DI SPlay:HDMI [ : STATe]  :DI SPlay:PVTime: WI NDow: TRACe:X[ : SCALe] :COUPle  :DI SPlay:PVTime: WI NDow: TRACe:X[ : SCALe] :PDI Vision ...
Page 67: Di Splay:backlight
Chapter 2 Command System RIGOL :DI SPlay:BACKlight Syntax :DI SPlay:BACKlight < integer> :DI SPlay:BACKlight? Description Sets the brightness of the backlight of LCD. Queries the brightness of the backlight of LCD. Parameter Name Type Range Default < integer> I nteger...
Page 68: Di Splay:graticule[ :State]
RIGOL Chapter 2 Command System :DI SPlay:GRATicule[ :STATe] Syntax :DI SPlay:GRATicule[ : STATe] OFF| ON| 0| 1 :DI SPlay:GRATicule[ : STATe] ? Description Enables or disables the display of the graticule. Queries the display of the graticule. Parameter Name Type...
Page 69: Di Splay:pvtime:wi Ndow :Trace:x[ :Scale] :Couple
Chapter 2 Command System RIGOL :DI SPlay:PVTime:WI NDow :TRACe:X[ :SCALe] :COUPle Syntax :DI SPlay:PVTime: WI NDow: TRACe:X[ : SCALe] :COUPle OFF| ON| 0| 1 :DI SPlay:PVTime: WI NDow: TRACe:X[ : SCALe] :COUPle? Description Enables or disables the auto scale function for the horizontal axis in the PvT view.
Page 70: Di Splay:pvtime:wi Ndow :Trace:x[ :Scale] :Rlevel
RIGOL Chapter 2 Command System The following query returns 4.000000000e-07. :DI SPlay:PVTime: WI NDow: TRACe:X:SCALe:PDI Vision? :DI SPlay:PVTime:WI NDow :TRACe:X[ :SCALe] :RLEVel Syntax :DI SPlay:PVTime: WI NDow: TRACe:X[ : SCALe] :RLEVel < real> :DI SPlay:PVTime: WI NDow: TRACe:X[ : SCALe] :RLEVel? Description Sets the reference time for the horizontal axis in the PvT view.
Page 71: Di Splay:pvtime:wi Ndow :Trace:y[ :Scale] :Pdi Vision
Chapter 2 Command System RIGOL "Left". :DI SPlay:PVTime: WI NDow: TRACe:X:SCALe:RPOSition LEFT The following query returns LEFT. :DI SPlay:PVTime: WI NDow: TRACe:X:SCALe:RPOSition? :DI SPlay:PVTime:WI NDow :TRACe:Y[ :SCALe] :PDI Vision Syntax :DI SPlay:PVTime: WI NDow: TRACe:Y[ : SCALe] :PDI Vision < rel_ampl>...
Page 72: Di Splay:vi Ew:density:aadjust
RIGOL Chapter 2 Command System Return Format The query returns the reference level for the vertical axis in scientific notation. Example The following command sets the reference level for the vertical axis in the PvT view to 100 dBm. :DI SPlay:PVTime: WI NDow: TRACe:Y: SCALe:RLEVel 100 The following query returns 1.000000000e+ 02.
Page 73: Di Splay:vi Ew:density:cpalettes
Chapter 2 Command System RIGOL :DI SPlay:VI EW:DENSity:CPALettes Syntax :DI SPlay:VI EW:DENSity:CPALettes COOL| WARM| RADar| FI RE| FROSt :DI SPlay:VI EW:DENSity:CPALettes? Description Sets the color palette of Density. Queries the color palette of Density. Parameter Name Type Range Default ——...
Page 74: Di Splay:vi Ew:density:ldhue
RIGOL Chapter 2 Command System :DI SPlay:VI EW:DENSity:LDHue Syntax :DI SPlay:VI EW:DENSity: LDHue < real> :DI SPlay:VI EW:DENSity: LDHue? Description Sets the lowest density hue. Queries the lowest density hue. Parameter Name Type Range Default < real> Consecutive Real Number 0 to 99.9...
Page 75: Di Splay:vi Ew:density:persistence:i Nfinite
Chapter 2 Command System RIGOL :DI SPlay:VI EW:DENSity:PERSistence:I NFinite Syntax :DI SPlay:VI EW:DENSity:PERSistence:I NFinite OFF| ON| 0| 1 :DI SPlay:VI EW:DENSity:PERSistence:I NFinite? Description Enables or disables the inf inite mode of the persistence time. Queries the status of the inf inite mode of the persistence time.
Page 76: Di Splay:vi Ew:spectrogram:aadjust
RIGOL Chapter 2 Command System Example The following commands sets the current view to Spectrogram. :DI SPlay:VI EW:SELect SPECtrogram The following query returns SPEC. :DI SPlay:VI EW:SELect? :DI SPlay:VI EW:SPECtrogram:AADJust Syntax :DI SPlay:VI EW:SPECtrogram:AADJust Description Auto adjusts the reference hue position and bottom hue position based on the highest amplitude value and the lowest amplitude value found in the spectrogram, respectively.
Page 77: Di Splay:vi Ew:spectrogram:hue
Chapter 2 Command System RIGOL :DI SPlay:VI EW:SPECtrogram:HUE Syntax :DI SPlay:VI EW:SPECtrogram:HUE < real> :DI SPlay:VI EW:SPECtrogram:HUE? Description Sets the reference hue. Queries the reference hue. Parameter Name Type Range Default < real> Consecutive Real Number 0 to 359.9 Remarks The reference hue indicates the hue value at the top of the color bar in the spectrogram.
Page 78: Di Splay:vi Ew:spectrogram:reference
RIGOL Chapter 2 Command System The following query returns 146. :DI SPlay:VI EW:SPECtrogram:POSition? :DI SPlay:VI EW:SPECtrogram:REFerence Syntax :DI SPlay:VI EW:SPECtrogram:REFerence < integer> :DI SPlay:VI EW:SPECtrogram:REFerence? Description Sets the position of the reference hue displayed in the graticule. Queries the position of the reference hue displayed in the graticule.
Page 79: Di Splay:vi Ew:spectrogram:trace:selection
Chapter 2 Command System RIGOL Example The following command enables coupling the marker to the trace. :DI SPlay:VI EW:SPECtrogram:TRACe:COUPle ON or : DI SPlay:VI EW:SPECtrogram: TRACe:COUPle 1 The following query returns 1. :DI SPlay:VI EW:SPECtrogram:TRACe:COUPle? :DI SPlay:VI EW:SPECtrogram:TRACe:SELection Syntax :DI SPlay:VI EW:SPECtrogram:TRACe: SELection TI ME| TNUMber...
Page 80: Di Splay:wi Ndow:select
RIGOL Chapter 2 Command System :DI SPlay:WI NDow :SELect Syntax :DI SPlay:WI NDow:SELect SPECtrum| PVT :DI SPlay:WI NDow:SELect? Description Selects a window in the current view. Queries the currently selected window type. Parameter Name Type Range Default —— Keyword SPECtrum| PVT ——...
Page 81: Di Splay:wi Ndow :Trace:y:dli Ne:state
Chapter 2 Command System RIGOL :DI SPlay:WI NDow :TRACe:Y:DLI Ne:STATe Syntax :DI SPlay:WI NDow:TRACe: Y:DLI Ne: STATe OFF| ON| 0| 1 :DI SPlay:WI NDow:TRACe: Y:DLI Ne: STATe? Description Turns on or off the display line. Queries the status of the display line.
Page 82: Di Splay:wi Ndow:trace:y[ :Scale] :Nrposition
RIGOL Chapter 2 Command System :DI SPlay:WI NDow :TRACe:Y[ :SCALe] :NRPosition Syntax :DI SPlay:WI NDow:TRACe:Y[ :SCALe] :NRPosition < integer> :DI SPlay:WI NDow:TRACe:Y[ :SCALe] :NRPosition? Description Sets the reference position of normalization. Queries the reference position of normalization. Parameter Name Type...
Page 83: Di Splay:wi Ndow:trace:y[ :Scale] :Rlevel
Chapter 2 Command System RIGOL :DI SPlay:WI NDow :TRACe:Y[ :SCALe] :RLEVel Syntax :DI SPlay:WI NDow:TRACe:Y[ :SCALe] :RLEVel < ampl> :DI SPlay:WI NDow: TRACe:Y[ :SCALe] :RLEVel? Description Sets the reference level. Queries the reference level. Parameter Name Type Range Default < ampl>...
Page 84: Di Splay:wi Ndow:trace:y[ :Scale] :Spacing
RIGOL Chapter 2 Command System :DI SPlay:WI NDow :TRACe:Y[ :SCALe] :SPACing Syntax :DI SPlay:WI NDow:TRACe:Y[ :SCALe] :SPACing LI Near| LOGarithmic :DI SPlay:WI NDow: TRACe:Y[ :SCALe] :SPACing? Description Sets the Y-axis scale type. Queries the Y-axis scale type. Parameter Name Type...
Page 85: Fetch Commands
:FETCh: SANalyzer< n> ?  :FETCh: TOI ntercept?  :FETCh: TOI ntercept:I P3?  :FETCh:TPOWer? Remarks: The :FETCh commands are only available for the RSA3000 series that has been installed with advanced measurement kit (AMK) option. RSA3000 Programming Guide 2-67 www.valuetronics.com...
Page 86: Fetch:acpower
RIGOL Chapter 2 Command System :FETCh:ACPow er? 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.
Page 87: Fetch:acpower:mai N
Chapter 2 Command System RIGOL :FETCh:ACPow er:MAI N? Syntax :FETCh:ACPower:MAI N? 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.
Page 88: Fetch:cnratio
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.
Page 89: Fetch:cnratio:cnratio
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.
Page 90: Fetch:ebwidth
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.
Page 91: Fetch:harmonics:amplitude? < N
Chapter 2 Command System RIGOL :FETCh:HARMonics:AMPLitude? < n> Syntax :FETCh: HARMonics:AMPLitude? < n> Description Queries the amplitude of the specified harmonic. Parameter Name Type Range Default < n> I nteger 1 to 10 —— Remarks This command is only valid when the harmonic distortion measurement in GPSA mode is enabled.
Page 92: Fetch:harmonics:frequency:all
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.
Page 93: Fetch:harmonics:fundamental
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...
Page 94: Fetch:obwidth:obwidth
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.
Page 95: Fetch:sanalyzer< N
Chapter 2 Command System RIGOL :FETCh:SANalyzer< n> ? Syntax :FETCh: SANalyzer< n> ? Description Queries the measurement results or trace data in the cache area. Parameter Name Type Range Default < n> Discrete 1| 2| 3| 4| 5| 6 ——...
Page 96: Fetch:toi Ntercept:i P3
RIGOL Chapter 2 Command System :FETCh:TOI ntercept:I P3? Syntax :FETCh: TOI ntercept:I P3? 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.
Page 97: Format Commands
Chapter 2 Command System RIGOL :FORMat Commands Command List:  :FORMat:BORDer  :FORMat[ :TRACe] [ : DATA] :FORMat:BORDer Syntax :FORMat:BORDer NORMal| SWAPped :FORMat:BORDer? Description Selects the binary data byte order for data transmission. Queries the binary data byte order for data transmission.
Page 98: Format[ :Trace] [ :Data]
RIGOL Chapter 2 Command System :FORMat[ :TRACe] [ :DATA] Syntax :FORMat[ :TRACe] [ : DATA] ASCii| I NTeger,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.
Page 99: I Eee 488.2 Common Commands
Chapter 2 Command System RIGOL I EEE 488.2 Common Commands I EEE 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 ...
Page 100: Cls
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.
Page 101: Esr
Queries the I D string of the instrument. Return Format The query returns the I D 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...
Page 102: Opc
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.
Page 103: Sav
Chapter 2 Command System RIGOL * SAV Syntax * SAV < integer> Description Saves the current instrument state to the selected register. Parameter Name Type Range Default < integer> I nteger 1 to 16 —— Example The following command saves the current instrument state to Register 1.
Page 104: Stb
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.
Page 105: I Ni Tiate Commands
:I NI Tiate:CONTinuous  :I NI Tiate[ :I MMediate] Remarks: The commands with * are only available for the RSA3000 series that has been installed with advanced measurement kit option. :I NI Tiate:CONTinuous Syntax :I NI Tiate:CONTinuous OFF| ON| 0| 1...
Page 106: I Nstrument Commands
RIGOL Chapter 2 Command System :I NSTrument Commands Command List:  :I NSTrument:COUPle:FREQuency:CENTer  :I NSTrument:DEFault  :I NSTrument:NSELect  :I NSTrument[ :SELect] :I NSTrument:COUPle:FREQuency:CENTer Syntax :I NSTrument:COUPle:FREQuency:CENTer ALL| NONE :I NSTrument:COUPle:FREQuency:CENTer? Description Turns on or off the global center frequency of the instrument.
Page 107: I Nstrument:nselect
Chapter 2 Command System RIGOL :I NSTrument:NSELect :I NSTrument[ :SELect] Syntax :I NSTrument:NSELect 1| 2 :I NSTrument:NSELect? :I NSTrument[ :SELect] SA| RTSA :I NSTrument[ :SELect] ? Description Selects the working mode of the instrument. Queries the working mode of the instrument.
Page 108: Mmemory Commands
RIGOL Chapter 2 Command System :MMEMory Commands Command List:  :MMEMory: DELete  :MMEMory: LOAD:FMT  :MMEMory: LOAD:LI Mit  :MMEMory: LOAD:STATe  :MMEMory: LOAD:TRACe  :MMEMory: LOAD:TRACe:DATA  :MMEMory:MOVE  :MMEMory: STORe:LI Mit  :MMEMory: STORe:MTABle  :MMEMory: STORe:PTABle ...
Page 109: Mmemory:load:fmt
Chapter 2 Command System RIGOL :MMEMory:LOAD:FMT Syntax :MMEMory: LOAD: FMT < label> ,< file_name> Description Loads the edited FMT f ile (.csv). Parameter Name Type Range Default —— < label> Keyword UPPer| LOWer —— —— < file_name> ASCI I String Remarks This operation fails if the specified file does not exist.
Page 110: Mmemory:load:state
RIGOL Chapter 2 Command System :MMEMory:LOAD:STATe Syntax :MMEMory: LOAD: STATe < file_name> Description I mports the specified state file (.sta). Parameter Name Type Range Default < file_name> ASCI I String —— —— Remarks This operation fails if the specified file does not exist.
Page 111: Mmemory:load:trace:data
Chapter 2 Command System RIGOL :MMEMory:LOAD:TRACe:DATA Syntax :MMEMory: LOAD: TRACe: DATA < label> ,< file_name> Description I mports the specif ied measurement data f ile (.csv). Parameter Name Type Range Default < label> Keyword TRACE1| TRACE2| TRACE3| TRACE4| TRACE5| TRACE6 ——...
Page 112: Mmemory:store:li Mit
RIGOL Chapter 2 Command System :MMEMory:STORe:LI Mit Syntax :MMEMory: STORe: LI Mit < label> ,< file_name> 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).
Page 113: Mmemory:store:ptable
Chapter 2 Command System RIGOL :MMEMory:STORe:PTABle Syntax :MMEMory: STORe:PTABle < file_name> Description Saves the peak table with a specified filename suffixed with ".csv" by default (you do not have to add the suffix manually) to the default path (/ "mode name"/ measdata).
Page 114: Mmemory:store:state
RIGOL Chapter 2 Command System Parameter Name Type Range Default < file_name> ASCI I String —— —— Remarks I f the specified file already exists, overwrite it. I f a suff ix (.jpg/ .png/ .bmp) following the f ilename exists, you can save the current screen image with a different format based on its different suff ix.
Page 115: Mmemory:store:trace:data
Chapter 2 Command System RIGOL Remarks I f the specified file already exists, overwrite it. Example The following command saves the current instrument state and Trace 1 with the f ilename "mystate.trs" to the folder (/ gpsa/ tracestate). :MMEMory: STORe:TRACe TRACE1,mystate...
Page 116: Output Commands
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.
Page 117: Read Commands
:READ: SANalyzer< n> ?  :READ: TOI ntercept?  :READ: TOI ntercept:I P3?  :READ: TPOWer? Remarks: The :READ commands are only available for the RSA3000 series that has been installed with advanced measurement kit (AMK) option. RSA3000 Programming Guide 2-99 www.valuetronics.com...
Page 118: Read:acpower
RIGOL Chapter 2 Command System :READ:ACPow er? 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.
Page 119: Read:acpower: Upper
Chapter 2 Command System RIGOL :READ:ACPow er:UPPer? Syntax :READ:ACPower: UPPer? Description Executes one adjacent channel power measurement and returns the upper channel power. Remarks The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer.
Page 120: Read:cnratio:cnratio
RIGOL Chapter 2 Command System :READ:CNRatio:CNRatio? Syntax :READ:CNRatio:CNRatio? Description Executes one C/ N ratio measurement and returns the C/ N ratio. Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer.
Page 121: Read:harmonics:amplitude:all
Chapter 2 Command System RIGOL :READ:HARMonics:AMPLitude:ALL? Syntax :READ:HARMonics:AMPLitude:ALL? Description Executes one harmonic distortion measurement and returns the amplitudes of the first 10 harmonics. Remarks I f the number of harmonics under measurement is less than 10, the harmonics that are not measured do not have return values.
Page 122: Read:harmonics[ :Di Stortion]
RIGOL Chapter 2 Command System :READ:HARMonics[ :DI STortion] ? Syntax :READ:HARMonics[ :DI STortion] ? Description Executes one harmonic distortion measurement and returns the percentage of the total harmonic distortion. Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer.
Page 123: Read:harmonics:fundamental
Chapter 2 Command System RIGOL This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode. Return Format The query returns the frequency of the specified harmonic in scientific notation. The unit is Hz. For example, 4.550000000e+ 07...
Page 124: Read:obwidth:obwidth
RIGOL Chapter 2 Command System :READ:OBWidth:OBWidth? Syntax :READ:OBWidth:OBWidth? Description Executes one occupied bandwidth measurement and returns the occupied bandwidth. Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode.
Page 125: Read:sanalyzer< N
Chapter 2 Command System RIGOL :READ:SANalyzer< n> ? Syntax :READ:SANalyzer< n> ? Description Queries the measurement results or trace data in the buffer. Parameter Name Type Range Default < n> Discrete 1| 2| 3| 4| 5| 6 —— Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer.
Page 126: Read:toi Ntercept:i P3
RIGOL Chapter 2 Command System :READ:TOI ntercept:I P3? Syntax :READ: TOI ntercept:I P3? Description Executes one TOI measurement and returns the value of the intercept of the Third Order Lower or the Third Order Upper, whichever is smaller. Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer.
Page 127: :Sense] Commands
Chapter 2 Command System RIGOL [ :SENSe] Commands Command List:  [ :SENSe] :ACPower:AVERage:COUNt  [ :SENSe] :ACPower:AVERage[ :STATe]  [ :SENSe] :ACPower:AVERage:TCONtrol  [ :SENSe] :ACPower:BANDwidth:ACHannel  [ :SENSe] :ACPower:BANDwidth:I NTegration  [ :SENSe] :ACPower:CSPacing  [ :SENSe] :ACQuisition: TI ME ...
Page 128 RIGOL Chapter 2 Command System  [ :SENSe] : DEMod  [ :SENSe] : DEMod: GAI N:AUTO  [ :SENSe] : DEMod: GAI N:I NCRement  [ :SENSe] : DEMod: STATe  [ :SENSe] : DETector: TRACe: PVTime  [ :SENSe] : DETector[ : FUNCtion] ...
Page 129 [ :SENSe] : TPOWer:LLI Mit*  [ :SENSe] : TPOWer:MODE*  [ :SENSe] : TPOWer:RLI Mit* Remarks: The commands with * are only available for the RSA3000 series that has been installed with advanced measurement kit (AMK) option. RSA3000 Programming Guide 2-111 www.valuetronics.com...
Page 130: :Sense] :Acpower:average:count
RIGOL Chapter 2 Command System [ :SENSe] :ACPow er:AVERage:COUNt Syntax [ :SENSe] :ACPower:AVERage:COUNt < integer> [ :SENSe] :ACPower:AVERage:COUNt? Description Sets the average count of the ACP measurement. Queries the average count of the ACP measurement. Parameter Name Type Range Default <...
Page 131: :Sense] :Acpower:average:tcontrol
Chapter 2 Command System RIGOL [ :SENSe] :ACPow er: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...
Page 132: :Sense] :Acpower:bandwidth:i Ntegration
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] :ACPow er:BANDw idth:I NTegration Syntax [ :SENSe] :ACPower:BANDwidth:I NTegration < freq>...
Page 133: :Sense] :Acquisition:ti Me
Chapter 2 Command System RIGOL Remarks This command is only valid when the adjacent channel power measurement in GPSA mode is enabled. Return Format The query returns the channel spacing in scientific notation. I ts unit is Hz. Example The following command sets the channel spacing to 1 MHz.
Page 134: :Sense] :Acquisition:ti Me:pvtime
RIGOL Chapter 2 Command System Parameter Name Type Range Default —— Bool OFF| ON| 0| 1 ON| 1 Remarks This command is only available for Normal, Density, Spectrogram, and Density Spectrogram in RTSA mode. Return Format The query returns 0 or 1.
Page 135: :Sense] :Acquisition:ti Me:pvtime:auto
Chapter 2 Command System RIGOL [ :SENSe] :ACQuisition:TI ME:PVTime:AUTO Syntax [ :SENSe] :ACQuisition: TI ME:PVTime:AUTO OFF| ON| 0| 1 [ :SENSe] :ACQuisition: TI ME:PVTime:AUTO? Description Enables or disables the auto acquisition time for producing a trace. Queries the status of the auto acquisition time for producing a trace.
Page 136: :Sense] :Average:count:current
RIGOL Chapter 2 Command System The following query returns 100. :SENSe:AVERage:COUNt? :TRACe:AVERage:COUNt? [ :SENSe] :AVERage:COUNt:CURRent? :TRACe:AVERage:COUNt:CURRent? Syntax [ :SENSe] :AVERage:COUNt: CURRent? :TRACe:AVERage:COUNt:CURRent? Description Queries the current average times of the average trace. Return Format The query returns the current trace average count in integer.
Page 137: :Sense] :Average:type:auto
Chapter 2 Command System RIGOL [ :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.
Page 138: [ :Sense] :Bandwidth| Bwi Dth[ :Resolution]
RIGOL Chapter 2 Command System The following query returns 1. :SENSe:BANDwidth:EMI Filter:STATe? :SENSe:BWI Dth:EMI Filter:STATe? [ :SENSe] :BANDw idth| BWI Dth[ :RESolution] Syntax [ :SENSe] :BANDwidth| BWI Dth[ :RESolution] < freq> [ :SENSe] :BANDwidth| BWI Dth[ :RESolution] ? Description Sets the resolution bandwidth (RBW).
Page 139: :Sense] :Bandwidth| Bwi Dth[ :Resolution] :Select
Chapter 2 Command System RIGOL This command is only available for GPSA mode. Return Format The query returns 0 or 1. Example The following command enables the auto setting mode of RBW. :SENSe:BANDwidth:RESolution:AUTO ON or :SENSe:BANDwidth:RESolution:AUTO 1 :SENSe:BWI Dth:RESolution:AUTO ON or :SENSe:BWI Dth:RESolution:AUTO 1 The following query returns 1.
Page 140: [ :Sense] :Bandwidth| Bwi Dth[ :Resolution] :Select:auto[ :State]
RIGOL Chapter 2 Command System [ :SENSe] :BANDw idth| BWI Dth[ :RESolution] :SELect:AUTO[ :STATe] Syntax [ :SENSe] :BANDwidth| BWI Dth[ :RESolution] :SELect:AUTO[ :STATe] OFF| ON| 0| 1 [ :SENSe] :BANDwidth| BWI Dth[ :RESolution] :SELect:AUTO[ :STATe] ? Description Enables or disables the auto setting mode of RBW.
Page 141: :Sense] :Bandwidth| Bwi Dth:vi Deo
Chapter 2 Command System RIGOL :SENSe:BANDwidth: SHAPe GAUSsian :SENSe:BWI Dth:SHAPe GAUSsian The following query returns GAUS. :SENSe:BANDwidth: SHAPe? :SENSe:BWI Dth:SHAPe GAUSsian [ :SENSe] :BANDw idth| BWI Dth:VI Deo Syntax [ :SENSe] :BANDwidth| BWI Dth:VI Deo < freq> [ :SENSe] :BANDwidth| BWI Dth:VI Deo? Description Sets the video bandwidth (VBW).
Page 142: :Sense] :Bandwidth| Bwi Dth:vi Deo:ratio
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:VI Deo: AUTO ON or : SENSe:BANDwidth:VI Deo:AUTO 1 :SENSe:BWI Dth:VI Deo:AUTO ON or : SENSe:BWI Dth:VI Deo:AUTO 1 The following query returns 1.
Page 143: :Sense] :Bandwidth| Bwi Dth:vi Deo:ratio:auto
Chapter 2 Command System RIGOL [ :SENSe] :BANDw idth| BWI Dth:VI Deo:RATio:AUTO Syntax [ :SENSe] :BANDwidth| BWI Dth:VI Deo:RATio:AUTO OFF| ON| 0| 1 [ :SENSe] :BANDwidth| BWI Dth:VI Deo:RATio:AUTO? Description Enables or disables the auto setting mode of V/ R ratio.
Page 144: [ :Sense] :Cnratio:average[ :State]
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.
Page 145: :Sense] :Cnratio:bandwidth:i Ntegration
Chapter 2 Command System RIGOL 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.
Page 146: :Sense] :Cnratio:offset
RIGOL Chapter 2 Command System Parameter [ 1] Name Type Range Default < freq> Consecutive Real Number 33 Hz to 1.5 GHz 2 MHz [ 1] Note I f option RSA3000-BW1 is installed, the available range is from 3 Hz to 1.5 GHz.
Page 147: I Nput:i Mpedance
Chapter 2 Command System RIGOL :I NPut:I MPedance [ :SENSe] :CORRection:I MPedance[ :I NPut] [ :MAGNitude] Syntax :I NPut:I MPedance 50| 75 :I NPut:I MPedance? [ :SENSe] :CORRection:I MPedance[ :I NPut] [ :MAGNitude] 50| 75 [ :SENSe] :CORRection:I MPedance[ :I NPut] [ :MAGNitude] ? Description power conversion.
Page 148: :Sense] :Demod
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 Range Default —— Keyword...
Page 149: :Sense] :Demod:gai N:i Ncrement
Chapter 2 Command System RIGOL Example The following command enables the auto setting mode of signal gain. :SENSe: DEMod: GAI N:AUTO ON or : SENSe: DEMod: GAI N:AUTO 1 The following query returns 1. :SENSe: DEMod: GAI N:AUTO? [ :SENSe] :DEMod:GAI N:I NCRement Syntax [ :SENSe] : DEMod: GAI N:I NCRement <...
Page 150: :Sense] :Detector:trace:pvtime
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...
Page 151: [ :Sense] :Detector[ :Function]
Chapter 2 Command System RIGOL [ :SENSe] :DETector[ :FUNCtion] [ :SENSe] :DETector:TRACe< n> Syntax （） [ :SENSe] : DETector[ : FUNCtion] AVERage VAVerage | NEGative| NORMal| POSitive| SAMPle| QPEak| RAVerage （） [ :SENSe] : DETector[ : FUNCtion] ? （...
Page 152: :Sense] :Detector:trace< N> :Auto
RIGOL Chapter 2 Command System [ :SENSe] :DETector:TRACe< n> :AUTO Syntax [ :SENSe] : DETector: TRACe< n> :AUTO OFF| ON| 0| 1 [ :SENSe] : DETector: TRACe< n> :AUTO? Description Enables or disables the Detector Auto function for the specified trace.
Page 153: [ :Sense] :Ebwidth:average[ :State]
Chapter 2 Command System RIGOL [ :SENSe] :EBWidth:AVERage[ :STATe] Syntax [ :SENSe] :EBWidth:AVERage[ :STATe] OFF| ON| 0| 1 [ :SENSe] :EBWidth:AVERage[ :STATe] ? Description Enables or disables the average measurement function of the emission bandwidth measurement. Queries the status of the average measurement function of the emission bandwidth measurement.
Page 154: :Sense] :Ebwidth:frequency:span
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 < freq> [ :SENSe] :EBWidth:FREQuency:SPAN? Description Sets the span of the emission bandwidth measurement.
Page 155: :Sense] :Ebwidth:xdb
Chapter 2 Command System RIGOL When Max Hold is enabled, each measurement result is compared with the previous result, and then display whichever is the maximum. When Max Hold is disabled, the current measurement result is displayed. Max Hold and average measurement are mutually exclusive. When Max Hold is enabled, the average measurement will be automatically disabled.
Page 156: :Sense] :Frequency:center
RIGOL Chapter 2 Command System [ :SENSe] :FREQuency:CENTer Syntax [ :SENSe] :FREQuency:CENTer < freq> [ :SENSe] :FREQuency:CENTer? Description Sets the center frequency. Queries the center frequency. Parameter Name Type Range Default [ 1] 0 Hz to Fmax (zero span) GPSA mode...
Page 157: [ :Sense] :Frequency:center:step[ :I Ncrement]
Chapter 2 Command System RIGOL [ :SENSe] :FREQuency:CENTer:STEP[ :I NCRement] Syntax [ :SENSe] :FREQuency:CENTer:STEP[ :I NCRement] < freq> [ :SENSe] :FREQuency:CENTer:STEP[ :I NCRement] ? Description Sets the CF step. Queries the CF step. Parameter Name Type Range Default < freq>...
Page 158: :Sense] :Frequency:span
RIGOL Chapter 2 Command System [ :SENSe] :FREQuency:SPAN Syntax [ :SENSe] :FREQuency:SPAN < freq> [ :SENSe] :FREQuency:SPAN? Description Sets the span. Queries the span. Parameter Name Type Range Default [ 1] ， GPSA mode : 0 Hz 100 Hz to Fmax...
Page 159: :Sense] :Frequency: Span:bandwidth[ :Resolution] :Ratio:auto
Chapter 2 Command System RIGOL Example The following command sets the span/ RBW ratio to 100. :SENSe: FREQuency: SPAN:BANDwidth:RESolution:RATio 100 The following query returns 100. :SENSe: FREQuency: SPAN:BANDwidth:RESolution:RATio? [ :SENSe] :FREQuency:SPAN:BANDw idth[ :RESolution] :RATio:AUTO Syntax [ :SENSe] :FREQuency: SPAN:BANDwidth[ :RESolution] :RATio:AUTO OFF| ON| 0| 1...
Page 160: :Sense] :Frequency:span:zero
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 < freq> [ :SENSe] :FREQuency:STARt? Description Sets the start frequency.
Page 161: :Sense] :Frequency:stop
Chapter 2 Command System RIGOL [ :SENSe] :FREQuency:STOP Syntax [ :SENSe] :FREQuency:STOP < freq> [ :SENSe] :FREQuency:STOP? Description Sets the stop frequency. Queries the stop frequency. Parameter [ 1] Name Type Range Default 0 Hz to Fmax (zero span) GPSA mode...
Page 162: [ :Sense] :Hdi St:average[ :State]
RIGOL Chapter 2 Command System Parameter Name Type Range Default < integer> I nteger 1 to 1,000 Remarks This command is only valid when the harmonic distortion measurement in GPSA mode is enabled. Return Format The query returns the average count in integer.
Page 163: :Sense] :Hdi St:average:tcontrol
Chapter 2 Command System RIGOL [ :SENSe] :HDI St:AVERage:TCONtrol Syntax [ :SENSe] :HDI St:AVERage:TCONtrol EXPonential| REPeat [ :SENSe] :HDI St:AVERage:TCONtrol? Description Sets the average mode of the harmonic distortion measurement. Queries the average mode of the harmonic distortion measurement. Parameter...
Page 164: :Sense] :Hdi St:ti Me
RIGOL Chapter 2 Command System Example The following command sets the number of harmonics to 5. :SENSe:HDI St:NUMBers 5 The following query returns 5. :SENSe:HDI St:NUMBers? [ :SENSe] :HDI St:TI ME Syntax [ :SENSe] :HDI St:TI ME < time> [ :SENSe] :HDI St:TI ME? Description Sets the sweep time of the harmonic distortion measurement.
Page 165: [ :Sense] :Mchpower:average[ :State]
Chapter 2 Command System RIGOL Return Format The query returns the average count in integer. Example The following command sets the average count to 100. :SENSe:MCHPower:AVERage:COUNt 100 The following query returns 100. :SENSe:MCHPower:AVERage:COUNt? [ :SENSe] :MCHPow er:AVERage[ :STATe] Syntax [ :SENSe] :MCHPower:AVERage[ :STATe] OFF| ON| 0| 1...
Page 166: :Sense] :Obwidth:average:count
RIGOL Chapter 2 Command System Remarks EXPonential: indicates the exponential average. REPeat: indicates the repeat average. When "EXPonential" is selected, the result is the exponential average of the measurement results obtained in the past N times (N is specified in [ :SENSe] : MCHPower:AVERage:COUNt).
Page 167: :Sense] :Obwidth:average:tcontrol
Chapter 2 Command System RIGOL Description Enables or disables the average measurement function of the occupied bandwidth measurement. Queries the status of the average measurement function of the occupied bandwidth measurement. Parameter Name Type Range Default —— Bool OFF| ON| 0| 1...
Page 168: :Sense] :Obwidth:frequency:span
RIGOL Chapter 2 Command System [ :SENSe] :OBWidth:FREQuency:SPAN Syntax [ :SENSe] :OBWidth: FREQuency:SPAN < freq> [ :SENSe] :OBWidth: FREQuency:SPAN? Description Sets the span of the occupied bandwidth measurement. Queries the span of the occupied bandwidth measurement. Parameter [ 1] Name...
Page 169: :Sense] :Obwidth:percent
Chapter 2 Command System RIGOL Example The following command enables the Max Hold. :SENSe:OBWidth: MAXHold: STATe ON or : SENSe:OBWidth:MAXHold:STATe 1 The following query returns 1. :SENSe:OBWidth:MAXHold: STATe? [ :SENSe] :OBWidth:PERCent Syntax [ :SENSe] :OBWidth:PERCent < real> [ :SENSe] :OBWidth:PERCent? Description Sets the percentage the signal power takes up in the whole span power (power ratio).
Page 170: :Sense] :Power[ :Rf] :Attenuation:auto
RIGOL Chapter 2 Command System Example The following command sets the attenuation to 20 dB. :SENSe:POWer:RF:ATTenuation 20 The following query returns 20. :SENSe:POWer:RF:ATTenuation? [ :SENSe] :POWer[ :RF] :ATTenuation:AUTO Syntax [ :SENSe] :POWer[ :RF] :ATTenuation:AUTO OFF| ON| 0| 1 [ :SENSe] :POWer[ :RF] :ATTenuation:AUTO? Description Enables or disables the auto setting mode of the input attenuation.
Page 171: [ :Sense] :Power[ :Rf] :Mi Xer:range[ :Upper]
Chapter 2 Command System RIGOL [ :SENSe] :POWer[ :RF] :MI Xer:RANGe[ :UPPer] Syntax [ :SENSe] :POWer[ :RF] :MI Xer:RANGe[ :UPPer] < ampl> [ :SENSe] :POWer[ :RF] :MI Xer:RANGe[ :UPPer] ? Description Sets the maximum power of the input mixer. Queries the maximum power of the input mixer.
Page 172: :Sense] :Si Gcapture:2Fsk:ampup
RIGOL Chapter 2 Command System [ :SENSe] :SI GCapture:2FSK:AMPUp Syntax [ :SENSe] :SI GCapture: 2FSK:AMPUp < ample> [ :SENSe] :SI GCapture: 2FSK:AMPUp? Description Sets the upper limit of the amplitude of 2FSK signal. Queries the upper limit of the amplitude of 2FSK signal.
Page 173: [ :Sense] :Si Gcapture:2Fsk:mark1:Switch[ :State]
Chapter 2 Command System RIGOL [ :SENSe] :SI GCapture:2FSK:MARK1:SWitch[ :STATe] Syntax [ :SENSe] :SI GCapture: 2FSK:MARK1: SWitch[ : STATe] OFF| ON| 0| 1 [ :SENSe] :SI GCapture: 2FSK:MARK1: SWitch[ : STATe] ? Description Enables or disables Mark 1. Queries the on/ off status of Marker 1.
Page 174: [ :Sense] :Si Gcapture:2Fsk:mark2:Switch[ :State]
RIGOL Chapter 2 Command System [ :SENSe] :SI GCapture:2FSK:MARK2:SWitch[ :STATe] Syntax [ :SENSe] :SI GCapture: 2FSK:MARK2: SWitch[ : STATe] OFF| ON| 0| 1 [ :SENSe] :SI GCapture: 2FSK:MARK2: SWitch[ : STATe] ? Description Enables or disables Mark 2. Queries the on/ off status of Marker 2.
Page 175: :Sense] :Si Gcapture:2Fsk:peakamp
Chapter 2 Command System RIGOL [ :SENSe] :SI GCapture:2FSK:PEAKAmp? Syntax [ :SENSe] :SI GCapture: 2FSK:PEAKAmp? < peaknum> Description Queries the amplitude of the nth peak in the SSC measurement results. Parameter Name Type Range Default < peaknum> I nteger 1 to 6 Remarks This command is only available for RTSA mode and valid when the SSC function is enabled.
Page 176: :Sense] :Si Gcapture:2Fsk:pf
RIGOL Chapter 2 Command System [ :SENSe] :SI GCapture:2FSK:PF? Syntax [ :SENSe] :SI GCapture: 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.
Page 177: :Sense] :Si Gcapture:2Fsk:reset
Chapter 2 Command System RIGOL [ :SENSe] :SI GCapture:2FSK:RESet Syntax [ :SENSe] :SI GCapture: 2FSK:RESet Description Performs the reset operation, deletes the original signal, and restarts to capture the signal. Remarks This command is only available for RTSA mode and valid when the SSC function is enabled.
Page 178: :Sense] :Sweep:poi Nts
RIGOL Chapter 2 Command System [ :SENSe] :SWEep:POI Nts Syntax [ :SENSe] :SWEep:POI Nts < integer> [ :SENSe] :SWEep:POI Nts? Description Sets the number of sweep points. Queries the number of sweep points. Parameter Name Type Range Default < integer>...
Page 179: :Sense] :Sweep:ti Me:auto
Chapter 2 Command System RIGOL [ :SENSe] :SWEep:TI ME:AUTO Syntax [ :SENSe] :SWEep:TI ME:AUTO OFF| ON| 0| 1 [ :SENSe] :SWEep:TI ME:AUTO? Description Enables or disables auto sweep time. Queries the status of the auto sweep time. Parameter Name Type...
Page 180: :Sense] :Toi :Average:count
RIGOL Chapter 2 Command System [ :SENSe] :TOI :AVERage:COUNt Syntax [ :SENSe] : TOI :AVERage:COUNt < integer> [ :SENSe] : TOI :AVERage:COUNt? Description Sets the average count of the TOI measurement. Queries the average count of the TOI measurement. Parameter...
Page 181: :Sense] :Toi :Average:tcontrol
Chapter 2 Command System RIGOL [ :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...
Page 182: :Sense] :Tpower:average:count
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 < integer>...
Page 183: :Sense] :Tpower:average:tcontrol
Chapter 2 Command System RIGOL 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...
Page 184: :Sense] :Tpower:mode
RIGOL Chapter 2 Command System Parameter Name Type Range Default μ μs < time> Consecutive Real Number s to (current value of stop line) Remarks This command is only valid when the T-power measurement in GPSA mode is enabled. Return Format The query returns the start line in scientific notation.
Page 185: :Sense] :Tpower:rli Mit
Chapter 2 Command System RIGOL [ :SENSe] :TPOWer:RLI Mit Syntax [ :SENSe] : TPOWer:RLI Mit < time> [ :SENSe] : TPOWer:RLI Mit? Description Sets the stop line for the T-power measurement. Queries the stop line for the T-power measurement. Parameter...
Page 186: Source Commands
RIGOL Chapter 2 Command System :SOURce Commands Command List:  :SOURce:CORRection:OFFSet  :SOURce[ :EXTernal] :POWer[ :LEVel] [ :I MMediate] [ :AMPLitude]  :SOURce: TRACe:REFerence:STATe  :SOURce: TRACe:STORref Remarks: The :SOURce commands are only available for RSA3045-TG/ RSA3030-TG working in GPSA mode.
Page 187: Source:trace:reference:state
Chapter 2 Command System RIGOL 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:I MMediate:AMPLitude -10 The following query returns -1.000000000e+ 01. :SOURce:EXTernal:POWer: LEVel:I MMediate:AMPLitude?
Page 188: Status Commands
RIGOL Chapter 2 Command System :STATus Commands The :STATus commands and I EEE 488.2 Common Commands are used to operate or query the status registers. The structure of the status register is shown in the following f igure. The STATus commands are used to set and query the questionable status register and operation status register.
Page 189: Status:operation:condition
Chapter 2 Command System RIGOL :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.
Page 190: Status:operation[ :Event]
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.
Page 191: Status:questionable[ :Event]
Chapter 2 Command System RIGOL Parameter Name Type Range Default " " < integer> I nteger Refer to Remarks Remarks The following table lists the bit definitions for the questionable status register. The bit 0 to bit 8, bit 13 and bit 14 are reserved;...
Page 192: System Commands
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] : I P:ADDRess  :SYSTem:COMMunicate:LAN[ :SELF] : I P:DNS:AUTO[ : STATe]  :SYSTem:COMMunicate:LAN[ :SELF] : I P:DNSBack ...
Page 193: System:beeper:state
Chapter 2 Command System RIGOL :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 Range Default —— Bool OFF| ON| 0| 1 OFF| 0 Return Format The query returns 0 or 1.
Page 194: System:communicate:lan[ :Self] :Dhcp:state
RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the auto I P 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...
Page 195 Chapter 2 Command System RIGOL 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.
Page 196: System:communicate:lan[ :Self] :I P:dnsback
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN[ :SELF] :I P:DNSBack Syntax :SYSTem:COMMunicate: LAN[ :SELF] : I P:DNSBack < ip_address> :SYSTem:COMMunicate: LAN[ :SELF] : I P:DNSBack? Description Sets the backup address for the DNS. Queries the backup address for the DNS. Parameter...
Page 197: System:communicate:lan[ :Self] :I P:gatew Ay
Chapter 2 Command System RIGOL Example The following command sets the preferred DNS address to "172.16.2.2". :SYSTem:COMMunicate:LAN: SELF: I P:DNSPreferred 172.16.2.2 :SYSTem:COMMunicate:LAN: SELF: I P:DNSServer 172.16.2.2 The following query returns 172.16.2.2. :SYSTem:COMMunicate:LAN: SELF: I P:DNSPreferredr? :SYSTem:COMMunicate:LAN: SELF: I P:DNSServer? :SYSTem:COMMunicate:LAN[ :SELF] :I P:GATew ay Syntax :SYSTem:COMMunicate:LAN[ :SELF] : I P: GATeway <...
Page 198: System:communicate:lan[ :Self] :Manuip:state
RIGOL Chapter 2 Command System Remarks The format of < ip_address> is "nnn.nnn.nnn.nnn". The range for the first segment (nnn) is from 0 to 255. This command is only valid in manual I P setting mode. Return Format The query returns the current subnet mask in the format of "nnn.nnn.nnn.nnn".
Page 199: System:communicate:lan[ :Self] :Mdns:state
Chapter 2 Command System RIGOL :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.
Page 200: System:date
RIGOL Chapter 2 Command System Main Board: 00.01.00 Keyboard:00.01.00 CPU: 00.01.00 SPU: 00.01.02 WPU: 00.01.00 BOOT:00.01.00 OS:00.01.00 Firmware:00.01.00 Note: When you use RSA3045-TG/ RSA3030-TG, the query also returns information about "TG Board". :SYSTem:DATE Syntax :SYSTem: DATE < year> ,< month> ,< day>...
Page 201: System:language
Chapter 2 Command System RIGOL Return Format The query returns 0 or 1. Example The following command sets the power switch on the front panel is turned off. :SYSTem:FSWitch: STATe OFF or :SYSTem: FSWitch:STATe 0 The following query returns 0.
Page 202: System:option:state
RIGOL Chapter 2 Command System Example The following command installs the option RSA3000-PA. :SYSTem:LKEY RSA3000-PA@8AD12B8EBC5DF492D1D4289B7CBA5B6150BF6F5D752D645C36D74530B05F39B49C461B2 3A50D6C94A34E06782AC4380070B0D1A86BA84E02768391FFD70C2103 :SYSTem:OPTion:STATe? Syntax :SYSTem:OPTion: STATe? < option name> Description Queries whether an option is activated or not. Parameter Name Type Range Default < option name>...
Page 203: System:preset
Chapter 2 Command System RIGOL :SYSTem:PRESet Syntax :SYSTem:PRESet Description Recalls the system's preset settings, and recovers the system to the state specified by :SYSTem:PRESet:TYPE command. :SYSTem:PRESet:SAVE Syntax :SYSTem:PRESet: SAVE USER1| USER2| USER3| USER4| USER5| USER6 Description Saves the specif ied user setting.
Page 204: System:preset:user:save
RIGOL Chapter 2 Command System :SYSTem:PRESet:USER:SAVE Syntax :SYSTem:PRESet: USER: SAVE Description Saves the current user setting. Remarks I f the current preset type is "FACTory", save the current user setting to User1. I f the current preset type is "User1 through User6", save the current user setting to the specif ied user.
Page 205: System:ti Me
Chapter 2 Command System RIGOL Parameter Name Type Range Default —— Keyword OFF| SYSTem| OPTion| LI Cense Remarks OFF: turns off the system information display. SYSTem: displays the system information. OPTion: displays the option information. LI Cense: displays the registration information.
Page 206: Trace Commands
RIGOL Chapter 2 Command System :TRACe Commands Command List:  :TRACe:CLEar:ALL  :TRACe[ : DATA]  :TRACe:MATH:A  :TRACe:MATH:B  :TRACe:MATH:CONSt  :TRACe:MATH:PEAK[ :DATA] ?  :TRACe:MATH:PEAK:POI Nts?  :TRACe:MATH:REFerence  :TRACe:MATH: STATe  :TRACe:MATH: TYPE  :TRACe:PRESet:ALL  :TRACe< n> :DI SPlay: STATe ...
Page 207 Chapter 2 Command System RIGOL Explanation Use the : FORMat[ :TRACe] [ :DATA] command to set the format of the user data. < comma_separated_ASCI I _data> : [ 1] Data block . Select this parameter when the data format is ASCii. The two neighboring data points are separated by a comma (1 byte) and a space (1 byte) and each point is expressed in scientif ic notation;...
Page 208: Trace:math:a
RIGOL Chapter 2 Command System [ 2] I n the two examples here, 801 points are transmitted and the queries return 801 points. However, due to the limited space, the succeeding data is omitted here. The return values in the above examples are acquired when the trace stops sweeping.
Page 209: Trace:math:const
Chapter 2 Command System RIGOL :TRACe:MATH:CONSt Syntax :TRACe:MATH:CONSt < integer> :TRACe:MATH:CONSt? Description Sets the log offset in the trace math operation formula. Queries the log offset in the trace math operation formula. Parameter Name Type Range Default < integer> Consecutive Real Number...
Page 210: Trace:math:reference
RIGOL Chapter 2 Command System :TRACe:MATH:REFerence Syntax :TRACe:MATH:REFerence < integer> :TRACe:MATH:REFerence? Description Sets the log reference in the trace math operation formula. Queries the log reference in the trace math operation formula. Parameter Name Type Range Default < integer> Consecutive Real Number...
Page 211: Trace:math:type
Chapter 2 Command System RIGOL :TRACe:MATH:TYPE Syntax :TRACe:MATH: TYPE A+ B| A-B| A+ CONST| A-CONST| A-B+ REF :TRACe:MATH:TYPE? Description Sets the operation type of the trace. Queries the operation type of the trace. Paramter Name Type Range Default —— Keyword...
Page 212: Trace< N> :Di Splay:state
RIGOL Chapter 2 Command System :TRACe< n> :DI SPlay:STATe Syntax :TRACe< n> :DI SPlay[ :STATe] OFF| ON| 0| 1 :TRACe< n> :DI SPlay[ :STATe] ? Description Enables or disables the display of the specified trace. Queries the status for the specified trace.
Page 213: Trace< N> :Update:state
Chapter 2 Command System RIGOL Return Format The query returns WRI T, AVER, MAXH, or MI NH. Example The following command sets the type of Trace 1 to Max Hold. :TRACe1:MODE MAXHold :TRACe1: TYPE MAXHold The following query returns MAXH.
Page 214: Tri Gger Commands
RIGOL Chapter 2 Command System :TRI Gger Commands Command List:  :TRI Gger[ :SEQuence] :ATRigger  :TRI Gger[ :SEQuence] :ATRigger:STATe  :TRI Gger[ :SEQuence] :EXTernal< n> : DELay  :TRI Gger[ :SEQuence] :EXTernal< n> : DELay: STATe  :TRI Gger[ :SEQuence] :EXTernal< n> : SLOPe ...
Page 215: Tri Gger[ :Sequence] :Atrigger
Chapter 2 Command System RIGOL :TRI Gger[ :SEQuence] :ATRigger Syntax :TRI Gger[ :SEQuence] :ATRigger < time> :TRI Gger[ :SEQuence] :ATRigger? Description Sets the time that the analyzer will wait for the trigger to be initiated automatically. Queries the time that the analyzer will wait for the trigger to be initiated automatically.
Page 216: Tri Gger[ :Sequence] :External< N> :Delay
RIGOL Chapter 2 Command System :TRI Gger[ :SEQuence] :EXTernal< n> :DELay Syntax :TRI Gger[ :SEQuence] :EXTernal< n> : DELay < time> :TRI Gger[ :SEQuence] :EXTernal< n> : DELay? Description Sets the delay time for the external trigger. Queries the delay time for the external trigger.
Page 217: Tri Gger[ :Sequence] :External< N> :Slope
Chapter 2 Command System RIGOL :TRI Gger:SEQuence:EXTernal1:DELay:STATe ON or : TRI Gger: SEQuence:EXTernal1:DELay: STATe 1 The following query returns 1. :TRI Gger:SEQuence:EXTernal1:DELay:STATe? :TRI Gger[ :SEQuence] :EXTernal< n> :SLOPe Syntax :TRI Gger:SEQuence:EXTernal< n> :SLOPe POSitive| NEGative :TRI Gger:SEQuence:EXTernal< n> : SLOPe? Description Sets the trigger edge for the external trigger.
Page 218: Tri Gger[ :Sequence] :Fmt:cri Teria
RIGOL Chapter 2 Command System "Outside", the maximum value of the parameter < number> is 1. I n the Spectrogram measurement mode, the maximum value of the parameter < number> is 10,000. I n the PvT measurement mode, the maximum value of the parameter <...
Page 219: Tri Gger[ :Sequence] :Fmt:delay
Chapter 2 Command System RIGOL :TRI Gger[ :SEQuence] :FMT:DELay Syntax :TRI Gger[ :SEQuence] :FMT: DELay < time> :TRI Gger[ :SEQuence] :FMT: DELay? Description Sets the delay time for FMT. Queries the delay time for FMT. Parameter Name Type Range Default μ...
Page 220: Tri Gger[ :Sequence] :Fmt:mask
RIGOL Chapter 2 Command System :TRI Gger[ :SEQuence] :FMT:MASK Syntax :TRI Gger[ :SEQuence] :FMT: MASK UPPer| LOWer| BOTH :TRI Gger[ :SEQuence] :FMT: MASK? Description Sets the mask to be used for the current trigger. Queries the mask to be used for the current trigger.
Page 221: Tri Gger[ :Sequence] :Fmt: Mask:relative:amplitude
Chapter 2 Command System RIGOL :TRI Gger[ :SEQuence] :FMT:MASK:RELative:AMPLitude Syntax :TRI Gger[ :SEQuence] :FMT: MASK:RELative:AMPLitude ON| OFF| 1| 0 :TRI Gger[ :SEQuence] :FMT: MASK:RELative:AMPLitude? Description Sets whether the amplitudes of the mask points are coupled to the reference level of the instrument.
Page 222: Tri Gger[ :Sequence] :Fmt:mask< N> :Bui Ld
RIGOL Chapter 2 Command System ON| 1: enables the coupling function. That is, when "Relative" is selected under X Axis Type , the frequency of the current mask point is the difference between the point and the current center frequency.
Page 223: Tri Gger[ :Sequence] :Fmt:mask< N> :Delete
Chapter 2 Command System RIGOL Parameter Name Type Range Default < n> Discrete 1| 2 —— < freq> Consecutive Real Number 0 Hz to 4.5 GHz < ampl> Consecutive Real Number -1,000 dBm to 1,000 dBm 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.
Page 224: Tri Gger[ :Sequence] :Holdoff
RIGOL Chapter 2 Command System the lower mask is being edited. This command is only valid when you select FMT to be the trigger source in RTSA working mode. :TRI Gger[ :SEQuence] :HOLDoff Syntax :TRI Gger[ :SEQuence] :HOLDoff < time>...
Page 225: Tri Gger[ :Sequence] :Source
Chapter 2 Command System RIGOL The following query returns 1. :TRI Gger:SEQuence:HOLDoff: STATe? :TRI Gger[ :SEQuence] :SOURce Syntax :TRI Gger[ :SEQuence] :SOURce EXTernal1| EXTernal2| I MMediate| VI Deo| FMT| POWer :TRI Gger[ :SEQuence] :SOURce? Description Sets the trigger source. Queries the trigger source.
Page 226: Tri Gger[ :Sequence] :Vi Deo:delay:state
RIGOL Chapter 2 Command System Return Format The query returns the delay time for video trigger in scientif ic notation. The unit is s. Example The following command sets the delay time for the video trigger to 100 ms. :TRI Gger:SEQuence:VI Deo: DELay 0.1 The following query returns 1.000000e-01.
Page 227: Tri Gger[ :Sequence] :Vi Deo:slope
Chapter 2 Command System RIGOL Remarks This command is only valid when the following conditions are met: in GPSA mode; selecting the video trigger. Return Format The query returns the trigger level in scientific notation. Example The following command sets the trigger level of the video trigger to 10 dBm.
Page 228: Tri Gger2:Mode
RIGOL Chapter 2 Command System :TRI Gger2:MODE Syntax :TRI Gger2: MODE I N| OUT| 0| 1 :TRI Gger2: MODE? Description Sets the interface type of External Trigger 2. Queries the interface type of External Trigger 2. Parameter Name Type Range Default ——...
Page 229: Uni T Command
Chapter 2 Command System RIGOL :UNI T Command Command List:  :UNI T:POWer :UNI T:POWer Syntax :UNI T:POWer DBM| DBMV| DBUV| V| W :UNI T:POWer? Description Sets the unit of the Y axis. Queries the unit of the Y axis.
Page 230 www.valuetronics.com...
Page 231: Chapter 3 Programming Examples
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 LabVI EW 2010.
Page 232: Programming I Nstructions
RIGOL Chapter 3 Programming Examples Programming I nstructions This section introduces the problems that might occur during the programming process as well as their solutions. I f these problems occur, please resolve them according to the corresponding instructions. When you build a working environment via the network, it is recommended that you build a pure local area network.
Page 233: Visual C+ + 6.0 Programming Example
Chapter 3 Programming Examples RIGOL Visual C+ + 6.0 Programming Example Enter the Visual C+ + 6.0 programming environment, and perform the following procedures. Create a MFC project based on a dialog box and name it "DemoForRSA" in this example.
Page 234 RIGOL Chapter 3 Programming Examples By now, VI SA library has been added. Add the Text, Edit, and Button controls, as shown in the f igure below. Add the control variables. View  ClassWizard Click , and then click the...
Page 235 Chapter 3 Programming Examples RIGOL / / Change the address's data style from CString to char* SendAddr = strAddr.GetBuffer(strAddr.GetLength()); strcpy(SendAddr,strAddr); strAddr.ReleaseBuffer(); / / Change the command's data style from CString to char* SendBuf = strContent.GetBuffer(strContent.GetLength()); strcpy(SendBuf,strContent); strContent.ReleaseBuffer(); / / Open a VI SA resource status = viOpenDefaultRM(&defaultRM);...
Page 236 RIGOL Chapter 3 Programming Examples / / Open the instrument status = viOpen(defaultRM, SendAddr, VI _NULL, VI _NULL, &instr); / / Read from the instrument status = viRead(instr, RecBuf, MAX_REC_SI ZE, &retCount); / / Close the system status = viClose(instr);...
Page 237 Chapter 3 Programming Examples RIGOL return status; bool CDemoForRSADlg::I nstrWriteEx(CString strAddr, CString strContent) / / Write operation with exception handling ViStatus status; ViUI nt32 retCount; char * SendBuf = NULL; bool bWriteOK = true; / / Change the address's data style from CString to char* SendBuf = strContent.GetBuffer(strContent.GetLength());...
Page 238 RIGOL Chapter 3 Programming Examples unsigned char RecBuf[ MAX_REC_SI ZE] ; bool bReadOK = true; / / Change the address's data style from CString to char* SendAddr = strAddr.GetBuffer(strAddr.GetLength()); strcpy(SendAddr,strAddr); strAddr.ReleaseBuffer(); memset(RecBuf,0,MAX_REC_SI ZE); / / Read from the instrument status = viRead(m_SessI nstr, RecBuf, MAX_REC_SI ZE, &retCount);...
Page 239 Chapter 3 Programming Examples RIGOL bool bFindRSA = false; status = viOpenDefaultRM(&defaultRM); if (status < VI _SUCCESS) / / Error I nitializing VI SA...exiting MessageBox("No VI SA instrument was opened ! "); return ; memset(instrDesc,0,1000); / / Find resource status = viFindRsrc(defaultRM,expr,f indList, retcnt, instrDesc);...
Page 240 RIGOL Chapter 3 Programming Examples void CDemoForRSADlg: :OnBtRead() / / Read operation / / TODO: Add your control notif ication handler code here UpdateData(true); I nstrRead(m_strI nstrAddr,&m_strResult); UpdateData(false); Run the results. Click Connect to search for the spectrum analyzer; I nput "* I DN?" in the "Command" edit box;...
Page 241: Visual Basic 6.0 Programming Example
Chapter 3 Programming Examples RIGOL Visual Basic 6.0 Programming Example Enter the Visual Basic 6.0 programming environment, and perform the following procedures. Build a standard application program project (Standard EXE), and name it "DemoForRSA". Project  Add File… Open . Search for the visa32.bas...
Page 242 RIGOL Chapter 3 Programming Examples Dim rSize As Long 'I nitialize the system status = viOpenDefaultRM(dfltRM) 'Failed to initialize the system I f (status < VI _SUCCESS) Then ！ MsgBox " No VI SA resource was opened " Exit Sub...
Page 243 Chapter 3 Programming Examples RIGOL MsgBox " Failed to open the instrument! " Exit Function End I f 'Read from the instrument stasus = viRead(sesn, strTemp0, 256, rSize) 'Reading failed I f (status < VI _SUCCESS) Then MsgBox " Failed to read from the instrument! "...
Page 244 RIGOL Chapter 3 Programming Examples j = I nStr(strRet, "RSA") I f ( j > = 0) Then bFindRSA = True Exit For End I f Call viFindNext(fList + i - 1, rsrcName(i)) Next i 'Display I f (bFindRSA = True) Then TxtI nsAddr.Text = rsrcName(i)
Page 245: Labvi Ew 2010 Programming Example
Chapter 3 Programming Examples RIGOL LabVI EW 2010 Programming Example Enter the Labview 2010 programming environment, and perform the following procedures. Create a VI f ile, and name it "DemoForRSA". Add controls to the front panel interface, including the Address...
Page 246 RIGOL Chapter 3 Programming Examples Write operation (including error conf irmation) 3-16 RSA3000 Programming Guide www.valuetronics.com...
Page 247 Chapter 3 Programming Examples RIGOL Read operation (including error correction advice) RSA3000 Programming Guide 3-17 www.valuetronics.com...
Page 248 RIGOL Chapter 3 Programming Examples Exit Run the program, and then the following interface is displayed below. Click the VI SA resource name from the drop-down list under Address , and click Connect to connect the instrument. Then, input a command in the Command f ield.
Page 249: Linux Programming Example
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 Programming environment: Operating system: Fedroa 8 (Linux-2.6.23) GCC version: gcc-4.1.2...
Page 250 RIGOL Chapter 3 Programming Examples For example, if the network address and DNS setting conf igured for the PC are as shown in the f igures below, then, the network address of the spectrum analyzer should be conf igured as follows.
Page 251 Chapter 3 Programming Examples 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 f ile automatically. Method 1: Specify the search path of the library in the environment variable LD_LI BRARY_PATH.
Page 252: Linux Programming Procedures
RIGOL Chapter 3 Programming Examples Linux Programming Procedures Edit the DemoForRSA.h header f ile and declare a class to encapsulate the operation and property of the instrument. # ifndef DEMO_FOR_RSA_H # def ine DEMO_FOR_RSA_H # include < stdio.h> # include <...
Page 253 Chapter 3 Programming Examples RIGOL string strI nstr = ""; ViChar instrDesc[ 1000] ; unsigned long i = 0; bool bFindRSA = false; memset(instrDesc,0,1000); / / Turn on the VI SA device status = viOpenDefaultRM(&defaultRM); (status < VI _SUCCESS) cout< <...
Page 254 RIGOL Chapter 3 Programming Examples string str; / / Address conversion, convert the string type to char* SendAddr = const_cast< char* > (strAddr.c_str()); / / Address conversion, convert the string type to char* SendBuf = const_cast< char* > (strContent.c_str()); / / Turn on the specif ied device status = viOpenDefaultRM(&defaultRM);...
Page 255 Chapter 3 Programming Examples RIGOL status = viRead(instr, RecBuf, MAX_REC_SI ZE, &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 = "";...
Page 256 RIGOL Chapter 3 Programming Examples && demo.m_strCommand[ 2] = && demo.m_strCommand[ 3] = 'd') / / demo.I nstrWrite(demo.m_strI nstrAddr,"* I DN?"); / / demo.I nstrRead(demo.m_strI nstrAddr,demo.m_strResult); cout< < "read result:"< < demo.m_strResult< < endl; demo.m_strResult= ""; else if (demo.m_strCommand[ 0] = &&...
Page 257 Chapter 3 Programming Examples RIGOL rm demo $(obj) Run the results. # make ./ demo When the program runs, the instrument is connected automatically. I f no instrument is found, a prompt message "No VI SA equipment!" is displayed, and the system exits the program. I f the instrument is found and successfully connected, the following interface is displayed, as shown in the f igure below.
Page 258 www.valuetronics.com...
Page 259: Chapter 4 Appendix
Chapter 4 Appendix RIGOL Chapter 4 Appendix Appendix A: Default Settings Sending the * RST command can restore the instrument to default settings, as shown in the table below. Parameter Name GPSA Parameter RTSA Parameter Value Value Non- PvT FREQ Center Freq 2.25 GHz...
Page 260 RIGOL Chapter 4 Appendix Trigger Criteria Enter Active Mask Upper Frequency 0 Hz Amplitude -100 dBm Build From Trace Trace1 X Offset 0 Hz Y Offset 0 dB X Axis Type Fixed Y Axis Type Fixed Trace Selected Trace Trace1...
Page 261 Chapter 4 Appendix RIGOL Limit Type Upper X To CF Fixed Y To Ref Fixed Margin Off, 0 dB Test Trace Trace1 Test Limits Limit State [ 2] T- Pow er Avg Number Avg Mode Exponential Avg State TP Type...
Page 262 RIGOL Chapter 4 Appendix [ 2] Avg Number Avg Mode Exponential Avg State TOI Span 2 MHz Measure Setup( RTSA) Normal Avg Number Test Limits Select Limit Limit1 Limit State Test Trace Trace1 Limit Type Upper X to CF Relative...
Page 263 Chapter 4 Appendix RIGOL Couple Markers Marker Table Peak Cont Peak Pk-Pk Search Maximum Value Maximum Value Peak Threshold On, -90 dBm On, -90 dBm Peak Excursion On, 6 dB On, 6 dB Threshold Line Peak Table Peak Table Sort...
Page 264: Appendix B: Warranty
RIGOL Chapter 4 Appendix Appendix B: Warranty TECHNOLOGI ES, I NC. (hereinafter referred to as ) warrants that the product will be free RIGOL RIGOL from defects in materials and workmanship within the warranty period. I f a product proves defective within the warranty period, guarantees free replacement or repair for the defective product.

This manual is also suitable for:

Rsa3045 Rsa3030 Rsa3045-tg Rsa3030-tg

Rigol RSA3000 Series Programming Manual

Quick Links

Need help?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Rigol RSA3000 Series

Summary of Contents for Rigol RSA3000 Series