Programming Guide DS1000Z-E Series Digital Oscilloscope Aug. 2019 RIGOL (SUZHOU) TECHNOLOGIES INC.
RIGOL Guaranty and Declaration Copyright © 2019 RIGOL (SUZHOU) TECHNOLOGIES INC. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES INC. Publication Number PGA27100-1110 Software Version 00.06.01 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.
RIGOL Document Overview This manual provides guidance on how to use the SCPI commands in programming to realize remote control of RIGOL DS1000Z-E series digital oscilloscope through the remote interface. DS1000Z-E can communicate with a PC through the USB or the LAN bus. Main Topics in this Manual: Chapter 1 Programming Overview This chapter introduces how to build the remote communication between DS1000Z-E series digital oscilloscope and the PC.
Contents RIGOL Contents Guaranty and Declaration ......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 Programming Overview......................................................................................1-1 To Build Remote Communication ....................................................................
RIGOL Contents :DECoder:CONFig:ENDian .......................................................................................... 2-36 :DECoder:CONFig:WIDth ............................................................................................ 2-36 :DECoder:CONFig:SRATe? .......................................................................................... 2-37 :DECoder:UART .........................................................................................................
Contents RIGOL :LAN:SMASk .................................................................................................................... 2-77 :LAN:STATus? .................................................................................................................. 2-77 :LAN:VISA? ...................................................................................................................... 2-78 :LAN:APPLy....................................................................................
RIGOL Contents :MEASure:SETup:MAX ..................................................................................................... 2-105 :MEASure:SETup:MID ..................................................................................................... 2-106 :MEASure:SETup:MIN ..................................................................................................... 2-106 :MEASure:SETup:PSA ...............................................................................................
Contents RIGOL :TRIGger:DURATion ....................................................................................................... 2-142 :TRIGger:TIMeout .......................................................................................................... 2-145 :TRIGger:RUNT ............................................................................................................. 2-147 :TRIGger:WINDows ..........................................................................................
Chapter 1 Programming Overview RIGOL Chapter 1 Programming Overview This chapter introduces how to build the remote communication between DS1000Z-E series digital oscilloscope and the PC. It also introduces the remote control methods as well as the syntax, symbols, parameters and abbreviation rules of the SCPI commands.
RIGOL Chapter 1 Programming Overview To Build Remote Communication This oscilloscope can communicate with a PC through the USB or the LAN bus. This section introduces how to control the oscilloscope remotely through the USB interface using Ultra Sigma in details. Operation Steps: 1. Install the Ultra Sigma common PC software Download the Ultra Sigma common PC software from RIGOL official website (www.rigol.com) and install it according to the instructions. 2.
RIGOL Chapter 1 Programming Overview 3 4 5 6 DS1000Z-E Programming Guide 1-3
RIGOL Chapter 1 Programming Overview 7 (3) Search for device resource Start up the Ultra Sigma and the software will automatically search for the instrument resources to search for the resources. currently connected to the PC. You can also click (4) View the device resources The resources found will appear under the "RIGOL Online Resource" directory and the model number and USB interface information of the instrument will also be displayed.
Chapter 1 Programming Overview RIGOL SCPI Command Overview SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming language that is built upon the standard IEEE 488.1 and IEEE 488.2 and conforms to various standards (such as the floating point operation rule in IEEE 754 standard, ISO 646 7-bit coded character for information interchange (equivalent to ASCII programming)). The SCPI commands provide a hierarchical tree structure and consist of multiple subsystems.
RIGOL Chapter 1 Programming Overview 2. Discrete The parameter could be any of the values listed. For example, :ACQuire:TYPE :ACQuire:TYPE? Wherein, can be set to NORMal|AVERages|PEAK|HRESolution. The query returns the abbreviations (NORM, AVER, PEAK, or HRES). 3. Integer Unless otherwise noted, the parameter can be any integer (NR1 format) within the effective value range. Note that do not set the parameter to a decimal, otherwise errors will occur.
Chapter 2 Command System RIGOL Chapter 2 Command System This chapter introduces the syntax, function, parameter, and using instruction of each DS1000Z-E command. Main topics of this chapter: :AUToscale :CLEar :RUN :STOP :SINGle :TFORce :ACQuire Commands :CALibrate Commands :CHANnel Commands :CURSor Commands :DECoder Commands :DISPlay Commands :ETABle Commands :FUNCtion Commands IEEE488.
RIGOL Chapter 2 Command System :AUToscale Syntax :AUToscale Description Enable the waveform auto setting function. The oscilloscope will automatically adjust the vertical scale, horizontal timebase, and trigger mode according to the input signal to realize optimum waveform display. This command is equivalent to pressing the AUTO key on the front panel.
Chapter 2 Command System RIGOL :SINGle Syntax :SINGle Description Set the oscilloscope to the single trigger mode. This command is equivalent to any of the following two operations: pressing the SINGLE key on the front panel and sending the :TRIGger:SWEep SINGle command. Explanation In the single trigger mode, the oscilloscope triggers once when the trigger conditions are met and then stops.
RIGOL Chapter 2 Command System :ACQuire Commands The :ACQuire commands are used to set and query the memory depth, acquisition mode and the number of averages as well as query the current sample rate of the oscilloscope.
RIGOL Chapter 2 Command System :ACQuire:MDEPth Syntax :ACQuire:MDEPth :ACQuire:MDEPth? Description Parameter Explanation Return Format Example Related Command Set or query the memory depth of the oscilloscope (namely the number of waveform points that can be stored in a single trigger sample). The default unit is pts (points).
RIGOL Chapter 2 Command System average the neighboring points of the sample waveform to reduce the random noise on the input signal and generate much smoother waveforms on the screen. This is generally used when the sample rate of the digital converter is higher than the storage rate of the acquisition memory. Return Format Example The query returns NORM, AVER, PEAK, or HRES.
Chapter 2 Command System RIGOL :CALibrate Commands Command List: :CALibrate:QUIT :CALibrate:STARt :CALibrate:QUIT Syntax Description Related Command :CALibrate:QUIT Exit the self-calibration at any time. :CALibrate:STARt :CALibrate:STARt Syntax :CALibrate:STARt Description The oscilloscope starts to execute self-calibration. Explanation The self-calibration operation can make the oscilloscope quickly reach its optimum working state to obtain the most accurate measurement values.
RIGOL Chapter 2 Command System :CHANnel Commands The :CHANnel commands are used to set or query the vertical system parameters of the analog channels, such as the bandwidth limit, coupling, vertical scale, and vertical offset.
RIGOL Chapter 2 Command System :CHANnel:COUPling Syntax :CHANnel:COUPling :CHANnel:COUPling? Description Parameter Explanation Return Format Example Set or query the coupling mode of the specified channel. Name Type Range Default Discrete {1|2} -- Discrete {AC|DC|GND} DC AC: the DC components of the signal under test are blocked. DC: the DC and AC components of the signal under test can both pass the channel.
RIGOL Chapter 2 Command System :CHANnel:INVert Syntax :CHANnel:INVert :CHANnel:INVert? Description Parameter Explanation Return Format Example Enable or disable the waveform invert of the specified channel or query the status of the waveform invert of the specified channel.
RIGOL Chapter 2 Command System :CHANnel:RANGe Syntax :CHANnel:RANGe :CHANnel:RANGe? Description Parameter Explanation Return Format Example Set or query the vertical range of the specified channel. The default unit is V.
RIGOL Chapter 2 Command System :CHANnel:TCAL Syntax :CHANnel:TCAL :CHANnel:TCAL? Description Parameter Explanation Set or query the delay calibration time of the specified channel to calibrate the zero offset of the corresponding channel. The default unit is s. Name Type Range Default Discrete {1|2} -- Real -100ns to 100ns 0.00s can only be set to the specific values in the specified step.
RIGOL Chapter 2 Command System :CHANnel:SCALe Syntax :CHANnel:SCALe :CHANnel:SCALe? Description Parameter Set or query the vertical scale of the specified channel. The default unit is V.
RIGOL Chapter 2 Command System :CHANnel:UNITs Syntax :CHANnel:UNITs :CHANnel:UNITs? Description Parameter Return Format Example Set or query the amplitude display unit of the specified channel. Name Type Range Default Discrete {1|2} -- Discrete {VOLTage|WATT|AMPere|UNKNown} VOLTage The query returns VOLT, WATT, AMP, or UNKN.
RIGOL Chapter 2 Command System :CURSor Commands The :CURSor commands are used to measure the X-axis value (such as time) and Y-axis value (such as voltage) of the waveform displayed on the screen. Command List: :CURSor:MODE :CURSor:MANual :CURSor:TRACk :CURSor:AUTO :CURSor:XY :CURSor:MODE Syntax :CURSor:MODE :CURSor:MODE? Description Parameter Explanation Return Format Example Related Commands Set or query the cursor measurement mode.
RIGOL Chapter 2 Command System :CURSor:MANual Command List: :CURSor:MANual:TYPE :CURSor:MANual:SOURce :CURSor:MANual:TUNit :CURSor:MANual:VUNit :CURSor:MANual:AX :CURSor:MANual:BX :CURSor:MANual:AY :CURSor:MANual:BY :CURSor:MANual:AXValue? :CURSor:MANual:AYValue? :CURSor:MANual:BXValue? :CURSor:MANual:BYValue? :CURSor:MANual:XDELta? :CURSor:MANual:IXDELta? :CURSor:MANual:YDELta? :CURSor:MANual:TYPE Syntax :CURSor:MANual:TYPE :CURSor:MANua
RIGOL Chapter 2 Command System :CURSor:MANual:SOURce Syntax :CURSor:MANual:SOURce :CURSor:MANual:SOURce? Description Parameter Explanation Return Format Example Set or query the channel source of the manual cursor measurement mode. Name Type Range Default Discrete {CHANnel1|CHANnel2|MATH} CHANnel1 Only the channel that is enabled currently can be selected. The query returns CHAN1, CHAN2, or MATH.
RIGOL Chapter 2 Command System Related Command :CHANnel:UNITs :CURSor:MANual:AX Syntax :CURSor:MANual:AX :CURSor:MANual:AX? Description Parameter Explanation Return Format Example Set or query the horizontal position of cursor A in the manual cursor measurement mode. Name Type Range Default Integer 5 to 594 100 The horizontal and vertical positions of the cursor are defined by the pixel coordinate of the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400).
RIGOL Chapter 2 Command System the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400). Wherein, (0,0) is located at the left top corner of the screen and (600,400) is located at the right bottom corner of the screen. The horizontal pixel range is from 0 to 600 and the vertical pixel range is from 0 to 400. Return Format Example The query returns an integer between 5 and 394.
RIGOL Chapter 2 Command System :CURSor:MANual:BXValue? Syntax Description Return Format Example Related Commands :CURSor:MANual:BXValue? Query the X value of cursor B in the manual cursor measurement mode. The unit depends on the horizontal unit currently selected. The query returns the X value of cursor B in scientific notation. :CURSor:MANual:BXValue? /*The query returns 4.
RIGOL Chapter 2 Command System :CURSor:MANual:YDELta? Syntax :CURSor:MANual:YDELta? Description Query the difference between the Y values of cursor A and cursor B (BY-AY) in the manual cursor measurement mode. The unit depends on the vertical unit currently selected. Return Format When the signal source is CHANnel1|CHANnel2|MATH, the query returns the difference in scientific notation. Example Related Commands :CURSor:MANual:YDELta? /*The query returns -4.
RIGOL Chapter 2 Command System :CURSor:TRACk:SOURce2 Syntax :CURSor:TRACk:SOURce2 :CURSor:TRACk:SOURce2? Description Parameter Explanation Return Format Example Set or query the channel source of cursor B in the track cursor measurement mode. Name Type Range Default Discrete {OFF|CHANnel1|CHANnel2|MATH} CHANnel1 Only the channels enabled can be selected as the channel source. The query returns OFF, CHAN1, CHAN2, or MATH.
RIGOL Chapter 2 Command System :CURSor:TRACk:AY? Syntax :CURSor:TRACk:AY? Description Query the vertical position of cursor A in the track cursor measurement mode. Explanation The horizontal and vertical positions of the cursor are defined by the pixel coordinate of the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400). Wherein, (0,0) is located at the left top corner of the screen and (600,400) is located at the right bottom corner of the screen.
RIGOL Chapter 2 Command System Example Related Commands :CURSor:TRACk:AYValue? /*The query returns -4.000000e-01*/ :CHANnel:UNITs :CURSor:TRACk:AY? :CURSor:TRACk:BXValue? Syntax Description Return Format Example Related Command :CURSor:TRACk:BXValue? Query the X value of cursor B in the track cursor measurement mode. The default unit is s. The query returns the X value of cursor B in scientific notation. :CURSor:TRACk:BXValue? /*The query returns 4.
RIGOL Chapter 2 Command System Related Commands :CURSor:TRACk:AY? :CURSor:TRACk:BY? :CURSor:TRACk:IXDELTA? Syntax Description Return Format Example Related Commands :CURSor:TRACk:IXDELTA? Query the reciprocal of the absolute value of the difference between the X values of cursor A and cursor B (1/|dX|) in the track cursor measurement mode. The default unit is Hz. The query returns 1/|dX| in scientific notation. :CURSor:TRACk:IXDELTA? /*The query returns 1.
RIGOL Chapter 2 Command System Explanation Return Format Example This command is only valid when the auto cursor mode is selected. You can select the auto cursor measurement mode using the :CURSor:MODE command. The 37 waveform parameters are listed below (see the detailed introduction in :MEASure Commands). The parameters can be enabled by the :MEASure:ITEM command.
RIGOL Chapter 2 Command System :CURSor:AUTO:AY? Syntax :CURSor:AUTO:AY? Description Query the vertical position of cursor A in auto cursor measurement. Explanation The horizontal and vertical positions of the cursor are defined by the pixel coordinate of the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400). Wherein, (0,0) is located at the left top corner of the screen and (600,400) is located at the right bottom corner of the screen.
RIGOL Chapter 2 Command System Example :CURSor:AUTO:AYValue? /*The query returns -4.000000e-01*/ :CURSor:AUTO:BXValue? Syntax :CURSor:AUTO:BXValue? Description Query the X value of cursor B in auto cursor measurement. The unit depends on the horizontal unit currently selected. Explanation In auto cursor measurement, cursor B of X type is not required for some of the measurement items. At this point, the query returns 9.9E37.
RIGOL Chapter 2 Command System :CURSor:XY The :CURSor:XY commands can only be used when the horizontal timebase mode is XY. Command List: :CURSor:XY:AX :CURSor:XY:BX :CURSor:XY:AY :CURSor:XY:BY :CURSor:XY:AXValue? :CURSor:XY:AYValue? :CURSor:XY:BXValue? :CURSor:XY:BYValue? :CURSor:XY:AX Syntax :CURSor:XY:AX :CURSor:XY:AX? Description Parameter Explanation Return Format Example Set or query the horizontal position of cursor A in the XY cursor measurement mode.
RIGOL Chapter 2 Command System Example :CURSor:XY:BX 200 :CURSor:XY:BX? /*Set the horizontal position of cursor B to 200*/ /*The query returns 200*/ :CURSor:XY:AY Syntax :CURSor:XY:AY :CURSor:XY:AY? Description Parameter Explanation Return Format Example Set or query the vetical position of cursor A in the XY cursor measurement mode.
RIGOL Chapter 2 Command System :CURSor:XY:AYValue? Syntax Description Return Format :CURSor:XY:AYValue? Query the Y value of cursor A in the XY cursor measurement mode. The unit depends on the amplitude unit of the corresponding channel. The query returns the Y value of cursor A in scientific notation. Example :CURSor:XY:AYValue? Related Command :CHANnel:UNITs /*The query returns 2.
RIGOL Chapter 2 Command System :DECoder Commands The :DECoder commands are used to execute decoding settings and operations.
RIGOL Chapter 2 Command System :DECoder:DISPlay Syntax :DECoder:DISPlay :DECoder:DISPlay? Description Parameter Return Format Example Turn on or off the decoder or query the status of the decoder. Name Type Range Default Discrete {1|2} -- Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0.
RIGOL Chapter 2 Command System Format Example :DECoder1:POSition 300 :DECoder1:POSition? /*Set the vertical position of the bus to 300*/ /*The query returns 300*/ :DECoder:THREshold:CHANnel1 :DECoder:THREshold:CHANnel2 Syntax :DECoder:THREshold:CHANnel1 :DECoder:THREshold:CHANnel1? :DECoder:THREshold:CHANnel2 :DECoder:THREshold:CHANnel2? Description Parameter Explanation Return Format Example Set or query the threshold level of the specified analog channel.
RIGOL Chapter 2 Command System :DECoder1:THREshold:AUTO? Related Commands /*The query returns 0*/ :DECoder:THREshold:CHANnel1 :DECoder:THREshold:CHANnel2 :DECoder:CONFig:LABel Syntax :DECoder:CONFig:LABel :DECoder:CONFig:LABel? Description Parameter Explanation Return Format Example Turn on or off the label display function, or query the status of the label display function.
RIGOL Parameter Explanation Return Format Example Chapter 2 Command System Name Type Range Default Discrete {1|2} -- Bool {{1|ON}|{0|OFF}} 1|ON When this function is turned on, the current bus display format will be displayed at the right of the label display (when the bus display is turned on). You can send the :DECoder:FORMat command to set the bus display format. The query returns 1 or 0.
RIGOL Chapter 2 Command System :DECoder:CONFig:SRATe? Syntax Description Parameter Explanation Return Format Example :DECoder:CONFig:SRATe? Query the current digital sample rate. Name Type Range Default Discrete {1|2} -- The digital sample rate is related to the data source currently selected. By default, the data source is "Trace"; at this point, the digital sample rate is related to the horizontal time base. The query returns the digital sample rate in scientific notation.
RIGOL Chapter 2 Command System :DECoder:UART The :DECoder:UART commands are used to set the RS232 decoding parameters.
RIGOL Chapter 2 Command System Return Format Example The query returns CHAN1, CHAN2, or OFF. :DECoder1:UART:RX CHANnel2 /*Set the RX channel source to CH2*/ :DECoder1:UART:RX? /*The query returns CHAN2*/ :DECoder:UART:POLarity Syntax :DECoder:UART:POLarity :DECoder:UART:POLarity? Description Parameter Explanation Return Format Example Set or query the polarity of RS232 decoding.
RIGOL Chapter 2 Command System Parameter Return Format Example Name Type Range Default Discrete {1|2} -- Integer 110 to 20M 9600 The query returns the current baud rate in integer.
RIGOL Chapter 2 Command System Return Format Example The query returns NONE, EVEN, or ODD.
RIGOL Chapter 2 Command System :DECoder:IIC The :DECoder:IIC commands are used to set the I2C decoding parameters. Command List: :DECoder:IIC:CLK :DECoder:IIC:DATA :DECoder:IIC:ADDRess :DECoder:IIC:CLK Syntax :DECoder:IIC:CLK :DECoder:IIC:CLK? Description Parameter Return Format Example Set or query the signal source of the clock channel in I2C decoding.
RIGOL Chapter 2 Command System :DECoder:IIC:ADDRess Syntax :DECoder:IIC:ADDRess :DECoder:IIC:ADDRess? Description Parameter Explanation Return Format Example Set or query the address mode of I2C decoding. Name Type Range Default Discrete {1|2} -- Discrete {NORMal|RW} NORMal NORMal: the address bits (:TRIGger:IIC:AWIDth) does not include the R/W bit. RW: the address bits (:TRIGger:IIC:AWIDth) includes the R/W bit. The query returns NORM or RW.
RIGOL Chapter 2 Command System :DECoder:SPI The :DECoder:SPI commands are used to set the SPI decoding parameters.
RIGOL Chapter 2 Command System Explanation Return Format Example When OFF is selected, no MISO channel source will be set. The MISO channel source and MOSI channel source (:DECoder:SPI:MOSI) cannot be both set to OFF. The query returns CHAN1, CHAN2, or OFF.
RIGOL Chapter 2 Command System :DECoder:SPI:SELect Syntax :DECoder:SPI:SELect :DECoder:SPI:SELect? Description Parameter Explanation Return Format Example Set or query the CS polarity in SPI decoding. Name Type Range Default Discrete {1|2} -- Discrete {NCS|CS} NCS NCS: low level is valid ( CS is low. ). The instrument starts transmitting data when the CS: high level is valid ( CS is high. ).
RIGOL Chapter 2 Command System Parameter Explanation Return Format Example Name Type Range Default Discrete {1|2} -- Real Refer to Explanation 1.00us The timeout time should be greater than the maximum pulse width of the clock and lower than the idle time between frames. This command is only valid in the timeout mode (:DECoder:SPI:MODE). The query returns the timeout time in scientific notation. :DECoder1:SPI:TIMeout 0.
RIGOL Chapter 2 Command System :DECoder:SPI:ENDian Syntax :DECoder:SPI:ENDian :DECoder:SPI:ENDian? Description Parameter Return Format Example Set or query the endian of the SPI decoding data. Name Type Range Default Discrete {1|2} -- Discrete {LSB|MSB} MSB The query returns LSB or MSB.
RIGOL Chapter 2 Command System :DECoder:PARallel The :DECoder:PARallel commands are used to set the parallel decoding parameters.
RIGOL Chapter 2 Command System Return Format Example The query returns RISE, FALL, or BOTH.
RIGOL Chapter 2 Command System Parameter Name Type Range Default Discrete {1|2} -- {CHANnel1|CHANnel2|} Related to the bit selected Explanation Return Format Example Discrete Before sending this command, use the :DECoder:PARallel:BITX command to select the desired data bit. The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System Return Format Example When the noise rejection is turned on, sending the :DECoder:PARallel:NRTime command can set the desired rejection time. The query returns 1 or 0.
RIGOL Chapter 2 Command System :DECoder:PARallel:PLOT Syntax :DECoder:PARallel:PLOT :DECoder:PARallel:PLOT? Description Parameter Explanation Return Format Example Turn on or off the curve function of parallel decoding, or query the status of the curve function of parallel decoding. Name Type Range Default Discrete {1|2} -- Bool {{1|ON}|{0|OFF}} 0|OFF When this function is turned on, the variation trend of the bus data is displayed in vector diagram form.
RIGOL Chapter 2 Command System :DISPlay Commands The :DISPlay commands can be used to set the waveform display mode, persistence time, waveform intensity, screen grid type and grid brightness. Command List: :DISPlay:CLEar :DISPlay:DATA? :DISPlay:TYPE :DISPlay:GRADing:TIME :DISPlay:WBRightness :DISPlay:GRID :DISPlay:GBRightness :DISPlay:CLEar Syntax :DISPlay:CLEar Description Clear all the waveforms on the screen.
RIGOL Chapter 2 Command System :DISPlay:DATA? Syntax Description Parameter Explanation Return Format :DISPlay:DATA? [,,] Read the data stream of the image currently displayed on the screen and set the color, invert display, and format of the image acquired.
RIGOL Chapter 2 Command System :DISPlay:TYPE Syntax :DISPlay:TYPE :DISPlay:TYPE? Description Parameter Explanation Return Format Example 2-56 Set or query the display mode of the waveform on the screen. Name Type Range Default Discrete {VECTors|DOTS} VECTors VECTors: the sample points are connected by lines. Normally, this mode can provide the most vivid waveform to view the steep edge of the waveform (such as square waveform). DOTS: display the sample points directly.
RIGOL Chapter 2 Command System :DISPlay:GRADing:TIME Syntax :DISPlay:GRADing:TIME
RIGOL Chapter 2 Command System :DISPlay:GRID Syntax :DISPlay:GRID :DISPlay:GRID? Description Parameter Explanation Return Format Example Set or query the grid type of screen display. Name Type Range Default Discrete {FULL|HALF|NONE} FULL FULL: turn the background grid and coordinate on. HALF: turn the background grid off and coordinate on. NONE: turn the background grid and coordinate off. The query returns FULL, HALF, or NONE.
RIGOL Chapter 2 Command System :ETABle Commands The :ETABle commands are used to set the parameters related to the decoding event table. Command List: :ETABle:DISP :ETABle:FORMat :ETABle:VIEW :ETABle:COLumn :ETABle:ROW :ETABle:SORT :ETABle:DATA? :ETABle:DISP Syntax :ETABle:DISP :ETABle:DISP? Description Parameter Explanation Return Format Example Turn on or off the decoding event table, or query the status of the decoding event table.
RIGOL Chapter 2 Command System :ETABle:VIEW Syntax :ETABle:VIEW :ETABle:VIEW? Description Parameter Explanation Return Format Example Set or query the display mode of the event table. Name Type Range Default Discrete {1|2} -- Discrete {PACKage|DETail|PAYLoad} PACKage PACKage: the time and data are displayed in the event table. DETail: the detailed data of the specified row is displayed in the event table.
RIGOL Chapter 2 Command System :ETABle:ROW Syntax :ETABle:ROW :ETABle:ROW? Description Parameter Return Format Example Set or query the current row of the event table. Name Type Range Default Discrete {1|2} -- Integer 1 to the maximum number of rows of the current event table 1 The query returns the current row in integer. If the current even table is empty, the query returns 0.
RIGOL Chapter 2 Command System :ETABle:DATA? Syntax Description Parameter Return Format :ETABle:DATA? Read the current event table data. Name Type Range Default Discrete {1|2} -- The query returns the event table data in the format as shown in the figure below. Wherein, #9000000098 is the TMC data description header followed by the even table data and its format is #900000dddd. dddd denotes the number of bytes of the valid waveform data following the description header.
RIGOL Chapter 2 Command System :FUNCtion Commands The :FUNCtion commands are used to set the waveform recording and playback parameters.
RIGOL Chapter 2 Command System :FUNCtion:WRECord:FMAX? Syntax :FUNCtion:WRECord:FMAX? Description Query the maximum number of frames can be recorded currently. Explanation As the capacity of the waveform memory is fixed, the more the number of points each frame of waveform has, the less the number of waveform frames can be recorded. Thus, the maximum number of frames can be recorded currently is decided by the memory depth currently selected.
RIGOL Chapter 2 Command System :FUNCtion:WRECord:OPERate Syntax :FUNCtion:WRECord:OPERate :FUNCtion:WRECord:OPERate? Description Parameter Explanation Return Format Example Start or stop the waveform recording, or query the status of the waveform recording. Name Type Range Default Discrete {RUN|STOP} -- Before sending this command, send the :FUNCtion:WRECord:ENABle command to turn on the waveform recording function. Otherwise, this command is invalid. The query returns RUN or STOP.
RIGOL Chapter 2 Command System :FUNCtion:WREPlay:FSTart Syntax :FUNCtion:WREPlay:FSTart :FUNCtion:WREPlay:FSTart? Description Parameter Explanation 2-66 Set or query the start frame of waveform playback. Name Type Range Default Integer 1 to the maximum number of frames recorded 1 Use the :FUNCtion:WRECord:FEND command to set the maximum number of frames recorded.
RIGOL Chapter 2 Command System :FUNCtion:WREPlay:FEND Syntax :FUNCtion:WREPlay:FEND :FUNCtion:WREPlay:FEND? Description Parameter Explanation Return Format Example Set or query the end frame of waveform playback. Name Type Range Default Integer 1 to the maximum number of frames recorded The maximum number of frames recorded Use the :FUNCtion:WRECord:FEND command to set the maximum number of frames recorded.
RIGOL Chapter 2 Command System :FUNCtion:WREPlay:FINTerval Syntax :FUNCtion:WREPlay:FINTerval :FUNCtion:WREPlay:FINTerval? Description Parameter Explanation Return Format Example Set or query the time interval between frames in waveform playback. The default unit is s. Name Type Range Default Real 100ns to 10s 100ns You can only set the time interval of waveform playback when a waveform is currently recorded.
RIGOL Chapter 2 Command System :FUNCtion:WREPlay:DIRection Syntax :FUNCtion:WREPlay:DIRection
:FUNCtion:WREPlay:DIRection? Description Parameter Explanation Return Format Example Set or query the waveform playback direction. Name Type Range Default Discrete {FORWard|BACKward} FORWard FORWard: positive direction. Play from the start frame to the end frame. BACKward: negative direction. Play from the end frame to the start frame.RIGOL Chapter 2 Command System :FUNCtion:WREPlay:FCURrent Syntax :FUNCtion:WREPlay:FCURrent :FUNCtion:WREPlay:FCURrent? Description Parameter Explanation Return Format Example Set or query the current frame in waveform playback. Name Type Range Default Integer 1 to the maximum number of frames recorded The maximum number of frames recorded Use the :FUNCtion:WRECord:FEND command to set the maximum number of frames recorded.
RIGOL Chapter 2 Command System IEEE488.2 Common Commands The IEEE 488.2 standard defines some common commands used for querying the basic information of the instrument or executing the basic operations. These commands usually start with "*" and the keyword of the command is usually 3-character long. Command List: *CLS *ESE *ESR? *IDN? *OPC *RST *SRE *STB? *TST? *WAI *CLS Syntax Description *CLS Clear all the event registers and clear the error queue.
RIGOL Chapter 2 Command System *ESR? Syntax *ESR? Description Query and clear the event register for the standard event status register. Explanation The bit 1 and bit 6 of the standard event status register are not used and are always treated as 0. The range of the return value are the decimal numbers corresponding to the binary numbers X0XXXX0X (X is 1 or 0). Return Format The query returns an integer which equals the sum of the weights of all the bits in the register.
RIGOL Chapter 2 Command System *SRE Syntax *SRE *SRE? Description Parameter Explanation Return Format Example Set or query the enable register for the status byte register set. Name Type Range Default Integer 0 to 255 0 The bit 0 and bit 1 of the status byte register are not used and are always treated as 0; therefore, the range of are the decimal numbers corresponding to the binary numbers XXXXXX00 (X is 1 or 0).
RIGOL Chapter 2 Command System :LAN Commands Command List: :LAN:DHCP :LAN:AUToip :LAN:GATeway :LAN:DNS :LAN:MAC? :LAN:MANual :LAN:INITiate :LAN:IPADdress :LAN:SMASk :LAN:STATus? :LAN:VISA? :LAN:APPLy :LAN:DHCP Syntax :LAN:DHCP :LAN:DHCP? Description Parameter Explanation Return Format Example Turns on or off the DHCP configuration mode; or queries the on/off status of the current DHCP configuration mode.
RIGOL Chapter 2 Command System Explanation Return Format Example When the three IP configuration types (DHCP, Auto IP, and Static IP) are all turned on, the priority of the parameter configuration from high to low is "DHCP", "Auto IP", and "Static IP". The three IP configuration types cannot be all turned off at the same time. When the auto IP mode is valid, disable DHCP manually. You can self-define the gateway and DNS address for the oscilloscope.
RIGOL Chapter 2 Command System Example :LAN:DNS 192.168.1.1 :LAN:DNS? /*Sets the DNS address to 192.168.1.1.*/ /*The query returns the current DNS address.*/ :LAN:MAC? Syntax Description Return Format :LAN:MAC? Queries the MAC address of the instrument. The address format displayed on the oscilloscope is as follows: 00-19-AF-30-00-00. The query returns the MAC address in strings. For example, 0019af300000.
RIGOL Chapter 2 Command System :LAN:IPADdress Syntax :LAN:IPADdress :LAN:IPADdress? Description Parameter Explanation Return Format Example Sets or queries the IP address of the instrument. Name Type Range Default ASCII String Refer to Explanation —— The format of is nnn,nnn,nnn,nnn. The range of the first section of "nnn" is from 0 to 223 (except 127), and the ranges of the other three sections of "nnn" are from 0 to 255.
RIGOL Chapter 2 Command System :LAN:VISA? Syntax Description Return Format :LAN:VISA? Queries the VISA address of the instrument. The query returns the VISA address in strings. For example, TCPIP::172.16.3.119::INSTR. :LAN:APPLy Syntax Description 2-78 :LAN:APPLy Applies the network configuration.
Chapter 2 Command System RIGOL :MATH Commands The :MATH commands are used to set the operations between the waveforms of multiple channels.
RIGOL Chapter 2 Command System :MATH:FILTer:TYPE :MATH:FILTer:W1 :MATH:FILTer:W2 :MATH:OPTion:STARt :MATH:OPTion:END :MATH:OPTion:INVert :MATH:OPTion:SENSitivity :MATH:OPTion:DIStance :MATH:OPTion:ASCale :MATH:OPTion:THReshold1 :MATH:OPTion:THReshold2 :MATH:OPTion:FX:SOURce1 :MATH:OPTion:FX:SOURce2 :MATH:OPTion:FX:OPERator :MATH:DISPlay Syntax :MATH:DISPlay :MATH:DISPlay? Description Parameter Return Format Example Enable or disable the mat
RIGOL Chapter 2 Command System :MATH:SOURce1 Syntax :MATH:SOURce1 :MATH:SOURce1? Description Parameter Explanation Set or query the source or source A of algebraic operation/functional operation/the outer layer operation of compound operation. Name Type Range Default Discrete {CHANnel1|CHANnel2|FX} CHANnel1 For algebraic operations, this command is used to set source A. For functional operations, only this command is used to set the source.
RIGOL Chapter 2 Command System Example :MATH:SOURce2 CHANnel2 :MATH:SOURce2? /*Set source B of algebraic operation to CH2*/ /*The query returns CHAN2*/ :MATH:LSOUrce1 Syntax :MATH:LSOUrce1 :MATH:LSOUrce1? Description Parameter Explanation Return Format Example Set or query source A of logic operation. Name Type Range Default Discrete {CHANnel1|CHANnel2} CHANnel1 The logic operations include A&&B, A||B, A^B, and !A. The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System Explanation Return Format Example Related Commands The range of the vertical scale is related to the operator currently selected and the vertical scale of the source channel. For the integration (intg) and differential (diff) operations, it is also related to the current horizontal timebase. The query returns the vertical scale of the operation result in scientific notation. :MATH:SCALe 2 :MATH:SCALe? /*Set the vertical scale to 2V*/ /*The query returns 2.
RIGOL Chapter 2 Command System Example Related Command :MATH:INVert ON :MATH:INVert? /*Enable the inverted display mode*/ /*The query returns 1*/ :MATH:OPERator :MATH:RESet Syntax :MATH:RESet Description Sending this command, the instrument adjusts the vertical scale of the operation result to the most proper value according to the current operator and the horizontal timebase of the source.
RIGOL Chapter 2 Command System Example :MATH:FFT:WINDow BLACkman :MATH:FFT:WINDow? Related Command /*Set the window function of the FFT operation to blackman*/ /* The query returns BLACK*/ :MATH:OPERator :MATH:FFT:SPLit Syntax :MATH:FFT:SPLit :MATH:FFT:SPLit? Description Parameter Explanation Return Format Example Related Command Enable or disable the half-screen display mode of the FFT operation, or query the status of the half display mode of the FFT operation.
RIGOL Chapter 2 Command System :MATH:FFT:HSCale Syntax :MATH:FFT:HSCale :MATH:FFT:HSCale? Description Parameter Explanation Return Format Example Set or query the horizontal scale of the FFT operation result. The default unit is Hz. Name Type Range Default Real Refer to Explanation 5MHz can be set to 1/1000, 1/400, 1/200, 1/100, 1/40, or 1/20 of the FFT sample rate.
RIGOL Chapter 2 Command System :MATH:FFT:MODE :TIMebase[:MAIN]:SCALe :MATH:FFT:HSCale :MATH:FFT:MODE Syntax :MATH:FFT:MODE :MATH:FFT:MODE? Description Parameter Explanation Return Format Example Set or query the FFT mode. Name Type Range Default Discrete {TRACe|MEMory} TRACe TRACe: denotes that the data source of the FFT operation is the data of the waveform displayed on the screen.
RIGOL Chapter 2 Command System Example Related Commands :MATH:FILTer:TYPE LPASs :MATH:FILTer:TYPE? /*Set the filter type to low pass*/ /*The query returns LPAS*/ :MATH:FILTer:W1 :MATH:FILTer:W2 :MATH:FILTer:W1 Syntax :MATH:FILTer:W1 :MATH:FILTer:W1? Description Parameter Set or query the cutoff frequency (ωc1) of the low pass/high pass filter or cutoff frequency 1 (ωc1) of the band pass/band stop filter. The default unit is Hz.
RIGOL Chapter 2 Command System Explanation Return Format Example When the type of the filter is set to BPASs (band pass) or BSTOP (band stop), you need to set two cutoff frequencies. Send the :MATH:FILTer:W1 command to set cutoff frequency 1 (ωc1); and send this command to set cutoff frequency 2 (ωc2). At this time, the range of is from (0.01 x screen sample rate) to (0.1 x screen sample rate), with a step of (0.005 x screen sample rate). Wherein, Screen Sample Rate = 100/Horizontal Timebase.
RIGOL Chapter 2 Command System Return Format Example Related Command The query returns an integer. :MATH:OPTion:END 200 :MATH:OPTion:END? /*Set the waveform end point to 200*/ /*The query returns 200*/ :MATH:OPTion:STARt :MATH:OPTion:INVert Syntax :MATH:OPTion:INVert :MATH:OPTion:INVert? Description Parameter Explanation Enable or disable the inverted display mode of the operation result, or query the inverted display mode status of the operation result.
RIGOL Chapter 2 Command System :MATH:OPTion:DIStance Syntax :MATH:OPTion:DIStance :MATH:OPTion:DIStance? Description Parameter Explanation Return Format Example Related Command Set or query the smoothing window width of differential operation (diff). Name Type Range Default Integer 3 to 201 3 This command is only applicable to differential operation (diff). The query returns an integer between 3 and 201.
RIGOL Chapter 2 Command System Return Format Example VerticalScale refers to the vertical scale of source A VeticalOffset refers to the vertical offset of source A The step is VerticalScale/50 The query returns the threshold level in scientific notation. :MATH:OPTion:THReshold1 0.8 :MATH:OPTion:THReshold1? Related Commands /*Set the the threshold level of source A in logic operations to 800mV*/ /*The query returns 8.
RIGOL Chapter 2 Command System Example :MATH:OPTion:FX:SOURce1 CHANnel1 :MATH:OPTion:FX:SOURce1? /*Set source A of the inner layer operation of compound operation to CH1*/ /*The query returns CHAN1*/ :MATH:OPTion:FX:SOURce2 Syntax :MATH:OPTion:FX:SOURce2 :MATH:OPTion:FX:SOURce2? Description Parameter Return Format Example Set or query source B of the inner layer operation of compound operation.
RIGOL Chapter 2 Command System :MASK Commands The :MASK commands are used to set and query the pass/fail test parameters.
RIGOL Chapter 2 Command System Explanation Return Format Example Only channels enabled can be selected as the source. You can send the :CHANnel:DISPlay command to enable the desired channel. The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System :MASK:SOOutput Syntax :MASK:SOOutput :MASK:SOOutput? Description Parameter Explanation Return Format Example Turn the "Stop on Fail" function on or off, or query the status of the "Stop on Fail" function. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF ON: when failed waveforms are detected, the oscilloscope will stop the test and enter the "STOP" state.
RIGOL Chapter 2 Command System :MASK:X Syntax :MASK:X :MASK:X? Description Parameter Return Format Example Set or query the horizontal adjustment parameter in the pass/fail test mask. The default unit is div. Name Type Range Default Real 0.02 to 4, the step is 0.02 within the range 0.02 The query returns the horizontal adjustment parameter in scientific notation. :MASK:X 0.28 :MASK:X? /*Set the horizontal adjustment parameter to 0.28div*/ /*The query returns 2.
RIGOL Chapter 2 Command System :MASK:FAILed? Syntax Description Return Format :MASK:FAILed? Query the number of failed frames in the pass/fail test. The query returns an integer. :MASK:TOTal? Syntax Description Return Format :MASK:TOTal? Query the total number of frames in the pass/fail test. The query returns an integer. :MASK:RESet Syntax :MASK:RESet Description Reset the numbers of passed frames and failed frames as well as the total number of frames in the pass/fail test to 0.
RIGOL Chapter 2 Command System :MEASure Commands DS1000Z-E supports the auto measurement of the following 37 waveform parameters and provides the statistic function for the measurement results. In additional, you can use the frequency counter to make more precise frequency measurement. The :MEASure commands are used to set and query the measurement parameters. 1. Time Parameters Period: Defined as the time between the threshold middle points of two consecutive, like-polarity edges.
RIGOL Chapter 2 Command System -Pulses: The number of negative pulses that fall from above the threshold upper limit to below the threshold lower limit. -Pulses=n Threshold Upper Limit 1 +Edges: 2 Threshold Lower Limit n The number of rising edges that rise from below the threshold lower limit to above the threshold upper limit.
RIGOL Chapter 2 Command System 4. Voltage Parameters Vmax: The voltage value from the highest point of the waveform to the GND. Vmin: The voltage value from the lowest point of the waveform to the GND. Vpp: The voltage value from the highest point to the lowest point of the waveform. Vtop: The voltage value from the flat top of the waveform to the GND. Vbase: The voltage value from the flat base of the waveform to the GND. Vamp: The voltage value from the top of the waveform to the base of the waveform.
RIGOL 5. Chapter 2 Command System Other Parameters +Rate: Divide the difference of the upper value and lower value on the rising edge by the corresponding time. -Rate: Divide the difference of the lower value and upper value on the falling edge by the corresponding time. Area: The area of the whole waveform within the screen and the unit is voltage-second. The area meadured above the zero reference (namely the vertical offset) is positive and the area measured below the zero reference is negative.
RIGOL Chapter 2 Command System :MEASure:SOURce Syntax :MEASure:SOURce :MEASure:SOURce? Description Parameter Explanation Return Format Example Related Command Set or query the source of the current measurement parameter. Name Type Range Default Discrete {CHANnel1|CHANnel2|MATH} CHANnel1 Analog channels (CH1 and CH2) can be selected no matter wether they are currently turned on. This command is used to set the source for the measurement parameters (except delay and phase).
RIGOL Chapter 2 Command System :MEASure:CLEar Syntax Description Parameter Explanation Example :MEASure:CLEar - Clear one or all of the last five measurement items enabled. Name Type Range Default
- Discrete {ITEM1|ITEM2|ITEM3|ITEM4|ITEM5|ALL} -- You can use the :MEASure:ITEM command to enable the desired parameters of the 37 waveform parameters.
RIGOL Chapter 2 Command System Format Example :MEASure:ADISplay ON :MEASure:ADISplay? /*Enable the all measurement function*/ /*The query returns 1*/ :MEASure:AMSource Syntax :MEASure:AMSource [,[,[,]]] :MEASure:AMSource? Description Parameter Return Format Example Set or query the source(s) of the all measurement function. Name Type Range Default Discrete {CHANnel1|CHANnel2|MATH} CHANnel1 The query returns CHAN1, CHAN2, or MATH.
RIGOL Chapter 2 Command System :MEASure:SETup:MID Syntax :MEASure:SETup:MID :MEASure:SETup:MID? Description Parameter Explanation Return Format Example Related Commands Set or query the middle point of the threshold (expressed in the percentage of amplitude) in time, delay, and phase measurements.
RIGOL Chapter 2 Command System :MEASure:SETup:PSA Syntax :MEASure:SETup:PSA :MEASure:SETup:PSA? Description Parameter Return Format Example Related Command Set or query source A of Phase 1→2 and Phase 1→2 measurements. Name Type Range Default Discrete {CHANnel1|CHANnel2} CHANnel1 The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System :MEASure:SETup:DSB Syntax :MEASure:SETup:DSB :MEASure:SETup:DSB? Description Parameter Return Format Example Related Command Set or query source B of Delay 1→2 and Delay 1→2 measurements. Name Type Range Default Discrete {CHANnel1|CHANnel2} CHANnel2 The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System Return Format Example Related Commands Sending the :MEASure:STATistic:DISPlay command can enable the statistic function. When the statistic function is enabled, the oscilloscope makes statistic and displays the statistic results of at most 5 measurement items that are turned on last. The query returns DIFF or EXTR.
RIGOL Chapter 2 Command System and :MEASure:SETup:PSB commands by default. Return Format Example The query returns the statistic result in scientific notation. :MEASure:STATistic:ITEM VPP,CHANnel2 /*Enable the Vpp statistic function of CH2*/ :MEASure:STATistic:ITEM? MAXimum,VPP /*The query returns 9.
RIGOL Chapter 2 Command System :REFerence Commands The :REFerence commands are used to set the reference waveform parameters.
RIGOL Chapter 2 Command System :REFerence:SOURce Syntax :REFerence:SOURce :REFerence:SOURce? Description Parameter Explanation Return Format Example Set or query the source of the current reference channel. Name Type Range Default Discrete {1|2|3|4|5|6|7|8|9|10} -- Discrete {CHANnel1|CHANnel2|MATH} CHANnel1 Only channels currently enabled can be selected as the source of the current reference channel. The query returns CHAN1, CHAN2, or MATH.
RIGOL Chapter 2 Command System :REFerence:VOFFset Syntax :REFerence:VOFFset :REFerence:VOFFset? Description Parameter Explanation Return Format Example Set or query the vertical offset of the specified reference channel. The unit is the same as the unit of the source. Name Type Range Default Discrete {1|2|3|4|5|6|7|8|9|10} -- Real (-10 x RefVerticalScale) to (10 x RefVerticalScale) 0 RefVerticalScale refers to the vertical scale of the reference channel.
RIGOL Chapter 2 Command System :REFerence:SAVe Syntax Description Parameter Related Command :REFerence:SAVe Store the waveform of the current reference channel to the internal memory as reference waveform. Name Type Range Default Discrete {1|2|3|4|5|6|7|8|9|10} -- :REFerence:CURRent :REFerence:COLor Syntax :REFerence:COLor :REFerence:COLor? Description Parameter Return Format Example Set or query the display color of the current reference channel.
RIGOL Chapter 2 Command System :STORage Commands The :STORage commands are used to set the related parameters when storing images. Command List: :STORage:IMAGe:TYPE :STORage:IMAGe:INVERT :STORage:IMAGe:COLor :STORage:IMAGe:TYPE Syntax :STORage:IMAGe:TYPE :STORage:IMAGe:TYPE? Description Parameter Return Format Example Set or query the image type when storing images.
RIGOL Chapter 2 Command System :STORage:IMAGe:COLor Syntax :STORage:IMAGe:COLor :STORage:IMAGe:COLor? Description Parameter Return Format Example 2-116 Set the image color when storing images to color (ON) or intensity graded color (OFF); or query the image color when storing images. Name Type Range Default Bool {ON|OFF} ON The query returns ON or OFF.
RIGOL Chapter 2 Command System :SYSTem Commands The :SYSTem commands are used to set the system-related parameters, such as the sound and language.
RIGOL Chapter 2 Command System :SYSTem:BEEPer Syntax :SYSTem:BEEPer :SYSTem:BEEPer? Description Parameter Return Format Example Enable or disable the beeper, or query the status of the beeper. Name Type Range Default Bool {{1|ON}|{0|OFF}} -- The query returns 1 or 0. :SYSTem:BEEPer ON :SYSTem:BEEPer? /*Enable the beeper*/ /*The query returns 1*/ :SYSTem:ERRor[:NEXT]? Syntax Description Return Format :SYSTem:ERRor[:NEXT]? Query and delete the last system error message.
RIGOL Chapter 2 Command System :SYSTem:LOCKed Syntax :SYSTem:LOCKed :SYSTem:LOCKed? Description Parameter Return Format Enable or disable the keyboard lock function, or query the status of the keyboard lock function. Name Type Range Default Bool {{1|ON}|{0|OFF}} 0|OFF The query returns 1 or 0.
RIGOL Chapter 2 Command System :SYSTem:OPTion:UNINSTall Syntax Description :SYSTem:OPTion:UNINSTall Uninstall the options installed. :SYSTem:RAM? Syntax Description Return Format :SYSTem:RAM? Query the number of analog channels of the instrument. The query always returns 2. :SYSTem:SETup Syntax :SYSTem:SETup :SYSTem:SETup? Description Import the setting parameters of the oscilloscope to restore the oscilloscope to the specified setting. Query the setting of the oscilloscope.
RIGOL Chapter 2 Command System :TIMebase Commands The :TIMebase commands are used to set the horizontal parameters, such as enabling the delayed sweep and setting the horizontal timebase mode.
RIGOL Chapter 2 Command System Related Commands :TIMebase[:MAIN]:SCALe :TIMebase[:MAIN]:OFFSet :TIMebase:DELay:SCALe :TIMebase:DELay:SCALe Syntax :TIMebase:DELay:SCALe :TIMebase:DELay:SCALe? Description Parameter Explanation Return Format Example 2-122 Set or query the delayed timebase scale. The default unit is s/div.
RIGOL Chapter 2 Command System Related Commands :TIMebase[:MAIN]:SCALe :ACQuire:SRATe? :TRIGger:MODE :TIMebase[:MAIN]:OFFSet Syntax :TIMebase[:MAIN]:OFFSet :TIMebase[:MAIN]:OFFSet? Description Parameter Explanation Return Format Example Related Commands Set or query the main timebase offset. The default unit is s.
RIGOL Chapter 2 Command System :TIMebase[:MAIN]:SCALe Syntax :TIMebase[:MAIN]:SCALe :TIMebase[:MAIN]:SCALe? Description Set or query the main timebase scale. The default unit is s/div.
RIGOL Chapter 2 Command System :TRIGger Commands The :TRIGger commands are used to set the trigger system of the oscilloscope.
RIGOL Chapter 2 Command System :TRIGger:COUPling Syntax :TRIGger:COUPling :TRIGger:COUPling? Description Parameter Explanation Return Format Example Select or query the trigger coupling type. Name Type Range Default Discrete {AC|DC|LFReject|HFReject} DC This command is only applicable to edge trigger of which the signal source is an analog channel. AC: block all the DC components and attenuate signals lower than 75 kHz.
RIGOL Chapter 2 Command System :TRIGger:HOLDoff Syntax :TRIGger:HOLDoff :TRIGger:HOLDoff? Description Parameter Explanation Return Format Example Set or query the trigger holdoff time. The default unit is s. Name Type Range Default Real 16ns to 10s 16ns Trigger holdoff can be used to stably trigger the complex waveforms (such as pulse series). Holdoff time is the time that the oscilloscope waits before re-arming the trigger circuitry.
RIGOL Chapter 2 Command System :TRIGger:EDGe Command List: :TRIGger:EDGe:SOURce :TRIGger:EDGe:SLOPe :TRIGger:EDGe:LEVel :TRIGger:EDGe:SOURce Syntax :TRIGger:EDGe:SOURce :TRIGger:EDGe:SOURce? Description Parameter Return Format Example Set or query the trigger source in edge trigger. Name Type Range Default Discrete {CHANnel1|CHANnel2|AC} CHANnel1 The query returns CHAN1, CHAN2, or AC.
RIGOL Chapter 2 Command System :TRIGger:EDGe:LEVel Syntax :TRIGger:EDGe:LEVel :TRIGger:EDGe:LEVel? Description Parameter Explanation Return Format Example Set or query the trigger level in edge trigger. The unit is the same as the current amplitude unit of the signal source selected. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0 For VerticalScale, refer to the :CHANnel:SCALe command.
RIGOL Chapter 2 Command System :TRIGger:PULSe Command List: :TRIGger:PULSe:SOURce :TRIGger:PULSe:WHEN :TRIGger:PULSe:WIDTh :TRIGger:PULSe:UWIDth :TRIGger:PULSe:LWIDth :TRIGger:PULSe:LEVel :TRIGger:PULSe:SOURce Syntax :TRIGger:PULSe:SOURce :TRIGger:PULSe:SOURce? Description Parameter Return Format Example Set or query the trigger source in pulse width trigger.
RIGOL Chapter 2 Command System :TRIGger:PULSe:WIDTh Syntax :TRIGger:PULSe:WIDTh :TRIGger:PULSe:WIDTh? Description Parameter Explanation Return Format Example Set or query the pulse width in pulse width trigger. The default unit is s. Name Type Range Default Real 8ns to 10s PGReater, NGReater: 1μs PLESs, NLESs: 2μs This command is available when the trigger condition (refer to :TRIGger:PULSe:WHEN) is PGReater, PLESs, NGReater, and NLESs.
RIGOL Chapter 2 Command System :TRIGger:PULSe:LEVel Syntax :TRIGger:PULSe:LEVel :TRIGger:PULSe:LEVel? Description Parameter Explanation Return Format Example 2-132 Set or query the trigger level in pulse width trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0 For VerticalScale, refer to the :CHANnel:SCALe command. For OFFSet, refer to the :CHANnel:OFFSet command.
RIGOL Chapter 2 Command System :TRIGger:SLOPe Command List: :TRIGger:SLOPe:SOURce :TRIGger:SLOPe:WHEN :TRIGger:SLOPe:TIME :TRIGger:SLOPe:TUPPer :TRIGger:SLOPe:TLOWer :TRIGger:SLOPe:WINDow :TRIGger:SLOPe:ALEVel :TRIGger:SLOPe:BLEVel :TRIGger:SLOPe:SOURce Syntax :TRIGger:SLOPe:SOURce :TRIGger:SLOPe:SOURce? Description Parameter Return Format Example Set or query the trigger source in slope trigger.
RIGOL Chapter 2 Command System Format Example :TRIGger:SLOPe:WHEN NLESs :TRIGger:SLOPe:WHEN? /*Set the trigger condition to NLESs*/ /*The query returns NLES*/ :TRIGger:SLOPe:TIME Syntax :TRIGger:SLOPe:TIME
RIGOL Chapter 2 Command System Return Format Example Related Command The query returns the lower limit of the time in scientific notation. :TRIGger:SLOPe:TLOWer 0.000000020 :TRIGger:SLOPe:TLOWer? /*Set the lower limit of the time to 20ns*/ /*The query returns 2.000000e-08*/ :TRIGger:SLOPe:TUPPer :TRIGger:SLOPe:WINDow Syntax :TRIGger:SLOPe:WINDow :TRIGger:SLOPe:WINDow? Description Parameter Explanation Return Format Example Set or query the vertical window type in slope trigger.
RIGOL Chapter 2 Command System :TRIGger:SLOPe:BLEVel Syntax :TRIGger:SLOPe:BLEVel :TRIGger:SLOPe:BLEVel? Description Parameter Explanation Return Format Example Related Command 2-136 Set or query the lower limit of the trigger level in slope trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0 For VerticalScale, refer to :CHANnel:SCALe.
RIGOL Chapter 2 Command System :TRIGger:VIDeo Command List: :TRIGger:VIDeo:SOURce :TRIGger:VIDeo:POLarity :TRIGger:VIDeo:MODE :TRIGger:VIDeo:LINE :TRIGger:VIDeo:STANdard :TRIGger:VIDeo:LEVel :TRIGger:VIDeo:SOURce Syntax :TRIGger:VIDeo:SOURce :TRIGger:VIDeo:SOURce? Description Parameter Return Format Example Select or query the trigger source in video trigger.
RIGOL Chapter 2 Command System Return Format Example Related Commands EVENfield: trigger on the rising edge of the first ramp waveform pulse in the even field. This type is available when the video standard is NTSC or PAL/SECAM. LINE: for the NTSC and PAL/SECAM video standards, trigger on the specified line in the odd or even field; for the 480P and 576P video standards, trigger on the specified line. ALINes: trigger on all the horizontal sync pulses.
RIGOL Chapter 2 Command System frames per second. The TV sweep line is 525 with the even field goes first and the odd field follows behind. Return Format Example Related Commands 480P: the frame frequency is 60 frames per second; the TV sweep line is 525; line-by-line sweep; the line frequency is 31.5 kHz. 576P: the frame frequency is 60 frames per second; the TV sweep line is 625; line-by-line sweep. The query returns PALS, NTSC, 480P, or 576P.
RIGOL Chapter 2 Command System :TRIGger:PATTern Command List: :TRIGger:PATTern:PATTern :TRIGger:PATTern:LEVel :TRIGger:PATTern:PATTern Syntax :TRIGger:PATTern:PATTern [,] :TRIGger:PATTern:PATTern? Description Parameter Explanation Return Format Example 2-140 Set or query the pattern of each channel in pattern trigger.
RIGOL Chapter 2 Command System :TRIGger:PATTern:LEVel Syntax :TRIGger:PATTern:LEVel , :TRIGger:PATTern:LEVel? Description Parameter Explanation Return Format Example Set or query the trigger level of the specified channel in pattern trigger. The unit is the same as the current amplitude unit.
RIGOL Chapter 2 Command System :TRIGger:DURATion Command List: :TRIGger:DURATion:SOURce :TRIGger:DURATion:TYPe :TRIGger:DURATion:WHEN :TRIGger:DURATion:TUPPer :TRIGger:DURATion:TLOWer :TRIGger:DURATion:SOURce Syntax :TRIGger:DURATion:SOURce :TRIGger:DURATion:SOURce? Description Parameter Return Format Example Set or query the trigger source in duration trigger. Name Type Range Default Discrete {CHANnel1|CHANnel2} CHANnel1 The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System Example :TRIGger:DURATion:TYPe L,X,H,L :TRIGger:DURATion:TYPe? /*Set the pattern of CH1 to L. The pattern of CH2 remains unchanged*/ /*The query returns L,X */ :TRIGger:DURATion:WHEN Syntax :TRIGger:DURATion:WHEN :TRIGger:DURATion:WHEN? Description Parameter Explanation Return Format Example Set or query the trigger condition in duration trigger.
RIGOL Chapter 2 Command System :TRIGger:DURATion:TLOWer Syntax :TRIGger:DURATion:TLOWer :TRIGger:DURATion:TLOWer? Description Parameter Explanation Return Format Example Related Command 2-144 Set or query the duration time lower limit in duration trigger. The default unit is s. Name Type Range Default Real 8ns to 9.99s 1μs This command is available when the trigger condition (:TRIGger:DURATion:WHEN) is GREater or GLESs.
RIGOL Chapter 2 Command System :TRIGger:TIMeout Command List: :TRIGger:TIMeout:SOURce :TRIGger:TIMeout:SLOPe :TRIGger:TIMeout:TIMe :TRIGger:TIMeout:SOURce Syntax :TRIGger:TIMeout:SOURce :TRIGger:TIMeout:SOURce? Description Parameter Return Format Example Set or query the trigger source in timeout trigger. Name Type Range Default Discrete {CHANnel1|CHANnel2} CHANnel1 The query returns CHAN1 or CHAN2.
RIGOL Return Format Example 2-146 Chapter 2 Command System The query returns the timeout time in scientific notation. :TRIGger:TIMeout:TIMe 0.002 :TRIGger:TIMeout:TIMe? /*Set the timeout time to 2ms*/ /*The query returns 2.
RIGOL Chapter 2 Command System :TRIGger:RUNT Command List: :TRIGger:RUNT:SOURce :TRIGger:RUNT:POLarity :TRIGger:RUNT:WHEN :TRIGger:RUNT:WUPPer :TRIGger:RUNT:WLOWer :TRIGger:RUNT:ALEVel :TRIGger:RUNT:BLEVel :TRIGger:RUNT:SOURce Syntax :TRIGger:RUNT:SOURce :TRIGger:RUNT:SOURce? Description Parameter Return Format Example Set or query the trigger source in runt trigger.
RIGOL Chapter 2 Command System :TRIGger:RUNT:WHEN Syntax :TRIGger:RUNT:WHEN :TRIGger:RUNT:WHEN? Description Parameter Explanation Return Format Example Set or query the qualifier in runt trigger. Name Type Range Default Discrete {NONE|GREater|LESS|GLESs} NONE NONE: do not set the trigger condition in runt trigger. GREater: trigger when the runt pulse width is greater than the lower limit of the pulse width (refer to :TRIGger:RUNT:WLOWer).
RIGOL Chapter 2 Command System :TRIGger:RUNT:WLOWer Syntax :TRIGger:RUNT:WLOWer :TRIGger:RUNT:WLOWer? Description Parameter Explanation Return Format Example Set or query the pulse width lower limit in runt trigger. The default unit is s. Name Type Range Default Real When the qualifier is GREater, the range is from 8ns to 10s; when the qualifier is GLESs, the range is from 8ns to 9.99s.
RIGOL Chapter 2 Command System :TRIGger:RUNT:BLEVel Syntax :TRIGger:RUNT:BLEVel :TRIGger:RUNT:BLEVel? Description Parameter Explanation Return Format Example 2-150 Set or query the trigger level lower limit in runt trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0 For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
RIGOL Chapter 2 Command System :TRIGger:WINDows Command List: :TRIGger:WINDows:SOURce :TRIGger:WINDows:SLOPe :TRIGger:WINDows:POSition :TRIGger:WINDows:TIMe :TRIGger:WINDows:ALEVel :TRIGger:WINDows:BLEVel :TRIGger:WINDows:SOURce Syntax :TRIGger:WINDows:SOURce :TRIGger:WINDows:SOURce? Description Parameter Return Format Example Set or query the trigger source in windows trigger.
RIGOL Chapter 2 Command System :TRIGger:WINDows:POSition Syntax :TRIGger:WINDows:POSition :TRIGger:WINDows:POSition? Description Parameter Explanation Return Format Example Set or query the trigger position in windows trigger. Name Type Range Default Discrete {EXIT|ENTER|TIMe} ENTER EXIT: trigger when the input signal exits the specified trigger level range. ENTER: trigger when the trigger signal enters the specified trigger level range.
RIGOL Chapter 2 Command System :TRIGger:WINDows:ALEVel Syntax :TRIGger:WINDows:ALEVel :TRIGger:WINDows:ALEVel? Description Parameter Explanation Return Format Example Set or query the trigger level upper limit in windows trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 2V For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
RIGOL Chapter 2 Command System :TRIGger:DELay Command List: :TRIGger:DELay:SA :TRIGger:DELay:SLOPA :TRIGger:DELay:SB :TRIGger:DELay:SLOPB :TRIGger:DELay:TYPe :TRIGger:DELay:TUPPer :TRIGger:DELay:TLOWer :TRIGger:DELay:SA Syntax :TRIGger:DELay:SA :TRIGger:DELay:SA? Description Parameter Return Format Example Set or query the trigger source A in delay trigger.
RIGOL Chapter 2 Command System :TRIGger:DELay:SB Syntax :TRIGger:DELay:SB :TRIGger:DELay:SB? Description Parameter Return Format Example Set or query the trigger source B in delay trigger. Name Type Range Default Discrete {CHANnel1|CHANnel2} CHANnel2 The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System :TRIGger:DELay:TYPe Syntax :TRIGger:DELay:TYPe :TRIGger:DELay:TYPe? Description Parameter Explanation Return Format Example Related Commands Set or query the delay type in delay trigger. Name Type Range Default Discrete {GREater|LESS|GLESs |GOUT} GREater GREater: trigger when the time difference (△T) between the specified edges of tigger source A and tigger source B is greater than the preset time limit.
RIGOL Chapter 2 Command System :TRIGger:DELay:TLOWer Syntax :TRIGger:DELay:TLOWer :TRIGger:DELay:TLOWer? Description Parameter Explanation Return Format Example Related Command Set or query the lower limit of the delay time in delay trigger. The default unit is s. Name Type Range Default Real Related to the delay type GREater: 8ns to 10s GOUT or GLESs: 8ns to 9.99s 1μs This command is only available when the delay type (refer to :TRIGger:DELay:TYPe) is GREater, GOUT, or GLESs.
RIGOL Chapter 2 Command System :TRIGger:SHOLd Command List: :TRIGger:SHOLd:DSrc :TRIGger:SHOLd:CSrc :TRIGger:SHOLd:SLOPe :TRIGger:SHOLd:PATTern :TRIGger:SHOLd:TYPe :TRIGger:SHOLd:STIMe :TRIGger:SHOLd:HTIMe :TRIGger:SHOLd:DSrc Syntax :TRIGger:SHOLd:DSrc :TRIGger:SHOLd:DSrc? Description Parameter Return Format Example Set or query the data source in setup/hold trigger.
RIGOL Chapter 2 Command System :TRIGger:SHOLd:SLOPe Syntax :TRIGger:SHOLd:SLOPe :TRIGger:SHOLd:SLOPe? Description Parameter Return Format Example Set or query the edge type in setup/hold trigger. Name Type Range Default Discrete {POSitive|NEGative} POSitive The query returns POS or NEG.
RIGOL Chapter 2 Command System :TRIGger:SHOLd:STIMe Syntax :TRIGger:SHOLd:STIMe :TRIGger:SHOLd:STIMe? Description Parameter Explanation Return Format Example Related Command Set or query the setup time in setup/hold trigger. The default unit is s. Name Type Range Default Real 8ns to 1s 1μs Setup time refers to the period of time that the data stays stable and constant before the clock signal of the trigger appears.
RIGOL Chapter 2 Command System :TRIGger:NEDGe Command List: :TRIGger:NEDGe:SOURce :TRIGger:NEDGe:SLOPe :TRIGger:NEDGe:IDLE :TRIGger:NEDGe:EDGE :TRIGger:NEDGe:LEVel :TRIGger:NEDGe:SOURce Syntax :TRIGger:NEDGe:SOURce :TRIGger:NEDGe:SOURce? Description Parameter Set or query the trigger source in Nth edge trigger. Name Type Range Default Discrete {CHANnel1|CHANnel2} CHANnel1 Return Format The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System :TRIGger:NEDGe:IDLE Syntax :TRIGger:NEDGe:IDLE :TRIGger:NEDGe:IDLE? Description Parameter Return Format Example Set or query the idle time in Nth edge trigger. The default unit is s. Name Type Range Default Real 16ns to 10s 1μs The query returns the idle time in scientific notation. :TRIGger:NEDGe:IDLE 0.002 :TRIGger:NEDGe:IDLE? /*Set the idle time to 2ms*/ /*The query returns 2.
RIGOL Chapter 2 Command System :TRIGger:RS232 Command List: :TRIGger:RS232:SOURce :TRIGger:RS232:WHEN :TRIGger:RS232:PARity :TRIGger:RS232:STOP :TRIGger:RS232:DATA :TRIGger:RS232:WIDTh :TRIGger:RS232:BAUD :TRIGger:RS232:BUSer :TRIGger:RS232:LEVel :TRIGger:RS232:SOURce Syntax :TRIGger:RS232:SOURce :TRIGger:RS232:SOURce? Description Set or query the trigger source in RS232 trigger.
RIGOL Chapter 2 Command System :TRIGger:RS232:PARity Syntax :TRIGger:RS232:PARity :TRIGger:RS232:PARity? Description Parameter Explanation Return Format Example Related Command Set or query the parity type when the trigger condition is ERRor or PARity in RS232 trigger. Name Type Range Default Discrete {EVEN|ODD|NONE} Error Frame: NONE Check Error: ODD When the trigger condition is PARity, the parity type cannot be set to NONE. At this point, the default parity type is ODD.
RIGOL Chapter 2 Command System :TRIGger:RS232:WIDTh Syntax :TRIGger:RS232:WIDTh :TRIGger:RS232:WIDTh? Description Parameter Return Format Example Related Command Set or query the data bits when the trigger condition is DATA in RS232 trigger. Name Type Range Default Discrete {5|6|7|8} 8 The query returns 5, 6, 7, or 8.
RIGOL Chapter 2 Command System :TRIGger:RS232:LEVel Syntax :TRIGger:RS232:LEVel :TRIGger:RS232:LEVel? Description Parameter Explanation Return Format Example 2-166 Set or query the trigger level in RS232 trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0 For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
RIGOL Chapter 2 Command System :TRIGger:IIC Command List: :TRIGger:IIC:SCL :TRIGger:IIC:SDA :TRIGger:IIC:WHEN :TRIGger:IIC:AWIDth :TRIGger:IIC:ADDRess :TRIGger:IIC:DIRection :TRIGger:IIC:DATA :TRIGger:IIC:CLEVel :TRIGger:IIC:DLEVel :TRIGger:IIC:SCL Syntax :TRIGger:IIC:SCL :TRIGger:IIC:SCL? Description Parameter Return Format Example Set or query the channel source of SCL in I2C trigger.
RIGOL Chapter 2 Command System :TRIGger:IIC:WHEN Syntax :TRIGger:IIC:WHEN :TRIGger:IIC:WHEN? Description Parameter Explanation Return Format Example Set or query the trigger condition in I2C trigger. Name Type Range Default Discrete {STARt|RESTart|STOP|NACKnowledge| ADDRess|DATA|ADATa} STARt STARt: trigger when the SDA data transitions from high to low while the SCL is high. RESTart: trigger when another start condition occurs before a stop condition.
RIGOL Chapter 2 Command System :TRIGger:IIC:ADDRess Syntax :TRIGger:IIC:ADDRess :TRIGger:IIC:ADDRess? Description Parameter Set or query the address when the trigger condition is ADDRess or ADATa in I2C trigger. Name Explanation Return Format Example Related Command Type Integer Range Default n 0 to 2 -1: 0 to 127, 0 to 255, or 0 to 1023 1 In the expression 2n-1, n is the current address bits. The query returns an integer.
RIGOL Chapter 2 Command System :TRIGger:IIC:CLEVel Syntax :TRIGger:IIC:CLEVel :TRIGger:IIC:CLEVel? Description Parameter Explanation Return Format Example Set or query the trigger level of SCL in I2C trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0 For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
RIGOL Chapter 2 Command System :TRIGger:SPI Command List: :TRIGger:SPI:SCL :TRIGger:SPI:SDA :TRIGger:SPI:WHEN :TRIGger:SPI:WIDTh :TRIGger:SPI:DATA :TRIGger:SPI:TIMeout :TRIGger:SPI:SLOPe :TRIGger:SPI:CLEVel :TRIGger:SPI:DLEVel :TRIGger:SPI:SLEVel :TRIGger:SPI:MODE :TRIGger:SPI:CS :TRIGger:SPI:SCL Syntax :TRIGger:SPI:SCL :TRIGger:SPI:SCL? Description Parameter Return Format Example Set or query the channel source of SCL in SPI trigger.
RIGOL Chapter 2 Command System :TRIGger:SPI:WHEN Syntax :TRIGger:SPI:WHEN :TRIGger:SPI:WHEN? Description Parameter Explanation Set or query the trigger condition in SPI trigger. Name Type Range Default Discrete {CS|TIMeout} CS When the trigger condition is set to TIMeout, you can use the :TRIGger:SPI:TIMeout command to set the timeout value. Return Format The query returns CS or TIM.
RIGOL Chapter 2 Command System :TRIGger:SPI:TIMeout Syntax :TRIGger:SPI:TIMeout :TRIGger:SPI:TIMeout? Description Parameter Return Format Example Related Command Set or query the timeout value when the trigger condition is TIMeout in SPI trigger. The default unit is s. Name Type Range Default Real 100ns to 1s 1μs The query returns the timeout value in scientific notation. :TRIGger:SPI:TIMeout 0.
RIGOL Chapter 2 Command System :TRIGger:SPI:DLEVel Syntax :TRIGger:SPI:DLEVel :TRIGger:SPI:DLEVel? Description Parameter Explanation Return Format Example Set or query the trigger level of the SDA channel in SPI trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (-5 x VerticalScale - OFFSet) to (5 x VerticalScale - OFFSet) 0 For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
RIGOL Chapter 2 Command System :TRIGger:SPI:CS Syntax :TRIGger:SPI:CS :TRIGger:SPI:CS? Description Parameter Return Format Example Set or query the data source of the CS signal in SPI trigger. Name Type Range Default Discrete {CHANnel1|CHANnel2} CHANnel1 The query returns CHAN1 or CHAN2.
RIGOL Chapter 2 Command System :WAVeform Commands The :WAVeform commands are used to read the waveform data and its related settings. :WAVeform:MODE is used to set the reading mode of the waveform data. In different mode, the definition of each parameter is different, as shown in Figure 2-1 and Figure 2-2.
RIGOL Chapter 2 Command System Command List: :WAVeform:SOURce :WAVeform:MODE :WAVeform:FORMat :WAVeform:DATA? :WAVeform:XINCrement? :WAVeform:XORigin? :WAVeform:XREFerence? :WAVeform:YINCrement? :WAVeform:YORigin? :WAVeform:YREFerence? :WAVeform:STARt :WAVeform:STOP :WAVeform:PREamble? :WAVeform:SOURce Syntax :WAVeform:SOURce :WAVeform:SOURce? Description Parameter Explanation Return Format Example Related Command Set or query the channel of
RIGOL Chapter 2 Command System Return Format Example RAW: read the waveform data in the internal memory. Note that the waveform data in the internal memory can only be read when the oscilloscope is in the stop state and the oscilloscope cannot be operated during the reading process. If the MATH channel is selected, only the NORMal mode is valid. The query returns NORM, MAX, or RAW.
RIGOL Chapter 2 Command System Tip: When reading the waveform data in the internal memory, the maximum number of waveform points can be read each time the :WAV:DATA? command is sent is related to the return format of the waveform data currently selected, as shown in the table below.
RIGOL Chapter 2 Command System internal memory in at least 3 batches (300000/125000=2.4). When reading the waveform data in batches, note that the number of waveform points in the internal memory that is read each time (namely, stop point - start point + 1) cannot be greater than the maximum number of points that can be read each time (in this example, it is 125000); then, you need to combine the waveform data that are read separately in sequence.
RIGOL Chapter 2 Command System data returned each time is the data in one area in the internal memory. Each of the data returned contains the TMC data description header (WORD or BYTE format) and the waveform data from two adjacent areas are continuous. The figure below shows the waveform data read (in BYTE format). First, select "View as hexadecimal only" in the dropdown list at the right side.
RIGOL Chapter 2 Command System :WAVeform:XORigin? Syntax :WAVeform:XORigin? Description Query the start time of the waveform data of the channel source currently selected in the X direction. Explanation The return value is related to the current data reading mode: In NORMal mode, the query returns the start time of the waveform data displayed on the screen. In RAW mode, the query returns the start time of the waveform data in the internal memory.
RIGOL Chapter 2 Command System :WAVeform:YORigin? Syntax :WAVeform:YORigin? Description Query the vertical offset relative to the vertical reference position of the specified channel source in the Y direction. Explanation The return value is related to the current data reading mode: In NORMal mode, YORigin = VerticalOffset/YINCrement. In RAW mode, YORigin is related to the Verticalscale of the internal waveform and the Verticalscale currently selected.
RIGOL Chapter 2 Command System Commands :WAVeform:MODE :WAVeform:FORMat :WAVeform:STOP :WAVeform:STOP Syntax :WAVeform:STOP :WAVeform:STOP? Description Parameter Set or query the stop point of waveform data reading.
RIGOL Chapter 2 Command System : the vertical reference position in the Y direction. Example Related Commands :WAVeform:PREamble? /*The query returns 0,2,6000000,1,1.000000e-09,-3.000000e-03,0,4.
Chapter 3 Programming Demos RIGOL Chapter 3 Programming Demos This chapter lists some programming demos to illustrate how to use commands to realize the common functions of the oscilloscope in the development environments of Excel, Matlab, LabVIEW, Visual Basic 6.0 and Visual C++ 6.0. All the demos are based on VISA (Virtual Instrument Software Architecture).
RIGOL Chapter 3 Programming Demos Programming Preparations Before programming, you need to make the following preparations: First, install the Ultra Sigma common PC software. You can log in RIGOL official website (www.rigol.com) to download the software; then, install the software according to the instructions. When Ultra Sigma is installed, the NI-VISA library is installed automatically. Here, the default installation path is C:\Program Files\IVI Foundation\VISA.
Chapter 3 Programming Demos RIGOL Excel Programming Demo The program used in this demo: Microsoft Excel 2010 The function realized in this demo: send the *IDN? Command to read the device information. 1. Create a new Excel file that enables the Macros. In this demo, the file is named as IDN.xlsm. 2. Run the IDN.xlsm file. Click FileOptions at the upper-left corner of the Excel file to open the interface as shown in the figure below. Click Customize Ribbon at the right, check Developer and click OK.
RIGOL Chapter 3 Programming Demos 3. Enter the VISA descriptor into a cell of the file as shown in the figure below. For example, the VISA descriptor is USB0::0x1AB1::0x04CE::DS1ZA160801111::INSTR. Input it into SHEET1.CELLS(1,2) (namely the B1 cell in Sheet1). Click the Developer menu and select the Visual Basic option to open the Microsoft Visual Basic. 4. Select Tools(T) in the Microsoft Visual Basic menu bar and click References.
Chapter 3 Programming Demos RIGOL Explanation: If you cannot find the VISA Library in the list at the left of the figure above, please follow the method below to find it. (1) Make sure that your PC has installed the NI-VISA library. (2) Click Browse… at the right and set the search range to C:\WINDOWS\system32 and the filename to visa32.dll, as shown in the figure below. 5. Click View Code in the Developer menu to enter the Microsoft Visual Basic interface. Add the following codes and save the file.
RIGOL 6. Chapter 3 Programming Demos Add button control: click Insert in the Developer menu, select the desired button in Form Controls and put it into the cell of the Excel. At this point, the Assign Macro interface is displayed, select "Sheet1.QueryIdn" and click "Run". By default, the button mane is "Button 1". Right-click the button and select Edit Text in the pop-up menu to change the button name to "*IDN?". 7. 3-6 Click the "*IDN?" button to send request and read data.
Chapter 3 Programming Demos RIGOL Matlab Programming Demo The program used in this demo: MATLAB R2009a The function realized in this demo: make FFT operation on the waveform data and draw the waveform. 1. Run the Matlab software and modify the current directory (namely modify the Current Directory at the top of the software). In this demo, the current directory is modified to E:\DS1000Z-E_Demo. 2. Click File New Blank M-File in the Matlab interface to create an empty M file. 3.
RIGOL 5. 3-8 Chapter 3 Programming Demos Run the M file and the running result is as follows.
Chapter 3 Programming Demos RIGOL LabVIEW Programming Demo The program used in this demo: LabVIEW 2009 The functions realized in this demo: read the waveform data of CH1 on the screen. 1. Run LabVIEW 2009, create a VI file and name it as DS1000Z-E_Demo. 2. Add controls. Right-click in the Front Panel interface, select and add VISA resource name and Waveform Graph from the Controls column, as shown in the figures below. 3. Open the Block Diagram interface.
RIGOL Chapter 3 Programming Demos 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 control and input ":WAV:SOUR CHAN1", ":WAV:FORM BYTE", and ":WAV:DATA?" respectively.
Chapter 3 Programming Demos RIGOL Get the length of the effective waveform data. 7. Convert the character data into array format using the String To Byte Array, namely display the waveform data on the Waveform Graph control and then remove the TMC data header using the Array Subset function. 8. The complete program block diagram is as shown in the figure below.
RIGOL 9. 3-12 Chapter 3 Programming Demos Select the device resource from the VISA Resource Name list box and run the program.
Chapter 3 Programming Demos RIGOL Visual Basic Programming Demo The program used in this demo: Visual Basic 6.0 The function realized in this demo: control the on/off state of any channel. Enter Visual Basic 6.0 and operate according to the following steps: 1. Build a standard application program project (Standard EXE) and name it as Demo. 2. Click the Existing tab of ProjectAdd Module. Search for the visa32.bas file in the include folder under the NI-VISA installation path and add the file. 3.
RIGOL Chapter 3 Programming Demos Dim strRes As String * 200 Dim list As Long Dim nmatches As Long Dim matches As String * 200 ' keep the device number acquired Dim s32Disp As Integer ' acquire the usb source of visa Call viOpenDefaultRM(defrm) Call viFindRsrc(defrm, "USB?*", list, nmatches, matches) ' Open the device Call viOpen(defrm, matches, 0, 0, vi) ' Send the command to query the status of CH1 Call viVPrintf(vi, ":CHAN1:DISP?" + Chr$(10), 0) ' Acquire the status of CH1 Call viVScanf(vi, "%t", strRe
Chapter 3 Programming Demos RIGOL Visual C++ Programming Demo The program used in this demo: Microsoft Visual C++ 6.0 The functions realized in this demo: search for the instrument address, connect the instrument, send command and read the return value. Enter Visual C++6.0 and operate according to the following steps: 1. Create a MFC project based on dialog box. 2. Open the C/C++ tab in ProjectSettings, select Code Generation in Category and Debug Multithreaded DLL in Use run-time library.
RIGOL 4. Chapter 3 Programming Demos Open the Directories tab in ToolsOptions. Select Include files in Show directories for and double-click the blank in Directories to add the path of Include: C:\Program Files\IVI Foundation\VISA\WinNT\include. Select Library files in Show directories for and double-click the blank in Directories to add the path of Lib: C:\Program Files\IVI Foundation\VISA\WinNT\lib\msc. Note: at present, VISA library has been added. 5.
Chapter 3 Programming Demos RIGOL 7. Add the variables m_combox and m_receive for the Combo Box and Edit controls respectively. 8. Add codes. Double-click Send and Read to enter the programming environment. Declare the #include of the visa library in the header file and then add the following codes.
RIGOL Chapter 3 Programming Demos viFindRsrc(defaultRM, "USB?*", &list,&nmatches, matches); viOpen (defaultRM,matches,VI_NULL,VI_NULL,&vi); // Send the command received m_combox.GetLBText(m_combox.GetCurSel(),strTemp); strTemp = strTemp + "\n"; stringTemp = (char*)(LPCTSTR)strTemp; viPrintf (vi,stringTemp); // Read the result viScanf (vi, "%t\n", &buf); // Display the result UpdateData (TRUE); m_receive = buf; UpdateData (FALSE); viClose (vi); viClose (defaultRM); 9.
