Rigol DL3000 Series Operating instructions

RIGOL
Programming Guide
DL3000 Series Programmable DC
Electronic Load
Apr. 2019
RIGOL (SUZHOU) TECHNOLOGIES INC.

RIGOL
DL3000 Programming Guide I
Guaranty and Declaration
Copyright
© 2017 RIGOL (SUZHOU) TECHNOLOGIES INC. All Rights Reserved.
Trademark Information
RIGOL is a registered trademark of RIGOL (SUZHOU) TECHNOLOGIES INC.
Publication Number
PGJ01105-1110
Software Version
00.01.04
Software upgrade might change or add product features. Please acquire the latest version of the manual
from RIGOL website or contact RIGOL to upgrade the software.
Notices
RIGOL products are covered by P.R.C. and foreign patents, issued and pending.
RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at
the company’s sole decision.
Information in this publication replaces all previously released materials.
Information in this publication is subject to change without notice.
RIGOL shall not be liable for either incidental or consequential losses 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, photocopied, or rearranged without prior written
approval of RIGOL.
Product Certification
RIGOL guarantees that this product conforms to the national and industrial standards in China as well as
the ISO9001:2015 standard and the ISO14001:2015 standard. Other international standard conformance
certifications are in progress.
Contact Us
If you have any problem or requirement when using our products or this manual, please contact RIGOL.
E-mail: [e-mail]
Website: www.rigol.com

RIGOL
II DL3000 Programming Guide
Document Overview
This manual is your guide to programming the RIGOL DL3000 series programmable DC power supply.
Main Topics in this Manual:
Chapter 1 Programming Overview
This chapter introduces how to set up remote communication between the electronic load and the PC, the
remote control methods, the syntax, symbols, parameters, and abbreviation rules of the SCPI commands.
Chapter 2 Command System
This chapter introduces the syntax, function, parameters, and usage of each command.
Chapter 3 Application Instances
This chapter provides some application instances of the basic functions of the electronic load. Each
application instance is composed of a series of commands, which are used to realize the specified basic
function.
Chapter 4 Programming Instances
This chapter illustrates how to control the DL3000 series by programming in Excel, MATLAB, LabVIEW,
Visual C++, and Visual C#.
Chapter 5 Appendix
This chapter provides default settings and warranty information for the DL3000 series.
Tip
For the latest version of this manual, download it from the official website of RIGOL (www.rigol.com).
Format Conventions in this Manual:
1. Key
The key at the front panel is denoted by the format of “Key Name (Bold) + Text Box”. For example,
Utility denotes the “Utility” key.
2. Menu Softkey
The menu softkey is denoted by the format of “Menu Word (Bold) + Character Shading”. For
example, Interface denotes the “Interface” menu softkey under Utility.
Content Conventions in this Manual:
DL3000 series programmable DC electronic load includes the following models. Unless otherwise specified,
this manual takes DL3031A as an example to make a detailed introduction about the commands of the
DL3000 series, and lists some application instances and programming examples of DL3031A.
Model
No. of
Channels
Voltage
Current
Power
DL3021/DL3021A
1
DC 150 V
40 A
200 W
DL3031/DL3031A
1
DC 150 V
60 A
350 W

