Rigol DS1000E Series, DS1000D Series Operating instructions

RIGOL
Programming Guide
DS1000E, DS1000D
Series Digital Oscilloscope
July 2009
RIGOL Technologies, Inc.

RIGOL
Programming Guide for DS1000E, DS1000D Series
I
Copyright
© 2009 RIGOL Technologies, Inc. All Rights Reserved.
Trademark Information
RIGOL is registered trademark of RIGOL Technologies, Inc.
Notices
RIGOL products are protected by patent law in and outside of P.R.C..
RIGOL Technologies, Inc. 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 copy or photocopy or rearrange
without prior written approval of RIGOL.
Product Certification
RIGOL guarantees this product conforms to the standards of national and industrial.
Meanwhile, the related standards conform to other ISO will get further. At present,
DS1000E, DS1000D has passed CE certification.

RIGOL
Programming Guide for DS1000E, DS1000D Series
II
Content
Chapter 1 Programming Introduction................................................... 1-1
Communication Interfaces .........................................................................1-2
Command Introduction ..............................................................................1-3
Command Syntax ...............................................................................1-3
Symbol Instruction..............................................................................1-4
Command Input .................................................................................1-5
Parameter Type ..................................................................................1-6
Chapter 2 Command Systems ............................................................... 2-1
General Commands ...................................................................................2-2
SYSTem Commands...................................................................................2-4
ACQuire Commands ..................................................................................2-6
DISPlay Commands ................................................................................. 2-10
TIMebase Commands .............................................................................. 2-15
TRIGger Commands ................................................................................ 2-19
Trigger Control ................................................................................. 2-22
EDGE Trigger.................................................................................... 2-26
PULSe Trigger................................................................................... 2-27
VIDEO Trigger .................................................................................. 2-29
SLOPe Trigger .................................................................................. 2-32
PATTern Trigger ................................................................................ 2-36
DURation Trigger .............................................................................. 2-37
ALTernation Trigger........................................................................... 2-39
STORage Command ................................................................................ 2-48
MATH Commands.................................................................................... 2-50
CHANnel Commands................................................................................ 2-53
MEASure Commands ............................................................................... 2-59
WAVeform Command............................................................................... 2-68
LA Commands......................................................................................... 2-70
KEY Commands....................................................................................... 2-75
Other Commands .................................................................................... 2-87
Chapter 3 Programming Examples........................................................ 3-1
Prepare for Programming...........................................................................3-1

RIGOL
Programming Guide for DS1000E, DS1000D Series
III
Programming based on RIGOL USB Driver...................................................3-2
Program in Visual C++ 6.0 ..................................................................3-2
Program in Visual Basic 6.0 .................................................................3-7
Programming based on VISA.................................................................... 3-16
Program in Visual C++ 6.0 ................................................................ 3-16
Program in Visual Basic 6.0 ............................................................... 3-21
Program in LabVIEW 8.6 ................................................................... 3-24
Command Quick Reference A-Z .................................................................. 1

Programming Introduction RIGOL
Programming Guide for DS1000E, DS1000D Series
1-1
Chapter 1 Programming Introduction
This chapter provides the introduction about the interfces and commands so as to
control DS1000E,DS1000D series digital oscilloscopes via remote commands.
The chapter contains following topics:
Communication Interfaces
Command Introduction
Command Syntax
Symbol Instruction
Command Input
Parameter Type

RIGOL Programming Introduction
Programming Guide for DS1000E, DS1000D Series
1-2
Communication Interfaces
Computers communicate with the oscilloscope by sending and receiving messages
over an I/O port such as an USB or RS-232 port. Commands appear as ASCII
character strings embedded inside the output statements of a “host”language
available on your computer.
Basic operations that you can do with a computer and an oscilloscope
include:
Set up the oscilloscope.
Make measurements.
Retrieve data (waveforms or measurements) from the oscilloscope.
Connection:
USB: connect the oscilloscope with the computer through an USB data cable.
RS232: connect the oscilloscope with the computer through an RS232 serial port
Cable.

