RIGOL Programming Guide DS1000Z Series Digital Oscilloscope Dec. 2013 RIGOL Technologies, Inc.
RIGOL Guaranty and Declaration Copyright © 2013 RIGOL Technologies, Inc. All Rights Reserved. Trademark Information RIGOL is a registered trademark of RIGOL Technologies, Inc. Publication Number PGA17103-1110 Notices RIGOL products are protected by patent law in and outside of P.R.C. RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at company’s sole decision. Information in this publication replaces all previously corresponding material.
RIGOL Document Overview This manual guides users to control RIGOL DS1000Z series digital oscilloscope remotely by programming using SCPI commands through the remote interface. DS1000Z can build communication with PC through USB, LAN or GPIB (option). Main Topics in this Manual: Chapter 1 Programming Overview This chapter introduces how to build the remote communication between DS1000Z series digital oscilloscope and PC, remote control method as well as brief introduction of the SCPI commands.
Contents RIGOL Contents Guaranty and Declaration ......................................................................................................... I Document Overview ................................................................................................................. II Chapter 1 Programming Overview......................................................................................1-1 To Build Remote Communication ....................................................................
RIGOL Contents *ESR?............................................................................................................................ 2-33 *IDN?............................................................................................................................ 2-33 *OPC ............................................................................................................................. 2-33 *RST ....................................................................................
Contents RIGOL :MEASure:SETup:DSB ..................................................................................................... 2-58 :MEASure:STATistic:DISPlay ............................................................................................ 2-59 :MEASure:STATistic:MODE .............................................................................................. 2-59 :MEASure:STATistic:RESet ...............................................................................................
RIGOL Contents :TRIGger:COUPling .........................................................................................................2-83 :TRIGger:STATus? ..........................................................................................................2-83 :TRIGger:SWEep ............................................................................................................ 2-83 :TRIGger:HOLDoff .............................................................................................
Chapter 1 Programming Overview RIGOL Chapter 1 Programming Overview This chapter introduces how to build the remote communication between the PC and instrument and provides an overview of the syntax, symbol, parameter type and abbreviation rules of the SCPI commands.
RIGOL Chapter 1 Programming Overview To Build Remote Communication This oscilloscope can build communication with PC through USB, LAN or GPIB (option) interface. This section will introduces detailly how to control the oscilloscope remotely through USB interface using Ultra Sigma. Operation Steps: 1. Install the Ultra Sigma common PC software Download the Ultra Sigma common PC software from www.rigol.
RIGOL Chapter 1 Programming Overview 5 6 7 (3) Search device resource Start up the Ultra Sigma and the software will automatically search for the oscilloscope to search the resources. resources currently connected to the PC. You can also click During the search, the status bar of the software is as shown in the figure below.
RIGOL Chapter 1 Programming Overview (4) View the device resource 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 as shown in the figure below.
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 IEEE488.1 and IEEE 488.2 and conforms to various standards (such as the floating point operation rule in IEEE754 standard, ISO646 7-bit coded character for information interchange (equivalent to ASCll programming)).
RIGOL Chapter 1 Programming Overview Parameter Type 1. Bool The parameter could be OFF, ON, 0 or 1. For example, :MEASure:ADISplay :MEASure:ADISplay? Wherein, can be set to {{0|OFF}|{1|ON}}. The query returns 0 or 1. 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.
Chapter 2 Command System RIGOL Chapter 2 Command System This chapter introduces the syntax, function, parameter and using instruction of each DS1000Z command. Main topics of this chapter: :AUToscale :CLEar :RUN :STOP :SINGle :TFORce :ACQuire Commands :CALibrate Commands :CHANnel Commands :CURSor Commands :DISPlay 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 press the AUTO key at the front panel.
Chapter 2 Command System RIGOL :SINGle Syntax :SINGle Description Set the oscilloscope to single trigger mode. This command is equivalent to the following two operations: pressing the SINGLE key at the front panel, sending the :TRIGger:SWEep SINGle command. Explanation In single trigger mode, the oscilloscope triggers once the trigger conditions are met and then stops. When the waveform record function is enabled or during playback the recorded waveform, this command is invalid.
RIGOL Chapter 2 Command System :ACQuire Commands :ACQuire commands are used to set or query the memory depth, acquisition mode and the current sample rate of the oscilloscope as well as to set the number of averages under average acquisition mode.
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 :ACQuire:TYPE Syntax :ACQuire:TYPE :ACQuire:TYPE? Description Parameter Explanation Return Format Example Related Command 2-6 Set or query the acquisition mode when the oscilloscope samples. Name Type Range Default Discrete {NORMal|AVERages|PEAK|HRESolution} NORMal NORMal: in this mode, the oscilloscope samples the signal at equal time interval to rebuild the waveform.
RIGOL Chapter 2 Command System :ACQuire:SRATe? Syntax :ACQuire:SRATe? Description Query the current sample rate. The default unit is Sa/s. Explanation Sample rate is the sample frequency of the oscilloscope, namely the waveform points sampled per second.
RIGOL Chapter 2 Command System :CHANnel Commands :CHANnel commands are used to set or query the vertical system parameters, such as 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|3|4} —— Discrete {AC|DC|GND} DC AC: the DC components of the signal under test are blocked. DC: the DC and AC components of the signal under test can both pass the channel.
RIGOL Chapter 2 Command System :CHANnel:OFFSet Syntax :CHANnel:OFFSet :CHANnel:OFFSet? Description Parameter Set or query the vertical offset of the specified channel. The default unit is V. Name Type Range Default Discrete {1|2|3|4} —— Real Be dependent on the current vertical scale and probe ratio.
RIGOL Chapter 2 Command System :CHANnel:TCAL Syntax :CHANnel:TCAL :CHANnel:TCAL? Description Parameter Explanation Return Format Set or query the delay calibration time of the specified channel to calibrate the zero offset of the corresponding channel. The default unit is s. Name Type Range Default Discrete {1|2|3|4} —— Real -100ns to 100ns 0.00ns The parameter can only be set to specific values in specified step.
RIGOL Chapter 2 Command System :CHANnel:SCALe Syntax :CHANnel:SCALe :CHANnel:SCALe? Description Parameter Explanation Return Format Example Related Command Set or query the vertical scale of the specified channel. The default unit is V. Name Type Range Default Discrete {1|2|3|4} —— Real Be dependent on the current probe ratio.
RIGOL Chapter 2 Command System :CHANnel:UNITs Syntax :CHANnel:UNITs :CHANnel:UNITs? Description Parameter Return Format Example Set or query amplitude unit displayed of the specified channel. Name Type Range Default Discrete {1|2|3|4} —— Discrete {VOLTage|WATT|AMPere|UNKNown} VOLTage The query returns VOLT, WATT, AMP or UNKN.
RIGOL Chapter 2 Command System :CURSor Commands :CURSor commands are used to measure the X-axis value (such as time) and Y-axis value (such as voltage) of the waveform displayed in the screen. Command List: :CURSor:MODE :CURSor:MANual :CURSor:TRACk :CURSor:AUTO:ITEM :CURSor:XY :CURSor:MODE Syntax :CURSor:MODE :CURSor:MODE? Description Parameter Explanation Return Format Example Related Command 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 in manual cursor measurement mode. Name Type Range Default Discrete {CHANnel1|CHANnel2| CHANnel3|CHANnel4|MATH} CHANnel1 Only the channel is enabled currently can be selected. The query returns CHAN1, CHAN2, CHAN3, CHAN4 or MATH.
RIGOL Chapter 2 Command System :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 manual cursor measurement mode. Name Type Range Default Integer 5 to 594 100 The horizontal and vertical positions 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 :CURSor:MANual:BY Syntax :CURSor:MANual:BY :CURSor:MANual:BY? Description Parameter Explanation Return Format Example Set or query the vertical position of cursor B in manual cursor measurement mode. Name Type Range Default Integer 5 to 394 300 The horizontal and vertical positions 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 :CURSor:MANual:BYValue? Syntax Description Return Format Example Related Command :CURSor:MANual:BYValue? Query the Y value of cursor B in manual cursor measurement mode. The unit dependents on the vertical unit currently selected. The query returns the Y value of cursor B in scientific notation. :CURSor:MANual:BYValue? /*The query returns -4.
RIGOL Chapter 2 Command System :CURSor:TRACk Command List: :CURSor:TRACk:SOURce1 :CURSor:TRACk:SOURce2 :CURSor:TRACk:AX :CURSor:TRACk:BX :CURSor:TRACk:AY? :CURSor:TRACk:BY? :CURSor:TRACk:AXValue? :CURSor:TRACk:AYValue? :CURSor:TRACk:BXValue? :CURSor:TRACk:BYValue? :CURSor:TRACk:XDELta? :CURSor:TRACk:IXDELTA? :CURSor:TRACk:SOURce1 Syntax :CURSor:TRACk:SOURce1 :CURSor:TRACk:SOURce1? Description Parameter Explanation Return Format Example Set or qu
RIGOL Chapter 2 Command System :CURSor:TRACk:AX Syntax :CURSor:TRACk:AX :CURSor:TRACk:AX? Description Parameter Explanation Return Format Example Set or query the horizontal position of cursor A in track cursor measurement mode. Name Type Range Default Integer 5 to 594 100 The horizontal and vertical positions 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 :CURSor:TRACk:BY? Syntax :CURSor:TRACk:BY? Description Query the vertical position of cursor B in track cursor measurement mode. Explanation The horizontal and vertical positions 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 :CURSor:TRACk:BYValue? Syntax Description Return Format Example Related Command :CURSor:TRACk:BYValue? Query the Y value of cursor B in track cursor measurement mode. The unit is the same as the channel unit currently selected. The query returns the Y value of cursor B in scientific notation. :CURSor:TRACk:BYValue? /*The query returns -4.
RIGOL Chapter 2 Command System :CURSor:AUTO:ITEM Syntax :COUSor:AUTO:ITEM - :CURSor:AUTO:ITEM? Description Parameter Explanation Return Format Example Related Command 2-24 Auto cursor can measure 24 waveform parameters. Using this command, you can select the parameters measured by auto cursor from the five parameters enabled last. Name Type Range Default
- Discrete {OFF|ITEM1|ITEM2|ITEM3|ITEM4|ITEM5} OFF Using the :CURSor:MODE command, you can select auto cursor measurement mode.
RIGOL Chapter 2 Command System :CURSor:XY :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 XY cursor measurement mode.
RIGOL Chapter 2 Command System :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 XY cursor measurement mode. Name Type Range Default Integer 5 to 394 100 In XY timebase mode, the horizontal and vertical positions are defined by the pixel coordinate of the XY display area. The pixel coordinate of the XY display area ranges from (0,0) to (400,400).
RIGOL Chapter 2 Command System :CURSor:XY:AYValue? Syntax Description Return Format :CURSor:XY:AYValue? Query the Y value of cursor A in XY cursor measurement mode. The unit dependents on the amplitude unit selected by 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 4.
RIGOL Chapter 2 Command System :DISPlay Commands :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 :DISPlay:DATA? Description Read the bitmap data stream of the image currently displayed. Explanation The command is sent from the PC to the instrument through the VISA interface. The instrument responds to the command and directly returns the bitmap data stream of the image currently displayed to the buffer area of the PC.
RIGOL Chapter 2 Command System :DISPlay:TYPE Syntax :DISPlay:TYPE :DISPlay:TYPE? Description Parameter Explanation Return Format Example 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 and displayed. Normally, this mode can provide the most vivid waveform to view the steep edge of the waveform (such as square waveform).
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. NONE: turn the background grid and coordinate off. The query returns FULL, HALF or NONE.
RIGOL Chapter 2 Command System IEEE488.2 Common Commands IEEE 488.2 standard defines some common commands used for querying the basic information of the instrument or executing 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 in the register set 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 ranging from 00000000 (0 in decimal) to 11111111 (255 in decimal) and of which the bit 1 and bit 6 are 0.
RIGOL Chapter 2 Command System *STB? Syntax *STB? Description Query the event register for the status byte register. The value of the status byte register is set to 0 after this command is executed. Explanation The bit 0 and bit 1 of the status byte register are not used and are always treated as 0. The query returns the decimal numbers corresponding to the binary numbers ranging from 00000000 (0 in decimal) to 11111111 (255 in decimal) and of which the bit 0 and bit 1 are 0.
Chapter 2 Command System RIGOL :MATH Commands :MATH commands are used to set the operations between the waveforms of multiple channels. Note: The operations can be divided into two types. Analog Operations: A+B, A-B, A×B, A/B, FFT, intg, diff, sqrt, lg, ln, exp and abs Logic Operation: A&&B, A||B, A^B and !A For logic operation, the waveform data to be operated is compared to the preset threshold and is converted to 0 or 1. Thus, the result will also be 0 or 1.
RIGOL Chapter 2 Command System :MATH:DISPlay Syntax :MATH:DISPlay :MATH:DISPlay? Description Parameter Return Format Example Enable or disable the math operation function or query the math operation status. Name Type Range Default Bool {{0|OFF}|{1|ON}} 0|OFF The query returns 0 or 1. :MATH:DISPlay ON :MATH:OPERator Syntax :MATH:OPERator :MATH:OPERator? Description Parameter Return Format Example Set or query the operator of the math operation.
RIGOL Chapter 2 Command System :MATH:SOURce2 Syntax :MATH:SOURce2 :MATH:SOURce2? Description Parameter Explanation Return Format Example Set or query the source of the math operation. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 For the operations which needs two source, this command is used to set the source B. The query returns CHAN1, CHAN2, CHAN3 or CHAN4.
RIGOL Chapter 2 Command System :MATH:OFFSet Syntax :MATH:OFFSet :MATH:OFFSet? Description Parameter Set or query the vertical offset of the operation result. The unit dependents on the operator currently selected and the unit selected by the source. Name Explanation Return Format Type Range Default Real Be related to the vertical scale of the operation result Range: -1000*MathVerticalScale ~ 1000*MathVerticalScale Step: MathVerticalScale/50 0.
RIGOL Chapter 2 Command System :MATH:FFT:WINDow Syntax :MATH:FFT:WINDow :MATH:FFT:WINDow? Description Parameter Explanation Return Format Example Related Command Set or query the window function of the FFT operation. Name Type Range Default Discrete {RECTangle|BLACkman|HANNing|HAMMing| FLATtop|TRIangle} RECTangle Spectral leakage can be considerably decreased when a window function is used. Different window functions are applicable to measure different waveforms.
RIGOL Chapter 2 Command System :MATH:FFT:UNIT Syntax :MATH:FFT:UNIT :MATH:FFT:UNIT? Description Parameter Return Format Example Related Command Set or query the vertical unit of the FFT operation result. Name Type Range Default Discrete {VRMS|DB} DB The query returns DB or VRMS. :MATH:FFT:UNIT VRMS :MATH:OPERator :MATH:FFT:HSCale Syntax :MATH:FFT:HSCale :MATH:FFT:HSCale? Description Parameter Explanation Set or query the horizontal scale of the FFT operation result.
RIGOL Chapter 2 Command System :MATH:FFT:HCENter Syntax :MATH:FFT:HCENter :MATH:FFT:HCENter? Description Parameter Explanation Return Format Example Related Command Set or query the center frequency of the FFT operation result, namely the frequency relative to the horizontal center in the screen. The default unit is Hz. Name Type Range Default Real 0~( current screen sample rate×2/5) 5MHz Current screen sample rate = 100/current horizontal timebase.
RIGOL Chapter 2 Command System :MATH:OPTion:END Syntax :MATH:OPTion:END :MATH:OPTion:END? Description Parameter Explanation Return Format Example Related Command Set or query the end point of the waveform math operation. Name Type Range Default Discrete (Current point currently set+1)~1199 1199 This command is invalid for FFT operation. Sending this command will modify the end point of all operations (except FFT).
RIGOL Chapter 2 Command System :MATH:OPTion:SENSitivity Syntax :MATH:OPTion:SENSitivity :MATH:OPTion:SENSitivity? Description Parameter Explanation Return Format Example Related Command Set or query the sensitivity of the logic operation. The default unit is div (namle the current vertical scale). Name Type Range Default Real 0 to 0.96div, the step is 0.08div 0 This command is only applicable to the logic operations (A&&B, A||B, A^B and !A).
RIGOL Chapter 2 Command System :MATH:OPTion:THReshold1 Syntax :MATH:OPTion:THReshold1 :MATH:OPTion:THReshold1? Description Parameter Explanation Return Format Example Related Command Set or query the threshold level of the source A in logic operation. The default unit is V. Name Type Range Default Real (-4*Vertical Scale – Vertical Offset)~ (4*Vertical Scale – Vertical Offset) 0.00V This command is only applicable to the logic operations (A&&B, A||B, A^B and !A).
RIGOL Chapter 2 Command System :MASK Commands :MASK commands are used to set and query the parameter in pass/fail test.
RIGOL Chapter 2 Command System :MASK:SOURce Syntax :MASK:SOURce :MASK:SOURce? Description Parameter Explanation Return Format Example Related Command Set or query the source of the pass/fail test. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 This command can only select the channel enabled. You can sent the :CHANnel:DISPlay command to enable the desired channel. The query returns CHAN1, CHAN2, CHAN3 or CHAN4.
RIGOL Chapter 2 Command System :MASK:MDISplay Syntax :MASK:MDISplay :MASK:MDISplay? Description Parameter Explanation Return Format Example Related Command Enable or disable the statistic information when the pass/fail test is enabled, or query the status of the statistic information. Name Type Range Default Bool {{0|OFF}|{1|ON}} 0|OFF Before executing this command, you need to sent the :MASK:ENABle command to enable the pass/fail test.
RIGOL Chapter 2 Command System :MASK:OUTPut Syntax :MASK:OUTPut :MASK:OUTPut? Description Parameter Explanation Return Format Example Enable or disable the sound prompt when the failed waveforms are detected, or query the status of the sound prompt. Name Type Range Default Bool {{0|OFF}|{1|ON}} 0|OFF OFF: failed waveforms are detected, there are display and output but the beeper does not sound..
Chapter 2 Command System RIGOL :MASK:CREate Syntax :MASK:CREate Description Create the pass/fail test mask using the current horizontal adjustment parameter and vertical adjustment parameter. Explanation This command is valid only when the pass/fail test is enabled (:MASK:ENABle) and not in run state (:MASK:OPERate). Related Command :MASK:ENABle :MASK:OPERate :MASK:X :MASK:Y :MASK:PASSed? Syntax Description Return Format :MASK:PASSed? Query the number of the passed frames in pass/fail test.
RIGOL Chapter 2 Command System :MEASure Commands DS1000Z can measure the following 24 waveform parameters and provide the statistic function for the measurement results. In additional, you can use the frequency counter to make more precise measurement of the input signal frequency. :MEASure commands are used to set or query the corresponding parameters. Time Parameters Period: Defined as the time between the threshold middle points of two consecutive, like-polarity edges.
RIGOL Chapter 2 Command System Wherein, Phase denotes “Phase 1→2 ” or “Phase 1→2 ”, Delay denotes “Delay 1→2 ” or “Delay 1→2 ” and Period1 denotes the period of source 1. Period Source 1 Delay Source 2 Voltage Parameters Vmax: the voltage value from Vmin: the voltage value from Vpp: the voltage value from Vtop: the voltage value from Vbase: the voltage value from Vamp: the voltage value from Vavg: the arithmetic average Average = Vrms: ∑x i n the highest point of the waveform to the GND.
RIGOL Chapter 2 Command System Other Parameters : 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. The area measured is the algebraic sum of the area of the whole waveform within the screen. : Period Area The area of the first period of waveform on the screen and the unit is voltage-second.
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 for parameter measurement. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 This command is used to set the source for parameters (except for delay and phase) measurement.
RIGOL Chapter 2 Command System :MEASure:CLEar Syntax Description Parameter Explanation Example Related Command :MEASure:CLEar - Clear the 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 24 waveform parameters.
RIGOL Chapter 2 Command System :MEASure:ADISplay Syntax :MEASure:ADISplay :MEASure:ADISplay? Description Parameter Explanation Return Format Example Related Command Enable or disable all measurement function, or query the status of all measurement function.
RIGOL Chapter 2 Command System :MEASure:SETup:MAX Syntax :MEASure:SETup:MAX :MEASure:SETup:MAX? Description Parameter Explanation Return Format Example Related Command Set or query the upper limit of the threshold when measuring time, delay and phase parameters. The default unit is %. Name Type Range Default Integer 7 to 95 90 The upper limit, middle point and lower limit of the threshold are used to define the time, delay and phase parameters.
RIGOL Chapter 2 Command System :MEASure:SETup:MIN Syntax :MEASure:SETup:MIN :MEASure:SETup:MIN? Description Parameter Explanation Return Format Example Related Command Set or query the lower limit of the threshold when measuring time, delay and phase parameters. The default unit is %. Name Type Range Default Integer 5 to 93 10 The upper limit, middle point and lower limit of the threshold are used to define the time, delay and phase parameters.
RIGOL Chapter 2 Command System :MEASure:SETup:PSB Syntax :MEASure:SETup:PSB :MEASure:SETup:PSB? Description Parameter Return Format Example Related Command Set or query the source B of Phase 1→2 and Phase 1→2 measurements. Name Type Range Default Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel2 The query returns CHAN1, CHAN2, CHAN3 or CHAN4.
RIGOL Chapter 2 Command System :MEASure:STATistic:DISPlay Syntax :MEASure:STATistic:DISPlay :MEASure:STATistic:DISPlay? Description Parameter Explanation Return Format Example Related Command Enable or disable the statistic function, or query the status of the statistic function.
RIGOL Chapter 2 Command System :MEASure:STATistic:RESet Syntax Description Related Command :MEASure:STATistic:RESet Clear the history data and make statistic again.
RIGOL Chapter 2 Command System :MEASure:ITEM Syntax :MEASure:ITEM - [,[,]] :MEASure:ITEM?
- [,[,]] Description Parameter Explanation Return Format Example Related Command Measure any waveform parameter of the specified source, or query the measurement result of any waveform parameter of the specified source.
RIGOL Chapter 2 Command System :REFerence Commands Command List: :REFerence:DISPlay :REFerence:ENABle :REFerence:SOURce :REFerence:VSCale :REFerence:VOFFset :REFerence:RESet :REFerence:DISPlay Syntax :REFerence:DISPlay :REFerence:DISPlay? Description Parameter Return Format Example Enable or disable the REF function, or query the status of the REF function. Name Type Range Default Bool {{0|OFF}|{1|ON}} 0|OFF The query returns 0 or 1.
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 specified reference channel.
RIGOL Chapter 2 Command System :REFerence:VOFFset Syntax :REFerence:VOFFset :REFerence:VOFFset? Description Parameter Explanation Return Format 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} None Real -10*RefVerticalScale to 10*RefVerticalScale 0 RefVerticalScale refers to the vertical scale of the reference channel.
Chapter 2 Command System RIGOL [:SOURce[]] Commands (DS1000Z-S Only) Command List: [:SOURce[]]:OUTPut[][:STATe] [:SOURce[]]:OUTPut[]:IMPedance [:SOURce[]]:FREQuency[:FIXed] [:SOURce[]]:PHASe[:ADJust] [:SOURce[]]:PHASe:INITiate [:SOURce[]]:FUNCtion[:SHAPe] [:SOURce[]]:FUNCtion:RAMP:SYMMetry [:SOURce[]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] [:SOURce[]]:VOLTage[:LEVel][:IMMediate]:OFFSet [:SOURce[]]:PULSe:DCYCle [:SOURce[]
RIGOL Chapter 2 Command System [:SOURce[]]:OUTPut[][:STATe] Syntax [:SOURce[]]:OUTPut[][:STATe] [:SOURce[]]:OUTPut[][:STATe]? Description Parameter Explanation Return Format Example Turn on or off the output of the specified source channel, or query the status of the specified source channel.
RIGOL Chapter 2 Command System [:SOURce[]]:FREQuency[:FIXed] Syntax [:SOURce[]]:FREQuency[:FIXed] [:SOURce[]]:FREQuency[:FIXed]? Description Parameter Set or query the output frequency of the specified source channel if modulation is not enabled or the carrier frequency if modulation is enabled. The default unit is Hz. Name Type Range Default [] Discrete {1|2} If omitted, operating on source 1 by default Real Sine: 0.1Hz to 25MHz Square: 0.1Hz to 15MHz Pulse: 0.
RIGOL Chapter 2 Command System [:SOURce[]]:PHASe:INITiate Syntax Description Parameter Explanation [:SOURce[]]:PHASe:INITiate Execute align phase operation. Name Type Range Default [] Discrete {1|2} If omitted, operating on source 1 by default Executing align phase operation, the instrument will re-configure the two channels and enable the generator to output with specified frequency and start phase.
RIGOL Chapter 2 Command System [:SOURce[]]:FUNCtion:RAMP:SYMMetry Syntax [:SOURce[]]:FUNCtion:RAMP:SYMMetry [:SOURce[]]:FUNCtion:RAMP:SYMMetry? Description Parameter Return Format Example Related Command Set or query the ramp symmetry (the percentage that the rising period takes up in the whole period) of the specified source channel. The default unit is %.
RIGOL Chapter 2 Command System [:SOURce[]]:VOLTage[:LEVel][:IMMediate]:OFFSet Syntax [:SOURce[]]:VOLTage[:LEVel] [:IMMediate]:OFFSet [:SOURce[]]:VOLTage[:LEVel] [:IMMediate]:OFFSet? Description Parameter Set or query the DC offset of the specified source channel. The default unit is V. Name Type Range Default [] Discrete {1|2} If omitted, operating on source 1 by default Real Related to the output impedance and amplitude: HighZ: ±(2.5V－current amplitude/2) 50Ω: ±(1.
RIGOL Chapter 2 Command System [:SOURce[]]:MOD[:STATe] Syntax [:SOURce[]]:MOD[:STATe] [:SOURce[]]:MOD[:STATe]? Description Parameter Explanation Return Format Example Related Command Enable or disable the modulation of the specified source channel, or query the status of the modulation of the specified source channel.
RIGOL Chapter 2 Command System [:SOURce[]]:MOD:AM[:DEPTh] Syntax [:SOURce[]]:MOD:AM[:DEPTh] [:SOURce[]]:MOD:AM[:DEPTh]? Description Parameter Explanation Return Format Example Set or query the AM modulation depth (indicates the amplitude variation degree and is expressed as a percentage) of the specified source channel. The default unit is %.
RIGOL Chapter 2 Command System [:SOURce[]]:MOD:AM:INTernal:FUNCtion [:SOURce[]]:MOD:FM:INTernal:FUNCtion Syntax [:SOURce[]]:MOD:AM:INTernal:FUNCtion [:SOURce[]]:MOD:AM:INTernal:FUNCtion? [:SOURce[]]:MOD:FM:INTernal:FUNCtion [:SOURce[]]:MOD:FM:INTernal:FUNCtion? Description Parameter Explanation Return Format Example Set or query the modulating waveform of AM or FM of the specified source channel.
RIGOL Chapter 2 Command System [:SOURce[]]:APPLy? Syntax Description Parameter Return Format Example [:SOURce[]]:APPLy? Query the output configurations of the specified source channel. Name Type Range Default [] Discrete {1|2} If omitted, operating on source 1 by default The query returns the output configurations in “,,,,” format. If the corresponding item does not exist, it will be replaced by "DEF".
Chapter 2 Command System RIGOL NOISe: select Noise PULSe: select Pulse RAMP: select Ramp SINusoid: select Sine SQUare: select Square USER: select Arbitrary waveform : set the frequency of the specified waveform (Noise has no this parameter). The default unit is Hz : set the amplitude of the specified waveform. The default unit is Vpp : set the DC offset of the specified waveform.
RIGOL Chapter 2 Command System :SYSTem Commands :SYSTem 命令用于设置声音, 语言等系统相关的设置. Command List: :SYSTem:AUToscale :SYSTem:BEEPer :SYSTem:ERRor[:NEXT]? :SYSTem:GPIB :SYSTem:LANGuage :SYSTem:LOCKed :SYSTem:PON :SYSTem:OPTion:INSTall :SYSTem:OPTion:UNINSTall :SYSTem:AUToscale Syntax :SYSTem:AUToscale :SYSTem:AUToscale? Description Parameter Explanation Return Format Example Enable or disable the AUTO key at the front panel, or query the status of the AUTO key.
RIGOL Chapter 2 Command System :SYSTem:ERRor[:NEXT]? Syntax Description Return Format :SYSTem:ERRor[:NEXT]? Query and delete the last system error message. The query returns the error message in “,” format. Wherein, the message number is an integer and the message content is a ASCII character string. For example, -113,"Undefined header; command cannot be found".
RIGOL Chapter 2 Command System :SYSTem:PON Syntax :SYSTem:PON :SYSTem:PON? Description Parameter Return Format Example Set or query set the system configuration type to be recalled when the oscilloscope is powered on again after power-off. Name Type Range Default Discrete {LATest|DEFault} LATest The query returns LAT or DEF. :SYSTem:PON LATest :SYSTem:OPTion:INSTall Syntax Description Parameter Example :SYSTem:OPTion:INSTall Install option.
RIGOL Chapter 2 Command System :TIMebase Commands :TIMebase commands are used to set horizontal parameters, such as enabling the delayed sweep, setting the horizontal timebase mode, etc.
RIGOL Chapter 2 Command System :TIMebase:DELay:SCALe Syntax :TIMebase:DELay:SCALe :TIMebase:DELay:SCALe? Description Parameter Explanation Set or query the delayed timebase scale. The default unit is s/div.
RIGOL Chapter 2 Command System :TIMebase[:MAIN]:SCALe Syntax :TIMebase[:MAIN]:SCALe :TIMebase[:MAIN]:SCALe? Description Parameter Explanation Return Format Example Related Command Set or query the main timebase scale. The default unit is s/div.
RIGOL Chapter 2 Command System :TRIGger Commands :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 the edge trigger. AC: block all the DC components and attenuate signals lower than 75 kHz. DC: allow DC and AC components into the trigger path.
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 amount of 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|CHANnel3|CHANnel4|AC} CHANnel1 The query returns CHAN1, CHAN2, CHAN3, CHAN4 or AC.
RIGOL Chapter 2 Command System :TRIGger:EDGe:LEVel Syntax :TRIGger:EDGe:LEVel :TRIGger:EDGe:LEVel? Description Parameter Explanation Return Format Example Related Command 2-86 Set or query the trigger level in edge trigger. The unit is the same as the current amplitude unit. Name Type Range Default Real (± 5 × VerticalScale from the screen center) －OFFSet 0 For VerticalScale, refer to the :CHANnel:SCALe command. For OFFSet, refer to the :CHANnel:OFFSet 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 Related Command 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:LWIDth Syntax :TRIGger:PULSe:LWIDth :TRIGger:PULSe:LWIDth? Description Parameter Explanation Return Format Example Related Command Set or query the lower pulse width in pulse width trigger. The default unit is s. Name Type Range Default Real 8ns to 9.99s 992ns This command is available when the trigger condition (refer to :TRIGger:PULSe:WHEN) is PGLess and NGLess. The query returns the lower pulse width in scientific notation.
RIGOL Chapter 2 Command System :TRIGger:SLOPe Command List: :TRIGger:SLOPe:SOURce :TRIGger:SLOPe:WHEN :TRIGger:SLOPe:TIME :TRIGger:SLOPe:TUPPer :TRIGger:SLOPe:TLOWer :TRIGger:SLOPe:WINDow :TRIGger:SLOPe:ALEVel :TRIGger:SLOPe:BLEVel :TRIGger:SLOPe:SOURce Syntax :TRIGger:SLOPe:SOURce :TRIGger:SLOPe:SOURce? Description Parameter Return Format Example 2-90 Set or query the trigger source in slope trigger.
RIGOL Chapter 2 Command System :TRIGger:SLOPe:WHEN Syntax :TRIGger:SLOPe:WHEN :TRIGger:SLOPe:WHEN? Description Parameter Explanation Return Format Example Related Command Set or query the trigger condition in slope trigger. Name Type Range Default Discrete {PGReater|PLESs|NGReater|NLESs|PGLess|NGLess} PGReater PGReater/PLESs: you need to specify a time value (refer to :TRIGger:SLOPe:TIME).
RIGOL Chapter 2 Command System :TRIGger:SLOPe:TUPPer Syntax :TRIGger:SLOPe:TUPPer
RIGOL Chapter 2 Command System :TRIGger:SLOPe:WINDow Syntax :TRIGger:SLOPe:WINDow :TRIGger:SLOPe:WINDow? Description Parameter Explanation Return Format Example Related Command Set or query the vertical window type in slope trigger Name Type Range Default Discrete {TA|TB|TAB} TA TA: only adjust the upper limit of the trigger level, refer to :TRIGger:SLOPe:ALEVel. TB: only adjust the lower limit of the trigger level, refer to :TRIGger:SLOPe:BLEVel.
RIGOL Chapter 2 Command System :TRIGger:SLOPe:BLEVel Syntax :TRIGger:SLOPe:BLEVel :TRIGger:SLOPe:BLEVel? Description Parameter Explanation Return Format Example Related Command 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 × VerticalScale from the screen center) －OFFSet 0 For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
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 :TRIGger:VIDeo:MODE Syntax :TRIGger:VIDeo:MODE :TRIGger:VIDeo:MODE? Description Parameter Explanation Return Format Example Related Command Set or query the sync type in video trigger. Name Type Range Default Discrete {ODDField|EVENfield|LINE|ALINes} ALINes ODDField: trigger on the rising edge of the first ramp waveform pulse in the odd field. This type is available when the video standard is NTSC or PAL/SECAM.
RIGOL Chapter 2 Command System :TRIGger:VIDeo:STANdard Syntax :TRIGger:VIDeo:STANdard :TRIGger:VIDeo:STANdard? Description Parameter Explanation Return Format Example Related Command Set or query the video standard in video trigger. Name Type Range Default Discrete {PALSecam|NTSC|480P|576P} NTSC PALSecam: PAL: the frame frequency is 25 frames per second. The TV sweep line is 625 with the odd field goes first and the even field follows behind.
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-98 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 Related Command 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.
RIGOL Chapter 2 Command System :TRIGger:DURATion:WHEN Syntax :TRIGger:DURATion:WHEN :TRIGger:DURATion:WHEN? Description Parameter Explanation Return Format Example Related Command Set or query the trigger condition in duration trigger. Name Type Range Default Discrete {GREater|LESS|GLESs} GREater GREater: you need to specify a time (refer to :TRIGger:DURATion:TLOWer). The oscilloscope triggers when the duration of the pattern is greater than the preset time.
RIGOL Chapter 2 Command System :TRIGger:DURATion:TLOWer Syntax :TRIGger:DURATion:TLOWer :TRIGger:DURATion:TLOWer? Description Parameter Explanation Return Format Example Related Command 2-102 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 (Option) 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|CHANnel3|CHANnel4} CHANnel1 The query returns CHAN1, CHAN2, CHAN3 or CHAN4.
RIGOL Chapter 2 Command System :TRIGger:TIMeout:TIMe Syntax :TRIGger:TIMeout:TIMe :TRIGger:TIMeout:TIMe? Description Parameter Return Format Example Related Command 2-104 Set or query the timeout time in timeout trigger. The default unit is s. Name Type Range Default Real 16ns to 10s 16ns The query returns the timeout time in scientific notation. :TRIGger:TIMeout:TIMe 0.002 /*Set the timeout time to 2ms*/ :TRIGger:TIMeout:TIMe? /*The query returns 2.
RIGOL Chapter 2 Command System :TRIGger:RUNT (Option) Command List: :TRIGger:RUNT:SOURce :TRIGger:RUNT:POLarity :TRIGger:RUNT:WHEN :TRIGger:RUNT:WUPPer :TRIGger:RUNT:WLOWer :TRIGger:RUNT:ALEVel :TRIGger:RUNT:BLEVel :TRIGger:RUNT:SOURce Syntax :TRIGger:RUNT:SOURce :TRIGger:RUNT:SOURce? Description Parameter Return Format Example Set or query the trigger source in runt trigger.
RIGOL Chapter 2 Command System :TRIGger:RUNT:WHEN Syntax :TRIGger:RUNT:WHEN :TRIGger:RUNT:WHEN? Description Parameter Explanation Return Format Example Related Command 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 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 Related Command Set or query the pulse width lower limit in runt trigger. The default unit is s. Name Type Range Default Discrete 8ns to 9.99s 1μs This command is only available when the qualifier (refer to :TRIGger:RUNT:WHEN) is GREater or GLESs. The query returns the pulse width lower limit in scientific notation.
RIGOL Chapter 2 Command System :TRIGger:RUNT:BLEVel Syntax :TRIGger:RUNT:BLEVel :TRIGger:RUNT:BLEVel? Description Parameter Explanation Return Format Example Related Command 2-108 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 × VerticalScale from the screen center) －OFFSet 0 For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
RIGOL Chapter 2 Command System :TRIGger:WINDows (Option) Command List: :TRIGger:WINDows:SOURce :TRIGger:WINDows:SLOPe :TRIGger:WINDows:POSition :TRIGger:WINDows:TIMe :TRIGger:WINDows:ALEVel :TRIGger:WINDows:BLEVel :TRIGger:WINDows:SOURce Syntax :TRIGger:WINDows:SOURce :TRIGger:WINDows:SOURce? Description Parameter Return Format Example Set or query the trigger source in windows trigger.
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 Related Command 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 × VerticalScale from the screen center) －OFFSet 2V For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
RIGOL Chapter 2 Command System :TRIGger:DELay (Option) Command List: :TRIGger:DELay:SA :TRIGger:DELay:SLOPA :TRIGger:DELay:SB :TRIGger:DELay:SLOPB :TRIGger:DELay:TYPe :TRIGger:DELay:TUPPer :TRIGger:DELay:TLOWer :TRIGger:DELay:SA Syntax :TRIGger:DELay:SA :TRIGger:DELay:SA? Description Parameter Return Format Example Set or query the trigger source A in delay trigger.
RIGOL Chapter 2 Command System :TRIGger:DELay:SLOPB Syntax :TRIGger:DELay:SLOPB :TRIGger:DELay:SLOPB? Description Parameter Return Format Example Set or query the edge type of the trigger source B in delay trigger. Name Type Range Default Discrete {POSitive|NEGative} POSitive The query returns POS or NEG.
RIGOL Chapter 2 Command System :TRIGger:DELay:TUPPer Syntax :TRIGger:DELay:TUPPer :TRIGger:DELay:TUPPer? Description Parameter Explanation Return Format Example Related Command Set or query the upper limit of the delay time in delay trigger. The default unit is s. Name Type Range Default Real 16ns to 10s 2μs This command is only available when the delay type (refer to :TRIGger:DELay:TYPe) is LESS, GOUT or GLESs.
RIGOL Chapter 2 Command System :TRIGger:SHOLd (Option) Command List: :TRIGger:SHOLd:DSrc :TRIGger:SHOLd:CSrc :TRIGger:SHOLd:SLOPe :TRIGger:SHOLd:PATTern :TRIGger:SHOLd:TYPe :TRIGger:SHOLd:STIMe :TRIGger:SHOLd:HTIMe :TRIGger:SHOLd:DSrc Syntax :TRIGger:SHOLd:DSrc :TRIGger:SHOLd:DSrc? Description Parameter Return Format Example Set or query the data source in setup/hold trigger.
RIGOL Chapter 2 Command System :TRIGger:SHOLd:PATTern Syntax :TRIGger:SHOLd:PATTern :TRIGger:SHOLd:PATTern? Description Parameter Explanation Return Format Example Set or query the data type in setup/hold trigger. Name Type Range Default Discrete {H|L} H H: high level L: low level The query returns H or L.
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 This command is only available when the setup type (refer to :TRIGger:SHOLd:TYPe) is SETup or SETHOLd. The query returns the setup time in scientific notation. :TRIGger:SHOLd:STIMe 0.
RIGOL Chapter 2 Command System :TRIGger:NEDGe (Option) Command List: :TRIGger:NEDGe:SOURce :TRIGger:NEDGe:SLOPe :TRIGger:NEDGe:IDLE :TRIGger:NEDGe:EDGE :TRIGger:NEDGe:LEVel :TRIGger:NEDGe:SOURce Syntax :TRIGger:NEDGe:SOURce :TRIGger:NEDGe:SOURce? Description Parameter Return Format Example Set or query the trigger source in Nth edge trigger.
RIGOL Chapter 2 Command System :TRIGger:NEDGe:IDLE Syntax :TRIGger:NEDGe:IDLE :TRIGger:NEDGe:IDLE? Description Set or query the idle time in Nth edge trigger. The default unit is s. Parameter Return Format Example Name Type Range Default Real 16ns to 10s 1μs The query returns the idle time in scientific notation. :TRIGger:NEDGe:IDLE 0.002 /*Set the idle time to 2ms*/ :TRIGger:NEDGe:IDLE? /*The query returns 2.
RIGOL Chapter 2 Command System :TRIGger:RS232 (Option) Command List: :TRIGger:RS232:SOURce :TRIGger:RS232:WHEN :TRIGger:RS232:PARity :TRIGger:RS232:STOP :TRIGger:RS232:DATA :TRIGger:RS232:WIDTh :TRIGger:RS232:BAUD :TRIGger:RS232:BUSer :TRIGger:RS232:LEVel :TRIGger:RS232:SOURce Syntax :TRIGger:RS232:SOURce :TRIGger:RS232:SOURce? Description Parameter Return Format Example 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 trigger condition is ERRor or PARity in RS232 trigger. Name Type Range Default Discrete {EVEN|ODD|NONE} NONE When the trigger condition is PARity, the parity type can not be set to NONE. At this point, the default parity type is EVEN.
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 Related Command 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 × VerticalScale from the screen center) － OFFSet 0 For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
RIGOL Chapter 2 Command System :TRIGger:IIC (Option) Command List: :TRIGger:IIC:SCL :TRIGger:IIC:SDA :TRIGger:IIC:WHEN :TRIGger:IIC:AWIDth :TRIGger:IIC:ADDRess :TRIGger:IIC:DIRection :TRIGger:IIC:DATA :TRIGger:IIC:CLEVel :TRIGger:IIC:DLEVel :TRIGger:IIC:SCL Syntax :TRIGger:IIC:SCL :TRIGger:IIC:SCL? Description Parameter 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|ADD Ress|DATA|ADATa} STARt STARt: trigger when SDA data transitions from high to low while 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 n Default 0 to 2 – 1: 0 to 127, 0 to 255 or 0 to 1023 1 In 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 Related Command 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 × VerticalScale from the screen center) － OFFSet 0 For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
RIGOL Chapter 2 Command System :TRIGger:SPI (Option) Command List: :TRIGger:SPI:SCL :TRIGger:SPI:SDA :TRIGger:SPI:WHEN :TRIGger:SPI:WIDTh :TRIGger:SPI:DATA :TRIGger:SPI:TIMeout :TRIGger:SPI:SLOPe :TRIGger:SPI:CLEVel :TRIGger:SPI:DLEVel :TRIGger:SPI: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 Related Command 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 × VerticalScale from the screen center) － OFFSet 0 For VerticalScale, refer to :CHANnel:SCALe. For OFFSet, refer to :CHANnel:OFFSet.
RIGOL Chapter 2 Command System :WAVeform Commands :WAVeform commands are used to read the waveform data and its related settings. :WAVeform:MODE is used to set the mode to read the waveform data. In different mode, the parameters definition 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 :WAVeform:MODE Syntax :WAVeform:MODE :WAVeform:MODE? Description Parameter Explanation Return Format Example Related Command Set or query the reading mode used by :WAVeform:DATA?. Name Type Range Default Discrete {NORMal|MAXimum|RAW} NORMal NORMal: read the waveform data displayed on the screen.
RIGOL Chapter 2 Command System :WAVeform:DATA? Syntax :WAVeform:DATA? Description Read the waveform data.
RIGOL Chapter 2 Command System :WAVeform:XINCrement? Syntax :WAVeform:XINCrement? Description Query the time difference between two neighboring points of the specified source in X direction.
RIGOL Chapter 2 Command System :WAVeform:YINCrement? Syntax :WAVeform:YINCrement? Description Query the waveform increment of the specified source in Y direction. The unit is the same as the current amplitude unit. Explanation YINCrement= VerticalScale/25 Return Format Example Related Command The query returns the YINCrement in scientific notation. :WAVeform:YINCrement? /*The query returns 8.
RIGOL Chapter 2 Command System :WAVeform:STARt Syntax :WAVeform:STARt :WAVeform:STARt? Description Parameter Set or query the start position of internal memory waveform reading. Name Return Format Example Related Command Type Range Default Integer NORMal: 1 to 1200 MAX: 1 to the number of effective point currently on the screen RAW: 1 to the current maximum memory depth 1 The query returns an integer.
RIGOL Chapter 2 Command System :WAVeform:PREamble? Syntax Description Return Format :WAVeform:PREamble? Query and return all the waveform parameters. The query returns 10 waveform parameters separated by “,”: ,,,,,,,,, Wherein, : 0 (BYTE), 1 (WORD) or 2 (ASC). : 0 (NORMal), 1 (MAXimum) or 2 (RAW). : integer between 1 and 12000000.
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, LabVIEW, Matlab, 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: Make sure that your PC has installed the NI-VISA library (can be downloaded from NI website: http://www.ni.com/visa/). Here, the default installation path is C:\Program Files\IVI Foundation\VISA. Here, the USB interface of the oscilloscope is used to communicate with the PC and please use USB cable to connect the USB DEVICE interface at the rear panel of the power supply to the PC.
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 DS1000Z_Demo_Excel.xlsm file. Click FileOptions at the upper-left corner of the Excel file to open the interface as shown in the figure below.
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::DS1T00000006::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 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 “OK”. 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_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 following running result is displayed.
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 in the screen. 1. Run LabVIEW 2009, create a VI file and name it as DS1000Z_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.
RIGOL Chapter 3 Programming Demos 3. Open the Block Diagram interface. Right-click on the VISA resource name and you can select and add the following functions from VISA Palette from the pop-up menu: VISA Write, VISA Read, VISA Open and VISA Close. 4. Connect the VISA resource name with the VISA Open. Then, connect the VISA resource name outputs of all the functions with the VISA resource name and connect the error output with the error input as shown in the figure below. 5.
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 displaying 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 start the run.
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 into 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 matches As String * 200 ' keep the acquisition device number Dim s32Disp As Integer ' acquire the usb source of visa Call viOpenDefaultRM(defrm) Call viFindRsrc(defrm, "USB?*", list, nmatches, matches) ' Open the device Call viOpen(defrm, matches, 0, 0, vi) ' Send the command to query the status of CH1 Call viVPrintf(vi, ":CHAN1:DISP?" + Chr$(10), 0) ' Acquire the status of CH1 Call viVScanf(vi, "%t", strRes) s32Disp = CInt(strRes) If (s32Disp = 1) Then ' Send the set
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 in Visual C++6.0 and operate accoding 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.
