User manual

ManualsBrandsRIGOL ManualsLaboratory Test EquipmentDigital 100 MHz 20-channel 500 null 3 null 8 Bit Digital storage (DSO), Mixed signal (MSO), Function g

RIGOL

Programming Guide

MSO1000Z/DS1000Z Series

Digital Oscilloscope

Dec. 2015

RIGOL TECHNOLOGIES, INC.

Summary of content (260 pages)

PAGE 1
RIGOL Programming Guide MSO1000Z/DS1000Z Series Digital Oscilloscope Dec. 2015 RIGOL TECHNOLOGIES, INC.
PAGE 2
PAGE 3
RIGOL Guaranty and Declaration Copyright © 2014 RIGOL TECHNOLOGIES, INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL TECHNOLOGIES, INC. Publication Number PGA19108-1110 Software Version 00.04.03.SP2 Software upgrade might change or add product features. Please acquire the latest version of the manual from RIGOL website or contact RIGOL to upgrade the software. Notices       RIGOL products are covered by P.R.C. and foreign patents, issued and pending.
PAGE 4
RIGOL Document Overview This manual provides guidance on how to use the SCPI commands in programming to realize remote control of RIGOL MSO1000Z/DS1000Z series digital oscilloscope through the remote interface. MSO1000Z/DS1000Z can communicate with a PC through the USB or the LAN bus. Main Topics in this Manual: Chapter 1 Programming Overview This chapter introduces how to build the remote communication between MSO1000Z/DS1000Z series digital oscilloscope and the PC.
PAGE 5
Contents RIGOL Contents Guaranty and Declaration ......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 Programming Overview......................................................................................1-1 To Build Remote Communication ....................................................................
PAGE 6
RIGOL Contents :DECoder:CONFig:LINE .............................................................................................. 2-42 :DECoder:CONFig:FORMat.......................................................................................... 2-42 :DECoder:CONFig:ENDian .......................................................................................... 2-43 :DECoder:CONFig:WIDth ............................................................................................
PAGE 7
Contents RIGOL :LA:POD:DISPlay ....................................................................................................... 2-86 :LA:POD:THReshold................................................................................................... 2-86 :LA:SIZE .......................................................................................................................... 2-87 :LA:STATe ...............................................................................................
PAGE 8
RIGOL Contents :MEASure:AMSource ....................................................................................................... 2-118 :MEASure:SETup:MAX ..................................................................................................... 2-119 :MEASure:SETup:MID ..................................................................................................... 2-119 :MEASure:SETup:MIN ..............................................................................................
PAGE 9
Contents RIGOL :SYSTem:LANGuage ....................................................................................................... 2-145 :SYSTem:LOCKed ........................................................................................................... 2-146 :SYSTem:PON ................................................................................................................ 2-146 :SYSTem:OPTion:INSTall .....................................................................................
PAGE 10
RIGOL Contents :WAVeform:PREamble? ................................................................................................... 2-226 Chapter 3 Programming Demos ......................................................................................... 3-1 Programming Preparations ......................................................................................................... 3-2 Excel Programming Demo .........................................................................................
PAGE 11
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
RIGOL Chapter 1 Programming Overview To Build Remote Communication This oscilloscope can communicate with a PC through the USB or the LAN bus. This section introduces how to control the oscilloscope remotely through the USB interface using Ultra Sigma in details. Operation Steps: 1. 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. 2.
PAGE 13
RIGOL Chapter 1 Programming Overview 3 4 5 6 MSO1000Z/DS1000Z Programming Guide 1-3
PAGE 14
RIGOL Chapter 1 Programming Overview 7 (3) Search for device resource Start up the Ultra Sigma and the software will automatically search for the instrument resources to search for the resources. currently connected to the PC. You can also click (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.
PAGE 15
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)). The SCPI commands provide a hierarchical tree structure and consist of multiple subsystems.
PAGE 16
RIGOL Chapter 1 Programming Overview The query returns 1 or 0. 2. Discrete The parameter could be any of the values listed. For example, :ACQuire:TYPE :ACQuire:TYPE? Wherein, can be set to NORMal|AVERages|PEAK|HRESolution. The query returns the abbreviations (NORM, AVER, PEAK, or HRES). 3. Integer Unless otherwise noted, the parameter can be any integer (NR1 format) within the effective value range. Note that do not set the parameter to a decimal, otherwise errors will occur.
PAGE 17
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  :ACQuire Commands  :CALibrate Commands  :CHANnel Commands  :CURSor Commands  :DECoder Commands  :DISPlay Commands  :ETABle Commands  :FUNCtion Commands (Option)  IEEE488.
PAGE 18
RIGOL Chapter 2 Command System :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
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 the :TRIGger:SWEep SINGle command. Explanation  In the single trigger mode, the oscilloscope triggers once when the trigger conditions are met and then stops.
PAGE 20
RIGOL Chapter 2 Command System :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.
PAGE 21
RIGOL Chapter 2 Command System :ACQuire:MDEPth Syntax :ACQuire:MDEPth :ACQuire:MDEPth? Description Parameter Explanation 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). Name Type Range Default Discrete Refer to Explanation AUTO  For the analog channel: ― When a single channel is enabled, the range of is {AUTO|12000| 120000|1200000|12000000|24000000}.
PAGE 22
RIGOL Chapter 2 Command System :ACQuire:TYPE Syntax :ACQuire:TYPE :ACQuire:TYPE? Description Parameter Explanation Return Format Example 2-6 Set or query the acquisition mode of the oscilloscope. Name Type Range Default Discrete {NORMal|AVERages|PEAK|HRESolution} NORMal  NORMal: in this mode, the oscilloscope samples the signal at equal time interval to rebuild the waveform. For most of the waveforms, the best display effect can be obtained using this mode.
PAGE 23
RIGOL Chapter 2 Command System :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.
PAGE 24
RIGOL Chapter 2 Command System :CALibrate Commands Command List:  :CALibrate:QUIT  :CALibrate:STARt :CALibrate:QUIT Syntax Description Related Command :CALibrate:QUIT Exit the self-calibration at any time. :CALibrate:STARt :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 working state to obtain the most accurate measurement values.
PAGE 25
RIGOL Chapter 2 Command System :CHANnel Commands The :CHANnel 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.
PAGE 26
RIGOL Chapter 2 Command System :CHANnel:COUPling Syntax :CHANnel:COUPling :CHANnel:COUPling? Description Parameter Explanation Return Format Example Set or query the coupling mode of the specified channel. Name Type Range Default Discrete {1|2|3|4} -- Discrete {AC|DC|GND} DC  AC: the DC components of the signal under test are blocked.  DC: the DC and AC components of the signal under test can both pass the channel.
PAGE 27
RIGOL Chapter 2 Command System :CHANnel:INVert Syntax :CHANnel:INVert :CHANnel:INVert? Description Parameter Explanation Return Format Example Enable or disable the waveform invert of the specified channel or query the status of the waveform invert of the specified channel.
PAGE 28
RIGOL Chapter 2 Command System :CHANnel:RANGe Syntax :CHANnel:RANGe :CHANnel:RANGe? Description Parameter Explanation Return Format Example 2-12 Set or query the vertical range of the specified channel. The default unit is V.
PAGE 29
RIGOL Chapter 2 Command System :CHANnel:TCAL Syntax :CHANnel:TCAL :CHANnel:TCAL? Description Parameter Explanation 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. Name Type Range Default Discrete {1|2|3|4} -- Real -100ns to 100ns 0.00s can only be set to the specific values in the specified step.
PAGE 30
RIGOL Chapter 2 Command System :CHANnel:SCALe Syntax :CHANnel:SCALe :CHANnel:SCALe? Description Parameter Set or query the vertical scale of the specified channel. The default unit is V.
PAGE 31
RIGOL Chapter 2 Command System :CHANnel:UNITs Syntax :CHANnel:UNITs :CHANnel:UNITs? Description Parameter Return Format Example Set or query the amplitude display unit of the specified channel. Name Type Range Default Discrete {1|2|3|4} -- Discrete {VOLTage|WATT|AMPere|UNKNown} VOLTage The query returns VOLT, WATT, AMP, or UNKN.
PAGE 32
RIGOL Chapter 2 Command System :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  :CURSor:AUTO  :CURSor:XY :CURSor:MODE Syntax :CURSor:MODE :CURSor:MODE? Description Parameter Explanation Return Format Example Related Commands Set or query the cursor measurement mode.
PAGE 33
RIGOL Chapter 2 Command System :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 :CURSor:MANua
PAGE 34
RIGOL Chapter 2 Command System :CURSor:MANual:SOURce Syntax :CURSor:MANual:SOURce :CURSor:MANual:SOURce? Description Parameter Explanation Return Format Example Set or query the channel source of the manual cursor measurement mode. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3| CHANnel4|MATH|LA} CHANnel1  Only the channel that is enabled currently can be selected.  When LA is selected, the cursor type cannot be set to Y (:CURSor:MANual:TYPE).
PAGE 35
RIGOL Chapter 2 Command System :CURSor:MANual:VUNit Syntax :CURSor:MANual:VUNit :CURSor:MANual:VUNit? Description Parameter Explanation Return Format Example Set or query the vertical unit in the manual cursor measurement mode. Name Type Range Default Discrete {PERCent|SOURce} SOURce  PERCent: AY, BY, and BY-AY in the measurement results are expressed in percentage.
PAGE 36
RIGOL Chapter 2 Command System :CURSor:MANual:BX Syntax :CURSor:MANual:BX :CURSor:MANual:BX? Description Parameter Explanation Return Format Example Set or query the horizontal position of cursor B in the manual cursor measurement mode. Name Type Range Default Integer 5 to 594 500 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 37
RIGOL Chapter 2 Command System :CURSor:MANual:BY Syntax :CURSor:MANual:BY :CURSor:MANual:BY? Description Parameter Explanation Return Format Example Set or query the vertical position of cursor B in the manual cursor measurement mode. Name Type Range Default Integer 5 to 394 300  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 38
RIGOL Chapter 2 Command System :CURSor:MANual:BXValue? Syntax Description Return Format Example Related Commands :CURSor:MANual:BXValue? Query the X value of cursor B in the manual cursor measurement mode. The unit depends on the horizontal unit currently selected. The query returns the X value of cursor B in scientific notation. :CURSor:MANual:BXValue? /*The query returns 4.
PAGE 39
RIGOL Chapter 2 Command System :CURSor:MANual:IXDELta? Syntax Description Return Format Example Related Commands :CURSor:MANual:IXDELta? 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. The query returns 1/|dX| in scientific notation. :CURSor:MANual:IXDELta? /*The query returns 1.
PAGE 40
RIGOL Chapter 2 Command System :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 :CURSor:TRACk:SOURce1? Description Parameter Explanation Return
PAGE 41
RIGOL Chapter 2 Command System :CURSor:TRACk:SOURce2 Syntax :CURSor:TRACk:SOURce2 :CURSor:TRACk:SOURce2? Description Parameter Explanation Return Format Example Set or query the channel source of cursor B in the track cursor measurement mode. Name Type Range Default Discrete {OFF|CHANnel1|CHANnel2|CHANnel3| CHANnel4|MATH} CHANnel1 Only the channels enabled can be selected as the channel source. The query returns OFF, CHAN1, CHAN2, CHAN3, CHAN4, or MATH.
PAGE 42
RIGOL Chapter 2 Command System :CURSor:TRACk:BX Syntax :CURSor:TRACk:BX :CURSor:TRACk:BX? Description Parameter Explanation Return Format Example Set or query the horizontal position of cursor B in the track cursor measurement mode. Name Type Range Default Integer 5 to 594 500 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 43
RIGOL Chapter 2 Command System :CURSor:TRACk:AXValue? Syntax Description Return Format Example Related Command :CURSor:TRACk:AXValue? Query the X value of cursor A in the track cursor measurement mode. The default unit is s. The query returns the X value of cursor A in scientific notation. :CURSor:TRACk:AXValue? /*The query returns -4.
PAGE 44
RIGOL Chapter 2 Command System :CURSor:TRACk:XDELta? Syntax Description Return Format Example Related Commands :CURSor:TRACk:XDELta? 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. The query returns the difference in scientific notation. :CURSor:TRACk:XDELta? /*The query returns 8.
PAGE 45
RIGOL Chapter 2 Command System :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 :CURSor:AUTO:ITEM? Description Parameter Explanation Return Format Example The auto cursor function can measure 37 waveform parameters.
PAGE 46
RIGOL Chapter 2 Command System :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). Wherein, (0,0) is located at the left top corner of the screen and (600,400) is located at the right bottom corner of the screen.
PAGE 47
RIGOL Chapter 2 Command System :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). Wherein, (0,0) is located at the left top corner of the screen and (600,400) is located at the right bottom corner of the screen.
PAGE 48
RIGOL Chapter 2 Command System :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. At this point, the query returns 9.9E37. Return Format Example 2-32 The query returns the Y value of cursor B in scientific notation. :CURSor:AUTO:BYValue? /*The query returns 4.
PAGE 49
RIGOL Chapter 2 Command System :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 :CURSor:XY:AX? Description Parameter Explanation Return Format Example Set or query the horizontal position of cursor A in the XY cursor measurement mode.
PAGE 50
RIGOL Chapter 2 Command System :CURSor:XY:BX Syntax :CURSor:XY:BX :CURSor:XY:BX? Description Parameter Explanation Return Format Example Set or query the horizontal position of cursor B in the XY cursor measurement mode. Name Type Range Default Integer 5 to 394 300 In the XY timebase mode, the horizontal and vertical positions of the cursor are defined by the pixel coordinate of the XY display area. The pixel coordinate of the screen ranges from (0,0) to (400,400).
PAGE 51
RIGOL Chapter 2 Command System :CURSor:XY:BY Syntax :CURSor:XY:BY :CURSor:XY:BY? Description Parameter Explanation Return Format Example Set or query the vertical position of cursor B in the XY cursor measurement mode. Name Type Range Default Integer 5 to 394 300 In the XY timebase mode, the horizontal and vertical positions are defined by the pixel coordinate of the XY display area. The pixel coordinate of the XY display area ranges from (0,0) to (400,400).
PAGE 52
RIGOL Chapter 2 Command System :CURSor:XY:BXValue? Syntax Description Return Format :CURSor:XY:BXValue? Query the X value of cursor B in the XY cursor measurement mode. The unit depends on the amplitude unit of the corresponding channel. The query returns the X value of cursor B in scientific notation. Example :CURSor:XY:BXValue? Related Command :CHANnel:UNITs /*The query returns -2.
PAGE 53
RIGOL Chapter 2 Command System :DECoder Commands The :DECoder commands are used to execute decoding settings and operations.
PAGE 54
RIGOL Chapter 2 Command System :DECoder:DISPlay Syntax :DECoder:DISPlay :DECoder:DISPlay? Description Parameter Return Format Example Turn on or off the decoder or query the status of the decoder. Name Type Range Default Discrete {1|2} -- Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0.
PAGE 55
RIGOL Chapter 2 Command System :DECoder:POSition Syntax :DECoder:POSition :DECoder:POSition? Description Parameter Explanation Return Format Example Set or query the vertical position of the bus on the screen. Name Type Range Default Discrete {1|2} -- Integer 50 to 350 Decoder 1: 350 Decoder 2: 300 The screen is divided into 400 parts vertically which are marked as 0 to 400 from top to bottom respectively. The range of is from 50 to 350.
PAGE 56
RIGOL Chapter 2 Command System :DECoder:THREshold:CHANnel1 :DECoder:THREshold:CHANnel2 :DECoder:THREshold:CHANnel3 :DECoder:THREshold:CHANnel4 Syntax :DECoder:THREshold:CHANnel1 :DECoder:THREshold:CHANnel1? :DECoder:THREshold:CHANnel2 :DECoder:THREshold:CHANnel2? :DECoder:THREshold:CHANnel3 :DECoder:THREshold:CHANnel3? :DECoder:THREshold:CHANnel4 :DECoder:THREshold:CHANnel4? Description Parameter Explanation Return Format Example 2-40 S
PAGE 57
RIGOL Chapter 2 Command System :DECoder:THREshold:AUTO Syntax :DECoder:THREshold:AUTO :DECoder:THREshold:AUTO? Description Parameter Explanation Return Format Example Related Commands 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.
PAGE 58
RIGOL Chapter 2 Command System :DECoder:CONFig:LINE Syntax :DECoder:CONFig:LINE :DECoder:CONFig:LINE? Description Parameter Explanation Return Format Example Turn on or off the bus display function, or query the status of the bus display function. Name Type Range Default Discrete {1|2} -- Bool {{1|ON}|{0|OFF}} 1|ON When this function is enabled, the bus will be displayed on the screen.
PAGE 59
RIGOL Chapter 2 Command System :DECoder:CONFig:ENDian Syntax :DECoder:CONFig:ENDian :DECoder:CONFig:ENDian? Description Parameter Explanation Return Format Example 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. Name Type Range Default Discrete {1|2} -- Bool {{1|ON}|{0|OFF}} 0|OFF  This command is invalid in parallel decoding.
PAGE 60
RIGOL Chapter 2 Command System :DECoder:UART (Option) The :DECoder:UART commands are used to set the RS232 decoding parameters.
PAGE 61
RIGOL Chapter 2 Command System :DECoder:UART:RX Syntax :DECoder:UART:RX :DECoder:UART:RX? Description Parameter Explanation Return Format Example Set or query the RX channel source of RS232 decoding. Name Type Range Default Discrete {1|2} -- Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8| D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF} OFF When OFF is selected, no RX channel source will be set.
PAGE 62
RIGOL Chapter 2 Command System :DECoder:UART:ENDian Syntax :DECoder:UART:ENDian :DECoder:UART:ENDian? Description Parameter Return Format Example Set or query the endian of RS232 decoding. Name Type Range Default Discrete {1|2} -- Discrete {LSB|MSB} LSB The query returns LSB or MSB.
PAGE 63
RIGOL Chapter 2 Command System :DECoder:UART:STOP Syntax :DECoder:UART:STOP :DECoder:UART:STOP? Description Parameter Return Format Example Set or query the stop bit after each frame of data in RS232 decoding. Name Type Range Default Discrete {1|2} -- Discrete {1|1.5|2} 1 The query returns 1, 1.5, or 2. :DECoder1:UART:STOP 1.5 :DECoder1:UART:STOP? /*Set the stop bit in RS232 decoding to 1.5*/ /*The query returns 1.
PAGE 64
RIGOL Chapter 2 Command System :DECoder:IIC (Option) The :DECoder:IIC commands are used to set the I2C decoding parameters. Command List:  :DECoder:IIC:CLK  :DECoder:IIC:DATA  :DECoder:IIC:ADDRess :DECoder:IIC:CLK Syntax :DECoder:IIC:CLK :DECoder:IIC:CLK? Description Parameter Return Format Example Set or query the signal source of the clock channel in I2C decoding.
PAGE 65
RIGOL Chapter 2 Command System :DECoder:IIC:ADDRess Syntax :DECoder:IIC:ADDRess :DECoder:IIC:ADDRess? Description Parameter Explanation Return Format Example Set or query the address mode of I2C decoding. Name Type Range Default Discrete {1|2} -- Discrete {NORMal|RW} NORMal  NORMal: the address bits (:TRIGger:IIC:AWIDth) does not include the R/W bit.  RW: the address bits (:TRIGger:IIC:AWIDth) includes the R/W bit. The query returns NORM or RW.
PAGE 66
RIGOL Chapter 2 Command System :DECoder:SPI (Option) The :DECoder:SPI commands are used to set the SPI decoding parameters.
PAGE 67
RIGOL Chapter 2 Command System :DECoder:SPI:MISO Syntax :DECoder:SPI:MISO :DECoder:SPI:MISO? Description Parameter Explanation Return Format Example Set or query the MISO channel source in SPI decoding. Name Type Range Default Discrete {1|2} -- Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8| D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF} OFF When OFF is selected, no MISO channel source will be set.
PAGE 68
RIGOL Chapter 2 Command System :DECoder:SPI:CS Syntax :DECoder:SPI:CS :DECoder:SPI:CS? Description Parameter Explanation Return Format Example Set or query the CS channel source in SPI decoding. Name Type Range Default Discrete {1|2} -- Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8| D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel3 This command is only valid in the CS mode (:DECoder:SPI:MODE).
PAGE 69
RIGOL Chapter 2 Command System :DECoder:SPI:MODE Syntax :DECoder:SPI:MODE :DECoder:SPI:MODE? Description Parameter Explanation Return Format Example Set or query the frame synchronization mode of SPI decoding. Name Type Range Default Discrete {1|2} -- Discrete {CS|TIMeout} TIMeout  CS: it contains a chip select line (CS). You can perform frame synchronization according to CS.
PAGE 70
RIGOL Chapter 2 Command System :DECoder:SPI:POLarity Syntax :DECoder:SPI:POLarity :DECoder:SPI:POLarity? Description Parameter Explanation Return Format Example Set or query the polarity of the SDA data line in SPI decoding. Name Type Range Default Discrete {1|2} -- Discrete {NEGative|POSitive} POSitive  NEGative: . The low level is 1.  POSitive: . The high level is 1. The query returns NEG or POS.
PAGE 71
RIGOL Chapter 2 Command System :DECoder:SPI:WIDTh Syntax :DECoder:SPI:WIDTh :DECoder:SPI:WIDTh? Description Parameter Return Format Example Set or query the number of bits of each frame of data in SPI decoding. Name Type Range Default Discrete {1|2} -- Integer 8 to 32 8 The query returns an integer between 8 and 32.
PAGE 72
RIGOL Chapter 2 Command System :DECoder:PARallel The :DECoder:PARallel commands are used to set the parallel decoding parameters.
PAGE 73
RIGOL Chapter 2 Command System :DECoder:PARallel:EDGE Syntax :DECoder:PARallel:EDGE :DECoder:PARallel:EDGE? Description Parameter Explanation Return Format Example Set or query the edge type of the clock channel when the instrument samples the data channel in parallel decoding. Name Type Range Default Discrete {1|2} -- Discrete {RISE|FALL|BOTH} RISE If no clock channel is selected (:DECoder:PARallel:CLK), the instrument will sample when the channel data jumps.
PAGE 74
RIGOL Chapter 2 Command System :DECoder:PARallel:BITX Syntax :DECoder:PARallel:BITX :DECoder:PARallel:BITX? Description Parameter Explanation Return Format Example Set or query the data bit that requires a channel source on the parallel bus. Name Type Range Default Discrete {1|2} -- Integer 0 to (data width - 1) 0  Set the data width using the :DECoder:PARallel:WIDTh command.
PAGE 75
RIGOL Chapter 2 Command System :DECoder:PARallel:POLarity Syntax :DECoder:PARallel:POLarity :DECoder:PARallel:POLarity? Description Parameter Explanation Return Format Example Set ro query the data polarity of parallel decoding. Name Type Range Default Discrete {1|2} -- Discrete {NEGative|POSitive} POSitive  NEGative: . The low level is 1.  POSitive: . The high level is 1. The query returns NEG or POS.
PAGE 76
RIGOL Chapter 2 Command System :DECoder:PARallel:NRTime Syntax :DECoder:PARallel:NRTime :DECoder:PARallel:NRTime? Description Parameter Explanation Return Format Example Set or query the noise rejection time of parallel decoding. The default unit is s. Name Type Range Default Discrete {1|2} -- Real 0.00s to 100ms 0.00s Before sending this command, send the :DECoder:PARallel:NREJect command to turn on the noise rejection function.
PAGE 77
RIGOL Chapter 2 Command System :DECoder:PARallel:PLOT Syntax :DECoder:PARallel:PLOT :DECoder:PARallel:PLOT? Description Parameter Explanation Return Format Example Turn on or off the curve function of parallel decoding, or query the status of the curve function of parallel decoding. Name Type Range Default Discrete {1|2} -- Bool {{1|ON}|{0|OFF}} 0|OFF When this function is turned on, the variation trend of the bus data is displayed in vector diagram form.
PAGE 78
RIGOL Chapter 2 Command System :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  :DISPlay:GRID  :DISPlay:GBRightness :DISPlay:CLEar Syntax :DISPlay:CLEar Description Clear all the waveforms on the screen.
PAGE 79
RIGOL Chapter 2 Command System :DISPlay:DATA? Syntax Description Parameter Explanation Return Format :DISPlay:DATA? [,,] Read the data stream of the image currently displayed on the screen and set the color, invert display, and format of the image acquired.
PAGE 80
RIGOL Chapter 2 Command System :DISPlay:TYPE Syntax :DISPlay:TYPE :DISPlay:TYPE? Description Parameter Explanation Return Format Example 2-64 Set or query the display mode of the waveform on the screen. Name Type Range Default Discrete {VECTors|DOTS} VECTors  VECTors: the sample points are connected by lines. Normally, this mode can provide the most vivid waveform to view the steep edge of the waveform (such as square waveform).  DOTS: display the sample points directly.
PAGE 81
RIGOL Chapter 2 Command System :DISPlay:GRADing:TIME Syntax :DISPlay:GRADing:TIME :DISPlay:GRADing:TIME? Description Parameter Explanation Return Format Example Set or query the persistence time. The default unit is s. Name Type Range Default Discrete {MIN|0.1|0.2|0.5|1|5|10|INFinite} MIN  MIN: set the persistence time to its minimum to view the waveform changing in high refresh rate.
PAGE 82
RIGOL Chapter 2 Command System :DISPlay:GRID Syntax :DISPlay:GRID :DISPlay:GRID? Description Parameter Explanation Return Format Example Set or query the grid type of screen display. Name Type Range Default Discrete {FULL|HALF|NONE} FULL FULL: turn the background grid and coordinate on. HALF: turn the background grid off and coordinate on. NONE: turn the background grid and coordinate off. The query returns FULL, HALF, or NONE.
PAGE 83
RIGOL Chapter 2 Command System :ETABle Commands The :ETABle commands are used to set the parameters related to the decoding event table. Command List:  :ETABle:DISP  :ETABle:FORMat  :ETABle:VIEW  :ETABle:COLumn  :ETABle:ROW  :ETABle:SORT  :ETABle:DATA? :ETABle:DISP Syntax :ETABle:DISP :ETABle:DISP? Description Parameter Explanation Return Format Example Turn on or off the decoding event table, or query the status of the decoding event table.
PAGE 84
RIGOL Chapter 2 Command System :ETABle:VIEW Syntax :ETABle:VIEW :ETABle:VIEW? Description Parameter Explanation Return Format Example Set or query the display mode of the event table. Name Type Range Default Discrete {1|2} -- Discrete {PACKage|DETail|PAYLoad} PACKage  PACKage: the time and data are displayed in the event table.  DETail: the detailed data of the specified row is displayed in the event table.
PAGE 85
RIGOL Chapter 2 Command System :ETABle:ROW Syntax :ETABle:ROW :ETABle:ROW? Description Parameter Return Format Example Set or query the current row of the event table. Name Type Range Default Discrete {1|2} -- Integer 1 to the maximum number of rows of the current event table 1 The query returns the current row in integer. If the current even table is empty, the query returns 0.
PAGE 86
RIGOL Chapter 2 Command System :ETABle:DATA? Syntax Description Parameter Return Format :ETABle:DATA? Read the current event table data. Name Type Range Default Discrete {1|2} -- The query returns the event table data in the format as shown in the figure below. Wherein, #9000000098 is the TMC data description header followed by the even table data and its format is #900000dddd. dddd denotes the number of bytes of the valid waveform data following the description header.
PAGE 87
RIGOL Chapter 2 Command System :FUNCtion Commands (Option) The :FUNCtion commands are used to set the waveform recording and playback parameters.
PAGE 88
RIGOL Chapter 2 Command System :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
RIGOL Chapter 2 Command System :FUNCtion:WRECord:OPERate Syntax :FUNCtion:WRECord:OPERate :FUNCtion:WRECord:OPERate? Description Parameter Explanation Return Format Example Start or stop the waveform recording, or query the status of the waveform recording. Name Type Range Default Discrete {RUN|STOP} -- Before sending this command, send the :FUNCtion:WRECord:ENABle command to turn on the waveform recording function. Otherwise, this command is invalid. The query returns RUN or STOP.
PAGE 90
RIGOL Chapter 2 Command System :FUNCtion:WREPlay:FSTart Syntax :FUNCtion:WREPlay:FSTart :FUNCtion:WREPlay:FSTart? Description Parameter Explanation 2-74 Set or query the start frame of waveform playback. Name Type Range Default Integer 1 to the maximum number of frames recorded 1  Use the :FUNCtion:WRECord:FEND command to set the maximum number of frames recorded.
PAGE 91
RIGOL Chapter 2 Command System :FUNCtion:WREPlay:FEND Syntax :FUNCtion:WREPlay:FEND :FUNCtion:WREPlay:FEND? Description Parameter Explanation Return Format Example Set or query the end frame of waveform playback. Name Type Range Default Integer 1 to the maximum number of frames recorded The maximum number of frames recorded  Use the :FUNCtion:WRECord:FEND command to set the maximum number of frames recorded.
PAGE 92
RIGOL Chapter 2 Command System :FUNCtion:WREPlay:FINTerval Syntax :FUNCtion:WREPlay:FINTerval :FUNCtion:WREPlay:FINTerval? Description Parameter Explanation Return Format Example Set or query the time interval between frames in waveform playback. The default unit is s. Name Type Range Default Real 100ns to 10s 100ns  You can only set the time interval of waveform playback when a waveform is currently recorded.
PAGE 93
RIGOL Chapter 2 Command System :FUNCtion:WREPlay:DIRection Syntax :FUNCtion:WREPlay:DIRection
:FUNCtion:WREPlay:DIRection? Description Parameter Explanation Return Format Example Set or query the waveform playback direction. Name Type Range Default Discrete {FORWard|BACKward} FORWard  FORWard: positive direction. Play from the start frame to the end frame.  BACKward: negative direction. Play from the end frame to the start frame.
PAGE 94
RIGOL Chapter 2 Command System :FUNCtion:WREPlay:FCURrent Syntax :FUNCtion:WREPlay:FCURrent :FUNCtion:WREPlay:FCURrent? Description Parameter Explanation Return Format Example Set or query the current frame in waveform playback. Name Type Range Default Integer 1 to the maximum number of frames recorded The maximum number of frames recorded  Use the :FUNCtion:WRECord:FEND command to set the maximum number of frames recorded.
PAGE 95
RIGOL Chapter 2 Command System 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. Command List:  *CLS  *ESE  *ESR?  *IDN?  *OPC  *RST  *SRE  *STB?  *TST?  *WAI *CLS Syntax Description *CLS Clear all the event registers and clear the error queue.
PAGE 96
RIGOL Chapter 2 Command System *ESR? Syntax *ESR? Description Query and clear the event register for the standard event status register. Explanation The bit 1 and bit 6 of the standard event status register are not used and are always treated as 0. The range of the return value are the decimal numbers corresponding to the binary numbers X0XXXX0X (X is 1 or 0). Return Format The query returns an integer which equals the sum of the weights of all the bits in the register.
PAGE 97
RIGOL Chapter 2 Command System *SRE Syntax *SRE *SRE? Description Parameter Explanation Return Format Example Set or query the enable register for the status byte register set. Name Type Range Default Integer 0 to 255 0 The bit 0 and bit 1 of the status byte register are not used and are always treated as 0; therefore, the range of are the decimal numbers corresponding to the binary numbers XXXXXX00 (X is 1 or 0).
PAGE 98
RIGOL Chapter 2 Command System :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.
PAGE 99
RIGOL Chapter 2 Command System :LA:AUTosort Syntax Description Parameter Explanation :LA:AUTosort Set the auto ordering mode of the waveforms of the channels turned on on the screen.
PAGE 100
RIGOL Chapter 2 Command System :LA:DIGital:POSition Syntax :LA:DIGital:POSition :LA:DIGital:POSition? Description Parameter Set or query the display position of the specified digital channel waveform on the screen.
PAGE 101
RIGOL Chapter 2 Command System :LA:DISPlay Syntax :LA:DISPlay {||}, :LA:DISPlay? {||} Description Parameter Explanation Return Format Example 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
RIGOL Chapter 2 Command System :LA:POD:DISPlay Syntax :LA:POD:DISPlay :LA:POD:DISPlay? Description Parameter Explanation Return Format Example Turn on or off the specified default channel group, or query the status of the specified default channel group. Name Type Range Default Integer 1 to 2 -- Bool {{1|ON}|{0|OFF}} --  There are 2 default channel groups: POD1 (D0 to D7) and POD2 (D8 to D15).
PAGE 103
RIGOL Chapter 2 Command System :LA:SIZE Syntax :LA:SIZE :LA:SIZE? Description Parameter Explanation Return Format Example Related Command Set or query the display size of the waveforms of the channels turned on on the screen. Name Type Range Default Discrete {SMALl|LARGe} SMALl  SMALl: up to 16 waveforms can be displayed on the screen (0 to 15 from top to bottom).  LARGe: up to 8 waveforms can be displayed on the screen (0 to 7 from top to bottom).
PAGE 104
RIGOL Chapter 2 Command System :LA:TCALibrate Syntax :LA:TCALibrate :LA:TCALibrate? Description Parameter Explanation Set or query the delay calibration time of the digital channels. The default unit is s. Name Type Range Default Real -100ns to 100ns 0.00s  When using the oscilloscope for actual measurement, the transmission delay of the probe cable may cause relatively larger error (zero offset).
PAGE 105
Chapter 2 Command System RIGOL :MATH Commands The :MATH commands are used to set the operations between the waveforms of multiple channels.
PAGE 106
RIGOL Chapter 2 Command System  :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 :MATH:DISPlay? Description Parameter Return Format Example Enable or disable the mat
PAGE 107
RIGOL Chapter 2 Command System :MATH:SOURce1 Syntax :MATH:SOURce1 :MATH:SOURce1? Description Parameter Explanation Set or query the source or source A of algebraic operation/functional operation/the outer layer operation of compound operation. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|FX} CHANnel1  For algebraic operations, this command is used to set source A.  For functional operations, only this command is used to set the source.
PAGE 108
RIGOL Chapter 2 Command System :MATH:SOURce2 Syntax :MATH:SOURce2 :MATH:SOURce2? Description Parameter Explanation Set or query source B of algebraic operation/the outer layer operation of compound operation. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|FX} CHANnel1  This command is only applicable to algebraic operations (requiring two sources) and compound operations whose outer layer operations are algebraic operations.
PAGE 109
RIGOL Chapter 2 Command System :MATH:LSOUrce2 Syntax :MATH:LSOUrce2 :MATH:LSOUrce2? Description Parameter Explanation Return Format Example Set or query source B of logic operation. Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8| D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4} D1  The logic operations include A&&B, A||B, A^B, and !A.  This command is only applicable to logic operations that require two signal sources and is used to set source B.
PAGE 110
RIGOL Chapter 2 Command System :MATH:OFFSet Syntax :MATH:OFFSet :MATH:OFFSet? Description Parameter Set or query the vertical offset of the operation result. The unit depends on the operator currently selected and the unit of the source. Name Explanation Return Format Type Range Default Real Related to the vertical scale of the operation result Range: (-1000 x MathVerticalScale) to (1000 x MathVerticalScale) Step: MathVerticalScale/50 0.
PAGE 111
RIGOL Chapter 2 Command System :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.
PAGE 112
RIGOL Chapter 2 Command System :MATH:FFT:SPLit Syntax :MATH:FFT:SPLit :MATH:FFT:SPLit? Description Parameter Explanation Return Format Example Related Command 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. Name Type Range Default Bool {{1|ON}|{0|OFF}} 1|ON  Enable the half-screen display mode: the source channel and the FFT operation results are displayed separately.
PAGE 113
RIGOL Chapter 2 Command System :MATH:FFT:HSCale Syntax :MATH:FFT:HSCale :MATH:FFT:HSCale? Description Parameter Explanation Return Format Example Set or query the horizontal scale of the FFT operation result. The default unit is Hz. Name Type Range Default Real Refer to Explanation 5MHz  can be set to 1/1000, 1/400, 1/200, 1/100, 1/40, or 1/20 of the FFT sample rate.
PAGE 114
RIGOL Chapter 2 Command System :MATH:FFT:HCENter Syntax :MATH:FFT:HCENter :MATH:FFT:HCENter? Description Parameter Explanation Return Format Example 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. Name Type Range Default Real Refer to Explanation 5MHz  When the FFT mode is set to TRACe, the range of is from 0 to (0.4 x FFT sample rate).
PAGE 115
RIGOL Chapter 2 Command System :MATH:FILTer:TYPE Syntax :MATH:FILTer:TYPE :MATH:FILTer:TYPE? Description Parameter Explanation Return Format Example Related Commands Set or query the filter type. Name Type Range Default Discrete {LPASs|HPASs|BPASs|BSTOP} LPASs  MSO1000Z/DS1000Z provides 4 types of filters (Low Pass Filter, High Pass Filter, Band Pass Filter, and Band Stop Filter). Setting the bandwidth can filter the specified frequencies.
PAGE 116
RIGOL Chapter 2 Command System :MATH:FILTer:W1 Syntax :MATH:FILTer:W1 :MATH:FILTer:W1? Description Parameter 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. Name Explanation Return Format Example Type Real Range Default Refer to Explanation Related to the filter type LPASs|BPASs|BSTOP: 0.005 x screen sample rate HPASs: 0.
PAGE 117
RIGOL Chapter 2 Command System :MATH:FILTer:W2 Syntax :MATH:FILTer:W2 :MATH:FILTer:W2? Description Parameter Explanation Return Format Example Set or query the cutoff frequency 2 (ωc2) of the band pass/band stop filter. The default unit is Hz. Name Type Range Default Real Refer to Explanation 0.1 x screen sample rate When the type of the filter is set to BPASs (band pass) or BSTOP (band stop), you need to set two cutoff frequencies.
PAGE 118
RIGOL Chapter 2 Command System :MATH:OPTion:END Syntax :MATH:OPTion:END :MATH:OPTion:END? Description Parameter Explanation Return Format Example Related Command Set or query the end point of the waveform math operation. Name Type Range Default Discrete (Start point currently set+1) to 1199 1199  This command is invalid for the FFT operation. Sending this command will modify the end points of all the operations (except FFT).
PAGE 119
RIGOL Chapter 2 Command System :MATH:OPTion:SENSitivity Syntax :MATH:OPTion:SENSitivity :MATH:OPTion:SENSitivity? Description Parameter Explanation Return Format Example Related Commands Set or query the sensitivity of the logic operation. The default unit is div (namely the current vertical scale). Name Type Range Default Real 0 to 0.96, the step is 0.08 0 This command is only applicable to logic operations (A&&B, A||B, A^B, and !A).
PAGE 120
RIGOL Chapter 2 Command System :MATH:OPTion:ASCale Syntax :MATH:OPTion:ASCale :MATH:OPTion:ASCale? Description Parameter Explanation Return Format Example Enable or disable the auto scale setting of the operation result or query the status of the auto scale setting.
PAGE 121
RIGOL Chapter 2 Command System :MATH:OPTion:THReshold2 Syntax :MATH:OPTion:THReshold2 :MATH:OPTion:THReshold2? Description Parameter Explanation Return Format Example Set or query the threshold level of source B in logic operations. The default unit is V. Name Type Range Default Real (-4 x VerticalScale - VerticalOffset) to (4 x VerticalScale - VerticalOffset) 0.00V  This command is only applicable to A&&B, A||B, and A^B logic operations of which source B is an analog channel.
PAGE 122
RIGOL Chapter 2 Command System :MATH:OPTion:FX:SOURce2 Syntax :MATH:OPTion:FX:SOURce2 :MATH:OPTion:FX:SOURce2? Description Parameter Return Format Example Set or query source B of the inner layer operation of compound operation. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
PAGE 123
RIGOL Chapter 2 Command System :MASK Commands The :MASK commands are used to set and query the pass/fail test parameters.
PAGE 124
RIGOL Chapter 2 Command System :MASK:SOURce Syntax :MASK:SOURce :MASK:SOURce? Description Parameter Explanation Return Format Example Set or query the source of the pass/fail test. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Only channels enabled can be selected as the source. You can sent the :CHANnel:DISPlay command to enable the desired channel. The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
PAGE 125
RIGOL Chapter 2 Command System :MASK:MDISplay Syntax :MASK:MDISplay :MASK:MDISplay? Description Parameter Explanation Return Format Example Enable or disable the statistic information when the pass/fail test is enabled, or query the status of the statistic information. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF  Before executing this command, you need to send the :MASK:ENABle command to enable the pass/fail test.
PAGE 126
RIGOL Chapter 2 Command System :MASK:OUTPut Syntax :MASK:OUTPut :MASK:OUTPut? Description Parameter Explanation Return Format Example Enable or disable the sound prompt when failed waveforms are detected, or query the status of the sound prompt. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF  OFF: when failed waveforms are detected, there are display and output but the beeper does not sound.
PAGE 127
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). Related Commands :MASK:X :MASK:Y :MASK:PASSed? Syntax Description Return Format :MASK:PASSed? Query the number of passed frames in the pass/fail test.
PAGE 128
RIGOL Chapter 2 Command System :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. 1. Time Parameters Period: Defined as the time between the threshold middle points of two consecutive, like-polarity edges.
PAGE 129
RIGOL Chapter 2 Command System -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 1 +Edges: 2 Threshold Lower Limit n The number of rising edges that rise from below the threshold lower limit to above the threshold upper limit.
PAGE 130
RIGOL 4. Chapter 2 Command System 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. Vtop: The voltage value from the flat top of the waveform to the GND. Vbase: The voltage value from the flat base of the waveform to the GND. Vamp: The voltage value from the top of the waveform to the base of the waveform.
PAGE 131
Chapter 2 Command System 5. 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. Area: The area of the whole waveform within the screen and the unit is voltage-second. The area meadured above the zero reference (namely the vertical offset) is positive and the area measured below the zero reference is negative.
PAGE 132
RIGOL Chapter 2 Command System :MEASure:SOURce Syntax :MEASure:SOURce :MEASure:SOURce? Description Parameter Explanation Return Format Example Related Command Set or query the source of the current measurement parameter. Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8| D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} CHANnel1  Analog channels CH1 to CH4 can be selected no matter wether they are currently turned on.
PAGE 133
RIGOL Chapter 2 Command System :MEASure:COUNter:VALue? Syntax Description Return Format Example Related Command :MEASure:COUNter:VALue? Query the measurement result of the frequency counter. The default unit is Hz. The query returns the measurement result in scientific notation. If the frequency counter is disabled, 0.0000000e+00 will be returned. :MEASure:COUNter:VALue? /*The query returns 1.
PAGE 134
RIGOL Chapter 2 Command System :MEASure:ADISplay Syntax :MEASure:ADISplay :MEASure:ADISplay? Description Parameter Explanation Return Format Example Enable or disable the all measurement function, or query the status of the all measurement function.
PAGE 135
RIGOL Chapter 2 Command System :MEASure:SETup:MAX Syntax :MEASure:SETup:MAX :MEASure:SETup:MAX? Description Parameter Explanation Return Format Example Related Commands Set or query the upper limit of the threshold (expressed in the percentage of amplitude) in time, delay, and phase measurements.
PAGE 136
RIGOL Chapter 2 Command System :MEASure:SETup:MIN Syntax :MEASure:SETup:MIN :MEASure:SETup:MIN? Description Parameter Explanation Return Format Example Related Commands Set or query the lower limit of the threshold (expressed in the percentage of amplitude) in time, delay, and phase measurements.
PAGE 137
RIGOL Chapter 2 Command System :MEASure:SETup:PSB Syntax :MEASure:SETup:PSB :MEASure:SETup:PSB? Description Parameter Return Format Example Related Command Set or query source B of Phase 1→2 and Phase 1→2 measurements. Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8| D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel2 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, CHAN3, or CHAN4.
PAGE 138
RIGOL Chapter 2 Command System :MEASure:SETup:DSB Syntax :MEASure:SETup:DSB :MEASure:SETup:DSB? Description Parameter Return Format Example Related Command Set or query source B of Delay 1→2 and Delay 1→2 measurements. Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8| D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel2 The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1, CHAN2, CHAN3, or CHAN4.
PAGE 139
RIGOL Chapter 2 Command System :MEASure:STATistic:MODE Syntax :MEASure:STATistic:MODE :MEASure:STATistic:MODE? Description Parameter Explanation Return Format Example Related Commands Set or query the statistic mode. Name Type Range Default Discrete {DIFFerence|EXTRemum} EXTRemum  DIFFerence: select the difference mode. The statistic results contain the current value, average value, standard deviation, and counts.  EXTRemum: select the extremum mode.
PAGE 140
RIGOL Chapter 2 Command System :MEASure:STATistic:ITEM Syntax :MEASure:STATistic:ITEM [,[,]] :MEASure:STATistic:ITEM? ,[,[,]] Description Parameter Explanation Return Format Example 2-124 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.
PAGE 141
RIGOL Chapter 2 Command System :MEASure:ITEM Syntax :MEASure:ITEM [,[,]] :MEASure:ITEM? [,[,]] Description Parameter Explanation Return Format Example Measure any waveform parameter of the specified source, or query the measurement result of any waveform parameter of the specified source.
PAGE 142
RIGOL Chapter 2 Command System :REFerence Commands The :REFerence commands are used to set the reference waveform parameters.
PAGE 143
RIGOL Chapter 2 Command System :REFerence:SOURce Syntax :REFerence:SOURce :REFerence:SOURce? Description Parameter Set or query the source of the current reference channel. Name Type Range Default Discrete {1|2|3|4|5|6|7|8|9|10} -- Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10| D11|D12|D13|D14|D15|CHANnel1| CHANnel2|CHANnel3|CHANnel4|MATH} CHANnel1 Explanation Only channels currently enabled can be selected as the source of the current reference channel.
PAGE 144
RIGOL Chapter 2 Command System :REFerence:VOFFset Syntax :REFerence:VOFFset :REFerence:VOFFset? Description Parameter Explanation Return Format Example Set or query the vertical offset of the specified reference channel. The unit is the same as the unit of the source. Name Type Range Default Discrete {1|2|3|4|5|6|7|8|9|10} -- Real (-10 x RefVerticalScale) to (10 x RefVerticalScale) 0 RefVerticalScale refers to the vertical scale of the reference channel.
PAGE 145
RIGOL Chapter 2 Command System :REFerence:SAVe Syntax Description Parameter Related Command :REFerence:SAVe Store the waveform of the current reference channel to the internal memory as reference waveform. Name Type Range Default Discrete {1|2|3|4|5|6|7|8|9|10} -- :REFerence:CURRent :REFerence:COLor Syntax :REFerence:COLor :REFerence:COLor? Description Parameter Return Format Example Set or query the display color of the current reference channel.
PAGE 146
RIGOL Chapter 2 Command System [:SOURce[]] Commands The [:SOURce[]] commands are used to set the parameters of the built-in signal source. can be 1 or 2 which denotes the corresponding built-in signal source channel. When or :SOURce[] 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 147
RIGOL Chapter 2 Command System [:SOURce[]]:OUTPut[][:STATe] Syntax [:SOURce[]]:OUTPut[][:STATe] [:SOURce[]]:OUTPut[][:STATe]? Description Parameter Explanation Return Format Example Turn on or off the output of the specified source channel, or query the status of the output of the specified source channel.
PAGE 148
RIGOL Chapter 2 Command System [:SOURce[]]:FREQuency[:FIXed] Syntax [:SOURce[]]:FREQuency[:FIXed] [:SOURce[]]:FREQuency[:FIXed]? Description Parameter 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. Name Type Range Default [] Discrete {1|2} If omitted, the operation is performed on source 1 by default Real Sine: 0.1Hz to 25MHz Square: 0.
PAGE 149
RIGOL Chapter 2 Command System [:SOURce[]]:PHASe:INITiate Syntax Description Parameter Explanation [:SOURce[]]:PHASe:INITiate Execute the align phase operation. Name Type Range Default [] Discrete {1|2} If omitted, the operation is performed on source 1 by default 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
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:RAMP:SYMMetry Syntax [:SOURce[]]:FUNCtion:RAMP:SYMMetry [:SOURce[]]:FUNCtion:RAMP:SYMMetry? Description Parameter Return Format Example Related Command Set or query the ramp symmetry (the percentage that the rising period takes up in the whole period) of the specified source channel.
PAGE 151
RIGOL Chapter 2 Command System [:SOURce[]]:VOLTage[:LEVel][:IMMediate]:OFFSet Syntax [:SOURce[]]:VOLTage[:LEVel] [:IMMediate]:OFFSet [:SOURce[]]:VOLTage[:LEVel] [:IMMediate]:OFFSet? Description Parameter Set or query the DC offset of the specified source channel. The default unit is VDC.
PAGE 152
RIGOL Chapter 2 Command System [:SOURce[]]:MOD[:STATe] Syntax [:SOURce[]]:MOD[:STATe] [:SOURce[]]:MOD[:STATe]? Description Parameter Explanation Return Format Example Related Command Enable or disable the modulation of the specified source channel, or query the status of the modulation of the specified source channel.
PAGE 153
RIGOL Chapter 2 Command System [:SOURce[]]:MOD:AM[:DEPTh] Syntax [:SOURce[]]:MOD:AM[:DEPTh] [:SOURce[]]:MOD:AM[:DEPTh]? Description Parameter Explanation Return Format Example Set or query the AM modulation depth (indicates the amplitude variation degree and is expressed as a percentage) of the specified source channel.
PAGE 154
RIGOL Chapter 2 Command System [:SOURce[]]:MOD:AM:INTernal:FUNCtion [:SOURce[]]:MOD:FM:INTernal:FUNCtion Syntax [:SOURce[]]:MOD:AM:INTernal:FUNCtion [:SOURce[]]:MOD:AM:INTernal:FUNCtion? [:SOURce[]]:MOD:FM:INTernal:FUNCtion [:SOURce[]]:MOD:FM:INTernal:FUNCtion? Description Parameter Explanation Return Format Example Set or query the modulating waveform of AM or FM of the specified source channel.
PAGE 155
RIGOL Chapter 2 Command System [:SOURce[]]:MOD:FM[:DEVIation] Syntax [:SOURce[]]:MOD:FM[:DEVIation] [:SOURce[]]:MOD:FM[:DEVIation]? Description Parameter Explanation Return Format Example Set or query the FM frequency deviation of the specified source channel. The default unit is Hz.
PAGE 156
RIGOL Chapter 2 Command System [:SOURce[]]:APPLy:NOISe [:SOURce[]]:APPLy:PULSe [:SOURce[]]:APPLy:RAMP [:SOURce[]]:APPLy:SINusoid [:SOURce[]]:APPLy:SQUare [:SOURce[]]:APPLy:USER Syntax [:SOURce[]]:APPLy:NOISe [[,]] [:SOURce[]]:APPLy:PULSe [[,[,[,]]]] [:SOURce[]]:APPLy:RAMP [[,[,[,]]]] [:SOURce[]]:APPLy:SINusoid [[,[,[,]]]] [:SOURce[]]:APPLy:SQUare [[,[,[,]]]
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 (, , , and ) are in order. You can not omit one parameter and set the one/ones behind it. For example, you can not omit and set directly.
PAGE 158
RIGOL Chapter 2 Command System :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 :STORage:IMAGe:TYPE? Description Parameter Return Format Example Set or query the image type when storing images.
PAGE 159
RIGOL Chapter 2 Command System :STORage:IMAGe:COLor Syntax :STORage:IMAGe:COLor :STORage:IMAGe:COLor? Description Parameter Return Format Example Set the image color when storing images to color (ON) or intensity graded color (OFF); or query the image color when storing images. Name Type Range Default Bool {ON|OFF} ON The query returns ON or OFF.
PAGE 160
RIGOL Chapter 2 Command System :SYSTem Commands The :SYSTem commands are used to set the system-related parameters, such as the sound and language.
PAGE 161
RIGOL Chapter 2 Command System :SYSTem:BEEPer Syntax :SYSTem:BEEPer :SYSTem:BEEPer? Description Parameter Return Format Example Enable or disable the beeper, or query the status of the beeper. Name Type Range Default Bool {{1|ON}|{0|OFF}} -- The query returns 1 or 0. :SYSTem:BEEPer ON :SYSTem:BEEPer? /*Enable the beeper*/ /*The query returns 1*/ :SYSTem:ERRor[:NEXT]? Syntax Description Return Format :SYSTem:ERRor[:NEXT]? Query and delete the last system error message.
PAGE 162
RIGOL Chapter 2 Command System :SYSTem:LOCKed Syntax :SYSTem:LOCKed :SYSTem:LOCKed? Description Parameter Return Format Enable or disable the keyboard lock function, or query the status of the keyboard lock function. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0.
PAGE 163
RIGOL Chapter 2 Command System :SYSTem:OPTion:UNINSTall Syntax Description :SYSTem:OPTion:UNINSTall Uninstall the options installed. :SYSTem:RAM? Syntax Description Return Format :SYSTem:RAM? Query the number of analog channels of the instrument. The query always returns 4. :SYSTem:SETup Syntax :SYSTem:SETup :SYSTem:SETup? Description Import the setting parameters of the oscilloscope to restore the oscilloscope to the specified setting. Query the setting of the oscilloscope.
PAGE 164
RIGOL Chapter 2 Command System [:TRACe[]] Commands The [:TRACe[]] commands are used to set the arbitrary waveform parameters of the built-in signal sources. can be 1 or 2 which denotes the corresponding built-in signal source channel. If or :TRACe[] 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
RIGOL Chapter 2 Command System [:TRACe[]]:DATA:DAC16 Syntax Description Parameter Explanation [:TRACe[]]:DATA:DAC16 volatile,, Download binary data block to the volatile memory of the specified signal source.
PAGE 166
RIGOL Chapter 2 Command System [:TRACe[]]:DATA:DAC Syntax Description Parameter Explanation 2-150 [:TRACe[]]:DATA:DAC volatile,[|,,...] Download binary data block or decimal waveform values to the volatile memory of the specified signal source. Name Type Range Default Discrete {1|2} 1 Refer to Explanation Integer 0 to 16383 --  denotes the binary data to be downloaded.
PAGE 167
RIGOL Chapter 2 Command System [:TRACe[]]:DATA:POINts Syntax [:TRACe[]]:DATA:POINts volatile, [:TRACe[]]:DATA:POINts? volatile Description Parameter Explanation Return Format Example Set or query the initial number of points of the arbitrary waveform of the specified signal source channel. Name Type Range Default Discrete {1|2} 1 Integer 1 to 16384 2  This command initializes the voltage value of each point on the volatile waveform to 0μV automatically.
PAGE 168
RIGOL Chapter 2 Command System [:TRACe[]]:DATA:VALue Syntax [:TRACe[]]:DATA:VALue volatile,, [:TRACe[]]:DATA:VALue? volatile, Description Parameter Explanation Return Format Example Modify or query the decimal value of the specified point in the volatile memory of the specified signal source.
PAGE 169
RIGOL Chapter 2 Command System :TIMebase Commands The :TIMebase commands are used to set the horizontal parameters, such as enabling the delayed sweep and setting the horizontal timebase mode.
PAGE 170
RIGOL Chapter 2 Command System :TIMebase:DELay:OFFSet Syntax :TIMebase:DELay:OFFSet :TIMebase:DELay:OFFSet? Description Parameter Explanation Return Format Example Related Commands Set or query the delayed timebase offset. The default unit is s.
PAGE 171
RIGOL Chapter 2 Command System :TIMebase:DELay:SCALe Syntax :TIMebase:DELay:SCALe :TIMebase:DELay:SCALe? Description Parameter Explanation Return Format Example Set or query the delayed timebase scale. The default unit is s/div. Name Type Range Default Real Refer to Explanation 500ns/div  The maximum value of is the main timebase scale currently set, and the minimum value is expressed as: 50/(current sample rate x amplification factor).
PAGE 172
RIGOL Chapter 2 Command System Related Commands :TIMebase[:MAIN]:SCALe :ACQuire:SRATe? :TRIGger:MODE :TIMebase[:MAIN]:OFFSet Syntax :TIMebase[:MAIN]:OFFSet :TIMebase[:MAIN]:OFFSet? Description Parameter Explanation Return Format Example Related Commands Set or query the main timebase offset. The default unit is s.
PAGE 173
RIGOL Chapter 2 Command System :TIMebase[:MAIN]:SCALe Syntax :TIMebase[:MAIN]:SCALe :TIMebase[:MAIN]:SCALe? Description Set or query the main timebase scale. The default unit is s/div.
PAGE 174
RIGOL Chapter 2 Command System :TRIGger Commands The :TRIGger commands are used to set the trigger system of the oscilloscope.
PAGE 175
RIGOL Chapter 2 Command System :TRIGger:COUPling Syntax :TRIGger:COUPling :TRIGger:COUPling? Description Parameter Explanation Return Format Example Select or query the trigger coupling type. Name Type Range Default Discrete {AC|DC|LFReject|HFReject} DC  This command is only applicable to edge trigger of which the signal source is an analog channel.  AC: block all the DC components and attenuate signals lower than 75 kHz.
PAGE 176
RIGOL Chapter 2 Command System :TRIGger:HOLDoff Syntax :TRIGger:HOLDoff :TRIGger:HOLDoff? Description Parameter Explanation Return Format Example Set or query the trigger holdoff time. The default unit is s. Name Type Range Default Real 16ns to 10s 16ns  Trigger holdoff can be used to stably trigger the complex waveforms (such as pulse series). Holdoff time is the time that the oscilloscope waits before re-arming the trigger circuitry.
PAGE 177
RIGOL Chapter 2 Command System :TRIGger:POSition? Syntax Description Return Format Example :TRIGger:POSition? Query the position in the internal memory that corresponds to the waveform trigger position. The query returns an integer.  -2 denotes that the instrument is not triggered and there is no trigger position.
PAGE 178
RIGOL Chapter 2 Command System :TRIGger:EDGe Command List:  :TRIGger:EDGe:SOURce  :TRIGger:EDGe:SLOPe  :TRIGger:EDGe:LEVel :TRIGger:EDGe:SOURce Syntax :TRIGger:EDGe:SOURce :TRIGger:EDGe:SOURce? Description Parameter Explanation Return Format Example Set or query the trigger source in edge trigger.
PAGE 179
RIGOL Chapter 2 Command System :TRIGger:EDGe:LEVel Syntax :TRIGger:EDGe:LEVel :TRIGger:EDGe:LEVel? Description Parameter Explanation Return Format Example Set or query the trigger level in edge trigger. The unit is the same as the current amplitude unit of the signal source selected. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0  For VerticalScale, refer to the :CHANnel:SCALe command.
PAGE 180
RIGOL Chapter 2 Command System :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 :TRIGger:PULSe:SOURce? Description Parameter Explanation Return Format Example 2-164 Set or query the trigger source in pulse width trigger.
PAGE 181
RIGOL Chapter 2 Command System :TRIGger:PULSe:WHEN Syntax :TRIGger:PULSe:WHEN :TRIGger:PULSe:WHEN? Description Parameter Explanation Return Format Example Set or query the trigger condition in pulse width trigger. Name Type Range Default Discrete {PGReater|PLESs|NGReater| NLESs|PGLess|NGLess} PGReater  PGReater/PLESs: you need to specify a pulse width (refer to :TRIGger:PULSe:WIDTh).
PAGE 182
RIGOL Chapter 2 Command System :TRIGger:PULSe:UWIDth Syntax :TRIGger:PULSe:UWIDth :TRIGger:PULSe:UWIDth? Description Parameter Explanation Return Format Example Related Command Set or query the upper pulse width in pulse width trigger. The default unit is s. Name Type Range Default Real 16ns to 10s 2μs This command is available when the trigger condition (refer to :TRIGger:PULSe:WHEN) is PGLess and NGLess. The query returns the upper pulse width in scientific notation.
PAGE 183
RIGOL Chapter 2 Command System :TRIGger:PULSe:LEVel Syntax :TRIGger:PULSe:LEVel :TRIGger:PULSe:LEVel? Description Parameter Explanation Return Format Example Set or query the trigger level in pulse width trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0  For VerticalScale, refer to the :CHANnel:SCALe command. For OFFSet, refer to the :CHANnel:OFFSet command.
PAGE 184
RIGOL Chapter 2 Command System :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 :TRIGger:SLOPe:SOURce? Description Parameter Return Format Example 2-168 Set or query the trigger source in slope trigger.
PAGE 185
RIGOL Chapter 2 Command System :TRIGger:SLOPe:WHEN Syntax :TRIGger:SLOPe:WHEN :TRIGger:SLOPe:WHEN? Description Parameter Explanation Return Format Example Set or query the trigger condition in slope trigger. Name Type Range Default Discrete {PGReater|PLESs|NGReater| NLESs|PGLess|NGLess} PGReater  PGReater/PLESs: you need to specify a time value (refer to :TRIGger:SLOPe:TIME).
PAGE 186
RIGOL Chapter 2 Command System :TRIGger:SLOPe:TUPPer Syntax :TRIGger:SLOPe:TUPPer :TRIGger:SLOPe:TUPPer? Description Parameter Explanation Return Format Example Related Command Set or query the upper limit of the time in slope trigger. The default unit is s. Name Type Range Default Real 16ns to 10s 2μs This command is available when the trigger condition (refer to :TRIGger:SLOPe:WHEN) is PGLess and NGLess. The query returns the upper limit of the time in scientific notation.
PAGE 187
RIGOL Chapter 2 Command System :TRIGger:SLOPe:WINDow Syntax :TRIGger:SLOPe:WINDow :TRIGger:SLOPe:WINDow? Description Parameter Explanation Return Format Example Set or query the vertical window type in slope trigger. Name Type Range Default Discrete {TA|TB|TAB} TA  TA: only adjust the upper limit of the trigger level, refer to :TRIGger:SLOPe:ALEVel.  TB: only adjust the lower limit of the trigger level, refer to :TRIGger:SLOPe:BLEVel.
PAGE 188
RIGOL Chapter 2 Command System :TRIGger:SLOPe:BLEVel Syntax :TRIGger:SLOPe:BLEVel :TRIGger:SLOPe:BLEVel? Description Parameter Explanation Return Format Example Related Command 2-172 Set or query the lower limit of the trigger level in slope trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0 For VerticalScale, refer to :CHANnel:SCALe.
PAGE 189
RIGOL Chapter 2 Command System :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 :TRIGger:VIDeo:SOURce? Description Parameter Return Format Example Select or query the trigger source in video trigger.
PAGE 190
RIGOL Chapter 2 Command System :TRIGger:VIDeo:MODE Syntax :TRIGger:VIDeo:MODE :TRIGger:VIDeo:MODE? Description Parameter Explanation Return Format Example Related Commands Set or query the sync type in video trigger. Name Type Range Default Discrete {ODDField|EVENfield|LINE|ALINes} ALINes  ODDField: trigger on the rising edge of the first ramp waveform pulse in the odd field. This type is available when the video standard is NTSC or PAL/SECAM.
PAGE 191
RIGOL Chapter 2 Command System :TRIGger:VIDeo:STANdard Syntax :TRIGger:VIDeo:STANdard :TRIGger:VIDeo:STANdard? Description Parameter Explanation Return Format Example Related Commands Set or query the video standard in video trigger. Name Type Range Default Discrete {PALSecam|NTSC|480P|576P} NTSC  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
RIGOL Chapter 2 Command System :TRIGger:PATTern Command List:  :TRIGger:PATTern:PATTern  :TRIGger:PATTern:LEVel 2-176 MSO1000Z/DS1000Z Programming Guide
PAGE 193
RIGOL Chapter 2 Command System :TRIGger:PATTern:PATTern Syntax :TRIGger:PATTern:PATTern [,[, [,[,…[,]]]]] :TRIGger:PATTern:PATTern? Description Parameter Explanation Set or query the pattern of each channel in pattern trigger.
PAGE 194
RIGOL Chapter 2 Command System :TRIGger:PATTern:LEVel Syntax :TRIGger:PATTern:LEVel , :TRIGger:PATTern:LEVel? Description Parameter Explanation Return Format Example 2-178 Set or query the trigger level of the specified channel in pattern trigger. The unit is the same as the current amplitude unit.
PAGE 195
RIGOL Chapter 2 Command System :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 :TRIGger:DURATion:SOURce? Description Parameter Explanation Return Format Example Set or query the trigger source in duration trigger.
PAGE 196
RIGOL Chapter 2 Command System :TRIGger:DURATion:TYPe Syntax :TRIGger:DURATion:TYPe [,[, [,[,…[,]]]]] :TRIGger:DURATion:TYPe? Description Parameter Explanation Return Format Example Set or query the pattern of each channel in duration trigger.
PAGE 197
RIGOL Chapter 2 Command System :TRIGger:DURATion:WHEN Syntax :TRIGger:DURATion:WHEN :TRIGger:DURATion:WHEN? Description Parameter Explanation Return Format Example Set or query the trigger condition in duration trigger. Name Type Range Default Discrete {GREater|LESS|GLESs} GREater  GREater: you need to specify a time (refer to :TRIGger:DURATion:TLOWer). The oscilloscope triggers when the duration of the pattern is greater than the preset time.
PAGE 198
RIGOL Chapter 2 Command System :TRIGger:DURATion:TLOWer Syntax :TRIGger:DURATion:TLOWer :TRIGger:DURATion:TLOWer? Description Parameter Explanation Return Format Example Related Command 2-182 Set or query the duration time lower limit in duration trigger. The default unit is s. Name Type Range Default Real 8ns to 9.99s 1μs This command is available when the trigger condition (:TRIGger:DURATion:WHEN) is GREater or GLESs.
PAGE 199
RIGOL Chapter 2 Command System :TRIGger:TIMeout (Option) Command List:  :TRIGger:TIMeout:SOURce  :TRIGger:TIMeout:SLOPe  :TRIGger:TIMeout:TIMe :TRIGger:TIMeout:SOURce Syntax :TRIGger:TIMeout:SOURce :TRIGger:TIMeout:SOURce? Description Parameter Explanation Return Format Example Set or query the trigger source in timeout trigger.
PAGE 200
RIGOL Chapter 2 Command System :TRIGger:TIMeout:TIMe Syntax :TRIGger:TIMeout:TIMe :TRIGger:TIMeout:TIMe? Description Parameter Return Format Example 2-184 Set or query the timeout time in timeout trigger. The default unit is s. Name Type Range Default Real 16ns to 10s 16ns The query returns the timeout time in scientific notation. :TRIGger:TIMeout:TIMe 0.002 :TRIGger:TIMeout:TIMe? /*Set the timeout time to 2ms*/ /*The query returns 2.
PAGE 201
RIGOL Chapter 2 Command System :TRIGger:RUNT (Option) 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 :TRIGger:RUNT:SOURce? Description Parameter Return Format Example Set or query the trigger source in runt trigger.
PAGE 202
RIGOL Chapter 2 Command System :TRIGger:RUNT:WHEN Syntax :TRIGger:RUNT:WHEN :TRIGger:RUNT:WHEN? Description Parameter Explanation Return Format Example Set or query the qualifier in runt trigger. Name Type Range Default Discrete {NONE|GREater|LESS|GLESs} NONE  NONE: do not set the trigger condition in runt trigger.  GREater: trigger when the runt pulse width is greater than the lower limit of the pulse width (refer to :TRIGger:RUNT:WLOWer).
PAGE 203
RIGOL Chapter 2 Command System :TRIGger:RUNT:WLOWer Syntax :TRIGger:RUNT:WLOWer :TRIGger:RUNT:WLOWer? Description Parameter Explanation Return Format Example Set or query the pulse width lower limit in runt trigger. The default unit is s. Name Type Range Default Real When the qualifier is GREater, the range is from 8ns to 10s; when the qualifier is GLESs, the range is from 8ns to 9.99s.
PAGE 204
RIGOL Chapter 2 Command System :TRIGger:RUNT:BLEVel Syntax :TRIGger:RUNT:BLEVel :TRIGger:RUNT:BLEVel? Description Parameter Explanation Return Format Example 2-188 Set or query the trigger level lower limit in runt trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0 For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
PAGE 205
RIGOL Chapter 2 Command System :TRIGger:WINDows (Option) 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 :TRIGger:WINDows:SOURce? Description Parameter Return Format Example Set or query the trigger source in windows trigger.
PAGE 206
RIGOL Chapter 2 Command System :TRIGger:WINDows:POSition Syntax :TRIGger:WINDows:POSition :TRIGger:WINDows:POSition? Description Parameter Explanation Return Format Example Set or query the trigger position in windows trigger. Name Type Range Default Discrete {EXIT|ENTER|TIMe} ENTER  EXIT: trigger when the input signal exits the specified trigger level range.  ENTER: trigger when the trigger signal enters the specified trigger level range.
PAGE 207
RIGOL Chapter 2 Command System :TRIGger:WINDows:ALEVel Syntax :TRIGger:WINDows:ALEVel :TRIGger:WINDows:ALEVel? Description Parameter Explanation Return Format Example Set or query the trigger level upper limit in windows trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 2V For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
PAGE 208
RIGOL Chapter 2 Command System :TRIGger:DELay (Option) 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 :TRIGger:DELay:SA? Description Parameter Return Format Example Set or query the trigger source A in delay trigger.
PAGE 209
RIGOL Chapter 2 Command System :TRIGger:DELay:SB Syntax :TRIGger:DELay:SB :TRIGger:DELay:SB? Description Parameter Return Format Example Set or query the trigger source B in delay trigger. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel2 The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
PAGE 210
RIGOL Chapter 2 Command System :TRIGger:DELay:TYPe Syntax :TRIGger:DELay:TYPe :TRIGger:DELay:TYPe? Description Parameter Explanation Return Format Example Related Commands Set or query the delay type in delay trigger. Name Type Range Default Discrete {GREater|LESS|GLESs |GOUT} GREater  GREater: trigger when the time difference (△T) between the specified edges of tigger source A and tigger source B is greater than the preset time limit.
PAGE 211
RIGOL Chapter 2 Command System :TRIGger:DELay:TLOWer Syntax :TRIGger:DELay:TLOWer :TRIGger:DELay:TLOWer? Description Parameter Explanation Return Format Example Related Command Set or query the lower limit of the delay time in delay trigger. The default unit is s. Name Type Range Default Real Related to the delay type GREater: 8ns to 10s GOUT or GLESs: 8ns to 9.99s 1μs This command is only available when the delay type (refer to :TRIGger:DELay:TYPe) is GREater, GOUT, or GLESs.
PAGE 212
RIGOL Chapter 2 Command System :TRIGger:SHOLd (Option) 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 :TRIGger:SHOLd:DSrc? Description Parameter Return Format Example Set or query the data source in setup/hold trigger.
PAGE 213
RIGOL Chapter 2 Command System :TRIGger:SHOLd:SLOPe Syntax :TRIGger:SHOLd:SLOPe :TRIGger:SHOLd:SLOPe? Description Parameter Return Format Example Set or query the edge type in setup/hold trigger. Name Type Range Default Discrete {POSitive|NEGative} POSitive The query returns POS or NEG.
PAGE 214
RIGOL Chapter 2 Command System :TRIGger:SHOLd:STIMe Syntax :TRIGger:SHOLd:STIMe :TRIGger:SHOLd:STIMe? Description Parameter Explanation Return Format Example Related Command Set or query the setup time in setup/hold trigger. The default unit is s. Name Type Range Default Real 8ns to 1s 1μs  Setup time refers to the period of time that the data stays stable and constant before the clock signal of the trigger appears.
PAGE 215
RIGOL Chapter 2 Command System :TRIGger:NEDGe (Option) Command List:  :TRIGger:NEDGe:SOURce  :TRIGger:NEDGe:SLOPe  :TRIGger:NEDGe:IDLE  :TRIGger:NEDGe:EDGE  :TRIGger:NEDGe:LEVel :TRIGger:NEDGe:SOURce Syntax :TRIGger:NEDGe:SOURce :TRIGger:NEDGe:SOURce? Description Parameter Explanation Return Format Example Set or query the trigger source in Nth edge trigger.
PAGE 216
RIGOL Chapter 2 Command System :TRIGger:NEDGe:IDLE Syntax :TRIGger:NEDGe:IDLE :TRIGger:NEDGe:IDLE? Description Parameter Return Format Example Set or query the idle time in Nth edge trigger. The default unit is s. Name Type Range Default Real 16ns to 10s 1μs The query returns the idle time in scientific notation. :TRIGger:NEDGe:IDLE 0.002 :TRIGger:NEDGe:IDLE? /*Set the idle time to 2ms*/ /*The query returns 2.
PAGE 217
RIGOL Chapter 2 Command System :TRIGger:RS232 (Option) 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 :TRIGger:RS232:SOURce? Description Parameter Explanation Return Format Example Set or query the trigger source in RS232 trigger.
PAGE 218
RIGOL Chapter 2 Command System :TRIGger:RS232:WHEN Syntax :TRIGger:RS232:WHEN :TRIGger:RS232:WHEN? Description Parameter Explanation Return Format Example Related Command Set or query the trigger condition in RS232 trigger. Name Type Range Default Discrete {STARt|ERRor|PARity|DATA} STARt  STARt: trigger on the start frame position.  ERRor: trigger when error frame is detected.  PARity: trigger when check error is detected.
PAGE 219
RIGOL Chapter 2 Command System :TRIGger:RS232:STOP Syntax :TRIGger:RS232:STOP :TRIGger:RS232:STOP? Description Parameter Return Format Example Related Command Set or query the stop bit when the trigger condition is ERRor in RS232 trigger. Name Type Range Default Discrete {1|2} 1 The query returns 1 or 2.
PAGE 220
RIGOL Chapter 2 Command System :TRIGger:RS232:BAUD Syntax :TRIGger:RS232:BAUD :TRIGger:RS232:BAUD? Description Parameter Return Format Example Related Command Set or query the baud rate in RS232 trigger. The default unit is bps. Name Type Range Default Discrete {2400|4800|9600|19200|38400|57600| 115200|230400|460800|921600|1000000| USER} 9600 The query returns an integer or USER.
PAGE 221
RIGOL Chapter 2 Command System :TRIGger:RS232:LEVel Syntax :TRIGger:RS232:LEVel :TRIGger:RS232:LEVel? Description Parameter Explanation Return Format Example Set or query the trigger level in RS232 trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0  For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
PAGE 222
RIGOL Chapter 2 Command System :TRIGger:IIC (Option) 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 :TRIGger:IIC:SCL? Description Parameter Explanation Return Format Example Set or query the channel source of SCL in I2C trigger.
PAGE 223
RIGOL Chapter 2 Command System :TRIGger:IIC:WHEN Syntax :TRIGger:IIC:WHEN :TRIGger:IIC:WHEN? Description Parameter Explanation Return Format Example Set or query the trigger condition in I2C trigger. Name Type Range Default Discrete {STARt|RESTart|STOP|NACKnowledge| ADDRess|DATA|ADATa} STARt  STARt: trigger when the SDA data transitions from high to low while the SCL is high.  RESTart: trigger when another start condition occurs before a stop condition.
PAGE 224
RIGOL Chapter 2 Command System :TRIGger:IIC:ADDRess Syntax :TRIGger:IIC:ADDRess :TRIGger:IIC:ADDRess? Description Parameter Set or query the address when the trigger condition is ADDRess or ADATa in I2C trigger. Name Explanation Return Format Example Related Command Type Integer Range Default n 0 to 2 -1: 0 to 127, 0 to 255, or 0 to 1023 1 In the expression 2n-1, n is the current address bits. The query returns an integer.
PAGE 225
RIGOL Chapter 2 Command System :TRIGger:IIC:CLEVel Syntax :TRIGger:IIC:CLEVel :TRIGger:IIC:CLEVel? Description Parameter Explanation Return Format Example Set or query the trigger level of SCL in I2C trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0  For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
PAGE 226
RIGOL Chapter 2 Command System :TRIGger:SPI (Option) 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 :TRIGger:SPI:SCL? Description Parameter Explanation Return Format Example 2-210 Set or query the channel source of SC
PAGE 227
RIGOL Chapter 2 Command System :TRIGger:SPI:SDA Syntax :TRIGger:SPI:SDA :TRIGger:SPI:SDA? Description Parameter Explanation Return Format Example Set or query the channel source of SDA in SPI trigger. Name Type Range Default Discrete {D0|D1|D2|D3|D4|D5|D6|D7|D8| D9|D10|D11|D12|D13|D14|D15| CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel2 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
RIGOL Chapter 2 Command System :TRIGger:SPI:DATA Syntax :TRIGger:SPI:DATA :TRIGger:SPI:DATA? Description Parameter Set or query the data in SPI trigger. Name Explanation Return Format Type Integer Range Default 32 0 to 2 -1 82 The range of is related to the data bits. The maximum data bits is 32. Thus, the range of is from 0 to 232-1. The query returns an integer.
PAGE 229
RIGOL Chapter 2 Command System :TRIGger:SPI:CLEVel Syntax :TRIGger:SPI:CLEVel :TRIGger:SPI:CLEVel? Description Parameter Explanation Return Format Example Set or query the trigger level of the SCL channel in SPI trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0  For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
PAGE 230
RIGOL Chapter 2 Command System :TRIGger:SPI:SLEVel Syntax :TRIGger:SPI:SLEVel :TRIGger:SPI:SLEVel? Description Parameter Explanation Return Format Example Set or query the trigger level of the CS channel in SPI trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0  For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
PAGE 231
RIGOL Chapter 2 Command System :TRIGger:SPI:CS Syntax :TRIGger:SPI:CS :TRIGger:SPI:CS? Description Parameter Explanation Return Format Example Set or query the data source of the CS signal in SPI trigger.
PAGE 232
RIGOL Chapter 2 Command System :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
RIGOL Chapter 2 Command System 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 :WAVeform:SOURce? Description Parameter Explanation Return Format Example Related Command Set or query the channel o
PAGE 234
RIGOL Chapter 2 Command System :WAVeform:MODE Syntax :WAVeform:MODE :WAVeform:MODE? Description Parameter Explanation Return Format Example Set or query the reading mode used by :WAVeform:DATA?. Name Type Range Default Discrete {NORMal|MAXimum|RAW} NORMal  NORMal: read the waveform data displayed on the screen.  MAXimum: read the waveform data displayed on the screen when the instrument is in the run state and the waveform data in the internal memory in the stop state.
PAGE 235
RIGOL Chapter 2 Command System :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. :WAV:FORM BYTE Set the return format of the waveform data to BYTE S4.
PAGE 236
RIGOL Chapter 2 Command System 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 Set the stop point of waveform data reading to the 120000th waveform point (the last point) Read the waveform data in the internal memory (all the points) S6. :WAV:STOP 120000 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 Format  The return format is related to the return format of the waveform data currently selected (:WAVeform:FORMat). WORD or BYTE format: the data returned consists of 2 parts, including the TMC data description header and the waveform data.
PAGE 238
RIGOL Chapter 2 Command System :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. In the RAW mode, XINCrement = 1/SampleRate.
PAGE 239
RIGOL Chapter 2 Command System :WAVeform:XREFerence? Syntax Description Return Format Related Command :WAVeform:XREFerence? Query the reference time of the specified channel source in the X direction. The query returns 0 (namely the first point on the screen or in the internal memory). :WAVeform:SOURce :WAVeform:YINCrement? Syntax :WAVeform:YINCrement? Description Query the waveform increment of the specified channel source in the Y direction. The unit is the same as the current amplitude unit.
PAGE 240
RIGOL Chapter 2 Command System :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). In RAW mode, YREFerence is related to the Verticalscale of the internal waveform and the Verticalscale currently selected.
PAGE 241
RIGOL Chapter 2 Command System :WAVeform:STOP Syntax :WAVeform:STOP :WAVeform:STOP? Description Parameter Set or query the stop point of waveform data reading.
PAGE 242
RIGOL Chapter 2 Command System :WAVeform:PREamble? Syntax Description Return Format :WAVeform:PREamble? Query and return all the waveform parameters. The query returns 10 waveform parameters separated by ",": ,,,,,,,,, Wherein, : 0 (BYTE), 1 (WORD) or 2 (ASC). : 0 (NORMal), 1 (MAXimum) or 2 (RAW). : an integer between 1 and 12000000.
PAGE 243
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. All the demos are based on VISA (Virtual Instrument Software Architecture).
PAGE 244
RIGOL Chapter 3 Programming Demos 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. Here, the default installation path is C:\Program Files\IVI Foundation\VISA.
PAGE 245
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. 1. Create a new Excel file that enables the Macros. In this demo, the file is named as IDN.xlsm. 2. Run the IDN.xlsm file. Click FileOptions at the upper-left corner of the Excel file to open the interface as shown in the figure below. Click Customize Ribbon at the right, check Developer and click OK.
PAGE 246
RIGOL Chapter 3 Programming Demos 3. 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. 4. Select Tools(T) in the Microsoft Visual Basic menu bar and click References.
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. (2) Click Browse… at the right and set the search range to C:\WINDOWS\system32 and the filename to visa32.dll, as shown in the figure below. 5. Click View Code in the Developer menu to enter the Microsoft Visual Basic interface. Add the following codes and save the file.
PAGE 248
RIGOL 6. Chapter 3 Programming Demos 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" and click "Run". By default, the button mane is "Button 1". Right-click the button and select Edit Text in the pop-up menu to change the button name to "*IDN?". 7. 3-6 Click the "*IDN?" button to send request and read data.
PAGE 249
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. 1. Run the Matlab software and modify the current directory (namely modify the Current Directory at the top of the software). In this demo, the current directory is modified to E:\MSO1000Z_Demo. 2. Click File  New  Blank M-File in the Matlab interface to create an empty M file. 3.
PAGE 250
RIGOL 5. 3-8 Chapter 3 Programming Demos Run the M file and the running result is as follows.
PAGE 251
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. 1. Run LabVIEW 2009, create a VI file and name it as MSO1000Z_Demo. 2. Add controls. Right-click in the Front Panel interface, select and add VISA resource name and Waveform Graph from the Controls column, as shown in the figures below.
PAGE 252
RIGOL Chapter 3 Programming Demos 3. 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. 4. Connect the VISA resource name with the VISA Open. Then, connect the VISA resource name outputs of all the functions with the VISA resource name and connect the error output with the error input as shown in the figure below. 5.
PAGE 253
Chapter 3 Programming Demos RIGOL Get the length of the effective waveform data. 7. 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. 8. The complete program block diagram is as shown in the figure below.
PAGE 254
RIGOL 9. 3-12 Chapter 3 Programming Demos Select the device resource from the VISA Resource Name list box and run the program.
PAGE 255
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: 1. Build a standard application program project (Standard EXE) and name it as Demo. 2. Click the Existing tab of ProjectAdd Module. Search for the visa32.bas file in the include folder under the NI-VISA installation path and add the file. 3.
PAGE 256
RIGOL Chapter 3 Programming Demos 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 Call viOpen(defrm, matches, 0, 0, vi) ' Send the command to query the status of CH1 Call viVPrintf(vi, ":CHAN1:DISP?" + Chr$(10), 0) ' Acquire the status of CH1 Call viVScanf(vi, "%t", strRes) s32Disp = CInt(strRes) If (s32Disp = 1) Then ' Send the settin
PAGE 257
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. Enter Visual C++6.0 and operate according to the following steps: 1. Create a MFC project based on dialog box. 2. Open the C/C++ tab in ProjectSettings, select Code Generation in Category and Debug Multithreaded DLL in Use run-time library.
PAGE 258
RIGOL 4. Chapter 3 Programming Demos 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. Note: at present, VISA library has been added. 5.
PAGE 259
Chapter 3 Programming Demos RIGOL 7. Add the variables m_combox and m_receive for the Combo Box and Edit controls respectively. 8. Add codes. Double-click Send and Read to enter the programming environment. Declare the #include of the visa library in the header file and then add the following codes.
PAGE 260
RIGOL Chapter 3 Programming Demos 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); m_receive = buf; UpdateData (FALSE); viClose (vi); viClose (defaultRM); 9.