Contents RIGOL
DL3000 Programming Guide III
Contents
Guaranty and Declaration ......................................................................................................... I
Document Overview .................................................................................................................II
Chapter 1 Programming Overview......................................................................................1-1
To Build Remote Communication ...............................................................................................1-2
Remote Control Method ............................................................................................................1-3
SCPI Command Overview..........................................................................................................1-4
Syntax...............................................................................................................................1-4
Symbol Description ............................................................................................................1-4
Parameter Type..................................................................................................................1-5
Command Abbreviation ......................................................................................................1-5
SCPI Status Register.................................................................................................................1-6
Questionable Status Register ..............................................................................................1-7
Standard Event Status Register...........................................................................................1-8
Status Byte Register...........................................................................................................1-8
Chapter 2 Command System...............................................................................................2-1
IEEE 488.2 Common Commands................................................................................................2-2
*CLS .................................................................................................................................2-2
*ESE .................................................................................................................................2-3
*ESR? ...............................................................................................................................2-4
*IDN? ...............................................................................................................................2-4
*OPC.................................................................................................................................2-5
*OPT?...............................................................................................................................2-5
*PSC.................................................................................................................................2-6
*RST.................................................................................................................................2-6
*SRE.................................................................................................................................2-7
*STB? ...............................................................................................................................2-7
*TRG ................................................................................................................................2-8
*TST? ...............................................................................................................................2-8
*WAI.................................................................................................................................2-8
:STATus Commands ..................................................................................................................2-9
:STATus:QUEStionable:CONDition?......................................................................................2-9
:STATus:QUEStionable:ENABle.......................................................................................... 2-10
:STATus:QUEStionable[:EVENt]? ....................................................................................... 2-10
:STATus:PRESet ............................................................................................................... 2-11
:STATus:OPERation:CONDition?......................................................................................... 2-11
:STATus:OPERation:ENABle............................................................................................... 2-12
:STATus:OPERation[:EVENt]?............................................................................................ 2-12
:MEASure commands and :FETCh commands........................................................................... 2-13
:FETCh:VOLTage[:DC]?..................................................................................................... 2-13
:MEASure:VOLTage[:DC]?................................................................................................. 2-13
:FETCh:VOLTage:MAX?..................................................................................................... 2-14
:MEASure:VOLTage:MAX? ................................................................................................. 2-14
:FETCh:VOLTage:MIN? ..................................................................................................... 2-14
:MEASure:VOLTage:MIN?.................................................................................................. 2-14
:FETCh:CURRent[:DC]? .................................................................................................... 2-14
:MEASure:CURRent[:DC]?................................................................................................. 2-14
:FETCh:CURRent:MAX?..................................................................................................... 2-14
:MEASure:CURRent:MAX?................................................................................................. 2-14
:FETCh:CURRent:MIN?..................................................................................................... 2-14
:MEASure:CURRent:MIN? ................................................................................................. 2-14
:FETCh:RESistance[:DC]? ................................................................................................. 2-15
:MEASure:RESistance[:DC]? ............................................................................................. 2-15
:FETCh:POWer[:DC]? ....................................................................................................... 2-15

RIGOL Contents
IV DL3000 Programming Guide
:MEASure:POWer[:DC]?....................................................................................................2-15
:FETCh:CAPability? ...........................................................................................................2-15
:MEASure:CAPability?........................................................................................................2-15
:FETCh:WATThours?.........................................................................................................2-15
:MEASure:WATThours? .....................................................................................................2-15
:FETCh:DISChargingTime?................................................................................................2-16
:MEASure:DISChargingTime? ............................................................................................2-16
:FETCh:TIME?..................................................................................................................2-16
:MEASure:TIME? ..............................................................................................................2-16
:FETCh:WAVedata?...........................................................................................................2-16
:MEASure:WAVedata?.......................................................................................................2-16
:TRIGger Commands...............................................................................................................2-17
:TRIGger..........................................................................................................................2-17
:TRIGger:SOURce.............................................................................................................2-17
[:SOURce] Commands.............................................................................................................2-18
[:SOURce]:INPut..............................................................................................................2-20
[:SOURce]:FUNCtion.........................................................................................................2-20
[:SOURce]:FUNCtion:MODE ..............................................................................................2-20
[:SOURce]:TRANsient.......................................................................................................2-21
[:SOURce]:CURRent[:LEVel][:IMMediate]...........................................................................2-21
[:SOURce]:CURRent:RANGe..............................................................................................2-22
[:SOURce]:CURRent:SLEW................................................................................................2-22
[:SOURce]:CURRent:SLEW:POSitive...................................................................................2-23
[:SOURce]:CURRent:SLEW:NEGative .................................................................................2-23
[:SOURce]:CURRent:VON..................................................................................................2-24
[:SOURce]:CURRent:VLIMt................................................................................................2-24
[:SOURce]:CURRent:ILIMt ................................................................................................2-24
[:SOURce]:CURRent:TRANsient:MODE...............................................................................2-25
[:SOURce]:CURRent:TRANsient:ALEVel..............................................................................2-25
[:SOURce]:CURRent:TRANsient:BLEVel..............................................................................2-26
[:SOURce]:CURRent:TRANsient:AWIDth ............................................................................2-26
[:SOURce]:CURRent:TRANsient:BWIDth ............................................................................2-27
[:SOURce]:CURRent:TRANsient:FREQuency.......................................................................2-27
[:SOURce]:CURRent:TRANsient:PERiod..............................................................................2-28
[:SOURce]:CURRent:TRANsient:ADUTy..............................................................................2-28
[:SOURce]:VOLTage[:LEVel][:IMMediate]...........................................................................2-29
[:SOURce]:VOLTage:RANGe ..............................................................................................2-29
[:SOURce]:VOLTage:VLIMt................................................................................................2-30
[:SOURce]:VOLTage:ILIMt.................................................................................................2-30
[:SOURce]:RESistance[:LEVel][:IMMediate]........................................................................2-30
[:SOURce]:RESistance:RANGe...........................................................................................2-31
[:SOURce]:RESistance:VLIMt.............................................................................................2-31
[:SOURce]:RESistance:ILIMt .............................................................................................2-32
[:SOURce]:POWer[:LEVel][:IMMediate]..............................................................................2-32
[:SOURce]:POWer:VLIMt...................................................................................................2-33
[:SOURce]:POWer:ILIMt ...................................................................................................2-33
[:SOURce]:LIST:MODE......................................................................................................2-33
[:SOURce]:LIST:RANGe ....................................................................................................2-34
[:SOURce]:LIST:COUNt.....................................................................................................2-34
[:SOURce]:LIST:STEP .......................................................................................................2-35
[:SOURce]:LIST:LEVel.......................................................................................................2-35
[:SOURce]:LIST:WIDth .....................................................................................................2-35
[:SOURce]:LIST:SLEW ......................................................................................................2-36
[:SOURce]:LIST:END ........................................................................................................2-36
[:SOURce]:BATTary:RANGe...............................................................................................2-36
[:SOURce]:BATTary[:LEVel][:IMMediate]............................................................................2-37
[:SOURce]:BATTary:VSTop ................................................................................................2-37
[:SOURce]:BATTary:CSTop ................................................................................................2-38

Contents RIGOL
DL3000 Programming Guide V
[:SOURce]:BATTary:TIMestop ........................................................................................... 2-38
[:SOURce]:BATTary:VON .................................................................................................. 2-39
[:SOURce]:BATTary:VENabstop......................................................................................... 2-39
[:SOURce]:BATTary:CENabstop......................................................................................... 2-39
[:SOURce]:BATTary:TENabstop......................................................................................... 2-40
[:SOURce]:OCP:RANGe .................................................................................................... 2-40
[:SOURce]:OCP:VON........................................................................................................ 2-40
[:SOURce]:OCP:VONDelay................................................................................................ 2-41
[:SOURce]:OCP:ISET........................................................................................................ 2-41
[:SOURce]:OCP:ISTep ...................................................................................................... 2-42
[:SOURce]:OCP:IDELaystep.............................................................................................. 2-42
[:SOURce]:OCP:IMAX....................................................................................................... 2-42
[:SOURce]:OCP:IMIN ....................................................................................................... 2-43
[:SOURce]:OCP:VOCP ...................................................................................................... 2-43
[:SOURce]:OCP:TOCP ...................................................................................................... 2-44
[:SOURce]:OPP:VON........................................................................................................ 2-44
[:SOURce]:OPP:VONDelay................................................................................................ 2-45
[:SOURce]:OPP:PSET....................................................................................................... 2-45
[:SOURce]:OPP:PSTep...................................................................................................... 2-46
[:SOURce]:OPP:PDELaystep ............................................................................................. 2-46
[:SOURce]:OPP:PMAX ...................................................................................................... 2-46
[:SOURce]:OPP:PMIN....................................................................................................... 2-47
[:SOURce]:OPP:VOPP....................................................................................................... 2-47
[:SOURce]:OPP:TOPP....................................................................................................... 2-48
[:SOURce]:WAVe:TIMe..................................................................................................... 2-48
[:SOURce]:WAVe:TSTep ................................................................................................... 2-49
[:SOURce]:SENSe ............................................................................................................ 2-49
:SYSTem Commands............................................................................................................... 2-50
:SYSTem:KEY................................................................................................................... 2-50
:SYSTem:ERRor?.............................................................................................................. 2-51
:SYSTem:VERSion?........................................................................................................... 2-51
:SYSTem:IDN................................................................................................................... 2-51
:LXI Commands...................................................................................................................... 2-52
LXI:IDENtify[:STATE] ....................................................................................................... 2-52
LXI:MDNS[:ENABle] ......................................................................................................... 2-52
LXI:RESet........................................................................................................................ 2-53
LXI:RESTart..................................................................................................................... 2-53
:LIC Command ....................................................................................................................... 2-54
:LIC:SET.......................................................................................................................... 2-54
Chapter 3 Application Instances.........................................................................................3-1
LIST Function...........................................................................................................................3-1
Chapter 4 Programming Instances.....................................................................................4-1
Programming Preparations ........................................................................................................4-1
Excel Programming Instance .....................................................................................................4-3
MATLAB Programming Instance.................................................................................................4-6
LabVIEW Programming Instance................................................................................................4-7
Visual C++ Programming Instance .......................................................................................... 4-12
Visual C# Programming Instance............................................................................................. 4-16
Chapter 5 Appendix ............................................................................................................5-1
Appendix A: Default Settings.....................................................................................................5-1
Appendix B: Warranty...............................................................................................................5-4

Chapter 1 Programming Overview RIGOL
DL3000 Programming Guide 1-1
Chapter 1 Programming Overview
This chapter introduces how to set up remote communication between the electronic load and the PC, the
remote control methods, the syntax, symbols, parameters, and abbreviation rules of the SCPI commands.
Contents in this chapter:
To Build Remote Communication
Remote Control Method
SCPI Command Overview
SCPI Status Register

RIGOL Chapter 1 Programming Overview
1-2 DL3000 Programming Guide
To Build Remote Communication
DL3000 series electronic load can communicate with the PC via USB, LAN (option), RS232, or GPIB
(extended using the USB-GPIB module) interface.
Note: The RS232 protocol command ends with "\r\n" for the DL3000 series.
Operation Procedures:
1. Install Ultra Sigma (PC) software.
You can download Ultra Sigma from the official website of RIGOL (www.rigol.com)and install the
software according to the installation wizard.
2. Connect the electronic load to the PC and configure the interface parameters for the load.
Connect the load to the PC by using any of the four communication interfaces: USB, LAN, RS232, and
GPIB (via the USB-GPIB interface converter), as shown in Figure 1-1.
Figure 1-1 DL3000 Communication Interface
USB Host
LAN
USB Device
RS232

Chapter 1 Programming Overview RIGOL
DL3000 Programming Guide 1-3
Note: For DL3021A and DL3031A, they have been configured with LAN network before leaving the
factory, so they can remotely communicate with the PC via the LAN interface. For DL3021 and
DL3031, LAN interface communication is an optional function. If you need the function, please
purchase the option and install it properly (:LIC:SET).
(1) Remote communication via USB: Use the USB cable to connect the USB DEVICE interface on the
rear panel of DL3000 to the USB HOST interface of the PC.
(2) Remote communication via LAN:
Make sure that your PC has been accessed to the local area network.
Check whether the local area network where your PC resides supports DHCP or auto IP mode.
If not, you need to obtain the available network interface parameters, including the IP
address, subnet mask, default gateway, and DNS.
Use the network cable to have DL3000 get access to the local area network.
Press Utility Interface LAN to configure the IP address, subnet mask, default
gateway, and DNS for the instrument.
(3) Remote communication via RS232:
Use the RS232 cable to connect the RS232 interface to the PC or the data terminal
equipment (DTE).
Press Utility Interface RS232 to set the interface parameters (baud rate, parity, etc.)
that match the PC or DTE.
(4) Remote communication via GPIB:
Use the USB-GPIB interface module to expand the GPIB interface by connecting the module
to the USB HOST interface on the front panel of DL3000．
Use the GPIB cable to connect the instrument to your PC.
Press Utility Interface GPIB to configure the GPIB address for the instrument.
3. Check whether the connection is successful.
Run Ultra Sigma, and then search for the resources and right-click the resource name. Select "SCPI
Panel Control" to open the SCPI command control panel. In the SCPI command control panel, input a
correct command. After that, click Send Command first and then click Read Response. Or you can
also directly click Send & Read to verify whether the connection works properly.
Remote Control Method
1. User-defined programming
You can refer to "Command System" of Chapter 2 in this manual to use the SCPI (Standard
Commands for Programmable Instruments) commands to control DL3000 by programming in LabVIEW,
Visual C#, and other development environments. For details, refer to "Programming Instances" of
Chapter 4 in this manual.
2. Send SCPI commands via the PC software
You can use the PC software to send commands to control DL3000 remotely. RIGOL Ultra Sigma is
recommended. You can download the software from RIGOL official website (www.rigol.com).

RIGOL Chapter 1 Programming Overview
1-4 DL3000 Programming Guide
SCPI Command Overview
SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming
language that is built upon the existing standard IEEE 488.1 and IEEE 488.2 and conforms to various
standards, such as the floating point operation rule in IEEE 754 standard, ISO 646 7-bit coded character set
for information interchange (equivalent to ASCII programming). This chapter introduces the syntax,
symbols, parameters, and abbreviation rules of the SCPI commands.
Syntax
The SCPI commands provide a hierarchical tree structure, and consist of multiple subsystems. Each
command subsystem consists of one root keyword and one or more sub-keywords. The command line
usually starts with a colon; the keywords are separated by colons, and following the keywords are the
parameter settings available. The keywords of the command and the first parameter is separated by a
space. The command ending with a quotation mark indicates querying a certain function.
For example,
:STATus:QUEStionable:ENABle <enable value>
:STATus:QUEStionable:ENABle?
STATus is the root keyword of the command. QUEStionable and ENABle are the second and third keyword,
respectively. The command line starts with a colon, and different levels of keywords are also separated by
colons. <enable value> indicates a settable parameter. The command keywords
":STATus:QUEStionable:ENABle" and the parameter <enable value> are separated by a space. The
quotation mark (?) indicates querying.
In some commands with multiple parameters, commas are often used to separate these parameters. For
example,
:SYSTem:IDN:SET <manufacturer>,<model>,<sn>,<firmware>
Symbol Description
The following four symbols are not part of the command, and they are not sent with the commands, but
taken as delimiters to better describe the parameters in the command.
1. Braces { }
The contents enclosed in the braces can contain multiple optional parameters. When sending the
command, you must select one of the parameters.
2. Vertical Bar |
The vertical bar is used to separate multiple parameter options. When sending the command, you must
select one of the parameters.
3. Square Brackets [ ]
The contents (keywords or parameters) in the square brackets can be omitted. If the parameter is
omitted, it will be set to the default. For example, when sending the :MEASure[:VOLTage][:DC]?
command, you can select any one of the following four commands, as they can achieve the same
effects as the :MEASure[:VOLTage][:DC]? command.
:MEASure?
:MEASure:DC?
:MEASure:VOLTage?
:MEASure:VOLTage:DC?
4. Angle Brackets < >
The parameter enclosed in the angle brackets must be replaced by an effective value. For example,
the :LIC:SET <sn> command must be sent in the form of :LIC:SET
UVF2L3N3XXKYTB73PPRSA4XDMSRT.

Chapter 1 Programming Overview RIGOL
DL3000 Programming Guide 1-5
Parameter Type
The parameters contained in this manual can be divided into the following five types: Bool, Integer, Real,
Discrete, and ASCII String.
1. Bool
The parameter can be set to ON (1) or OFF (0).
2. Integer
Unless otherwise specified, the parameter can be any integer within the effective value range.
Note: Do not set the parameter to a decimal, otherwise, errors will occur.
3. Real
Unless otherwise specified, the parameter can be any real-value (in decimal form or in scientific
notation) within the effective value range.
4. Discrete
The parameters can only be the specified numerical values or characters.
5. ASCII String
The parameter can be the combinations of ASCII characters.
Besides, many commands support the MINimum, MAXimum, or DEF parameter. MINimum indicates setting
the parameter to a minimum value or querying the minimum value of the parameter; MAXimum indicates
setting the parameter to a maximum value or querying the maximum value of the parameter; DEF indicates
setting the parameter to a default value.
Command Abbreviation
The letters in the commands are case-insensitive. The commands can be input in uppercase letters or in
lowercase letters. If abbreviation is used, you must enter all the uppercase letters that exist in the
command syntax. For example, :SYSTem:ERRor? can be abbreviated as :SYST:ERR?

RIGOL Chapter 1 Programming Overview
1-6 DL3000 Programming Guide
SCPI Status Register
All the SCPI commands to the instrument perform the status register operation in the same way. The status
system records the instrument status into the following three registers: questionable status register,
standard event status register, and status byte register. The status byte register is used to record advanced
summary information, which is reported by other registers. The SCPI status system of the DL3000 is shown
in Figure 1-2.
Figure 1-2 SCPI Status System of the DL3000 Series

Chapter 1 Programming Overview RIGOL
DL3000 Programming Guide 1-7
Questionable Status Register
The SCPI status system of the DL3000 is shown in Figure 1-2. The questionable status register monitors the
overall instrument condition, such as voltage/current control, OTP, OVP, OCP, and fan failure. You can send
the :STATus:QUEStionable[:EVENt]? command to read the register. The definitions for the bits in the
questionable status register and the decimal value that corresponds to the binary-weighted value are
shown in Table 1-1.
Table 1-1 Definitions for the bits in the questionable status register and the decimal value that corresponds
to the binary-weighted value
Bit
Weight
Name
Description
0 1 VF
Voltage fault. Overvoltage and reverse voltage occurred; the OV
or the RV condition is removed.
1
2
OC
Overcurrent occurred.
2
4
RS
Remote Sense terminal connection
3 8 OP Overpower occurred.
4 Not used Not used This bit is always set to 0.
5
Not used
Not used
This bit is always set to 0.
6 Not used Not used This bit is always set to 0.
7 128 RUN Runs in List mode
8
Not used
Not used
This bit is always set to 0.
9 512 RRV
Remote Reverse Voltage. When reverse voltage occurs to the
remote terminals, the bit and VF bit are set. When the reverse
voltage is removed, the RRV bit is cleared, but the VF bit will not
be cleared.
10 1024 UNR
Unregulated. The input is unregulated. When the input has been
regulated, the bit is cleared.
11 2048 LRV
Local Reverse Voltage. When reverse voltage occurs to the input
terminals, the bit and VF bit are set. When the reverse voltage is
removed, the LRV bit is cleared, but the VF bit will not be cleared.
12 4096 OV
Overvoltage. When OV occurs, the OV bit and VF bit are set, and
the load is turned off.
13 8192 PS
Protection Shutdown. When overcurrent, overpower, or
overtemperature occurred, the load's input is turned off
(protection shutdown).
14 16384 VON
Voltage of sink current on. When the input voltage exceeds the
set Von value, the load starts to sink the current.
15
Not used
Not used
This bit is always set to 0.
Event Register
The event register latches events from the condition register. Once the bit in the event register is set to 1,
the subsequent event changes are ignored. The event register is read-only. Once the bit is set to 1, it will
remain set and will not be cleared until cleared by running a query command (e.g. the *ESR? command) or
the *CLS command. When you send a query command to query the event register, a decimal value
(equivalent to the binary-weighted sum of all bits enabled in the register) will be returned.
Enable Register
The enable register is both readable and writable. It defines whether to report the events in the event
register to the status byte register. The :STATus:PRESet command will clear all bits in the enable register,
and the *PSC 1 command will make all bits in the enabled register cleared once the instrument is powered
on. To enable the events in the event register to be reported to the status byte register, write a decimal
value (equivalent to the binary-weighted sum of all bits enabled in the register) into the enable register.