Programming Introduction RIGOL
Programming Guide for DS1000E, DS1000D Series
1-3
Command Introduction
Command Syntax
The command system of DS1000E, DS1000D series digital oscilloscopes presents a
multiscale tree structure, each of the subsystem consists of a “Root”keyword and one
or multilayered keywords. Generally, a command line starts with “:”(except for IEEE
commands) and “:”is also used for separating different keywords, meanwhile,
parameters are permitted to follow the keywords; in addition, “?”after a command
line denotes to query its function and “space”is used to divide command and
parameter.
For example:
:TRIGger:EDGE:SLOPe {POSitive|NEGative}
:TRIGger:EDGE:SLOPe?
TRIGger is the root keyword of this command, EDGE and SLOPe are second and
third keyword respectively, all of these keywords are separated by “:”. Connects
enclosed in the “{}”denote the parameters permitted to be set by user; queries are
formed by adding a question mark (?) to the end of the commands and “space”is
used to divide the command :TRIGger:EDGE:SLOPe and the parameter. For the
command with multiple parameters, “,”is generally used for separating the
parameters, for example:
:TRIGger:DURation:PATTern <value>,<mask>

RIGOL Programming Introduction
Programming Guide for DS1000E, DS1000D Series
1-4
Symbol Instruction
The following symbols are not “real”parts of the commands, but they are usually
used to assist to explain the parameters containd in a command line.
1. Braces { }
The parameters enclosed in a command line must be selected. When several
elements separated by a vertical line (|) are enclosed by braces, { }, only one
element may be selected, for example:
:MEASure:TOTal {ON|OFF},
Thereinto, {ON|OFF} indicates that only ON or OFF may be selected, not both.
2. Square Brackets [ ]
Items enclosed in square brackets [ ] are optional, for example:
:TIMebase[:DELayed]:OFFSet <offset>
Thereinto, [:DELayed] could be omitted.
3. Triangle Brackets < >
Items enclosed in < > should be replaced by an effective value, for example:
:DISPlay:BRIGhtness <ncount>
Thereinto, < ncount > must be a numerical value such as 25.

Programming Introduction RIGOL
Programming Guide for DS1000E, DS1000D Series
1-5
Command Input
All the commands of both DS1000E, DS1000D series are case-insensitive. You can
use capital letter to input the whole command or you can input the abbreviation.
Note that if use abbreviation, the capital letters specified in commands must be
written completely. For example:
:TRIGger:EDGE:SLOPe
can be entered as:
:TRIG:EDGE:SLOP

RIGOL Programming Introduction
Programming Guide for DS1000E, DS1000D Series
1-6
Parameter Type
The commands contains 5 kinds of parameters, different parameters have different
setting methods.
1. Boolean
The parameter should be “OFF”or “ON”, for example:
:MEASure:TOTal {ON|OFF}
Thereinto, “ON”denotes trun on (enable) this function and “OFF”denoets turn
off (disable).
2. Consecutive Integer
The parameter should be a consecutive integer, for example:
:DISPlay:BRIGhtness <ncount>
Thereinto, <ncount> could be an integer between 0 and 32 (including 0 and
32).
3. Consecutive Real Number
The parameters could be any value within effective range and precision
permitting, for example:
:TRIGger:EDGE:SENSitivity <count>
Thereinto, <count> could be a real number between 0.1 and 1(including 0.1
and 1).
4. Discrete
The parameters can only be the cited value, for example:
:ACQuire:AVERages <count>
Thereinto, <count> could be 2, 4, 8, 16, 32, 64, 128, 256.
5. ASCII Character String
The parameter should a combination of ASCII character string, for example:
:TRIGger:MODE <mode>
Thereinto, <mode> could be “EDGE”, ”PULSe”, ”VIDEO”, ”SLOPe”, “PATTern”,
“DURation”or ”ALTernation”.

Command Systems RIGOL
Programming Guide for DS1000E, DS1000D Series
2-1
Chapter 2 Command Systems
This chapter gives detailed information on each command supported by DS1000E,
DS1000D series, including command format, function description, using
considerations as well as some application examples.
The subcommands systems contain:
General Commands
SYSTem Commands
ACQuire Commands
DISPlay Commands
TIMebase Commands
TRIGger Commands
Trigger Control
EDGE Trigger
PULSe Trigger
VIDEO Trigger
SLOPe Trigger
PATTern Trigger
DURation Trigger
ALTernation Trigger
STORage Command
MATH Commands
CHANnel Commands
MEASure Commands
WAVeform Command
LA Commands
KEY Commands
Other Commands

RIGOL Command Systems
Programming Guide for DS1000E, DS1000D Series
2-2
General Commands
IEEE standard defineds common commands for querying or executing some basic
information about instrument, which usually begins with “*” and holds 3-character
long command keywords.
DS1000E, DS1000D series digital oscilloscopes support following IEEE488.2
commands:
*IDN?
*RST
The detailed information of each command are given as follows:

