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 shall not be liable for losses caused by either incidental or consequential in connection with
the furnishing, use or performance of this manual as well as any information contained.
Any part of this document is forbidden to be copied or photocopied or rearranged without prior written
approval of RIGOL.
Product Certification
RIGOL guarantees this product conforms to the national and industrial standards in China as well as the
ISO9001:2008 standard and the ISO14001:2004 standard. Other international standard conformance
certification is in progress.
Contact Us
If you have any problem or requirement when using our products or this manual, please contact RIGOL.
E-mail: service@rigol.com
Website: www.rigol.com
DS1000Z Programming Guide I
RIGOL
Tip
For the newest version of this manual, please download it from www.rigol.com.
Model
Analog Bandwidth
Channel Number
Source Channel Number
DS1104Z
100 MHz
4
None
DS1074Z
70 MHz
4
None
DS1104Z-S
100 MHz
4 2 DS1074Z-S
70 MHz
4
2
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.
Chapter 2 Command System
This chapter introduces the syntax, function, parameter and using instruction of each command.
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.
Format Conventions in this Manual:
1. Button
The function key at the front panel is denoted by the format of “Button Name (Bold) + Text Box” in the
manual, for example, Utility denotes the “Utility” key.
2. Menu
The menu item is denoted by the format of “Menu Word (Bold) + Character Shading” in the manual,
for example, System denotes the “System” item under Utility.
3. Operation Step
The next step of the operation is denoted by an arrow “” in the manual. For example, Utility
System denotes pressing Utility at the front panel and then pressing System.
Content Conventions in this Manual:
DS1000Z series include the following models. Unless otherwise noted, this manual takes DS1104Z-S as an
example to illustrate the command system of DS1000Z series.
II DS1000Z Programming Guide
Contents RIGOL
Contents
Guaranty and Declaration ......................................................................................................... I
Document Overview ................................................................................................................. II
Visual C++ Programming Demo ............................................................................................. 3-15
VI DS1000Z Programming Guide
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.
Main topics of this chapter:
To Build Remote Communication
Remote Control Methods
SCPI Command Overview
DS1000Z Programming Guide1-1
RIGOL Chapter 1 Programming Overview
1
2 3 4
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
CD supplied with the accessories and install it according to the instructions.
2. Connect the instrument and PC and configure the interface parameters of the instrum ent
DS1000Z can build communication with PC through USB, LAN or G PIB (option) interface. This manual
takes USB as an example.
(1) Connect the devices
Connect the USB DEVICE interface at the real panel of the oscilloscope and the USB Host interface
of the PC using USB cable.
(2) Install the USB driver
This oscilloscope is a USBTMC device. Assuming that your PC has already been installed with
Ultra Sigma, after y ou connect the oscilloscope to the PC and turn both on for the first time (the
oscilloscope is automatically configured to USB interface), the New Hardware Wizard as shown
in the figure below is displayed on the PC. Please install the “USB Test and Measurement Device”
driver following the directions in the wizard. The steps are as follows.
www.rigol.com or acquire it from the resource
1-2 DS1000Z Programming Guide
Chapter 1 Programming Overview RIGOL
5 6 7
(3) Search 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
During the search, the status bar of the software is as shown in the figure below.
to search the resources.
DS1000Z Programming Guide 1-3
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.
(5) Communication test
Right click the resource name “DS1104Z (USB0::0x1AB1::0x04CE::DS1T0000000006::INSTR)” to
select “SCPI Panel Control” to turn on the remote command control panel (as shown in the figure
below) through which you can send commands and read data.
Remote Control Methods
1. User-defined Programming
Users can use SCPI (Standard Commands for Programmable I nstruments) command s to pr ogr am and
control the oscilloscope. For details, refer to the introductions in Chapter 3
2. Send SCPI Commands via the PC Software
You can control the oscilloscope remotely by sending SCPI commands via the PC software (Ultra Sigma)
provided by RIGOL
Automation Explorer” of NI (National Instruments Corporation) or the “Agilent IO Libraries Suite” of
Agilent (Agilent Technologies, Inc.).
1-4 DS1000Z Programming Guide
. Besides, you can also control the instrument using the “Measurement &
Programming Demos.
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)). This section introduces the syntax, symbols,
parameters and abbreviation rules of the SCPI commands.
Syntax
The command string usually starts with ":"; the keywords are separated by ":" and are followed by the
parameter settings available; "?" is added at the end of the command string to indicate query; the
command and param e t e r are separated by "space".
For example,
:ACQuire:TYPE <type>
:ACQuire:TYPE?
ACQuire is the root keyword of the command. TYPE is the second-level keyword. The command string starts
with ":" which separates the multiple-level keywords. <type> represents the parameters available for
setting. "?" represents query . The command :ACQuire:TYPE and parameter <type> are separated by space.
"," is generally used for separating multiple parameters contained in the same command, for example,
:TRIGger:PATTern:PATTern <pattern1>,<pattern2>,<pattern3>,<pattern4>
Symbol Description
The following symbols will not be sent with the commands.
1.Braces {}
The parameters enclosed in the braces are optional and are usually separated by the vertic al bar "|".
When using the command, one of the parameters must be selected.
2.Vertical Bar |
The vertical bar is used to separate multiple parameters and one of the parameters must be selected
when using the command.
3.Square Brackets []
The content in the square brackets can be omitted.
4.Triangle Brackets <>
The parameter enclosed in the triangle brackets must be replaced by an effective value.
DS1000Z Programming Guide 1-5
RIGOL Chapter 1 Programming Overview
Parameter Type
1. 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.
2. Discrete
The parameter could be any of the values listed. For example,
:ACQuire:TYPE <type>
:ACQuire:TYPE?
Wherein,
<type> can be set to NORMal|AVERages|PEAK|HRESolution.
The query returns the abbreviations (NORM, AVER, PEAK or HRES).
3. Integer
Unless otherwise noted, the parameter can be any integer (NR1 format) within the effective value
range. Note that do not set the parameter to a decimal, otherwise errors will occur. For example,
:DISPlay:GBRightness <brightness>
:DISPlay:GBRightness?
Wherein,
<brightness> can be set to any integer between 0 and 100.
The query returns an integer between 0 and 100.
4. Real
The parameter can be any real number within the effective value range and this command accepts
decimal (NR2 format) and scientific notation (NR3 format) parameter input. For example,
:TRIGger:TIMeout:TIMe <NR3>
:TRIGger:TIMeout:TIMe?
Wherein,
<NR3> can be set to any r eal number between 1.600000e-08 (namely 16ns) to 0.1e+02 namely 10s).
The query returns a real number in scientific notation.
5. ASCII String
The parameter should be the combinations of ASCII characters.
For example,
:SYSTem:OPTion:INSTall <license>
Wherein,
<license> can be set to PDUY9N9QTS9PQSWPLAETRD3UJHYA.
Command Abbreviation
All the commands are case-insensitive and you can use any of them. If abbreviation is used, all the capital
letters in the command must be written completely. For example, the :MEASure:ADISplay? command can
be abbreviated to :MEAS:ADIS?.
1-6 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
Chapter 2 Command System
This chapter introduces the syntax, function, parameter and using instruction of each DS1000Z command.
1. Unless otherwise noted, this manual takes DS1104Z-S as an example to introduces the commands.
2. For parameter setting commands (for example, time , frequency, amplitude and etc.), the oscilloscope
can only accept numbers and set the parameters using default units and can not recognize the units
following the parameters. For the default units of each parameter, please refer to the description in
each command listed following.
DS1000Z Programming Guide2-1
RIGOL Chapter 2 Command System
Syntax
:AUToscale
the front panel.
waveform, this command is invalid.
Syntax
:CLEar
still be displayed. This command is equivalent to press the CLEAR key at the front panel.
Command
:STOP
waveform, this command is invalid.
: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
Explanation Theoretically, wavef orm auto setting f unction requires that the frequ ency of sine can
not be lower than 41Hz, the duty cycle should be greater than 1% as well as the
amplitude must be greater than 20mVpp for square.
When the pass/fail function is enabled (see the
this command, the oscilloscope will disable the pass/fail function firstly and the
execute waveform auto setting function.
When the waveform record function is enabled or during playback the recorded
:MASK:ENABle command), if y ou sent
:CLEar
Description Clear all the waveforms on the screen. If the oscilloscope is in RUN state, wavef orm will
Related
:DISPlay:CLEar
:RUN
:STOP
Syntax :RUN
Description The :RUN command makes the oscilloscope starting running and the :STOP command
makes the oscilloscope stopping running. These commands are equivalent to press the
RUN/STOP key at the front panel.
Explanation When the waveform record function is enabled or during playback the recorded
2-2 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
Syntax
:SINGle
the :TRIGger:SWEep SINGle command.
waveform, this command is invalid.
:STOP
Syntax
:TFORce
key at the front panel.
Command
: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
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
Related
Command
:TFORce
:RUN
:TFORce
Description Generate a trigger signal forcefully. This command is only applicable to normal and single
Related
trigger mode (see the
:TRIGger:SWEep
:TRIGger:SWEep command) and is equivalent to press the FORCE
DS1000Z Programming Guide 2-3
RIGOL Chapter 2 Command System
:ACQuire:AVERages?
Description
Set or query the number of averages under average acquisition mode.
Name
Type
Range
Default
<count>
Integer
2n (n is an integer and ranges from 1 to 10)
2
response of the displayed waveform to the waveform changes will be.
Format
:ACQuire:AVERages? /*The query returns 128*/
: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.
: In the “Command List” in this manual, the parameters in the setting commands and the query
commands are not included and you can refer to the complete introductions of the commands in the text
according to the keyword.
:ACQuire:AVERages
Syntax :ACQuire:AVERages <count>
[1]
:
Parameter
Explanation You can sent the :ACQuire:TYPE command to set the acquisition mode.
In average acquisition mode, the greater the number of av erages is, the lower the
noise will be and the higher the vertical resolution will be but the slower the
Return
Example
Related
Command
The query returns an integer between 2 and 1024.
:ACQuire:AVERages 128 /*Set the number of averages to 128*/
:ACQuire:TYPE
2-4 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:ACQuire:MDEPth?
points that can be stored in a single trigger sample. The default unit is pts (points).
Name
Type
Range
Default
according to the current sample rate.
Format
:ACQuire:MDEPth? /*The query returns 12000*/
:TIMebase[:MAIN]:SCALe
:ACQuire:MDEPth
Syntax :ACQuire:MDEPth <mdep>
Description Set or query the memory depth of the oscilloscope namely the number of waveform
Parameter
<mdep>
Discrete Refer to the Explanation
AUTO
Explanation When a single channel is on: {AUTO|12000|120000|1200000|12000000|24000000}
When dual channels are on: {AUTO|6000|60000|600000|6000000|12000000}
When four channels are on: {AUTO|3000|30000|300000|3000000|6000000}
Wherein, 24000000, 12000000 and 6000000 are optional.
The relationship among the memory depth, sample rate and waveform length is
satisfied with the following equation:
Memory Depth = Sample Rate × Waveform Length
Wherein, the Memory Depth can be set using the
:ACQuire:MDEPth command and
the Waveform Length is the product of the horizontal timebase (set by
:TIMebase[:MAIN]:SCALe command) and the number of the horizontal scales
the
(12 for DS1000Z).
When AUTO is selected, the oscilloscope will select the memory depth automatically
Return
Example
Related
The query returns the actual number of points (integer) or AUTO.
:ACQuire:MDEPth 12000 /*Set the memory depth to 12000*/
:ACQuire:SRATe?
Command
DS1000Z Programming Guide 2-5
RIGOL Chapter 2 Command System
:ACQuire:TYPE?
Description
Set or query the acquisition mode when the oscilloscope samples.
Name
Type
Range
Default
<type>
Discrete
{NORMal|AVERages|PEAK|HRESolution}
NORMal
storage rate of the acquisition memory.
Format
Example
:ACQuire:TYPE AVERages /*Select the average a c quisition mode*/
Command
:ACQuire:TYPE
Syntax :ACQuire:TYPE <type>
Parameter
Explanation
Return
NORMal
: in this mode, the oscilloscope samples the signal at equal time interval to
rebuild the waveform. For most of the waveforms, the best display effect can be
obtained using this mode.
AVERages: in
this mode, the oscilloscope averages the waveforms from multiple
samples to reduce the random noise of the input signal and improve the vertical
resolution. The number of averages can be set by senting the
command.
The gr eater the number of av erages is, the lower the n oise will be and the
:ACQuire:AVERages
higher the vertical resolution will be but the slower the response of the displayed
waveform to the waveform changes will be.
PEAK (Peak Detect): in this mode, the oscilloscope acquires the maximum and
minimum values of the signal within the sample interval to get the envelope of the
signal or the narrow pulse of the signal that might be lost. In this mode, signal
confusion can be prevented but the noise displayed would be larger.
HRESolution (High Resolution): this mode uses a kind of ultra-sample technique to
average the neighboring points of the sample waveform to reduce the r andom noise
on the input signal and generate much smoother waveforms on the screen. This is
generally used when the sample rate of the digital converter is higher than the
The query returns NORM, AVER, PEAK or HRES.
Related
:ACQuire:AVERages
2-6 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:ACQuire:SRATe?
Query the current sample rate. The default unit is Sa/s.
The oscilloscope starts to execute self-calibration.
sent the :CALibrate:QUIT command to quit the self-calibration.
Command
:ACQuire:SRATe?
Syntax
Description
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 is
satisfied with the following equation:
Memory Depth = Sample Rate × Waveform Length
Wherein, the Memory Depth can be set using the
the Waveform Length is the product of the horizontal timebase (set by
:TIMebase[:MAIN]:SCALe command) and the number of the horizontal scales
the
:ACQuire:MDEPth command and
Return
Related
Command
The query returns the sample rate in scientific notation.
:ACQuire:MDEPth
:TIMebase[:MAIN]:SCALe
:CALibrate Commands
Command List:
:CALibrate:QUIT
:CALibrate:STARt
:CALibrate:QUIT
Related
:CALibrate:STARt
:CALibrate:STARt
Explanation The self-calibration can make the oscilloscope quickly reach its optimum working
state to obtain the most accurate measurement values.
During the self-calibration, all the channels of the oscilloscope must be disconnected
from the inputs.
The functions of most of the keys are disabled during the self-calibration. You can
Related
DS1000Z Programming Guide 2-7
:CALibrate:QUIT
RIGOL Chapter 2 Command System
:CHANnel<n>:BWLimit?
Description
Set or query the bandwidth limit parameter of the specified channel.
Name
Type
Range
Default
<n>
Discrete
{1|2|3|4}
<type>
Discrete
{20M|OFF}
OFF
frequency components.
Format
Example
:CHANnel1:BWLimit 20M /*Enable the 20MHz bandwidth limit*/
:CHANnel<n> Commands
:CHANnel<n> commands are used to set or query the vertical system parameters, such as bandwidth limit,
coupling, vertical scale and vertical offset.
Description Set or query the delay calibration time of the specified channel to calibrate the zero of fset
Parameter
<n> Discrete {1|2|3|4}
——
Explanation The <val> parameter can only be set to specific values in specified step. If the parameter
you sent is not one of the values that can be set, the parameter will be set automatically
to the nearest value. The step varies with the horizontal timebase (set by
:TIMebase[:MAIN]:SCALe command).
the
Return
The query returns the delay calibration time in scientific notation.
Example
Related
:CHANnel1:TCAL 0.00002 /*Set the delay calibration time to 20ns*/
:TIMebase[:MAIN]:SCALe
DS1000Z Programming Guide 2-11
RIGOL Chapter 2 Command System
:CHANnel<n>:SCALe?
Description
Set or query the vertical scale of the specified channel. The default unit is V.
Name
Type
Range
Default
used to improve the amplitude of waveform display to view signal d etails.
<n> Discrete {1|2|3|4}
<scale> Real Be dependent on the current probe ratio.
probe ratio = 1: 1mV to 10V
——
1V (the probe
ratio is 10)
probe ratio = 10 (default): 10mV to 100V
Explanation The range of the vertical scale is dependent on the current probr ratio (set by
:CHANnel<n>:PROBe command). Because the default probe ratio of DS1000Z is
the
10, the default value of <scale> is the value when the probe ratio is 10.
You can use the
:CHANnel<n>:VERNier command to enable or disable the fine
adjustment of the vertical scale. By default, the fine adjustment is off. At this point,
you can only set the vertical scale in 1-2-5 step, namely 1mV, 2mV, 5mV, 10mV, …,
10V. When the fine adjustment is on, you can further adjust the vertical scale within
a relatively smaller range to improve vertical resolution. If the amplitude of the input
waveform is a little bit greater than the full scale under the current scale and the
amplitude would be a little bit lower if the next scale is used, fine adjustment can be
Return
Example
Related
The query returns the vertical scale in scientific notation.
:CHANnel1:SCALe 1 /*Set the vertical scale of CH1 to 1V*/
Explanation By default, the fine adjustment is off. At this point, you can only set the vertical scale in
1-2-5 step, namely 1mV, 2mV, 5mV, 10mV…10V. When the fine adjustment is on, you can
further adjust the vertical scale within a relatively smaller range to improve vertical
resolution. If the amplitude of the input waveform is a little bit greater than the full scale
under the current scale and the amplitude would be a little bit lower if the next scale is
used, fine adjustment can be used to improve the amplitude of waveform display to view
——
Return
Related
The query returns 0 or 1.
:CHANnel<n>:SCALe
DS1000Z Programming Guide 2-13
RIGOL Chapter 2 Command System
:CURSor:MODE?
Description
Set or query the cursor measurement mode.
Name
Type
Range
Default
<mode>
Discrete
{OFF|MANual|TRACk|AUTO|XY}
OFF
horizontal timebase mode is XY.
Format
Example
:CURSor:MODE MANual /*enable the manual cursor mode*/
:CURSor Commands
:CURSor comm ands are used to me asure the X -axis v alue (such as time) and Y-axis value (such as voltage)
of the waveform displayed in the screen.
Explanation OFF: disable the cursor measurement function.
MANual: enable the manual cursor measurement mode.
TRACk: enable the track cursor measurement mode.
AUTO: enable the auto cursor measurement mode.
XY: enable the XY cursor measurement mode. This mode is valid only when the
Explanation X: select X type cursor. The X type cursors are a vertical solid line (cursor A) and a
vertical dotted line (cursor B) and are usually used to measure time parameters.
Y: select Y type cursor. The Y type cursors are a horizontal solid line (cursor A) and a
horizontal dotted line (cursor B) and are usually used to measure voltage
Return
The query returns X or Y.
DS1000Z Programming Guide 2-15
RIGOL Chapter 2 Command System
:CURSor:MANual:SOURce?
Description
Set or query the channel source in manual cursor measurement mode.
Name
Type
Range
Default
CHANnel3|CHANnel4|MATH}
Explanation
Only the channel is enabled currently can be selected.
Format
measurement mode to CH2*/
:CURSor:MANual:TUNit?
Description
Set or query the horizontal unit in manual cursor measurement mode.
Name
Type
Range
Default
<unit>
Discrete
{S|HZ|DEGRee|PERCent}
S
PERCent: AX, BX and BX-AX are in “%”.
Format
Example
:CURSor:MANual:TUNit DEGRee /* Set the horizontal unit to “degree”*/
:CURSor:MANual:VUNit?
Description
Set or query the vertical unit in manual cursor measurement mode.
Name
Type
Range
Default
<unit>
Discrete
{PERCent|SOURce}
SOURce
automatically set to the unit of the current source.
Format
Example
:CURSor:MANual:VUNit PERCent /* Set the vertical unit to %*/
Command
:CURSor:MANual:SOURce
Syntax :CURSor:MANual:SOURce <source>
Parameter
Return
Example
<source> Discrete {CHANnel1|CHANnel2|
The query returns CHAN1, CHAN2, CHAN3, CHAN4 or MATH.
:CURSor:MANual:SOURce CHANnel2 /*Set the channel source of manual cursor
CHANnel1
:CURSor:MANual:TUNit
Syntax :CURSor:MANual:TUNit <unit>
Parameter
Explanation S: AX, BX and BX-AX in the measurement results are in “s” and 1/|dX| is in “Hz”.
HZ: AX, BX and BX-AX in the measurement results are in “Hz” and 1/|dX| is in “s”.
DEGRee: AX, BX and BX-AX are in “degree”.
Return
The query returns S, HZ, DEGR or PERC.
:CURSor:MANual:VUNit
Syntax :CURSor:MANual:VUNit <unit>
Parameter
Explanation PERCent: AY, BY and BY-AY in the measurement results are in “degree”.
SOURce: the units of AY, BY and BY-AY in the measurement results will be
Return
Related
The query returns PERC or SOUR.
:CHANnel<n>:UNITs
2-16 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:CURSor:MANual:AX?
Description
Set or query the horizontal position of cursor A in manual cursor measurement mode.
Name
Type
Range
Default
<x>
Integer
5 to 594
100
400.
Format
Example
:CURSor:MANual:AX 200 /*Set the horizontal position of cursor A to 200*/
:CURSor:MANual:BX?
Description
Set or query the horizontal position of cursor B in manual cursor measurement mode.
Name
Type
Range
Default
<x>
Integer
5 to 594
500
400.
Format
Example
:CURSor:MANual:BX 200 /* Set the horizontal position of cursor B to 200*/
:CURSor:MANual:AY?
Description
Set or query the vertical position of cursor A in manual cursor measurement mode.
Name
Type
Range
Default
400.
Format
Example
:CURSor:MANual:AY 200 /*Set the vertical position of cursor A to 200*/
:CURSor:MANual:AX
Syntax :CURSor:MANual:AX <x>
Parameter
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 loca ted at the right bottom corner of the
screen. The horizontal pixel range is from 0 to 600 and the vertical pixel range is from 0 to
Return
The query returns an integer between 5 and 594.
:CURSor:MANual:BX
Syntax :CURSor:MANual:BX <x>
Parameter
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 (6 00,400). Wherein, (0,0) is located at
the left top corner of the screen and (600,400) is located at the right bottom corner of the
screen. The horizontal pixel range is from 0 to 600 and the vertical pixel r ange is from 0 to
Return
The query returns an integer between 5 and 594.
:CURSor:MANual:AY
Syntax :CURSor:MANual:AY <y>
Parameter
<y> Integer 5 to 394 100
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 (6 00,400). Wherein, (0,0) is located at
the left top corner of the screen and (600,400) is located at the right bottom corner of the
screen. The horizontal pixel range is from 0 to 600 and the vertical pixel r ange is from 0 to
Return
DS1000Z Programming Guide 2-17
The query returns an integer between 5 and 394.
RIGOL Chapter 2 Command System
:CURSor:MANual:BY?
Description
Set or query the vertical position of cursor B in manual cursor measurement mode.
Name
Type
Range
Default
<y>
Integer
5 to 394
300
400.
Format
Example
:CURSor:MANual:BY 200 /*Set the vertical position of cursor B to 200*/
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. The horizontal pixel range is from 0 to 600 and the vertical pixel r ange is from 0 to
Return
The query returns an integer between 5 and 394.
:CURSor:MANual:AXValue?
Description Query the X value of cursor A in manual cursor measurement mode. The unit dependents
Return
Related
The query returns the X value of cursor A in scientific notation.
:CURSor:MANual:AX
Command
:CURSor:MANual:AYValue?
Description Query the Y value of cursor A in manual cursor measurement mode. The unit dependents
Return
The query returns the Y value of cursor A in scientific notation.
Related
:CURSor:MANual:AY
Command
:CURSor:MANual:BXValue?
Description Query the X value of cursor B in manual cursor measurement mode. The unit dependents
Return
Related
Command
2-18 DS1000Z Programming Guide
The query returns the X value of cursor B in scientific notation.
The query returns OFF, CHAN1, CHAN2, CHAN3, CHAN4 or MATH.
:CURSor:TRACk:SOURce2
Syntax :CURSor:TRACk:SOURce2 <source>
Parameter
<source> Discrete
{OFF|CHANnel1|CHANnel2|
CHANnel3|CHANnel4|MATH}
{OFF|CHANnel1|CHANnel2|
CHANnel1
CHANnel1
Return
The query returns OFF, CHAN1, CHAN2, CHAN3, CHAN4 or MATH.
2-20 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:CURSor:TRACk:AX?
Description
Set or query the horizontal position of cursor A in track cursor measurement mode.
Name
Type
Range
Default
400.
Format
Example
:CURSor:TRACk:AX 200 /* Set the horizontal position of cursor A to 200*/
:CURSor:TRACk:BX?
Description
Set or query the horizontal position of cursor B in track cursor measurement mode.
Name
Type
Range
Default
<x>
Integer
5 to 594
500
400.
Format
Example
:CURSor:TRACk:BX 200 /* Set the horizontal position of cursor B to 200*/
Syntax
:CURSor:TRACk:AY?
Description
Query the vertical position of cursor A in track cursor measurement mode.
screen. At this point, 4294967295 will be returned.
Format
Example
:CURSor:TRACk:AY? /*The query returns 284*/
:CURSor:TRACk:AX
Syntax :CURSor:TRACk:AX <x>
Parameter
<x> Integer 5 to 594 100
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 (6 00,400). Wherein, (0,0) is located at
the left top corner of the screen and (600,400) is located at the right bottom corner of the
screen. The horizontal pixel range is from 0 to 600 and the vertical pixel r ange is from 0 to
Return
The query returns an integer between 5 and 594.
:CURSor:TRACk:BX
Syntax :CURSor:TRACk:BX <x>
Parameter
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). Wh erein, (0,0) is located at
the left top corner of the screen and (600,400) is located at the right bottom corner of the
screen. The horizontal pixel range is from 0 to 600 and the vertical pixel r ange is from 0 to
Return
The query returns an integer between 5 and 594.
:CURSor:TRACk:AY?
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. The horizontal pixel range is from 0 to 600 and the
vertical pixel range is from 0 to 400.
It is invalid state when the cursor A exceeds the vertical range displayed in the
Return
The query returns an integer.
DS1000Z Programming Guide 2-21
RIGOL Chapter 2 Command System
Syntax
:CURSor:TRACk:BY?
Description
Query the vertical position of cursor B in track cursor measurement mode.
screen. At this point, 4294967295 will be returned.
Format
Example
:CURSor:TRACk:BY? /*The query returns 200*/
Syntax
:CURSor:TRACk:AXValue?
Description
Query the X value of cursor A in track cursor measurement mode. The default unit is s.
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. The horizontal pixel range is from 0 to 600 and the
vertical pixel range is from 0 to 400.
It is invalid state when the cursor A exceeds the vertical range displayed in the
Return
The query returns an integer.
:CURSor:TRACk:AXValue?
Return
Related
The query returns the X value of cursor A in scientific notation.
:CURSor:TRACk:AX
:CURSor:TRACk:AYValue?
Description Query the Y value of cursor A in track cursor measurement mode. The unit is the same as
Return
The query returns the Y value of cursor A in scientific notation.
Related
Command
:CHANnel<n>:UNITs
:CURSor:TRACk:BXValue?
Return
Related
2-22 DS1000Z Programming Guide
The query returns the X value of cursor B in scientific notation.
Explanation 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). Wherein, (0,0) is located at the right top corner and (400,400) is
located at the left bottom corner. The horizontal and vertical pixel ranges are both from 0
Return
The query returns an integer between 5 and 394.
:CURSor:XY:BX
Syntax :CURSor:XY:BX <x>
Parameter
Explanation 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 displa y area ranges from
(0,0) to (400,400). Wherein, (0,0) is located at the right top corner and (400,400) is
located at the left bottom corner. The horizontal and vertical pixel ranges are both from 0
Return
DS1000Z Programming Guide 2-25
The query returns an integer between 5 and 394.
RIGOL Chapter 2 Command System
:CURSor:XY:AY?
Description
Set or query the vetical position of cursor A in XY cursor measurement mode.
Name
Type
Range
Default
<x>
Integer
5 to 394
100
located at the left bottom corner. The horizontal and vertical pixel ranges are both from 0
to 400.
Format
Example
:CURSor:XY:AY 200
:CURSor:XY:BY?
Description
Set or query the vertical position of cursor B in XY cursor measurement mode.
Name
Type
Range
Default
<x>
Integer
5 to 394
300
to 400.
Format
Example
:CURSor:XY:BY 200
Syntax
:CURSor:XY:AXValue?
the amplitude unit selected by the corresponding channel.
Explanation 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 r anges from
(0,0) to (400,400). Wherein, (0,0) is located at the right top corner and (400,400) is
Return
The query returns an integer between 5 and 394.
:CURSor:XY:BY
Syntax :CURSor:XY:BY <y>
Parameter
Explanation 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 r anges from
(0,0) to (400,400). Wherein, (0,0) is located at the right top corner and (400,400) is
located at the left bottom corner. The horizontal and vertical pixel ranges are both from 0
Return
The query returns an integer between 5 and 394.
:CURSor:XY:AXValue?
Description Query the X value of cursor A in XY cursor measurement mode. The unit dependents on
Return
Related
The query returns the X value of cursor A in scientific notation.
:CHANnel<n>:UNITs
2-26 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
Syntax
:CURSor:XY:AYValue?
the amplitude unit selected by the corresponding channel.
Explanation If the oscilloscope is in RUN state, waveform will still be displayed.
This command is equivalent to press the CLEAR key at the front panel. Sending
Related
Command
:RUN
2-28 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
Syntax
:DISPlay:DATA?
Description
Read the bitmap data stream of the image currently displayed.
image currently displayed to the buffer area of the PC.
(length)
effective data.
bitmap file header.
:DISPlay:DATA?
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
Return
Format
Th format of the bitmap data stream:
Component
Size
Example Explanation
TMC Blockheader ::= #NXXXXXX is
used to describe the length of the
data stream. Wherein, # is the start
denoter of the data stream; N is less
TMC
Blockheader
[1]
+2 #9001152054
N
than or equal to 9 and the N figures
following it denotes the length of the
data stream in bytes. For example,
#9001152054; wherein, N is 9 and
001152054 denotes that the data
stream contains 1152054 bytes of
TMC
Blockheader
[1]
Note
Note
: N is the width used to describe the data length in the TMC header. For example, #90000.
[2]
: the width is 800, the height is 480, the bit depth is 24Bit = 3Byte, 54 is the size of the
800*480*3+
54=1152054
[2]
BM… Specific bitmap data.
Example 1. Make sure that the buffer is large enough to rec eive the data stream, otherwise the
program might be abnormal when reading the data stream.
2. The returned data stream contains TMC data header and you need to remove the
data header to make the data stream a standard bitmap data str e a m.
3. When the data size is larger than 1 M and the communication speed of the interface
is not fast enough, you need to set an appropriate timeout time
4. The terminator '\n'(0X0A) at the end of the data should be removed.
DS1000Z Programming Guide 2-29
RIGOL Chapter 2 Command System
:DISPlay:TYPE?
Description
Set or querythe display mode of the waveform on the screen.
Name
Type
Range
Default
<type>
Discrete
{VECTors|DOTS}
VECTors
and use the cursor to measure the X and Y values of the sample point.
Format
Example
:DISPlay:TYPE DOTS
:DISPlay:GRADing:TIME?
Description
Set or query the persistence time. The default unit is s.
<time>
Discrete
{MIN|0.1|0.2|0.5|1|5|10|INFinite}
MIN
as well as capture incidental events.
Format
Example
:DISPlay:GRADing:TIME 0.1 /*Set the persistence time to 0.1s*/
:DISPlay:WBRightness?
Description
Set or query the waveform brightness. The default unit is %.
Name
Type
Range
Default
<time>
Integer
0 to 100
50
Format
Example
:DISPlay:WBRightness 60
:DISPlay:TYPE
Syntax :DISPlay:TYPE <type>
Parameter
Explanation 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).
DOTS: display the sample points directly. You can directly view each sample point
Return
The query returns VECT or DOTS.
:DISPlay:GRADing:TIME
Syntax :DISPlay:GRADing:TIME <time>
Parameter
Explanation MIN: set the persistence time to its minimum to view the waveform changing in high
Return
Name Type Range Default
refresh rate.
Specific Values: a certain value from the range listed above, enable to observe glitch
that changes relatively slowly or glitch with low occurrence probability.
INFinite: in this mode, the oscilloscope displays the newly acquired waveform
without clearing the waveform formerly acquired. Enable to measure noise and jitter
The query returns the persistence time currently set.
:DISPlay:WBRightness
Syntax :DISPlay:WBRightness <time>
Parameter
Return
2-30 DS1000Z Programming Guide
The query returns an integer between 0 and 100.
Chapter 2 Command System RIGOL
:DISPlay:GRID?
Description
Set or query the grid type of screen display.
Name
Type
Range
Default
<grid>
Discrete
{FULL|HALF|NONE}
FULL
NONE: turn the background grid and coordinate off.
Format
Example
:DISPlay:GRID NONE
:DISPlay:GBRightness?
Description
Set or query the brightness of the screen grid. The default unit is %.
Name
Type
Range
Default
Format
Example
:DISPlay:GBRightness 60
:DISPlay:GRID
Syntax :DISPlay:GRID <grid>
Parameter
Explanation FULL: turn the background grid and coordinate on.
HALF: turn the background grid off.
Return
The query returns FULL, HALF or NONE.
:DISPlay:GBRightness
Syntax :DISPlay:GBRightness <brightness>
Parameter
<brightness> Integer 0 to 100 50
Return
The query returns an integer between 0 and 100.
DS1000Z Programming Guide 2-31
RIGOL Chapter 2 Command System
Syntax
*CLS
Description
Clear all the event registers in the register set and clear the error queue.
*ESE?
Description
Set or query the enable register for the standard event register set.
Name
Type
Range
Default
<value>
Integer
0~255
0
and of which the bit 1 and bit 6 are 0.
Format
already been set in the register.
*ESE? /*The query returns 16*/
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.
Explanation The bit 1 and bit 6 of the standard event status register are not used and are always
treated as 0, therefore, the range of <value> are the decimal numbers corresponding to
the binary numbers ranging from 00000000 (0 in decimal) to 11111111 (255 in decimal)
Return
Example *ESE 16 /* Enable the bit 4 (16 in decimal) of the standard event status register */
The query returns an integer which equals the sum of the weights of all the bits that have
2-32 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
Syntax
*ESR?
Description
Query and clear the event register for the standard event status register.
of which the bit 1 and bit 6 are 0.
Format
Syntax
*IDN?
Description
Query the ID character string of the instrument.
Format
TECHNOLOGIES,DS1104Z,DS1T00000006,00.02.00.
*OPC
register to 1 after the current operation is finished.
Format
Syntax
*RST
Description
Restore the instrument to the default values.
*SRE?
Description
Set or querythe enable register for the state byte register set.
Name
Type
Range
Default
<value>
Integer
0~255
0
which the bit 0 and bit 1 are 0.
Format
have already been set in th e register.
*SRE? /*The query returns 16*/
*ESR?
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
Return
The query returns an integer between 0 and 255.
*IDN?
Return
The query returns the ID character string of the instrument, such as RIGOL
*OPC
Syntax *OPC?
Description The *OPC? command is used to query whether the current operation is finished. The *OPC
command is used to set the Operation Complete bit (bit 0) in the standard event status
Return
The query returns 1 if the current operation is finished; otherwise, returns 0.
*RST
*SRE
Syntax *SRE <value>
Parameter
Explanation The bit 0 and bit 1 of the status byte reg ister are not used and are alwa ys treated as 0,
therefore, the range of <value> are the decimal numbers corresponding to the binary
numbers ranging from 00000000 (0 in decimal) to 11111111 (255 in decimal) and of
Return
Example *SRE 16 /*Enable the bit 4 (16 in decimal) of the status byte register*/
DS1000Z Programming Guide 2-33
The query returns an integer which equals the sum of the weights of all the bits that
RIGOL Chapter 2 Command System
Syntax
*STB?
Query the event register for th e status byte r egiste r. The value of the status byte register
is set to 0 after this command is executed.
1 are 0.
Format
Syntax
*TST?
Description
Perform a self-test and then returns the seilf-test results.
Format
Syntax
*WAI
Description
Wait for the operation to finish.
executed.
*STB?
Description
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
Return
The query returns an integer between 0 and 255.
*TST?
Return
The query returnsa decimal integer.
*WAI
Explanation The subsequent command can only be carried out after the current command has been
2-34 DS1000Z Programming Guide
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 wavef or m data to be operated is compar ed to the preset threshold and is
converted to 0 or 1. Thus, the result will also be 0 or 1.
For the analog operation or logic operation which needs only one source, only the
Explanation The <hsc> parameter can be set to the four scales: 1/20, 1/40, 1/100 and 1/200 of
the current screen sample rate (namely 100/current horizontal timebase).
For example, if the horizontal timebase of the instrument is 1μs, the current screen
sample rate is 100/1μs=100MHz. Thus, the horizontal scale can be set to 5MHz,
2.5MHz, 1MHz or 500kHz.
You can view the detaied information of the spectrum by reducing the horizontal
Refer to Explanation
5.00MHz
Return
Example
Related
Command
The query returns the horizontal scale in scientific notation.
:MATH:FFT:HSCale 500000 /*Set the horizontal scale to 500kHz*/
:MATH:OPERator
2-40 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:MATH:FFT:HCENter?
relative to the horizontal center in the screen. The default unit is Hz.
Name
Type
Range
Default
<cent>
Real
0~( current screen sample rate×2/5)
5MHz
Step = horizontal scale of the FFT operation result/50.
Explanation The past/fail test is invalid in the following conditions: the horizontal timebase is XY or
ROLL, slow sweep mode (namely when the horizontal timebase is YT, the horizontal
Return
The query returns 0 or 1.
DS1000Z Programming Guide 2-45
RIGOL Chapter 2 Command System
:MASK:SOURce?
Description
Set or query the source of the pass/fail test.
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2|CHANnel3|CHANnel4}
CHANnel1
the :CHANnel<n>:DISPlay command to enable the desired channel.
Format
Example
:MASK:SOURce CHANnel2
:MASK:OPERate?
Description
Run or stop the pass/fail test, or query the status of the pass/fail test.
Name
Type
Range
Default
<oper>
Discrete
{RUN|STOP}
STOP
the pass/fail test.
Format
Example
:MASK:OPERate RUN
Command
:MASK:SOURce
Syntax :MASK:SOURce <source>
Parameter
Explanation This command can only select the channel enabled. You can sent
Return
Related
Command
The query returns CHAN1, CHAN2, CHAN3 or CHAN4.
:CHANnel<n>:DISPlay
:MASK:OPERate
Syntax :MASK:OPERate <oper>
Parameter
Explanation Before executing th is command , you ne ed to sent the :MASK:ENABle command to enable
Return
Related
The query returns RUN or STOP.
:MASK:ENABle
2-46 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:MASK:MDISplay?
status of the statistic information.
Name
Type
Range
Default
<bool>
Bool
{{0|OFF}|{1|ON}}
0|OFF
results.
Format
Example
:MASK:MDISplay ON
:MASK:TOTal?
:MASK:SOOutput?
function.
Name
Type
Range
Default
<bool>
Bool
{{0|OFF}|{1|ON}}
0|OFF
waveform is detected.
Format
Example
:MASK:SOOutput ON
:MASK:MDISplay
Syntax :MASK:MDISplay <bool>
Description Enable or disable the statistic information when the pass/fail test i s enabled, or query the
Parameter
Explanation Before executing this command, you need to sent the :MASK:ENABle command to
enable the pass/fail test.
When the statistic information is on, the test results will be displayed at the upper
right corner of the screen.
You can sent
:MASK:PASSed?, :MASK:FAILed? and :MASK:TOTal? to query the test
Return
Related
Command
The query returns 0 or 1.
:MASK:ENABle
:MASK:PASSed?
:MASK:FAILed?
:MASK:SOOutput
Syntax :MASK:SOOutput <bool>
Description Turn the “Stop on Fail” function on or off, or query the status of the “Stop on Fail”
Parameter
Explanation ON: when failed waveforms are det ected, the oscilloscope will stop the test and enter
the “STOP” state. At this point, the results of the test r emain the same on th e screen
(if display is turned on) and only one pulse is output from the [Trigger Out]
connector (if enabled) at the rear panel.
Return
DS1000Z Programming Guide 2-47
OFF: the oscilloscope will continue with the test even though failed waveforms are
detected. The test results on the screen will update continuously and a pulse will be
output from the [Trigger Out] connector at the rear panel each time a failed
The query returns 0 or 1.
RIGOL Chapter 2 Command System
:MASK:OUTPut?
status of the sound prompt.
Name
Type
Range
Default
<bool>
Bool
{{0|OFF}|{1|ON}}
0|OFF
sounds (not related to the on/off state of the sound).
Format
Example
:MASK:OUTPut ON
:MASK:X?
Description
Set or query the horizontal adjustment parameter in the pass/fail test mask.
Name
Type
Range
Default
<x>
Real
0.02 to 4
0.24
Explanation
In the range, the step is 0.02.
Format
:MASK:Y?
Description
Set or query the vertical adjustment parameter in the pass/fail test mask.
Name
Type
Range
Default
<y>
Real
0.04 to 5.12
0.48
Explanation
In the range, the step is 0.04.
Format
:MASK:Y? /*The query returns 3.600000e-01*/
:MASK:OUTPut
Syntax :MASK:OUTPut <bool>
Description Enable or disable the sound prompt when the failed waveforms are detected, or query the
Parameter
Explanation OFF: failed waveforms are detected, there are display and output but th e beeper
does not sound..
ON: failed waveforms are detected, there are display and output and the beeper
Return
:MASK:X
Syntax :MASK:X <x>
Parameter
Return
Example
:MASK:Y
The query returns 0 or 1.
The query returns the horizontal adjustment parameter in scientific notation.
:MASK:X 0.28 /*Set the horizontal adjustment parameter to 0.28div*/
:MASK:X? /*The query returns 2.800000e-01*/
Syntax :MASK:Y <y>
Parameter
Return
Example
The query returns the vertical adjustment parameter in scientific notation.
:MASK:Y 0.36 /* Set the vertical adjustment parameter to 0.36div*/
2-48 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
Syntax
:MASK:CREate
vertical adjustment parameter.
run state (:MASK:OPERate).
:MASK:Y
Syntax
:MASK:PASSed?
Description
Query the number of the passed frames in pass/fail test.
Format
Syntax
:MASK:FAILed?
Description
Query the number of the failed frames in pass/fail test.
Format
Syntax
:MASK:TOTal?
Description
Query the number of the total frames in pass/fail test.
Format
Syntax
:MASK:RESet
0.
:MASK:TOTal?
:MASK:CREate
Description Create the pass/fail test mask using the current horizontal adjustment parameter and
Explanation This command is valid only when the pass/fail test is enabled (:MASK:ENABle) and not in
Related
Command
:MASK:ENABle
:MASK:OPERate
:MASK:X
:MASK:PASSed?
Return
The query returns an integer.
:MASK:FAILed?
Return
The query returns an integer.
:MASK:TOTal?
Return
The query returns an integer.
:MASK:RESet
Description Reset the numbers of the passed frames, failed frames and total fr ames in pass/f ail test to
Related
Command
DS1000Z Programming Guide 2-49
:MASK:PASSed?
:MASK:FAILed?
RIGOL Chapter 2 Command System
Period:
Defined as the time between the threshold middle points of two consecutive,
like-polarity edges.
Frequency:
Defined as the reciprocal of period.
Rise Time:
The time for the signal amplitude to rise from the lower limit to the upper limit of
the threshod.
Fall Time:
The time for the signal amplitude to fall from the upper limit to the lower limit of the
threshod.
+ Width:
The time difference between the threshold middle points of a rising edge to the
next falling edge of the pulse.
- Width:
The time difference between the threshold middle points of a falling edg e to the
next rising edge of the pulse.
+ Duty:
The ratio of the positive pulse width to the period.
- Duty:
The ratio of the negative pulse width to the period.
Delay 1→2 :
The time difference between the rising edges of source 1 and source 2. Negative
edge of source 2.
Delay 1→2 :
The time difference between the falling edges of source 1 and source 2. Negative
of source 2.
Phase 1→2 :
Phase difference calculated according to “Delay 1→2 ” and the period of source
1, expressed in degree. The calculation formula is shown following.
Phase 1→2 :
Phase difference calculated according to “Delay 1→2 ” and the period of source
1, expressed in degree.The calculation formula is shown following.
360
1
Delay
Phase
Period
=×°
RiseTime
FallTime
Threshold Upper Limit
Threshold Middle Point
Threshold Lower Limit
+Width
-Width
Period
: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
Delay and Phase
delay indicates that the selected rising edge of source 1 occurred after the selected
delay indicates that the selected edg e of source 1 occur red after th e selected ed ge
2-50 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
Phase
Delay
1Period
Source 1
Source 2
Period
Delay
Vmax:
the voltage value from the highest point of the waveform to the GND.
Vmin:
the voltage value from the lowest point of the waveform to the GND.
Vpp:
the voltage value from the highest point to the lowest point of the waveform.
Vtop:
the voltage value from the flat top of the waveform to the GND.
Vbase:
the voltage value from the flat base of the waveform to the GND.
Vamp:
the voltage value from the top of the waveform to the base of the waveform.
Vavg:
the arithmetic average value on the whole waveform or on the gating area.
i
x
Average
n
=
∑
i
x
ith
points being measured.
Vrms:
the root mean square value on the whole waveform or the gating area.
2
1
n
i
i
x
RMS
n
=
=
∑
i
x
ith
points being measured.
Overshoot:
the ratio of the difference of the maximum value and top v alue of the waveform to the
amplitude value.
Preshoot:
the ratio of the difference of the minimum value and base v alue of the wavef orm to the
amplitude value.
Preshoot
Overshoot
Vamp
Vmax
Vmin
Vpp
Vtop
Vbase
Wherein,
“Delay 1→2
denotes “Phase 1→2 ” or “Phase 1→2 ”,
” and
Voltage Parameters
denotes the period of source 1.
, wherein,
is the
point being measured, nis the number of
denotes “Delay 1→2 ” or
, where,
is the
point being measured, nis the number of
DS1000Z Programming Guide 2-51
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. The area above
the zero reference (namely the vertical offset) is positive and the area below the zero reference is
negative. The area measured is the algeraic sum of the area of the whole period waveform. Note that
when the waveform on the screen is less than a period, the period area measured is 0.
<sour> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF} OFF
Return
The query returns CHAN1, CHAN2, CHAN3, CHAN4 or OFF.
Related
Command
:MEASure:COUNter:VALue?
:MEASure:COUNter:VALue?
Return
Related
DS1000Z Programming Guide 2-53
The query returns the measurement result in scientific notation. If the frequency counter
:MEASure:COUNter:SOURce
RIGOL Chapter 2 Command System
Syntax
:MEASure:CLEar <item>
Description
Clear the one or all of the last five measurement items enabled.
Name
Type
Range
Default
cleared.
Example
:MEASure:CLEar ITEM1
:MEASure:ITEM
Syntax
:MEASure:RECover <item>
Description
Recover the measurement item which has been cleared.
Name
Type
Range
Default
<item>
recovered.
:MEASure:CLEar
Parameter
<item>
Discrete
{ITEM1|ITEM2|ITEM3|ITEM4|ITEM5|ALL}
——
Explanation You can use the :MEASure:ITEM command to enable the desired par ameters of the
24 waveform parameters. Note that the laet five parameters are determined
according to the order in which you turned them on and they will not change as you
delete one or more measurement items.
:MEASure:RECover command to recover the item which has been
Related
You can sent the
:MEASure:RECover
Command
:MEASure:RECover
Parameter
Discrete {ITEM1|ITEM2|ITEM3|ITEM4|ITEM5|ALL}
Explanation You can use the :MEASure:ITEM command to enable the desired parameters of the
24 waveform parameters. Note that the laet five parameters are determined
according to the order in which you turned them on and they will not change as you
delete one or more measurement items.
——
Related
Command
You can sent the
:MEASure:CLEar
:MEASure:ITEM
:MEASure:CLEar command again to clear the items which has been
2-54 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:MEASure:ADISplay?
function.
Name
Type
Range
Default
<bool>
Bool
{{0|OFF}|{1|ON}}
0|OFF
source of the all measurement function.
Format
Example
:MEASure:ADISplay ON
Command
:MEASure:AMSource?
Description
Set or query the source of the all measurement function.
Name
Type
Range
Default
<src>
Discrete
{CHANnel1|CHANnel2|CHANnel3|CHANnel4}
CHANnel1
Format
:MEASure:ADISplay
Syntax :MEASure:ADISplay <bool>
Description Enable or disable all measurement function, or query the status of all measurement
Parameter
Explanation The all measurement function can measures the following 20 parameters of the
source at the same time:
Voltage Parameters: Vmax, Vmin, Vpp, Vtop, Vbase, Vamp, Vavg, Vrms, Overshoot
and Peshoot
Time Parameters: Period, Frequency, Rise Time, F all Time, + Width, - Width, + Duty
and - Duty
Other Parameters: Area and Period Area.
The all measurement function can measures the parameters of CH1, CH2, CH3 and
Explanation The [,<src>[,<src>]] parameter sets the source of the parameter to be measured.
If the parameter to be measured needs single source (such as VMAX, VMIN, VPP,
VTOP, VBASe, VAMP, VAVG, VRMS, OVERshoot, MARea, MPARea, PREShoot, PERiod,
FREQuency, RTIMe, FTIMe, PWIDth, NWIDth, PDUTy, NDUTy, etc.), one source
requires to be set. If the [,<src>[,<src>]] parameter is omitted, the default source is
selected by the
:MEASure:SOURce command.
If the parameter to be measured needs two sources (such as RDELay, FDELay,
RPHase, FPHase, etc.), two sources need to be sent with the command. If else, the
command will be invalide. If the [,<src>[,<src>]] parameter is omitted, the default
:MEASure:SETup:DSA and :MEASure:SETup:DSB
Return
Example
Related
Command
sources are selected by
The query returns the statistic result in scientific notation.
:MEASure:STATistic:ITEM VPP,CHANnel2 /*Enable the Vpp statistic function of CH2*/
Explanation The [,<src>[,<src>]] parameter sets the source of the parameter to be measured.
If the parameter to be measured needs single source (such as VMAX, VMIN, VPP,
VTOP, VBASe, VAMP, VAVG, VRMS, OVERshoot, MARea, MPARea, PREShoot, PERiod,
FREQuency, RTIMe, FTIMe, PWIDth, NWIDth, PDUTy, NDUTy, etc.), one source
requires to be set. If the [,<src>[,<src>]] parameter is omitted, the default source is
selected by the
:MEASure:SOURce command.
If the parameter to be measured needs two sources (such as RDELay, FDELay,
RPHase, FPHase, etc.), two sources need to be sent with the command. If else, the
command will be invalide. If the [,<src>[,<src>]] parameter is omitted, the default
:MEASure:SETup:DSA and :MEASure:SETup:DSB
Return
Example
Related
Command
sources are selected by
The query returns the measurement result in scientific notation.
:MEASure:ITEM OVERshoot,CHANnel2 /*Enable the ov ersh oot m easurement of CH2*/
[:SOURce[<n>]]. If both are omitted, the commands operation on source 1 by default.
Format
Example
:OUTPut 1
[:SOURce[<n>]]:OUTPut[<n>]:IMPedance?
Description
Set or query the impedance of the specified source channel
Name
Type
Range
Default
source 1 by default
<impedance>
Discrete
{OMEG|FIFTy}
OMEG
source 1 by default.
Format
Example
:OUTPut:IMPedance FIFTy
[:SOURce[<n>]]:OUTPut[<n>][:STATe]
Syntax [:SOURce[<n>]]:OUTPut[<n>][:STATe] <bool>
Description Turn on or off the output of the specified source channel, or query the status of the
Parameter
[<n>] Discrete {1|2}
If omitted, operating on
Explanation [:SOURce[<n>]] and [<n>] are used to specify the source channel. The priority of the
former is higher than that of the latter, namely if [:SOURce[<n>]] is omitted, the channel
is specified by [<n>] and if [:SOURce[<n>]] is not omitted, the channel is specified by
[:SOURce[<n>]] and [<n>] are used to specify the source channel. The priority of
the former is higher than that of the latter, namely if [:SOURce[<n>]] is omitted, the
channel is specified by [<n>] and if [:SOURce[<n>]] is not omitted, the channel is
specified by [:SOURce[<n>]]. If both are omitted, the commands operation on
Return
The query returns OMEG or FIFT.
2-66 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
[:SOURce[<n>]]:FREQuency[:FIXed]?
enabled or the carrier frequency if modulation is enabled. The default unit is Hz.
Description Set or query the output frequency of the specified source channel if modulation is not
Parameter
[<n>] Discrete {1|2}
If omitted, operating on
Sine: 0.1Hz to 25MHz
Square: 0.1Hz to 15MHz
<frequency> Real
Pulse: 0.1Hz to 1MHz
Ramp: 0.1Hz to 100kHz
100kHz
Arbitrary waveform: 0.1Hz to
10MHz
Return
Related
The query returns the frequency in scientific notation, such as 2.0000000e+05.
[:SOURce[<n>]]:MOD[:STATe]
Command
[:SOURce[<n>]]:PHASe[:ADJust]
Syntax [:SOURce[<n>]]:PHASe[:ADJust] <phase>
Description Set or query the start phase of the specified source channel. The default unit is degree
Parameter
Return
[<n>] Discrete {1|2}
If omitted, operating on
<phase> Real 0 to 360 0
The query returns the start phase in scientific notation, such as 0.0000000e+00.
DS1000Z Programming Guide 2-67
RIGOL Chapter 2 Command System
Syntax
[:SOURce[<n>]]:PHASe:INITiate
Description
Execute align phase ope ration.
Name
Type
Range
Default
Before Aligning Phase After Aligning Phase
[:SOURce[<n>]]:FUNCtion[:SHAPe]?
selected, the modulation will turn off automatically.
Name
Type
Range
Default
source 1 by default
|NOISe|DC|INTErnal|EXTernal}
EXTernal: Arbitrary waveform
Format
Example
:FUNCtion SQUare
[:SOURce[<n>]]:PHASe:INITiate
Parameter
[<n>] Discrete {1|2} If omitted, operating on source 1 by default
Explanation Executing align phase operation, the instrument will re-configure the two channels and
enable the generator to output with specified frequency and start phase.
For two signals whose frequencies are the same or in multiple, this operation will align
their phases. For example, assume a sine waveform (1kHz, 5Vpp, 0°) is outputed from
Source1, while another one (1kHz, 5Vpp, 180°) from Source2. Use another oscilloscope to
sample and display the two signals, you will see that the waveforms shown on the
oscilloscope do not always have a phase deviation of 180°. At this point, execute align
phase operation and the waveforms shown on the oscilloscope will have a phase deviation
of 180° without any adjustment of the start phase of the generator.
[:SOURce[<n>]]:FUNCtion[:SHAPe]
Syntax [:SOURce[<n>]]:FUNCtion[:SHAPe] <wave>
Description When modulation of the specified source channel is not enabled, these commands are
used to select or query the output waveform. When the modulation is enabled, they are
used to select or query the carrier waveform. At this point, if PULSe, NOISe or DC is
Parameter
[<n>] Discrete {1|2}
<wave> Discrete
{SINusoid|SQUare|RAMP|PULSe
Explanation INTErnal: Built-in waveforms (7 built-in waveforms are provided by DS1000Z,
including Sinc, Exp.Rise, Exp.Fall, ECG, Gauss, Lorentz and Haversine)
If omitted, operating on
SINusoid
Return
The query returns SIN, SQU, RAMP, PULS, NOIS, DC, INTE or EXT.
2-68 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
[:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry?
whole period) of the specified source channel. The default unit is %.
Explanation AM: amplitude modulation. The amplitude of the carrier waveform varies with the
instantaneous voltage of the modulating waveform.
FM: frequency modulation. The frequency of the carrier waveform varies with the
instantaneous voltage of the modulating waveform.
Sine, Square, Ramp, Built-in waveforms or Arb waveform (except for DC) can be
used as carrier waveform.
Sending
[:SOURce[<n>]]:MOD:AM:INTernal:FUNCtionor
[:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion can selelct Sine, Square, Ramp or
Return
The query returns AM or FM.
DS1000Z Programming Guide 2-71
RIGOL Chapter 2 Command System
[:SOURce[<n>]]:MOD:AM[:DEPTh]?
expressed as a percentage) of the specified source channel. The default unit is %.
Name
Type
Range
Default
source 1 by default
<depth>
Real
0 to 120
100
avoided.
Format
Example
:MOD:AM 80
[:SOURce[<n>]]:MOD:FM:INTernal:FREQuency?
channel. The default unit is Hz.
source 1 by default
Noise as modulating waveform.
Format
Example
:MOD:AM:INTernal:FREQuency 100
[:SOURce[<n>]]:MOD:AM[:DEPTh]
Syntax [:SOURce[<n>]]:MOD:AM[:DEPTh] <depth>
Description Set or query the AM modulation depth (indicates the amplitude variation degree and is
Parameter
[<n>] Discrete {1|2}
If omitted, operating on
Explanation In 0% modulation, the output amplitude is half of the carrier waveform amplitude.
In 100% modulation, the output amplitude is equal to carrier waveform amplitude.
In >100% modulation, the envelop distortion will be occurred and the output amplitude
of the instrument would not exceed 5Vpp (50Ω load). In real electrical circuit, it should be
Description Set or query the modulating waveform frequency of AM or FM of the specified source
Parameter
Name Type Range Default
[<n>] Discrete {1|2}
If omitted, operating on
<frequency> Real 1Hz to 50kHz 1kHz
Explanation Sending the [:SOURce[<n>]]:MOD:TYPecommand can set the modulation type.
AM: amplitude modulation. The amplitude of the carrier waveform varies with the
instantaneous voltage of the modulating waveform.
FM: frequency modulation. The frequency of the carrier waveform varies with the
instantaneous voltage of the modulating waveform.
Sending
[:SOURce[<n>]]:MOD:AM:INTernal:FUNCtionor
[:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion can selelct Sine, Square, Ramp or
Return
The query returns an integer.
2-72 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
Description
Set or query the modulating waveform of AM or FM of the specified source channel.
<freq>: set the frequency of the specified waveform (Noise has no this parameter).
The default unit is Hz
<amp>: set the amplitude of the specified waveform. The default unit is Vpp
<offset>: set the DC offset of the specified waveform. The default unit is V
<phase>: set the start phase of the specified waveform (Noise has no this
parameter). The default unit is degree (°).
Users can omit one parameter or multiple parameters. When all of the parameters
are omitted, the commands only select the waveform shape but not modify the
parameters.
The four parameters (<freq>, <amp>, <offset> and <phase>) are in order. You can
not omit the prior parameter and set the posterior one. For example, you can not
omit <freq> and set <amp> directly.
DS1000Z Programming Guide 2-75
RIGOL Chapter 2 Command System
:SYSTem:AUToscale?
Name
Type
Range
Default
<bool>
Bool
{{0|OFF}|{1|ON}}
1|ON
command will be invalid.
Format
Example
:SYSTem:AUToscale ON
:SYSTem:BEEPer?
Description
Enable or disable the beeper, or query the status of the beeper.
Enable or disable the AUTO key at the front panel, or query the status of the AUTO key.
Parameter
Explanation
Users can disable the AUTO key by sending this command or pressing Utility
Auto Options Lock and enable it only by sending this command.
After the AUTO key is disabled, Auto Scale operation is invalid. The :AUToscale
Return
The query returns 0 or 1.
:SYSTem:BEEPer
Syntax :SYSTem:BEEPer <bool>
Parameter
Return
The query returns 0 or 1.
2-76 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
Syntax
:SYSTem:ERRor[:NEXT]?
Description
Query and delete the last system error message.
character string. For example, -113,"Undefined header; command cannot be found".
:SYSTem:GPIB?
Description
Set or query the GPIB address.
Name
Type
Range
Default
<adr>
Integer
1 to 30
2
Explanation
The GPIB address is not affected by sending *RST.
Format
Example
:SYSTem:GPIB 7
:SYSTem:LANGuage?
Description
Set or query the system language.
Name
Type
Range
Default
<lang>
Discrete
{SCHinese|ENGLish}
SCHinese
Explanation
The system language is not affected by sending *RST.
Format
Example
:SYSTem:LANGuage SCHinese
:SYSTem:LOCKed?
function.
Name
Type
Range
Default
<bool>
Bool
{{0|OFF}|{1|ON}}
0|OFF
Format
:SYSTem:ERRor[:NEXT]?
Return
Format
The query returns the error message in “<message number>,<message content>”
format. Wherein, the message number is an integer and the message content is a ASCII
:SYSTem:GPIB
Syntax :SYSTem:GPIB <adr>
Parameter
Return
The query returns an integer.
:SYSTem:LANGuage
Syntax :SYSTem:LANGuage <lang>
Parameter
Return
The query returns SCH or ENGL.
:SYSTem:LOCKed
Syntax :SYSTem:LOCKed <bool>
Description Open or close the keyboard lock function, or query the status of the keyboard lock
Set or query the main timebase offset. The default unit is s.
Name
Type
Range
Default
<offset>
Real
-Screen/2 to 1s or -Screen/2 to 5000s
0
Stoping.
Return Format
The query returns the offset in scientific notation.
Example
:TIMebase:MAIN:OFFSet 0.0002 /*Set the main timebase offset to 20ms*/
:TIMebase:DELay:SCALe
Syntax :TIMebase:DELay:SCALe <scale_value>
Parameter
<scale_value> Real See Explanation500ns
Explanation The maximum of <scale_value> is the main timebase scale currently set and the
minimum is related to the current sample rate (satisfying the inequality: current sample rate * delay timebase scale * 7 ≥ 14) and not less than 1ns.
The delay timebase scale is only the maximum or the value decreased from the
maximum in 1-2-5 step. If the minimum calculated by the inequality mentioned
above is not the values which can be set, the larger value will be the minimum. If
the value set is between two values which can be set, the smaller one will be set.
For example, when the main timebase scale currently set 10.00us and the sample
rate is 500MSa/s, the maximum of <scale_value> is 10.00us. The minimum is
calculated using the inequality: ≥ 14 / (500MSa/s * 7) = 40ns. Taking the larger
value which can be set, the minimum is 50ns. At this point, if 0.000009 (namely
Example :TIMebase:DELay:SCALe 0.00000005 /*Set the delayed timebase scale to 50ns*/
Related
:TIMebase[:MAIN]:SCALe
Command
:TIMebase[:MAIN]:OFFSet
Syntax :TIMebase[:MAIN]:OFFSet <offset>
Parameter
Explanation This command is invalid when the horizontal timebase is Roll and the oscilloscope
is in Run state.
When the horizontal timebase is YT and the timebase scale is 20ms or larger
(namely “Slow Sweep” mode), this command is invalid when the oscilloscope in
Related
Command
:TIMebase:MODE
:TIMebase[:MAIN]:SCALe
:RUN
:STOP
2-80 DS1000Z Programming Guide
Chapter 2 Command System RIGOL
:TIMebase[:MAIN]:SCALe?
Description
Set or query the main timebase scale. The default unit is s/div.
Name
Type
Range
Default
“Slow Sweep” mode), this command is invalid when the oscilloscope in Stoping.
Return Format
The query returns the main timebase scale in scientific notation.
The query returns EDGE, PULS, RUNT, WIND, NEDG, SLOP, VID, PATT, DEL, TIM, DUR,
2-82 DS1000Z Programming Guide
EDGE
PATTern|DELay|TIMeout|DURation|SHOLd|RS232
Chapter 2 Command System RIGOL
:TRIGger:COUPling?
Description
Select or query the trigger coupling type.
Name
Type
Range
Default
<couple>
Discrete
{AC|DC|LFReject|HFReject}
DC
HFReject: reject the high frequency components (higher than 75 kHz).
Format
Example
:TRIGger:COUPling LFReject
Syntax
:TRIGger:STATus?
Description
Query the current trigger status.
Format
:TRIGger:SWEep?
Description
Set or query the trigger mode.
Name
Type
Range
Default
<sweep>
Discrete
{AUTO|NORMal|SINGle}
AUTO
when the trigger condition is met and then stops.
Format
Example
:TRIGger:SWEep SINGle
:TRIGger:COUPling
Syntax :TRIGger:COUPling <couple>
Parameter
Explanation 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.
LFReject: block the DC components and reject the low frequency components (lower
than 75 kHz).
Return
The query returns AC, DC, LFR or HFR.
:TRIGger:STATus?
Return
The query returns TD, WAIT, RUN, AUTO or STOP.
:TRIGger:SWEep
Syntax :TRIGger:SWEep <sweep>
Parameter
Explanation AUTO: auto trigger. No matter whether the trigger condition is met, there is always
waveform display.
NORMal: normal trigger. Display waveform when the trigger condition is met;
otherwise, the oscilloscope holds the original waveform and waits for the next trigger.
SINGle: single trigger. The oscilloscope waits for a trigger and displays the waveform
Return
The query returns AUTO, NORM or SING.
DS1000Z Programming Guide 2-83
RIGOL Chapter 2 Command System
:TRIGger:HOLDoff?
Description
Set or query the trigger holdoff time. The default unit is s.
Name
Type
Range
Default
<value>
Real
16ns to 10s
16ns
When the trigger type is video, RS232, I2C or SPI, this setting will be not available.
Enable or disable noise rejection, or query the status of noise rejection.
Name
Type
Range
Default
Explanation
Noise rejection reduces the possibility of noise trigger.
Format
Example
:TRIGger:NREJect ON
:TRIGger:HOLDoff
Syntax :TRIGger:HOLDoff <value>
Parameter
Explanation 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. The oscilloscope will not trigger until the holdoff time
expires.
Return
Example
The query retuns the trigger holdoff time in scientific notation.
:TRIGger:HOLDoff 0.0000002 /*Set the trigger holdoff time to 200ns*/