Page 1 RIGOL Programming Guide DS4000E Series Digital Oscilloscope Aug. 2016 RIGOL TECHNOLOGIES, INC.
Page 3 Notices RIGOL products are covered by P.R.C. and foreign patents, issued and pending.  RIGOL reserves the right to modify or change parts or all of the specifications and pricing policies at  the company's sole decision. Information in this publication replaces all previously released materials.
Page 4: Document Overview
This chapter introduces the syntax, function, parameters, and usage of each command. Chapter 3 Programming Examples This chapter illustrates how to control the DS4000E series digital oscilloscope by programming in Excel, LabVIEW, MATLAB, Visual Basic 6.0, and Visual C++ 6.0.
Page 5: Table Of Contents
RIGOL Contents Contents Guaranty and Declaration ......................I Document Overview ......................... II Chapter 1 SCPI Command Overview .................. 1-1 Syntax ............................. 1-1 Symbol Description ........................1-1 Parameter Type ........................1-2 Command Abbreviation ......................1-2 Chapter 2 Command System ....................2-1 :AUToscale ..........................
Page 6 RIGOL Contents :CHANnel<n>:DISPlay ...................... 2-62 :CHANnel<n>:IMPedance ....................2-62 :CHANnel<n>:INVert ......................2-62 :CHANnel<n>:OFFSet....................... 2-63 :CHANnel<n>:PEND ......................2-63 :CHANnel<n>:PROBe ....................... 2-64 :CHANnel<n>:SCALe ......................2-64 :CHANnel<n>:TCALibrate ....................2-65 :CHANnel<n>:TYPE? ......................2-65 :CHANnel<n>:UNITs ......................2-65 :CHANnel<n>:VERNier ..................... 2-66 :CURSor Commands ........................ 2-67 :CURSor:MODE ........................ 2-68 :CURSor:MANual ......................
Page 7 RIGOL Contents :MASK:DATA ........................2-109 :MASK:ENABle ....................... 2-110 :MASK:FAILed? ......................2-110 :MASK:MDISplay ......................2-110 :MASK:OPERate ......................2-111 :MASK:OUTPut....................... 2-111 :MASK:PASSed? ......................2-112 :MASK:RESet ......................... 2-112 :MASK:SOOutput ......................2-112 :MASK:SOURce ......................2-113 :MASK:TOTal? ........................ 2-113 :MASK:X ........................2-113 :MASK:Y ........................2-114 :MEASure Commands ......................
Page 8 RIGOL Contents :MEASure:VAMP ......................2-155 :MEASure:VAVG......................2-156 :MEASure:VBASe ......................2-158 :MEASure:VMAX ......................2-159 :MEASure:VMIN......................2-161 :MEASure:VPP ........................ 2-162 :MEASure:VRMS ......................2-164 :MEASure:VTOP......................2-165 :RECall Commands ........................ 2-167 :RECall:MTESt ........................ 2-167 :RECall:REFerence ......................2-167 :RECall:SETup ........................ 2-168 :RECall:TRACe ........................ 2-168 :RECall:WAVeform ......................2-169 :REFerence Commands ......................
Page 9 RIGOL Contents :SYSTem:TIME ....................... 2-187 :SYSTem:UDEVice ......................2-188 :SYSTem:VERSion? ......................2-188 :TIMebase Commands ......................2-189 :TIMebase:DELay:ENABle ....................2-189 :TIMebase:DELay:OFFSet ....................2-189 :TIMebase:DELay:SCALe ....................2-190 :TIMebase:HREF:MODE ....................2-190 :TIMebase:HREF:POSition ....................2-191 :TIMebase:MODE ......................2-191 :TIMebase:VERNier ......................2-191 :TIMebase:XY1:DISPlay ....................2-192 :TIMebase:XY2:DISPlay ....................2-192 :TIMebase[:MAIN]:OFFSet....................
Page 10 RIGOL Contents LabVIEW Programming Example ....................3-7 MATLAB Programming Example ....................3-11 Visual Basic 6.0 Programming Example ..................3-13 Visual C++ 6.0 Programming Example ..................3-15 VIII DS4000E Programming Guide...
Page 11: Chapter 1 Scpi Command Overview
RIGOL Chapter 1 SCPI Command Overview Chapter 1 SCPI Command Overview This chapter introduces the syntax, symbols, parameters, and abbreviation rules of the SCPI commands. Contents in this chapter: Syntax  Symbol Description  Parameter Type  Command Abbreviation ...
Page 12: Parameter Type
RIGOL Chapter 1 SCPI Command Overview Parameter Type Bool The available values for the parameter is 1 (ON) or 0 (OFF). For example, :MEASure:ADISplay <bool> :MEASure:ADISplay? Wherein, <bool> can be set to {{1|ON}|{0|OFF}}. The query returns 1 or 0. Discrete The parameter can be any of the values listed.
Page 13: Chapter 2 Command System
RIGOL Chapter 2 Command System Chapter 2 Command System This chapter introduces the syntax, function, parameters, and usage of each DS4000E command. Contents in this chapter: :AUToscale  :CLEar  :RUN  :STOP  :SINGle  :TFORce  :TLHAlf ...
Page 14: Clear
RIGOL Chapter 2 Command System When the pass/fail test function is enabled (refer to the :MASK:ENABle command), this command is  invalid. The waveform auto setting function requires that the frequency of sine waveform is no less than 20 Hz ...
Page 15: Tforce
RIGOL Chapter 2 Command System :TFORce Syntax :TFORce Description Generates a trigger signal forcefully. This command is only applicable to the normal and single trigger modes, refer to the :TRIGger:SWEep command. This command functions the same as the FORCE key in the trigger control area of the front panel.
Page 16: Acquire Commands
RIGOL Chapter 2 Command System :ACQuire Commands Command List :ACQuire:AALias  :ACQuire:AVERages  :ACQuire:MDEPth  :ACQuire:SRATe?  :ACQuire:TYPE  Note : In the "Command List" in this manual, the query commands and the parameters in the setting commands are omitted. You can refer to the complete introductions of the commands in the body of the text based on the keywords listed here.
Page 17: Acquire:mdepth
RIGOL Chapter 2 Command System :ACQuire:MDEPth Syntax :ACQuire:MDEPth <mdep> :ACQuire:MDEPth? Description Sets or queries the memory depth of the oscilloscope (namely the number of waveform points that can be stored through sampling in a single trigger). The default unit is pts (points).
Page 18 RIGOL Chapter 2 Command System make an average on the waveforms, so as to lower the random noises of the input signals and increase its vertical resolution. You can use the :ACQuire:AVERages command to set the number of averages in this mode.
Page 19: Bus Commands
RIGOL Chapter 2 Command System :BUS<n> Commands Command List: :BUS<n>:DATA?  :BUS<n>:DISPlay  :BUS<n>:EEXPort  :BUS<n>:EVENt  :BUS<n>:FORMat  :BUS<n>:MODE  :BUS<n>:CAN (Option)  :BUS<n>:FLEXray (Option)  :BUS<n>:IIC (Option)  :BUS<n>:PARallel  :BUS<n>:RS232 (Option)  :BUS<n>:SPI (Option)  :BUS<n>:DATA? Syntax :BUS<n>:DATA?
Page 20: Bus:Display
RIGOL Chapter 2 Command System :BUS<n>:DISPlay Syntax :BUS<n>:DISPlay <bool> :BUS<n>:DISPlay? Description Enables or disables the display of the specified decoding bus; or queries the on/off display status of the specified decoding bus. Parameter Name Type Range Default <n> Discrete {1|2} <bool>...
Page 21: Bus:Format
RIGOL Chapter 2 Command System :BUS<n>:FORMat Syntax :BUS<n>:FORMat <format> :BUS<n>:FORMat? Description Sets or queries the display format of decoding data of the specified decoding bus. Parameter Name Type Range Default <n> Discrete {1|2} <format> Discrete {HEX|DEC|BIN|ASCii} Return Format The query returns HEX, DEC, BIN, or ASC.
Page 22: Bus:Can (Option)
RIGOL Chapter 2 Command System :BUS<n>:CAN (Option) Command List: :BUS<n>:CAN:BAUD  :BUS<n>:CAN:BUSer  :BUS<n>:CAN:OFFSet  :BUS<n>:CAN:SOURce  :BUS<n>:CAN:SPOint  :BUS<n>:CAN:STYPe  :BUS<n>:CAN:THReshold  :BUS<n>:CAN:BAUD Syntax :BUS<n>:CAN:BAUD <baud> :BUS<n>:CAN:BAUD? Description Sets or queries the signal rate of CAN decoding on the specified bus. The default unit is b/s.
Page 23 RIGOL Chapter 2 Command System :BUS<n>:CAN:OFFSet Syntax :BUS<n>:CAN:OFFSet <val> :BUS<n>:CAN:OFFSet? Description Sets or queries the vertical position of CAN decoding data line on the specified bus. Parameter Name Type Range Default <n> Discrete {1|2} <val> Integer Refer to Remarks Remarks Before using the command, enable the display of the specified decoding bus (refer to ...
Page 24 RIGOL Chapter 2 Command System :BUS<n>:CAN:SPOint Syntax :BUS<n>:CAN:SPOint <spo> :BUS<n>:CAN:SPOint? Description Sets or queries the sample point position of CAN decoding on the specified bus (expressed in %) Parameter Name Type Range Default <n> Discrete {1|2} <spo> Integer 5 to 95 Remarks The sample point is within the range of the bit time.
Page 25 RIGOL Chapter 2 Command System :BUS<n>:CAN:THReshold Syntax :BUS<n>:CAN:THReshold <thre> :BUS<n>:CAN:THReshold? Description Sets or queries the threshold of the current source channel of CAN decoding on the specified bus. Parameter Name Type Range Default <n> Discrete {1|2} (-4 x VerticalScale - Offset) to (4 x VerticalScale - Offset) Wherein, VerticalScale is the vertical scale of the source channel, <thre>...
Page 26: Bus:Flexray (Option)
RIGOL Chapter 2 Command System :BUS<n>:FLEXray (Option) Command List: :BUS<n>:FLEXray:BAUD  :BUS<n>:FLEXray:OFFSet  :BUS<n>:FLEXray:SOURce  :BUS<n>:FLEXray:SPoint  :BUS<n>:FLEXray:STYPe  :BUS<n>:FLEXray:THReshold  :BUS<n>:FLEXray:BAUD Syntax :BUS<n>:FLEXray:BAUD <baud> :BUS<n>:FLEXray:BAUD? Description Sets or queries the signal rate of FlexRay decoding on the specified bus. The default unit is b/s.
Page 27 RIGOL Chapter 2 Command System below the middle part of the screen, <val> is a negative value. Return Format The query returns an integer. :BUS<n>:FLEXray:SOURce Syntax :BUS<n>:FLEXray:SOURce <source> :BUS<n>:FLEXray:SOURce? Description Sets or queries the source channel of FlexRay decoding on the specified bus.
Page 28 RIGOL Chapter 2 Command System Parameter Name Type Range Default <n> Discrete {1|2} <type> Discrete {BP|BM|RT} Return Format The query returns BP, BM, or RT. :BUS<n>:FLEXray:THReshold Syntax :BUS<n>:FLEXray:THReshold <thre> :BUS<n>:FLEXray:THReshold? Description Sets or queries the threshold of the current source channel of FlexRay decoding on the specified bus.
Page 29: Bus:Iic (Option)
RIGOL Chapter 2 Command System :BUS<n>:IIC (Option) Command List: :BUS<n>:IIC:OFFSet  :BUS<n>:IIC:SCLK:SOURce  :BUS<n>:IIC:SCLK:THReshold  :BUS<n>:IIC:SDA:SOURce  :BUS<n>:IIC:SDA:THReshold  :BUS<n>:IIC:OFFSet Syntax :BUS<n>:IIC:OFFSet <val> :BUS<n>:IIC:OFFSet? Description Sets or queries the vertical position of IIC decoding on the specified bus. Parameter Name...
Page 30 RIGOL Chapter 2 Command System Parameter Name Type Range Default <n> Discrete {1|2} <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Return Format The query returns CHAN1, CHAN2, CHAN3, or CHAN4. :BUS<n>:IIC:SCLK:THReshold Syntax :BUS<n>:IIC:SCLK:THReshold <thre> :BUS<n>:IIC:SCLK:THReshold? Description Sets or queries the threshold of the current clock line source channel of IIC decoding on the specified bus.
Page 31 RIGOL Chapter 2 Command System :BUS<n>:IIC:SDA:THReshold Syntax :BUS<n>:IIC:SDA:THReshold <thre> :BUS<n>:IIC:SDA:THReshold? Description Sets or queries the threshold of the current data line source channel of IIC decoding on the specified bus. Parameter Name Type Range Default <n> Discrete {1|2} (-4 x VerticalScale - Offset) to (4 x VerticalScale - Offset) Wherein, VerticalScale is the vertical scale of the data line source <thre>...
Page 32: Bus:Parallel
RIGOL Chapter 2 Command System :BUS<n>:PARallel Command List: :BUS<n>:PARallel:BSET  :BUS<n>:PARallel:CLK  :BUS<n>:PARallel:OFFSet  :BUS<n>:PARallel:SLOPe  :BUS<n>:PARallel:THReshold  :BUS<n>:PARallel:BSET Syntax :BUS<n>:PARallel:BSET <b0>[,<b1>[,<b2>[,<b3>]]] :BUS<n>:PARallel:BSET? Description Sets or queries the source channel of each bit of the data line of Parallel decoding on specified bus; or queries the data line source channel of Parallel decoding on the specified bus.
Page 33 RIGOL Chapter 2 Command System Remarks You can send the :BUS<n>:PARallel:SLOPe command to sample data channel's data on the rising edge, falling edge, or either of the edges of the clock signal. When <source> is set to "OFF" (disabling the clock channel), sampling is performed when a hop occurs to the data of the data channel during decoding.
Page 34 RIGOL Chapter 2 Command System Remarks POSitive: samples the data of the data channel on the rising edge of the clock signal.  NEGative: samples the data of the data channel on the falling edge of the clock signal. BOTH: samples the data of the data channel on both the rising and falling edge of the clock signal.
Page 35: Bus:Rs232 (Option)
RIGOL Chapter 2 Command System :BUS<n>:RS232 (Option) Command List: :BUS<n>:RS232:BAUD  :BUS<n>:RS232:BUSer  :BUS<n>:RS232:DBITs  :BUS<n>:RS232:ENDian  :BUS<n>:RS232:OFFSet  :BUS<n>:RS232:PACKet  :BUS<n>:RS232:PARity  :BUS<n>:RS232:PEND  :BUS<n>:RS232:POLarity  :BUS<n>:RS232:RTHReshold  :BUS<n>:RS232:RX  :BUS<n>:RS232:SBITs  :BUS<n>:RS232:TTHReshold  :BUS<n>:RS232:TX  :BUS<n>:RS232:BAUD Syntax :BUS<n>:RS232:BAUD <baud>...
Page 36 RIGOL Chapter 2 Command System Return Format The query returns an integer. :BUS<n>:RS232:DBITs Syntax :BUS<n>:RS232:DBITs <bits> :BUS<n>:RS232:DBITs? Description Sets or queries the data width (namely the actual number of data bits for each frame of data) of RS232 decoding on the specified bus.
Page 37 RIGOL Chapter 2 Command System Parameter Name Type Range Default <n> Discrete {1|2} Refer to Remarks <val> Integer Remarks Before using the command, enable the display of the specified decoding bus (refer to  the :BUS<n>:DISPlay command). The range of <val> is related to the screen display mode and the on/off status of the statistic function ...
Page 38 RIGOL Chapter 2 Command System Parameter Name Type Range Default <n> Discrete {1|2} <parity> Discrete {NONE|ODD|EVEN} NONE Remarks None: indicates that there is no parity bit in data transmission.  ODD: indicates the odd parity bit. The total count of occurrences of 1 in the data bit and check bit is an ...
Page 39 RIGOL Chapter 2 Command System Parameter Name Type Range Default <n> Discrete {1|2} <pol> Discrete {POSitive|NEGative} NEGative Remarks NEGative: Use negative logic. High level indicates logic "0"; low level indicates logic "1".  POSitive: Use positive logic. High level indicates logic "1"; low level indicates logic "0".
Page 40 RIGOL Chapter 2 Command System :BUS<n>:RS232:SBITs Syntax :BUS<n>:RS232:SBITs <stop bits> :BUS<n>:RS232:SBITs? Description Sets or queries the number of stop bits following each frame of data of RS232 decoding on the specified bus. Parameter Name Type Range Default <n> Discrete {1|2} <stop bits>...
Page 41 RIGOL Chapter 2 Command System Remarks When <source> is set to "OFF", it indicates that TX source channel is not set.  TX source channel and RX source channel (refer to the :BUS<n>:RS232:RX command) cannot be both  set to "OFF".
Page 42: Bus:Spi (Option)
RIGOL Chapter 2 Command System :BUS<n>:SPI (Option) Command List: :BUS<n>:SPI:DBITs  :BUS<n>:SPI:ENDian  :BUS<n>:SPI:MISO:POLarity  :BUS<n>:SPI:MISO:SOURce  :BUS<n>:SPI:MISO:THReshold  :BUS<n>:SPI:MODE  :BUS<n>:SPI:MOSI:POLarity  :BUS<n>:SPI:MOSI:SOURce  :BUS<n>:SPI:MOSI:THReshold  :BUS<n>:SPI:OFFSet  :BUS<n>:SPI:SCLK:SLOPe  :BUS<n>:SPI:SCLK:SOURce  :BUS<n>:SPI:SCLK:THReshold  :BUS<n>:SPI:SS:POLarity  :BUS<n>:SPI:SS:SOURce  :BUS<n>:SPI:SS:THReshold ...
Page 43 RIGOL Chapter 2 Command System Remarks MSB: Most Significant Bit. The transmission sequence shall be is in descending order.  LSB: Least Significant Bit. The transmission sequence shall be is in ascending order.  Return Format The query returns MSB or LSB.
Page 44 RIGOL Chapter 2 Command System Return Format The query returns CHAN1, CHAN2, CHAN3, CHAN4, or OFF. :BUS<n>:SPI:MISO:THReshold Syntax :BUS<n>:SPI:MISO:THReshold <thre> :BUS<n>:SPI:MISO:THReshold? Description Sets or queries the threshold of the source channel of MISO data line of SPI decoding on the specified bus.
Page 45 RIGOL Chapter 2 Command System :BUS<n>:SPI:MOSI:POLarity Syntax :BUS<n>:SPI:MOSI:POLarity <pol> :BUS<n>:SPI:MOSI:POLarity? Description Sets or queries the polarity of MOSI data line of SPI decoding on the specified bus. Parameter Name Type Range Default <n> Discrete {1|2} <pol> Discrete {HIGH|LOW} HIGH Remarks If the source channel of MOSI data line of SPI decoding on the specified bus is not set (refer to ...
Page 46 RIGOL Chapter 2 Command System :BUS<n>:SPI:MOSI:THReshold Syntax :BUS<n>:SPI:MOSI:THReshold <thre> :BUS<n>:SPI:MOSI:THReshold? Description Sets or queries the threshold of the source channel of MOSI data line of SPI decoding on the specified bus. Parameter Name Type Range Default <n> Discrete {1|2} (-4 x VerticalScale - Offset) to (4 x VerticalScale - Offset) Wherein, VerticalScale is the vertical scale of the MOSI data <thre>...
Page 47 RIGOL Chapter 2 Command System :BUS<n>:SPI:SCLK:SLOPe Syntax :BUS<n>:SPI:SCLK:SLOPe <slope> :BUS<n>:SPI:SCLK:SLOPe? Description Sets or queries on which type of edges of the clock signal is sampling performed on the data of source channel of data line of SPI decoding on the specified bus.
Page 48 RIGOL Chapter 2 Command System Parameter Name Type Range Default <n> Discrete {1|2} (-4 x VerticalScale - Offset) to (4 x VerticalScale - Offset) Wherein, VerticalScale is the vertical scale of the source <thre> Real channel, refer to the :CHANnel<n>:SCALe command;...
Page 49 RIGOL Chapter 2 Command System :BUS<n>:SPI:SS:THReshold Syntax :BUS<n>:SPI:SS:THReshold <thre> :BUS<n>:SPI:SS:THReshold? Description Sets or queries the threshold of the source channel of the CS line of SPI decoding on the specified bus. Parameter Name Type Range Default <n> Discrete {1|2} (-4 x VerticalScale - Offset) to (4 x VerticalScale - Offset) Wherein, VerticalScale is the vertical scale of the CS line source channel, refer to the :CHANnel<n>:SCALe...
Page 50: Calculate Commands
RIGOL Chapter 2 Command System :CALCulate Commands Command List: :CALCulate:MODE  :CALCulate:ADD  :CALCulate:ADVanced  :CALCulate:DIVision  :CALCulate:FFT  :CALCulate:LOGic  :CALCulate:MULTiply  :CALCulate:SUB  :CALCulate:MODE Syntax :CALCulate:MODE <mod> :CALCulate:MODE? Description Sets or queries the type of math operation. Parameter...
Page 51: Calculate:add
RIGOL Chapter 2 Command System :CALCulate:ADD Command List: :CALCulate:ADD:INVert  :CALCulate:ADD:SA  :CALCulate:ADD:SB  :CALCulate:ADD:VOFFset  :CALCulate:ADD:VSCale  :CALCulate:ADD:INVert Syntax :CALCulate:ADD:INVert <bool> :CALCulate:ADD:INVert? Description Enables or disables the invert display of the waveform of addition operation; or queries the on/off status of the invert display of the waveform of addition operation.
Page 52 RIGOL Chapter 2 Command System :CALCulate:ADD:VOFFset Syntax :CALCulate:ADD:VOFFset <offs> :CALCulate:ADD:VOFFset? Description Sets or queries the vertical position of the addition operation waveform. The unit is related to the current amplitude unit of the source channel. Parameter Name Type Range Default (-40 x vertical scale of the addition operation waveform) to (40 <offs>...
Page 53: Calculate:advanced
RIGOL Chapter 2 Command System :CALCulate:ADVanced Command List: :CALCulate:ADVanced:EXPRession  :CALCulate:ADVanced:INVert  :CALCulate:ADVanced:VARiable1  :CALCulate:ADVanced:VARiable2  :CALCulate:ADVanced:VOFFset  :CALCulate:ADVanced:VSCale  :CALCulate:ADVanced:EXPRession Syntax :CALCulate:ADVanced:EXPRession <str> :CALCulate:ADVanced:EXPRession? Description Sets or queries the expression of advanced operation. Parameter Name Type Range Default Refer to Remarks <str>...
Page 54 RIGOL Chapter 2 Command System Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Remarks 1|ON: turns the waveform invert on. The waveform voltage values are inverted and then displayed.  0|OFF: turns the waveform invert off. The waveform is displayed normally.
Page 55 RIGOL Chapter 2 Command System Remarks The expression of advanced operation (refer to the :CALCulate:ADVanced:EXPRession command) may contain CH1, CH2, CH3, or CH4. Return Format The query returns the vertical position in scientific notation. :CALCulate:ADVanced:VSCale Syntax :CALCulate:ADVanced:VSCale <scale> :CALCulate:ADVanced:VSCale? Description Sets or queries the vertical scale of the advanced operation waveform.
Page 56: Calculate:division
RIGOL Chapter 2 Command System :CALCulate:DIVision In the division operation, when the waveform voltage value of Source B is 0, the result of the division is treated as 0. Command List: :CALCulate:DIVision:INVert  :CALCulate:DIVision:SA  :CALCulate:DIVision:SB  :CALCulate:DIVision:VOFFset  :CALCulate:DIVision:VSCale ...
Page 57 RIGOL Chapter 2 Command System :CALCulate:DIVision:VOFFset Syntax :CALCulate:DIVision:VOFFset <offs> :CALCulate:DIVision:VOFFset? Description Sets or queries the vertical position of the division operation waveform. The unit is related to the current amplitude unit of the source channel. Parameter Name Type Range Default (-40 x vertical scale of the division operation waveform) to (40 x <offs>...
Page 58: Calculate:fft
RIGOL Chapter 2 Command System :CALCulate:FFT Command List: :CALCulate:FFT:HCENter  :CALCulate:FFT:HOFFset  :CALCulate:FFT:HSCaLe  :CALCulate:FFT:HSPan  :CALCulate:FFT:SOURce  :CALCulate:FFT:SPLit  :CALCulate:FFT:VOFFset  :CALCulate:FFT:VSCale  :CALCulate:FFT:VSMode  :CALCulate:FFT:WINDow  :CALCulate:FFT:HCENter Syntax :CALCulate:FFT:HCENter <center> :CALCulate:FFT:HCENter? Description Sets or queries the center frequency of FFT operation. The default unit is Hz.
Page 59 RIGOL Chapter 2 Command System is 100. For the value of Horizontal Time Base, refer to the :TIMebase[:MAIN]:SCALe command. The FFT horizontal scale is related to the FFT sample rate and FFT horizontal coefficient, refer to  the :CALCulate:FFT:HSPan command.
Page 60 RIGOL Chapter 2 Command System function. When the function is disabled, Number of Pixels Per Grid Horizontally is 50; when enabled, it is 100. For the value of Horizontal Time Base, refer to the :TIMebase[:MAIN]:SCALe command. You can set the FFT horizontal scale indirectly by setting the FFT horizontal coefficient (refer to ...
Page 61 RIGOL Chapter 2 Command System :CALCulate:FFT:VOFFset Syntax :CALCulate:FFT:VOFFset <offs> :CALCulate:FFT:VOFFset? Description Sets or queries the horizontal position of the FFT operation waveform. The unit is related to the current vertical scale type of FFT operation and the current amplitude unit of the source channel.
Page 62 RIGOL Chapter 2 Command System Parameter Name Type Range Default <vmode> Discrete {VRMS|DB} Remarks VRMS: displays the vertical amplitude in linear mode.  DB: displays the vertical amplitude in log mode.  Return Format The query returns VRMS or DB.
Page 63: Calculate:logic
RIGOL Chapter 2 Command System :CALCulate:LOGic Command List: :CALCulate:LOGic:ATHReshold  :CALCulate:LOGic:BTHReshold  :CALCulate:LOGic:INVert  :CALCulate:LOGic:OPERator  :CALCulate:LOGic:SA  :CALCulate:LOGic:SB  :CALCulate:LOGic:VOFFset  :CALCulate:LOGic:VSCale  :CALCulate:LOGic:ATHReshold :CALCulate:LOGic:BTHReshold Syntax :CALCulate:LOGic:ATHReshold <thre> :CALCulate:LOGic:ATHReshold? :CALCulate:LOGic:BTHReshold <thre> :CALCulate:LOGic:BTHReshold? Description Sets or queries the threshold of Source A or Source B in logic operation.
Page 64 RIGOL Chapter 2 Command System Return Format The query returns 1 or 0. :CALCulate:LOGic:OPERator Syntax :CALCulate:LOGic:OPERator <oper> :CALCulate:LOGic:OPERator? Description Sets or queries the logic operation formula. Parameter Name Type Range Default <oper> Discrete {AND|OR|NOT|XOR} Return Format The query returns AND, OR, NOT, or XOR.
Page 65 RIGOL Chapter 2 Command System :CALCulate:LOGic:VOFFset Syntax :CALCulate:LOGic:VOFFset <offs> :CALCulate:LOGic:VOFFset? Description Sets or queries the vertical position of the logic operation waveform. The default unit is U. Parameter Name Type Range Default (-40 x vertical scale of the logic operation waveform) to (40 x <offs>...
Page 66: Calculate:multiply
RIGOL Chapter 2 Command System :CALCulate:MULTiply Command List: :CALCulate:MULTiply:INVert  :CALCulate:MULTiply:SA  :CALCulate:MULTiply:SB  :CALCulate:MULTiply:VOFFset  :CALCulate:MULTiply:VSCale  :CALCulate:MULTiply:INVert Syntax :CALCulate:MULTiply:INVert <bool> :CALCulate:MULTiply:INVert? Description Enables or disables the invert display of the multiplication operation waveform; or queries the on/off status of the multiplication operation waveform.
Page 67 RIGOL Chapter 2 Command System :CALCulate:MULTiply:VOFFset Syntax :CALCulate:MULTiply:VOFFset <offs> :CALCulate:MULTiply:VOFFset? Description Sets or queries the vertical position of the multiplication operation waveform. The unit is related to the current amplitude unit of the source channel. Parameter Name Type Range Default (-40 x vertical scale of the multiplication operation waveform) to <offs>...
Page 68: Calculate:sub
RIGOL Chapter 2 Command System :CALCulate:SUB Command List: :CALCulate:SUB:INVert  :CALCulate:SUB:SA  :CALCulate:SUB:SB  :CALCulate:SUB:VOFFset  :CALCulate:SUB:VSCale  :CALCulate:SUB:INVert Syntax :CALCulate:SUB:INVert <bool> :CALCulate:SUB:INVert? Description Enables or disables the invert display of the subtraction operation waveform; or queries the on/off status of the invert display of the subtraction operation waveform.
Page 69 RIGOL Chapter 2 Command System :CALCulate:SUB:VOFFset Syntax :CALCulate:SUB:VOFFset <offs> :CALCulate:SUB:VOFFset? Description Sets or queries the vertical position of the subtraction operation waveform. The unit is related to the current amplitude unit of the source channel. Parameter Name Type Range Default (-40 x vertical scale of the subtraction operation waveform) to <offs>...
Page 70: Calibrate Commands
RIGOL Chapter 2 Command System :CALibrate Commands Command List: :CALibrate:DATE?  :CALibrate:QUIT  :CALibrate:STARt  :CALibrate:TIME?  :CALibrate:DATE? Syntax :CALibrate:DATE? Description Queries the date when the last self-calibration was performed. Return Format The query returns <year>,<month>,<day>. Wherein, <year>, <month>, and <day> represent year, month, and day respectively.
Page 71: Calibrate:time
RIGOL Chapter 2 Command System :CALibrate:TIME? Syntax :CALibrate:TIME? Description Queries the time when the last self-calibration was performed. Return Format The query returns <hours>,<minutes>,<seconds>. Wherein, <hours>, <minutes>, and <seconds> represent hour, minute, and second respectively. DS4000E Programming Guide 2-59...
Page 72: Channel Commands
RIGOL Chapter 2 Command System :CHANnel<n> Commands Command List: :CHANnel<n>:BVOLtage  :CHANnel<n>:BWLimit  :CHANnel<n>:COUPling  :CHANnel<n>:CSTart  :CHANnel<n>:DISPlay  :CHANnel<n>:IMPedance  :CHANnel<n>:INVert  :CHANnel<n>:OFFSet  :CHANnel<n>:PEND  :CHANnel<n>:PROBe  :CHANnel<n>:SCALe  :CHANnel<n>:TCALibrate  :CHANnel<n>:TYPE?  :CHANnel<n>:UNITs  :CHANnel<n>:VERNier  :CHANnel<n>:BVOLtage Syntax :CHANnel<n>:BVOLtage <vol>...
Page 73: Channel:Coupling
RIGOL Chapter 2 Command System Remarks 20M|100M: enables the bandwidth limit and sets the bandwidth limit to 20 MHz or 100 MHz. The  high-frequency components that are greater than 20 MHz or 100 MHz in the signal under test will be attenuated.
Page 74: Channel:Display
RIGOL Chapter 2 Command System :CHANnel<n>:DISPlay Syntax :CHANnel<n>:DISPlay <bool> :CHANnel<n>:DISPlay? Description Turns on or off the specified analog channel; or queries the on/off status of the specified analog channel. Parameter Name Type Range Default <n> Discrete {1|2|3|4} CH1: 1|ON <bool>...
Page 75: Channel:Offset
RIGOL Chapter 2 Command System Parameter Name Type Range Default <n> Discrete {1|2|3|4} <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Remarks 1|ON: turns the waveform invert on. The waveform voltage values are inverted and then displayed.  0|OFF: turns the waveform invert off. The waveform is displayed normally.
Page 76: Channel:Probe
RIGOL Chapter 2 Command System Remarks SEND: indicates a single-ended probe head.  DIFFerential: indicates a differential probe head.  Return Format The query returns SEND or DIFF. :CHANnel<n>:PROBe Syntax :CHANnel<n>:PROBe <atten> :CHANnel<n>:PROBe? Description Sets or queries the probe ratio of the probe currently connected to the specified analog channel.
Page 77: Channel:Tcalibrate
RIGOL Chapter 2 Command System :CHANnel<n>:TCALibrate Syntax :CHANnel<n>:TCALibrate <tcal> :CHANnel<n>:TCALibrate? Description Sets or queries the delay calibration time (used to calibrate the zero offset) of the specified analog channel. The default unit is s. Parameter Name Type Range Default <n>...
Page 78: Channel:Vernier
RIGOL Chapter 2 Command System :CHANnel<n>:VERNier Syntax :CHANnel<n>:VERNier <bool> :CHANnel<n>:VERNier? Description Enables or disables the fine adjustment of the vertical scale of the specified analog channel; or queries the on/off status of the fine adjustment function of the vertical scale of the specified analog channel.
Page 79: Cursor Commands
RIGOL Chapter 2 Command System :CURSor Commands Cursors are the horizontal and vertical marks that can be used to measure the X-axis values and Y-axis values of the source channel waveform. The cursor measurement function provides X cursors and Y cursors (as shown in the figure below).
Page 80: Cursor:mode
RIGOL Chapter 2 Command System :CURSor:MODE Syntax :CURSor:MODE <mode> :CURSor:MODE? Description Sets or queries the mode of the cursor measurement. Parameter Name Type Range Default <mode> Discrete {OFF|MANual|TRACk|AUTO} Remarks OFF: disables the cursor measurement function.  MANual: enables the manual mode of cursor measurement.
Page 81: Cursor:manual
RIGOL Chapter 2 Command System :CURSor:MANual Command List: :CURSor:MANual:AXValue?  :CURSor:MANual:AYValue?  :CURSor:MANual:BXValue?  :CURSor:MANual:BYValue?  :CURSor:MANual:CAX  :CURSor:MANual:CAY  :CURSor:MANual:CBX  :CURSor:MANual:CBY  :CURSor:MANual:IXDelta?  :CURSor:MANual:SOURce  :CURSor:MANual:TUNit  :CURSor:MANual:TYPE  :CURSor:MANual:VUNit  :CURSor:MANual:XDELta?  :CURSor:MANual:YDELta?  :CURSor:MANual:AXValue? Syntax...
Page 82 RIGOL Chapter 2 Command System :CURSor:MANual:BXValue? Syntax :CURSor:MANual:BXValue? Description Queries the X value at Cursor B (X cursor) in the manual mode of cursor measurement. The unit is determined by the currently selected horizontal unit. Remarks For the horizontal position of Cursor B (X cursor), refer to the :CURSor:MANual:CBX command.
Page 83 RIGOL Chapter 2 Command System :CURSor:MANual:CAY Syntax :CURSor:MANual:CAY <ay> :CURSor:MANual:CAY? Description Sets or queries the vertical position of Cursor A (Y cursor) in the manual mode of cursor measurement. Parameter Name Type Range Default <ay> Integer 0 to 399 Remarks The vertical position of the cursor is defined by the pixel coordinate of the screen.
Page 84 RIGOL Chapter 2 Command System Remarks The vertical position of the cursor is defined by the pixel coordinate of the screen. The range of the pixel coordinate on the screen vertically is from 0 to 399 (from top to bottom).
Page 85 RIGOL Chapter 2 Command System Parameter Name Type Range Default <unit> Discrete {SECond|HZ|DEGRee|PERCent} SECond Remarks SECond: when the X value at Cursor A (X cursor), the X value at Cursor B (X cursor), and the difference  between the two values (namely A->X, B->X, and △X in the measurement results) are queried, the returned values are expressed in s.
Page 86 RIGOL Chapter 2 Command System Parameter Name Type Range Default <unit> Discrete {SUNit|PERCent} SUNit Remarks SUNit: when the Y value at Cursor A (Y cursor), the Y value at Cursor B (Y cursor), and the difference  between the two values (namely A->Y, B->Y, and △Y in the measurement results) are queried, the returned values are expressed in the current amplitude unit of the source channel.
Page 87: Cursor:track
RIGOL Chapter 2 Command System :CURSor:TRACk Command List: :CURSor:TRACk:AXValue?  :CURSor:TRACk:AXIS  :CURSor:TRACk:AYValue?  :CURSor:TRACk:BXValue?  :CURSor:TRACk:BYValue?  :CURSor:TRACk:CAX  :CURSor:TRACk:CAY  :CURSor:TRACk:CBX  :CURSor:TRACk:CBY  :CURSor:TRACk:IXDelta?  :CURSor:TRACk:SEQuence  :CURSor:TRACk:SOURce1  :CURSor:TRACk:SOURce2  :CURSor:TRACk:XDELta?  :CURSor:TRACk:YDELta?  :CURSor:TRACk:AXValue? Syntax...
Page 88 RIGOL Chapter 2 Command System When Y is selected as the track axis, you can use the :CURSor:TRACk:CAX and :CURSor:TRACk:CBX  commands to adjust the horizontal position of X cursor. Then, Y cursor will automatically track the vertical amplitude of the waveform of the corresponding measurement source at X cursor.
Page 89 RIGOL Chapter 2 Command System Remarks In the track mode, when Cursor B (X cursor) is adjusted horizontally, Cursor B (Y cursor) will  automatically track the vertical amplitude of the waveform of the corresponding track source channel at Cursor B (X cursor).
Page 90 RIGOL Chapter 2 Command System :CURSor:TRACk:CBX Syntax :CURSor:TRACk:CBX <bx> :CURSor:TRACk:CBX? Description Sets or queries the horizontal position of Cursor B (X cursor) in the track mode of cursor measurement. Parameter Name Type Range Default <bx> Integer 0 to 699 Remarks The horizontal position of the cursor is defined by the pixel coordinate of the screen.
Page 91 RIGOL Chapter 2 Command System Remarks For the horizontal position of Cursor A (X cursor), refer to the :CURSor:TRACk:CAX command.  For the horizontal position of Cursor B (X cursor), refer to the :CURSor:TRACk:CBX command.  Return Format The query returns the reciprocal of the current difference in scientific notation. When the difference is 0 s, the query returns 9.9e37.
Page 92 RIGOL Chapter 2 Command System :CURSor:TRACk:SOURce2 Syntax :CURSor:TRACk:SOURce2 <source> :CURSor:TRACk:SOURce2? Description Sets or queries the track source of Cursor B (X cursor) in the track mode of cursor measurement. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH|NONE} CHANnel1 Remarks Only the currently enabled channel can be selected as the source channel.
Page 93: Display Commands
RIGOL Chapter 2 Command System :DISPlay Commands Command List: :DISPlay:CLEar  :DISPlay:DATA?  :DISPlay:GBRightness  :DISPlay:GRADing:TIME  :DISPlay:GRID  :DISPlay:MPERsistence  :DISPlay:TYPE  :DISPlay:WBRightness  :DISPlay:CLEar Syntax :DISPlay:CLEar Description Clears all the waveforms on the screen. If the oscilloscope is in the RUN state, after the waveform data is cleared, new waveform data will be displayed.
Page 94: Display:gbrightness
RIGOL Chapter 2 Command System Return Format The query returns the bitmap data stream in strings. The returned value consists of the TMC data block header and BMP data. The format and detailed Remarks of each part are as shown in the table below.
Page 95: Display:grid
RIGOL Chapter 2 Command System 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 20: sets the persistence time to a specific value to observe glitch that  changes relatively slowly or glitch with low occurrence probability. INFinite: sets the persistence time to infinite (the oscilloscope displays the newly acquired waveform ...
Page 96: Display:type
RIGOL Chapter 2 Command System :DISPlay:TYPE Syntax :DISPlay:TYPE <type> :DISPlay:TYPE? Description Sets or queries the display type of the waveform. Parameter Name Type Range Default <type> Discrete {VECTors|DOTS} VECTors Remarks VECTors: The sample points are connected by lines and displayed. Normally, this mode can provide the ...
Page 97: Ext Commands
RIGOL Chapter 2 Command System :EXT Commands Command List: :EXT:PEND  :EXT:CSTart  :EXT:PEND Syntax :EXT:PEND <type> :EXT:PEND? Description Sets or queries the head type of the active probe currently connected to the external trigger channel (namely the [EXT TRIG] connector on the front panel of the instrument).
Page 98: Function Commands
RIGOL Chapter 2 Command System :FUNCtion Commands Command List: :FUNCtion:WRMode  :FUNCtion:WRECord  :FUNCtion:WREPlay  :FUNCtion:WANalyze  :FUNCtion:WRMode Syntax :FUNCtion:WRMode <mode> :FUNCtion:WRMode? Description Sets or queries the waveform recording mode. Parameter Name Type Range Default <mode> Discrete {OFF|RECord|PLAY|KEEP|ANALyze} Remarks RECord: indicates the recording mode.
Page 99: Function:wrecord
RIGOL Chapter 2 Command System :FUNCtion:WRECord Command List: :FUNCtion:WRECord:FEND  :FUNCtion:WRECord:FMAX?  :FUNCtion:WRECord:INTerval  :FUNCtion:WRECord:OPERate  :FUNCtion:WRECord:FEND Syntax :FUNCtion:WRECord:FEND <frame> :FUNCtion:WRECord:FEND? Description Sets or queries the end frame of the waveform recording in the recording mode. The oscilloscope stops the recording operation automatically when the number of recorded frames reaches the set end frame.
Page 100 RIGOL Chapter 2 Command System :FUNCtion:WRECord:INTerval Syntax :FUNCtion:WRECord:INTerval <interval> :FUNCtion:WRECord:INTerval? Description Sets or queries the interval (namely the time between frames) of the waveform recording in the recording mode. The default unit is s. Parameter Name Type Range Default <interval>...
Page 101: Function:wreplay
RIGOL Chapter 2 Command System :FUNCtion:WREPlay Command List: :FUNCtion:WREPlay:FCURrent  :FUNCtion:WREPlay:FEND  :FUNCtion:WREPlay:FMAX?  :FUNCtion:WREPlay:FSTart  :FUNCtion:WREPlay:INTerval  :FUNCtion:WREPlay:MODE  :FUNCtion:WREPlay:OPERate  :FUNCtion:WREPlay:TTAG  :FUNCtion:WREPlay:CTAG?  :FUNCtion:WREPlay:FCURrent Syntax :FUNCtion:WREPlay:FCURrent <frame> :FUNCtion:WREPlay:FCURrent? Description Sets or queries the current frame in waveform playback.
Page 102 RIGOL Chapter 2 Command System :FUNCtion:WREPlay:FMAX? Syntax :FUNCtion:WREPlay:FMAX? Description Queries the number of frames of recorded waveforms in the waveform playback mode. Return Format The query returns an integer. :FUNCtion:WREPlay:FSTart Syntax :FUNCtion:WREPlay:FSTart <frame> :FUNCtion:WREPlay:FSTart? Description Sets or queries the start frame in waveform playback.
Page 103 RIGOL Chapter 2 Command System :FUNCtion:WREPlay:MODE Syntax :FUNCtion:WREPlay:MODE <mode> :FUNCtion:WREPlay:MODE? Description Sets or queries the waveform playback mode. Parameter Name Type Range Default <mode> Discrete {REPeat|SINGle} SINGle Remarks REPeat: indicates the circular playback. The waveform is played from the start frame to the end frame, ...
Page 104 RIGOL Chapter 2 Command System Return Format The query returns 1 or 0. :FUNCtion:WREPlay:CTAG? Syntax :FUNCtion:WREPlay:CTAG? Description Queries the recording time difference between the currently displayed waveform and the first frame of waveform in the playback mode. Return Format The query returns the recording time difference in scientific notation.
Page 105: Function:wanalyze
RIGOL Chapter 2 Command System :FUNCtion:WANalyze Command List: :FUNCtion:WANalyze:CANCel  :FUNCtion:WANalyze:CMASk  :FUNCtion:WANalyze:ECDiff?  :FUNCtion:WANalyze:ECURrent  :FUNCtion:WANalyze:EFCount?  :FUNCtion:WANalyze:FCURrent  :FUNCtion:WANalyze:MODE  :FUNCtion:WANalyze:NEXT  :FUNCtion:WANalyze:PREVious  :FUNCtion:WANalyze:SETup:EFRame  :FUNCtion:WANalyze:SETup:SFRame  :FUNCtion:WANalyze:SETup:SSENd  :FUNCtion:WANalyze:SETup:SSTart  :FUNCtion:WANalyze:SETup:THReshold  :FUNCtion:WANalyze:SETup:XMASk  :FUNCtion:WANalyze:SETup:YMASk ...
Page 106 RIGOL Chapter 2 Command System Remarks When the waveform analysis mode is "Trace" (refer to the :FUNCtion:WANalyze:MODE command), the  "Current Frame Difference" (namely the relative difference) is the normalized value of the difference between the current frame and the template.
Page 107 RIGOL Chapter 2 Command System Parameter Name Type Range Default <frame> Integer 1 to the number of frames that have been recorded Return Format The query returns an integer. :FUNCtion:WANalyze:MODE Syntax :FUNCtion:WANalyze:MODE <mode> :FUNCtion:WANalyze:MODE? Description Sets or queries the waveform analysis mode.
Page 108 RIGOL Chapter 2 Command System Parameter Name Type Range Default Number of frames that <frame> Integer 1 to the number of frames that have been recorded have been recorded Remarks The actual range of the end frame is from the currently set start frame of waveform analysis (refer to the :FUNCtion:WANalyze:SETup:SFRame command) to the number of frames that have been recorded.
Page 109 RIGOL Chapter 2 Command System :FUNCtion:WANalyze:SETup:SSTart Syntax :FUNCtion:WANalyze:SETup:SSTart <point> :FUNCtion:WANalyze:SETup:SSTart? Description Sets or queries the screen start point (in pixel) in waveform analysis. Parameter Name Type Range Default <point> Integer 5 to 685 Remarks The range of the pixel coordinate on the screen horizontally is from 0 to 699 (from left to right).
Page 110 RIGOL Chapter 2 Command System Return Format The query returns the horizontal tolerance range in scientific notation. :FUNCtion:WANalyze:SETup:YMASk Syntax :FUNCtion:WANalyze:SETup:YMASk <mask> :FUNCtion:WANalyze:SETup:YMASk? Description Sets or queries the vertical tolerance range of the pass/fail test mask when the waveform analysis mode is "Pass/Fail".
Page 111 RIGOL Chapter 2 Command System :FUNCtion:WANalyze:STARt Syntax :FUNCtion:WANalyze:STARt Description Starts the waveform analysis. Remarks During the analysis process, the progress bar is displayed and users cannot modify the waveform  analysis settings. After the analysis operation is completed, the analysis results (including "Error Frames", "Current ...
Page 112: Ieee 488.2 Common Commands
RIGOL Chapter 2 Command System IEEE 488.2 Common Commands IEEE 488.2 standard defines some common commands that are used for querying the basic information of the instrument or executing basic operations. These commands usually start with "*", and the keywords in a command contain 3 characters.
Page 113: Esr
*IDN? Description Queries the instrument information. Return Format The query returns RIGOL TECHNOLOGIES,<model>,<serial number>,<software version>. Wherein, <model>: indicates the model number of the instrument. <serial number>: indicates the serial number of the instrument. <software version>: indicates the software version of the instrument.
Page 114: Rst
RIGOL Chapter 2 Command System Return Format The query returns 1 if the current operation is finished; otherwise, the query returns 0. *RST Syntax *RST Description Restores the instrument to its factory default settings. *SRE Syntax *SRE <mask> *SRE? Description Sets or queries the enable register of the status byte register set.
Page 115: Tst
RIGOL Chapter 2 Command System Return Format The query returns an integer (corresponds to the binary-weighted sum of all the bits) between 0 and 255. *TST? Syntax *TST? Description Performs a self-test and queries the self-test result. Remarks The self-test result is expressed as a 32-bit binary number. "0" denotes that the corresponding item passes the self-test;...
Page 116: Lan Commands
RIGOL Chapter 2 Command System :LAN Commands Command List: :LAN:APPLy  :LAN:AUToip  :LAN:DHCP  :LAN:DNS  :LAN:GATeway  :LAN:INITiate  :LAN:IPADdress  :LAN:MAC?  :LAN:MANual  :LAN:SMASk  :LAN:STATus?  :LAN:VISA?  :LAN:APPLy Syntax :LAN:APPLy Description Applies the current network parameter configuration.
Page 117: Lan:dhcp
RIGOL Chapter 2 Command System :LAN:DHCP Syntax :LAN:DHCP <bool> :LAN:DHCP? Description Turns on or off the DHCP configuration mode; or queries the on/off status of the current DHCP configuration mode. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 1|ON Remarks The high-to-low priority of the three IP configuration modes is "DHCP", "Auto IP"...
Page 118: Lan:gateway
RIGOL Chapter 2 Command System :LAN:GATeway Syntax :LAN:GATeway <string> :LAN:GATeway? Description Sets or queries the gateway address. Parameter Name Type Range Default Refer to Remarks <string> ASCII String Remarks The format of <string> is nnn,nnn,nnn,nnn. The range of the first section of "nnn" is from 1 to 223 ...
Page 119: Lan:mac
RIGOL Chapter 2 Command System Remarks The format of <string> is nnn,nnn,nnn,nnn. The range of the first section of "nnn" is from 1 to 223  (except 127), and the ranges of the other three sections of "nnn" are from 0 to 255.
Page 120: Lan:smask
RIGOL Chapter 2 Command System :LAN:SMASk Syntax :LAN:SMASk <string> :LAN:SMASk? Description Sets or queries the subnet mask. Parameter Name Type Range Default Refer to Remarks <string> ASCII String Remarks The format of <string> is nnn,nnn,nnn,nnn. The range of the section "nnn" is from 0 to 255.
Page 121: Mask Commands
RIGOL Chapter 2 Command System :MASK Commands Command List: :MASK:CREate  :MASK:DATA  :MASK:ENABle  :MASK:FAILed?  :MASK:MDISplay  :MASK:OPERate  :MASK:OUTPut  :MASK:PASSed?  :MASK:RESet  :MASK:SOOutput  :MASK:SOURce  :MASK:TOTal?  :MASK:X  :MASK:Y  :MASK:CREate Syntax :MASK:CREate Description Creates the pass/fail test mask according to the current setting.
Page 122: Mask:enable
RIGOL Chapter 2 Command System When sending the command, directly place the data stream after the command string, then complete  the whole sending process in one time. When reading the data stream, ensure that there is enough buffer space to receive the data stream; otherwise, errors might occur in reading the program.
Page 123: Mask:operate
RIGOL Chapter 2 Command System Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Remarks The display of the statistic information of the pass/fail test results can only be turned on when the pass/fail test function is enabled (refer to the :MASK:ENABle command).
Page 124: Mask:passed
RIGOL Chapter 2 Command System :MASK:PASSed? Syntax :MASK:PASSed? Description Queries the number of frames that pass the pass/fail test. Return Format The query returns an integer. :MASK:RESet Syntax :MASK:RESet Description Resets the pass/fail test results. Remarks After this command is sent, the number of frames that pass the pass/fail test (refer to the :MASK:PASSed? command), the number of frames that fail the pass/fail test (refer to the :MASK:FAILed? command), and the total number of frames (refer to the :MASK:TOTal? command) are all reset to 0.
Page 125: Mask:source
RIGOL Chapter 2 Command System :MASK:SOURce Syntax :MASK:SOURce <source> :MASK:SOURce? Description Sets or queries the source channel of the pass/fail test. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Remarks Only the currently enabled channel (refer to the :CHANnel<n>:DISPlay command) can be selected as the source channel.
Page 126: Mask:y
RIGOL Chapter 2 Command System :MASK:Y Syntax :MASK:Y <y> :MASK:Y? Description Sets or queries the vertical tolerance range of the pass/fail test mask. The default unit is div (in the vertical direction). Parameter Name Type Range Default <y> Real 0.03125 to 4 (with a step of 0.03125) 0.375...
Page 127: Measure Commands
RIGOL Chapter 2 Command System :MEASure Commands Command List: :MEASure:ADISplay  :MEASure:AMSource  :MEASure:AREA  :MEASure:CLEar  :MEASure:COUNter:SOURce  :MEASure:COUNter:VALue?  :MEASure:CREGion:CAX  :MEASure:CREGion:CBX  :MEASure:FDELay  :MEASure:F2RDelay  :MEASure:FPHase  :MEASure:F2RPhase  :MEASure:FREQuency  :MEASure:FTIMe  :MEASure:HISTory:DISPlay  :MEASure:HISTory:DMODe ...
Page 128: Measure:adisplay
RIGOL Chapter 2 Command System :MEASure:ADISplay Syntax :MEASure:ADISplay <bool> :MEASure:ADISplay? Description Enables or disables the all measurement function; or queries the on/off status of the all measurement function. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Remarks The all measurement function can measure all the time, voltage, and area parameters of the specified ...
Page 129: Measure:area
RIGOL Chapter 2 Command System Parameter Name Type Range Default <chan> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} CHANnel1 Remarks You can perform the all measurement function on one or multiple channels among CH1-CH4 and MATH at the same time. Return Format The query returns the source channel(s) (CHAN1, CHAN2, CHAN3, CHAN4, or MATH) in strings. These source channels are separated by commas.
Page 130: Measure:counter:source
RIGOL Chapter 2 Command System :MEASure:COUNter:SOURce Syntax :MEASure:COUNter:SOURce <source> :MEASure:COUNter:SOURce? Description Sets or queries the measurement source of the frequency counter. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|EXT|OFF} Remarks When <source> is "OFF", it indicates that the frequency counter function will be disabled.
Page 131: Measure:cregion:cbx
RIGOL Chapter 2 Command System :MEASure:CREGion:CBX Syntax :MEASure:CREGion:CBX <cbx> :MEASure:CREGion:CBX? Description Sets or queries the position of Cursor B when the measurement range is the "cursor area". Parameter Name Type Range Default <cbx> Integer 6 to 697 Remarks The position of the cursor is defined by the pixel coordinate of the screen. The range of the pixel ...
Page 132 RIGOL Chapter 2 Command System :MEASure:FDELay:SAVerage :MEASure:FDELay:SCURrent :MEASure:FDELay:SDEViation :MEASure:FDELay:SMAXimum :MEASure:FDELay:SMINimum Syntax 1 :MEASure:FDELay:SAVerage [<chanA>,<chanB>] :MEASure:FDELay:SCURrent [<chanA>,<chanB>] :MEASure:FDELay:SDEViation [<chanA>,<chanB>] :MEASure:FDELay:SMAXimum [<chanA>,<chanB>] :MEASure:FDELay:SMINimum [<chanA>,<chanB>] Description 1 Measures the delay (falling edge-falling edge) between the two specified source channels, and enables the statistic function of the measurement results.
Page 133: Measure:f2Rdelay
RIGOL Chapter 2 Command System :MEASure:F2RDelay Syntax 1 :MEASure:F2RDelay [<chanA>,<chanB>] Description 1 Measures the delay (falling edge-rising edge) between the two specified source channels. Syntax 2 :MEASure:F2RDelay? [<chanA>,<chanB>] Description 2 Measures the delay (falling edge-rising edge) between the two specified source channels. The default unit is s.
Page 134: Measure:fphase
RIGOL Chapter 2 Command System Queries the average value, current value, standard deviation, maximum value, or minimum value of the delay (falling edge-rising edge) measurement results when the delay (falling edge-rising edge) measurement function between the two specified source channels and the statistic function of the measurement results are enabled.
Page 135 RIGOL Chapter 2 Command System :MEASure:FPHase:SAVerage :MEASure:FPHase:SCURrent :MEASure:FPHase:SDEViation :MEASure:FPHase:SMAXimum :MEASure:FPHase:SMINimum Syntax 1 :MEASure:FPHase:SAVerage [<chanA>,<chanB>] :MEASure:FPHase:SCURrent [<chanA>,<chanB>] :MEASure:FPHase:SDEViation [<chanA>,<chanB>] :MEASure:FPHase:SMAXimum [<chanA>,<chanB>] :MEASure:FPHase:SMINimum [<chanA>,<chanB>] Description 1 Measures the phase deviation (falling edge-falling edge) between the two specified source channels, and enables the statistic function of the measurement results.
Page 136: Measure:f2Rphase
RIGOL Chapter 2 Command System :MEASure:F2RPhase Syntax 1 :MEASure:F2RPhase [<chanA>,<chanB>] Description 1 Measures the phase deviation (falling edge-rising edge) between the two specified source channels. Syntax 2 :MEASure:F2RPhase? [<chanA>,<chanB>] Description 2 Measures the phase deviation (falling edge-rising edge) between the two specified source channels. The default unit is °.
Page 137: Measure:frequency
RIGOL Chapter 2 Command System Description 2 Queries the average value, current value, standard deviation, maximum value, or minimum value of the phase deviation (falling edge-rising edge) measurement results when the phase deviation (falling edge-rising edge) measurement function between the two specified source channels and the statistic function of the measurement results are enabled.
Page 138: Measure:ftime
RIGOL Chapter 2 Command System :MEASure:FREQuency:SAVerage :MEASure:FREQuency:SCURrent :MEASure:FREQuency:SDEViation :MEASure:FREQuency:SMAXimum :MEASure:FREQuency:SMINimum Syntax 1 :MEASure:FREQuency:SAVerage [<chan>] :MEASure:FREQuency:SCURrent [<chan>] :MEASure:FREQuency:SDEViation [<chan>] :MEASure:FREQuency:SMAXimum [<chan>] :MEASure:FREQuency:SMINimum [<chan>] Description 1 Measures the frequency of the specified source channel and enables the statistic function of the measurement results.
Page 139 RIGOL Chapter 2 Command System Description 2 Measures and queries the fall time of the specified source channel. The default unit is s. Parameter Name Type Range Default <chan> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Remarks Before making measurements, turn on the channels to be measured.
Page 140: Measure:history:display
RIGOL Chapter 2 Command System When [<chan>] is omitted, the command, by default, applies to the currently set measurement source  (refer to the :MEASure:SOURce command). Return Format The query returns the average value, current value, standard deviation, maximum value, or minimum value in scientific notation.
Page 141: Measure:marea
RIGOL Chapter 2 Command System :MEASure:MARea Syntax 1 :MEASure:MARea [<chan>] Description 1 Measures the area of the specified source channel. Syntax 2 :MEASure:MARea? [<chan>] Description 2 Measures and queries the area of the specified source channel. The default unit is volt-second.
Page 142: Measure:mparea
RIGOL Chapter 2 Command System Description 2 Queries the average value, current value, standard deviation, maximum value, or minimum value of the area measurement results when the area measurement function of the specified source channel and the statistic function of the measurement results are enabled. The default unit is volt-second.
Page 143 RIGOL Chapter 2 Command System :MEASure:MPARea:SAVerage :MEASure:MPARea:SCURrent :MEASure:MPARea:SDEViation :MEASure:MPARea:SMAXimum :MEASure:MPARea:SMINimum Syntax 1 :MEASure:MPARea:SAVerage [<chan>] :MEASure:MPARea:SCURrent [<chan>] :MEASure:MPARea:SDEViation [<chan>] :MEASure:MPARea:SMAXimum [<chan>] :MEASure:MPARea:SMINimum [<chan>] Description 1 Measures the period area of the specified source channel and enables the statistic function of the measurement results.
Page 144: Measure:nduty
RIGOL Chapter 2 Command System :MEASure:NDUTy Syntax 1 :MEASure:NDUTy [<chan>] Description 1 Measures the negative duty cycle of the specified source channel. Syntax 2 :MEASure:NDUTy? [<chan>] Description 2 Measures and queries the negative duty cycle of the specified source channel.
Page 145: Measure:nwidth
RIGOL Chapter 2 Command System Description 2 Queries the average value, current value, standard deviation, maximum value, or minimum value of the negative duty cycle measurement results when the negative duty cycle measurement function of the specified source channel and the statistic function of the measurement results are enabled.
Page 146: Measure:overshoot
RIGOL Chapter 2 Command System :MEASure:NWIDth:SAVerage :MEASure:NWIDth:SCURrent :MEASure:NWIDth:SDEViation :MEASure:NWIDth:SMAXimum :MEASure:NWIDth:SMINimum Syntax 1 :MEASure:NWIDth:SAVerage [<chan>] :MEASure:NWIDth:SCURrent [<chan>] :MEASure:NWIDth:SDEViation [<chan>] :MEASure:NWIDth:SMAXimum [<chan>] :MEASure:NWIDth:SMINimum [<chan>] Description 1 Measures the negative pulse width of the specified source channel and enables the statistic function of the measurement results.
Page 147 RIGOL Chapter 2 Command System Description 2 Measures and queries the overshoot of the specified source channel. Parameter Name Type Range Default <chan> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Remarks Before making measurements, turn on the channels to be measured.  When the math operation type is FFT (refer to the :CALCulate:MODE command), <chan> cannot be ...
Page 148: Measure:pduty
RIGOL Chapter 2 Command System When [<chan>] is omitted, the command, by default, applies to the currently set measurement source  (refer to the :MEASure:SOURce command). Return Format The query returns the average value, current value, standard deviation, maximum value, or minimum value in scientific notation.
Page 149: Measure:period
RIGOL Chapter 2 Command System Syntax 2 :MEASure:PDUTy:SAVerage? [<chan>] :MEASure:PDUTy:SCURrent? [<chan>] :MEASure:PDUTy:SDEViation? [<chan>] :MEASure:PDUTy:SMAXimum? [<chan>] :MEASure:PDUTy:SMINimum? [<chan>] Description 2 Queries the average value, current value, standard deviation, maximum value, or minimum value of the positive duty cycle measurement results when the positive duty cycle measurement function of the specified source channel and the statistic function of the measurement results are enabled.
Page 150: Measure:preshoot
RIGOL Chapter 2 Command System :MEASure:PERiod:SAVerage :MEASure:PERiod:SCURrent :MEASure:PERiod:SDEViation :MEASure:PERiod:SMAXimum :MEASure:PERiod:SMINimum Syntax 1 :MEASure:PERiod:SAVerage [<chan>] :MEASure:PERiod:SCURrent [<chan>] :MEASure:PERiod:SDEViation [<chan>] :MEASure:PERiod:SMAXimum [<chan>] :MEASure:PERiod:SMINimum [<chan>] Description 1 Measures the period of the specified source channel and enables the statistic function of the measurement results.
Page 151 RIGOL Chapter 2 Command System Description 2 Measures and queries the preshoot of the specified source channel. Parameter Name Type Range Default <chan> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Remarks Before making measurements, turn on the channels to be measured.  When the math operation type is FFT (refer to the :CALCulate:MODE command), <chan> cannot be ...
Page 152: Measure:pvrms
RIGOL Chapter 2 Command System When the math operation type is FFT (refer to the :CALCulate:MODE command), <chan> cannot be  set to "MATH". When [<chan>] is omitted, the command, by default, applies to the currently set measurement source ...
Page 153: Measure:pwidth
RIGOL Chapter 2 Command System Description 1 Measures the period amplitude effective value (Per. Vrms) of the specified source channel and enables the statistic function of the measurement results. Syntax 2 :MEASure:PVRMs:SAVerage? [<chan>] :MEASure:PVRMs:SCURrent? [<chan>] :MEASure:PVRMs:SDEViation? [<chan>] :MEASure:PVRMs:SMAXimum? [<chan>] :MEASure:PVRMs:SMINimum? [<chan>]...
Page 154 RIGOL Chapter 2 Command System When the math operation type is FFT (refer to the :CALCulate:MODE command), <chan> cannot be  set to "MATH". When [<chan>] is omitted, the command, by default, applies to the currently set measurement source ...
Page 155: Measure:recover
RIGOL Chapter 2 Command System :MEASure:RECover Syntax :MEASure:RECover <item> Description Recovers the measurement items that have been cleared. Parameter Name Type Range Default <item> Discrete {ITEM1|ITEM2|ITEM3|ITEM4|ITEM5|ALL} Remarks After you have recovered the measurement items that have been cleared, you can also use the :MEASure:CLEar command to clear them again.
Page 156 RIGOL Chapter 2 Command System :MEASure:RDELay:SAVerage :MEASure:RDELay:SCURrent :MEASure:RDELay:SDEViation :MEASure:RDELay:SMAXimum :MEASure:RDELay:SMINimum Syntax 1 :MEASure:RDELay:SAVerage [<chanA>,<chanB>] :MEASure:RDELay:SCURrent [<chanA>,<chanB>] :MEASure:RDELay:SDEViation [<chanA>,<chanB>] :MEASure:RDELay:SMAXimum [<chanA>,<chanB>] :MEASure:RDELay:SMINimum [<chanA>,<chanB>] Description 1 Measures the delay (rising edge-rising edge) between the two specified source channels, and enables the statistic function of the measurement results.
Page 157: Measure:r2Fdelay
RIGOL Chapter 2 Command System :MEASure:R2FDelay Syntax 1 :MEASure:R2FDelay [<chanA>,<chanB>] Description 1 Measures the delay (rising edge-falling edge) between the two specified source channels. Syntax 2 :MEASure:R2FDelay? [<chanA>,<chanB>] Description 2 Measures and queries the delay (rising edge-falling edge) between the two specified source channels. The default unit is s.
Page 158: Measure:rphase
RIGOL Chapter 2 Command System Description 2 Queries the average value, current value, standard deviation, maximum value, or minimum value of the delay (rising edge-falling edge) measurement results when the delay (rising edge-falling edge) measurement function between the two specified source channels and the statistic function of the measurement results are enabled.
Page 159 RIGOL Chapter 2 Command System :MEASure:RPHase:SAVerage :MEASure:RPHase:SCURrent :MEASure:RPHase:SDEViation :MEASure:RPHase:SMAXimum :MEASure:RPHase:SMINimum Syntax 1 :MEASure:RPHase:SAVerage [<chanA>,<chanB>] :MEASure:RPHase:SCURrent [<chanA>,<chanB>] :MEASure:RPHase:SDEViation [<chanA>,<chanB>] :MEASure:RPHase:SMAXimum [<chanA>,<chanB>] :MEASure:RPHase:SMINimum [<chanA>,<chanB>] Description 1 Measures the phase deviation (rising edge-rising edge) between the two specified source channels and enables the statistic function of the measurement results.
Page 160: Measure:r2Fphase
RIGOL Chapter 2 Command System :MEASure:R2FPhase Syntax 1 :MEASure:R2FPhase [<chanA>,<chanB>] Description 1 Measures the phase deviation (rising edge-falling edge) between the two specified source channels. Syntax 2 :MEASure:R2FPhase? [<chanA>,<chanB>] Description 2 Measures and queries the phase deviation (rising edge-falling edge) between the two specified source channels.
Page 161: Measure:rtime
RIGOL Chapter 2 Command System Description 2 Queries the average value, current value, standard deviation, maximum value, or minimum value of the phase deviation (rising edge-falling edge) measurement results when the phase deviation (rising edge-falling edge) measurement function between the two specified source channels and the statistic function of the measurement results are enabled.
Page 162 RIGOL Chapter 2 Command System :MEASure:RTIMe:SAVerage :MEASure:RTIMe:SCURrent :MEASure:RTIMe:SDEViation :MEASure:RTIMe:SMAXimum :MEASure:RTIMe:SMINimum Syntax 1 :MEASure:RTIMe:SAVerage [<chan>] :MEASure:RTIMe:SCURrent [<chan>] :MEASure:RTIMe:SDEViation [<chan>] :MEASure:RTIMe:SMAXimum [<chan>] :MEASure:RTIMe:SMINimum [<chan>] Description 1 Measures the rise time of the specified source channel and enables the statistic function of the measurement results.
Page 163: Measure:setup:dsa
RIGOL Chapter 2 Command System :MEASure:SETup:DSA :MEASure:SETup:DSB Syntax :MEASure:SETup:DSA <sourA> :MEASure:SETup:DSA? :MEASure:SETup:DSB <sourB> :MEASure:SETup:DSB? Description Sets or queries the channel source of Source A or Source B in delay measurement. Parameter Name Type Range Default <sourA> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 <sourB>...
Page 164: Measure:setup:psa
RIGOL Chapter 2 Command System Remarks The upper limit, middle value, and lower limit of the threshold are expressed as the percentages of the  vertical amplitude. Setting the threshold will affect the measurement results of the time, delay and phase parameters.
Page 165: Measure:setup:type
RIGOL Chapter 2 Command System :MEASure:SETup:TYPE Syntax :MEASure:SETup:TYPE <type> :MEASure:SETup:TYPE? Description Sets or queries the type of the measurement setting. Parameter Name Type Range Default <type> Discrete {DELay|PHASe|THReshold} DELay Return Format The query returns DEL, PHAS, or THR. :MEASure:STATistic:DISPlay Syntax :MEASure:STATistic:DISPlay <bool>...
Page 166: Measure:statistic:reset
RIGOL Chapter 2 Command System Remarks EXTRemum: The current value, average value, minimum value, and maximum value are displayed at  the bottom of the screen. DIFFerence: The current value, average value, standard deviation, and count value are displayed at ...
Page 167: Measure:vamp
RIGOL Chapter 2 Command System :MEASure:VAMP Syntax 1 :MEASure:VAMP [<chan>] Description 1 Measures the amplitude of the specified source channel. Syntax 2 :MEASure:VAMP? [<chan>] Description 2 Measures and queries the amplitude of the specified source channel. The unit is related to the current amplitude unit of the specified source channel.
Page 168: Measure:vavg
RIGOL Chapter 2 Command System Description 2 Queries the average value, current value, standard deviation, maximum value, or minimum value of the amplitude measurement results when the amplitude measurement function of the specified source channel and the statistic function of the measurement results are enabled. The unit is related to the current amplitude unit of the specified source channel.
Page 169 RIGOL Chapter 2 Command System :MEASure:VAVG:SAVerage :MEASure:VAVG:SCURrent :MEASure:VAVG:SDEViation :MEASure:VAVG:SMAXimum :MEASure:VAVG:SMINimum Syntax 1 :MEASure:VAVG:SAVerage [<chan>] :MEASure:VAVG:SCURrent [<chan>] :MEASure:VAVG:SDEViation [<chan>] :MEASure:VAVG:SMAXimum [<chan>] :MEASure:VAVG:SMINimum [<chan>] Description 1 Measures the amplitude average value of the specified source channel and enables the statistic function of the measurement results.
Page 170: Measure:vbase
RIGOL Chapter 2 Command System :MEASure:VBASe Syntax 1 :MEASure:VBASe [<chan>] Description 1 Measures the amplitude base value of the specified source channel. Syntax 2 :MEASure:VBASe? [<chan>] Description 2 Measures and queries the amplitude base value of the specified source channel. The unit is related to the current amplitude unit of the specified source channel.
Page 171: Measure:vmax
RIGOL Chapter 2 Command System Description 2 Queries the average value, current value, standard deviation, maximum value, or minimum value of the amplitude base value measurement results when the amplitude base value measurement function of the specified source channel and the statistic function of the measurement results are enabled. The unit is related to the current amplitude unit of the specified source channel.
Page 172 RIGOL Chapter 2 Command System :MEASure:VMAX:SAVerage :MEASure:VMAX:SCURrent :MEASure:VMAX:SDEViation :MEASure:VMAX:SMAXimum :MEASure:VMAX:SMINimum Syntax 1 :MEASure:VMAX:SAVerage [<chan>] :MEASure:VMAX:SCURrent [<chan>] :MEASure:VMAX:SDEViation [<chan>] :MEASure:VMAX:SMAXimum [<chan>] :MEASure:VMAX:SMINimum [<chan>] Description 1 Measures the maximum amplitude value of the specified source channel and enables the statistic function of the measurement results.
Page 173: Measure:vmin
RIGOL Chapter 2 Command System :MEASure:VMIN Syntax 1 :MEASure:VMIN [<chan>] Description 1 Measures the minimum amplitude value of the specified source channel. Syntax 2 :MEASure:VMIN? [<chan>] Description 2 Measures and queries the minimum amplitude value of the specified source channel. The unit is related to the current amplitude unit of the specified source channel.
Page 174: Measure:vpp
RIGOL Chapter 2 Command System Description 2 Queries the average value, current value, standard deviation, maximum value, or minimum value of the measurement results for the minimum amplitude value when the minimum amplitude value measurement function of the specified source channel and the statistic function of the measurement results are enabled.
Page 175 RIGOL Chapter 2 Command System :MEASure:VPP:SAVerage :MEASure:VPP:SCURrent :MEASure:VPP:SDEViation :MEASure:VPP:SMAXimum :MEASure:VPP:SMINimum Syntax 1 :MEASure:VPP:SAVerage [<chan>] :MEASure:VPP:SCURrent [<chan>] :MEASure:VPP:SDEViation [<chan>] :MEASure:VPP:SMAXimum [<chan>] :MEASure:VPP:SMINimum [<chan>] Description 1 Measures the peak-peak value of the specified source channel and enables the statistic function of the measurement results.
Page 176: Measure:vrms
RIGOL Chapter 2 Command System :MEASure:VRMS Syntax 1 :MEASure:VRMS [<chan>] Description 1 Measures the amplitude effective value (Vrms) of the specified source channel. Syntax 2 :MEASure:VRMS? [<chan>] Description 2 Measures and queries the amplitude effective value (Vrms) of the specified source channel. The unit is related to the current amplitude unit of the specified source channel.
Page 177: Measure:vtop
RIGOL Chapter 2 Command System Description 2 Queries the average value, current value, standard deviation, maximum value, or minimum value of the measurement results of the amplitude effective value (Vrms) when the measurement function of the amplitude effective value (Vrms) of the specified source channel and the statistic function of the measurement results are enabled.
Page 178 RIGOL Chapter 2 Command System :MEASure:VTOP:SAVerage :MEASure:VTOP:SCURrent :MEASure:VTOP:SDEViation :MEASure:VTOP:SMAXimum :MEASure:VTOP:SMINimum Syntax 1 :MEASure:VTOP:SAVerage [<chan>] :MEASure:VTOP:SCURrent [<chan>] :MEASure:VTOP:SDEViation [<chan>] :MEASure:VTOP:SMAXimum [<chan>] :MEASure:VTOP:SMINimum [<chan>] Description 1 Measures the amplitude top value of the specified source channel and enables the statistic function of the measurement results.
Page 179: Recall Commands
RIGOL Chapter 2 Command System :RECall Commands Command List: :RECall:MTESt  :RECall:REFerence  :RECall:SETup  :RECall:TRACe  :RECall:WAVeform  :RECall:MTESt Syntax :RECall:MTEst <file_spec> Description Recalls the pass/fail test mask file stored in the external memory. Parameter Name Type Range Default <file_spec>...
Page 180: Recall:setup
RIGOL Chapter 2 Command System :RECall:SETup Syntax :RECall:SETup <file_spec> Description Recalls the setup file stored in the external memory. Parameter Name Type Range Default <file_spec> includes the file storage location and the filename with a suffix. Its length cannot exceed 64 characters.
Page 181: Recall:waveform
RIGOL Chapter 2 Command System :RECall:WAVeform Syntax :RECall:WAVeform <file_spec> Description Recalls the waveform file stored in the external memory. Parameter Name Type Range Default <file_spec> includes the file storage location and the filename with a suffix. Its length cannot exceed 64 characters.
Page 182: Reference Commands
RIGOL Chapter 2 Command System :REFerence Commands Command List: :REFerence:COLor  :REFerence:CURRent?  :REFerence:DISPlay  :REFerence:RESet  :REFerence:SAVe  :REFerence:SOURce  :REFerence:VOFFset  :REFerence:VSCale  :REFerence<n>:CURRent  :REFerence<n>:ENABle  :REFerence:COLor Syntax :REFerence:COLor <color> :REFerence:COLor? Description Sets or queries the color of the current reference waveform.
Page 183: Reference:display
RIGOL Chapter 2 Command System :REFerence:DISPlay Syntax :REFerence:DISPlay <bool> :REFerence:DISPlay? Description Turns on or off the REF function; or queries the on/off status of the REF function. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 0|OFF Remarks When the REF function is enabled or disabled, the display of the currently enabled reference waveform channel(s) will be turned on or off (refer to the :REFerence<n>:ENABle command).
Page 184: Reference:source
RIGOL Chapter 2 Command System :REFerence:SOURce Syntax :REFerence:SOURce <source> :REFerence:SOURce? Description Sets or queries the source channel of the current reference waveform channel. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} CHANnel1 Remarks Only the currently enabled channel can be selected as the source channel of the reference waveform.
Page 185: Reference:Current
RIGOL Chapter 2 Command System Remarks Defines the saved vertical scale of the reference waveform as Vscale0, the currently set vertical scale of the reference waveform as Vscale1. Different values of <vscale> indicate different ratios between Vscale0 and Vscale1, as shown in the table below.
Page 186: Save Commands
RIGOL Chapter 2 Command System :SAVE Commands Command List: :SAVE:CSV[:STARt]  :SAVE:CSV:FACTors  :SAVE:CSV:LENGth  :SAVE:FORMat  :SAVE:IMAGe[:STARt]  :SAVE:IMAGe:TYPE  :SAVE:IMAGe:FACTors  :SAVE:SETup[:STARt]  :SAVE:TRACe[:STARt]  :SAVE:WAVeform[:STARt]  :SAVE:REFerence[:STARt]  :SAVE:MTESt[:STARt]  :SAVE:CSV[:STARt] Syntax :SAVE:CSV[:STARt] <file_spec> Description Saves the waveform data to the external memory in "*.csv" format.
Page 187: Save:csv:length
RIGOL Chapter 2 Command System Remarks After this function is enabled, when you send the :SAVE:CSV[:STARt] command to save the "*.csv" file, a ".txt" file with the same filename will also be saved. This file includes the model, serial number, hardware and software version number, as well as the current parameter configurations of the oscilloscope.
Page 188: Save:image[:Start]
RIGOL Chapter 2 Command System :SAVE:IMAGe[:STARt] Syntax :SAVE:IMAGe[:STARt] <file_spec> Description Stores the contents displayed on the screen into the external memory in image format. Parameter Name Type Range Default <file_spec> includes the file storage location and the filename with a suffix. Its length cannot exceed 64 characters.
Page 189: Save:setup[:Start]
RIGOL Chapter 2 Command System Remarks After this function is enabled, when you send the :SAVE:IMAGe[:STARt] command to save the image file, a ".txt" file with the same filename will also be saved. This file includes the model, serial number, hardware and software version number, as well as the current parameter configurations of the oscilloscope.
Page 190: Save:waveform[:Start]
RIGOL Chapter 2 Command System :SAVE:WAVeform[:STARt] Syntax :SAVE:WAVeform[:STARt] {<file_spec>} Description Saves the waveform data to the external memory in "*.wfm" format. Parameter Name Type Range Default <file_spec> includes the file storage location and the filename with a suffix. Its length cannot exceed 64 characters.
Page 191: Save:mtest[:Start]
RIGOL Chapter 2 Command System :SAVE:MTESt[:STARt] Syntax :SAVE:MTESt[:STARt] <file_spec> Description Saves the current pass/fail test mask to the external memory in "*.pf" format. Parameter Name Type Range Default <file_spec> includes the file storage location and the filename with a suffix. Its length cannot exceed 64 characters.
Page 192: System Commands
RIGOL Chapter 2 Command System :SYSTem Commands Command List: :SYSTem:AOUTput  :SYSTem:AUToscale  :SYSTem:BEEPer  :SYSTem:DATE  :SYSTem:ERRor[:NEXT]?  :SYSTem:ETIMpedence  :SYSTem:EXPand  :SYSTem:GAMount?  :SYSTem:GPIB  :SYSTem:LANGuage  :SYSTem:OPTion:INSTall  :SYSTem:OPTion:UNINSTall  :SYSTem:PON  :SYSTem:PSTatus  :SYSTem:RAMount?  :SYSTem:RCLOck ...
Page 193: System:autoscale
RIGOL Chapter 2 Command System :SYSTem:AUToscale Syntax :SYSTem:AUToscale <bool> :SYSTem:AUToscale? Description Enables or disables the Auto function; or queries the on/off status of the Auto function. Parameter Name Type Range Default <bool> Bool {{1|ON}|{0|OFF}} 1|ON Remarks 1|ON: enables the Auto function. After it is enabled, you can use the :AUToscale command (or press ...
Page 194: System:date
RIGOL Chapter 2 Command System :SYSTem:DATE Syntax :SYSTem:DATE <year>,<month>,<day> :SYSTem:DATE? Description Sets or queries the system date. Parameter Name Type Range Default <year> Integer 1999 to 2099 <month> Integer 1 to 12 <day> Integer 1 to 31 (28, 29, or 30) Return Format The query returns the system date in strings.
Page 195: System:expand
RIGOL Chapter 2 Command System :SYSTem:EXPand Syntax :SYSTem:EXPand <exp> :SYSTem:EXPand? Description Sets or queries the vertical reference. Parameter Name Type Range Default <exp> Discrete {CENTer|GROund} GROund Remarks CENTer: when the vertical scale of the channel is modified, the waveform of the corresponding ...
Page 196: System:language
Obtain an option license Log in to the RIGOL official website (www.rigol.com), click SERVICE  Software License Register to enter the "Registered product license code" interface. In the interface, enter the correct key, serial number (press System, and select the "Info." tab to obtain the serial number of the instrument), and verification code.
Page 197: System:pon
RIGOL Chapter 2 Command System :SYSTem:PON Syntax :SYSTem:PON <pon> :SYSTem:PON? Description Sets or queries the system configuration recalled by the oscilloscope when it is powered on again after power-off. Parameter Name Type Range Default <pon> Discrete {LATest|DEFault} Remarks LATest: restores the oscilloscope to the system configuration at the last power-off.
Page 198: System:rclock
RIGOL Chapter 2 Command System :SYSTem:RCLOck Syntax :SYSTem:RCLock <clock> :SYSTem:RCLock? Description Sets or queries the type of the reference clock. Parameter Name Type Range Default <clock> Discrete {COUTput|CINPut} COUTput Remarks COUTput: indicates clock output. The oscilloscope outputs the internal 10 MHz clock signal from the ...
Page 199: System:ssaver:time
RIGOL Chapter 2 Command System When sending the command, directly place the data stream after the command string, then complete  the whole sending process in one time. When reading the data stream, ensure that there is enough buffer space to receive the data stream; otherwise, errors might occur in reading the program.
Page 200: System:udevice
RIGOL Chapter 2 Command System :SYSTem:UDEVice Syntax :SYSTem:UDEVice <udv> :SYSTem:UDEVice? Description Sets or queries the type of the device connected to the USB Device interface. Parameter Name Type Range Default <udv> Discrete {COMPuter|PICTbridge} COMPuter Remarks COMPuter: The oscilloscope can communicate with a PC via the USB DEVICE interface on the rear ...
Page 201: Timebase Commands
RIGOL Chapter 2 Command System :TIMebase Commands Command List: :TIMebase:DELay:ENABle  :TIMebase:DELay:OFFSet  :TIMebase:DELay:SCALe  :TIMebase:HREF:MODE  :TIMebase:HREF:POSition  :TIMebase:MODE  :TIMebase:VERNier  :TIMebase:XY1:DISPlay  :TIMebase:XY2:DISPlay  :TIMebase[:MAIN]:OFFSet  :TIMebase[:MAIN]:SCALe  :TIMebase:DELay:ENABle Syntax :TIMebase:DELay:ENABle <bool> :TIMebase:DELay:ENABle? Description Turns on or off the delayed sweep; or queries the on/off status of the delayed sweep.
Page 202: Timebase:delay:scale
RIGOL Chapter 2 Command System DelayRange = 14 x DelayScale. MainScale is the main time base, refer to the :TIMebase[:MAIN]:SCALe command; MainOffset is the horizontal position (normal sweep), refer to the :TIMebase[:MAIN]:OFFSet command; DelayScale is the horizontal time base of the delayed sweep, refer to the :TIMebase:DELay:SCALe command.
Page 203: Timebase:href:position
RIGOL Chapter 2 Command System :TIMebase:HREF:POSition Syntax :TIMebase:HREF:POSition <pos> :TIMebase:HREF:POSition? Description Sets or queries the user-defined horizontal reference position when the horizontal reference is set to "USER" (refer to the :TIMebase:HREF:MODE command). Parameter Name Type Range Default <pos> Integer -350 to +350 Remarks The leftmost, rightmost, and center of the screen are 350, -350, and 0 respectively.
Page 204: Timebase:xy1:Display
RIGOL Chapter 2 Command System Remarks 1|ON: enables the fine adjustment function. Rotate Horizontal SCALE to further adjust the  horizontal time base at a relatively smaller step. 0|OFF: disables the fine adjustment function. Rotate Horizontal SCALE to adjust the horizontal ...
Page 205: Timebase[:Main]:Scale
RIGOL Chapter 2 Command System Parameter Name Type Range Default <offset> Real Refer to Remarks Remarks The range of <offset> is related to the current horizontal time base mode (refer to the :TIMebase:MODE command) and the operating state of the oscilloscope.
Page 206: Trigger Commands
RIGOL Chapter 2 Command System :TRIGger Commands Command List: :TRIGger:COUPling  :TRIGger:HOLDoff  :TRIGger:MODE  :TRIGger:STATus?  :TRIGger:SWEep  :TRIGger:NREJect  :TRIGger:CAN  :TRIGger:EDGe  :TRIGger:IIC  :TRIGger:PATTern  :TRIGger:PULSe  :TRIGger:RUNT  :TRIGger:NEDGe  :TRIGger:RS232  :TRIGger:SLOPe  :TRIGger:SPI ...
Page 207: Trigger:holdoff
RIGOL Chapter 2 Command System :TRIGger:HOLDoff Syntax :TRIGger:HOLDoff <value> :TRIGger:HOLDoff? Description Sets or queries the trigger holdoff time. The default unit is s. Parameter Name Type Range Default <value> Real 100 ns to 10 s 100 ns Remarks The trigger types that support the holdoff include Edge trigger, Pulse trigger, Runt trigger, Slope trigger, and Pattern trigger.
Page 208: Trigger:sweep
RIGOL Chapter 2 Command System :TRIGger:SWEep Syntax :TRIGger:SWEep <sweep> :TRIGger:SWEep? Description Sets or queries the trigger mode. Parameter Name Type Range Default <sweep> Discrete {AUTO|NORMal|SINGle} AUTO Remarks AUTO: indicates the auto trigger. In this trigger mode, if the specified trigger condition is not found, ...
Page 209: Trigger:can
RIGOL Chapter 2 Command System :TRIGger:CAN Command List: :TRIGger:CAN:BAUD  :TRIGger:CAN:BUSer  :TRIGger:CAN:FTYPe  :TRIGger:CAN:LEVel  :TRIGger:CAN:SOURce  :TRIGger:CAN:SPOint  :TRIGger:CAN:STYPe  :TRIGger:CAN:WHEN  :TRIGger:CAN:BAUD Syntax :TRIGger:CAN:BAUD <baud> :TRIGger:CAN:BAUD? Description Sets or queries the signal rate of CAN trigger. The default unit is b/s.
Page 210 RIGOL Chapter 2 Command System :TRIGger:CAN:FTYPe Syntax :TRIGger:CAN:FTYPe <ftype> :TRIGger:CAN:FTYPe? Description Sets or queries the frame type of CAN trigger when the trigger condition is "FTYPe" (refer to the :TRIGger:CAN:WHEN command). Parameter Name Type Range Default <ftype> Discrete {DATA|REMote|ERRor|OVERload} DATA Remarks DATA: indicates data frame.
Page 211 RIGOL Chapter 2 Command System Description Sets or queries the source channel of CAN trigger. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Remarks Channels that are not currently turned on can also be selected as the trigger source.
Page 212 RIGOL Chapter 2 Command System differential probe. The positive polarity of the differential probe connects the CAN_H bus signal, and the negative polarity connects the CAN_L bus signal. Return Format The query returns RX, TX, H, L, or DIFF. :TRIGger:CAN:WHEN Syntax :TRIGger:CAN:WHEN <cond>...
Page 213: Trigger:edge
RIGOL Chapter 2 Command System :TRIGger:EDGe Command List: :TRIGger:EDGe:LEVel  :TRIGger:EDGe:SLOPe  :TRIGger:EDGe:SOURce  :TRIGger:EDGe:LEVel Syntax :TRIGger:EDGe:LEVel <level> :TRIGger:EDGe:LEVel? Description Sets or queries the trigger level of Edge trigger. The unit is the same as the current amplitude unit of the source channel.
Page 214 RIGOL Chapter 2 Command System NEGative: indicates that the oscilloscope triggers at the crossing point where the falling edge of the  input signal meets the preset trigger level. RFALl: indicates that the oscilloscope triggers at the crossing point where the rising or falling edge of ...
Page 215: Trigger:iic
RIGOL Chapter 2 Command System :TRIGger:IIC Command List: :TRIGger:IIC:ADDRess  :TRIGger:IIC:AWIDth  :TRIGger:IIC:CLEVel  :TRIGger:IIC:DATA  :TRIGger:IIC:DIRection  :TRIGger:IIC:DLEVel  :TRIGger:IIC:SCL  :TRIGger:IIC:SDA  :TRIGger:IIC:WHEN  :TRIGger:IIC:ADDRess Syntax :TRIGger:IIC:ADDRess <address> :TRIGger:IIC:ADDRess? Description Sets or queries the address of IIC trigger when the trigger condition is "ADDRess" or "ADATa" (refer to the :TRIGger:IIC:WHEN command).
Page 216 RIGOL Chapter 2 Command System :TRIGger:IIC:CLEVel Syntax :TRIGger:IIC:CLEVel <level> :TRIGger:IIC:CLEVel? Description Sets or queries the trigger level of the clock signal of IIC trigger. The unit is the same as the current amplitude unit of the source channel. Parameter Name...
Page 217 RIGOL Chapter 2 Command System Remarks You do not need to set the data direction when the address width of IIC trigger is 8 bits (refer to the :TRIGger:IIC:AWIDth command). Return Format The query returns READ, WRIT, or RWR. :TRIGger:IIC:DLEVel Syntax :TRIGger:IIC:DLEVel <level>...
Page 218 RIGOL Chapter 2 Command System :TRIGger:IIC:SDA Syntax :TRIGger:IIC:SDA <source> :TRIGger:IIC:SDA? Description Sets or queries the source channel of the data line of IIC trigger. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel2 Remarks Channels that are not currently turned on can also be selected as the trigger source.
Page 219: Trigger:pattern
RIGOL Chapter 2 Command System :TRIGger:PATTern Command List: :TRIGger:PATTern:LEVel  :TRIGger:PATTern:PATTern  :TRIGger:PATTern:SOURce  :TRIGger:PATTern:LEVel Syntax :TRIGger:PATTern:LEVel [<chan>,]<level> :TRIGger:PATTern:LEVel? [<chan>] Description Sets or queries the trigger level of the specified channel of Pattern trigger. If <chan> is omitted, the command sets or queries the trigger level of the current channel (refer to the :TRIGger:PATTern:SOURce command).
Page 220 RIGOL Chapter 2 Command System Parameter Name Type Range Default <pch1> Discrete {H|L|X|R|F} <pch2> Discrete {H|L|X|R|F} <pch3> Discrete {H|L|X|R|F} <pch4> Discrete {H|L|X|R|F} <pext> Discrete {H|L|X|R|F} Remarks <pch1>-<pch4> represent the patterns of the analog channels (CH1-CH4) respectively; <pext>  represents the pattern of the external trigger channel (EXT TRIG). By default, the instrument sets the patterns of the channels (CH1-CH4) first, and then the external trigger channel EXT TRIG.
Page 221: Trigger:pulse
RIGOL Chapter 2 Command System :TRIGger:PULSe Command List: :TRIGger:PULSe:LEVel  :TRIGger:PULSe:LWIDth  :TRIGger:PULSe:SOURce  :TRIGger:PULSe:UWIDth  :TRIGger:PULSe:WHEN  :TRIGger:PULSe:LEVel Syntax :TRIGger:PULSe:LEVel <level> :TRIGger:PULSe:LEVel? Description Sets or queries the trigger level of Pulse trigger. The unit is the same as the current amplitude unit of the source channel.
Page 222 RIGOL Chapter 2 Command System Remarks When the trigger condition is "PGLess" or "NGLess" (refer to the :TRIGger:PULSe:WHEN command), the lower limit of the pulse width must be smaller than the upper limit of the current pulse width (refer to the :TRIGger:PULSe:UWIDth command).
Page 223 RIGOL Chapter 2 Command System :TRIGger:PULSe:WHEN Syntax :TRIGger:PULSe:WHEN <cond> :TRIGger:PULSe:WHEN? Description Sets or queries the trigger condition of Pulse trigger. Parameter Name Type Range Default <cond> Discrete {PGReater|PLESs|NGReater|NLESs|PGLess|NGLess} PGReater Remarks PGReater: indicates that the oscilloscope triggers when the positive pulse width of the input signal is ...
Page 224: Trigger:runt
RIGOL Chapter 2 Command System :TRIGger:RUNT Command List: :TRIGger:RUNT:ALEVel  :TRIGger:RUNT:BLEVel  :TRIGger:RUNT:POLarity  :TRIGger:RUNT:SOURce  :TRIGger:RUNT:WHEN  :TRIGger:RUNT:WLOWer  :TRIGger:RUNT:WUPPer  :TRIGger:RUNT:ALEVel Syntax :TRIGger:RUNT:ALEVel <level> :TRIGger:RUNT:ALEVel? Description Sets or queries the upper limit of trigger level of Runt trigger (namely the high level). The unit is the same as the current amplitude unit of the source channel.
Page 225 RIGOL Chapter 2 Command System Parameter Name Type Range Default The range of <level> is from (-6 x VerticalScale - Offset) to (5.98 x VerticalScale - Offset) (relative to the vertical center of the screen). <level> Real Wherein, VerticalScale is the vertical scale of the source channel, refer to the :CHANnel<n>:SCALe command;...
Page 226 RIGOL Chapter 2 Command System Return Format The query returns CHAN1, CHAN2, CHAN3, or CHAN4. :TRIGger:RUNT:WHEN Syntax :TRIGger:RUNT:WHEN <cond> :TRIGger:RUNT:WHEN? Description Sets or queries the trigger conditions of Runt trigger. Parameter Name Type Range Default <cond> Discrete {NONE|GREater|LESS|GLESs} NONE Remarks NONE: indicates that no trigger conditions of Runt trigger are set.
Page 227 RIGOL Chapter 2 Command System :TRIGger:RUNT:WUPPer Syntax :TRIGger:RUNT:WUPPer <width> :TRIGger:RUNT:WUPPer? Description Sets or queries the maximum pulse width (i.g. upper limit of the pulse width) of Runt trigger when the trigger condition is "LESS" or "GLESs" (refer to the :TRIGger:RUNT:WHEN command).
Page 228: Trigger:nedge
RIGOL Chapter 2 Command System :TRIGger:NEDGe Command List: :TRIGger:NEDGe:EDGE  :TRIGger:NEDGe:IDLE  :TRIGger:NEDGe:LEVel  :TRIGger:NEDGe:SLOPe  :TRIGger:NEDGe:SOURce  :TRIGger:NEDGe:EDGE Syntax :TRIGger:NEDGe:EDGE <edge> :TRIGger:NEDGe:EDGE? Description Sets or queries the number of edges for the Nth edge trigger. Parameter Name Type Range Default <edge>...
Page 229 RIGOL Chapter 2 Command System Parameter Name Type Range Default The range of <level> is from (-6 x VerticalScale - Offset) to (6 x VerticalScale - Offset) (relative to the vertical center of the screen). <level> Real Wherein, VerticalScale is the vertical scale of the source channel, refer to the :CHANnel<n>:SCALe command;...
Page 230: Trigger:rs232
RIGOL Chapter 2 Command System :TRIGger:RS232 Command List: :TRIGger:RS232:BAUD  :TRIGger:RS232:BUSer  :TRIGger:RS232:DATA  :TRIGger:RS232:LEVel  :TRIGger:RS232:PARity  :TRIGger:RS232:SOURce  :TRIGger:RS232:STOP  :TRIGger:RS232:WHEN  :TRIGger:RS232:WIDTh  :TRIGger:RS232:BAUD Syntax :TRIGger:RS232:BAUD <baud> :TRIGger:RS232:BAUD? Description Sets or queries the baud rate of RS232 trigger. The default unit is bps.
Page 231 RIGOL Chapter 2 Command System :TRIGger:RS232:DATA Syntax :TRIGger:RS232:DATA <data> :TRIGger:RS232:DATA? Description Sets or queries the data value of RS232 trigger when the trigger condition is "DATA" (refer to the :TRIGger:RS232:WHEN command). Parameter Name Type Range Default Refer to Remarks <data>...
Page 232 RIGOL Chapter 2 Command System Parameter Name Type Range Default <parity> Discrete {EVEN|ODD|NONE} NONE Remarks The even-odd check mode cannot be set to NONE when the trigger condition is "PARity" (refer to the :TRIGger:RS232:WHEN command). Return Format The query returns EVEN, ODD, or NONE.
Page 233 RIGOL Chapter 2 Command System :TRIGger:RS232:WHEN Syntax :TRIGger:RS232:WHEN <cond> :TRIGger:RS232:WHEN? Description Sets or queries the trigger condition of RS232 trigger. Parameter Name Type Range Default <cond> Discrete {STARt|ERRor|PARity|DATA} STARt Remarks STARt: indicates start of frame.The oscilloscope triggers at the start of a frame.
Page 234: Trigger:slope
RIGOL Chapter 2 Command System :TRIGger:SLOPe Command List: :TRIGger:SLOPe:ALEVel  :TRIGger:SLOPe:BLEVel  :TRIGger:SLOPe:SOURce  :TRIGger:SLOPe:TLOWer  :TRIGger:SLOPe:TUPPer  :TRIGger:SLOPe:WHEN  :TRIGger:SLOPe:WINDow  :TRIGger:SLOPe:ALEVel Syntax :TRIGger:SLOPe:ALEVel <level> :TRIGger:SLOPe:ALEVel? Description Sets or queries the upper limit of trigger level of Slope trigger (namely the high level). The unit is the same as the current amplitude unit of the source channel.
Page 235 RIGOL Chapter 2 Command System Parameter Name Type Range Default The range of <level> is from (-6 x VerticalScale - Offset) to (5.98 x VerticalScale - Offset) (relative to the vertical center of the screen). Wherein, VerticalScale is the vertical scale of the source <level>...
Page 236 RIGOL Chapter 2 Command System Remarks When the trigger condition is "PGLess" or "NGLess" (refer to the :TRIGger:SLOPe:WHEN command), the time lower limit must be smaller than the current time upper limit (refer to the :TRIGger:SLOPe:TUPPer command). Return Format The query returns the time lower limit in scientific notation.
Page 237 RIGOL Chapter 2 Command System PGLess: indicates that the oscilloscope triggers when the positive slope time of the input signal is  greater than the lower limit of the specified time (refer to the :TRIGger:SLOPe:TLOWer command) and smaller than the upper limit of the specified time (refer to the :TRIGger:SLOPe:TUPPer command).
Page 238: Trigger:spi
RIGOL Chapter 2 Command System :TRIGger:SPI Command List: :TRIGger:SPI:CLEVel  :TRIGger:SPI:CS  :TRIGger:SPI:DATA  :TRIGger:SPI:DLEVel  :TRIGger:SPI:MODE  :TRIGger:SPI:SCL  :TRIGger:SPI:SDA  :TRIGger:SPI:SLEVel  :TRIGger:SPI:SLOPe  :TRIGger:SPI:TIMeout  :TRIGger:SPI:WHEN  :TRIGger:SPI:WIDTh  :TRIGger:SPI:CLEVel Syntax :TRIGger:SPI:CLEVel <level> :TRIGger:SPI:CLEVel? Description Sets or queries the trigger level of the clock signal of SPI trigger. The unit is the same as the current amplitude unit of the source channel.
Page 239 RIGOL Chapter 2 Command System Remarks Channels that are not currently turned on can also be selected as the trigger source. Return Format The query returns CHAN1, CHAN2, CHAN3, or CHAN4. :TRIGger:SPI:DATA Syntax :TRIGger:SPI:DATA <data> :TRIGger:SPI:DATA? Description Sets or queries the data value of SPI trigger.
Page 240 RIGOL Chapter 2 Command System :TRIGger:SPI:MODE Syntax :TRIGger:SPI:MODE <mode> :TRIGger:SPI:MODE? Description Sets or queries the CS mode of SPI trigger when the trigger condition is "CS" (refer to the :TRIGger:SPI:WHEN command). Parameter Name Type Range Default <mode> Discrete {HIGH|LOW} HIGH Return Format The query returns HIGH or LOW.
Page 241 RIGOL Chapter 2 Command System :TRIGger:SPI:SLEVel Syntax :TRIGger:SPI:SLEVel <level> :TRIGger:SPI:SLEVel? Description Sets or queries the trigger level of the CS signal of SPI trigger when the trigger condition is "CS" (refer to the :TRIGger:SPI:WHEN command). The unit is the same as the current amplitude unit of the source channel.
Page 242 RIGOL Chapter 2 Command System :TRIGger:SPI:TIMeout Syntax :TRIGger:SPI:TIMeout <time> :TRIGger:SPI:TIMeout? Description Sets or queries the timeout value of SPI trigger when the trigger condition is "TIMeout" (refer to the :TRIGger:SPI:WHEN command). The default unit is s. Parameter Name Type Range...
Page 243: Trigger:usb
RIGOL Chapter 2 Command System :TRIGger:USB Command List: :TRIGger:USB:DMINus  :TRIGger:USB:DPLus  :TRIGger:USB:MLEVel  :TRIGger:USB:PLEVel  :TRIGger:USB:SPEed  :TRIGger:USB:WHEN  :TRIGger:USB:DMINus Syntax :TRIGger:USB:DMINus <source> :TRIGger:USB:DMINus? Description Sets or queries the source channel of D- data line of USB trigger. Parameter...
Page 244 RIGOL Chapter 2 Command System :TRIGger:USB:MLEVel Syntax :TRIGger:USB:MLEVel <level> :TRIGger:USB:MLEVel? Description Sets or queries the trigger level of D- data signal of USB trigger. The unit is the same as the current amplitude unit of the source channel. Parameter Name...
Page 245 RIGOL Chapter 2 Command System :TRIGger:USB:SPEed Syntax :TRIGger:USB:SPEed <value> :TRIGger:USB:SPEed? Description Sets or queries the signal rate of USB trigger. Parameter Name Type Range Default <value> Discrete {LOW|FULL} Return Format The query returns LOW or FULL. :TRIGger:USB:WHEN Syntax :TRIGger:USB:WHEN <cond>...
Page 246: Trigger:video
RIGOL Chapter 2 Command System :TRIGger:VIDeo Command List: :TRIGger:VIDeo:LEVel  :TRIGger:VIDeo:LINE  :TRIGger:VIDeo:MODE  :TRIGger:VIDeo:POLarity  :TRIGger:VIDeo:SOURce  :TRIGger:VIDeo:STANdard  :TRIGger:VIDeo:LEVel Syntax :TRIGger:VIDeo:LEVel <level> :TRIGger:VIDeo:LEVel? Description Sets or queries the trigger level of Video trigger. The unit is the same as the current amplitude unit of the source channel.
Page 247 RIGOL Chapter 2 Command System Return Format The query returns an integer. :TRIGger:VIDeo:MODE Syntax :TRIGger:VIDeo:MODE <mode> :TRIGger:VIDeo:MODE? Description Sets or queries the sync trigger mode of Video trigger. Parameter Name Type Range Default <mode> Discrete {ALINes|LINE|ODDField|EVENfield} ALINes Remarks ALINes: indicates all lines. The oscilloscope triggers on the first line found.
Page 248 RIGOL Chapter 2 Command System :TRIGger:VIDeo:SOURce Syntax :TRIGger:VIDeo:SOURce <source> :TRIGger:VIDeo:SOURce? Description Sets or queries the source channel of Video trigger. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Remarks Channels that are not currently turned on can also be selected as the trigger source.
Page 249: Trigger:flexray
RIGOL Chapter 2 Command System :TRIGger:FLEXray Command List: :TRIGger:FLEXray:BAUD  :TRIGger:FLEXray:LEVel  :TRIGger:FLEXray:SOURce  :TRIGger:FLEXray:WHEN  :TRIGger:FLEXray:BAUD Syntax :TRIGger:FLEXray:BAUD <baud> :TRIGger:FLEXray:BAUD? Description Sets or queries the signal rate of FlexRay trigger. The default unit is b/s. Parameter Name Type Range Default <baud>...
Page 250 RIGOL Chapter 2 Command System :TRIGger:FLEXray:SOURce Syntax :TRIGger:FLEXray:SOURce <source> :TRIGger:FLEXray:SOURce? Description Sets or queries the source channel of FlexRay trigger. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Remarks Channels that are not currently turned on can also be selected as the trigger source.
Page 251: Waveform Commands
RIGOL Chapter 2 Command System :WAVeform Commands The :WAVeform commands are used to set the parameters concerning waveform data reading and to read the waveform data. In different waveform data reading mode (refer to the :WAVeform:MODE command), the definition of each parameter is different. The definitions of the parameters in NORMAL and RAW modes are as shown in Figure 2-1 and Figure 2-2.
Page 252: Waveform:begin
RIGOL Chapter 2 Command System Command List: :WAVeform:BEGin  :WAVeform:DATA?  :WAVeform:END  :WAVeform:FORMat  :WAVeform:MODE  :WAVeform:POINts  :WAVeform:PREamble?  :WAVeform:RESet  :WAVeform:SOURce  :WAVeform:STARt  :WAVeform:STATus?  :WAVeform:STOP  :WAVeform:XINCrement?  :WAVeform:XORigin?  :WAVeform:XREFerence?  :WAVeform:YINCrement?  :WAVeform:YORigin? ...
Page 253 RIGOL Chapter 2 Command System Procedures of reading the waveform data in the internal memory: S1. :STOP Sets the oscilloscope to the Stop state (You can only read the waveform data in the internal memory when the oscilloscope is in the Stop state.)
Page 254: Waveform:end
RIGOL Chapter 2 Command System Data Block Header :WAVeform:END Syntax :WAVeform:END Description Stops the waveform data reading. Remarks This command is only applicable to reading waveform data in the internal memory (refer to the :WAVeform:MODE command). :WAVeform:FORMat Syntax :WAVeform:FORMat <format>...
Page 255: Waveform:mode
RIGOL Chapter 2 Command System :WAVeform:MODE Syntax :WAVeform:MODE <mode> :WAVeform:MODE? Description Sets or queries the reading mode of the waveform data. Parameter Name Type Range Default <mode> Discrete {NORMal|RAW|MAXimum} NORMal Remarks NORMal: reads the waveform data displayed on the screen.
Page 256: Waveform:preamble
RIGOL Chapter 2 Command System :WAVeform:PREamble? Syntax :WAVeform:PREamble? Description Queries the waveform parameter settings related to the waveform data reading. Return Format The query returns the parameter settings in strings in the following sequence, and the parameters are separated by commas.
Page 257: Waveform:source
RIGOL Chapter 2 Command System :WAVeform:SOURce Syntax :WAVeform:SOURce <source> :WAVeform:SOURce? Description Sets or queries the source channel of waveform data reading. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH|FFT} CHANnel1 Remarks When the source channel is set to MATH or FFT, only the waveform data displayed on the screen can be read, and the waveform data in the internal memory cannot be read in this mode.
Page 258: Waveform:status
RIGOL Chapter 2 Command System :WAVeform:STATus? Syntax :WAVeform:STATus? Description Queries the current status of waveform data reading. Return Format The query returns IDLE,<n> or READ,<n>. IDLE,<n>: indicates that the waveform data reading thread finishes; <n> is the number of waveform points that have been read.
Page 259: Waveform:xorigin
RIGOL Chapter 2 Command System MAXimum mode: XINCrement = TimeScale/100 when the oscilloscope is in the Run state; XINCrement  = 1/SampleRate when the oscilloscope is in the Stop state. Wherein, TimeScale is the current horizontal time base, refer to the :TIMebase[:MAIN]:SCALe command;...
Page 260: Waveform:yorigin
RIGOL Chapter 2 Command System Return Format The query returns the unit voltage value in scientific notation. :WAVeform:YORigin? Syntax :WAVeform:YORigin? Description Queries the vertical position relative to the vertical reference position (refer to the :WAVeform:YREFerence? command) of the current source channel (refer to the :WAVeform:SOURce command) in the Y direction.
Page 261: Programming Examples
Chapter 3 Programming Examples Chapter 3 Programming Examples This chapter illustrates how to program the DS4000E series digital oscilloscope with SCPI commands based on NI-VISA in Excel, LabVIEW, MATLAB, Visual Basic 6.0, and Visual C++ 6.0. NI-VISA (National Instrument-Virtual Instrument Software Architecture), developed by NI (National Instrument), provides an advanced programming interface to communicate with various instruments through their bus lines.
Page 262: Excel Programming Example
RIGOL Chapter 3 Programming Examples resource (connected to PC via the USB interface) will be under the directory of "RIGOL Online Resource" in the Ultra Sigma interface, with the model of the instrument and the USB information displayed. In this instance, the USB VISA descriptor is USB0::0x1AB1::0x04B1::DS4A0000000001::INSTR By now, the programming preparations are complete.
Page 263 RIGOL Chapter 3 Programming Examples Click the Developer tab and select the Visual Basic option to open the Microsoft Visual Basic. Click Tools in the Microsoft Visual Basic menu bar and select References… Select VISA Library in the pop-up dialog box and click OK to take VISA Library as a reference.
Page 264 RIGOL Chapter 3 Programming Examples Remarks: If you cannot find VISA Library in the left section of the above dialog box, please follow the method below to find it. (1) Make sure that your PC has installed the NI-VISA library.
Page 265 RIGOL Chapter 3 Programming Examples Dim ret As Long 'Turn on the device, and the device resource descriptor is in CELLS(1,2) of SHEET1' viErr = visa.viOpenDefaultRM(viDefRm) viErr = visa.viOpen(viDefRm, Sheet1.Cells(1, 2), 0, 5000, viDevice) ‘Send request, read the data, and the return value is in CELLS(2,2) of SHEET1’...
Page 266 RIGOL Chapter 3 Programming Examples DS4000E Programming Guide...
Page 267 RIGOL Chapter 3 Programming Examples LabVIEW Programming Example Program used in this example: LabVIEW 8.2 Function realized in this instance: reading the waveform data of CH1 on the screen. Run LabVIEW 8.2, and then create a VI file named Demo_LabVIEW.
Page 268 RIGOL Chapter 3 Programming Examples 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.
Page 269 RIGOL Chapter 3 Programming Examples Get the length of the effective waveform data. Convert the character data into array format using the String To Byte Array to display the waveform data on the Waveform Graph control and then remove the TMC data header using the Array Subset function.
Page 270 RIGOL Chapter 3 Programming Examples 3-10 DS4000E Programming Guide...
Page 271 RIGOL Chapter 3 Programming Examples MATLAB Programming Example Program used in this example: MATLAB R2009a Function realized in this instance: making FFT operation on the waveform data and plotting the waveform. Run the MATLAB software and modify the current path. In this example, the current path is modified to be D:\Demo\MATLAB.
Page 272 RIGOL Chapter 3 Programming Examples Save the M file to the current path. In this example, the M file is named as "Demo_MATLAB.m". Run the M file and the running results are displayed as follows: 3-12 DS4000E Programming Guide...
Page 273 RIGOL Chapter 3 Programming Examples Visual Basic 6.0 Programming Example Program used in this example: Visual Basic 6.0 Function realized in this example: controlling the on/off status of any channel. Build a standard application program project (Standard EXE), and name it "Demo_VB".
Page 274 RIGOL Chapter 3 Programming Examples Dim s32Disp As Integer ' Obtain the USB resource of VISA Call viOpenDefaultRM(defrm) Call viFindRsrc(defrm, "USB?*", list, nmatches, matches) ' Turn on the instrument Call viOpen(defrm, matches, 0, 0, vi) ' Send a command to query the status of CH1 Call viVPrintf(vi, ":CHAN1:DISP?"...
Page 275 RIGOL Chapter 3 Programming Examples Visual C++ 6.0 Programming Example Program used in this instance: Microsoft Visual C++ 6.0 Function realized in this instance: searching for the instrument address, connecting to the instrument, sending commands, and reading return values. Run Microsoft Visual C++ 6.0. Create a MFC project based on a dialog box and name it as demoIDN in this instance.
Page 276 RIGOL Chapter 3 Programming Examples Select Library files from the drop-down list box under Show directories for. Double click the empty space under Directories to enter the specified path of Library files：C:\Program Files\IVI Foundation\VISA\WinNT\lib\msc. Click OK to close the dialog box.
Page 277 RIGOL Chapter 3 Programming Examples Add the variables m_combox and m_receive to the Com Box and Edit Box controls respectively. Add codes. Double-click Send and Read to enter the programming environment. Declare the #include <visa.h> of the VISA library in the header file and then add the following codes: ViSession defaultRM, vi;...
Page 278 RIGOL Chapter 3 Programming Examples stringTemp = (char *)(LPCTSTR)strTemp; viPrintf (vi,stringTemp); //Read the results viScanf (vi, "%t\n", &buf); //Display the results UpdateData (TRUE); m_receive = buf; UpdateData (FALSE); viClose (vi); viClose (defaultRM); Save, compile, and run the project to obtain a single exe file. When the oscilloscope is correctly connected to the PC, select a command and click Send and Read to execute the command.

This manual is also suitable for:

Ds4024e Ds4014e

Rigol DS4000E Series Programming Manual

Document Overview

Chapter 1 SCPI Command Overview

Chapter 2 Command System

Chapter 3 Programming Examples

Quick Links

Related Manuals for Rigol DS4000E Series

Summary of Contents for Rigol DS4000E Series