RIGOL Chapter 1 Programming Overview
1-8 DL3000 Programming Guide
Standard Event Status Register
The standard event status register records the following events that might occur on your instrument:
power-on inspection, command syntax error, command execution error, self-test/calibration error, query
error, or operation completed. All these events or any one of the events can be reported to Bit 5 (ESB, Event
Summary Bit) of status byte register via the enable register. To set the enable register mask, you need to
use the *ESE command to write a decimal value into the register. The definitions for the bits in the standard
event status register and the decimal value that corresponds to the binary-weighted value are shown in
Table 1-2.
Table 1-2 Definitions for the bits in the standard event status register and the decimal value that
corresponds to the binary-weighted value
Bit
Weight
Name
Description
0 1 OPC (Operation complete)
The operation has been completed. All pending
operations were completed following the execution
of the *OPC command.
1 Not used Not used This bit is always set to 0.
2
4
QYE (Query error)
A query error has occurred.
3 8 DDE (Device error)
A device error (error caused by self-test or
calibration) has occurred.
4 16 EXE (Execution error)
An execution error (trigger ignored, initialization
ignored, setting conflict, data over-the-
limit, data
length too long, or invalid parameter value) has
occurred.
5 32 CME (Command error)
A command error (command syntax error) has
occurred.
6 Not used Not used This bit is always set to 0.
7 128 PON (Power on)
Power-on test. After the bit has been read from the
last event of the register or has been cleared, turn
off the instrument and then turn it on again.
Status Byte Register
The status byte register reports the status information about other status registers; queries the report of Bit
4 (MAV, Message Available) data to be queried in the output buffer. The summary bit in the status byte
register will not be latched. Clearing the event register will clear the corresponding summary bits of the
status byte register. Read all the information in the output cache (including any pending queries), and will
clear Bit 4 (MAV, Message Available). The definitions for the bits in the status byte register and the decimal
value that corresponds to the binary-weighted value are shown in Table 1-3.

Chapter 1 Programming Overview RIGOL
DL3000 Programming Guide 1-9
Table 1-3 Definitions for the bits in the status byte register and the decimal value that corresponds to the
binary-weighted value
Bit
Weight
Name
Description
0 Not used Not used This bit is always set to 0.
1 Not used Not used This bit is always set to 0.
2 4 EQ
Error queue. One or more errors were found in the
error queue.
3 8
Questionable status
summary
One or multiple bits of the questionable status
register has/have been set (To enable the bit, refer
to the :STATus:QUEStionable:ENABle command).
4 16 Message available A message is available in the output buffer.
5 32
Standard event status
summary
One or multiple bits of the standard event status
register has/have been set (To enable the bit, refer
to the *ESE command).
6 64 Master summary
One or multiple bits of the status byte register
has/have been set.
7 128 Operation status summary
One or multiple bits of the operation status register
has/have been set (To enable the bit, refer to
the :STATus:OPERation:ENABle command).

Chapter 2 Command System RIGOL
DL3000 Programming Guide 2-1
Chapter 2 Command System
This chapter introduces the syntax, function, parameters, and usage of each command.
Contents in this chapter:
IEEE 488.2 Common Commands
:STATus Commands
:MEASure commands and :FETCh commands
:TRIGger Commands
[:SOURce] Commands
:SYSTem Commands
:LXI Commands
:LIC Command

RIGOL Chapter 2 Command System
2-2 DL3000 Programming Guide
IEEE 488.2 Common Commands
Command List:
*CLS
*ESE
*ESR?
*IDN?
*OPC
*OPT?
*PSC
*RST
*SRE
*STB?
*TRG
*TST?
*WAI
*CLS
Syntax
*CLS
Description
Clears all the event registers.
Remarks You can send the command for querying the event register
(:STATus:QUEStionable[:EVENt]? or *ESR?) to clear the corresponding event register.
Sending the reset command (*RST) or device clearing command cannot clear the
event register.
Related
Command :STATus:QUEStionable[:EVENt]?
*ESR?
*RST