Rigol RSA5000 Series Programming Manual
  1. Manuals
  2. Brands
  3. Rigol Manuals
  4. Measuring Instruments
  5. RSA5000 Series
  6. Programming manual
Rigol RSA5000 Series Programming Manual

Rigol RSA5000 Series Programming Manual

Real-time spectrum analyzer
Hide thumbs Also See for RSA5000 Series:
Table of Contents

Advertisement

Quick Links

Download this manual
RIGOL
Programming Guide
RSA5000 Series Real- time
Spectrum Analyzer
Jan. 26, 2018
RIGOL TECHNOLOGI ES, I NC.
www.valuetronics.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the RSA5000 Series and is the answer not in the manual?

Questions and answers

Related Manuals for Rigol RSA5000 Series

Summary of Contents for Rigol RSA5000 Series

  • Page 1 RIGOL Programming Guide RSA5000 Series Real- time Spectrum Analyzer Jan. 26, 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 RSA5000 Programming Guide www.valuetronics.com...

  • Page 4: Document Overview

    This chapter introduces the syntax, function, parameters, and usage of each command. Chapter 3 Programming Examples This chapter illustrates how to control the RSA5000 series by programming in the development environments such as Visual C+ + , Visual Basic, and LabVI EW.

  • 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-25 :CALCulate:MARKer< n> : LI Nes[ :STATe] ................2-25 :CALCulate:MARKer< n> : MAXimum: LEFT ................2-26 :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-108 :READ: TOI ntercept:I P3? ....................2-108 :READ: TPOWer? ......................2-109 [ :SENSe] Commands......................2-110 [ :SENSe] :ACPower:AVERage:COUNt ................2-113 [ :SENSe] :ACPower:AVERage[ :STATe] ................2-113 [ :SENSe] :ACPower:AVERage:TCONtrol ................2-114 [ :SENSe] :ACPower:BANDwidth:ACHannel ................ 2-114 [ :SENSe] :ACPower:BANDwidth:I NTegration ..............
  • Page 10 RIGOL Contents [ :SENSe] :FREQuency: SPAN ..................... 2-141 [ :SENSe] :FREQuency: SPAN:BANDwidth[ :RESolution] :RATio ..........2-141 [ :SENSe] :FREQuency: SPAN:BANDwidth[ :RESolution] :RATio:AUTO ........2-142 [ :SENSe] :FREQuency: SPAN:FULL ..................2-142 [ :SENSe] :FREQuency: SPAN:PREVious ................2-142 [ :SENSe] :FREQuency: SPAN:ZERO ................... 2-143 [ :SENSe] :FREQuency: STARt ....................
  • Page 11 Contents RIGOL :SOURce: TRACe:STORref ....................2-170 :STATus Commands ......................2-171 :STATus:OPERation:CONDition?..................2-172 :STATus:OPERation:ENABle ..................... 2-172 :STATus:OPERation[ :EVENt] ? ..................2-173 :STATus:PRESet ......................2-173 :STATus:QUEStionable:CONDition? .................. 2-173 :STATus:QUEStionable:ENABle ..................2-174 :STATus:QUEStionable[ :EVENt] ? ..................2-175 :SYSTem Commands ......................2-176 :SYSTem:BEEPer:STATe ....................2-177 :SYSTem:COMMunicate:LAN[ :SELF] :APPLy ..............
  • Page 12 RIGOL Contents :TRI Gger[ :SEQuence] :EXTernal< n> : DELay: STATe ............2-202 :TRI Gger[ :SEQuence] :EXTernal< n> : SLOPe ..............2-203 :TRI Gger[ :SEQuence] :FMT: APTRigger ................2-203 :TRI Gger[ :SEQuence] :FMT: CRI Teria ................2-204 :TRI Gger[ :SEQuence] :FMT: DELay ................... 2-205 :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 RSA5000 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 RSA5000 remotely. Ultra Sigma is RIGOL recommended. You can download the software from off icial website (www.rigol.com). RIGOL RSA5000 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 RSA5000 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: GATetime:AUTO  :CALCulate:MARKer< n> : FCOunt[ : STATe]  :CALCulate:MARKer< n> : FCOunt: X?  :CALCulate:MARKer< n> : FUNCtion  :CALCulate:MARKer< n> : FUNCtion:BAND: LEFT  :CALCulate:MARKer< n> : FUNCtion:BAND:RI GHt ...

  • 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

    RIGOL Chapter 2 Command System :CALCulate:MARKer:PEAK:EXCursion Syntax :CALCulate:MARKer:PEAK:EXCursion < rel_ampl> :CALCulate:MARKer:PEAK:EXCursion? Description Sets the amplitude of the peak. I ts unit is dB. Queries the peak amplitude. Parameter Name Type Range Default < rel_ampl> Consecutive Real Number 0 dB to 100 dB...

  • Page 33: Calculate:marker:peak:search:mode

    Chapter 2 Command System RIGOL :CALCulate:MARKer:PEAK:SEARch:MODE Syntax :CALCulate:MARKer:PEAK:SEARch:MODE PARameter| MAXimum :CALCulate:MARKer:PEAK:SEARch:MODE? Description Sets the peak search mode. Queries the peak search mode. Parameter Name Type Range Default —— Keyword PARameter| MAXimum MAXimum 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.

  • Page 34: Calculate:marker:peak:sort

    RIGOL Chapter 2 Command System :CALCulate:MARKer:PEAK:SORT :TRACe:MATH:PEAK:SORT Syntax :CALCulate:MARKer:PEAK:SORT FREQuency| AMPLitude :CALCulate:MARKer:PEAK:SORT? :TRACe:MATH:PEAK: SORT FREQuency| AMPLitude :TRACe:MATH:PEAK: SORT? Description Sets the sorting order of the data displayed in the peak table. Queries the sorting order of the data displayed in the peak table.

  • Page 35: Calculate:marker:peak:table[ :State]

    Chapter 2 Command System RIGOL Remarks ALL| NORMal: lists all the peaks defined by the peak criteria, and displays data based on the current sorting order in the peak table. GTDLine| DLMore: lists the peaks that are greater than the defined display line and that meet the peak criteria.

  • Page 36: Calculate:marker:peak:threshold

    RIGOL Chapter 2 Command System :CALCulate:MARKer:PEAK:THReshold Syntax :CALCulate:MARKer:PEAK:THReshold < ampl> :CALCulate:MARKer:PEAK: THReshold? Description Sets the peak threshold, and its default unit is dBm. Queries the peak threshold. Parameter Name Type Range Default < ampl> Consecutive Real Number -200 dBm to 0 dBm...

  • Page 37: Calculate:marker:table[ :State]

    Chapter 2 Command System RIGOL :CALCulate:MARKer:TABLe[ :STATe] Syntax :CALCulate:MARKer: TABLe[ :STATe] OFF| ON| 0| 1 :CALCulate:MARKer:TABLe[ :STATe] ? Description Enables or disables the marker table. Queries the status of the marker table. Parameter Name Type Range Default —— Bool OFF| ON| 0| 1...

  • Page 38: Calculate:marker< N> :Cpsearch[ :State]

    RIGOL Chapter 2 Command System :CALCulate:MARKer< n> :CPSearch[ :STATe] Syntax :CALCulate:MARKer< n> :CPSearch[ : STATe] OFF| ON| 0| 1 :CALCulate:MARKer< n> :CPSearch[ : STATe] ? Description Enables or disables continuous peak search function, and marks the peak value with n.

  • Page 39: Calculate:marker< N> :Fcount:gatetime:auto

    Chapter 2 Command System RIGOL :CALCulate:MARKer< n> :FCOunt:GATetime:AUTO Syntax :CALCulate:MARKer< n> : FCOunt: GATetime:AUTO OFF| ON| 0| 1 :CALCulate:MARKer< n> : FCOunt: GATetime:AUTO? Description Turns on or off the auto gate time for Marker n. Queries the status of the auto gate time for Marker n.

  • Page 40: Calculate:marker< N> :Fcount:x

    RIGOL Chapter 2 Command System :CALCulate:MARKer< n> :FCOunt:X? Syntax :CALCulate:MARKer< n> : FCOunt: X? Description Queries the readout of the frequency counter of the specif ied marker. Parameter Name Type Range Default < n> Discrete 1| 2| 3| 4| 5| 6| 7| 8 ——...

  • Page 41: Calculate:marker< N> :Function:band:left

    Chapter 2 Command System RIGOL :CALCulate:MARKer< n> :FUNCtion:BAND:LEFT Syntax :CALCulate:MARKer< n> : FUNCtion:BAND: LEFT < freq> :CALCulate:MARKer< n> : FUNCtion:BAND: LEFT? Description Sets the left edge frequency or time of the signal involved in the calculation for the band function.

  • Page 42: Calculate:marker< N> :Function:band:span

    RIGOL Chapter 2 Command System Return Format The query returns the right edge frequency or time of the signal in scientific notation. Example The following command sets the right edge frequency of the signal involved in the calculation for the Marker 1 band function to 4 GHz.

  • Page 43: Calculate:marker< N> :Function:band:span:auto

    Chapter 2 Command System RIGOL :CALCulate:MARKer< n> :FUNCtion:BAND:SPAN:AUTO Syntax :CALCulate:MARKer< n> : FUNCtion:BAND: SPAN:AUTO OFF| ON| 0| 1 :CALCulate:MARKer< n> : FUNCtion:BAND: SPAN:AUTO? Description Enables or disables the band span auto function. Queries the status of band span auto function.

  • Page 44: Calculate:marker< N> :Maximum:left

    RIGOL Chapter 2 Command System :CALCulate:MARKer1: LI Nes:STATe ON or :CALCulate:MARKer1:LI Nes:STATe 1 The following query returns 1. :CALCulate:MARKer1: LI Nes:STATe? :CALCulate:MARKer< n> :MAXimum:LEFT Syntax :CALCulate:MARKer< n> : MAXimum: LEFT Description Searches for and marks the nearest peak which is located at the left side of the current peak and meets the peak search condition.

  • Page 45: Calculate:marker< N> :Maximum:next

    Chapter 2 Command System RIGOL :CALCulate:MARKer< n> :MAXimum:NEXT Syntax :CALCulate:MARKer< n> : MAXimum: NEXT Description Searches for and marks the peak whose amplitude on the trace is next to that of the current peak and which meets the peak search condition.

  • Page 46: Calculate:marker< N> :Mi Nimum

    RIGOL Chapter 2 Command System :CALCulate:MARKer< n> :MI Nimum Syntax :CALCulate:MARKer< n> : MI Nimum Description Searches for and marks the peak with the minimum amplitude on the trace. Parameter Name Type Range Default < n> Discrete 1| 2| 3| 4| 5| 6| 7| 8 ——...

  • Page 47: Calculate:marker< N> :Ptpeak

    Chapter 2 Command System RIGOL :CALCulate:MARKer< n> :PTPeak Syntax :CALCulate:MARKer< n> :PTPeak Description Performs the peak-peak search and marks it with a specified marker. Parameter Name Type Range Default < n> Discrete 1| 2| 3| 4| 5| 6| 7| 8 ——...

  • Page 48: Calculate:marker< N> [ :Set] :Center

    RIGOL Chapter 2 Command System :CALCulate:MARKer< n> [ :SET] :CENTer Syntax :CALCulate:MARKer< n> [ : SET] :CENTer Description Sets the frequency of the specified marker to the center frequency of the analyzer. Parameter Name Type Range Default < n> Discrete 1| 2| 3| 4| 5| 6| 7| 8 ——...

  • Page 49: Calculate:marker< N> [ :Set] :Delta:span

    Chapter 2 Command System RIGOL :CALCulate:MARKer< n> [ :SET] :DELTa:SPAN Syntax :CALCulate:MARKer< n> [ : SET] :DELTa: SPAN Description Sets the frequency difference of the specified Delta marker to the span of the analyzer. Parameter Name Type Range Default < n>...

  • Page 50: Calculate:marker< N> [ :Set] :Start

    RIGOL Chapter 2 Command System :CALCulate:MARKer< n> [ :SET] :STARt Syntax :CALCulate:MARKer< n> [ : SET] :STARt Description Sets the frequency of the specified marker to the start frequency of the analyzer. Parameter Name Type Range Default < n> Discrete 1| 2| 3| 4| 5| 6| 7| 8 ——...

  • Page 51: Calculate:marker< N> [ :Set] :Stop

    Chapter 2 Command System RIGOL :CALCulate:MARKer< n> [ :SET] :STOP Syntax :CALCulate:MARKer< n> [ : SET] :STOP Description Sets the frequency of the specified marker to the stop frequency of the analyzer. Parameter Name Type Range Default < n> Discrete 1| 2| 3| 4| 5| 6| 7| 8 ——...

  • Page 52: Calculate:marker< N> :Trace

    RIGOL Chapter 2 Command System :CALCulate:MARKer< n> :TRACe Syntax :CALCulate:MARKer< n> : TRACe < integer> :CALCulate:MARKer< n> : TRACe? Description Sets the marker trace for the specified marker. Queries the marker trace for the specified marker. Parameter Name Type Range Default <...

  • Page 53: Calculate:marker< N> :X

    Chapter 2 Command System RIGOL Return Format The query returns 0 or 1. Example The following command sets the marker trace of Marker 1 to Auto. :CALCulate:MARKer1: TRACe:AUTO ON or :CALCulate: MARKer1:TRACe:AUTO 1 The following query returns 1. :CALCulate:MARKer1: TRACe:AUTO? :CALCulate:MARKer<...

  • Page 54: Calculate:marker< N> :X:readout

    RIGOL Chapter 2 Command System :CALCulate:MARKer< n> :X:READout Syntax :CALCulate:MARKer< n> : X: READout FREQuency| TI ME| I TI Me| PERiod :CALCulate:MARKer< n> : X: READout? Description Sets the readout mode of the X axis of the specified marker. Queries the readout mode of the X axis of the specified marker.

  • Page 55: Calculate:marker< N> :Y

    Chapter 2 Command System RIGOL Example The following command enables the auto readout mode of Marker 1 in the X-axis. :CALCulate:MARKer1: X:READout:AUTO ON or :CALCulate:MARKer1:X:READout:AUTO 1 The following query returns 1. :CALCulate:MARKer1: X:READout:AUTO? :CALCulate:MARKer< n> :Y Syntax :CALCulate:MARKer< n> :Y < amp>...

  • Page 56: Calculate:marker< N> :Z:position

    RIGOL Chapter 2 Command System :CALCulate:MARKer< n> :Z:POSition Syntax :CALCulate:MARKer< n> : Z: POSition < integer> :CALCulate:MARKer< n> : Z: POSition? Description Sets the trace number of the trace where the marker stays in the Spectrogram view. Queries the trace number of the trace where the marker stays in the Spectrogram view.

  • Page 57: Calculate:ntdata[ :State]

    Chapter 2 Command System RIGOL Remarks PDI Fference: indicates the power difference between Operand 1 and Operand 2. PSUM: indicates the power sum between Operand 1 and Operand 2. LOFFset: indicates the sum between Operand 1 and the offset parameter < rel_offset> .

  • 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 RSA5000 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". RSA5000 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 :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 :DI SPlay:PVTime:WI NDow :TRACe:Y[ :SCALe] :PDI Vision Syntax :DI SPlay:PVTime: WI NDow: TRACe:Y[ : SCALe] :PDI Vision < rel_ampl> :DI SPlay:PVTime: WI NDow: TRACe:Y[ : SCALe] :PDI Vision? Description Sets the unit per division in the vertical axis of the PvT view.

  • Page 72: Di Splay:vi Ew:density:aadjust

    RIGOL Chapter 2 Command System :DI SPlay:VI EW:DENSity:AADJust Syntax :DI SPlay:VI EW:DENSity:AADJust Description Sets the highest density hue to the highest density value found in the current bitmap; sets the lowest density hue to the lowest non-zero density value found in the current bitmap.

  • 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:trace: Y:dli Ne

    RIGOL Chapter 2 Command System Remarks This command is only available for Density Spectrogram, PvT Spectrum, or PvT Spectrogram in RTSA mode. Return Format The query returns SPEC or PVT. Example The following command selects the PvT window in the PvT Spectrum view.

  • 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 RSA5000 series that has been installed with advanced measurement kit (AMK) option. RSA5000 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 RSA5000 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:screen

    RIGOL Chapter 2 Command System :MMEMory:STORe:SCReen Syntax :MMEMory: STORe: SCReen < file_name> Description Saves the current screen image with the specified filename suffixed with ".jpg", ".png/ ", or ".bmp" to the default path (/ "mode name"/ screen). Parameter Name Type...

  • Page 115: Mmemory:store:trace

    Chapter 2 Command System RIGOL :MMEMory:STORe:TRACe Syntax :MMEMory: STORe: TRACe < label> ,< file_name> Description Saves the specified trace+ state file with filename suffixed with ".trs" to the default path (/ "mode name"/ tracestate). Parameter Name Type Range Default < label>...

  • 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 RSA5000 series that has been installed with advanced measurement kit (AMK) option. RSA5000 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: Mai N

    Chapter 2 Command System RIGOL :READ:ACPow er:MAI N? Syntax :READ:ACPower: MAI N? Description Executes one adjacent channel power measurement and returns the main channel power. Remarks The power unit of the return value is consistent with the current Y-axis unit.

  • Page 120: Read:cnratio:carrier

    RIGOL Chapter 2 Command System :READ:CNRatio:CARRier? Syntax :READ:CNRatio:CARRier? Description Executes one C/ N ratio measurement and returns the carrier power. Remarks The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer.

  • Page 121: Read:ebwidth

    Chapter 2 Command System RIGOL :READ:EBWidth? Syntax :READ:EBWidth? Description Executes one emission bandwidth measurement and returns the measurement results. Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer. This command is only available for GPSA mode.

  • Page 122: Read:harmonics:amplitude? < N

    RIGOL Chapter 2 Command System :READ:HARMonics:AMPLitude? < n> Syntax :READ:HARMonics:AMPLitude? < n> Description Executes one harmonic distortion measurement and returns the amplitude of the specified harmonic. Parameter Name Type Range Default < n> I nteger 1 to 10 —— Remarks The amplitude unit of the return value is consistent with the current Y-axis unit.

  • Page 123: Read:harmonics:frequency:all

    Chapter 2 Command System RIGOL :READ:HARMonics:FREQuency:ALL? Syntax :READ:HARMonics:FREQuency:ALL? Description Executes one harmonic distortion measurement and returns the frequencies of the first 10 harmonics. Remarks I f the number of harmonics under measurement is less than 10, the harmonics that are not measured do not have return values.

  • Page 124: Read:harmonics:fundamental

    RIGOL Chapter 2 Command System :READ:HARMonics:FUNDamental? Syntax :READ:HARMonics:FUNDamental? Description Executes one harmonic distortion measurement and returns the frequency of the fundamental waveform. Remarks This command has the same function as :READ:HARMonics:FREQuency? 1. This command will select data from the latest measurement results, and then transmit the data to the output buffer.

  • Page 125: Read:obwidth:obwidth:ferror

    Chapter 2 Command System RIGOL :READ:OBWidth:OBWidth:FERRor? Syntax :READ:OBWidth:OBWidth: FERRor? Description Executes one occupied bandwidth measurement and returns the transmit frequency error. Remarks This command will select data from the latest measurement results, and then transmit the data to the output buffer.

  • Page 126: Read:toi Ntercept

    RIGOL Chapter 2 Command System :READ:TOI ntercept? Syntax :READ: TOI ntercept? Description Executes one TOI measurement and returns the measurement results. Remarks The amplitude unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer.

  • Page 127: Read:tpower

    Chapter 2 Command System RIGOL :READ:TPOWer? Syntax :READ: TPOWer? Description Executes one T-power measurement and returns the measurement results. Remarks The power unit of the return value is consistent with the current Y-axis unit. This command will select data from the latest measurement results, and then transmit the data to the output buffer.

  • Page 128: :Sense] Commands

    RIGOL Chapter 2 Command System [ :SENSe] Commands Command List:  [ :SENSe] :ACPower:AVERage:COUNt  [ :SENSe] :ACPower:AVERage[ :STATe]  [ :SENSe] :ACPower:AVERage:TCONtrol  [ :SENSe] :ACPower:BANDwidth:ACHannel  [ :SENSe] :ACPower:BANDwidth:I NTegration  [ :SENSe] :ACPower:CSPacing  [ :SENSe] :ACQuisition: TI ME ...
  • Page 129 Chapter 2 Command System RIGOL  [ :SENSe] : DEMod  [ :SENSe] : DEMod: GAI N:AUTO  [ :SENSe] : DEMod: GAI N:I NCRement  [ :SENSe] : DEMod: STATe  [ :SENSe] : DETector: TRACe: PVTime  [ :SENSe] : DETector[ : FUNCtion] ...
  • Page 130 RIGOL Chapter 2 Command System  [ :SENSe] :OBWidth:MAXHold:STATe*  [ :SENSe] :OBWidth:PERCent*  [ :SENSe] :POWer[ :RF] :ATTenuation  [ :SENSe] :POWer[ :RF] :ATTenuation:AUTO  [ :SENSe] :POWer[ :RF] :GAI N[ :STATe]  [ :SENSe] :POWer[ :RF] :MI Xer:RANGe[ :UPPer] ...
  • Page 131 Chapter 2 Command System RIGOL [ :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 132: :Sense] :Acpower:average:count

    RIGOL Chapter 2 Command System [ :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 133: :Sense] :Acpower:bandwidth:i Ntegration

    Chapter 2 Command System RIGOL 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 134: :Sense] :Acquisition:ti Me

    RIGOL Chapter 2 Command System 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. :SENSe:ACPower:CSPacing 1000000 The following query returns 1.000000000e+ 06.

  • Page 135: :Sense] :Acquisition:ti Me:pvtime

    Chapter 2 Command System RIGOL Remarks This command is only available for Normal, Density, Spectrogram, and Density Spectrogram in RTSA mode. Return Format The query returns 0 or 1. Example The following command enables the auto acquisition time for producing one single trace or one bitmap.

  • Page 136: :Sense] :Acquisition:ti Me:pvtime:auto

    RIGOL Chapter 2 Command System [ :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 single trace. Queries the status of the auto acquisition time for producing a single trace.

  • Page 137: :Sense] :Average:count:current

    Chapter 2 Command System RIGOL 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 138: :Sense] :Average:type:auto

    RIGOL Chapter 2 Command System [ :SENSe] :AVERage:TYPE:AUTO Syntax [ :SENSe] :AVERage:TYPE:AUTO OFF| ON| 0| 1 [ :SENSe] :AVERage:TYPE:AUTO? Description Enables or disables the auto state for the average type of the swept SA analysis measurement. Queries the on/ off auto state for the average type of the swept SA analysis measurement.

  • Page 139: [ :Sense] :Bandwidth| Bwi Dth[ :Resolution]

    Chapter 2 Command System RIGOL 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 140: :Sense] :Bandwidth| Bwi Dth[ :Resolution] :Select

    RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the auto setting mode of RBW. :SENSe:BANDwidth:RESolution:AUTO ON or :SENSe:BANDwidth:RESolution:AUTO 1 :SENSe:BWI Dth:RESolution:AUTO ON or :SENSe:BWI Dth:RESolution:AUTO 1 The following query returns 1.

  • Page 141: [ :Sense] :Bandwidth| Bwi Dth[ :Resolution] :Select:auto[ :State]

    Chapter 2 Command System RIGOL [ :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 142: :Sense] :Bandwidth| Bwi Dth:vi Deo

    RIGOL Chapter 2 Command System :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 143: :Sense] :Bandwidth| Bwi Dth:vi Deo:ratio

    Chapter 2 Command System RIGOL 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 144: :Sense] :Bandwidth| Bwi Dth:vi Deo:ratio:auto

    RIGOL Chapter 2 Command System [ :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 145: [ :Sense] :Cnratio:average[ :State]

    Chapter 2 Command System RIGOL 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 146: :Sense] :Cnratio:bandwidth:i Ntegration

    RIGOL Chapter 2 Command System This command is only valid when the C/ N ratio measurement in GPSA mode is enabled. Return Format The query returns EXP or REP Example The following command sets repeat average to the average mode.

  • Page 147: :Sense] :Cnratio:bandwidth:noi Se

    Chapter 2 Command System RIGOL [ :SENSe] :CNRatio:BANDw idth:NOI Se Syntax [ :SENSe] :CNRatio:BANDwidth:NOI Se < freq> [ :SENSe] :CNRatio:BANDwidth:NOI Se? Description Sets the noise bandwidth. Queries the noise bandwidth. Parameter Name Type Range Default < freq> Consecutive Real Number 3 Hz to 2.166666 GHz...

  • Page 148: I Nput:i Mpedance

    RIGOL Chapter 2 Command System :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 149: :Sense] :Demod

    Chapter 2 Command System RIGOL [ :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 150: :Sense] :Demod:gai N:i Ncrement

    RIGOL Chapter 2 Command System 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 151: :Sense] :Detector:trace:pvtime

    Chapter 2 Command System RIGOL 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 152: [ :Sense] :Detector[ :Function]

    RIGOL Chapter 2 Command System [ :SENSe] :DETector[ :FUNCtion] [ :SENSe] :DETector:TRACe< n> Syntax （ ） [ :SENSe] : DETector[ : FUNCtion] AVERage VAVerage | NEGative| NORMal| POSitive| SAMPle| QPEak| RAVerage （ ） [ :SENSe] : DETector[ : FUNCtion] ? （...

  • Page 153: :Sense] :Detector:trace< N> :Auto

    Chapter 2 Command System RIGOL [ :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 154: [ :Sense] :Ebwidth:average[ :State]

    RIGOL Chapter 2 Command System [ :SENSe] :EBWidth:AVERage[ :STATe] Syntax [ :SENSe] :EBWidth:AVERage[ :STATe] OFF| ON| 0| 1 [ :SENSe] :EBWidth:AVERage[ :STATe] ? Description Enables or disables the average measurement function of the emission bandwidth measurement. Queries the status of the average measurement function of the emission bandwidth measurement.

  • Page 155: :Sense] :Ebwidth:frequency:span

    Chapter 2 Command System RIGOL 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 156: :Sense] :Ebwidth:xdb

    RIGOL Chapter 2 Command System whichever is the maximum. When Max Hold is disabled, the current measurement result is displayed. Max Hold and average measurement are mutually exclusive. When Max Hold is enabled, the average measurement will be automatically disabled.

  • Page 157: :Sense] :Frequency:center

    Chapter 2 Command System RIGOL [ :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 [ 2] [ 1] < freq> Consecutive Real Number...

  • Page 158: [ :Sense] :Frequency:center:step[ :I Ncrement]

    RIGOL Chapter 2 Command System [ :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 159: :Sense] :Frequency:span

    Chapter 2 Command System RIGOL [ :SENSe] :FREQuency:SPAN Syntax [ :SENSe] :FREQuency:SPAN < freq> [ :SENSe] :FREQuency:SPAN? Description Sets the span. Queries the span. Parameter Name Type Range Default GPSA mode: 0 Hz, 10 Hz to Fmax GPSA mode: Fmax Consecutive <...

  • Page 160: :Sense] :Frequency: Span:bandwidth[ :Resolution] :Ratio:auto

    RIGOL Chapter 2 Command System 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 [ :SENSe] :FREQuency: SPAN:BANDwidth[ :RESolution] :RATio:AUTO? Description Enables or disables the auto setting mode of span/ RBW ratio.

  • Page 161: :Sense] :Frequency:span:zero

    Chapter 2 Command System RIGOL [ :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 162: :Sense] :Frequency:tune:i Mmediate

    RIGOL Chapter 2 Command System Return Format The query returns the stop frequency in scientific notation. The unit is Hz. Example The following command sets the stop frequency to 10 MHz. :SENSe: FREQuency: STOP 10000000 The following query returns 1.000000000e+ 07.

  • Page 163: [ :Sense] :Hdi St:average[ :State]

    Chapter 2 Command System RIGOL [ :SENSe] :HDI St:AVERage[ :STATe] Syntax [ :SENSe] :HDI St:AVERage[ :STATe] OFF| ON| 0| 1 [ :SENSe] :HDI St:AVERage[ :STATe] ? Description Enables or disables the average measurement function of the harmonic distortion measurement. Queries the status of the average measurement function of the harmonic distortion measurement.

  • Page 164: :Sense] :Hdi St:numbers

    RIGOL Chapter 2 Command System Example The following command sets the average mode to Repeat. :SENSe:HDI St:AVERage:TCONtrol REPeat The following query returns REP . :SENSe:HDI St:AVERage:TCONtrol? [ :SENSe] :HDI St:NUMBers Syntax [ :SENSe] :HDI St:NUMBers < integer> [ :SENSe] :HDI St:NUMBers? Description Sets the number of harmonics to be measured.

  • Page 165: :Sense] :Mchpower:average:count

    Chapter 2 Command System RIGOL Return Format The query returns the sweep time in scientific notation. The unit is s. Example The following command sets the sweep time to 100 ms. :SENSe:HDI St: TI ME 0.1 The following query returns 1.000000000e-01.

  • Page 166: :Sense] :Mchpower:average:tcontrol

    RIGOL Chapter 2 Command System Remarks This command is only valid when the multi-channel power measurement in GPSA mode is enabled. Return Format The query returns 0 or 1. Example The following command enables the average measurement function. :SENSe:MCHPower:AVERage:STATe ON or :SENSe: MCHPower:AVERage:STATe 1 The following query returns 1.

  • Page 167: :Sense] :Obwidth:average:count

    Chapter 2 Command System RIGOL [ :SENSe] :OBWidth:AVERage:COUNt Syntax [ :SENSe] :OBWidth:AVERage:COUNt < integer> [ :SENSe] :OBWidth:AVERage:COUNt? Description Sets the average count of the occupied bandwidth measurement. Queries the average count of the occupied bandwidth measurement. Parameter Name Type Range Default <...

  • Page 168: :Sense] :Obwidth:average:tcontrol

    RIGOL Chapter 2 Command System [ :SENSe] :OBWidth:AVERage:TCONtrol Syntax [ :SENSe] :OBWidth:AVERage:TCONtrol EXPonential| REPeat [ :SENSe] :OBWidth:AVERage:TCONtrol? Description Selects the average mode of the occupied bandwidth measurement. Queries the average mode of the occupied bandwidth measurement. Parameter Name Type Range Default ——...

  • Page 169: :Sense] :Obwidth:maxhold:state

    Chapter 2 Command System RIGOL Example The following command sets the span to 1 MHz. :SENSe:OBWidth: FREQuency: SPAN 1000000 The following query returns 1.000000000e+ 06. :SENSe:OBWidth: FREQuency: SPAN? [ :SENSe] :OBWidth:MAXHold:STATe Syntax [ :SENSe] :OBWidth:MAXHold:STATe OFF| ON| 0| 1 [ :SENSe] :OBWidth:MAXHold:STATe? Description Enables or disables Max Hold of the occupied bandwidth measurement.

  • Page 170: :Sense] :Power[ :Rf] :Attenuation

    RIGOL Chapter 2 Command System Remarks This command is only valid when the occupied bandwidth measurement in GPSA mode is enabled. The range of < real> is from 1 to 99.99. Therefore, set the range of the corresponding parameter for the analyzer to "1% -99.99% ".

  • Page 171: [ :Sense] :Power[ :Rf] :Gai N[ :State]

    Chapter 2 Command System RIGOL Return Format The query returns 0 or 1. Example The following command disables the auto setting mode of the input attenuation. :SENSe:POWer:RF:ATTenuation:AUTO OFF or :SENSe:POWer:RF:ATTenuation:AUTO 0 The following query returns 0. :SENSe:POWer:RF:ATTenuation:AUTO? [ :SENSe] :POWer[ :RF] :GAI N[ :STATe]...

  • Page 172: :Sense] :Si Gcapture: 2Fsk:ampdown

    RIGOL Chapter 2 Command System Example The following command sets the maximum power of the input mixer to -20 dBm. :SENSe:POWer:RF:MI Xer:RANGe:UPPer -20 The following query returns -2.000000000e+ 01. :SENSe:POWer:RF:MI Xer:RANGe:UPPer? [ :SENSe] :SI GCapture:2FSK:AMPDow n Syntax [ :SENSe] :SI GCapture: 2FSK:AMPDown < ample>...

  • Page 173: :Sense] :Si Gcapture:2Fsk:mark1:Freq

    Chapter 2 Command System RIGOL Return Format The query returns the amplitude upper limit in scientific notation. Example The following command sets the amplitude upper limit to -20 dBm. :SENSe: SI GCapture:2FSK:AMPUp -20 The following query returns -2.000000000e+ 01. :SENSe: SI GCapture:2FSK:AMPUp?

  • Page 174: [ :Sense] :Si Gcapture:2Fsk:mark1:Switch[ :State]

    RIGOL Chapter 2 Command System [ :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 175: [ :Sense] :Si Gcapture:2Fsk:mark2:Switch[ :State]

    Chapter 2 Command System RIGOL [ :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 176: :Sense] :Si Gcapture:2Fsk:peakamp

    RIGOL Chapter 2 Command System [ :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 177: :Sense] :Si Gcapture:2Fsk:pf

    Chapter 2 Command System RIGOL [ :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 178: :Sense] :Si Gcapture:2Fsk:reset

    RIGOL Chapter 2 Command System [ :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 179: :Sense] :Sweep:poi Nts

    Chapter 2 Command System RIGOL [ :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 180: :Sense] :Sweep:ti Me:auto

    RIGOL Chapter 2 Command System [ :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 181: :Sense] :Toi :Average:count

    Chapter 2 Command System RIGOL [ :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 182: :Sense] :Toi :Average:tcontrol

    RIGOL Chapter 2 Command System [ :SENSe] :TOI :AVERage:TCONtrol Syntax [ :SENSe] : TOI :AVERage:TCONtrol EXPonential| REPeat [ :SENSe] : TOI :AVERage:TCONtrol? Description Selects the average mode of the TOI measurement. Queries the average mode of the TOI measurement. Parameter...

  • Page 183: :Sense] :Tpower:average:count

    Chapter 2 Command System RIGOL 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 184: :Sense] :Tpower:average:tcontrol

    RIGOL Chapter 2 Command System Return Format The query returns 0 or 1. Example The following command enables the average measurement. :SENSe: TPOWer:AVERage:STATe ON or : SENSe:TPOWer:AVERage:STATe 1 The following query returns 1. :SENSe: TPOWer:AVERage:STATe? [ :SENSe] :TPOWer:AVERage:TCONtrol Syntax [ :SENSe] : TPOWer:AVERage:TCONtrol EXPonential| REPeat...

  • Page 185: :Sense] :Tpower:lli Mit

    Chapter 2 Command System RIGOL [ :SENSe] :TPOWer:LLI Mit Syntax [ :SENSe] : TPOWer:LLI Mit < time> [ :SENSe] : TPOWer:LLI Mit? Description Sets the start line for the T-power measurement. Queries the start line for the T-power measurement. Parameter...

  • Page 186: :Sense] :Tpower:rli Mit

    RIGOL Chapter 2 Command System The following query returns AVER. :SENSe: TPOWer:MODE? [ :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.

  • Page 187: Source Commands

    Chapter 2 Command System RIGOL :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 RSA5065-TG/ RSA5032-TG working in GPSA mode.

  • Page 188: Source:trace:reference:state

    RIGOL Chapter 2 Command System Return Format The query returns the output amplitude in scientific notation. Example The following command sets the output amplitude to -10 dB. :SOURce:EXTernal:POWer: LEVel:I MMediate:AMPLitude -10 The following query returns -1.000000000e+ 01. :SOURce:EXTernal:POWer: LEVel:I MMediate:AMPLitude?

  • Page 189: Status Commands

    Chapter 2 Command System RIGOL :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 190: Status:operation:condition

    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.

  • Page 191: Status:operation[ :Event]

    Chapter 2 Command System RIGOL Example The following command sets the enable register of the Operation Status Register to 100. :STATus:OPERation:ENABle 100 The following query returns 100. :STATus:OPERation:ENABle? :STATus:OPERation[ :EVENt] ? Syntax :STATus:OPERation[ :EVENt] ? Description Queries the event register of the Operation Status Register.

  • Page 192: Status:questionable:enable

    RIGOL Chapter 2 Command System :STATus:QUEStionable:ENABle Syntax :STATus:QUEStionable:ENABle < integer> :STATus:QUEStionable:ENABle? Description Sets the enable register of the Questionable Status Register. Queries the enable register of the Questionable Status Register. Parameter Name Type Range Default " " < integer> I nteger...

  • Page 193: Status:questionable[ :Event]

    Chapter 2 Command System RIGOL :STATus:QUEStionable[ :EVENt] ? Syntax :STATus:QUEStionable[ :EVENt] ? Description Queries the event register of the Questionable Status Register. Return Format Queries the event register of the Questionable Status Register in integer. For example, 0. RSA5000 Programming Guide 2-175 www.valuetronics.com...

  • Page 194: 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 195: 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 196: 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 197 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 198: 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 199: 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 200: System:communicate:lan[ :Self] :I P:submask

    RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN[ :SELF] :I P:SUBMask Syntax :SYSTem:COMMunicate: LAN[ :SELF] : I P:SUBMask< ip_address> :SYSTem:COMMunicate: LAN[ :SELF] : I P:SUBMask? Description Sets the subnet mask. Queries the subnet mask. Parameter Name Type Range Default < ip_address> ASCI I String Refer to "...

  • Page 201: System:communicate:lan[ :Self] :Mdns:state

    Chapter 2 Command System RIGOL The following query returns 1. :SYSTem:COMMunicate:LAN: SELF: MANuip: STATe? :SYSTem:COMMunicate:LAN[ :SELF] :MDNS:STATe Syntax :SYSTem:COMMunicate:LAN[ :SELF] : MDNS:STATe OFF| ON| 0| 1 :SYSTem:COMMunicate:LAN[ :SELF] : MDNS:STATe? Description Enables or disables the state of the network information sending.

  • Page 202: System:configure:i Nformation

    RIGOL Chapter 2 Command System :SYSTem:CONFigure:I NFormation? Syntax :SYSTem:CONFigure:I NFormation? Description Queries the system information of the spectrum analyzer. Remarks The system information includes the model, serial number, software and hardware version number, and f irmware version number. Return Format The query returns the system information.

  • Page 203: System:fswitch[ :State]

    Chapter 2 Command System RIGOL :SYSTem:FSWitch[ :STATe] Syntax :SYSTem: FSWitch[ :STATe] OFF| ON| 0| 1 :SYSTem: FSWitch[ :STATe] ? Description Sets the power switch on the front panel to be turned on or off. Queries whether the power switch on the front panel is turned on or off.

  • Page 204: System:lkey

    RIGOL Chapter 2 Command System :SYSTem:LKEY Syntax :SYSTem: LKEY < option info> @< license info> Description I nstalls and activates the specified option. Parameter Name Type Range Default < option info> ASCI I String —— —— < license info> ASCI I String ——...

  • Page 205: System:pon:type

    Chapter 2 Command System RIGOL :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...

  • Page 206: System:preset:type

    RIGOL Chapter 2 Command System :SYSTem:PRESet:TYPE Syntax :SYSTem:PRESet: TYPe FACTory| USER1| USER2| USER3| USER4| USER5| USER6 :SYSTem:PRESet: TYPe? Description Selects the preset type of the system to be the factory mode or any one of the items from User1 to User6.

  • Page 207: System:scpi :Di Splay

    Chapter 2 Command System RIGOL :SYSTem:SCPI :DI SPlay Syntax :SYSTem:SCPI :DI SPlay OFF| ON| 0| 1 :SYSTem:SCPI :DI SPlay? Description Enables or disables the SCPI display. Queries the status for the SCPI display. Parameter Name Type Range Default —— Bool...

  • Page 208: System:ti Me

    RIGOL Chapter 2 Command System :SYSTem:SHOW SYSTem The following query returns SYST. :SYSTem:SHOW? :SYSTem:TI ME Syntax :SYSTem: TI ME < hour> ,< minute> ,< second> :SYSTem: TI ME? Description Sets the system time of the instrument. Queries the system time of the instrument.

  • Page 209: Trace Commands

    Chapter 2 Command System RIGOL :TRACe Commands Command List:  :TRACe:CLEar:ALL  :TRACe[ : DATA]  :TRACe:MATH:A  :TRACe:MATH:B  :TRACe:MATH:CONSt  :TRACe:MATH:PEAK[ :DATA] ?  :TRACe:MATH:PEAK:POI Nts?  :TRACe:MATH:REFerence  :TRACe:MATH: STATe  :TRACe:MATH: TYPE  :TRACe:PRESet:ALL  :TRACe< n> :DI SPlay: STATe ...

  • Page 210: Trace[ :Data]

    RIGOL Chapter 2 Command System :TRACe[ :DATA] Syntax :TRACe[ : DATA] TRACE1| TRACE2| TRACE3| TRACE4| TRACE5| TRACE6,< def inite_length_block> | < comma_separated_ASCI I _data> :TRACe[ : DATA] ? TRACE1| TRACE2| TRACE3| TRACE4| TRACE5| TRACE6 Description Load the user data into the specif ied trace.

  • Page 211: Trace:math:a

    Chapter 2 Command System RIGOL 11111111111111111111010011…… Note: As the PC software converts the binary data returned to ASCI I character, the return value is unrecognizable code when the PC software is used to execute the query command. :TRACe: DATA? TRACE2 Remark: [ 1] The format of the data block is "Data Block Header + Data Block";...

  • Page 212: Trace:math:b

    RIGOL Chapter 2 Command System :TRACe:MATH:B Syntax :TRACe:MATH:B T1| T2| T3| T4| T5| T6 :TRACe:MATH:B? Description Sets Op2 in the trace math operation formula to Trace 1, Trace 2, Trace 3, Trace 4, Trace 5, or Trace 6. Queries which trace is Op2 represented in the trace math operation formula.

  • Page 213: Trace:math:peak[ :Data]

    Chapter 2 Command System RIGOL :TRACe:MATH:PEAK[ :DATA] ? Syntax :TRACe:MATH:PEAK[ :DATA] ? Description Queries the frequencies (Hz) and amplitudes (the unit is the same as the current Y-axis unit) of the peaks in the peak table. Remarks This command only queries Trace 1.

  • Page 214: Trace:math:state

    RIGOL Chapter 2 Command System :TRACe:MATH:STATe Syntax :TRACe:MATH: STATe OFF| ON| 0| 1 :TRACe:MATH:STATe? Description Enables or disables the math operation. Queries the status of the math operation of the trace. Parameter Name Type Range Default —— Bool OFF| ON| 0| 1...

  • Page 215: Trace:preset:all

    Chapter 2 Command System RIGOL :TRACe:PRESet:ALL Syntax :TRACe:PRESet:ALL Description Resets all the traces. Remarks Enables Trace 1, and sets other traces to be in blank state. This does not affect the trace type and the detector type. :TRACe< n> :DI SPlay:STATe Syntax :TRACe<...

  • Page 216: Trace< N> :Mode

    RIGOL Chapter 2 Command System :TRACe< n> :MODE :TRACe< n> :TYPE Syntax :TRACe< n> :MODE WRI Te| AVERage| MAXHold| MI NHold :TRACe< n> :MODE? :TRACe< n> : TYPE WRI Te| AVERage| MAXHold| MI NHold :TRACe< n> : TYPE? Description Sets the type of the specified trace.

  • Page 217: Trace< N> :Update:state

    Chapter 2 Command System RIGOL :TRACe< n> :UPDate:STATe Syntax :TRACe< n> : UPDate:STATe OFF| ON| 0| 1 :TRACe< n> : UPDate:STATe? Description Enables or disables the update of the specified trace. Queries the status for the update of the specified trace.

  • Page 218: 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 219: 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 220: 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 221: 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 222: 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 223: 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 224: Tri Gger[ :Sequence] :Fmt:mask

    RIGOL Chapter 2 Command System The following query returns 1. :TRI Gger:SEQuence:FMT:DELay: STATe? :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.

  • Page 225: Tri Gger[ :Sequence] :Fmt:mask:relative:amplitude

    Chapter 2 Command System RIGOL :TRI Gger:SEQuence:FMT:MASK:EDI T UPPer The following query returns UPP . :TRI Gger:SEQuence:FMT:MASK:EDI T? :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 226: Tri Gger[ :Sequence] :Fmt:mask:relative:frequency

    RIGOL Chapter 2 Command System :TRI Gger[ :SEQuence] :FMT:MASK:RELative:FREQuency Syntax :TRI Gger[ :SEQuence] :FMT: MASK:RELative:FREQuency ON| OFF| 1| 0 :TRI Gger[ :SEQuence] :FMT: MASK:RELative:FREQuency? Description Sets whether the frequencies of the mask points are coupled to the center frequency of the instrument.

  • Page 227: Tri Gger[ :Sequence] :Fmt:mask< N> :Data

    Chapter 2 Command System RIGOL This command is only valid when you select FMT to be the trigger source in RTSA mode. Example The following command creates a upper mask from trace1. :TRI Gger:SEQuence:FMT:MASK1:BUI Ld TRACE1 :TRI Gger[ :SEQuence] :FMT:MASK< n> :DATA Syntax :TRI Gger[ :SEQuence] :FMT: MASK<...

  • Page 228: Tri Gger[ :Sequence] :Fmt:mask< N> :New

    RIGOL Chapter 2 Command System :TRI Gger[ :SEQuence] :FMT:MASK< n> :NEW Syntax :TRI Gger[ :SEQuence] :FMT: MASK< n> :NEW Description Clears the currently activated mask and creates a default new mask. Parameter Name Type Range Default < n> Discrete 1| 2 ——...

  • Page 229: Tri Gger[ :Sequence] :Holdoff:state

    Chapter 2 Command System RIGOL :TRI Gger[ :SEQuence] :HOLDoff:STATe Syntax :TRI Gger[ :SEQuence] :HOLDoff:STATe OFF| ON| 0| 1 :TRI Gger[ :SEQuence] :HOLDoff:STATe? Description Enables or disables the trigger holdoff function. Queries the status of the trigger holdoff function. Parameter Name...

  • Page 230: Tri Gger[ :Sequence] :Vi Deo:delay

    RIGOL Chapter 2 Command System :TRI Gger[ :SEQuence] :VI Deo:DELay Syntax :TRI Gger[ :SEQuence] :VI Deo:DELay < time> :TRI Gger[ :SEQuence] :VI Deo:DELay? Description Sets the delay time for the video trigger. Queries the delay time for the video trigger.

  • Page 231: Tri Gger[ :Sequence] :Vi Deo:level

    Chapter 2 Command System RIGOL :TRI Gger[ :SEQuence] :VI Deo:LEVel Syntax :TRI Gger:SEQuence:VI Deo: LEVel < ampl> :TRI Gger:SEQuence:VI Deo: LEVel? Description Sets the trigger level of the video trigger. Queries the trigger level of the video trigger. Parameter Name...

  • Page 232: Tri Gger2:Mode

    RIGOL Chapter 2 Command System The following query returns POS. :TRI Gger:SEQuence:VI Deo: SLOPe? :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.

  • Page 233: 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 234 www.valuetronics.com...

  • Page 235: 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 236: 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 237: 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 238 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 239 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 240 RIGOL Chapter 3 Programming Examples 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); status = viClose(defaultRM); (* pstrResult).Format("% s",RecBuf );...
  • Page 241 Chapter 3 Programming Examples RIGOL 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 242 RIGOL Chapter 3 Programming Examples bool bReadOK = true; / / Change the address's data style from CString to char* SendAddr = strAddr.GetBuffer(strAddr.GetLength()); strcpy(SendAddr,strAddr); strAddr.ReleaseBuffer(); memset(RecBuf,0,MAX_REC_SI ZE); / / Read from the instrument status = viRead(m_SessI nstr, RecBuf, MAX_REC_SI ZE, &retCount);...
  • Page 243 Chapter 3 Programming Examples RIGOL 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 244 RIGOL Chapter 3 Programming Examples / / 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 245: 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 246 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 247 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 248 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 249: 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 250 RIGOL Chapter 3 Programming Examples Write operation (including error conf irmation) 3-16 RSA5000 Programming Guide www.valuetronics.com...
  • Page 251 Chapter 3 Programming Examples RIGOL Read operation (including error correction advice) RSA5000 Programming Guide 3-17 www.valuetronics.com...
  • Page 252 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 253: 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 254 RIGOL Chapter 3 Programming Examples below, then, the network address of the spectrum analyzer should be conf igured as follows. I P Address: 172.16.3.X* Default Gateway: 172.16.3.1 Subnet Mask: 255.255.255.0 DNS: 172.16.2.2 Note* : X can be any value not in use from 2 to 254.
  • Page 255 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 256: 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 257 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 258 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 259 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 260 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 261 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 262 www.valuetronics.com...

  • Page 263: 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 ( RSA5000- B40) Value...
  • Page 264 RIGOL Chapter 4 Appendix Trigger Mask Upper Trigger Criteria Enter Active Mask Upper Frequency 0 Hz Amplitude 0 dB Build From Trace Trace1 X Offset 0 Hz Y Offset 0 dB X Axis Type Relative Y Axis Type Relative Trace...
  • Page 265 Chapter 4 Appendix RIGOL Select Limit Limit1 Limit Type Upper X To CF Fixed Y To Ref Fixed Margin Off, 0 dB Test Trace Trace1 Test Limits Limit State T- Pow er Avg Number Off, 10 Avg Mode Exponential Avg State...
  • Page 266 RIGOL Chapter 4 Appendix Harmonic ST 1 ms Avg Number Off, 10 Avg Mode Exponential Avg State TOI Span 2 MHz [ 2] Measure Setup ( RTSA) Normal Avg Number Test Limits Select Limit Limit1 Limit State Test Trace Trace1...
  • Page 267 Chapter 4 Appendix RIGOL Line State 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 268: 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:

Rsa5065Rsa5032Rsa5065-tgRsa5032-tg

Table of Contents