Page 1 RIGOL Programming Guide MSO1000Z/DS1000Z Series Digital Oscilloscope Jul. 2018 RIGOL TECHNOLOGIES, INC.
Page 3: Guaranty And Declaration
Notices RIGOL products are covered by P.R.C. and foreign patents, issued and pending.  RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at  the company’s sole decision. Information in this publication replaces all previously released materials.
Page 4: Document Overview
Excel, Matlab, LabVIEW, Visual Basic 6.0 and Visual C++ 6.0. For the newest version of this manual, please download it from RIGOL official website (www.rigol.com). Format Conventions in this Manual: The function key at the front panel is denoted by the format of "Key Name (Bold) + Text Box" in the manual.
Page 5: Table Of Contents
Contents RIGOL Contents Guaranty and Declaration ......................I Document Overview ......................... II Chapter 1 Programming Overview..................1-1 To Build Remote Communication ....................1-2 Remote Control Methods ......................1-4 SCPI Command Overview ......................1-5 Syntax ..........................1-5 Symbol Description ......................1-5 Parameter Type ........................
Page 6 Contents RIGOL :DECoder<n>:CONFig:LINE ....................2-42 :DECoder<n>:CONFig:FORMat..................2-42 :DECoder<n>:CONFig:ENDian ..................2-43 :DECoder<n>:CONFig:WIDth .................... 2-43 :DECoder<n>:CONFig:SRATe? ..................2-43 :DECoder<n>:UART ......................2-44 :DECoder<n>:IIC ......................2-48 :DECoder<n>:SPI ......................2-50 :DECoder<n>:PARallel ...................... 2-56 :DISPlay Commands ........................ 2-62 :DISPlay:CLEar ......................... 2-62 :DISPlay:DATA? ........................ 2-63 :DISPlay:TYPE ........................2-64 :DISPlay:GRADing:TIME ....................
Page 7 Contents RIGOL :LA:POD<n>:DISPlay ....................... 2-86 :LA:POD<n>:THReshold ....................2-86 :LA:SIZE .......................... 2-87 :LA:STATe ........................2-87 :LA:TCALibrate ......................... 2-88 :MATH Commands ........................2-89 :MATH:DISPlay ........................ 2-90 :MATH:OPERator ......................2-90 :MATH:SOURce1 ......................2-91 :MATH:SOURce2 ......................2-92 :MATH:LSOUrce1 ......................2-92 :MATH:LSOUrce2 ......................2-93 :MATH:SCALe ........................2-93 :MATH:OFFSet .........................
Page 8 Contents RIGOL :MEASure:AMSource ....................... 2-118 :MEASure:SETup:MAX ..................... 2-119 :MEASure:SETup:MID ..................... 2-119 :MEASure:SETup:MIN ..................... 2-120 :MEASure:SETup:PSA ...................... 2-120 :MEASure:SETup:PSB ...................... 2-121 :MEASure:SETup:DSA ..................... 2-121 :MEASure:SETup:DSB ..................... 2-122 :MEASure:STATistic:DISPlay .................... 2-122 :MEASure:STATistic:MODE ....................2-123 :MEASure:STATistic:RESet ....................2-123 :MEASure:STATistic:ITEM ....................2-124 :MEASure:ITEM ......................2-125 :REFerence Commands ......................
Page 9 Contents RIGOL :SYSTem:LANGuage ....................... 2-145 :SYSTem:LOCKed ......................2-146 :SYSTem:PON ........................ 2-146 :SYSTem:OPTion:INSTall ....................2-146 :SYSTem:OPTion:UNINSTall .................... 2-147 :SYSTem:RAM? ......................2-147 :SYSTem:SETup ......................2-147 [:TRACe[<n>]] Commands ....................2-148 [:TRACe[<n>]]:DATA ..................... 2-148 [:TRACe[<n>]]:DATA:DAC16 ..................2-149 [:TRACe[<n>]]:DATA:DAC ..................... 2-150 [:TRACe[<n>]]:DATA:POINts ..................2-151 [:TRACe[<n>]]:DATA:POINts:INTerpolate ............... 2-151 [:TRACe[<n>]]:DATA:VALue ..................
Page 10 Contents RIGOL :WAVeform:PREamble? ....................2-226 Chapter 3 Programming Demos ..................3-1 Programming Preparations ......................3-2 Excel Programming Demo ......................3-3 Matlab Programming Demo......................3-7 LabVIEW Programming Demo ....................3-9 Visual Basic Programming Demo ....................3-13 Visual C++ Programming Demo ....................3-15...
Page 11: Chapter 1 Programming Overview
Chapter 1 Programming Overview RIGOL Chapter 1 Programming Overview This chapter introduces how to build the remote communication between MSO1000Z/DS1000Z series digital oscilloscope and the PC. It also introduces the remote control methods as well as the syntax, symbols, parameters and abbreviation rules of the SCPI commands.
Page 12: To Build Remote Communication
Operation Steps: Install the Ultra Sigma common PC software Download the Ultra Sigma common PC software from RIGOL official website (www.rigol.com) and install it according to the instructions. Connect the instrument and PC and configure the interface parameters of the instrument MSO1000Z/DS1000Z can communicate with a PC through the USB or the LAN bus.
Page 13 Chapter 1 Programming Overview RIGOL MSO1000Z/DS1000Z Programming Guide...
Page 14: Remote Control Methods
(4) View the device resources The resources found will appear under the "RIGOL Online Resource" directory and the model number and USB interface information of the instrument will also be displayed. For example, MSO1104Z (USB0::0x1AB1::0x04CE::DS1ZD170800001::INSTR).
Page 15: Scpi Command Overview
Chapter 1 Programming Overview RIGOL SCPI Command Overview SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming language that is built upon the standard IEEE 488.1 and IEEE 488.2 and conforms to various standards (such as the floating point operation rule in IEEE 754 standard, ISO 646 7-bit coded character for information interchange (equivalent to ASCII programming)).
Page 16: Command Abbreviation
Chapter 1 Programming Overview RIGOL The query returns 1 or 0. Discrete The parameter could be any of the values listed. For example, :ACQuire:TYPE <type> :ACQuire:TYPE? Wherein, <type> can be set to NORMal|AVERages|PEAK|HRESolution. The query returns the abbreviations (NORM, AVER, PEAK, or HRES).
Page 17: Chapter 2 Command System
Chapter 2 Command System RIGOL Chapter 2 Command System This chapter introduces the syntax, function, parameter, and using instruction of each MSO1000Z/DS1000Z command. Main topics of this chapter: :AUToscale  :CLEar  :RUN  :STOP  :SINGle  :TFORce ...
Page 18: Autoscale
Chapter 2 Command System RIGOL :AUToscale Syntax :AUToscale Description Enable the waveform auto setting function. The oscilloscope will automatically adjust the vertical scale, horizontal timebase, and trigger mode according to the input signal to realize optimum waveform display. This command is equivalent to pressing the AUTO key at the front panel.
Page 19: Single
Chapter 2 Command System RIGOL :SINGle Syntax :SINGle Description Set the oscilloscope to the single trigger mode. This command is equivalent to any of the following two operations: pressing the SINGLE key at the front panel and sending :TRIGger:SWEep SINGle command.
Page 20: Acquire Commands
Chapter 2 Command System RIGOL :ACQuire Commands The :ACQuire commands are used to set and query the memory depth, acquisition mode and the number of averages as well as query the current sample rate of the oscilloscope. Command List :ACQuire:AVERages ...
Page 21: Acquire:mdepth
Chapter 2 Command System RIGOL :ACQuire:MDEPth Syntax :ACQuire:MDEPth <mdep> :ACQuire:MDEPth? Description Set or query the memory depth of the oscilloscope (namely the number of waveform points that can be stored in a single trigger sample). The default unit is pts (points).
Page 22: Acquire:type
Chapter 2 Command System RIGOL :ACQuire:TYPE Syntax :ACQuire:TYPE <type> :ACQuire:TYPE? Description Set or query the acquisition mode of the oscilloscope. Parameter Name Type Range Default <type> {NORMal|AVERages|PEAK|HRESolution} Discrete NORMal Explanation NORMal n this mode, the oscilloscope samples the signal at equal time interval to ...
Page 23: Acquire:srate
Chapter 2 Command System RIGOL :ACQuire:SRATe? Syntax :ACQuire:SRATe? Description Query the current sample rate. The default unit is Sa/s. Explanation Sample rate is the sample frequency of the oscilloscope, namely the waveform points  sampled per second. The following equation describes the relationship among memory depth, sample ...
Page 24: Calibrate Commands
Chapter 2 Command System RIGOL :CALibrate Commands Command List: :CALibrate:QUIT  :CALibrate:STARt  :CALibrate:QUIT Syntax :CALibrate:QUIT Description Exit the self-calibration at any time. Related :CALibrate:STARt Command :CALibrate:STARt Syntax :CALibrate:STARt Description The oscilloscope starts to execute self-calibration. Explanation The self-calibration operation can make the oscilloscope quickly reach its optimum ...
Page 25: Channel Commands
Chapter 2 Command System RIGOL :CHANnel<n> Commands The :CHANnel<n> commands are used to set or query the vertical system parameters of the analog channels, such as the bandwidth limit, coupling, vertical scale, and vertical offset. Command List: :CHANnel<n>:BWLimit  :CHANnel<n>:COUPling ...
Page 26: Channel:Coupling
Chapter 2 Command System RIGOL :CHANnel<n>:COUPling Syntax :CHANnel<n>:COUPling <coupling> :CHANnel<n>:COUPling? Description Set or query the coupling mode of the specified channel. Parameter Name Type Range Default <n> Discrete {1|2|3|4} <coupling> Discrete {AC|DC|GND} Explanation AC: the DC components of the signal under test are blocked.
Page 27: Channel:Invert
Chapter 2 Command System RIGOL :CHANnel<n>:INVert Syntax :CHANnel<n>:INVert <bool> :CHANnel<n>:INVert? Description Enable or disable the waveform invert of the specified channel or query the status of the waveform invert of the specified channel. Parameter Name Type Range Default <n> Discrete {1|2|3|4} <bool>...
Page 28: Channel:Range
Chapter 2 Command System RIGOL :CHANnel<n>:RANGe Syntax :CHANnel<n>:RANGe <range> :CHANnel<n>:RANGe? Description Set or query the vertical range of the specified channel. The default unit is V. Parameter Name Type Range Default <n> Discrete {1|2|3|4} Related to the probe ratio 8V (the probe <range>...
Page 29: Channel:Tcal
Chapter 2 Command System RIGOL :CHANnel<n>:TCAL Syntax :CHANnel<n>:TCAL <val> :CHANnel<n>:TCAL? Description Set or query the delay calibration time of the specified channel to calibrate the zero offset of the corresponding channel. The default unit is s. Parameter Name Type Range Default <n>...
Page 30: Channel:Scale
Chapter 2 Command System RIGOL :CHANnel<n>:SCALe Syntax :CHANnel<n>:SCALe <scale> :CHANnel<n>:SCALe? Description Set or query the vertical scale of the specified channel. The default unit is V. Parameter Name Type Range Default <n> Discrete {1|2|3|4} Related to the current probe ratio...
Page 31: Channel:Units
Chapter 2 Command System RIGOL :CHANnel<n>:UNITs Syntax :CHANnel<n>:UNITs <units> :CHANnel<n>:UNITs? Description Set or query the amplitude display unit of the specified channel. Parameter Name Type Range Default <n> Discrete {1|2|3|4} <units> Discrete {VOLTage|WATT|AMPere|UNKNown} VOLTage Return The query returns VOLT, WATT, AMP, or UNKN.
Page 32: Cursor Commands
Chapter 2 Command System RIGOL :CURSor Commands The :CURSor commands are used to measure the X-axis value (such as time) and Y-axis value (such as voltage) of the waveform displayed on the screen. Command List: :CURSor:MODE  :CURSor:MANual  :CURSor:TRACk ...
Page 33: Cursor:manual
Chapter 2 Command System RIGOL :CURSor:MANual Command List: :CURSor:MANual:TYPE  :CURSor:MANual:SOURce  :CURSor:MANual:TUNit  :CURSor:MANual:VUNit  :CURSor:MANual:AX  :CURSor:MANual:BX  :CURSor:MANual:AY  :CURSor:MANual:BY  :CURSor:MANual:AXValue?  :CURSor:MANual:AYValue?  :CURSor:MANual:BXValue?  :CURSor:MANual:BYValue?  :CURSor:MANual:XDELta?  :CURSor:MANual:IXDELta?  :CURSor:MANual:YDELta?  :CURSor:MANual:TYPE Syntax :CURSor:MANual:TYPE <type>...
Page 34 Chapter 2 Command System RIGOL :CURSor:MANual:SOURce Syntax :CURSor:MANual:SOURce <source> :CURSor:MANual:SOURce? Description Set or query the channel source of the manual cursor measurement mode. Parameter Name Type Range Default {CHANnel1|CHANnel2|CHANnel3| <source> Discrete CHANnel1 CHANnel4|MATH|LA} Explanation Only the channel that is enabled currently can be selected.
Page 35 Chapter 2 Command System RIGOL :CURSor:MANual:VUNit Syntax :CURSor:MANual:VUNit <unit> :CURSor:MANual:VUNit? Description Set or query the vertical unit in the manual cursor measurement mode. Parameter Name Type Range Default <unit> Discrete {PERCent|SOURce} SOURce Explanation PERCent: AY, BY, and BY-AY in the measurement results are expressed in percentage.
Page 36 Chapter 2 Command System RIGOL :CURSor:MANual:BX Syntax :CURSor:MANual:BX <x> :CURSor:MANual:BX? Description Set or query the horizontal position of cursor B in the manual cursor measurement mode. Parameter Name Type Range Default <x> Integer 5 to 594 Explanation The horizontal and vertical positions of the cursor are defined by the pixel coordinate of the screen.
Page 37 Chapter 2 Command System RIGOL :CURSor:MANual:BY Syntax :CURSor:MANual:BY <y> :CURSor:MANual:BY? Description Set or query the vertical position of cursor B in the manual cursor measurement mode. Parameter Name Type Range Default <y> Integer 5 to 394 Explanation The horizontal and vertical positions of the cursor are defined by the pixel coordinate ...
Page 38 Chapter 2 Command System RIGOL :CURSor:MANual:BXValue? Syntax :CURSor:MANual:BXValue? Description Query the X value of cursor B in the manual cursor measurement mode. The unit depends on the horizontal unit currently selected. Return The query returns the X value of cursor B in scientific notation.
Page 39 Chapter 2 Command System RIGOL :CURSor:MANual:IXDELta? Syntax :CURSor:MANual:IXDELta? Description Query the reciprocal of the absolute value of the difference between the X values of cursor A and cursor B (1/|dX|) in the manual cursor measurement mode. The unit depends on the horizontal unit currently selected.
Page 40: Cursor:track
Chapter 2 Command System RIGOL :CURSor:TRACk Command List: :CURSor:TRACk:SOURce1  :CURSor:TRACk:SOURce2  :CURSor:TRACk:AX  :CURSor:TRACk:BX  :CURSor:TRACk:AY?  :CURSor:TRACk:BY?  :CURSor:TRACk:AXValue?  :CURSor:TRACk:AYValue?  :CURSor:TRACk:BXValue?  :CURSor:TRACk:BYValue?  :CURSor:TRACk:XDELta?  :CURSor:TRACk:YDELta?  :CURSor:TRACk:IXDELTA?  :CURSor:TRACk:SOURce1 Syntax :CURSor:TRACk:SOURce1 <source> :CURSor:TRACk:SOURce1? Description Set or query the channel source of cursor A in the track cursor measurement mode.
Page 41 Chapter 2 Command System RIGOL :CURSor:TRACk:SOURce2 Syntax :CURSor:TRACk:SOURce2 <source> :CURSor:TRACk:SOURce2? Description Set or query the channel source of cursor B in the track cursor measurement mode. Parameter Name Type Range Default {OFF|CHANnel1|CHANnel2|CHANnel3| <source> Discrete CHANnel1 CHANnel4|MATH} Explanation Only the channels enabled can be selected as the channel source.
Page 42 Chapter 2 Command System RIGOL :CURSor:TRACk:BX Syntax :CURSor:TRACk:BX <x> :CURSor:TRACk:BX? Description Set or query the horizontal position of cursor B in the track cursor measurement mode. Parameter Name Type Range Default <x> Integer 5 to 594 Explanation The horizontal and vertical positions of the cursor are defined by the pixel coordinate of the screen.
Page 43 Chapter 2 Command System RIGOL :CURSor:TRACk:AXValue? Syntax :CURSor:TRACk:AXValue? Description Query the X value of cursor A in the track cursor measurement mode. The default unit is s. Return The query returns the X value of cursor A in scientific notation.
Page 44 Chapter 2 Command System RIGOL :CURSor:TRACk:XDELta? Syntax :CURSor:TRACk:XDELta? Description Query the difference between the X values of cursor A and cursor B (BX-AX) in the track cursor measurement mode. The default unit is s. Return The query returns the difference in scientific notation.
Page 45: Cursor:auto
Chapter 2 Command System RIGOL :CURSor:AUTO Command List: :CURSor:AUTO:ITEM  :CURSor:AUTO:AX?  :CURSor:AUTO:BX?  :CURSor:AUTO:AY?  :CURSor:AUTO:BY?  :CURSor:AUTO:AXValue?  :CURSor:AUTO:AYValue?  :CURSor:AUTO:BXValue?  :CURSor:AUTO:BYValue?  :CURSor:AUTO:ITEM Syntax :CURSor:AUTO:ITEM <item> :CURSor:AUTO:ITEM? Description The auto cursor function can measure 37 waveform parameters. Using this command, you can select the parameters to be measured by the auto cursor from the five parameters enabled last or query the parameters currently measured by the auto cursor.
Page 46 Chapter 2 Command System RIGOL :CURSor:AUTO:AX? Syntax :CURSor:AUTO:AX? Description Query the horizontal position of cursor A in auto cursor measurement. Explanation The horizontal and vertical positions of the cursor are defined by the pixel  coordinate of the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400).
Page 47 Chapter 2 Command System RIGOL :CURSor:AUTO:BY? Syntax :CURSor:AUTO:BY? Description Query the vertical position of cursor B in auto cursor measurement. Explanation The horizontal and vertical positions of the cursor are defined by the pixel  coordinate of the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400).
Page 48 Chapter 2 Command System RIGOL :CURSor:AUTO:BYValue? Syntax :CURSor:AUTO:BYValue? Description Query the Y value of cursor B in auto cursor measurement. The unit depends on the vertical unit currently selected. Explanation In auto cursor measurement, cursor B of Y type is not required for some of the measurement items.
Page 49: Cursor:xy
Chapter 2 Command System RIGOL :CURSor:XY The :CURSor:XY commands can only be used when the horizontal timebase mode is XY. Command List: :CURSor:XY:AX  :CURSor:XY:BX  :CURSor:XY:AY  :CURSor:XY:BY  :CURSor:XY:AXValue?  :CURSor:XY:AYValue?  :CURSor:XY:BXValue?  :CURSor:XY:BYValue?  :CURSor:XY:AX Syntax :CURSor:XY:AX <x>...
Page 50 Chapter 2 Command System RIGOL :CURSor:XY:BX Syntax :CURSor:XY:BX <x> :CURSor:XY:BX? Description Set or query the horizontal position of cursor B in the XY cursor measurement mode. Parameter Name Type Range Default <x> Integer 5 to 394 Explanation In the XY timebase mode, the horizontal and vertical positions of the cursor are defined by the pixel coordinate of the XY display area.
Page 51 Chapter 2 Command System RIGOL :CURSor:XY:BY Syntax :CURSor:XY:BY <y> :CURSor:XY:BY? Description Set or query the vertical position of cursor B in the XY cursor measurement mode. Parameter Name Type Range Default <x> Integer 5 to 394 Explanation In the XY timebase mode, the horizontal and vertical positions are defined by the pixel coordinate of the XY display area.
Page 52 Chapter 2 Command System RIGOL :CURSor:XY:BXValue? Syntax :CURSor:XY:BXValue? Description Query the X value of cursor B in the XY cursor measurement mode. The unit depends on the amplitude unit of the corresponding channel. Return The query returns the X value of cursor B in scientific notation.
Page 53: Decoder Commands
Chapter 2 Command System RIGOL :DECoder Commands The :DECoder commands are used to execute decoding settings and operations. Command List: :DECoder<n>:MODE  :DECoder<n>:DISPlay  :DECoder<n>:FORMat  :DECoder<n>:POSition  :DECoder<n>:THREshold:CHANnel1  :DECoder<n>:THREshold:CHANnel2  :DECoder<n>:THREshold:CHANnel3  :DECoder<n>:THREshold:CHANnel4  :DECoder<n>:THREshold:AUTO  :DECoder<n>:CONFig:LABel ...
Page 54: Decoder:Display
Chapter 2 Command System RIGOL :DECoder<n>:DISPlay Syntax :DECoder<n>:DISPlay <bool> :DECoder<n>:DISPlay? Description Turn on or off the decoder or query the status of the decoder. Parameter Name Type Range Default <n> Discrete {1|2} <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Return The query returns 1 or 0.
Page 55: Decoder:Position
Chapter 2 Command System RIGOL :DECoder<n>:POSition Syntax :DECoder<n>:POSition <pos> :DECoder<n>:POSition? Description Set or query the vertical position of the bus on the screen. Parameter Name Type Range Default <n> Discrete {1|2} Decoder 1: 350 <pos> Integer 50 to 350 Decoder 2: 300...
Page 56: Decoder:Threshold:channel1
Chapter 2 Command System RIGOL :DECoder<n>:THREshold:CHANnel1 :DECoder<n>:THREshold:CHANnel2 :DECoder<n>:THREshold:CHANnel3 :DECoder<n>:THREshold:CHANnel4 Syntax :DECoder<n>:THREshold:CHANnel1 <thre> :DECoder<n>:THREshold:CHANnel1? :DECoder<n>:THREshold:CHANnel2 <thre> :DECoder<n>:THREshold:CHANnel2? :DECoder<n>:THREshold:CHANnel3 <thre> :DECoder<n>:THREshold:CHANnel3? :DECoder<n>:THREshold:CHANnel4 <thre> :DECoder<n>:THREshold:CHANnel4? Description Set or query the threshold level of the specified analog channel. Parameter Name Type Range Default <n>...
Page 57: Decoder:Threshold:auto
Chapter 2 Command System RIGOL :DECoder<n>:THREshold:AUTO Syntax :DECoder<n>:THREshold:AUTO <bool> :DECoder<n>:THREshold:AUTO? Description Turn on or off the auto threshold function of the analog channels, or query the status of the auto threshold function of the analog channels. Parameter Name Type Range Default <n>...
Page 58: Decoder:Config:line
Chapter 2 Command System RIGOL :DECoder<n>:CONFig:LINE Syntax :DECoder<n>:CONFig:LINE <bool> :DECoder<n>:CONFig:LINE? Description Turn on or off the bus display function, or query the status of the bus display function. Parameter Name Type Range Default <n> Discrete {1|2} <bool> Bool {{1|ON}|{0|OFF}} 1|ON Explanation When this function is enabled, the bus will be displayed on the screen.
Page 59: Decoder:Config:endian
Chapter 2 Command System RIGOL :DECoder<n>:CONFig:ENDian Syntax :DECoder<n>:CONFig:ENDian <bool> :DECoder<n>:CONFig:ENDian? Description Turn on or off the endian display function in serial bus decoding, or query the status of the endian display function in serial bus decoding. Parameter Name Type Range Default <n>...
Page 60: Decoder:Uart
Chapter 2 Command System RIGOL :DECoder<n>:UART The :DECoder<n>:UART commands are used to set the RS232 decoding parameters. Command List: :DECoder<n>:UART:TX  :DECoder<n>:UART:RX  :DECoder<n>:UART:POLarity  :DECoder<n>:UART:ENDian  :DECoder<n>:UART:BAUD  :DECoder<n>:UART:WIDTh  :DECoder<n>:UART:STOP  :DECoder<n>:UART:PARity  :DECoder<n>:UART:TX Syntax :DECoder<n>:UART:TX <tx> :DECoder<n>:UART:TX? Description Set or query the TX channel source of RS232 decoding.
Page 61 Chapter 2 Command System RIGOL :DECoder<n>:UART:RX Syntax :DECoder<n>:UART:RX <rx> :DECoder<n>:UART:RX? Description Set or query the RX channel source of RS232 decoding. Parameter Name Type Range Default <n> Discrete {1|2} {D0|D1|D2|D3|D4|D5|D6|D7|D8| <rx> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF} Explanation When OFF is selected, no RX channel source will be set. The RX channel source and TX channel source (:DECoder<n>:UART:TX) cannot be both set to OFF.
Page 62 Chapter 2 Command System RIGOL :DECoder<n>:UART:ENDian Syntax :DECoder<n>:UART:ENDian <endian> :DECoder<n>:UART:ENDian? Description Set or query the endian of RS232 decoding. Parameter Name Type Range Default <n> Discrete {1|2} <endian> Discrete {LSB|MSB} Return The query returns LSB or MSB. Format Example :DECoder1:UART:ENDian MSB...
Page 63 Chapter 2 Command System RIGOL :DECoder<n>:UART:STOP Syntax :DECoder<n>:UART:STOP <stop> :DECoder<n>:UART:STOP? Description Set or query the stop bit after each frame of data in RS232 decoding. Parameter Name Type Range Default <n> Discrete {1|2} <stop> Discrete {1|1.5|2} Return The query returns 1, 1.5, or 2.
Page 64: Decoder:Iic
Chapter 2 Command System RIGOL :DECoder<n>:IIC The :DECoder<n>:IIC commands are used to set the I2C decoding parameters. Command List: :DECoder<n>:IIC:CLK  :DECoder<n>:IIC:DATA  :DECoder<n>:IIC:ADDRess  :DECoder<n>:IIC:CLK Syntax :DECoder<n>:IIC:CLK <clk> :DECoder<n>:IIC:CLK? Description Set or query the signal source of the clock channel in I2C decoding.
Page 65 Chapter 2 Command System RIGOL :DECoder<n>:IIC:ADDRess Syntax :DECoder<n>:IIC:ADDRess <addr> :DECoder<n>:IIC:ADDRess? Description Set or query the address mode of I2C decoding. Parameter Name Type Range Default <n> Discrete {1|2} <addr> Discrete {NORMal|RW} NORMal Explanation NORMal: the address bits (:TRIGger:IIC:AWIDth) does not include the R/W bit.
Page 66: Decoder:Spi
Chapter 2 Command System RIGOL :DECoder<n>:SPI The :DECoder<n>:SPI commands are used to set the SPI decoding parameters. Command List: :DECoder<n>:SPI:CLK  :DECoder<n>:SPI:MISO  :DECoder<n>:SPI:MOSI  :DECoder<n>:SPI:CS  :DECoder<n>:SPI:SELect  :DECoder<n>:SPI:MODE  :DECoder<n>:SPI:TIMeout  :DECoder<n>:SPI:POLarity  :DECoder<n>:SPI:EDGE  :DECoder<n>:SPI:ENDian  :DECoder<n>:SPI:WIDTh ...
Page 67 Chapter 2 Command System RIGOL :DECoder<n>:SPI:MISO Syntax :DECoder<n>:SPI:MISO <miso> :DECoder<n>:SPI:MISO? Description Set or query the MISO channel source in SPI decoding. Parameter Name Type Range Default <n> Discrete {1|2} {D0|D1|D2|D3|D4|D5|D6|D7|D8| <miso> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF} Explanation When OFF is selected, no MISO channel source will be set. The MISO channel source and MOSI channel source (:DECoder<n>:SPI:MOSI) cannot be both set to OFF.
Page 68 Chapter 2 Command System RIGOL :DECoder<n>:SPI:CS Syntax :DECoder<n>:SPI:CS <cs> :DECoder<n>:SPI:CS? Description Set or query the CS channel source in SPI decoding. Parameter Name Type Range Default <n> Discrete {1|2} {D0|D1|D2|D3|D4|D5|D6|D7|D8| <cs> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel3 CHANnel1|CHANnel2|CHANnel3|CHANnel4} Explanation This command is only valid in the CS mode (:DECoder<n>:SPI:MODE).
Page 69 Chapter 2 Command System RIGOL :DECoder<n>:SPI:MODE Syntax :DECoder<n>:SPI:MODE <CsTmo> :DECoder<n>:SPI:MODE? Description Set or query the frame synchronization mode of SPI decoding. Parameter Name Type Range Default <n> Discrete {1|2} <CsTmo> Discrete {CS|TIMeout} TIMeout Explanation CS: it contains a chip select line (CS). You can perform frame synchronization ...
Page 70 Chapter 2 Command System RIGOL :DECoder<n>:SPI:POLarity Syntax :DECoder<n>:SPI:POLarity <pol> :DECoder<n>:SPI:POLarity? Description Set or query the polarity of the SDA data line in SPI decoding. Parameter Name Type Range Default <n> Discrete {1|2} <pol> Discrete {NEGative|POSitive} POSitive Explanation NEGative: . The low level is 1.
Page 71 Chapter 2 Command System RIGOL :DECoder<n>:SPI:WIDTh Syntax :DECoder<n>:SPI:WIDTh <wid> :DECoder<n>:SPI:WIDTh? Description Set or query the number of bits of each frame of data in SPI decoding. Parameter Name Type Range Default <n> Discrete {1|2} <wid> Integer 8 to 32 Return The query returns an integer between 8 and 32.
Page 72: Decoder:Parallel
Chapter 2 Command System RIGOL :DECoder<n>:PARallel The :DECoder<n>:PARallel commands are used to set the parallel decoding parameters. Command List: :DECoder<n>:PARallel:CLK  :DECoder<n>:PARallel:EDGE  :DECoder<n>:PARallel:WIDTh  :DECoder<n>:PARallel:BITX  :DECoder<n>:PARallel:SOURce  :DECoder<n>:PARallel:POLarity  :DECoder<n>:PARallel:NREJect  :DECoder<n>:PARallel:NRTime  :DECoder<n>:PARallel:CCOMpensation  :DECoder<n>:PARallel:PLOT  :DECoder<n>:PARallel:CLK Syntax :DECoder<n>:PARallel:CLK <clk>...
Page 73 Chapter 2 Command System RIGOL :DECoder<n>:PARallel:EDGE Syntax :DECoder<n>:PARallel:EDGE <edge> :DECoder<n>:PARallel:EDGE? Description Set or query the edge type of the clock channel when the instrument samples the data channel in parallel decoding. Parameter Name Type Range Default <n> Discrete {1|2} <edge>...
Page 74 Chapter 2 Command System RIGOL :DECoder<n>:PARallel:BITX Syntax :DECoder<n>:PARallel:BITX <bit> :DECoder<n>:PARallel:BITX? Description Set or query the data bit that requires a channel source on the parallel bus. Parameter Name Type Range Default <n> Discrete {1|2} <bit> Integer 0 to (data width - 1)
Page 75 Chapter 2 Command System RIGOL :DECoder<n>:PARallel:POLarity Syntax :DECoder<n>:PARallel:POLarity <pol> :DECoder<n>:PARallel:POLarity? Description Set ro query the data polarity of parallel decoding. Parameter Name Type Range Default <n> Discrete {1|2} <pol> Discrete {NEGative|POSitive} POSitive Explanation NEGative: . The low level is 1.
Page 76 Chapter 2 Command System RIGOL :DECoder<n>:PARallel:NRTime Syntax :DECoder<n>:PARallel:NRTime <time> :DECoder<n>:PARallel:NRTime? Description Set or query the noise rejection time of parallel decoding. The default unit is s. Parameter Name Type Range Default <n> Discrete {1|2} <time> Real 0.00s to 100ms 0.00s...
Page 77 Chapter 2 Command System RIGOL :DECoder<n>:PARallel:PLOT Syntax :DECoder<n>:PARallel:PLOT <bool> :DECoder<n>:PARallel:PLOT? Description Turn on or off the curve function of parallel decoding, or query the status of the curve function of parallel decoding. Parameter Name Type Range Default <n> Discrete {1|2} <bool>...
Page 78: Display Commands
Chapter 2 Command System RIGOL :DISPlay Commands The :DISPlay commands can be used to set the waveform display mode, persistence time, waveform intensity, screen grid type and grid brightness. Command List: :DISPlay:CLEar  :DISPlay:DATA?  :DISPlay:TYPE  :DISPlay:GRADing:TIME  :DISPlay:WBRightness ...
Page 79: Display:data
Chapter 2 Command System RIGOL :DISPlay:DATA? Syntax :DISPlay:DATA? [<color>,<invert>,<format>] Description Read the data stream of the image currently displayed on the screen and set the color, invert display, and format of the image acquired. Parameter Name Type Range Default <color>...
Page 80: Display:type
Chapter 2 Command System RIGOL :DISPlay:TYPE Syntax :DISPlay:TYPE <type> :DISPlay:TYPE? Description Set or query the display mode of the waveform on the screen. Parameter Name Type Range Default <type> Discrete {VECTors|DOTS} VECTors Explanation VECTors: the sample points are connected by lines. Normally, this mode can provide ...
Page 81: Display:grading:time
Chapter 2 Command System RIGOL :DISPlay:GRADing:TIME Syntax :DISPlay:GRADing:TIME <time> :DISPlay:GRADing:TIME? Description Set or query the persistence time. The default unit is s. Parameter Name Type Range Default <time> Discrete {MIN|0.1|0.2|0.5|1|5|10|INFinite} Explanation MIN: set the persistence time to its minimum to view the waveform changing in high ...
Page 82: Display:grid
Chapter 2 Command System RIGOL :DISPlay:GRID Syntax :DISPlay:GRID <grid> :DISPlay:GRID? Description Set or query the grid type of screen display. Parameter Name Type Range Default <grid> Discrete {FULL|HALF|NONE} FULL Explanation FULL: turn the background grid and coordinate on. HALF: turn the background grid off and coordinate on.
Page 83: Etable Commands
Chapter 2 Command System RIGOL :ETABle Commands The :ETABle commands are used to set the parameters related to the decoding event table. Command List: :ETABle<n>:DISP  :ETABle<n>:FORMat  :ETABle<n>:VIEW  :ETABle<n>:COLumn  :ETABle<n>:ROW  :ETABle<n>:SORT  :ETABle<n>:DATA?  :ETABle<n>:DISP Syntax :ETABle<n>:DISP <bool>...
Page 84: Etable:View
Chapter 2 Command System RIGOL :ETABle<n>:VIEW Syntax :ETABle<n>:VIEW <view> :ETABle<n>:VIEW? Description Set or query the display mode of the event table. Parameter Name Type Range Default <n> Discrete {1|2} <view> Discrete {PACKage|DETail|PAYLoad} PACKage Explanation PACKage: the time and data are displayed in the event table.
Page 85: Etable:Row
Chapter 2 Command System RIGOL :ETABle<n>:ROW Syntax :ETABle<n>:ROW <row> :ETABle<n>:ROW? Description Set or query the current row of the event table. Parameter Name Type Range Default <n> Discrete {1|2} 1 to the maximum number of rows of the <row> Integer...
Page 86: Etable:Data
Chapter 2 Command System RIGOL :ETABle<n>:DATA? Syntax :ETABle<n>:DATA? Description Read the current event table data. Parameter Name Type Range Default <n> Discrete {1|2} Return The query returns the event table data in the format as shown in the figure below.
Page 87: Function Commands
Chapter 2 Command System RIGOL :FUNCtion Commands The :FUNCtion commands are used to set the waveform recording and playback parameters. Command List: :FUNCtion:WRECord:FEND  :FUNCtion:WRECord:FMAX?  :FUNCtion:WRECord:FINTerval  :FUNCtion:WRECord:PROMpt  :FUNCtion:WRECord:OPERate  :FUNCtion:WRECord:ENABle  :FUNCtion:WREPlay:FSTart  :FUNCtion:WREPlay:FEND  :FUNCtion:WREPlay:FMAX? ...
Page 88: Function:wrecord:fmax
Chapter 2 Command System RIGOL :FUNCtion:WRECord:FMAX? Syntax :FUNCtion:WRECord:FMAX? Description Query the maximum number of frames can be recorded currently. Explanation As the capacity of the waveform memory is fixed, the more the number of points each frame of waveform has, the less the number of waveform frames can be recorded. Thus, the maximum number of frames can be recorded currently is decided by the memory depth currently selected.
Page 89: Function:wrecord:operate
Chapter 2 Command System RIGOL :FUNCtion:WRECord:OPERate Syntax :FUNCtion:WRECord:OPERate <opt> :FUNCtion:WRECord:OPERate? Description Start or stop the waveform recording, or query the status of the waveform recording. Parameter Name Type Range Default <opt> Discrete {RUN|STOP} Explanation Before sending this command, send the...
Page 90: Function:wreplay:fstart
Chapter 2 Command System RIGOL :FUNCtion:WREPlay:FSTart Syntax :FUNCtion:WREPlay:FSTart <sta> :FUNCtion:WREPlay:FSTart? Description Set or query the start frame of waveform playback. Parameter Name Type Range Default <sta> Integer 1 to the maximum number of frames recorded Explanation Use the :FUNCtion:WRECord:FEND command to set the maximum number of ...
Page 91: Function:wreplay:fend
Chapter 2 Command System RIGOL :FUNCtion:WREPlay:FEND Syntax :FUNCtion:WREPlay:FEND <end> :FUNCtion:WREPlay:FEND? Description Set or query the end frame of waveform playback. Parameter Name Type Range Default 1 to the maximum number of frames The maximum number <end> Integer recorded of frames recorded...
Page 92: Function:wreplay:finterval
Chapter 2 Command System RIGOL :FUNCtion:WREPlay:FINTerval Syntax :FUNCtion:WREPlay:FINTerval <interval> :FUNCtion:WREPlay:FINTerval? Description Set or query the time interval between frames in waveform playback. The default unit is Parameter Name Type Range Default <interval> Real 100ns to 10s 100ns Explanation You can only set the time interval of waveform playback when a waveform is ...
Page 93: Function:wreplay:direction
Chapter 2 Command System RIGOL :FUNCtion:WREPlay:DIRection Syntax :FUNCtion:WREPlay:DIRection <dir> :FUNCtion:WREPlay:DIRection? Description Set or query the waveform playback direction. Parameter Name Type Range Default <dir> Discrete {FORWard|BACKward} FORWard Explanation FORWard: positive direction. Play from the start frame to the end frame.
Page 94: Function:wreplay:fcurrent
Chapter 2 Command System RIGOL :FUNCtion:WREPlay:FCURrent Syntax :FUNCtion:WREPlay:FCURrent <cur> :FUNCtion:WREPlay:FCURrent? Description Set or query the current frame in waveform playback. Parameter Name Type Range Default 1 to the maximum number of The maximum number <cur> Integer frames recorded of frames recorded...
Page 95: Ieee488.2 Common Commands
Chapter 2 Command System RIGOL IEEE488.2 Common Commands The IEEE 488.2 standard defines some common commands used for querying the basic information of the instrument or executing the basic operations. These commands usually start with "*" and the keyword of the command is usually 3-character long.
Page 96: Esr
*IDN? Syntax *IDN? Description Query the ID string of the instrument. Return The query returns RIGOL TECHNOLOGIES,<model>,<serial number>,<software Format version>. Whererin, <model>: the model number of the instrument. <serial number>: the serial number of the instrument. <software version>: the software version of the instrument.
Page 97: Sre
Chapter 2 Command System RIGOL *SRE Syntax *SRE <value> *SRE? Description Set or query the enable register for the status byte register set. Parameter Name Type Range Default <value> Integer 0 to 255 Explanation The bit 0 and bit 1 of the status byte register are not used and are always treated as 0;...
Page 98: La Commands
Chapter 2 Command System RIGOL :LA Commands The :LA commands are used to perform the related operations on the digital channels. These commands are only applicable to MSO1000Z and DS1000Z Plus with the MSO upgrade option. Command List: :LA:ACTive ...
Page 99: La:autosort
Chapter 2 Command System RIGOL :LA:AUTosort Syntax :LA:AUTosort <n> Description Set the auto ordering mode of the waveforms of the channels turned on on the screen. Parameter Name Type Range Default <n> Discrete {0|1} Explanation <n> = 0: waveforms on the screen are D15 to D0 from top to bottom ...
Page 100: La:digital:Position
Chapter 2 Command System RIGOL :LA:DIGital<n>:POSition Syntax :LA:DIGital<n>:POSition <position> :LA:DIGital<n>:POSition? Description Set or query the display position of the specified digital channel waveform on the screen. Parameter Name Type Range Default <n> Integer 0 to 15 When the waveform display mode is SMALl: 0 to 15 When the waveform display mode is LARGe: 0 to 7 <position>...
Page 101: La:display
Chapter 2 Command System RIGOL :LA:DISPlay Syntax :LA:DISPlay {<digital>|<group>|<pod>},<bool> :LA:DISPlay? {<digital>|<group>|<pod>} Description Turn on or off the specified digital channel, user-defined channel group or default channel group, or query the status of the specified digital channel, user-defined channel group or default channel group.
Page 102: La:pod:Display
Chapter 2 Command System RIGOL :LA:POD<n>:DISPlay Syntax :LA:POD<n>:DISPlay <bool> :LA:POD<n>:DISPlay? Description Turn on or off the specified default channel group, or query the status of the specified default channel group. Parameter Name Type Range Default <n> Integer 1 to 2 <bool>...
Page 103: La:size
Chapter 2 Command System RIGOL :LA:SIZE Syntax :LA:SIZE <size> :LA:SIZE? Description Set or query the display size of the waveforms of the channels turned on on the screen. Parameter Name Type Range Default <size> Discrete {SMALl|LARGe} SMALl Explanation SMALl: up to 16 waveforms can be displayed on the screen (0 to 15 from top to ...
Page 104: La:tcalibrate
Chapter 2 Command System RIGOL :LA:TCALibrate Syntax :LA:TCALibrate <tcal> :LA:TCALibrate? Description Set or query the delay calibration time of the digital channels. The default unit is s. Parameter Name Type Range Default <tcal> Real -100ns to 100ns 0.00s Explanation When using the oscilloscope for actual measurement, the transmission delay of the ...
Page 105: Math Commands
Chapter 2 Command System RIGOL :MATH Commands The :MATH commands are used to set the operations between the waveforms of multiple channels. Note: The operations include the following types:  Algebraic Operations: A+B, A-B, AxB, A/B Spectrum Operation: FFT Logic Operations: A&&B, A||B, A^B, !A...
Page 106: Math:display
Chapter 2 Command System RIGOL :MATH:FILTer:TYPE  :MATH:FILTer:W1  :MATH:FILTer:W2  :MATH:OPTion:STARt  :MATH:OPTion:END  :MATH:OPTion:INVert  :MATH:OPTion:SENSitivity  :MATH:OPTion:DIStance  :MATH:OPTion:ASCale  :MATH:OPTion:THReshold1  :MATH:OPTion:THReshold2  :MATH:OPTion:FX:SOURce1  :MATH:OPTion:FX:SOURce2  :MATH:OPTion:FX:OPERator  :MATH:DISPlay Syntax :MATH:DISPlay <bool> :MATH:DISPlay? Description Enable or disable the math operation function or query the math operation status.
Page 107: Math:source1
Chapter 2 Command System RIGOL :MATH:SOURce1 Syntax :MATH:SOURce1 <src> :MATH:SOURce1? Description Set or query the source or source A of algebraic operation/functional operation/the outer layer operation of compound operation. Parameter Name Type Range Default <src> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|FX} CHANnel1 Explanation For algebraic operations, this command is used to set source A.
Page 108: Math:source2
Chapter 2 Command System RIGOL :MATH:SOURce2 Syntax :MATH:SOURce2 <src> :MATH:SOURce2? Description Set or query source B of algebraic operation/the outer layer operation of compound operation. Parameter Name Type Range Default <src> {CHANnel1|CHANnel2|CHANnel3|CHANnel4|FX} Discrete CHANnel1 Explanation This command is only applicable to algebraic operations (requiring two sources) and ...
Page 109: Math:lsource2
Chapter 2 Command System RIGOL :MATH:LSOUrce2 Syntax :MATH:LSOUrce2 <src> :MATH:LSOUrce2? Description Set or query source B of logic operation. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8| <src> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4} Explanation The logic operations include A&&B, A||B, A^B, and !A. ...
Page 110: Math:offset
Chapter 2 Command System RIGOL :MATH:OFFSet Syntax :MATH:OFFSet <offs> :MATH:OFFSet? Description Set or query the vertical offset of the operation result. The unit depends on the operator currently selected and the unit of the source. Parameter Name Type Range Default...
Page 111: Math:reset
Chapter 2 Command System RIGOL :MATH:RESet Syntax :MATH:RESet Description Sending this command, the instrument adjusts the vertical scale of the operation result to the most proper value according to the current operator and the horizontal timebase of the source. Related...
Page 112: Math:fft:split
Chapter 2 Command System RIGOL :MATH:FFT:SPLit Syntax :MATH:FFT:SPLit <bool> :MATH:FFT:SPLit? Description Enable or disable the half-screen display mode of the FFT operation, or query the status of the half display mode of the FFT operation. Parameter Name Type Range Default <bool>...
Page 113: Math:fft:hscale
Chapter 2 Command System RIGOL :MATH:FFT:HSCale Syntax :MATH:FFT:HSCale <hsc> :MATH:FFT:HSCale? Description Set or query the horizontal scale of the FFT operation result. The default unit is Hz. Parameter Name Type Range Default <hsc> Refer to Explanation Real 5MHz Explanation <hsc> can be set to 1/1000, 1/400, 1/200, 1/100, 1/40, or 1/20 of the FFT sample ...
Page 114: Math:fft:hcenter
Chapter 2 Command System RIGOL :MATH:FFT:HCENter Syntax :MATH:FFT:HCENter <cent> :MATH:FFT:HCENter? Description Set or query the center frequency of the FFT operation result, namely the frequency relative to the horizontal center of the screen. The default unit is Hz. Parameter Name...
Page 115: Math:filter:type
Chapter 2 Command System RIGOL :MATH:FILTer:TYPE Syntax :MATH:FILTer:TYPE <type> :MATH:FILTer:TYPE? Description Set or query the filter type. Parameter Name Type Range Default <type> Discrete {LPASs|HPASs|BPASs|BSTOP} LPASs Explanation MSO1000Z/DS1000Z provides 4 types of filters (Low Pass Filter, High Pass Filter, ...
Page 116: Math:filter:w1
Chapter 2 Command System RIGOL :MATH:FILTer:W1 Syntax :MATH:FILTer:W1 <freq1> :MATH:FILTer:W1? Description Set or query the cutoff frequency (ωc1) of the low pass/high pass filter or cutoff frequency 1 (ωc1) of the band pass/band stop filter. The default unit is Hz.
Page 117: Math:filter:w2
Chapter 2 Command System RIGOL :MATH:FILTer:W2 Syntax :MATH:FILTer:W2 <freq2> :MATH:FILTer:W2? Description Set or query the cutoff frequency 2 (ωc2) of the band pass/band stop filter. The default unit is Hz. Parameter Name Type Range Default <freq2> Real Refer to Explanation 0.1 x screen sample rate...
Page 118: Math:option:end
Chapter 2 Command System RIGOL :MATH:OPTion:END Syntax :MATH:OPTion:END <end> :MATH:OPTion:END? Description Set or query the end point of the waveform math operation. Parameter Name Type Range Default (Start point currently set+1) to 1199 <end> Discrete 1199 Explanation This command is invalid for the FFT operation. Sending this command will modify the ...
Page 119: Math:option:sensitivity
Chapter 2 Command System RIGOL :MATH:OPTion:SENSitivity Syntax :MATH:OPTion:SENSitivity <sens> :MATH:OPTion:SENSitivity? Description Set or query the sensitivity of the logic operation. The default unit is div (namely the current vertical scale). Parameter Name Type Range Default 0 to 0.96, the step is 0.08 <sens>...
Page 120: Math:option:ascale
Chapter 2 Command System RIGOL :MATH:OPTion:ASCale Syntax :MATH:OPTion:ASCale <bool> :MATH:OPTion:ASCale? Description Enable or disable the auto scale setting of the operation result or query the status of the auto scale setting. Parameter Name Type Range Default {{1|ON}|{0|OFF}} <bool> Bool 0|OFF...
Page 121: Math:option:threshold2
Chapter 2 Command System RIGOL :MATH:OPTion:THReshold2 Syntax :MATH:OPTion:THReshold2 <thre> :MATH:OPTion:THReshold2? Description Set or query the threshold level of source B in logic operations. The default unit is V. Parameter Name Type Range Default (-4 x VerticalScale - VerticalOffset) to <thre>...
Page 122: Math:option:fx:source2
Chapter 2 Command System RIGOL :MATH:OPTion:FX:SOURce2 Syntax :MATH:OPTion:FX:SOURce2 <src> :MATH:OPTion:FX:SOURce2? Description Set or query source B of the inner layer operation of compound operation. Parameter Name Type Range Default {CHANnel1|CHANnel2|CHANnel3|CHANnel4} <src> Discrete CHANnel1 Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
Page 123: Mask Commands
Chapter 2 Command System RIGOL :MASK Commands The :MASK commands are used to set and query the pass/fail test parameters. Command List: :MASK:ENABle  :MASK:SOURce  :MASK:OPERate  :MASK:MDISplay  :MASK:SOOutput  :MASK:OUTPut  :MASK:X  :MASK:Y  :MASK:CREate ...
Page 124: Mask:source
Chapter 2 Command System RIGOL :MASK:SOURce Syntax :MASK:SOURce <source> :MASK:SOURce? Description Set or query the source of the pass/fail test. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Explanation Only channels enabled can be selected as the source. You can sent :CHANnel<n>:DISPlay...
Page 125: Mask:mdisplay
Chapter 2 Command System RIGOL :MASK:MDISplay Syntax :MASK:MDISplay <bool> :MASK:MDISplay? Description Enable or disable the statistic information when the pass/fail test is enabled, or query the status of the statistic information. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF...
Page 126: Mask:output
Chapter 2 Command System RIGOL :MASK:OUTPut Syntax :MASK:OUTPut <bool> :MASK:OUTPut? Description Enable or disable the sound prompt when failed waveforms are detected, or query the status of the sound prompt. Parameter Name Type Range Default {{1|ON}|{0|OFF}} <bool> Bool 0|OFF Explanation OFF: when failed waveforms are detected, there are display and output but the ...
Page 127: Mask:create
Chapter 2 Command System RIGOL :MASK:CREate Syntax :MASK:CREate Description Create the pass/fail test mask using the current horizontal adjustment parameter and vertical adjustment parameter. Explanation This command is valid only when the pass/fail test is enabled (:MASK:ENABle) and is not in the run state (:MASK:OPERate).
Page 128: Measure Commands
Chapter 2 Command System RIGOL :MEASure Commands MSO1000Z/DS1000Z supports the auto measurement of the following 37 waveform parameters and provides the statistic function for the measurement results. In additional, you can use the frequency counter to make more precise frequency measurement. The :MEASure commands are used to set and query the measurement parameters.
Page 129 Chapter 2 Command System RIGOL -Pulses: The number of negative pulses that fall from above the threshold upper limit to below the threshold lower limit. -Pulses=n Threshold Upper Limit Threshold Lower Limit +Edges: The number of rising edges that rise from below the threshold lower limit to above the threshold upper limit.
Page 130 Chapter 2 Command System RIGOL Voltage Parameters Vmax: The voltage value from the highest point of the waveform to the GND. Vmin: The voltage value from the lowest point of the waveform to the GND. Vpp: The voltage value from the highest point to the lowest point of the waveform.
Page 131 Chapter 2 Command System RIGOL Other Parameters +Rate: Divide the difference of the upper value and lower value on the rising edge by the corresponding time. -Rate: Divide the difference of the lower value and upper value on the falling edge by the corresponding time.
Page 132: Measure:source
Chapter 2 Command System RIGOL :MEASure:SOURce Syntax :MEASure:SOURce <sour> :MEASure:SOURce? Description Set or query the source of the current measurement parameter. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8| <sour> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel1 CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Explanation Analog channels CH1 to CH4 can be selected no matter wether they are currently ...
Page 133: Measure:counter:value
Chapter 2 Command System RIGOL :MEASure:COUNter:VALue? Syntax :MEASure:COUNter:VALue? Description Query the measurement result of the frequency counter. The default unit is Hz. Return The query returns the measurement result in scientific notation. If the frequency counter Format is disabled, 0.0000000e+00 will be returned.
Page 134: Measure:adisplay
Chapter 2 Command System RIGOL :MEASure:ADISplay Syntax :MEASure:ADISplay <bool> :MEASure:ADISplay? Description Enable or disable the all measurement function, or query the status of the all measurement function. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Explanation The all measurement function can measure the following 29 parameters of the ...
Page 135: Measure:setup:max
Chapter 2 Command System RIGOL :MEASure:SETup:MAX Syntax :MEASure:SETup:MAX <value> :MEASure:SETup:MAX? Description Set or query the upper limit of the threshold (expressed in the percentage of amplitude) in time, delay, and phase measurements. Parameter Name Type Range Default <value> Integer 7 to 95...
Page 136: Measure:setup:min
Chapter 2 Command System RIGOL :MEASure:SETup:MIN Syntax :MEASure:SETup:MIN <value> :MEASure:SETup:MIN? Description Set or query the lower limit of the threshold (expressed in the percentage of amplitude) in time, delay, and phase measurements. Parameter Name Type Range Default <value> Integer 5 to 93...
Page 137: Measure:setup:psb
Chapter 2 Command System RIGOL :MEASure:SETup:PSB Syntax :MEASure:SETup:PSB <source> :MEASure:SETup:PSB? Description Set or query source B of Phase 1→2 and Phase 1→2 measurements. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8| <source> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel2 CHANnel1|CHANnel2|CHANnel3|CHANnel4} Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, Format D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Page 138: Measure:setup:dsb
Chapter 2 Command System RIGOL :MEASure:SETup:DSB Syntax :MEASure:SETup:DSB <source> :MEASure:SETup:DSB? Description Set or query source B of Delay 1→2 and Delay 1→2 measurements. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8| <source> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel2 CHANnel1|CHANnel2|CHANnel3|CHANnel4} Return The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, Format D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Page 139: Measure:statistic:mode
Chapter 2 Command System RIGOL :MEASure:STATistic:MODE Syntax :MEASure:STATistic:MODE <mode> :MEASure:STATistic:MODE? Description Set or query the statistic mode. Parameter Name Type Range Default <mode> Discrete {DIFFerence|EXTRemum} EXTRemum Explanation DIFFerence: select the difference mode. The statistic results contain the current  value, average value, standard deviation, and counts.
Page 140: Measure:statistic:item
Chapter 2 Command System RIGOL :MEASure:STATistic:ITEM Syntax :MEASure:STATistic:ITEM <item>[,<src>[,<src>]] :MEASure:STATistic:ITEM? <type>,<item>[,<src>[,<src>]] Description Enable the statistic function of any waveform parameter of the specified source, or query the statistic result of any waveform parameter of the specified source. Parameter Name Type...
Page 141: Measure:item
Chapter 2 Command System RIGOL :MEASure:ITEM Syntax :MEASure:ITEM <item>[,<src>[,<src>]] :MEASure:ITEM? <item>[,<src>[,<src>]] Description Measure any waveform parameter of the specified source, or query the measurement result of any waveform parameter of the specified source. Parameter Name Type Range Default {VMAX|VMIN|VPP|VTOP|VBASe|VAMP|VAVG| VRMS|OVERshoot|PREShoot|MARea|MPARea| PERiod|FREQuency|RTIMe|FTIMe|PWIDth| <item>...
Page 142: Reference Commands
Chapter 2 Command System RIGOL :REFerence Commands The :REFerence commands are used to set the reference waveform parameters. Command List: :REFerence:DISPlay  :REFerence<n>:ENABle  :REFerence<n>:SOURce  :REFerence<n>:VSCale  :REFerence<n>:VOFFset  :REFerence<n>:RESet  :REFerence<n>:CURRent  :REFerence<n>:SAVe  :REFerence<n>:COLor  :REFerence:DISPlay Syntax :REFerence:DISPlay <bool>...
Page 143: Reference:Source
Chapter 2 Command System RIGOL :REFerence<n>:SOURce Syntax :REFerence<n>:SOURce <source> :REFerence<n>:SOURce? Description Set or query the source of the current reference channel. Parameter Name Type Range Default <n> Discrete {1|2|3|4|5|6|7|8|9|10} {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| <source> Discrete D11|D12|D13|D14|D15|CHANnel1| CHANnel1 CHANnel2|CHANnel3|CHANnel4|MATH} Explanation Only channels currently enabled can be selected as the source of the current reference channel.
Page 144: Reference:Voffset
Chapter 2 Command System RIGOL :REFerence<n>:VOFFset Syntax :REFerence<n>:VOFFset <offset> :REFerence<n>:VOFFset? Description Set or query the vertical offset of the specified reference channel. The unit is the same as the unit of the source. Parameter Name Type Range Default <n> Discrete {1|2|3|4|5|6|7|8|9|10} <offset>...
Page 145: Reference:Save
Chapter 2 Command System RIGOL :REFerence<n>:SAVe Syntax :REFerence<n>:SAVe Description Store the waveform of the current reference channel to the internal memory as reference waveform. Parameter Name Type Range Default <n> Discrete {1|2|3|4|5|6|7|8|9|10} Related :REFerence<n>:CURRent Command :REFerence<n>:COLor Syntax :REFerence<n>:COLor <color> :REFerence<n>:COLor? Description Set or query the display color of the current reference channel.
Page 146: [:Source[]] Commands
Chapter 2 Command System RIGOL [:SOURce[<n>]] Commands The [:SOURce[<n>]] commands are used to set the parameters of the built-in signal source. <n> can be 1 or 2 which denotes the corresponding built-in signal source channel. When <n> or :SOURce[<n>] is omitted, the operation will be applied to source 1 by default.
Page 147: [:Source[]]:Output[][:State]
Chapter 2 Command System RIGOL [:SOURce[<n>]]:OUTPut[<n>][:STATe] Syntax [:SOURce[<n>]]:OUTPut[<n>][:STATe] <bool> [:SOURce[<n>]]:OUTPut[<n>][:STATe]? Description Turn on or off the output of the specified source channel, or query the status of the output of the specified source channel. Parameter Name Type Range Default If omitted, the operation is [<n>]...
Page 148: [:Source[]]:Frequency[:Fixed]
Chapter 2 Command System RIGOL [:SOURce[<n>]]:FREQuency[:FIXed] Syntax [:SOURce[<n>]]:FREQuency[:FIXed] <frequency> [:SOURce[<n>]]:FREQuency[:FIXed]? Description Set or query the output frequency of the specified source channel if the modulation is not enabled or the carrier frequency if the modulation is enabled. The default unit is Hz.
Page 149: [:Source[]]:Phase:initiate
Chapter 2 Command System RIGOL [:SOURce[<n>]]:PHASe:INITiate Syntax [:SOURce[<n>]]:PHASe:INITiate Description Execute the align phase operation. Parameter Name Type Range Default If omitted, the [<n>] Discrete {1|2} operation is performed on source 1 by default Explanation When the align phase operation is performed, the instrument re-configures the two channels to make them output with the specified frequency and phase.
Page 150: [:Source[]]:Function:ramp:symmetry
Chapter 2 Command System RIGOL [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry Syntax [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry <val> [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry? Description Set or query the ramp symmetry (the percentage that the rising period takes up in the whole period) of the specified source channel. Parameter Name Type Range Default If omitted, the operation is [<n>]...
Page 151: [:Source[]]:Voltage[:Level][:Immediate]:Offset
Chapter 2 Command System RIGOL [:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate]:OFFSet Syntax [:SOURce[<n>]]:VOLTage[:LEVel] [:IMMediate]:OFFSet <offset> [:SOURce[<n>]]:VOLTage[:LEVel] [:IMMediate]:OFFSet? Description Set or query the DC offset of the specified source channel. The default unit is V Parameter Name Type Range Default If omitted, the operation is [<n>]...
Page 152: [:Source[]]:Mod[:State]
Chapter 2 Command System RIGOL [:SOURce[<n>]]:MOD[:STATe] Syntax [:SOURce[<n>]]:MOD[:STATe] <bool> [:SOURce[<n>]]:MOD[:STATe]? Description Enable or disable the modulation of the specified source channel, or query the status of the modulation of the specified source channel. Parameter Name Type Range Default If omitted, the operation is [<n>]...
Page 153: [:Source[]]:Mod:am[:Depth]
Chapter 2 Command System RIGOL [:SOURce[<n>]]:MOD:AM[:DEPTh] Syntax [:SOURce[<n>]]:MOD:AM[:DEPTh] <depth> [:SOURce[<n>]]:MOD:AM[:DEPTh]? Description Set or query the AM modulation depth (indicates the amplitude variation degree and is expressed as a percentage) of the specified source channel. Parameter Name Type Range Default If omitted, the operation is [<n>]...
Page 154: [:Source[]]:Mod:am:internal:function
Chapter 2 Command System RIGOL [:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion [:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion Syntax [:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion <wave> [:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion? [:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion <wave> [:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion? Description Set or query the modulating waveform of AM or FM of the specified source channel. Parameter Name Type Range Default If omitted, the operation is [<n>]...
Page 155: [:Source[]]:Mod:fm[:Deviation]
Chapter 2 Command System RIGOL [:SOURce[<n>]]:MOD:FM[:DEVIation] Syntax [:SOURce[<n>]]:MOD:FM[:DEVIation] <dev> [:SOURce[<n>]]:MOD:FM[:DEVIation]? Description Set or query the FM frequency deviation of the specified source channel. The default unit is Hz. Parameter Name Type Range Default If omitted, the operation is [<n>] Discrete...
Page 156: [:Source[]]:Apply:noise
Chapter 2 Command System RIGOL [:SOURce[<n>]]:APPLy:NOISe [:SOURce[<n>]]:APPLy:PULSe [:SOURce[<n>]]:APPLy:RAMP [:SOURce[<n>]]:APPLy:SINusoid [:SOURce[<n>]]:APPLy:SQUare [:SOURce[<n>]]:APPLy:USER Syntax [:SOURce[<n>]]:APPLy:NOISe [<amp>[,<offset>]] [:SOURce[<n>]]:APPLy:PULSe [<freq>[,<amp>[,<offset>[,<phase>]]]] [:SOURce[<n>]]:APPLy:RAMP [<freq>[,<amp>[,<offset>[,<phase>]]]] [:SOURce[<n>]]:APPLy:SINusoid [<freq>[,<amp>[,<offset>[,<phase>]]]] [:SOURce[<n>]]:APPLy:SQUare [<freq>[,<amp>[,<offset>[,<phase>]]]] [:SOURce[<n>]]:APPLy:USER [<freq>[,<amp>[,<offset>[,<phase>]]]] Description Configure the specified source channel to output a signal with the specified waveform and parameters.
Page 157 Chapter 2 Command System RIGOL Users can omit one or multiple parameters. When all of the parameters are omitted,  the commands only select the waveform shape but do not modify the parameters. The four parameters (<freq>, <amp>, <offset>, and <phase>) are in order. You ...
Page 158: Storage Commands
Chapter 2 Command System RIGOL :STORage Commands The :STORage commands are used to set the related parameters when storing images. Command List: :STORage:IMAGe:TYPE  :STORage:IMAGe:INVERT  :STORage:IMAGe:COLor  :STORage:IMAGe:TYPE Syntax :STORage:IMAGe:TYPE <type> :STORage:IMAGe:TYPE? Description Set or query the image type when storing images.
Page 159: Storage:image:color
Chapter 2 Command System RIGOL :STORage:IMAGe:COLor Syntax :STORage:IMAGe:COLor <bool> :STORage:IMAGe:COLor? Description Set the image color when storing images to color (ON) or intensity graded color (OFF); or query the image color when storing images. Parameter Name Type Range Default <bool>...
Page 160: System Commands
Chapter 2 Command System RIGOL :SYSTem Commands The :SYSTem commands are used to set the system-related parameters, such as the sound and language. Command List: :SYSTem:AUToscale  :SYSTem:BEEPer  :SYSTem:ERRor[:NEXT]?  :SYSTem:GAM?  :SYSTem:LANGuage  :SYSTem:LOCKed  :SYSTem:PON  :SYSTem:OPTion:INSTall ...
Page 161: System:beeper
Chapter 2 Command System RIGOL :SYSTem:BEEPer Syntax :SYSTem:BEEPer <bool> :SYSTem:BEEPer? Description Enable or disable the beeper, or query the status of the beeper. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} Return The query returns 1 or 0. Format Example...
Page 162: System:locked
To install an option, you need to order the option to obtain the corresponding key.  Then, use the key to acquire the option license by following the steps below. Log in RIGOL official website (www.rigol.com); click SERVICE  Software  License Register to enter the product license register interface.
Page 163: System:option:uninstall
Chapter 2 Command System RIGOL :SYSTem:OPTion:UNINSTall Syntax :SYSTem:OPTion:UNINSTall Description Uninstall the options installed. :SYSTem:RAM? Syntax :SYSTem:RAM? Description Query the number of analog channels of the instrument. Return The query always returns 4. Format :SYSTem:SETup Syntax :SYSTem:SETup <setup_stream> :SYSTem:SETup? Description Import the setting parameters of the oscilloscope to restore the oscilloscope to the specified setting.
Page 164: [:Trace[]] Commands
Chapter 2 Command System RIGOL [:TRACe[<n>]] Commands The [:TRACe[<n>]] commands are used to set the arbitrary waveform parameters of the built-in signal sources. <n> can be 1 or 2 which denotes the corresponding built-in signal source channel. If <n> or :TRACe[<n>] is omitted, the operation will be applied to source 1 by default. These commands are only applicable to models with source channels of MSO1000Z/DS1000Z series.
Page 165: [:Trace[]]:Data:dac16
Chapter 2 Command System RIGOL [:TRACe[<n>]]:DATA:DAC16 Syntax [:TRACe[<n>]]:DATA:DAC16 volatile,<flag>,<binary_block_data> Description Download binary data block to the volatile memory of the specified signal source. Parameter Name Type Range Default <n> Discrete {1|2} <flag> Discrete {END} <binary_block_data> Refer to Explanation Explanation This command consists of two parts: the command string ...
Page 166: [:Trace[]]:Data:dac
Chapter 2 Command System RIGOL [:TRACe[<n>]]:DATA:DAC Syntax [:TRACe[<n>]]:DATA:DAC volatile,[<binary_block_data>|<value>,<value>,<value>...] Description Download binary data block or decimal waveform values to the volatile memory of the specified signal source. Parameter Name Type Range Default <n> Discrete {1|2} <binary_block_data> Refer to Explanation <value>...
Page 167: [:Trace[]]:Data:points
Chapter 2 Command System RIGOL [:TRACe[<n>]]:DATA:POINts Syntax [:TRACe[<n>]]:DATA:POINts volatile,<data> [:TRACe[<n>]]:DATA:POINts? volatile Description Set or query the initial number of points of the arbitrary waveform of the specified signal source channel. Parameter Name Type Range Default <n> Discrete {1|2} <data> Integer...
Page 168: [:Trace[]]:Data:value
Chapter 2 Command System RIGOL [:TRACe[<n>]]:DATA:VALue Syntax [:TRACe[<n>]]:DATA:VALue volatile,<points>,<data> [:TRACe[<n>]]:DATA:VALue? volatile,<points> Description Modify or query the decimal value of the specified point in the volatile memory of the specified signal source. Parameter Name Type Range Default <n> Discrete {1|2} <points>...
Page 169: Timebase Commands
Chapter 2 Command System RIGOL :TIMebase Commands The :TIMebase commands are used to set the horizontal parameters, such as enabling the delayed sweep and setting the horizontal timebase mode. Command List: :TIMebase:DELay:ENABle  :TIMebase:DELay:OFFSet  :TIMebase:DELay:SCALe  :TIMebase[:MAIN]:OFFSet  :TIMebase[:MAIN]:SCALe ...
Page 170: Timebase:delay:offset
Chapter 2 Command System RIGOL :TIMebase:DELay:OFFSet Syntax :TIMebase:DELay:OFFSet <offset> :TIMebase:DELay:OFFSet? Description Set or query the delayed timebase offset. The default unit is s. Parameter Name Type Range Default -(LeftTime - DelayRange/2) to <offset> Real (RightTime - DelayRange/2) Explanation LeftTime = 6 x MainScale - MainOffset...
Page 171: Timebase:delay:scale
Chapter 2 Command System RIGOL :TIMebase:DELay:SCALe Syntax :TIMebase:DELay:SCALe <scale> :TIMebase:DELay:SCALe? Description Set or query the delayed timebase scale. The default unit is s/div. Parameter Name Type Range Default <scale> Real Refer to Explanation 500ns/div Explanation The maximum value of <scale> is the main timebase scale currently set, and ...
Page 172: Timebase[:Main]:Offset
Chapter 2 Command System RIGOL Related :TIMebase[:MAIN]:SCALe Commands :ACQuire:SRATe? :TRIGger:MODE :TIMebase[:MAIN]:OFFSet Syntax :TIMebase[:MAIN]:OFFSet <offset> :TIMebase[:MAIN]:OFFSet? Description Set or query the main timebase offset. The default unit is s. Parameter Name Type Range Default Refer to Explanation <offset> Real Explanation The range of <offset> is related to the current mode of the horizontal ...
Page 173: Timebase[:Main]:Scale
Chapter 2 Command System RIGOL :TIMebase[:MAIN]:SCALe Syntax :TIMebase[:MAIN]:SCALe <scale> :TIMebase[:MAIN]:SCALe? Description Set or query the main timebase scale. The default unit is s/div. Parameter Name Type Range Default YT mode: 5ns/div to 50s/div in 1-2-5 step <scale> Real 1μs/div Roll mode: 200ms/div to 50s/div in 1-2-5 step...
Page 174: Trigger Commands
Chapter 2 Command System RIGOL :TRIGger Commands The :TRIGger commands are used to set the trigger system of the oscilloscope. Command List: :TRIGger:MODE  :TRIGger:COUPling  :TRIGger:STATus?  :TRIGger:SWEep  :TRIGger:HOLDoff  :TRIGger:NREJect  :TRIGger:POSition?  :TRIGger:EDGe  :TRIGger:PULSe ...
Page 175: Trigger:coupling
Chapter 2 Command System RIGOL :TRIGger:COUPling Syntax :TRIGger:COUPling <couple> :TRIGger:COUPling? Description Select or query the trigger coupling type. Parameter Name Type Range Default <couple> Discrete {AC|DC|LFReject|HFReject} Explanation This command is only applicable to edge trigger of which the signal source is an ...
Page 176: Trigger:holdoff
Chapter 2 Command System RIGOL :TRIGger:HOLDoff Syntax :TRIGger:HOLDoff <value> :TRIGger:HOLDoff? Description Set or query the trigger holdoff time. The default unit is s. Parameter Name Type Range Default <value> Real 16ns to 10s 16ns Explanation Trigger holdoff can be used to stably trigger the complex waveforms (such as pulse ...
Page 177: Trigger:position
Chapter 2 Command System RIGOL :TRIGger:POSition? Syntax :TRIGger:POSition? Description Query the position in the internal memory that corresponds to the waveform trigger position. Return The query returns an integer. Format -2 denotes that the instrument is not triggered and there is no trigger position.
Page 178: Trigger:edge
Chapter 2 Command System RIGOL :TRIGger:EDGe Command List: :TRIGger:EDGe:SOURce  :TRIGger:EDGe:SLOPe  :TRIGger:EDGe:LEVel  :TRIGger:EDGe:SOURce Syntax :TRIGger:EDGe:SOURce <source> :TRIGger:EDGe:SOURce? Description Set or query the trigger source in edge trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8| <source> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel1 CHANnel1|CHANnel2|CHANnel3|CHANnel4|AC} Explanation When one or more of channels D0 to D7 is turned on, CH4 cannot be selected;...
Page 179 Chapter 2 Command System RIGOL :TRIGger:EDGe:LEVel Syntax :TRIGger:EDGe:LEVel <level> :TRIGger:EDGe:LEVel? Description Set or query the trigger level in edge trigger. The unit is the same as the current amplitude unit of the signal source selected. Parameter Name Type Range Default (-5 x VerticalScale - OFFSet) to <level>...
Page 180: Trigger:pulse
Chapter 2 Command System RIGOL :TRIGger:PULSe Command List: :TRIGger:PULSe:SOURce  :TRIGger:PULSe:WHEN  :TRIGger:PULSe:WIDTh  :TRIGger:PULSe:UWIDth  :TRIGger:PULSe:LWIDth  :TRIGger:PULSe:LEVel  :TRIGger:PULSe:SOURce Syntax :TRIGger:PULSe:SOURce <source> :TRIGger:PULSe:SOURce? Description Set or query the trigger source in pulse width trigger. Parameter Name Type Range...
Page 181 Chapter 2 Command System RIGOL :TRIGger:PULSe:WHEN Syntax :TRIGger:PULSe:WHEN <when> :TRIGger:PULSe:WHEN? Description Set or query the trigger condition in pulse width trigger. Parameter Name Type Range Default {PGReater|PLESs|NGReater| <when> Discrete PGReater NLESs|PGLess|NGLess} Explanation PGReater/PLESs: you need to specify a pulse width (refer ...
Page 182 Chapter 2 Command System RIGOL :TRIGger:PULSe:UWIDth Syntax :TRIGger:PULSe:UWIDth <width> :TRIGger:PULSe:UWIDth? Description Set or query the upper pulse width in pulse width trigger. The default unit is s. Parameter Name Type Range Default <width> Real 16ns to 10s 2μs Explanation This command is available when the trigger condition (refer to :TRIGger:PULSe:WHEN) is PGLess and NGLess.
Page 183 Chapter 2 Command System RIGOL :TRIGger:PULSe:LEVel Syntax :TRIGger:PULSe:LEVel <level> :TRIGger:PULSe:LEVel? Description Set or query the trigger level in pulse width trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default (-5 x VerticalScale - OFFSet) to <level>...
Page 184: Trigger:slope
Chapter 2 Command System RIGOL :TRIGger:SLOPe Command List: :TRIGger:SLOPe:SOURce  :TRIGger:SLOPe:WHEN  :TRIGger:SLOPe:TIME  :TRIGger:SLOPe:TUPPer  :TRIGger:SLOPe:TLOWer  :TRIGger:SLOPe:WINDow  :TRIGger:SLOPe:ALEVel  :TRIGger:SLOPe:BLEVel  :TRIGger:SLOPe:SOURce Syntax :TRIGger:SLOPe:SOURce <source> :TRIGger:SLOPe:SOURce? Description Set or query the trigger source in slope trigger. Parameter...
Page 185 Chapter 2 Command System RIGOL :TRIGger:SLOPe:WHEN Syntax :TRIGger:SLOPe:WHEN <when> :TRIGger:SLOPe:WHEN? Description Set or query the trigger condition in slope trigger. Parameter Name Type Range Default {PGReater|PLESs|NGReater| <when> Discrete PGReater NLESs|PGLess|NGLess} Explanation PGReater/PLESs: you need to specify a time value (refer to :TRIGger:SLOPe:TIME).
Page 186 Chapter 2 Command System RIGOL :TRIGger:SLOPe:TUPPer Syntax :TRIGger:SLOPe:TUPPer <time> :TRIGger:SLOPe:TUPPer? Description Set or query the upper limit of the time in slope trigger. The default unit is s. Parameter Name Type Range Default <time> Real 16ns to 10s 2μs Explanation This command is available when the trigger condition (refer to :TRIGger:SLOPe:WHEN) is PGLess and NGLess.
Page 187 Chapter 2 Command System RIGOL :TRIGger:SLOPe:WINDow Syntax :TRIGger:SLOPe:WINDow <window> :TRIGger:SLOPe:WINDow? Description Set or query the vertical window type in slope trigger. Parameter Name Type Range Default <window> Discrete {TA|TB|TAB} Explanation TA: only adjust the upper limit of the trigger level, refer to :TRIGger:SLOPe:ALEVel.
Page 188 Chapter 2 Command System RIGOL :TRIGger:SLOPe:BLEVel Syntax :TRIGger:SLOPe:BLEVel <level> :TRIGger:SLOPe:BLEVel? Description Set or query the lower limit of the trigger level in slope trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default (-5 x VerticalScale - OFFSet) to <level>...
Page 189: Trigger:video
Chapter 2 Command System RIGOL :TRIGger:VIDeo Command List: :TRIGger:VIDeo:SOURce  :TRIGger:VIDeo:POLarity  :TRIGger:VIDeo:MODE  :TRIGger:VIDeo:LINE  :TRIGger:VIDeo:STANdard  :TRIGger:VIDeo:LEVel  :TRIGger:VIDeo:SOURce Syntax :TRIGger:VIDeo:SOURce <source> :TRIGger:VIDeo:SOURce? Description Select or query the trigger source in video trigger. Parameter Name Type Range Default <source>...
Page 190 Chapter 2 Command System RIGOL :TRIGger:VIDeo:MODE Syntax :TRIGger:VIDeo:MODE <mode> :TRIGger:VIDeo:MODE? Description Set or query the sync type in video trigger. Parameter Name Type Range Default <mode> Discrete {ODDField|EVENfield|LINE|ALINes} ALINes Explanation ODDField: trigger on the rising edge of the first ramp waveform pulse in the odd ...
Page 191 Chapter 2 Command System RIGOL :TRIGger:VIDeo:STANdard Syntax :TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard? Description Set or query the video standard in video trigger. Parameter Name Type Range Default <standard> Discrete {PALSecam|NTSC|480P|576P} NTSC Explanation PALSecam:  PAL: the frame frequency is 25 frames per second. The TV sweep line is 625 with the odd field goes first and the even field follows behind.
Page 192: Trigger:pattern
Chapter 2 Command System RIGOL :TRIGger:PATTern Command List: :TRIGger:PATTern:PATTern  :TRIGger:PATTern:LEVel  2-176 MSO1000Z/DS1000Z Programming Guide...
Page 193 Chapter 2 Command System RIGOL :TRIGger:PATTern:PATTern Syntax :TRIGger:PATTern:PATTern <pa_ch1>[,<pa_ch2>[,<pa_ch3> [,<pa_ch4>[,<pa_d0>…[,<pa_d15>]]]]] :TRIGger:PATTern:PATTern? Description Set or query the pattern of each channel in pattern trigger. Parameter Name Type Range Default <pa_ch1> Discrete {H|L|X|R|F} <pa_ch2> Discrete {H|L|X|R|F} <pa_ch3> Discrete {H|L|X|R|F} <pa_ch4> Discrete {H|L|X|R|F} <pa_d0>...
Page 194 Chapter 2 Command System RIGOL :TRIGger:PATTern:LEVel Syntax :TRIGger:PATTern:LEVel <chan>,<level> :TRIGger:PATTern:LEVel? <chan> Description Set or query the trigger level of the specified channel in pattern trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default <chan>...
Page 195: Trigger:duration
Chapter 2 Command System RIGOL :TRIGger:DURATion Command List: :TRIGger:DURATion:SOURce  :TRIGger:DURATion:TYPe  :TRIGger:DURATion:WHEN  :TRIGger:DURATion:TUPPer  :TRIGger:DURATion:TLOWer  :TRIGger:DURATion:SOURce Syntax :TRIGger:DURATion:SOURce <source> :TRIGger:DURATion:SOURce? Description Set or query the trigger source in duration trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8| <source>...
Page 196 Chapter 2 Command System RIGOL :TRIGger:DURATion:TYPe Syntax :TRIGger:DURATion:TYPe <type_ch1>[,<type_ch2>[,<type_ch3> [,<type_ch4>[,<type_d0>…[,<type_d15>]]]]] :TRIGger:DURATion:TYPe? Description Set or query the pattern of each channel in duration trigger. Parameter Name Type Range Default <type_ch1> Discrete {H|L|X} <type_ch2> Discrete {H|L|X} <type_ch3> Discrete {H|L|X} <type_ch4> Discrete {H|L|X} <type_d0>...
Page 197 Chapter 2 Command System RIGOL :TRIGger:DURATion:WHEN Syntax :TRIGger:DURATion:WHEN <when> :TRIGger:DURATion:WHEN? Description Set or query the trigger condition in duration trigger. Parameter Name Type Range Default <when> Discrete {GREater|LESS|GLESs} GREater Explanation GREater: you need to specify a time (refer to :TRIGger:DURATion:TLOWer). The ...
Page 198 Chapter 2 Command System RIGOL :TRIGger:DURATion:TLOWer Syntax :TRIGger:DURATion:TLOWer <NR3> :TRIGger:DURATion:TLOWer? Description Set or query the duration time lower limit in duration trigger. The default unit is s. Parameter Name Type Range Default <NR3> Real 8ns to 9.99s 1μs Explanation This command is available when the trigger condition (:TRIGger:DURATion:WHEN) is GREater or GLESs.
Page 199: Trigger:timeout
Chapter 2 Command System RIGOL :TRIGger:TIMeout Command List: :TRIGger:TIMeout:SOURce  :TRIGger:TIMeout:SLOPe  :TRIGger:TIMeout:TIMe  :TRIGger:TIMeout:SOURce Syntax :TRIGger:TIMeout:SOURce <source> :TRIGger:TIMeout:SOURce? Description Set or query the trigger source in timeout trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8| <source> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel1 CHANnel1|CHANnel2|CHANnel3|CHANnel4} Explanation When one or more of channels D0 to D7 is turned on, CH4 cannot be selected;...
Page 200 Chapter 2 Command System RIGOL :TRIGger:TIMeout:TIMe Syntax :TRIGger:TIMeout:TIMe <NR3> :TRIGger:TIMeout:TIMe? Description Set or query the timeout time in timeout trigger. The default unit is s. Parameter Name Type Range Default <NR3> Real 16ns to 10s 16ns Return The query returns the timeout time in scientific notation.
Page 201: Trigger:runt
Chapter 2 Command System RIGOL :TRIGger:RUNT Command List: :TRIGger:RUNT:SOURce  :TRIGger:RUNT:POLarity  :TRIGger:RUNT:WHEN  :TRIGger:RUNT:WUPPer  :TRIGger:RUNT:WLOWer  :TRIGger:RUNT:ALEVel  :TRIGger:RUNT:BLEVel  :TRIGger:RUNT:SOURce Syntax :TRIGger:RUNT:SOURce <source> :TRIGger:RUNT:SOURce? Description Set or query the trigger source in runt trigger. Parameter Name Type...
Page 202 Chapter 2 Command System RIGOL :TRIGger:RUNT:WHEN Syntax :TRIGger:RUNT:WHEN <when> :TRIGger:RUNT:WHEN? Description Set or query the qualifier in runt trigger. Parameter Name Type Range Default <when> Discrete {NONE|GREater|LESS|GLESs} NONE Explanation NONE: do not set the trigger condition in runt trigger. ...
Page 203 Chapter 2 Command System RIGOL :TRIGger:RUNT:WLOWer Syntax :TRIGger:RUNT:WLOWer <NR3> :TRIGger:RUNT:WLOWer? Description Set or query the pulse width lower limit in runt trigger. The default unit is s. Parameter Name Type Range Default When the qualifier is GREater, the range is from 8ns to <NR3>...
Page 204 Chapter 2 Command System RIGOL :TRIGger:RUNT:BLEVel Syntax :TRIGger:RUNT:BLEVel <level> :TRIGger:RUNT:BLEVel? Description Set or query the trigger level lower limit in runt trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default (-5 x VerticalScale - OFFSet) to <level>...
Page 205: Trigger:windows
Chapter 2 Command System RIGOL :TRIGger:WINDows Command List: :TRIGger:WINDows:SOURce  :TRIGger:WINDows:SLOPe  :TRIGger:WINDows:POSition  :TRIGger:WINDows:TIMe  :TRIGger:WINDows:ALEVel  :TRIGger:WINDows:BLEVel  :TRIGger:WINDows:SOURce Syntax :TRIGger:WINDows:SOURce <source> :TRIGger:WINDows:SOURce? Description Set or query the trigger source in windows trigger. Parameter Name Type Range Default <source>...
Page 206 Chapter 2 Command System RIGOL :TRIGger:WINDows:POSition Syntax :TRIGger:WINDows:POSition <pos> :TRIGger:WINDows:POSition? Description Set or query the trigger position in windows trigger. Parameter Name Type Range Default <type> Discrete {EXIT|ENTER|TIMe} ENTER Explanation EXIT: trigger when the input signal exits the specified trigger level range.
Page 207 Chapter 2 Command System RIGOL :TRIGger:WINDows:ALEVel Syntax :TRIGger:WINDows:ALEVel <level> :TRIGger:WINDows:ALEVel? Description Set or query the trigger level upper limit in windows trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default (-5 x VerticalScale - OFFSet) to <level>...
Page 208: Trigger:delay
Chapter 2 Command System RIGOL :TRIGger:DELay Command List: :TRIGger:DELay:SA  :TRIGger:DELay:SLOPA  :TRIGger:DELay:SB  :TRIGger:DELay:SLOPB  :TRIGger:DELay:TYPe  :TRIGger:DELay:TUPPer  :TRIGger:DELay:TLOWer  :TRIGger:DELay:SA Syntax :TRIGger:DELay:SA <Source> :TRIGger:DELay:SA? Description Set or query the trigger source A in delay trigger. Parameter Name...
Page 209 Chapter 2 Command System RIGOL :TRIGger:DELay:SB Syntax :TRIGger:DELay:SB <source> :TRIGger:DELay:SB? Description Set or query the trigger source B in delay trigger. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel2 Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4. Format...
Page 210 Chapter 2 Command System RIGOL :TRIGger:DELay:TYPe Syntax :TRIGger:DELay:TYPe <type> :TRIGger:DELay:TYPe? Description Set or query the delay type in delay trigger. Parameter Name Type Range Default <type> Discrete {GREater|LESS|GLESs |GOUT} GREater Explanation GREater: trigger when the time difference (△T) between the specified edges of tigger ...
Page 211 Chapter 2 Command System RIGOL :TRIGger:DELay:TLOWer Syntax :TRIGger:DELay:TLOWer <NR3> :TRIGger:DELay:TLOWer? Description Set or query the lower limit of the delay time in delay trigger. The default unit is s. Parameter Name Type Range Default Related to the delay type <NR3>...
Page 212: Trigger:shold
Chapter 2 Command System RIGOL :TRIGger:SHOLd Command List: :TRIGger:SHOLd:DSrc  :TRIGger:SHOLd:CSrc  :TRIGger:SHOLd:SLOPe  :TRIGger:SHOLd:PATTern  :TRIGger:SHOLd:TYPe  :TRIGger:SHOLd:STIMe  :TRIGger:SHOLd:HTIMe  :TRIGger:SHOLd:DSrc Syntax :TRIGger:SHOLd:DSrc <source> :TRIGger:SHOLd:DSrc? Description Set or query the data source in setup/hold trigger. Parameter Name Type...
Page 213 Chapter 2 Command System RIGOL :TRIGger:SHOLd:SLOPe Syntax :TRIGger:SHOLd:SLOPe <slope> :TRIGger:SHOLd:SLOPe? Description Set or query the edge type in setup/hold trigger. Parameter Name Type Range Default <slope> Discrete {POSitive|NEGative} POSitive Return The query returns POS or NEG. Format Example :TRIGger:SHOLd:SLOPe NEGative...
Page 214 Chapter 2 Command System RIGOL :TRIGger:SHOLd:STIMe Syntax :TRIGger:SHOLd:STIMe <NR3> :TRIGger:SHOLd:STIMe? Description Set or query the setup time in setup/hold trigger. The default unit is s. Parameter Name Type Range Default <NR3> Real 8ns to 1s 1μs Explanation Setup time refers to the period of time that the data stays stable and constant before ...
Page 215: Trigger:nedge
Chapter 2 Command System RIGOL :TRIGger:NEDGe Command List: :TRIGger:NEDGe:SOURce  :TRIGger:NEDGe:SLOPe  :TRIGger:NEDGe:IDLE  :TRIGger:NEDGe:EDGE  :TRIGger:NEDGe:LEVel  :TRIGger:NEDGe:SOURce Syntax :TRIGger:NEDGe:SOURce <source> :TRIGger:NEDGe:SOURce? Description Set or query the trigger source in Nth edge trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8| <source>...
Page 216 Chapter 2 Command System RIGOL :TRIGger:NEDGe:IDLE Syntax :TRIGger:NEDGe:IDLE <NR3> :TRIGger:NEDGe:IDLE? Description Set or query the idle time in Nth edge trigger. The default unit is s. Parameter Name Type Range Default <NR3> Real 16ns to 10s 1μs Return Format The query returns the idle time in scientific notation.
Page 217: Trigger:rs232
Chapter 2 Command System RIGOL :TRIGger:RS232 Command List: :TRIGger:RS232:SOURce  :TRIGger:RS232:WHEN  :TRIGger:RS232:PARity  :TRIGger:RS232:STOP  :TRIGger:RS232:DATA  :TRIGger:RS232:WIDTh  :TRIGger:RS232:BAUD  :TRIGger:RS232:BUSer  :TRIGger:RS232:LEVel  :TRIGger:RS232:SOURce Syntax :TRIGger:RS232:SOURce <source> :TRIGger:RS232:SOURce? Description Set or query the trigger source in RS232 trigger.
Page 218 Chapter 2 Command System RIGOL :TRIGger:RS232:WHEN Syntax :TRIGger:RS232:WHEN <when> :TRIGger:RS232:WHEN? Description Set or query the trigger condition in RS232 trigger. Parameter Name Type Range Default <when> Discrete {STARt|ERRor|PARity|DATA} STARt Explanation STARt: trigger on the start frame position.  ERRor: trigger when error frame is detected.
Page 219 Chapter 2 Command System RIGOL :TRIGger:RS232:STOP Syntax :TRIGger:RS232:STOP <bit> :TRIGger:RS232:STOP? Description Set or query the stop bit when the trigger condition is ERRor in RS232 trigger. Parameter Name Type Range Default <bit> Discrete {1|2} Return Format The query returns 1 or 2.
Page 220 Chapter 2 Command System RIGOL :TRIGger:RS232:BAUD Syntax :TRIGger:RS232:BAUD <baud_rate> :TRIGger:RS232:BAUD? Description Set or query the baud rate in RS232 trigger. The default unit is bps. Parameter Name Type Range Default {2400|4800|9600|19200|38400|57600| <baud_rate> Discrete 115200|230400|460800|921600|1000000| 9600 USER} Return Format The query returns an integer or USER.
Page 221 Chapter 2 Command System RIGOL :TRIGger:RS232:LEVel Syntax :TRIGger:RS232:LEVel <level> :TRIGger:RS232:LEVel? Description Set or query the trigger level in RS232 trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default (-5 x VerticalScale - OFFSet) to <level>...
Page 222: Trigger:iic
Chapter 2 Command System RIGOL :TRIGger:IIC Command List: :TRIGger:IIC:SCL  :TRIGger:IIC:SDA  :TRIGger:IIC:WHEN  :TRIGger:IIC:AWIDth  :TRIGger:IIC:ADDRess  :TRIGger:IIC:DIRection  :TRIGger:IIC:DATA  :TRIGger:IIC:CLEVel  :TRIGger:IIC:DLEVel  :TRIGger:IIC:SCL Syntax :TRIGger:IIC:SCL <source> :TRIGger:IIC:SCL? Description Set or query the channel source of SCL in I2C trigger.
Page 223 Chapter 2 Command System RIGOL :TRIGger:IIC:WHEN Syntax :TRIGger:IIC:WHEN <trig_type> :TRIGger:IIC:WHEN? Description Set or query the trigger condition in I2C trigger. Parameter Name Type Range Default {STARt|RESTart|STOP|NACKnowledge| <trig_type> Discrete STARt ADDRess|DATA|ADATa} Explanation STARt: trigger when the SDA data transitions from high to low while the SCL is ...
Page 224 Chapter 2 Command System RIGOL :TRIGger:IIC:ADDRess Syntax :TRIGger:IIC:ADDRess <adr> :TRIGger:IIC:ADDRess? Description Set or query the address when the trigger condition is ADDRess or ADATa in I2C trigger. Parameter Name Type Range Default <adr> Integer 0 to 2 -1: 0 to 127, 0 to 255, or 0 to 1023...
Page 225 Chapter 2 Command System RIGOL :TRIGger:IIC:CLEVel Syntax :TRIGger:IIC:CLEVel <level> :TRIGger:IIC:CLEVel? Description Set or query the trigger level of SCL in I2C trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default (-5 x VerticalScale - OFFSet) to <level>...
Page 226: Trigger:spi
Chapter 2 Command System RIGOL :TRIGger:SPI Command List: :TRIGger:SPI:SCL  :TRIGger:SPI:SDA  :TRIGger:SPI:WHEN  :TRIGger:SPI:WIDTh  :TRIGger:SPI:DATA  :TRIGger:SPI:TIMeout  :TRIGger:SPI:SLOPe  :TRIGger:SPI:CLEVel  :TRIGger:SPI:DLEVel  :TRIGger:SPI:SLEVel  :TRIGger:SPI:MODE  :TRIGger:SPI:CS  :TRIGger:SPI:SCL Syntax :TRIGger:SPI:SCL <source> :TRIGger:SPI:SCL? Description Set or query the channel source of SCL in SPI trigger.
Page 227 Chapter 2 Command System RIGOL :TRIGger:SPI:SDA Syntax :TRIGger:SPI:SDA <source> :TRIGger:SPI:SDA? Description Set or query the channel source of SDA in SPI trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8| <source> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel2 CHANnel1|CHANnel2|CHANnel3|CHANnel4} Explanation When one or more of channels D0 to D7 is turned on, CH4 cannot be selected; when one or more of D8 to D15 is turned on, CH3 cannot be selected.
Page 228 Chapter 2 Command System RIGOL :TRIGger:SPI:DATA Syntax :TRIGger:SPI:DATA <data> :TRIGger:SPI:DATA? Description Set or query the data in SPI trigger. Parameter Name Type Range Default <data> Integer 0 to 2 Explanation The range of <data> is related to the data bits. The maximum data bits is 32. Thus, the range of <data>...
Page 229 Chapter 2 Command System RIGOL :TRIGger:SPI:CLEVel Syntax :TRIGger:SPI:CLEVel <level> :TRIGger:SPI:CLEVel? Description Set or query the trigger level of the SCL channel in SPI trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default (-5 x VerticalScale - OFFSet) to <level>...
Page 230 Chapter 2 Command System RIGOL :TRIGger:SPI:SLEVel Syntax :TRIGger:SPI:SLEVel <level> :TRIGger:SPI:SLEVel? Description Set or query the trigger level of the CS channel in SPI trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default (-5 x VerticalScale - OFFSet) to <level>...
Page 231 Chapter 2 Command System RIGOL :TRIGger:SPI:CS Syntax :TRIGger:SPI:CS <source> :TRIGger:SPI:CS? Description Set or query the data source of the CS signal in SPI trigger. Parameter Name Type Range Default {D0|D1|D2|D3|D4|D5|D6|D7|D8| <source> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel3 CHANnel1|CHANnel2|CHANnel3|CHANnel4} Explanation When one or more of channels D0 to D7 is turned on, CH4 cannot be selected; when one or more of D8 to D15 is turned on, CH3 cannot be selected.
Page 232: Waveform Commands
Chapter 2 Command System RIGOL :WAVeform Commands The :WAVeform commands are used to read the waveform data and its related settings. :WAVeform:MODE is used to set the reading mode of the waveform data. In different mode, the definition of each parameter is different, as shown in Figure 2-1 and Figure 2-2.
Page 233: Waveform:source
Chapter 2 Command System RIGOL Command List: :WAVeform:SOURce  :WAVeform:MODE  :WAVeform:FORMat  :WAVeform:DATA?  :WAVeform:XINCrement?  :WAVeform:XORigin?  :WAVeform:XREFerence?  :WAVeform:YINCrement?  :WAVeform:YORigin?  :WAVeform:YREFerence?  :WAVeform:STARt  :WAVeform:STOP  :WAVeform:PREamble?  :WAVeform:SOURce Syntax :WAVeform:SOURce <source> :WAVeform:SOURce? Description Set or query the channel of which the waveform data will be read.
Page 234: Waveform:mode
Chapter 2 Command System RIGOL :WAVeform:MODE Syntax :WAVeform:MODE <mode> :WAVeform:MODE? Description Set or query the reading mode used by :WAVeform:DATA?. Parameter Name Type Range Default <mode> Discrete {NORMal|MAXimum|RAW} NORMal Explanation NORMal: read the waveform data displayed on the screen. ...
Page 235: Waveform:data
Chapter 2 Command System RIGOL :WAVeform:DATA? Syntax :WAVeform:DATA? Description Read the waveform data. Explanation Reading procedures of the screen waveform data:  S1. :WAV:SOUR CHAN1 Set the channel source to CH1 S2. :WAV:MODE NORM Set the waveform reading mode to NORMal S3.
Page 236 Chapter 2 Command System RIGOL S4. :WAV:FORM BYTE Set the return format of the waveform data to BYTE S5. :WAV:STAR 1 Set the start point of waveform data reading to the first waveform point S6. :WAV:STOP 120000 Set the stop point of waveform data reading to the 120000th waveform point (the last point) S7.
Page 237 Chapter 2 Command System RIGOL S13. :WAV:DATA? Read the data from the 250001th waveform point to the 300000th waveform point (the last point) Finally, combine the data read in the 3 reading operations in sequence. Return The return format is related to the return format of the waveform data currently ...
Page 238: Waveform:xincrement
Chapter 2 Command System RIGOL :WAVeform:XINCrement? Syntax :WAVeform:XINCrement? Description Query the time difference between two neighboring points of the specified channel source in the X direction. Explanation The returned value is related to the current data reading mode:  In the NORMal mode, XINCrement = TimeScale/100.
Page 239: Waveform:xreference
Chapter 2 Command System RIGOL :WAVeform:XREFerence? Syntax :WAVeform:XREFerence? Description Query the reference time of the specified channel source in the X direction. Return The query returns 0 (namely the first point on the screen or in the internal memory). Format...
Page 240: Waveform:yreference
Chapter 2 Command System RIGOL :WAVeform:YREFerence? Syntax :WAVeform:YREFerence? Description Query the vertical reference position of the specified channel source in the Y direction. Explanation The return value is related to the current data reading mode: In NORMal mode, YREFerence is always 127 (the screen bottom is 0 and the screen top is 255).
Page 241: Waveform:stop
Chapter 2 Command System RIGOL :WAVeform:STOP Syntax :WAVeform:STOP <stop> :WAVeform:STOP? Description Set or query the stop point of waveform data reading. Parameter Name Type Range Default NORMal: 1 to 1200 MAX: 1 to the number of effective point <stop> Integer...
Page 242: Waveform:preamble
Chapter 2 Command System RIGOL :WAVeform:PREamble? Syntax :WAVeform:PREamble? Description Query and return all the waveform parameters. Return The query returns 10 waveform parameters separated by ",": Format <format>,<type>,<points>,<count>,<xincrement>,<xorigin>,<xreference>,<yincrem ent>,<yorigin>,<yreference> Wherein, <format>: 0 (BYTE), 1 (WORD) or 2 (ASC). <type>: 0 (NORMal), 1 (MAXimum) or 2 (RAW).
Page 243: Programming Demos
Chapter 3 Programming Demos RIGOL Chapter 3 Programming Demos This chapter lists some programming demos to illustrate how to use commands to realize the common functions of the oscilloscope in the development environments of Excel, Matlab, LabVIEW, Visual Basic 6.0 and Visual C++ 6.0.
Page 244: Programming Preparations
Before programming, you need to make the following preparations: First, install the Ultra Sigma common PC software. You can log in RIGOL official website (www.rigol.com) to download the software; then, install the software according to the instructions. When Ultra Sigma is installed, the NI-VISA library is installed automatically.
Page 245: Excel Programming Demo
Chapter 3 Programming Demos RIGOL Excel Programming Demo The program used in this demo: Microsoft Excel 2010 The function realized in this demo: send the *IDN? Command to read the device information. Create a new Excel file that enables the Macros. In this demo, the file is named as IDN.xlsm.
Page 246 Chapter 3 Programming Demos RIGOL Enter the VISA descriptor into a cell of the file as shown in the figure below. For example, the VISA descriptor is USB0::0x1AB1::0x04CE::DS1ZA160801111::INSTR. Input it into SHEET1.CELLS(1,2) (namely the B1 cell in Sheet1). Click the Developer menu and select the Visual Basic option to open the Microsoft Visual Basic.
Page 247 Chapter 3 Programming Demos RIGOL Explanation: If you cannot find the VISA Library in the list at the left of the figure above, please follow the method below to find it. (1) Make sure that your PC has installed the NI-VISA library.
Page 248 Chapter 3 Programming Demos RIGOL Add button control: click Insert in the Developer menu, select the desired button in Form Controls and put it into the cell of the Excel. At this point, the Assign Macro interface is displayed, select "Sheet1.QueryIdn"...
Page 249: Matlab Programming Demo
Chapter 3 Programming Demos RIGOL Matlab Programming Demo The program used in this demo: MATLAB R2009a The function realized in this demo: make FFT operation on the waveform data and draw the waveform. Run the Matlab software and modify the current directory (namely modify the Current Directory at the top of the software).
Page 250 Chapter 3 Programming Demos RIGOL Run the M file and the running result is as follows. MSO1000Z/DS1000Z Programming Guide...
Page 251: Labview Programming Demo
Chapter 3 Programming Demos RIGOL LabVIEW Programming Demo The program used in this demo: LabVIEW 2009 The functions realized in this demo: read the waveform data of CH1 on the screen. Run LabVIEW 2009, create a VI file and name it as MSO1000Z_Demo.
Page 252 Chapter 3 Programming Demos RIGOL Open the Block Diagram interface. Right-click on the VISA resource name and you can select and add the following functions from VISA Palette from the pop-up menu: VISA Write, VISA Read, VISA Open, and VISA Close.
Page 253 Chapter 3 Programming Demos RIGOL Get the length of the effective waveform data. Convert the character data into array format using the String To Byte Array, namely display the waveform data on the Waveform Graph control and then remove the TMC data header using the Array Subset function.
Page 254 Chapter 3 Programming Demos RIGOL Select the device resource from the VISA Resource Name list box and run the program. 3-12 MSO1000Z/DS1000Z Programming Guide...
Page 255: Visual Basic Programming Demo
Chapter 3 Programming Demos RIGOL Visual Basic Programming Demo The program used in this demo: Visual Basic 6.0 The function realized in this demo: control the on/off state of any channel. Enter Visual Basic 6.0 and operate according to the following steps: Build a standard application program project (Standard EXE) and name it as Demo.
Page 256 Chapter 3 Programming Demos RIGOL Dim matches As String * 200 ' keep the device number acquired Dim s32Disp As Integer ' acquire the usb source of visa Call viOpenDefaultRM(defrm) Call viFindRsrc(defrm, "USB?*", list, nmatches, matches) ' Open the device...
Page 257: Visual C++ Programming Demo
Chapter 3 Programming Demos RIGOL Visual C++ Programming Demo The program used in this demo: Microsoft Visual C++ 6.0 The functions realized in this demo: search for the instrument address, connect the instrument, send command and read the return value.
Page 258 Chapter 3 Programming Demos RIGOL Open the Directories tab in ToolsOptions. Select Include files in Show directories for and double-click the blank in Directories to add the path of Include: C:\Program Files\IVI Foundation\VISA\WinNT\include. Select Library files in Show directories for and double-click the blank in Directories to add the path of Lib: C:\Program Files\IVI Foundation\VISA\WinNT\lib\msc.
Page 259 Chapter 3 Programming Demos RIGOL Add the variables m_combox and m_receive for the Combo Box and Edit controls respectively. Add codes. Double-click Send and Read to enter the programming environment. Declare the #include <visa.h> of the visa library in the header file and then add the following codes.
Page 260 Chapter 3 Programming Demos RIGOL viFindRsrc(defaultRM, "USB?*", &list,&nmatches, matches); viOpen (defaultRM,matches,VI_NULL,VI_NULL,&vi); // Send the command received m_combox.GetLBText(m_combox.GetCurSel(),strTemp); strTemp = strTemp + "\n"; stringTemp = (char*)(LPCTSTR)strTemp; viPrintf (vi,stringTemp); // Read the result viScanf (vi, "%t\n", &buf); // Display the result UpdateData (TRUE);...

This manual is also suitable for:

Mso1074z-s Mso1074z Ds1000z series Ds1104z-s plus Ds1074z-s plus Mso1104z-s ... Show all

Rigol MSO1000Z Series Programming Manual

Guaranty and Declaration

Document Overview

Chapter 1 Programming Overview

Chapter 2 Command System

Chapter 3 Programming Demos

Quick Links

Need help?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Rigol MSO1000Z Series

Summary of Contents for Rigol MSO1000Z Series