Command Systems RIGOL
Programming Guide for DS1000E, DS1000D Series
2-3
1. *IDN?
Command Format:
*IDN?
Function Explanation:
The command queries the ID character string of the instrument, including a field
separated by 4 commas: manufactory, model, serial number and the version
number composed of numbers and separated by “.”.
Returned Format:
RIGOL TECHNOLOGIES,<model>, <serial number>, <software version
number>.
Example:
RIGOL TECHNOLOGIES,DS1102E,DS1EB104702974,00.02.01.01.00
2. *RST
Command Format:
*RST
Function Explanation:
The command resets the system parameters.

RIGOL Command Systems
Programming Guide for DS1000E, DS1000D Series
2-4
SYSTem Commands
SYSTem Commands are the fundamental commands for the operation of an
oscilloscope. They can either be used for operational control or screen data
interception and more.
SYSTem Commands include:
:RUN
:STOP
:AUTO
:HARDcopy
The detailed information of each command are given as follows:

Command Systems RIGOL
Programming Guide for DS1000E, DS1000D Series
2-5
1. :RUN
Command Format:
:RUN
Function Explanation:
The command initiates the oscilloscope to acquire waveform data according to its
current settings. Acquisition runs continuously until the oscilloscope receives
a :STOP command.
2. :STOP
Command Format:
:STOP
Function Explanation:
The command controls the oscilloscope to stop acquiring data. To restart the
acquisition, use the :RUN command.
3. :AUTO
Command Format:
:AUTO
Function Explanation:
The command controls the oscilloscope to evaluate all input waveforms
characteristics and set the optimum conditions to display the waveforms.
4. :HARDcopy
Command Format:
:HARDcopy
Function Explanation:
The command is to extract the current information on the screen and save the
bitmap into the U disc in the form of “HardCopyxxx.bmp”. (Note: this command
is unavailable in file system)

RIGOL Command Systems
Programming Guide for DS1000E, DS1000D Series
2-6
ACQuire Commands
ACQuire Commands set the acquire mode for the oscilloscope, including:
:ACQuire:TYPE
:ACQuire:MODE
:ACQuire:AVERages
:ACQuire:SAMPlingrate?
:ACQuire:MEMDepth <depth>
The detailed information of each command are given as follows:

Command Systems RIGOL
Programming Guide for DS1000E, DS1000D Series
2-7
1. :ACQuire:TYPE
Command Format:
:ACQuire:TYPE <type>
:ACQuire:TYPE?
Function Explanation:
The commands set and query the current acquire type of the oscilloscope.
<type> could be NORMal, AVERage or PEAKdetect.
Returned Format:
The query returns NORMAL, AVERAGE or PEAKDETECT.
Example:
:ACQ:TYPE AVER Setup the acquire type as Average.
:ACQ:TYPE? The query returns AVERAGE.
2. :ACQuire:MODE
Command Format:
:ACQuire:MODE <mode>
:ACQuire:MODE?
Function Explanation:
The commands set and query the current acquire mode of the oscilloscope.
<mode> could be RTIMe (Real time Sampling) or ETIMe (Equivalent Sampling).
Returned Format:
The query returns REAL_TIME or EQUAL_TIME.
Example:
:ACQ:MODE ETIM Setup the acquire mode as ETIMe.
:ACQ:MODE? The query returns EQUAL_TIME.
3. :ACQuire:AVERages
Command Format:

RIGOL Command Systems
Programming Guide for DS1000E, DS1000D Series
2-8
:ACQuire:AVERages <count>
:ACQuire:AVERages?
Function Explanation:
The commands set and query the average numbers in Average mode. <count>
could be and integer of 2 times the power of N within 2 and 256.
Returned Format:
The query returns 2, 4, 8, 16, 32, 64, 128 or 256.
Example:
:ACQ:AVER 16 Setup the average acquisition time as 16.
:ACQ:AVER? The query returns 16.
4. :ACQuire:SAMPlingrate?
Command Format:
:ACQuire:SAMPlingrate? {CHANnel<n>|DIGITAL}
Function Explanation:
The command queries the current sampling rate of the analog channel or digital
channel (only for DS1000D series). <n> is 1 or 2 means channel 1 or channel 2.
Returned Format:
The query returns the setting value of the sampling rate.
Example:
:ACQ:SAMP? CHANnel2 Query the sampling rate for channel 2.
100000000.000000 The query returns 100M.
5. :ACQuire:MEMDepth <depth>
Command Format:
:ACQuire:MEMDepth <depth>
:ACQuire:MEMDepth?
Function Explanation: