User manual

ManualsBrandsRIGOL ManualsLaboratory Test EquipmentDigital 200 MHz 2 null 14 null 8 Bit Digital storage (DSO)

RIGOL

Programming Guide

DS4000E Series Digital Oscilloscope

Aug. 2016

RIGOL TECHNOLOGIES, INC.

Summary of content (278 pages)

PAGE 1
RIGOL Programming Guide DS4000E Series Digital Oscilloscope Aug. 2016 RIGOL TECHNOLOGIES, INC.
PAGE 2
PAGE 3
RIGOL Guaranty and Declaration Copyright © 2016 RIGOL TECHNOLOGIES, INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL TECHNOLOGIES, INC. Publication Number PGA21101-1110 Software Version 00.02.03 Software upgrade might change or add product features. Please acquire the latest version of the manual from RIGOL website or contact RIGOL to upgrade the software. Notices       RIGOL products are covered by P.R.C. and foreign patents, issued and pending.
PAGE 4
RIGOL Document Overview This manual is your guide to programming RIGOL DS4000E series digital oscilloscope. Tip For the newest version of this manual, please download it from RIGOL official website (www.rigol.com). Main Topics in this Manual: Chapter 1 SCPI Command Overview This chapter introduces the syntax, symbols, parameters, and abbreviation rules of the SCPI commands. Chapter 2 Command System This chapter introduces the syntax, function, parameters, and usage of each command.
PAGE 5
Contents RIGOL Contents Guaranty and Declaration ......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 SCPI Command Overview ..................................................................................1-1 Syntax .............................................................................................
PAGE 6
RIGOL Contents :CHANnel:DISPlay ...................................................................................................... 2-62 :CHANnel:IMPedance ................................................................................................. 2-62 :CHANnel:INVert ........................................................................................................ 2-62 :CHANnel:OFFSet...............................................................................................
PAGE 7
Contents RIGOL :MASK:DATA .................................................................................................................. 2-109 :MASK:ENABle ............................................................................................................... 2-110 :MASK:FAILed? .............................................................................................................. 2-110 :MASK:MDISplay ......................................................................................
PAGE 8
RIGOL Contents :MEASure:VAMP ............................................................................................................. 2-155 :MEASure:VAVG.............................................................................................................. 2-156 :MEASure:VBASe ............................................................................................................ 2-158 :MEASure:VMAX ...........................................................................................
PAGE 9
Contents RIGOL :SYSTem:TIME ............................................................................................................... 2-187 :SYSTem:UDEVice .......................................................................................................... 2-188 :SYSTem:VERSion? ......................................................................................................... 2-188 :TIMebase Commands .......................................................................................
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 ..........................................................................
PAGE 11
Chapter 1 SCPI Command Overview RIGOL 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 Syntax The SCPI commands provide a hierarchical tree structure, and consist of multiple subsystems. Each command subsystem consists of one root keyword and one or more sub-keywords.
PAGE 12
RIGOL Chapter 1 SCPI Command Overview Parameter Type 1. Bool The available values for the parameter is 1 (ON) or 0 (OFF). For example, :MEASure:ADISplay :MEASure:ADISplay? Wherein, can be set to {{1|ON}|{0|OFF}}. The query returns 1 or 0. 2. Discrete The parameter can be any of the values listed. For example, :ACQuire:TYPE :ACQuire:TYPE? Wherein, can be set to NORMal, AVERages, PEAK, or HRESolution. The query returns NORM, AVER, PEAK, or HRES. 3.
PAGE 13
Chapter 2 Command System RIGOL 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  :ACQuire Commands  :BUS Commands  :CALCulate Commands  :CALibrate Commands  :CHANnel Commands  :CURSor Commands  :DISPlay Commands  :EXT Commands  :FUNCtion Commands  IEEE 488.
PAGE 14
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, the duty cycle is greater than 1%, and the amplitude is at least 20 mVpp. Otherwise, the waveform auto setting function may be invalid. :CLEar Syntax :CLEar Description Clears all the waveforms on the screen.
PAGE 15
Chapter 2 Command System RIGOL :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. :TLHAlf Syntax :TLHAlf Description Sets the trigger level to the vertical midpoint of the amplitude of a trigger signal.
PAGE 16
RIGOL Chapter 2 Command System :ACQuire Commands Command List[1]:  :ACQuire:AALias  :ACQuire:AVERages  :ACQuire:MDEPth  :ACQuire:SRATe?  :ACQuire:TYPE Note[1]: 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
RIGOL Chapter 2 Command System :ACQuire:MDEPth Syntax :ACQuire:MDEPth :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. PEAK: The oscilloscope samples the maximum and minimum value of the signal at the fixed sampling interval to acquire the signal envelope or the narrow pulses that might be lost. This mode can avoid the signal aliasing, but produces greater noises.
PAGE 19
RIGOL Chapter 2 Command System :BUS Commands Command List:  :BUS:DATA?  :BUS:DISPlay  :BUS:EEXPort  :BUS:EVENt  :BUS:FORMat  :BUS:MODE  :BUS:CAN (Option)  :BUS:FLEXray (Option)  :BUS:IIC (Option)  :BUS:PARallel  :BUS:RS232 (Option)  :BUS:SPI (Option) :BUS:DATA? Syntax :BUS:DATA? Description Reads the data in the decoding event table.
PAGE 20
RIGOL Chapter 2 Command System :BUS:DISPlay Syntax :BUS:DISPlay :BUS: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 Discrete {1|2} -- Bool {{1|ON}|{0|OFF}} 0|OFF Return Format The query returns 1 or 0.
PAGE 21
RIGOL Chapter 2 Command System :BUS:FORMat Syntax :BUS:FORMat :BUS:FORMat? Description Sets or queries the display format of decoding data of the specified decoding bus. Parameter Name Type Range Default Discrete {1|2} -- Discrete {HEX|DEC|BIN|ASCii} HEX Return Format The query returns HEX, DEC, BIN, or ASC. :BUS:MODE Syntax :BUS:MODE :BUS:MODE? Description Sets or queries the decoding type of the specified decoding bus.
PAGE 22
RIGOL Chapter 2 Command System :BUS:CAN (Option) Command List:  :BUS:CAN:BAUD  :BUS:CAN:BUSer  :BUS:CAN:OFFSet  :BUS:CAN:SOURce  :BUS:CAN:SPOint  :BUS:CAN:STYPe  :BUS:CAN:THReshold :BUS:CAN:BAUD Syntax :BUS:CAN:BAUD :BUS: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:CAN:OFFSet Syntax :BUS:CAN:OFFSet :BUS:CAN:OFFSet? Description Sets or queries the vertical position of CAN decoding data line on the specified bus. Parameter Name Type Range Default Discrete {1|2} -- Integer Refer to Remarks 0 Remarks  Before using the command, enable the display of the specified decoding bus (refer to the :BUS:DISPlay command).
PAGE 24
RIGOL Chapter 2 Command System :BUS:CAN:SPOint Syntax :BUS:CAN:SPOint :BUS:CAN:SPOint? Description Sets or queries the sample point position of CAN decoding on the specified bus (expressed in %). Parameter Name Type Range Default Discrete {1|2} -- Integer 5 to 95 50 Remarks The sample point is within the range of the bit time. The oscilloscope samples the bit level at the sample point.
PAGE 25
RIGOL Chapter 2 Command System :BUS:CAN:THReshold Syntax :BUS:CAN:THReshold :BUS:CAN:THReshold? Description Sets or queries the threshold of the current source channel of CAN decoding on the specified bus.
PAGE 26
RIGOL Chapter 2 Command System :BUS:FLEXray (Option) Command List:  :BUS:FLEXray:BAUD  :BUS:FLEXray:OFFSet  :BUS:FLEXray:SOURce  :BUS:FLEXray:SPoint  :BUS:FLEXray:STYPe  :BUS:FLEXray:THReshold :BUS:FLEXray:BAUD Syntax :BUS:FLEXray:BAUD :BUS: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, is a negative value. Return Format The query returns an integer. :BUS:FLEXray:SOURce Syntax :BUS:FLEXray:SOURce :BUS:FLEXray:SOURce? Description Sets or queries the source channel of FlexRay decoding on the specified bus. Parameter Name Type Discrete Discrete Range {1|2} {CHANnel1|CHANnel2|CHANnel3|CHANnel4} Default -CHANnel1 Return Format The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
PAGE 28
RIGOL Chapter 2 Command System Parameter Name Type Discrete Discrete Return Format The query returns BP, BM, or Range {1|2} {BP|BM|RT} Default -BP RT. :BUS:FLEXray:THReshold Syntax :BUS:FLEXray:THReshold :BUS:FLEXray:THReshold? Description Sets or queries the threshold of the current source channel of FlexRay decoding on the specified bus.
PAGE 29
RIGOL Chapter 2 Command System :BUS:IIC (Option) Command List:  :BUS:IIC:OFFSet  :BUS:IIC:SCLK:SOURce  :BUS:IIC:SCLK:THReshold  :BUS:IIC:SDA:SOURce  :BUS:IIC:SDA:THReshold :BUS:IIC:OFFSet Syntax :BUS:IIC:OFFSet :BUS:IIC:OFFSet? Description Sets or queries the vertical position of IIC decoding on the specified bus.
PAGE 30
RIGOL Parameter Name Chapter 2 Command System Type Discrete Discrete Range {1|2} {CHANnel1|CHANnel2|CHANnel3|CHANnel4} Default -CHANnel1 Return Format The query returns CHAN1, CHAN2, CHAN3, or CHAN4. :BUS:IIC:SCLK:THReshold Syntax :BUS:IIC:SCLK:THReshold :BUS:IIC:SCLK:THReshold? Description Sets or queries the threshold of the current clock line source channel of IIC decoding on the specified bus. The default unit is V.
PAGE 31
RIGOL Chapter 2 Command System :BUS:IIC:SDA:THReshold Syntax :BUS:IIC:SDA:THReshold :BUS:IIC:SDA:THReshold? Description Sets or queries the threshold of the current data line source channel of IIC decoding on the specified bus.
PAGE 32
RIGOL Chapter 2 Command System :BUS:PARallel Command List:  :BUS:PARallel:BSET  :BUS:PARallel:CLK  :BUS:PARallel:OFFSet  :BUS:PARallel:SLOPe  :BUS:PARallel:THReshold :BUS:PARallel:BSET Syntax :BUS:PARallel:BSET [,[,[,]]] :BUS: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: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 is set to "OFF" (disabling the clock channel), sampling is performed when a hop occurs to the data of the data channel during decoding. Return Format The query returns CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
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.  If the clock channel is currently not set (refer to the :BUS:PARallel:CLK command), you do not need to use the command to set the edge type.
PAGE 35
RIGOL Chapter 2 Command System :BUS:RS232 (Option) Command List:  :BUS:RS232:BAUD  :BUS:RS232:BUSer  :BUS:RS232:DBITs  :BUS:RS232:ENDian  :BUS:RS232:OFFSet  :BUS:RS232:PACKet  :BUS:RS232:PARity  :BUS:RS232:PEND  :BUS:RS232:POLarity  :BUS:RS232:RTHReshold  :BUS:RS232:RX  :BUS:RS232:SBITs  :BUS:RS232:TTHReshold  :BUS:RS232:TX :BUS:RS232:BAUD Syntax :BUS:RS232:BAUD :BUS:RS232:BAUD? Description Sets or queries the baud rate of data of
PAGE 36
RIGOL Chapter 2 Command System Return Format The query returns an integer. :BUS:RS232:DBITs Syntax :BUS:RS232:DBITs :BUS: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. Parameter Name Type Discrete Discrete Range {1|2} {5|6|7|8|9} Default -8 Return Format The query returns 5, 6, 7, 8, or 9.
PAGE 37
RIGOL Chapter 2 Command System Parameter Name Type Range Default Discrete {1|2} -- Integer Refer to Remarks 0 Remarks  Before using the command, enable the display of the specified decoding bus (refer to the :BUS:DISPlay command).  The range of is related to the screen display mode and the on/off status of the statistic function (refer to the :MEASure:STATistic:DISPlay command).
PAGE 38
RIGOL Parameter Name Chapter 2 Command System Type Discrete Discrete Range {1|2} {NONE|ODD|EVEN} Default -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 odd number. For example, if 0x55 (01010101) is transmitted, 1 shall be added to the check bit.  Even: indicates the even parity bit.
PAGE 39
RIGOL Chapter 2 Command System Parameter Name Type Discrete Discrete Range {1|2} {POSitive|NEGative} Default -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". Return Format The query returns POS or NEG.
PAGE 40
RIGOL Chapter 2 Command System :BUS:RS232:SBITs Syntax :BUS:RS232:SBITs :BUS: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 Discrete Discrete Range {1|2} {1|1.5|2} Default -1 Return Format The query returns 1, 1.5, or 2.
PAGE 41
Chapter 2 Command System RIGOL Remarks  When is set to "OFF", it indicates that TX source channel is not set.  TX source channel and RX source channel (refer to the :BUS:RS232:RX command) cannot be both set to "OFF". Return Format The query returns CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
PAGE 42
RIGOL Chapter 2 Command System :BUS:SPI (Option) Command List:  :BUS:SPI:DBITs  :BUS:SPI:ENDian  :BUS:SPI:MISO:POLarity  :BUS:SPI:MISO:SOURce  :BUS:SPI:MISO:THReshold  :BUS:SPI:MODE  :BUS:SPI:MOSI:POLarity  :BUS:SPI:MOSI:SOURce  :BUS:SPI:MOSI:THReshold  :BUS:SPI:OFFSet  :BUS:SPI:SCLK:SLOPe  :BUS:SPI:SCLK:SOURce  :BUS:SPI:SCLK:THReshold  :BUS:SPI:SS:POLarity  :BUS:SPI:SS:SOURce  :BUS:SPI:SS:THReshold  :BUS:SPI:TIMeout:TIME :BUS:SPI:
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. :BUS:SPI:MISO:POLarity Syntax :BUS:SPI:MISO:POLarity :BUS:SPI:MISO:POLarity? Description Sets or queries the polarity of MISO data line of SPI decoding on the specified bus.
PAGE 44
RIGOL Chapter 2 Command System Return Format The query returns CHAN1, CHAN2, CHAN3, CHAN4, or OFF. :BUS:SPI:MISO:THReshold Syntax :BUS:SPI:MISO:THReshold :BUS:SPI:MISO:THReshold? Description Sets or queries the threshold of the source channel of MISO data line of SPI decoding on the specified bus. The default unit is V.
PAGE 45
RIGOL Chapter 2 Command System :BUS:SPI:MOSI:POLarity Syntax :BUS:SPI:MOSI:POLarity :BUS:SPI:MOSI:POLarity? Description Sets or queries the polarity of MOSI data line of SPI decoding on the specified bus.
PAGE 46
RIGOL Chapter 2 Command System :BUS:SPI:MOSI:THReshold Syntax :BUS:SPI:MOSI:THReshold :BUS:SPI:MOSI:THReshold? Description Sets or queries the threshold of the source channel of MOSI data line of SPI decoding on the specified bus.
PAGE 47
RIGOL Chapter 2 Command System :BUS:SPI:SCLK:SLOPe Syntax :BUS:SPI:SCLK:SLOPe :BUS: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. Parameter Name Type Discrete Discrete Range {1|2} {POSitive|NEGative} Default -POSitive Remarks POSitive: indicates the rising edge. NEGative: indicates the falling edge.
PAGE 48
RIGOL Parameter Name Chapter 2 Command System Type Discrete Real Range {1|2} (-4 x VerticalScale - Offset) to (4 x VerticalScale - Offset) Wherein, VerticalScale is the vertical scale of the source channel, refer to the :CHANnel:SCALe command; Offset is the vertical position of the source channel, refer to the :CHANnel:OFFSet command. Default -0 Return Format The query returns the threshold level in scientific notation.
PAGE 49
RIGOL Chapter 2 Command System :BUS:SPI:SS:THReshold Syntax :BUS:SPI:SS:THReshold :BUS:SPI:SS:THReshold? Description Sets or queries the threshold of the source channel of the CS line of SPI decoding on the specified bus.
PAGE 50
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 :CALCulate:MODE? Description Sets or queries the type of math operation.
PAGE 51
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 :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 :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.
PAGE 53
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 :CALCulate:ADVanced:EXPRession? Description Sets or queries the expression of advanced operation.
PAGE 54
RIGOL Parameter Name Chapter 2 Command System Type Range Default 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. Return Format The query returns 1 or 0.
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 :CALCulate:ADVanced:VSCale? Description Sets or queries the vertical scale of the advanced operation waveform. The unit is related to the expression of advanced operation.
PAGE 56
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.
PAGE 57
RIGOL Chapter 2 Command System :CALCulate:DIVision:VOFFset Syntax :CALCulate:DIVision:VOFFset :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.
PAGE 58
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
: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. Return Format The query returns the horizontal position in scientific notation. :CALCulate:FFT:HSCaLe Syntax :CALCulate:FFT:HSCale :CALCulate:FFT:HSCale? Description Sets or queries the horizontal coefficient of FFT operation.
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 the :CALCulate:FFT:HSCaLe command). Return Format The query returns the horizontal scale in scientific notation.
PAGE 61
RIGOL Chapter 2 Command System :CALCulate:FFT:VOFFset Syntax :CALCulate:FFT:VOFFset :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 Parameter Name Chapter 2 Command System Type Discrete Range {VRMS|DB} Default 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. :CALCulate:FFT:WINDow Syntax :CALCulate:FFT:WINDow :CALCulate:FFT:WINDow? Description Sets or queries the window function of FFT operation.
PAGE 63
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 :CALCulate:LOGic:ATHReshold? :CALCulate:LOGic:BTHReshold :CALCulate:LOGic:BTHReshold? Description Sets or queries the threshold of
PAGE 64
RIGOL Chapter 2 Command System Return Format The query returns 1 or 0. :CALCulate:LOGic:OPERator Syntax :CALCulate:LOGic:OPERator :CALCulate:LOGic:OPERator? Description Sets or queries the logic operation formula. Parameter Name Type Discrete Range {AND|OR|NOT|XOR} Default AND Return Format The query returns AND, OR, NOT, or XOR.
PAGE 65
RIGOL Chapter 2 Command System :CALCulate:LOGic:VOFFset Syntax :CALCulate:LOGic:VOFFset :CALCulate:LOGic:VOFFset? Description Sets or queries the vertical position of the logic operation waveform. The default unit is U. Parameter Name Type Real Range (-40 x vertical scale of the logic operation waveform) to (40 x vertical scale of the logic operation waveform) Default 0 Return Format The query returns the vertical position in scientific notation.
PAGE 66
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 :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 :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.
PAGE 68
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 :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 :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.
PAGE 70
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 ,,. Wherein, , , and represent year, month, and day respectively. :CALibrate:QUIT Syntax :CALibrate:QUIT Description Stops performing the self-calibration operation.
PAGE 71
Chapter 2 Command System RIGOL :CALibrate:TIME? Syntax :CALibrate:TIME? Description Queries the time when the last self-calibration was performed. Return Format The query returns ,,. Wherein, , , and represent hour, minute, and second respectively.
PAGE 72
RIGOL Chapter 2 Command System :CHANnel Commands Command List:  :CHANnel:BVOLtage  :CHANnel:BWLimit  :CHANnel:COUPling  :CHANnel:CSTart  :CHANnel:DISPlay  :CHANnel:IMPedance  :CHANnel:INVert  :CHANnel:OFFSet  :CHANnel:PEND  :CHANnel:PROBe  :CHANnel:SCALe  :CHANnel:TCALibrate  :CHANnel:TYPE?  :CHANnel:UNITs  :CHANnel:VERNier :CHANnel:BVOLtage Syntax :CHANnel:BVOLtage :CHANnel:BVOLtage? Description Sets or queries the bias voltag
PAGE 73
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.  OFF: disables the bandwidth limit function. The high-frequency components in the signal under test can pass through the channel. Return Format The query returns 20M, 100M, or OFF.
PAGE 74
RIGOL Chapter 2 Command System :CHANnel:DISPlay Syntax :CHANnel:DISPlay :CHANnel:DISPlay? Description Turns on or off the specified analog channel; or queries the on/off status of the specified analog channel. Parameter Name Type Discrete Range {1|2|3|4} Bool {{1|ON}|{0|OFF}} Default -CH1: 1|ON CH2, CH3, CH4: 0|OFF Return Format The query returns 1 or 0.
PAGE 75
RIGOL Chapter 2 Command System Parameter Name Type Range Default Discrete {1|2|3|4} -- 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. Return Format The query returns 1 or 0.
PAGE 76
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:PROBe Syntax :CHANnel:PROBe :CHANnel:PROBe? Description Sets or queries the probe ratio of the probe currently connected to the specified analog channel. Parameter Name Type Discrete Discrete Range {1|2|3|4} {0.01|0.02|0.05|0.1|0.2|0.
PAGE 77
RIGOL Chapter 2 Command System :CHANnel:TCALibrate Syntax :CHANnel:TCALibrate :CHANnel: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.
PAGE 78
RIGOL Chapter 2 Command System :CHANnel:VERNier Syntax :CHANnel:VERNier :CHANnel: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. Parameter Name Type Discrete Bool Range {1|2|3|4} {{1|ON}|{0|OFF}} Default -0|OFF Remarks SCALE to further adjust the  1|ON: enables the fine adjustment function.
PAGE 79
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). Cursor A (X Cursor) Cursor B (X Cursor) Cursor A (Y Cursor) Cursor B (Y Cursor)   X Cursor X cursor is a vertical solid/dotted line that is used to make horizontal adjustments.
PAGE 80
RIGOL Chapter 2 Command System :CURSor:MODE Syntax :CURSor:MODE :CURSor:MODE? Description Sets or queries the mode of the cursor measurement. Parameter Name Type Discrete Range {OFF|MANual|TRACk|AUTO} Default OFF Remarks  OFF: disables the cursor measurement function.  MANual: enables the manual mode of cursor measurement.  TRACk: enables the track mode of cursor measurement.  AUTO: enables the auto mode of cursor measurement. Return Format The query returns OFF, MAN, TRAC, or AUTO.
PAGE 81
Chapter 2 Command System RIGOL :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 :CURSor:MANual:AXValue? Description Queries the X value at Cur
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. Return Format The query returns the X value in scientific notation.
PAGE 83
RIGOL Chapter 2 Command System :CURSor:MANual:CAY Syntax :CURSor:MANual:CAY :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 Integer Range 0 to 399 Default 100 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 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). Return Format The query returns an integer between 0 and 399. :CURSor:MANual:IXDelta? Syntax :CURSor:MANual:IXDelta? Description Queries the reciprocal (1/△X) of the difference between X values at Cursor A (X cursor) and Cursor B (X cursor) in the manual mode of cursor measurement.
PAGE 85
RIGOL Chapter 2 Command System Parameter Name Type Discrete Range {SECond|HZ|DEGRee|PERCent} Default 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 Parameter Name Chapter 2 Command System Type Discrete Range {SUNit|PERCent} Default 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
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 :CURSor:TRACk:AXValue? Description Queries the X value at Cursor A (X cur
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. Return Format The query returns X or Y. :CURSor:TRACk:AYValue? Syntax :CURSor:TRACk:AYValue? Description Queries the Y value at Cursor A (Y cursor) in the track mode of cursor measurement.
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).  For the vertical position of Cursor B (Y cursor), refer to the :CURSor:TRACk:CBY command. Return Format The query returns the Y value in scientific notation. When the Y value at Cursor B (Y cursor) exceeds the screen range, the query returns 9.
PAGE 90
RIGOL Chapter 2 Command System :CURSor:TRACk:CBX Syntax :CURSor:TRACk:CBX :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 Integer Range 0 to 699 Default 550 Remarks  The horizontal position of the cursor is defined by the pixel coordinate of the screen. The range of the pixel coordinate on the screen horizontally is from 0 to 699 (from left to right).
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 :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 Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH|NONE} Default CHANnel1 Remarks  Only the currently enabled channel can be selected as the source channel.  When is set to "NONE", it indicates that Cursor B (X cursor) will not be used.
PAGE 93
Chapter 2 Command System RIGOL :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. This command functions the same as the CLEAR key on the front panel.
PAGE 94
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. TMC Data Block Header BMP Data Size [1] N +2 800x480x3+54=1152054[2] (Length) Format #NX…X BM... It is used to describe the length of the data stream (the number of bytes).
PAGE 95
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 without clearing the waveform formerly acquired) to measure noise and jitter as well as capture incidental events. Return Format The query returns MIN, 0.05, 0.1, 0.2, 0.
PAGE 96
RIGOL Chapter 2 Command System :DISPlay:TYPE Syntax :DISPlay:TYPE :DISPlay:TYPE? Description Sets or queries the display type of the waveform. Parameter Name Type Discrete Range {VECTors|DOTS} Default VECTors Remarks  VECTors: The sample points are connected by lines and displayed. Normally, this mode can provide the most vivid waveform to view the steep edge of the waveform (such as square waveforms).  DOTS: displays the sample points directly.
PAGE 97
RIGOL Chapter 2 Command System :EXT Commands Command List:  :EXT:PEND  :EXT:CSTart :EXT:PEND Syntax :EXT:PEND :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). Parameter Name Type Discrete Range {SEND|DIFFerential} Default SEND Remarks  SEND: indicates a single-ended probe head.  DIFFerential: indicates a differential probe head.
PAGE 98
RIGOL Chapter 2 Command System :FUNCtion Commands Command List:  :FUNCtion:WRMode  :FUNCtion:WRECord  :FUNCtion:WREPlay  :FUNCtion:WANalyze :FUNCtion:WRMode Syntax :FUNCtion:WRMode :FUNCtion:WRMode? Description Sets or queries the waveform recording mode. Parameter Name Type Discrete Range {OFF|RECord|PLAY|KEEP|ANALyze} Default OFF Remarks  RECord: indicates the recording mode. PLAY: indicates the playback mode. KEEP: indicates the "constant-on" mode.
PAGE 99
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 :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 :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 Real Range 100 ns to 10 s Default 100 ns Return Format The query returns the interval in scientific notation.
PAGE 101
Chapter 2 Command System RIGOL :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 :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 :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 :FUNCtion:WREPlay:MODE? Description Sets or queries the waveform playback mode. Parameter Name Type Discrete Range {REPeat|SINGle} Default SINGle Remarks  REPeat: indicates the circular playback. The waveform is played from the start frame to the end frame, then such playback operation is repeated until you stop it manually.  SINGle: indicates the single playback.
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
Chapter 2 Command System RIGOL :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:WANaly
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.  When the waveform analysis mode is "Pass/Fail" (refer to the :FUNCtion:WANalyze:MODE command), the "Current Frame Difference" is 100% (the frame is correct) or 0% (the frame is wrong).
PAGE 107
RIGOL Chapter 2 Command System Parameter Name Type Integer Range 1 to the number of frames that have been recorded Default 1 Return Format The query returns an integer. :FUNCtion:WANalyze:MODE Syntax :FUNCtion:WANalyze:MODE :FUNCtion:WANalyze:MODE? Description Sets or queries the waveform analysis mode. Parameter Name Type Discrete Range {TRACe|MASK} Default TRACe Remarks  TRACe: indicates the trace mode. The waveform is analyzed according to the user-defined template.
PAGE 108
RIGOL Parameter Name Chapter 2 Command System Type Range Integer 1 to the number of frames that have been recorded Default Number of frames that 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. Return Format The query returns an integer.
PAGE 109
RIGOL Chapter 2 Command System :FUNCtion:WANalyze:SETup:SSTart Syntax :FUNCtion:WANalyze:SETup:SSTart :FUNCtion:WANalyze:SETup:SSTart? Description Sets or queries the screen start point (in pixel) in waveform analysis. Parameter Name Type Integer Range 5 to 685 Default 5 Remarks  The range of the pixel coordinate on the screen horizontally is from 0 to 699 (from left to right).  The actual range of the screen start point is from 5 to "currently set screen end point - 10".
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 :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". The default unit is div (in the vertical direction). Parameter Name Type Real Range 0.03125 to 4 (with a step of 0.03125) Default 0.
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 Error" and "CurFrame Diff") are displayed on the screen, and the current frame is located on the first error frame.
PAGE 112
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. Command List:  *CLS  *ESE  *ESR?  *IDN?  *OPC  *OPC?  *RST  *SRE  *STB?  *TST? *CLS Syntax *CLS Description Clears the event registers in all the register sets and clears the error queue.
PAGE 113
Chapter 2 Command System RIGOL Return Format The query returns an integer (corresponds to the binary-weighted sum of all the bits) between 0 and 255. *ESR? Syntax *ESR? Description Queries the event status register of the standard event register set. Remarks  For the definitions of the bits in the standard event register, refer to the *ESE command.  Querying the event status register will clear this register.
PAGE 114
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 *SRE? Description Sets or queries the enable register of the status byte register set. Parameter Name Type Integer Range 0 to 255 Default 0 Remarks is the binary-weighted sum of all the bits from bit 0 to bit 7.
PAGE 115
Chapter 2 Command System RIGOL 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; "1" denotes that the self-test of the corresponding items fails. The self-test item corresponding to each bit is as shown below.
PAGE 116
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
RIGOL Chapter 2 Command System :LAN:DHCP Syntax :LAN:DHCP :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 Bool Range {{1|ON}|{0|OFF}} Default 1|ON Remarks  The high-to-low priority of the three IP configuration modes is "DHCP", "Auto IP" and "Static IP". The three IP configuration modes cannot be all turned off at the same time.
PAGE 118
RIGOL Chapter 2 Command System :LAN:GATeway Syntax :LAN:GATeway :LAN:GATeway? Description Sets or queries the gateway address. Parameter Name Type ASCII String Range Refer to Remarks Default -- Remarks  The format of 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 119
RIGOL Chapter 2 Command System Remarks  The format of 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.  When the DHCP configuration mode is valid (refer to the :LAN:DHCP command), the DHCP server in the current network will assign the IP address to the oscilloscope. You can use this command to query the current IP address.
PAGE 120
RIGOL Chapter 2 Command System :LAN:SMASk Syntax :LAN:SMASk :LAN:SMASk? Description Sets or queries the subnet mask. Parameter Name Type ASCII String Range Refer to Remarks Default -- Remarks  The format of is nnn,nnn,nnn,nnn. The range of the section "nnn" is from 0 to 255.  When the DHCP configuration mode is valid (refer to the :LAN:DHCP command), the DHCP server in the current network will assign the subnet mask to the oscilloscope.
PAGE 121
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. Remarks  This command is invalid after the pass/fail test operation starts (refer to the :MASK:OPERate command).
PAGE 122
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. :MASK:ENABle Syntax :MASK:ENABle :MASK:ENABle? Description Enables or disables the pass/fail function; or queries the on/off status of the pass/fail function.
PAGE 123
RIGOL Chapter 2 Command System Parameter Name Type Bool Range {{1|ON}|{0|OFF}} Default 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). Return Format The query returns 1 or 0. :MASK:OPERate Syntax :MASK:OPERate :MASK:OPERate? Description Runs or stops the pass/fail test operation.
PAGE 124
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.
PAGE 125
RIGOL Chapter 2 Command System :MASK:SOURce Syntax :MASK:SOURce :MASK:SOURce? Description Sets or queries the source channel of the pass/fail test. Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4} Default CHANnel1 Remarks Only the currently enabled channel (refer to the :CHANnel:DISPlay command) can be selected as the source channel. Return Format The query returns CHAN1, CHAN2, CHAN3, or CHAN4.
PAGE 126
RIGOL Chapter 2 Command System :MASK:Y Syntax :MASK: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 Real Range 0.03125 to 4 (with a step of 0.03125) Default 0.375 Remarks For the vertical tolerance range, the oscilloscope only displays the number to two decimal places (round-up). For example, when the vertical tolerance range is 0.0625 div, 0.
PAGE 127
Chapter 2 Command System RIGOL :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  :MEASure:MARea  :MEASure:MPARea  :MEASure:NDUTy  :MEASure:NWIDth  :MEASure:OVERshoot  :MEASure:PDUTy 
PAGE 128
RIGOL Chapter 2 Command System :MEASure:ADISplay Syntax :MEASure:ADISplay :MEASure:ADISplay? Description Enables or disables the all measurement function; or queries the on/off status of the all measurement function. Parameter Name Type Bool Range {{1|ON}|{0|OFF}} Default 0|OFF Remarks  The all measurement function can measure all the time, voltage, and area parameters of the specified channel(s) and display the measurement results on the screen.
PAGE 129
RIGOL Chapter 2 Command System Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Default 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
RIGOL Chapter 2 Command System :MEASure:COUNter:SOURce Syntax :MEASure:COUNter:SOURce :MEASure:COUNter:SOURce? Description Sets or queries the measurement source of the frequency counter. Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4|EXT|OFF} Default OFF Remarks When is "OFF", it indicates that the frequency counter function will be disabled. Return Format The query returns CHAN1, CHAN2, CHAN3, CHAN4, EXT, or OFF.
PAGE 131
RIGOL Chapter 2 Command System :MEASure:CREGion:CBX Syntax :MEASure:CREGion:CBX :MEASure:CREGion:CBX? Description Sets or queries the position of Cursor B when the measurement range is the "cursor area". Parameter Name Type Integer Range 6 to 697 Default 400 Remarks  The position of the cursor is defined by the pixel coordinate of the screen. The range of the pixel coordinate on the screen horizontally is from 0 to 699 (from left to right).
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 [,] :MEASure:FDELay:SCURrent [,] :MEASure:FDELay:SDEViation [,] :MEASure:FDELay:SMAXimum [,] :MEASure:FDELay:SMINimum [,] Description 1 Measures the delay (falling edge-falling edge) between the two specified source channels, and enables the statis
PAGE 133
RIGOL Chapter 2 Command System :MEASure:F2RDelay Syntax 1 :MEASure:F2RDelay [,] Description 1 Measures the delay (falling edge-rising edge) between the two specified source channels. Syntax 2 :MEASure:F2RDelay? [,] Description 2 Measures the delay (falling edge-rising edge) between the two specified source channels. The default unit is s.
PAGE 134
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. The default unit is s.
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 [,] :MEASure:FPHase:SCURrent [,] :MEASure:FPHase:SDEViation [,] :MEASure:FPHase:SMAXimum [,] :MEASure:FPHase:SMINimum [,] Description 1 Measures the phase deviation (falling edge-falling edge) between the two specified source channels, and enables
PAGE 136
RIGOL Chapter 2 Command System :MEASure:F2RPhase Syntax 1 :MEASure:F2RPhase [,] Description 1 Measures the phase deviation (falling edge-rising edge) between the two specified source channels. Syntax 2 :MEASure:F2RPhase? [,] Description 2 Measures the phase deviation (falling edge-rising edge) between the two specified source channels. The default unit is °.
PAGE 137
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. The default unit is °.
PAGE 138
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 [] :MEASure:FREQuency:SCURrent [] :MEASure:FREQuency:SDEViation [] :MEASure:FREQuency:SMAXimum [] :MEASure:FREQuency:SMINimum [] 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 Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Default -- Remarks  Before making measurements, turn on the channels to be measured.  When the math operation type is FFT (refer to the :CALCulate:MODE command), cannot be set to "MATH".
PAGE 140
RIGOL  Chapter 2 Command System When [] 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. When the measurement results are invalid, the query returns 9.9e37.
PAGE 141
RIGOL Chapter 2 Command System :MEASure:MARea Syntax 1 :MEASure:MARea [] Description 1 Measures the area of the specified source channel. Syntax 2 :MEASure:MARea? [] Description 2 Measures and queries the area of the specified source channel. The default unit is volt-second. Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Default -- Remarks  Area: The horizontal axis denotes time and the vertical axis denotes waveform amplitude.
PAGE 142
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 [] :MEASure:MPARea:SCURrent [] :MEASure:MPARea:SDEViation [] :MEASure:MPARea:SMAXimum [] :MEASure:MPARea:SMINimum [] Description 1 Measures the period area of the specified source channel and enables the statistic function of the measurement results.
PAGE 144
RIGOL Chapter 2 Command System :MEASure:NDUTy Syntax 1 :MEASure:NDUTy [] Description 1 Measures the negative duty cycle of the specified source channel. Syntax 2 :MEASure:NDUTy? [] Description 2 Measures and queries the negative duty cycle of the specified source channel. Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Default -- Remarks  Before making measurements, turn on the channels to be measured.
PAGE 145
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. Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Default -- Remarks  Before making measurements, turn on the channels to be measured.
PAGE 146
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 [] :MEASure:NWIDth:SCURrent [] :MEASure:NWIDth:SDEViation [] :MEASure:NWIDth:SMAXimum [] :MEASure:NWIDth:SMINimum [] 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 Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Default -- Remarks  Before making measurements, turn on the channels to be measured.  When the math operation type is FFT (refer to the :CALCulate:MODE command), cannot be set to "MATH".
PAGE 148
RIGOL  Chapter 2 Command System When [] 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. When the measurement results are invalid, the query returns 9.9e37.
PAGE 149
RIGOL Chapter 2 Command System Syntax 2 :MEASure:PDUTy:SAVerage? [] :MEASure:PDUTy:SCURrent? [] :MEASure:PDUTy:SDEViation? [] :MEASure:PDUTy:SMAXimum? [] :MEASure:PDUTy:SMINimum? [] 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 ena
PAGE 150
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 [] :MEASure:PERiod:SCURrent [] :MEASure:PERiod:SDEViation [] :MEASure:PERiod:SMAXimum [] :MEASure:PERiod:SMINimum [] 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 Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Default -- Remarks  Before making measurements, turn on the channels to be measured.  When the math operation type is FFT (refer to the :CALCulate:MODE command), cannot be set to "MATH".
PAGE 152
RIGOL   Chapter 2 Command System When the math operation type is FFT (refer to the :CALCulate:MODE command), cannot be set to "MATH". When [] 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. When the measurement results are invalid, the query returns 9.9e37.
PAGE 153
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.
PAGE 154
RIGOL   Chapter 2 Command System When the math operation type is FFT (refer to the :CALCulate:MODE command), cannot be set to "MATH". When [] 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 measurement results in scientific notation. When the measurement results are invalid, the query returns 9.9e37.
PAGE 155
RIGOL Chapter 2 Command System :MEASure:RECover Syntax :MEASure:RECover Description Recovers the measurement items that have been cleared. Parameter Name Type Discrete Range {ITEM1|ITEM2|ITEM3|ITEM4|ITEM5|ALL} Default -- 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 [,] :MEASure:RDELay:SCURrent [,] :MEASure:RDELay:SDEViation [,] :MEASure:RDELay:SMAXimum [,] :MEASure:RDELay:SMINimum [,] Description 1 Measures the delay (rising edge-rising edge) between the two specified source channels, and enables the statisti
PAGE 157
RIGOL Chapter 2 Command System :MEASure:R2FDelay Syntax 1 :MEASure:R2FDelay [,] Description 1 Measures the delay (rising edge-falling edge) between the two specified source channels. Syntax 2 :MEASure:R2FDelay? [,] Description 2 Measures and queries the delay (rising edge-falling edge) between the two specified source channels. The default unit is s.
PAGE 158
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. The default unit is s.
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 [,] :MEASure:RPHase:SCURrent [,] :MEASure:RPHase:SDEViation [,] :MEASure:RPHase:SMAXimum [,] :MEASure:RPHase:SMINimum [,] Description 1 Measures the phase deviation (rising edge-rising edge) between the two specified source channels and enables the
PAGE 160
RIGOL Chapter 2 Command System :MEASure:R2FPhase Syntax 1 :MEASure:R2FPhase [,] Description 1 Measures the phase deviation (rising edge-falling edge) between the two specified source channels. Syntax 2 :MEASure:R2FPhase? [,] Description 2 Measures and queries the phase deviation (rising edge-falling edge) between the two specified source channels. The default unit is °.
PAGE 161
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. The default unit is °.
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 [] :MEASure:RTIMe:SCURrent [] :MEASure:RTIMe:SDEViation [] :MEASure:RTIMe:SMAXimum [] :MEASure:RTIMe:SMINimum [] Description 1 Measures the rise time of the specified source channel and enables the statistic function of the measurement results.
PAGE 163
RIGOL Chapter 2 Command System :MEASure:SETup:DSA :MEASure:SETup:DSB Syntax :MEASure:SETup:DSA :MEASure:SETup:DSA? :MEASure:SETup:DSB :MEASure:SETup:DSB? Description Sets or queries the channel source of Source A or Source B in delay measurement.
PAGE 164
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.  The value must be at least 1 greater than the value.
PAGE 165
RIGOL Chapter 2 Command System :MEASure:SETup:TYPE Syntax :MEASure:SETup:TYPE :MEASure:SETup:TYPE? Description Sets or queries the type of the measurement setting. Parameter Name Type Discrete Range {DELay|PHASe|THReshold} Default DELay Return Format The query returns DEL, PHAS, or THR.
PAGE 166
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 the bottom of the screen. Return Format The query returns EXTR or DIFF. :MEASure:STATistic:RESet Syntax :MEASure:STATistic:RESet Description Clears the history statistic data, makes statistics again, and displays the results.
PAGE 167
RIGOL Chapter 2 Command System :MEASure:VAMP Syntax 1 :MEASure:VAMP [] Description 1 Measures the amplitude of the specified source channel. Syntax 2 :MEASure:VAMP? [] 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
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 [] :MEASure:VAVG:SCURrent [] :MEASure:VAVG:SDEViation [] :MEASure:VAVG:SMAXimum [] :MEASure:VAVG:SMINimum [] Description 1 Measures the amplitude average value of the specified source channel and enables the statistic function of the measurement results.
PAGE 170
RIGOL Chapter 2 Command System :MEASure:VBASe Syntax 1 :MEASure:VBASe [] Description 1 Measures the amplitude base value of the specified source channel. Syntax 2 :MEASure:VBASe? [] 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
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 [] :MEASure:VMAX:SCURrent [] :MEASure:VMAX:SDEViation [] :MEASure:VMAX:SMAXimum [] :MEASure:VMAX:SMINimum [] Description 1 Measures the maximum amplitude value of the specified source channel and enables the statistic function of the measurement results.
PAGE 173
RIGOL Chapter 2 Command System :MEASure:VMIN Syntax 1 :MEASure:VMIN [] Description 1 Measures the minimum amplitude value of the specified source channel. Syntax 2 :MEASure:VMIN? [] 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
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. The unit is related to the current amplitude unit of the specified source channel.
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 [] :MEASure:VPP:SCURrent [] :MEASure:VPP:SDEViation [] :MEASure:VPP:SMAXimum [] :MEASure:VPP:SMINimum [] Description 1 Measures the peak-peak value of the specified source channel and enables the statistic function of the measurement results.
PAGE 176
RIGOL Chapter 2 Command System :MEASure:VRMS Syntax 1 :MEASure:VRMS [] Description 1 Measures the amplitude effective value (Vrms) of the specified source channel. Syntax 2 :MEASure:VRMS? [] 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
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. The unit is related to the current amplitude unit of the specified source channel.
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 [] :MEASure:VTOP:SCURrent [] :MEASure:VTOP:SDEViation [] :MEASure:VTOP:SMAXimum [] :MEASure:VTOP:SMINimum [] Description 1 Measures the amplitude top value of the specified source channel and enables the statistic function of the measurement results.
PAGE 179
RIGOL Chapter 2 Command System :RECall Commands Command List:  :RECall:MTESt  :RECall:REFerence  :RECall:SETup  :RECall:TRACe  :RECall:WAVeform :RECall:MTESt Syntax :RECall:MTEst Description Recalls the pass/fail test mask file stored in the external memory. Parameter Name Type ASCII String Range includes the file storage location and the filename with a suffix. Its length cannot exceed 64 characters.
PAGE 180
RIGOL Chapter 2 Command System :RECall:SETup Syntax :RECall:SETup Description Recalls the setup file stored in the external memory. Parameter Name Type ASCII String Range includes the file storage location and the filename with a suffix. Its length cannot exceed 64 characters.
PAGE 181
RIGOL Chapter 2 Command System :RECall:WAVeform Syntax :RECall:WAVeform Description Recalls the waveform file stored in the external memory. Parameter Name Type ASCII String Range includes the file storage location and the filename with a suffix. Its length cannot exceed 64 characters.
PAGE 182
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:CURRent  :REFerence:ENABle :REFerence:COLor Syntax :REFerence:COLor :REFerence:COLor? Description Sets or queries the color of the current reference waveform.
PAGE 183
RIGOL Chapter 2 Command System :REFerence:DISPlay Syntax :REFerence:DISPlay :REFerence:DISPlay? Description Turns on or off the REF function; or queries the on/off status of the REF function. Parameter Name Type Bool Range {{1|ON}|{0|OFF}} Default 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:ENABle command). Return Format The query returns 1 or 0.
PAGE 184
RIGOL Chapter 2 Command System :REFerence:SOURce Syntax :REFerence:SOURce :REFerence:SOURce? Description Sets or queries the source channel of the current reference waveform channel. Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} Default CHANnel1 Remarks Only the currently enabled channel can be selected as the source channel of the reference waveform. Return Format The query returns CHAN1, CHAN2, CHAN3, CHAN4, or MATH.
PAGE 185
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 indicate different ratios between Vscale0 and Vscale1, as shown in the table below. 1 2 3 4 5 6 7 8 9 10 Vscale1/Vscale0 0.05 0.1 0.2 0.5 1 2 5 10 20 50 Return Format The query returns an integer between 1 and 10.
PAGE 186
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] Description Saves the waveform data to the external memory in "*.csv" format.
PAGE 187
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. Return Format The query returns 1 or 0.
PAGE 188
RIGOL Chapter 2 Command System :SAVE:IMAGe[:STARt] Syntax :SAVE:IMAGe[:STARt] Description Stores the contents displayed on the screen into the external memory in image format. Parameter Name Type ASCII String Range includes the file storage location and the filename with a suffix. Its length cannot exceed 64 characters.
PAGE 189
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. Return Format The query returns 1 or 0.
PAGE 190
RIGOL Chapter 2 Command System :SAVE:WAVeform[:STARt] Syntax :SAVE:WAVeform[:STARt] {} Description Saves the waveform data to the external memory in "*.wfm" format. Parameter Name Type ASCII String Range includes the file storage location and the filename with a suffix. Its length cannot exceed 64 characters.
PAGE 191
RIGOL Chapter 2 Command System :SAVE:MTESt[:STARt] Syntax :SAVE:MTESt[:STARt] Description Saves the current pass/fail test mask to the external memory in "*.pf" format. Parameter Name Type ASCII String Range includes the file storage location and the filename with a suffix. Its length cannot exceed 64 characters.
PAGE 192
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  :SYSTem:RESet  :SYSTem:SETup  :SYSTem:SSAVer:TIME  :SYSTem:TIME  :SYSTem:UDEVice  :SYSTem:VERSion? :SYSTem:AOUTput Syntax :SYSTem:AOUT
PAGE 193
RIGOL Chapter 2 Command System :SYSTem:AUToscale Syntax :SYSTem:AUToscale :SYSTem:AUToscale? Description Enables or disables the Auto function; or queries the on/off status of the Auto function. Parameter Name Type Bool Range {{1|ON}|{0|OFF}} Default 1|ON Remarks  1|ON: enables the Auto function. After it is enabled, you can use the :AUToscale command (or press AUTO on the front panel) to make the oscilloscope perform a waveform auto setting operation.
PAGE 194
RIGOL Chapter 2 Command System :SYSTem:DATE Syntax :SYSTem:DATE ,, :SYSTem:DATE? Description Sets or queries the system date. Parameter Name Type Integer Integer Integer Range 1999 to 2099 1 to 12 1 to 31 (28, 29, or 30) Default ---- Return Format The query returns the system date in strings. The year, month, and date are separated by commas. :SYSTem:ERRor[:NEXT]? Syntax :SYSTem:ERRor[:NEXT]? Description Queries and deletes the last system error message.
PAGE 195
RIGOL Chapter 2 Command System :SYSTem:EXPand Syntax :SYSTem:EXPand :SYSTem:EXPand? Description Sets or queries the vertical reference. Parameter Name Type Discrete Range {CENTer|GROund} Default GROund Remarks  CENTer: when the vertical scale of the channel is modified, the waveform of the corresponding channel will be zoomed in or out vertically relative to the screen center.
PAGE 196
RIGOL Chapter 2 Command System :SYSTem:LANGuage Syntax :SYSTem:LANGuage :SYSTem:LANGuage? Description Sets or queries the system language. Parameter Name Type Discrete Range {SCHinese|TCHinese|ENGLish|FRENch|GERMan| RUSSian|PORTuguese|KORean|JAPanese|POLish} Default -- Return Format The query returns SCH, TCH, ENGL, FREN, GERM, RUSS, PORT, KOR, JAP, or POL. :SYSTem:OPTion:INSTall Syntax :SYSTem:OPTion:INSTall Description Installs an option.
PAGE 197
RIGOL Chapter 2 Command System :SYSTem:PON Syntax :SYSTem: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 Discrete Range {LATest|DEFault} Default -- Remarks  LATest: restores the oscilloscope to the system configuration at the last power-off.  DEFault: restores the oscilloscope to the factory setting. Return Format The query returns LAT or DEF.
PAGE 198
RIGOL Chapter 2 Command System :SYSTem:RCLOck Syntax :SYSTem:RCLock :SYSTem:RCLock? Description Sets or queries the type of the reference clock. Parameter Name Type Discrete Range {COUTput|CINPut} Default COUTput Remarks  COUTput: indicates clock output. The oscilloscope outputs the internal 10 MHz clock signal from the [10MHz In/Out] connector on the rear panel.  CINPut: indicates clock input.
PAGE 199
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. :SYSTem:SSAVer:TIME Syntax :SYSTem:SSAVer:TIME :SYSTem:SSAVer:TIME? Description Sets or queries the screen saver time.
PAGE 200
RIGOL Chapter 2 Command System :SYSTem:UDEVice Syntax :SYSTem:UDEVice :SYSTem:UDEVice? Description Sets or queries the type of the device connected to the USB Device interface. Parameter Name Type Discrete Range {COMPuter|PICTbridge} Default COMPuter Remarks  COMPuter: The oscilloscope can communicate with a PC via the USB DEVICE interface on the rear panel.  PICTbridge: The oscilloscope can communicate with a PictBridge printer via the USB DEVICE interface on the rear panel.
PAGE 201
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 :TIMebase:DELay:ENABle? Description Turns on or off the delayed sweep; or queries the on/off status of the delayed sweep.
PAGE 202
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. Return Format The query returns the horizontal position of the delayed sweep in scientific notation.
PAGE 203
RIGOL Chapter 2 Command System :TIMebase:HREF:POSition Syntax :TIMebase:HREF:POSition :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 Integer Range -350 to +350 Default 0 Remarks The leftmost, rightmost, and center of the screen are 350, -350, and 0 respectively. Return Format The query returns an integer between -350 and +350.
PAGE 204
RIGOL Chapter 2 Command System Remarks  1|ON: enables the fine adjustment function. Rotate Horizontal horizontal time base at a relatively smaller step.  0|OFF: disables the fine adjustment function. Rotate Horizontal time base within the adjustable range at 1-2-5 step. SCALE to further adjust the SCALE to adjust the horizontal Return Format The query returns 1 or 0.
PAGE 205
RIGOL Chapter 2 Command System Parameter Name Type Real Range Refer to Remarks Default 0 Remarks The range of is related to the current horizontal time base mode (refer to the :TIMebase:MODE command) and the operating state of the oscilloscope.
PAGE 206
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  :TRIGger:USB  :TRIGger:VIDeo  :TRIGger:FLEXray :TRIGger:COUPling Syntax :TRIGger:COUPling :TRIGger:COUPling? Description Sets or queries the trigger coupling t
PAGE 207
RIGOL Chapter 2 Command System :TRIGger:HOLDoff Syntax :TRIGger:HOLDoff :TRIGger:HOLDoff? Description Sets or queries the trigger holdoff time. The default unit is s. Parameter Name Type Range Default 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. Return Format The query returns the trigger holdoff time in scientific notation.
PAGE 208
RIGOL Chapter 2 Command System :TRIGger:SWEep Syntax :TRIGger:SWEep :TRIGger:SWEep? Description Sets or queries the trigger mode. Parameter Name Type Range Default Discrete {AUTO|NORMal|SINGle} AUTO Remarks  AUTO: indicates the auto trigger. In this trigger mode, if the specified trigger condition is not found, the oscilloscope will force a trigger and data acquisition to display the waveform.  NORMal: indicates the normal trigger.
PAGE 209
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 :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 :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 Discrete {DATA|REMote|ERRor|OVERload} DATA Remarks  DATA: indicates data frame.  REMote: indicates remote frame.  ERRor: indicates error frame.  OVERload: indicates overload frame.
PAGE 211
RIGOL Chapter 2 Command System Description Sets or queries the source channel of CAN trigger. Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4} Default CHANnel1 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.
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 :TRIGger:CAN:WHEN? Description Sets or queries the trigger condition of CAN trigger. Parameter Name Type Range Default Discrete {SOF|EOF|FTYPe|FERRor} SOF Remarks  SOF: indicates start of frame.
PAGE 213
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 :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. Parameter Name Type Real Range Refer to Remarks Default 0 Remarks The range of is related to the type of the source channel of Edge trigger.
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 the input signal meets the preset trigger level. Return Format The query returns POS, NEG, or RFAL.
PAGE 215
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
: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 :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 Type Real Range The range of is from (-6 x VerticalScale - Offset) to (6 x VerticalScale - Offset) (relative to the vertical center of the screen).
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 :TRIGger:IIC:DLEVel? Description Sets or queries the trigger level of the data signal of IIC trigger. The unit is the same as the current amplitude unit of the source channel.
PAGE 218
RIGOL Chapter 2 Command System :TRIGger:IIC:SDA Syntax :TRIGger:IIC:SDA :TRIGger:IIC:SDA? Description Sets or queries the source channel of the data line of IIC trigger. Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4} Default CHANnel2 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.
PAGE 219
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 [,] :TRIGger:PATTern:LEVel? [] Description Sets or queries the trigger level of the specified channel of Pattern trigger. If is omitted, the command sets or queries the trigger level of the current channel (refer to the :TRIGger:PATTern:SOURce command).
PAGE 220
RIGOL Parameter Name Chapter 2 Command System Type Discrete Discrete Discrete Discrete Discrete Range {H|L|X|R|F} {H|L|X|R|F} {H|L|X|R|F} {H|L|X|R|F} {H|L|X|R|F} Default X X X X X Remarks  - represent the patterns of the analog channels (CH1-CH4) respectively; represents the pattern of the external trigger channel (EXT TRIG).
PAGE 221
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 :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). Return Format The query returns the lower limit of the pulse width in scientific notation.
PAGE 223
RIGOL Chapter 2 Command System :TRIGger:PULSe:WHEN Syntax :TRIGger:PULSe:WHEN :TRIGger:PULSe:WHEN? Description Sets or queries the trigger condition of Pulse trigger. Parameter Name Type Discrete Range {PGReater|PLESs|NGReater|NLESs|PGLess|NGLess} Default PGReater Remarks  PGReater: indicates that the oscilloscope triggers when the positive pulse width of the input signal is greater than the specified pulse width (refer to the :TRIGger:PULSe:LWIDth command).
PAGE 224
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 :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 Real Range The range of 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 channel, refer to the :CHANnel:SCALe command; Offset is the vertical position of the source channel, refer to the :CHANnel:OFFSet 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 :TRIGger:RUNT:WHEN? Description Sets or queries the trigger conditions of Runt trigger. Parameter Name Type Discrete Range {NONE|GREater|LESS|GLESs} Default NONE Remarks  NONE: indicates that no trigger conditions of Runt trigger are set.  GREater: triggers when the width of the runt is greater than the current minimum width of the runt (i.g.
PAGE 227
RIGOL Chapter 2 Command System :TRIGger:RUNT:WUPPer Syntax :TRIGger:RUNT:WUPPer :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). Parameter Name Type Discrete Range The range of is from 4 ns to 4 s when the trigger condition is "LESS".
PAGE 228
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 :TRIGger:NEDGe:EDGE? Description Sets or queries the number of edges for the Nth edge trigger. Parameter Name Type Integer Range 1 to 65535 Default 2 Return Format The query returns an integer between 1 and 65535.
PAGE 229
RIGOL Chapter 2 Command System Parameter Name Type Real Range The range of is from (-6 x VerticalScale - Offset) to (6 x VerticalScale - Offset) (relative to the vertical center of the screen). Wherein, VerticalScale is the vertical scale of the source channel, refer to the :CHANnel:SCALe command; Offset is the vertical position of the source channel, refer to the :CHANnel:OFFSet command. Default 0 Return Format The query returns the trigger level in scientific notation.
PAGE 230
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 :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 :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 Integer Range Refer to Remarks Default 70 Remarks The value of is related to the current data width (set to n, refer to the :TRIGger:RS232:WIDTh command). Its range is from 0 to (2n - 1).
PAGE 232
RIGOL Parameter Name Chapter 2 Command System Type Discrete Range {EVEN|ODD|NONE} Default 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. :TRIGger:RS232:SOURce Syntax :TRIGger:RS232:SOURce :TRIGger:RS232:SOURce? Description Sets or queries the source channel of RS232 trigger.
PAGE 233
RIGOL Chapter 2 Command System :TRIGger:RS232:WHEN Syntax :TRIGger:RS232:WHEN :TRIGger:RS232:WHEN? Description Sets or queries the trigger condition of RS232 trigger. Parameter Name Type Range Default Discrete {STARt|ERRor|PARity|DATA} STARt Remarks  STARt: indicates start of frame.The oscilloscope triggers at the start of a frame. ERRor: indicates error frame. The oscilloscope triggers when an error frame is found. PARity: indicates check error.
PAGE 234
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 :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 Real Range The range of 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 channel of Slope trigger, refer to the :CHANnel:SCALe command; Offset is the vertical position of the source channel of Slope trigger, refer to the :CHANnel:OFFSet command.
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
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 :TRIGger:SPI:CLEVel? Description Sets or queries the trigger level of the clock signal of SPI trigger.
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 :TRIGger:SPI:DATA? Description Sets or queries the data value of SPI trigger. Parameter Name Type Integer Range Refer to Remarks Default 0 Remarks The value of is related to the current data width (set to n, refer to the :TRIGger:SPI:WIDTh command).
PAGE 240
RIGOL Chapter 2 Command System :TRIGger:SPI:MODE Syntax :TRIGger:SPI: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 Discrete Range {HIGH|LOW} Default HIGH Return Format The query returns HIGH or LOW. :TRIGger:SPI:SCL Syntax :TRIGger:SPI:SCL :TRIGger:SPI:SCL? Description Sets or queries the source channel of the clock line of SPI trigger.
PAGE 241
RIGOL Chapter 2 Command System :TRIGger:SPI:SLEVel Syntax :TRIGger:SPI:SLEVel :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 :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 Real Range 100 ns to 1 s Default 1 us Return Format The query returns the timeout value in scientific notation.
PAGE 243
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 :TRIGger:USB:DMINus? Description Sets or queries the source channel of D- data line of USB trigger.
PAGE 244
RIGOL Chapter 2 Command System :TRIGger:USB:MLEVel Syntax :TRIGger:USB:MLEVel :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 Type Real Range The range of is from (-6 x VerticalScale - Offset) to (6 x VerticalScale - Offset) (relative to the vertical center of the screen).
PAGE 245
RIGOL Chapter 2 Command System :TRIGger:USB:SPEed Syntax :TRIGger:USB:SPEed :TRIGger:USB:SPEed? Description Sets or queries the signal rate of USB trigger. Parameter Name Type Discrete Range {LOW|FULL} Default LOW Return Format The query returns LOW or FULL. :TRIGger:USB:WHEN Syntax :TRIGger:USB:WHEN :TRIGger:USB:WHEN? Description Sets or queries the trigger condition of USB trigger.
PAGE 246
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 :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 :TRIGger:VIDeo:MODE? Description Sets or queries the sync trigger mode of Video trigger. Parameter Name Type Discrete Range {ALINes|LINE|ODDField|EVENfield} Default ALINes Remarks  ALINes: indicates all lines. The oscilloscope triggers on the first line found.  LINE: indicates the specified line. The oscilloscope triggers on the specified line.
PAGE 248
RIGOL Chapter 2 Command System :TRIGger:VIDeo:SOURce Syntax :TRIGger:VIDeo:SOURce :TRIGger:VIDeo:SOURce? Description Sets or queries the source channel of Video trigger. Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4} Default CHANnel1 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.
PAGE 249
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 :TRIGger:FLEXray:BAUD? Description Sets or queries the signal rate of FlexRay trigger. The default unit is b/s. Parameter Name Type Discrete Range {2500000|5000000|10000000} Default 2500000 Return Format The query returns 2500000, 5000000, or 10000000.
PAGE 250
RIGOL Chapter 2 Command System :TRIGger:FLEXray:SOURce Syntax :TRIGger:FLEXray:SOURce :TRIGger:FLEXray:SOURce? Description Sets or queries the source channel of FlexRay trigger. Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4} Default CHANnel1 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.
PAGE 251
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
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?  :WAVeform:YREFerence? :WAVeform:BEGin Syntax :WAVeform:BEGin Description Starts the waveform data reading.
PAGE 253
Chapter 2 Command System RIGOL 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.) S2. :WAV:SOUR CHAN1 Sets the source channel of waveform data reading to CH1 S3.
PAGE 254
RIGOL Chapter 2 Command System TMC Data Header Block :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 :WAVeform:FORMat? Description Sets or queries the return format of the waveform data.
PAGE 255
RIGOL Chapter 2 Command System :WAVeform:MODE Syntax :WAVeform:MODE :WAVeform:MODE? Description Sets or queries the reading mode of the waveform data. Parameter Name Type Range Default Discrete {NORMal|RAW|MAXimum} NORMal Remarks  NORMal: reads the waveform data displayed on the screen. RAW: reads the waveform data in the internal memory.
PAGE 256
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. ,,,,,,,,, : indicates 0 (BYTE), 1 (WORD), or 2 (ASCii). Refer to the :WAVeform:FORMat command.
PAGE 257
RIGOL Chapter 2 Command System :WAVeform:SOURce Syntax :WAVeform:SOURce :WAVeform:SOURce? Description Sets or queries the source channel of waveform data reading. Parameter Name Type Discrete Range {CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH|FFT} Default 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
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, or READ,. IDLE,: indicates that the waveform data reading thread finishes; is the number of waveform points that have been read. READ,: indicates that the waveform data reading thread is running; is the number of waveform points that have currently been read.
PAGE 259
Chapter 2 Command System RIGOL 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; SampleRate is the current sample rate, refer to the :ACQuire:SRATe? command.  Return Format The query returns the time difference in scientific notation.
PAGE 260
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. Remarks The following formula presents the relations among three parameters: YORigin = VerticalOffset/VerticalScale x 32.
PAGE 261
Chapter 3 Programming Examples RIGOL 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
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. The following parts will make a detailed introduction about the programming examples in Excel, LabVIEW, MATLAB, Visual Basic 6.
PAGE 263
Chapter 3 Programming Examples RIGOL Click the Developer tab and select the Visual Basic option to open the Microsoft Visual Basic. 4. 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. (2) Click Browse…, then select the path C:\WINDOWS\system32 and search the filename visa32.dll, as shown in the figure below. 5. Click View in the Microsoft Visual Basic menu bar and select Code to enter the code window. Add the following codes and save the file.
PAGE 265
Chapter 3 Programming Examples RIGOL 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’ cmdStr = "*IDN?" viErr = visa.viWrite(viDevice, cmdStr, Len(cmdStr), ret) viErr = visa.viRead(viDevice, idnStr, 128, ret) Sheet1.Cells(2, 2) = idnStr ‘Turn off the device’ visa.
PAGE 266
RIGOL 3-6 Chapter 3 Programming Examples DS4000E Programming Guide
PAGE 267
Chapter 3 Programming Examples RIGOL 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. 1. Run LabVIEW 8.2, and then create a VI file named Demo_LabVIEW. 2. Add the VISA resource name and Waveform Graph controls, as shown in the figure below:. 3. Open the Block Diagram interface.
PAGE 268
RIGOL Chapter 3 Programming Examples 4. Connect the VISA resource name with the VISA Open. Then, connect the VISA resource name outputs of all the functions with the VISA resource name and connect the error output with the error input as shown in the figure below. 5. Add text boxes in the write buffer areas of the VISA Write controls and input ":WAV:SOUR CHAN1", ":WAV:FORM BYTE" and ":WAV:DATA?" respectively.
PAGE 269
Chapter 3 Programming Examples RIGOL Get the length of the effective waveform data. 7. 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. 8. The complete program block diagram is as shown in the figure below: 9. Select the device resource from the VISA Resource Name drop-down list and run the program.
PAGE 270
RIGOL 3-10 Chapter 3 Programming Examples DS4000E Programming Guide
PAGE 271
Chapter 3 Programming Examples RIGOL 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. 1. Run the MATLAB software and modify the current path. In this example, the current path is modified to be D:\Demo\MATLAB. 2. Click File  New  Blank M-File in the Matlab interface to create an empty M file. Add the following codes to the M file: % Create the VISA object.
PAGE 272
RIGOL 3. 3-12 Chapter 3 Programming Examples Save the M file to the current path. In this example, the M file is named as "Demo_MATLAB.m".
PAGE 273
Chapter 3 Programming Examples RIGOL 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. 1. Build a standard application program project (Standard EXE), and name it "Demo_VB". 2. Click Project  Add Module to open the Add Module dialog box. In the dialog box, click the Existing tab to search for the visa32.bas file in the "include" folder in the NI-VISA installation path and add the file.
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?" + Chr$(10), 0) ' Acquire the status of CH1 Call viVScanf(vi, "%t", strRes) s32Disp = CInt(strRes) If (s32Disp = 1) Then ' Send the setting command Call viVPrintf(vi, ":CHAN1:DISP 0" + Chr$(1
PAGE 275
Chapter 3 Programming Examples RIGOL 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. 1. Run Microsoft Visual C++ 6.0. Create a MFC project based on a dialog box and name it as demoIDN in this instance. 2. Click Project  Settings to open the Project Settings dialog box.
PAGE 276
RIGOL Chapter 3 Programming Examples 2) 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. By now, VISA library has been added. 5. Add Static Text, Combo Box, Button, and Edit Box controls. The layout interface for adding controls is as follows: 6. Modify the control attributes.
PAGE 277
Chapter 3 Programming Examples RIGOL 7. Add the variables m_combox and m_receive to the Com Box and Edit Box controls respectively. 8. Add codes. Double-click Send and Read to enter the programming environment. Declare the #include
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); 9. 3-18 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.