Rigol DS1000Z Series Programming Manual
  1. Manuals
  2. Brands
  3. Rigol Manuals
  4. Test Equipment
  5. DS1000Z Series
  6. Programming manual

Rigol DS1000Z Series Programming Manual

Digital oscilloscope
Hide thumbs Also See for DS1000Z Series:
Table of Contents

Advertisement

Quick Links

See also: User Manual , Quick Manual
RIGOL
Programming Guide
DS1000Z Series Digital Oscilloscope
Dec. 2013
RIGOL Technologies, Inc.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the DS1000Z Series and is the answer not in the manual?

Questions and answers

Related Manuals for Rigol DS1000Z Series

Summary of Contents for Rigol DS1000Z Series

  • Page 1 RIGOL Programming Guide DS1000Z Series Digital Oscilloscope Dec. 2013 RIGOL Technologies, Inc.

  • Page 3: Guaranty And Declaration

    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.

  • Page 4: Document Overview

    System denotes pressing Utility at the front panel and then pressing System. Content Conventions in this Manual: DS1000Z series includes the following models. Unless otherwise noted, this manual takes DS1104Z-S as an example to illustrate the command system of DS1000Z series.

  • Page 5: Table Of Contents

    Contents RIGOL Contents Guaranty and Declaration ......................I Document Overview ......................... II Chapter 1 Programming Overview..................1-1 To Build Remote Communication ....................1-2 Remote Control Methods ......................1-4 SCPI Command Overview ......................1-5 Syntax ..........................1-5 Symbol Description ......................1-5 Parameter Type ........................
  • Page 6 RIGOL Contents *ESR? ..........................2-34 *IDN? ..........................2-34 *OPC ..........................2-34 *RST ..........................2-34 *SRE ..........................2-34 *STB? ..........................2-35 *TST? ..........................2-35 *WAI ..........................2-35 :MATH Commands ........................2-36 :MATH:DISPlay ......................... 2-37 :MATH:OPERator ......................2-37 :MATH:SOURce1 ......................2-37 :MATH:SOURce2 ......................2-38 :MATH:SCALe ........................
  • Page 7 Contents RIGOL :MEASure:SETup:DSB ....................... 2-59 :MEASure:STATistic:DISPlay....................2-60 :MEASure:STATistic:MODE ....................2-60 :MEASure:STATistic:RESet ....................2-61 :MEASure:STATistic:ITEM ....................2-61 :MEASure:ITEM ....................... 2-62 :REFerence Commands ......................2-63 :REFerence:DISPlay ......................2-63 :REFerence<n>:ENABle ....................2-63 :REFerence<n>:SOURce ....................2-64 :REFerence<n>:VSCale ....................2-64 :REFerence<n>:VOFFset ....................2-65 :REFerence<n>:RESet ..................... 2-65 [:SOURce[<n>]] Commands (DS1000Z-S Only) ................
  • Page 8 RIGOL Contents :TRIGger:COUPling ......................2-84 :TRIGger:STATus? ......................2-84 :TRIGger:SWEep ......................2-84 :TRIGger:HOLDoff ......................2-85 :TRIGger:NREJect ......................2-85 :TRIGger:EDGe ........................ 2-86 :TRIGger:PULSe ....................... 2-88 :TRIGger:SLOPe ....................... 2-91 :TRIGger:VIDeo ....................... 2-96 :TRIGger:PATTern ......................2-99 :TRIGger:DURATion ......................2-101 :TRIGger:TIMeout (Option) ..................... 2-104 :TRIGger:RUNT (Option) ....................2-106 :TRIGger:WINDows (Option)...................

  • Page 9: Chapter 1 Programming Overview

    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.

  • Page 10: To Build Remote Communication

    RIGOL Chapter 1 Programming Overview To Build Remote Communication This oscilloscope can build communication with the PC through the USB, LAN or GPIB (option) interface. This section introduces how to control the oscilloscope remotely through the USB interface using Ultra Sigma in details.
  • Page 11 Chapter 1 Programming Overview RIGOL (3) Search for device resource Start up the Ultra Sigma and the software will automatically search for the oscilloscope resources currently connected to the PC. You can also click to search for the resources. During the search, the status bar of the software is as shown in the figure below.

  • Page 12: Remote Control Methods

    Chapter 1 Programming Overview (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 as shown in the figure below.

  • Page 13: Scpi Command Overview

    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)).

  • Page 14: Parameter Type

    RIGOL Chapter 1 Programming Overview Parameter Type Bool The parameter could be OFF, ON, 0 or 1. For example, :MEASure:ADISplay <bool> :MEASure:ADISplay? Wherein, <bool> can be set to {{0|OFF}|{1|ON}}. The query returns 0 or 1. Discrete The parameter could be any of the values listed. For example, :ACQuire:TYPE <type>...

  • Page 15: Chapter 2 Command System

    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 ...

  • Page 16: Autoscale

    RIGOL Chapter 2 Command System :AUToscale Syntax :AUToscale Description Enable the waveform auto setting function. The oscilloscope will automatically adjust the vertical scale, horizontal timebase and trigger mode according to the input signal to realize optimum waveform display. This command is equivalent to pressing the AUTO key at the front panel.

  • Page 17: Single

    Chapter 2 Command System RIGOL :SINGle Syntax :SINGle Description Set the oscilloscope to the single trigger mode. This command is equivalent to the following two operations: pressing the SINGLE key at the front panel and sending :TRIGger:SWEep SINGle command. Explanation In the single trigger mode, the oscilloscope triggers once when the trigger conditions ...

  • Page 18: Acquire Commands

    RIGOL Chapter 2 Command System :ACQuire Commands The :ACQuire commands are used to set and query the memory depth, acquisition mode and the current sample rate of the oscilloscope as well as to set the number of averages under the average acquisition mode.

  • Page 19: Acquire:mdepth

    Chapter 2 Command System RIGOL :ACQuire:MDEPth Syntax :ACQuire:MDEPth <mdep> :ACQuire:MDEPth? Description 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).

  • Page 20: Acquire:type

    RIGOL Chapter 2 Command System :ACQuire:TYPE Syntax :ACQuire:TYPE <type> :ACQuire:TYPE? Description Set or query the acquisition mode when the oscilloscope samples. Parameter Name Type Range Default <type> Discrete {NORMal|AVERages|PEAK|HRESolution} NORMal Explanation NORMal n this mode, the oscilloscope samples the signal at equal time interval to ...

  • Page 21: Acquire:srate

    Chapter 2 Command System RIGOL :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. The relationship among the memory depth, sample rate and waveform length ...

  • Page 22: Calibrate Commands

    RIGOL Chapter 2 Command System :CALibrate Commands Command List: :CALibrate:QUIT  :CALibrate:STARt  :CALibrate:QUIT Syntax :CALibrate:QUIT Description Exit the calibration at any time. Related :CALibrate:STARt Command :CALibrate:STARt Syntax :CALibrate:STARt Description The oscilloscope starts to execute the self-calibration. Explanation The self-calibration can make the oscilloscope quickly reach its optimum working ...

  • Page 23: Channel Commands

    Chapter 2 Command System RIGOL :CHANnel<n> Commands The :CHANnel<n> commands are used to set or query the vertical system parameters, such as the bandwidth limit, coupling, vertical scale and vertical offset. Command List: :CHANnel<n>:BWLimit  :CHANnel<n>:COUPling  :CHANnel<n>:DISPlay  :CHANnel<n>:INVert ...

  • Page 24: Channel:Coupling

    RIGOL Chapter 2 Command System :CHANnel<n>:COUPling Syntax :CHANnel<n>:COUPling <coupling> :CHANnel<n>:COUPling? Description Set or query the coupling mode of the specified channel. Parameter Name Type Range Default <n> Discrete {1|2|3|4} <coupling> Discrete {AC|DC|GND} Explanation AC: the DC components of the signal under test are blocked.

  • Page 25: Channel:Offset

    Chapter 2 Command System RIGOL :CHANnel<n>:OFFSet Syntax :CHANnel<n>:OFFSet <offset> :CHANnel<n>:OFFSet? Description Set or query the vertical offset of the specified channel. The default unit is V. Parameter Name Type Range Default <n> Discrete {1|2|3|4} Related to the current vertical scale and probe ratio.

  • Page 26: Channel:Tcal

    RIGOL Chapter 2 Command System :CHANnel<n>:TCAL Syntax :CHANnel<n>:TCAL <val> :CHANnel<n>:TCAL? Description 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. Parameter Name Type Range Default <n>...

  • Page 27: Channel:Scale

    Chapter 2 Command System RIGOL :CHANnel<n>:SCALe Syntax :CHANnel<n>:SCALe <scale> :CHANnel<n>:SCALe? Description Set or query the vertical scale of the specified channel. The default unit is V. Parameter Name Type Range Default <n> Discrete {1|2|3|4} <scale> Real Related to the current probe ratio.

  • Page 28: Channel:Units

    RIGOL Chapter 2 Command System :CHANnel<n>:UNITs Syntax :CHANnel<n>:UNITs <units> :CHANnel<n>:UNITs? Description Set or query the amplitude display unit of the specified channel. Parameter Name Type Range Default <n> Discrete {1|2|3|4} <units> Discrete {VOLTage|WATT|AMPere|UNKNown} VOLTage Return The query returns VOLT, WATT, AMP or UNKN.

  • Page 29: Cursor Commands

    Chapter 2 Command System RIGOL :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 ...

  • Page 30: Cursor:manual

    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 <type>...
  • Page 31 Chapter 2 Command System RIGOL :CURSor:MANual:SOURce Syntax :CURSor:MANual:SOURce <source> :CURSor:MANual:SOURce? Description Set or query the channel source of the manual cursor measurement mode. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2| CHANnel1 CHANnel3|CHANnel4|MATH} Explanation Only the channel that is enabled currently can be selected.
  • Page 32 RIGOL Chapter 2 Command System :CURSor:MANual:AX Syntax :CURSor:MANual:AX <x> :CURSor:MANual:AX? Description Set or query the horizontal position of cursor A in the manual cursor measurement mode. Parameter Name Type Range Default <x> Integer 5 to 594 Explanation The horizontal and vertical positions of the cursor are defined by the pixel coordinate of the screen.
  • Page 33 Chapter 2 Command System RIGOL :CURSor:MANual:BY Syntax :CURSor:MANual:BY <y> :CURSor:MANual:BY? Description Set or query the vertical position of cursor B in the manual cursor measurement mode. Parameter Name Type Range Default <y> Integer 5 to 394 Explanation The horizontal and vertical positions of the cursor are defined by the pixel coordinate of the screen.
  • Page 34 RIGOL Chapter 2 Command System :CURSor:MANual:BYValue? Syntax :CURSor:MANual:BYValue? Description Query the Y value of cursor B in the manual cursor measurement mode. The unit depends on the vertical unit currently selected. Return The query returns the Y value of cursor B in scientific notation.

  • Page 35: Cursor:track

    Chapter 2 Command System RIGOL :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 <source> :CURSor:TRACk:SOURce1? Description Set or query the channel source of cursor A in the track cursor measurement mode.
  • Page 36 RIGOL Chapter 2 Command System :CURSor:TRACk:AX Syntax :CURSor:TRACk:AX <x> :CURSor:TRACk:AX? Description Set or query the horizontal position of cursor A in the track cursor measurement mode. Parameter Name Type Range Default <x> Integer 5 to 594 Explanation The horizontal and vertical positions of the cursor are defined by the pixel coordinate of the screen.
  • Page 37 Chapter 2 Command System RIGOL :CURSor:TRACk:BY? Syntax :CURSor:TRACk:BY? Description Query the vertical position of cursor B 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).
  • Page 38 RIGOL Chapter 2 Command System :CURSor:TRACk:BYValue? Syntax :CURSor:TRACk:BYValue? Description Query the Y value of cursor B in the track cursor measurement mode. The unit is the same as the channel unit currently selected. Return The query returns the Y value of cursor B in scientific notation.

  • Page 39: Cursor:auto:item

    Chapter 2 Command System RIGOL :CURSor:AUTO:ITEM Syntax :COUSor:AUTO:ITEM <item> :CURSor:AUTO:ITEM? Description The auto cursor function can measure 24 waveform parameters. Using this command, you can select the parameters to be measured by the auto cursor from the five parameters enabled last or query the parameters currently measured by the auto cursor.

  • Page 40: Cursor:xy

    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 <x>...
  • Page 41 Chapter 2 Command System RIGOL :CURSor:XY:AY Syntax :CURSor:XY:AY <y> :CURSor:XY:AY? Description Set or query the vetical position of cursor A in the XY cursor measurement mode. Parameter Name Type Range Default <x> Integer 5 to 394 Explanation In the XY timebase mode, the horizontal and vertical positions are defined by the pixel coordinate of the XY display area.
  • Page 42 RIGOL Chapter 2 Command System :CURSor:XY:AYValue? Syntax :CURSor:XY:AYValue? Description Query the Y value of cursor A in the XY cursor measurement mode. The unit depends on the amplitude unit of the corresponding channel. Return The query returns the Y value of cursor A in scientific notation.

  • Page 43: Display Commands

    Chapter 2 Command System RIGOL :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 ...

  • Page 44: Display:data

    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.

  • Page 45: Display:type

    Chapter 2 Command System RIGOL :DISPlay:TYPE Syntax :DISPlay:TYPE <type> :DISPlay:TYPE? Description Set or query the display mode of the waveform on the screen. Parameter Name Type Range Default <type> Discrete {VECTors|DOTS} VECTors Explanation VECTors: the sample points are connected by lines. Normally, this mode can provide ...

  • Page 46: Display:grid

    RIGOL Chapter 2 Command System :DISPlay:GRID Syntax :DISPlay:GRID <grid> :DISPlay:GRID? Description Set or query the grid type of screen display. Parameter Name Type Range Default <grid> Discrete {FULL|HALF|NONE} FULL Explanation FULL: turn the background grid and coordinate on. HALF: turn the background grid off.

  • Page 47: Ieee488.2 Common Commands

    Chapter 2 Command System RIGOL 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.

  • Page 48: Esr

    The query returns an integer between 0 and 255. Format *IDN? Syntax *IDN? Description Query the ID string of the instrument. Return The query returns the ID string of the instrument, such as RIGOL Format TECHNOLOGIES,DS1104Z,DS1T00000006,00.02.00. *OPC Syntax *OPC? *OPC Description The *OPC? command is used to query whether the current operation is finished.

  • Page 49: Stb

    Chapter 2 Command System RIGOL *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.

  • Page 50: Math Commands

    RIGOL Chapter 2 Command System :MATH Commands The :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...

  • Page 51: Math:display

    Chapter 2 Command System RIGOL :MATH:DISPlay Syntax :MATH:DISPlay <bool> :MATH:DISPlay? Description Enable or disable the math operation function or query the math operation status. Parameter Name Type Range Default <bool> Bool {{0|OFF}|{1|ON}} 0|OFF Return The query returns 0 or 1.

  • Page 52: Math:source2

    RIGOL Chapter 2 Command System :MATH:SOURce2 Syntax :MATH:SOURce2 <src> :MATH:SOURce2? Description Set or query the source of the math operation. Parameter Name Type Range Default <src> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Explanation This command is only applicable to the operations which needs two source and it is used to set source B.

  • Page 53: Math:offset

    Chapter 2 Command System RIGOL :MATH:OFFSet Syntax :MATH:OFFSet <offs> :MATH:OFFSet? Description Set or query the vertical offset of the operation result. The unit depends on the operator currently selected and the unit of the source. Parameter Name Type Range Default Related to the vertical scale of the operation result.

  • Page 54: Math:fft:window

    RIGOL Chapter 2 Command System :MATH:FFT:WINDow Syntax :MATH:FFT:WINDow <wnd> :MATH:FFT:WINDow? Description Set or query the window function of the FFT operation. Parameter Name Type Range Default {RECTangle|BLACkman|HANNing|HAMMing| <wnd> Discrete RECTangle FLATtop|TRIangle} Explanation Spectral leakage can be considerably decreased when a window function is used.

  • Page 55: Math:fft:unit

    Chapter 2 Command System RIGOL :MATH:FFT:UNIT Syntax :MATH:FFT:UNIT <unit> :MATH:FFT:UNIT? Description Set or query the vertical unit of the FFT operation result. Parameter Name Type Range Default <unit> Discrete {VRMS|DB} Return The query returns DB or VRMS. Format Example :MATH:FFT:UNIT VRMS...

  • Page 56: Math:fft:hcenter

    RIGOL Chapter 2 Command System :MATH:FFT:HCENter Syntax :MATH:FFT:HCENter <cent> :MATH:FFT:HCENter? Description Set or query the center frequency of the FFT operation result, namely the frequency relative to the horizontal center of the screen. The default unit is Hz. Parameter Name...

  • Page 57: Math:option:end

    Chapter 2 Command System RIGOL :MATH:OPTion:END Syntax :MATH:OPTion:END <end> :MATH:OPTion:END? Description Set or query the end point of the waveform math operation. Parameter Name Type Range Default <end> (Start point currently set+1) to 1199 Discrete 1199 Explanation This command is invalid for the FFT operation. Sending this command will modify the ...

  • Page 58: Math:option:sensitivity

    RIGOL Chapter 2 Command System :MATH:OPTion:SENSitivity Syntax :MATH:OPTion:SENSitivity <sens> :MATH:OPTion:SENSitivity? Description Set or query the sensitivity of the logic operation. The default unit is div (namely the current vertical scale). Parameter Name Type Range Default <sens> 0 to 0.96div, the step is 0.08div...

  • Page 59: Math:option:threshold1

    Chapter 2 Command System RIGOL :MATH:OPTion:THReshold1 Syntax :MATH:OPTion:THReshold1 <thre> :MATH:OPTion:THReshold1? Description Set or query the threshold level of source A in the logic operation. The default unit is V. Parameter Name Type Range Default (-4*Vertical Scale – Vertical Offset) to <thre>...

  • Page 60: Mask Commands

    RIGOL Chapter 2 Command System :MASK Commands The :MASK commands are used to set and query the pass/fail test parameters. Command List: :MASK:ENABle  :MASK:SOURce  :MASK:OPERate  :MASK:MDISplay  :MASK:SOOutput  :MASK:OUTPut  :MASK:X  :MASK:Y  :MASK:CREate ...

  • Page 61: Mask:source

    Chapter 2 Command System RIGOL :MASK:SOURce Syntax :MASK:SOURce <source> :MASK:SOURce? Description Set or query the source of the pass/fail test. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Explanation Only the channel enabled can be selected as the source. You can sent :CHANnel<n>:DISPlay...

  • Page 62: Mask:mdisplay

    RIGOL Chapter 2 Command System :MASK:MDISplay Syntax :MASK:MDISplay <bool> :MASK:MDISplay? Description Enable or disable the statistic information when the pass/fail test is enabled, or query the status of the statistic information. Parameter Name Type Range Default <bool> Bool {{0|OFF}|{1|ON}} 0|OFF...

  • Page 63: Mask:output

    Chapter 2 Command System RIGOL :MASK:OUTPut Syntax :MASK:OUTPut <bool> :MASK:OUTPut? Description Enable or disable the sound prompt when the failed waveforms are detected, or query the status of the sound prompt. Parameter Name Type Range Default <bool> {{0|OFF}|{1|ON}} Bool 0|OFF...

  • Page 64: Mask:create

    RIGOL Chapter 2 Command System :MASK:CREate Syntax :MASK:CREate Description Create the pass/fail test mask using the current horizontal adjustment parameter and vertical adjustment parameter. Explanation This command is valid only when the pass/fail test is enabled (:MASK:ENABle) and is not in the run state (:MASK:OPERate).

  • Page 65: Measure Commands

    Chapter 2 Command System RIGOL :MEASure Commands DS1000Z supports the auto measurement of 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 frequency measurement. The :MEASure commands are used to set and query the measurement parameters.
  • Page 66 RIGOL Chapter 2 Command System Wherein, denotes “Phase 1→2 ” or “Phase 1→2 ”, denotes “Delay 1→2 ” or Phase Delay “Delay 1→2 ” and denotes the period of source 1. Period Period Source 1 Delay Source 2 Voltage Parameters ...
  • Page 67 Chapter 2 Command System RIGOL 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.

  • Page 68: Measure:source

    RIGOL Chapter 2 Command System :MEASure:SOURce Syntax :MEASure:SOURce <sour> :MEASure:SOURce? Description Set or query the source of the current measurement parameter. Parameter Name Type Range Default <sour> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Explanation This command is used to set the source for the measurement parameters (except the delay and phase).

  • Page 69: Measure:clear

    Chapter 2 Command System RIGOL :MEASure:CLEar Syntax :MEASure:CLEar <item> Description Clear one or all of the last five measurement items enabled. Parameter Name Type Range Default <item> {ITEM1|ITEM2|ITEM3|ITEM4|ITEM5|ALL} Discrete Explanation You can use the :MEASure:ITEM command to enable the desired parameters of the ...

  • Page 70: Measure:adisplay

    RIGOL Chapter 2 Command System :MEASure:ADISplay Syntax :MEASure:ADISplay <bool> :MEASure:ADISplay? Description Enable or disable the all measurement function, or query the status of the all measurement function. Parameter Name Type Range Default <bool> Bool {{0|OFF}|{1|ON}} 0|OFF Explanation The all measurement function can measure the following 20 parameters of the ...

  • Page 71: Measure:setup:max

    Chapter 2 Command System RIGOL :MEASure:SETup:MAX Syntax :MEASure:SETup:MAX <value> :MEASure:SETup:MAX? Description Set or query the upper limit of the threshold in the time, delay and phase measurements. The default unit is %. Parameter Name Type Range Default <value> Integer 7 to 95...

  • Page 72: Measure:setup:min

    RIGOL Chapter 2 Command System :MEASure:SETup:MIN Syntax :MEASure:SETup:MIN <value> :MEASure:SETup:MIN? Description Set or query the lower limit of the threshold in the time, delay and phase measurements. The default unit is %. Parameter Name Type Range Default <value> Integer 5 to 93...

  • Page 73: Measure:setup:psb

    Chapter 2 Command System RIGOL :MEASure:SETup:PSB Syntax :MEASure:SETup:PSB <source> :MEASure:SETup:PSB? Description Set or query source B of the Phase 1→2 and Phase 1→2 measurements. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel2 Return The query returns CHAN1, CHAN2, CHAN3 or CHAN4.

  • Page 74: Measure:statistic:display

    RIGOL Chapter 2 Command System :MEASure:STATistic:DISPlay Syntax :MEASure:STATistic:DISPlay <bool> :MEASure:STATistic:DISPlay? Description Enable or disable the statistic function, or query the status of the statistic function. Parameter Name Type Range Default <bool> Bool {{0|OFF}|{1|ON}} 0|OFF Explanation 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.

  • Page 75: Measure:statistic:reset

    Chapter 2 Command System RIGOL :MEASure:STATistic:RESet Syntax :MEASure:STATistic:RESet Description Clear the history data and make statistic again. Related :MEASure:STATistic:DISPlay Commands :MEASure:STATistic:MODE :MEASure:STATistic:ITEM :MEASure:STATistic:ITEM Syntax :MEASure:STATistic:ITEM <item>[,<src>[,<src>]] :MEASure:STATistic:ITEM? <type>,<item>[,<src>[,<src>]] Description Enable the statistic function of any waveform parameter of the specified source, or query the statistic result of any waveform parameter of the specified source.

  • Page 76: Measure:item

    RIGOL Chapter 2 Command System :MEASure:ITEM Syntax :MEASure:ITEM <item>[,<src>[,<src>]] :MEASure:ITEM? <item>[,<src>[,<src>]] Description Measure any waveform parameter of the specified source, or query the measurement result of any waveform parameter of the specified source. Parameter Name Type Range Default <item> Discrete...

  • Page 77: Reference Commands

    Chapter 2 Command System RIGOL :REFerence Commands Command List: :REFerence:DISPlay  :REFerence<n>:ENABle  :REFerence<n>:SOURce  :REFerence<n>:VSCale  :REFerence<n>:VOFFset  :REFerence<n>:RESet  :REFerence:DISPlay Syntax :REFerence:DISPlay <onoff> :REFerence:DISPlay? Description Enable or disable the REF function, or query the status of the REF function.

  • Page 78: Reference:Source

    RIGOL Chapter 2 Command System :REFerence<n>:SOURce Syntax :REFerence<n>:SOURce <source> :REFerence<n>:SOURce? Description Set or query the source of the specified reference channel. Parameter Name Type Range Default <n> Discrete {1|2|3|4|5|6|7|8|9|10} None {CHANnel1|CHANnel2| <source> Discrete CHANnel1 CHANnel3|CHANnel4|MATH} Explanation Among CH1, CH2, CH3, CH4 and MATH, only the channel currently enabled can be selected as the source or the specified reference channel.

  • Page 79: Reference:Voffset

    Chapter 2 Command System RIGOL :REFerence<n>:VOFFset Syntax :REFerence<n>:VOFFset <offset> :REFerence<n>:VOFFset? Description Set or query the vertical offset of the specified reference channel. The unit is the same as the unit of the source. Parameter Name Type Range Default <n> Discrete...

  • Page 80: [:Source[]] Commands (Ds1000Z-S Only)

    RIGOL Chapter 2 Command System [:SOURce[<n>]] Commands (DS1000Z-S Only) Command List: [:SOURce[<n>]]:OUTPut[<n>][:STATe]  [:SOURce[<n>]]:OUTPut[<n>]:IMPedance  [:SOURce[<n>]]:FREQuency[:FIXed]  [:SOURce[<n>]]:PHASe[:ADJust]  [:SOURce[<n>]]:PHASe:INITiate  [:SOURce[<n>]]:FUNCtion[:SHAPe]  [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry  [:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude]  [:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate]:OFFSet  [:SOURce[<n>]]:PULSe:DCYCle  [:SOURce[<n>]]:MOD[:STATe]  [:SOURce[<n>]]:MOD:TYPe  [:SOURce[<n>]]:MOD:AM[:DEPTh]  [:SOURce[<n>]]:MOD:AM:INTernal:FREQuency  [:SOURce[<n>]]:MOD:FM:INTernal:FREQuency ...

  • Page 81: [:Source[]]:Output[][:State]

    Chapter 2 Command System RIGOL [:SOURce[<n>]]:OUTPut[<n>][:STATe] Syntax [:SOURce[<n>]]:OUTPut[<n>][:STATe] <bool> [:SOURce[<n>]]:OUTPut[<n>][:STATe]? Description Turn on or off the output of the specified source channel, or query the status of the output of the specified source channel. Parameter Name Type Range Default If omitted, the operation is [<n>]...

  • Page 82: [:Source[]]:Frequency[:Fixed]

    RIGOL Chapter 2 Command System [:SOURce[<n>]]:FREQuency[:FIXed] Syntax [:SOURce[<n>]]:FREQuency[:FIXed] <frequency> [:SOURce[<n>]]:FREQuency[:FIXed]? Description Set or query the output frequency of the specified source channel if the modulation is not enabled or the carrier frequency if the modulation is enabled. The default unit is Hz.

  • Page 83: [:Source[]]:Phase:initiate

    Chapter 2 Command System RIGOL [:SOURce[<n>]]:PHASe:INITiate Syntax [:SOURce[<n>]]:PHASe:INITiate Description Execute the align phase operation. Parameter Name Type Range Default If omitted, the operation is [<n>] Discrete {1|2} performed on source 1 by default Explanation When the align phase operation is performed, the instrument re-configures the two channels to make them output with the specified frequency and phase.

  • Page 84: [:Source[]]:Function:ramp:symmetry

    RIGOL Chapter 2 Command System [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry Syntax [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry <val> [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry? Description 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 %. Parameter...

  • Page 85: [:Source[]]:Voltage[:Level][:Immediate]:Offset

    Chapter 2 Command System RIGOL [:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate]:OFFSet Syntax [:SOURce[<n>]]:VOLTage[:LEVel] [:IMMediate]:OFFSet <offset> [:SOURce[<n>]]:VOLTage[:LEVel] [:IMMediate]:OFFSet? Description Set or query the DC offset of the specified source channel. The default unit is V. Parameter Name Type Range Default If omitted, the operation [<n>] Discrete...

  • Page 86: [:Source[]]:Mod[:State]

    RIGOL Chapter 2 Command System [:SOURce[<n>]]:MOD[:STATe] Syntax [:SOURce[<n>]]:MOD[:STATe] <bool> [:SOURce[<n>]]:MOD[:STATe]? Description Enable or disable the modulation of the specified source channel, or query the status of the modulation of the specified source channel. Parameter Name Type Range Default If omitted, the operation is [<n>]...

  • Page 87: [:Source[]]:Mod:am[:Depth]

    Chapter 2 Command System RIGOL [:SOURce[<n>]]:MOD:AM[:DEPTh] Syntax [:SOURce[<n>]]:MOD:AM[:DEPTh] <depth> [:SOURce[<n>]]:MOD:AM[:DEPTh]? Description 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 %. Parameter...

  • Page 88: [:Source[]]:Mod:am:internal:function

    RIGOL Chapter 2 Command System [:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion [:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion Syntax [:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion <wave> [:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion? [:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion <wave> [:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion? Description Set or query the modulating waveform of AM or FM of the specified source channel. Parameter Name Type Range Default If omitted, the operation is [<n>]...

  • Page 89: [:Source[]]:Apply

    Chapter 2 Command System RIGOL [:SOURce[<n>]]:APPLy? Syntax [:SOURce[<n>]]:APPLy? Description Query the output configurations of the specified source channel. Parameter Name Type Range Default If omitted, the operation is performed on [<n>] Discrete {1|2} source 1 by default Return The query returns the output configurations in “<waveform Format name>,<frequency>,<amplitude>,<offset>,<start phase>”...
  • Page 90 RIGOL Chapter 2 Command System Explanation These commands are used to select the waveform shape.  NOISe: select Noise PULSe: select Pulse RAMP: select Ramp SINusoid: select Sine SQUare: select Square USER: select Arbitrary waveform <freq>: set the frequency of the specified waveform (Noise does not have this ...

  • Page 91: System Commands

    Chapter 2 Command System RIGOL :SYSTem Commands The :SYSTem commands are used to set the system-related parameters, such as the sound and language. Command List: :SYSTem:AUToscale  :SYSTem:BEEPer  :SYSTem:ERRor[:NEXT]?  :SYSTem:GPIB  :SYSTem:LANGuage  :SYSTem:LOCKed  :SYSTem:PON  :SYSTem:OPTion:INSTall ...

  • Page 92: System:error[:Next]

    RIGOL Chapter 2 Command System :SYSTem:ERRor[:NEXT]? Syntax :SYSTem:ERRor[:NEXT]? Description Query and delete the last system error message. Return The query returns the error message in “<message number>,<message content>” Format format. Wherein, <message number> is an integer and <message content> is a ASCII string.

  • Page 93: System:pon

    :SYSTem:PON LATest :SYSTem:OPTion:INSTall Syntax :SYSTem:OPTion:INSTall <license> Description Install the option. Parameter Name Type Range Default Option serial number supplied by RIGOL <license> ASCII String None No spaces between characters. Example :SYSTem:OPTion:INSTall PDUY9N9QTS9PQSWPLAETRD3UJHYA :SYSTem:OPTion:UNINSTall Syntax :SYSTem:OPTion:UNINSTall Description Uninstall the options installed.

  • Page 94: Timebase Commands

    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. Command List: :TIMebase:DELay:ENABle  :TIMebase:DELay:OFFSet  :TIMebase:DELay:SCALe  :TIMebase[:MAIN]:OFFSet  :TIMebase[:MAIN]:SCALe ...

  • Page 95: Timebase:delay:scale

    Chapter 2 Command System RIGOL :TIMebase:DELay:SCALe Syntax :TIMebase:DELay:SCALe <scale_value> :TIMebase:DELay:SCALe? Description Set or query the delayed timebase scale. The default unit is s/div. Parameter Name Type Range Default <scale_value> Real Explanation 500ns Explanation The maximum of <scale_value> is the main timebase scale currently set and the ...

  • Page 96: Timebase[:Main]:Scale

    RIGOL Chapter 2 Command System :TIMebase[:MAIN]:SCALe Syntax :TIMebase[:MAIN]:SCALe <scale_value> :TIMebase[:MAIN]:SCALe? Description Set or query the main timebase scale. The default unit is s/div. Parameter Name Type Range Default <scale_value> Real Normal: 5ns to 50s in 1-2-5 step 1μs Roll: 200ms to 50s in 1-2-5 step...

  • Page 97: Trigger Commands

    Chapter 2 Command System RIGOL :TRIGger Commands The :TRIGger commands are used to set the trigger system of the oscilloscope. Command List: :TRIGger:MODE  :TRIGger:COUPling  :TRIGger:STATus?  :TRIGger:SWEep  :TRIGger:HOLDoff  :TRIGger:NREJect  :TRIGger:EDGe  :TRIGger:PULSe  :TRIGger:SLOPe ...

  • Page 98: Trigger:coupling

    RIGOL Chapter 2 Command System :TRIGger:COUPling Syntax :TRIGger:COUPling <couple> :TRIGger:COUPling? Description Select or query the trigger coupling type. Parameter Name Type Range Default <couple> Discrete {AC|DC|LFReject|HFReject} Explanation This command is only applicable to the edge trigger.  AC: block all the DC components and attenuate signals lower than 75 kHz.

  • Page 99: Trigger:holdoff

    Chapter 2 Command System RIGOL :TRIGger:HOLDoff Syntax :TRIGger:HOLDoff <value> :TRIGger:HOLDoff? Description Set or query the trigger holdoff time. The default unit is s. Parameter Name Type Range Default <value> Real 16ns to 10s 16ns Explanation Trigger holdoff can be used to stably trigger the complex waveforms (such as pulse ...

  • Page 100: Trigger:edge

    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 <source> :TRIGger:EDGe:SOURce? Description Set or query the trigger source in edge trigger. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|AC} CHANnel1 Return The query returns CHAN1, CHAN2, CHAN3, CHAN4 or AC.
  • Page 101 Chapter 2 Command System RIGOL :TRIGger:EDGe:LEVel Syntax :TRIGger:EDGe:LEVel <level> :TRIGger:EDGe:LEVel? Description Set or query the trigger level in edge trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default <level> Real (± 5 × VerticalScale from the screen center) - OFFSet...

  • Page 102: Trigger:pulse

    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 <source> :TRIGger:PULSe:SOURce? Description Set or query the trigger source in pulse width trigger. Parameter Name Type Range Default <source>...
  • Page 103 Chapter 2 Command System RIGOL :TRIGger:PULSe:WIDTh Syntax :TRIGger:PULSe:WIDTh <width> :TRIGger:PULSe:WIDTh? Description Set or query the pulse width in pulse width trigger. The default unit is s. Parameter Name Type Range Default PGReater, NGReater: 1μs <width> Real 8ns to 10s PLESs, NLESs: 2μs...
  • Page 104 RIGOL Chapter 2 Command System :TRIGger:PULSe:LWIDth Syntax :TRIGger:PULSe:LWIDth <width> :TRIGger:PULSe:LWIDth? Description Set or query the lower pulse width in pulse width trigger. The default unit is s. Parameter Name Type Range Default <width> Real 8ns to 9.99s 992ns Explanation This command is available when the trigger condition (refer to :TRIGger:PULSe:WHEN) is PGLess and NGLess.

  • Page 105: Trigger:slope

    Chapter 2 Command System RIGOL :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 <source> :TRIGger:SLOPe:SOURce? Description Set or query the trigger source in slope trigger. Parameter...
  • Page 106 RIGOL Chapter 2 Command System :TRIGger:SLOPe:WHEN Syntax :TRIGger:SLOPe:WHEN <when> :TRIGger:SLOPe:WHEN? Description Set or query the trigger condition in slope trigger. Parameter Name Type Range Default <when> Discrete {PGReater|PLESs|NGReater|NLESs|PGLess|NGLess} PGReater Explanation PGReater/PLESs: you need to specify a time value (refer to :TRIGger:SLOPe:TIME).
  • Page 107 Chapter 2 Command System RIGOL :TRIGger:SLOPe:TUPPer Syntax :TRIGger:SLOPe:TUPPer <time> :TRIGger:SLOPe:TUPPer? Description Set or query the upper limit of the time in slope trigger. The default unit is s. Parameter Name Type Range Default <time> Real 16ns to 10s 1μs Explanation This command is available when the trigger condition (refer to :TRIGger:SLOPe:WHEN) is PGLess and NGLess.
  • Page 108 RIGOL Chapter 2 Command System :TRIGger:SLOPe:WINDow Syntax :TRIGger:SLOPe:WINDow <window> :TRIGger:SLOPe:WINDow? Description Set or query the vertical window type in slope trigger. Parameter Name Type Range Default <window> Discrete {TA|TB|TAB} Explanation TA: only adjust the upper limit of the trigger level, refer to :TRIGger:SLOPe:ALEVel.
  • Page 109 Chapter 2 Command System RIGOL :TRIGger:SLOPe:BLEVel Syntax :TRIGger:SLOPe:BLEVel <level> :TRIGger:SLOPe:BLEVel? Description Set or query the lower limit of the trigger level in slope trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default <level>...

  • Page 110: Trigger:video

    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 <source> :TRIGger:VIDeo:SOURce? Description Select or query the trigger source in video trigger. Parameter Name Type Range Default <source>...
  • Page 111 Chapter 2 Command System RIGOL :TRIGger:VIDeo:MODE Syntax :TRIGger:VIDeo:MODE <mode> :TRIGger:VIDeo:MODE? Description Set or query the sync type in video trigger. Parameter Name Type Range Default <mode> Discrete {ODDField|EVENfield|LINE|ALINes} ALINes Explanation ODDField: trigger on the rising edge of the first ramp waveform pulse in the odd ...
  • Page 112 RIGOL Chapter 2 Command System :TRIGger:VIDeo:STANdard Syntax :TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard? Description Set or query the video standard in video trigger. Parameter Name Type Range Default <standard> Discrete {PALSecam|NTSC|480P|576P} NTSC Explanation PALSecam:  PAL: the frame frequency is 25 frames per second. The TV sweep line is 625 with the odd field goes first and the even field follows behind.

  • Page 113: Trigger:pattern

    Chapter 2 Command System RIGOL :TRIGger:PATTern Command List: :TRIGger:PATTern:PATTern  :TRIGger:PATTern:LEVel  :TRIGger:PATTern:PATTern Syntax :TRIGger:PATTern:PATTern <pattern1>,<pattern2>,<pattern3>,<pattern4> :TRIGger:PATTern:PATTern? Description Set or query the pattern of each channel in pattern trigger. Parameter Name Type Range Default <pattern1> Discrete {H|L|X|R|F} <pattern2> Discrete {H|L|X|R|F} <pattern3>...
  • Page 114 RIGOL Chapter 2 Command System :TRIGger:PATTern:LEVel Syntax :TRIGger:PATTern:LEVel <chan>,<level> :TRIGger:PATTern:LEVel? <chan> Description Set or query the trigger level of the specified channel in pattern trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default <chan>...

  • Page 115: Trigger:duration

    Chapter 2 Command System RIGOL :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 <source> :TRIGger:DURATion:SOURce? Description Set or query the trigger source in duration trigger. Parameter Name Type Range Default <source> Discrete...
  • Page 116 RIGOL Chapter 2 Command System :TRIGger:DURATion:WHEN Syntax :TRIGger:DURATion:WHEN <when> :TRIGger:DURATion:WHEN? Description Set or query the trigger condition in duration trigger. Parameter Name Type Range Default <when> Discrete {GREater|LESS|GLESs} GREater Explanation GREater: you need to specify a time (refer to :TRIGger:DURATion:TLOWer). The ...
  • Page 117 Chapter 2 Command System RIGOL :TRIGger:DURATion:TLOWer Syntax :TRIGger:DURATion:TLOWer <NR3> :TRIGger:DURATion:TLOWer? Description Set or query the duration time lower limit in duration trigger. The default unit is s. Parameter Name Type Range Default <NR3> Real 8ns to 9.99s 1μs Explanation This command is available when the trigger condition (:TRIGger:DURATion:WHEN) is GREater or GLESs.

  • Page 118: Trigger:timeout (Option)

    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 <source> :TRIGger:TIMeout:SOURce? Description Set or query the trigger source in timeout trigger. Parameter Name Type Range Default <source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 Return The query returns CHAN1, CHAN2, CHAN3 or CHAN4.
  • Page 119 Chapter 2 Command System RIGOL :TRIGger:TIMeout:TIMe Syntax :TRIGger:TIMeout:TIMe <NR3> :TRIGger:TIMeout:TIMe? Description Set or query the timeout time in timeout trigger. The default unit is s. Parameter Name Type Range Default <NR3> Real 16ns to 10s 16ns Return The query returns the timeout time in scientific notation.

  • Page 120: Trigger:runt (Option)

    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 <source> :TRIGger:RUNT:SOURce? Description Set or query the trigger source in runt trigger. Parameter Name...
  • Page 121 Chapter 2 Command System RIGOL :TRIGger:RUNT:WHEN Syntax :TRIGger:RUNT:WHEN <when> :TRIGger:RUNT:WHEN? Description Set or query the qualifier in runt trigger. Parameter Name Type Range Default <when> Discrete {NONE|GREater|LESS|GLESs} NONE Explanation NONE: do not set the trigger condition in runt trigger. ...
  • Page 122 RIGOL Chapter 2 Command System :TRIGger:RUNT:WLOWer Syntax :TRIGger:RUNT:WLOWer <NR3> :TRIGger:RUNT:WLOWer? Description Set or query the pulse width lower limit in runt trigger. The default unit is s. Parameter Name Type Range Default <NR3> Discrete 8ns to 9.99s 1μs Explanation This command is only available when the qualifier (refer to :TRIGger:RUNT:WHEN) is GREater or GLESs.
  • Page 123 Chapter 2 Command System RIGOL :TRIGger:RUNT:BLEVel Syntax :TRIGger:RUNT:BLEVel <level> :TRIGger:RUNT:BLEVel? Description Set or query the trigger level lower limit in runt trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default <level> Real (± 5 × VerticalScale from the screen center) - OFFSet Explanation For VerticalScale, refer to :CHANnel<n>:SCALe.

  • Page 124: Trigger:windows (Option)

    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 <source> :TRIGger:WINDows:SOURce? Description Set or query the trigger source in windows trigger. Parameter Name Type Range Default <source>...
  • Page 125 Chapter 2 Command System RIGOL :TRIGger:WINDows:POSition Syntax :TRIGger:WINDows:POSition <pos> :TRIGger:WINDows:POSition? Description Set or query the trigger position in windows trigger. Parameter Name Type Range Default <type> Discrete {EXIT|ENTER|TIMe} ENTER Explanation EXIT: trigger when the input signal exits the specified trigger level range.
  • Page 126 RIGOL Chapter 2 Command System :TRIGger:WINDows:ALEVel Syntax :TRIGger:WINDows:ALEVel <level> :TRIGger:WINDows:ALEVel? Description Set or query the trigger level upper limit in windows trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default <level> Real (± 5 × VerticalScale from the screen center) - OFFSet Explanation For VerticalScale, refer to :CHANnel<n>:SCALe.

  • Page 127: Trigger:delay (Option)

    Chapter 2 Command System RIGOL :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 <Source> :TRIGger:DELay:SA? Description Set or query the trigger source A in delay trigger. Parameter...
  • Page 128 RIGOL Chapter 2 Command System :TRIGger:DELay:SLOPB Syntax :TRIGger:DELay:SLOPB <slope> :TRIGger:DELay:SLOPB? Description Set or query the edge type of the trigger source B in delay trigger. Parameter Name Type Range Default <slope> Discrete {POSitive|NEGative} POSitive Return The query returns POS or NEG.
  • Page 129 Chapter 2 Command System RIGOL :TRIGger:DELay:TUPPer Syntax :TRIGger:DELay:TUPPer <NR3> :TRIGger:DELay:TUPPer? Description Set or query the upper limit of the delay time in delay trigger. The default unit is s. Parameter Name Type Range Default <NR3> Real 16ns to 10s 2μs...

  • Page 130: Trigger:shold (Option)

    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 <source> :TRIGger:SHOLd:DSrc? Description Set or query the data source in setup/hold trigger. Parameter Name...
  • Page 131 Chapter 2 Command System RIGOL :TRIGger:SHOLd:PATTern Syntax :TRIGger:SHOLd:PATTern <pattern> :TRIGger:SHOLd:PATTern? Description Set or query the data type in setup/hold trigger. Parameter Name Type Range Default <pattern> Discrete {H|L} Explanation H: high level L: low level Return The query returns H or L.
  • Page 132 RIGOL Chapter 2 Command System :TRIGger:SHOLd:STIMe Syntax :TRIGger:SHOLd:STIMe <NR3> :TRIGger:SHOLd:STIMe? Description Set or query the setup time in setup/hold trigger. The default unit is s. Parameter Name Type Range Default <NR3> Real 8ns to 1s 1μs Explanation This command is only available when the setup type (refer to :TRIGger:SHOLd:TYPe) is SETup or SETHOLd.

  • Page 133: Trigger:nedge (Option)

    Chapter 2 Command System RIGOL :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 <source> :TRIGger:NEDGe:SOURce? Description Set or query the trigger source in Nth edge trigger. Parameter Name Type Range Default <source>...
  • Page 134 RIGOL Chapter 2 Command System :TRIGger:NEDGe:IDLE Syntax :TRIGger:NEDGe:IDLE <NR3> :TRIGger:NEDGe:IDLE? Description Set or query the idle time in Nth edge trigger. The default unit is s. Parameter Name Type Range Default <NR3> Real 16ns to 10s 1μs Return Format The query returns the idle time in scientific notation.

  • Page 135: Trigger:rs232 (Option)

    Chapter 2 Command System RIGOL :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 <source> :TRIGger:RS232:SOURce? Description Set or query the trigger source in RS232 trigger.
  • Page 136 RIGOL Chapter 2 Command System :TRIGger:RS232:PARity Syntax :TRIGger:RS232:PARity <parity> :TRIGger:RS232:PARity? Description Set or query the parity type when the trigger condition is ERRor or PARity in RS232 trigger. Parameter Name Type Range Default <parity> Discrete {EVEN|ODD|NONE} NONE Explanation When the trigger condition is PARity, the parity type cannot be set to NONE. At this point, the default parity type is ODD.
  • Page 137 Chapter 2 Command System RIGOL :TRIGger:RS232:WIDTh Syntax :TRIGger:RS232:WIDTh <width> :TRIGger:RS232:WIDTh? Description Set or query the data bits when the trigger condition is DATA in RS232 trigger. Parameter Name Type Range Default <width> Discrete {5|6|7|8} Return Format The query returns 5, 6, 7 or 8.
  • Page 138 RIGOL Chapter 2 Command System :TRIGger:RS232:LEVel Syntax :TRIGger:RS232:LEVel <level> :TRIGger:RS232:LEVel? Description Set or query the trigger level in RS232 trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default <level> Real (± 5 × VerticalScale from the screen center) - OFFSet Explanation For VerticalScale, refer to :CHANnel<n>:SCALe.

  • Page 139: Trigger:iic (Option)

    Chapter 2 Command System RIGOL :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 <source> :TRIGger:IIC:SCL? Description Set or query the channel source of SCL in I2C trigger.
  • Page 140 RIGOL Chapter 2 Command System :TRIGger:IIC:WHEN Syntax :TRIGger:IIC:WHEN <trig_type> :TRIGger:IIC:WHEN? Description Set or query the trigger condition in I2C trigger. Parameter Name Type Range Default {STARt|RESTart|STOP|NACKnowledge|ADD <trig_type> Discrete STARt Ress|DATA|ADATa} Explanation STARt: trigger when the SDA data transitions from high to low while the SCL is ...
  • Page 141 Chapter 2 Command System RIGOL :TRIGger:IIC:ADDRess Syntax :TRIGger:IIC:ADDRess <adr> :TRIGger:IIC:ADDRess? Description Set or query the address when the trigger condition is ADDRess or ADATa in I2C trigger. Parameter Name Type Range Default <adr> Integer 0 to 2 – 1: 0 to 127, 0 to 255 or 0 to 1023...
  • Page 142 RIGOL Chapter 2 Command System :TRIGger:IIC:CLEVel Syntax :TRIGger:IIC:CLEVel <level> :TRIGger:IIC:CLEVel? Description Set or query the trigger level of SCL in I2C trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default <level> Real (± 5 × VerticalScale from the screen center) - OFFSet Explanation For VerticalScale, refer to :CHANnel<n>:SCALe.

  • Page 143: Trigger:spi (Option)

    Chapter 2 Command System RIGOL :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 <source> :TRIGger:SPI:SCL? Description Set or query the channel source of SCL in SPI trigger.
  • Page 144 RIGOL Chapter 2 Command System :TRIGger:SPI:WHEN Syntax :TRIGger:SPI:WHEN <trig_type> :TRIGger:SPI:WHEN? Description Set or query the trigger condition in SPI trigger. Parameter Name Type Range Default <trig_type> Discrete {CS|TIMeout} Explanation When the trigger condition is set to TIMeout, you can use the :TRIGger:SPI:TIMeout command to set the timeout value.
  • Page 145 Chapter 2 Command System RIGOL :TRIGger:SPI:TIMeout Syntax :TRIGger:SPI:TIMeout <time_value> :TRIGger:SPI:TIMeout? Description Set or query the timeout value when the trigger condition is TIMeout in SPI trigger. The default unit is s. Parameter Name Type Range Default <time_value> Real 100ns to 1s 1μs...
  • Page 146 RIGOL Chapter 2 Command System :TRIGger:SPI:DLEVel Syntax :TRIGger:SPI:DLEVel <level> :TRIGger:SPI:DLEVel? Description Set or query the trigger level of the SDA channel in SPI trigger. The unit is the same as the current amplitude unit. Parameter Name Type Range Default <level>...

  • Page 147: Waveform Commands

    Chapter 2 Command System RIGOL :WAVeform Commands The :WAVeform commands are used to read the waveform data and its related settings. :WAVeform:MODE is used to set the reading mode of the waveform data. In different mode, the definition of each parameter is different, as shown in Figure 2-1 and Figure 2-2.

  • Page 148: Waveform:source

    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 <source> :WAVeform:SOURce? Description Set or query the channel of which the waveform data will be read.

  • Page 149: Waveform:mode

    Chapter 2 Command System RIGOL :WAVeform:MODE Syntax :WAVeform:MODE <mode> :WAVeform:MODE? Description Set or query the reading mode used by :WAVeform:DATA?. Parameter Name Type Range Default <mode> Discrete {NORMal|MAXimum|RAW} NORMal Explanation NORMal: read the waveform data displayed on the screen. ...

  • Page 150: Waveform:data

    RIGOL Chapter 2 Command System :WAVeform:DATA? Syntax :WAVeform:DATA? Description Read the waveform data. Explanation Procedures of the screen waveform data reading:  Set the channel: :WAV:SOURce CHAN1 Select the NORMal mode: :WAV:MODE NORM Read the screen waveform data: :WAV:DATA? Procedures of the internal memory waveform data reading: ...

  • Page 151: Waveform:xincrement

    Chapter 2 Command System RIGOL :WAVeform:XINCrement? Syntax :WAVeform:XINCrement? Description Query the time difference between two neighboring points of the specified channel source in the X direction. Explanation The returned value is related to the current data reading mode:  In the NORMal mode, XINCrement = TimeScale/100;...

  • Page 152: Waveform:yincrement

    RIGOL Chapter 2 Command System :WAVeform:YINCrement? Syntax :WAVeform:YINCrement? Description Query the waveform increment of the specified channel source in the Y direction. The unit is the same as the current amplitude unit. Explanation YINCrement= VerticalScale/25 Return The query returns the YINCrement in scientific notation.

  • Page 153: Waveform:start

    Chapter 2 Command System RIGOL :WAVeform:STARt Syntax :WAVeform:STARt <sta> :WAVeform:STARt? Description Set or query the start position of internal memory waveform reading. Parameter Name Type Range Default NORMal: 1 to 1200 MAX: 1 to the number of effective points currently <sta>...

  • Page 154: Waveform:preamble

    RIGOL Chapter 2 Command System :WAVeform:PREamble? Syntax :WAVeform:PREamble? Description Query and return all the waveform parameters. Return The query returns 10 waveform parameters separated by “,”: Format <format>,<type>,<points>,<count>,<xincrement>,<xorigin>,<xreference>,<yincrem ent>,<yorigin>,<yreference> Wherein, <format>: 0 (BYTE), 1 (WORD) or 2 (ASC). <type>: 0 (NORMal), 1 (MAXimum) or 2 (RAW).

  • Page 155: Chapter 3 Programming Demos

    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.

  • Page 156: Programming Preparations

    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.

  • Page 157: Excel Programming Demo

    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. Create a new Excel file that enables the Macros. In this demo, the file is named as DS1000Z_Demo_Excel.xlsm.
  • Page 158 RIGOL Chapter 3 Programming Demos 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.
  • Page 159 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.
  • Page 160 RIGOL 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”...

  • Page 161: Matlab Programming Demo

    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. Run the Matlab software and modify the current directory (namely modify the Current Directory at the top of the software).
  • Page 162 RIGOL Chapter 3 Programming Demos Run the M file and the running result is as follows. DS1000Z Programming Guide...

  • Page 163: Labview Programming Demo

    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. Run LabVIEW 2009, create a VI file and name it as DS1000Z_Demo.
  • Page 164 RIGOL Chapter 3 Programming Demos 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.
  • Page 165 Chapter 3 Programming Demos RIGOL Get the length of the effective waveform data. 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.
  • Page 166 RIGOL Chapter 3 Programming Demos Select the device resource from the VISA Resource Name list box and run the program. 3-12 DS1000Z Programming Guide...

  • Page 167: Visual Basic Programming Demo

    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: Build a standard application program project (Standard EXE) and name it as Demo.
  • Page 168 RIGOL Chapter 3 Programming Demos Dim matches As String * 200 ' keep the device number acquired Dim s32Disp As Integer ' acquire the usb source of visa Call viOpenDefaultRM(defrm) Call viFindRsrc(defrm, "USB?*", list, nmatches, matches) ' Open the device...

  • Page 169: Visual C++ Programming Demo

    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.
  • Page 170 RIGOL Chapter 3 Programming Demos Open the Directories tab in ToolsOptions. Select Include files in Show directories for and double-click the blank in Directories to add the path of Include: C:\Program Files\IVI Foundation\VISA\WinNT\include. Select Library files in Show directories for and double-click the blank in Directories to add the path of Lib: C:\Program Files\IVI Foundation\VISA\WinNT\lib\msc.
  • Page 171 Chapter 3 Programming Demos RIGOL Add the variables m_combox and m_receive for the Combo Box and Edit controls respectively. Add codes. Double-click Send and Read to enter the programming environment. Declare the #include <visa.h> of the visa library in the header file and then add the following codes.
  • Page 172 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);...

This manual is also suitable for:

Ds1104zDs1074zDs1104z-sDs1074z-s

Table of Contents