Rigol DP800 Series Operating instructions

RIGOL
Programming Guide
DP800 Series Programmable Linear
DC Power Supply
Mar. 2013
RIGOL Technologies, Inc.

RIGOL
DP800 Programming Guide I
Guaranty and Declaration
Copyright
© 2013 RIGOL Technologies, Inc. All Rights Reserved.
Trademark Information
RIGOL is a registered trademark of RIGOL Technologies, Inc.
Publication Number
PGH03102-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, please contact RIGOL Technologies, Inc.
or your local distributors, or visit: www.rigol.com.

RIGOL
II DP800 Programming Guide
Safety Requirement
General Safety Summary
Please review the following safety precautions carefully before putting the instrument into operation so as
to avoid any personal injuries or damages to the instrument and any product connected to it. To prevent
potential hazards, please use the instrument only specified by this manual.
Use Proper Power Cord.
Only the power cord designed for the instrument and authorized by local country could be used.
Ground The Instrument.
The instrument is grounded through the Protective Earth lead of the power cord. To avoid electric shock, it
is essential to connect the earth terminal of power cord to the Protective Earth terminal before any inputs or
outputs.
Observe All Terminal Ratings.
To avoid fire or shock hazard, observe all ratings and markers on the instrument and check your manual for
more information about ratings before connecting.
Use Proper Overvoltage Protection.
Make sure that no overvoltage (such as that caused by a thunderstorm) can reach the product, or else the
operator might expose to danger of electrical shock.
Do Not Operate Without Covers.
Do not operate the instrument with covers or panels removed.
Use Proper Fuse.
Please use the specified fuses.
Avoid Circuit or Wire Exposure.
Do not touch exposed junctions and components when the unit is powered.
Do Not Operate With Suspected Failures.
If you suspect damage occurs to the instrument, have it inspected by qualified service personnel before
further operations. Any maintenance, adjustment or replacement especially to circuits or accessories must
be performed by RIGOL authorized personnel.
Keep Well Ventilation.
Inadequate ventilation may cause increasing of temperature or damages to the device. So please keep well
ventilated and inspect the intake and fan regularly.
Do Not Operate in Wet Conditions.
In order to avoid short circuiting to the interior of the device or electric shock, please do not operate in a
humid environment.
Do Not Operate in an Explosive Atmosphere.
In order to avoid damages to the device or personal injuries, it is important to operate the device away from
an explosive atmosphere.
Keep Product Surfaces Clean and Dry.
To avoid the influence of dust and/or moisture in air, please keep the surface of device clean and dry.
Electrostatic Prevention.
Operate in an electrostatic discharge protective area environment to avoid damages induced by static

RIGOL
DP800 Programming Guide III
discharges. Always ground both the internal and external conductors of the cable to release static before
connecting.
Handling Safety.
Please handle with care during transportation to avoid damages to buttons, knob interfaces and other parts
on the panels.

RIGOL
IV DP800 Programming Guide
Safety Terms and Symbols
Terms in this Manual. These terms may appear in this manual:
WARNING
Warning statements indicate the conditions or practices that could result in injury or loss of life.
CAUTION
Caution statements indicate the conditions or practices that could result in damage to this
product or other property.
Terms on the Product. These terms may appear on the Product:
DANGER
indicates an injury or hazard may immediately happen.
WARNING
indicates an injury or hazard may be accessible potentially.
CAUTION
indicates a potential damage to the instrument or other property might occur.
Symbols on the Product. These symbols may appear on the product:
Hazardous
Voltage
Safety
Warning
Protective
Earth
Terminal
Chassis
Ground
Test
Ground

RIGOL
DP800 Programming Guide V
Document Overview
This manual introduces how to program the power supply over remote interfaces in details.
Main Topics in this Manual:
Chapter 1 Programming Overview
This chapter introduces how to build the remote communication between the power supply and PC and how
to control the power supply remotely. Besides, it also provides a brief introduction of the SCPI commands.
Chapter 2 Command System
This chapter introduces the syntax, function, parameter and using instruction of each DP800 command in
A-Z order.
Chapter 3 Application Examples
This chapter provides the application examples of the main functions of the power supply. In the application
examples, a series of commands are combined to realize the basic functions of the power supply.
Chapter 4 Programming Demos
This chapter introduces how to program and control DP800 using various development tools, such as Visual
C++, Visual Basic and LabVIEW.
Chapter 5 Appendix
This chapter provides various information, such as the command list and factory setting list.
Tip
For the newest version of this manual, please download it from www.rigol.com.
Format Conventions in this Manual:
1Button
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 “System Auxiliary Function Setting” key.
2Menu
The menu item is denoted by the format of “Menu Word (Bold) + Character Shading” in the manual,
for example, SysInfo denotes the “System Information” item under Utility.
3Operation 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.

RIGOL
VI DP800 Programming Guide
Content Conventions in this Manual:
DP800 series programmable linear DC power supply includes the following models. The programmable
ranges of the voltage and current for each model are as listed below. Unless otherwise noted, in this
manual, DP831A is taken as an example to illustrate the using method of each DP800 series command.
DP831A
Channel Voltage Range Voltage Default Current Range Current Default
CH1 0V to 8.4V 0V 0A to 5.3A 5A
CH2 0V to 32V 0V 0A to 2.1A 2A
CH3 -32V to 0V 0V 0A to 2.1A 2A
DP832A/DP832
Channel Voltage Range Voltage Default Current Range Current Default
CH1 0V to 32V 0V 0A to 3.2A 3A
CH2 0V to 32V 0V 0A to 3.2A 3A
CH3 0V to 5.3V 0V 0A to 3.2A 3A

RIGOL
DP800 Programming Guide VII
Contents
Guaranty and Declaration ......................................................................................................... I
Safety Requirement..................................................................................................................II
General Safety Summary............................................................................................................. II
Safety Terms and Symbols ..........................................................................................................IV
Document Overview ..................................................................................................................V
Chapter 1 Programming Overview......................................................................................1-1
To Build Remote Communication ...............................................................................................1-2
Remote Control Methods...........................................................................................................1-4
SCPI Command Overview..........................................................................................................1-4
Syntax...............................................................................................................................1-4
Symbol Description ............................................................................................................1-5
Parameter Type..................................................................................................................1-5
Command Abbreviation ......................................................................................................1-6
Chapter 2 Command System...............................................................................................2-1
:ANALyzer Commands...............................................................................................................2-2
:ANALyzer:ANALyze............................................................................................................2-2
:ANALyzer:ENDTime...........................................................................................................2-3
:ANALyzer:FILE? ................................................................................................................2-3
:ANALyzer:MEMory.............................................................................................................2-3
:ANALyzer:MMEMory..........................................................................................................2-4
:ANALyzer:OBJect ..............................................................................................................2-4
:ANALyzer:RESult? .............................................................................................................2-4
:ANALyzer:STARTTime........................................................................................................2-5
:ANALyzer:VALue?..............................................................................................................2-5
:APPLy Command .....................................................................................................................2-6
:DELAY Commands...................................................................................................................2-7
:DELAY:CYCLEs..................................................................................................................2-7
:DELAY:ENDState...............................................................................................................2-8
:DELAY:GROUPs.................................................................................................................2-8
:DELAY:PARAmeter.............................................................................................................2-9
:DELAY[:STATe] .................................................................................................................2-9
:DELAY:STATe:GEN........................................................................................................... 2-10
:DELAY:STOP................................................................................................................... 2-10
:DELAY:TIME:GEN............................................................................................................ 2-11
:DISPlay Command................................................................................................................. 2-12
IEEE488.2 Common Commands............................................................................................... 2-13
*IDN? ............................................................................................................................. 2-13
*RCL............................................................................................................................... 2-13
*RST............................................................................................................................... 2-13
*SAV............................................................................................................................... 2-14
*TST? ............................................................................................................................. 2-14
:INSTrument Commands......................................................................................................... 2-15
:INSTrument:NSELect....................................................................................................... 2-15
:INSTrument[:SELEct] ...................................................................................................... 2-15
:MEASure Commands.............................................................................................................. 2-16
:MEASure:ALL[:DC]? ........................................................................................................ 2-16
:MEASure:CURRent[:DC]?................................................................................................. 2-16
:MEASure:POWEr[:DC]? ................................................................................................... 2-17
:MEASure[:VOLTage][:DC]? .............................................................................................. 2-17
:MEMory Commands............................................................................................................... 2-18
:MEMory[:STATe]:DELete.................................................................................................. 2-18
:MEMory[:STATe]:LOAD.................................................................................................... 2-18

RIGOL
VIII DP800 Programming Guide
:MEMory[:STATe]:LOCK ....................................................................................................2-19
:MEMory[:STATe]:STORe...................................................................................................2-19
:MEMory[:STATe]:VALid?...................................................................................................2-20
:MMEMory Commands.............................................................................................................2-21
:MMEMory:CATalog? .........................................................................................................2-21
:MMEMory:CDIRectory......................................................................................................2-22
:MMEMory:DELete............................................................................................................2-22
:MMEMory:DISK? .............................................................................................................2-23
:MMEMory:LOAD..............................................................................................................2-23
:MMEMory:MDIRectory .....................................................................................................2-23
:MMEMory:STORe.............................................................................................................2-24
:MONItor Commands...............................................................................................................2-25
:MONItor:CURRent:CONDition...........................................................................................2-25
:MONItor:CURRent[:VALue] ..............................................................................................2-26
:MONItor:POWER:CONDition.............................................................................................2-26
:MONItor:POWER[:VALue]................................................................................................2-27
:MONItor[:STATe].............................................................................................................2-27
:MONItor:STOPway ..........................................................................................................2-28
:MONItor:VOLTage:CONDition ...........................................................................................2-29
:MONItor:VOLTage[:VALue]...............................................................................................2-30
:OUTPut Commands................................................................................................................2-31
:OUTPut:MODE?...............................................................................................................2-31
:OUTPut:OCP:CLEAR ........................................................................................................2-31
:OUTPut:OCP:QUES?........................................................................................................2-32
:OUTPut:OCP[:STATe].......................................................................................................2-32
:OUTPut:OCP:VALue.........................................................................................................2-33
:OUTPut:OVP:CLEAR ........................................................................................................2-33
:OUTPut:OVP:QUES?........................................................................................................2-34
:OUTPut:OVP[:STATe].......................................................................................................2-34
:OUTPut:OVP:VALue.........................................................................................................2-35
:OUTPut[:STATe]..............................................................................................................2-35
:OUTPut:TRACk................................................................................................................2-36
:PRESet Commands.................................................................................................................2-37
:PRESet[:APPLy]...............................................................................................................2-37
:PRESet:KEY ....................................................................................................................2-38
:PRESet:USER[n]:SET:CURRent.........................................................................................2-39
:PRESet:USER[n]:SET:DEFault...........................................................................................2-39
:PRESet:USER[n]:SET:TRACk ............................................................................................2-40
:PRESet:USER[n]:SET:OCP................................................................................................2-40
:PRESet:USER[n]:SET:OVP................................................................................................2-41
:PRESet:USER[n]:SET:OTP................................................................................................2-41
:PRESet:USER[n]:SET:SURE..............................................................................................2-42
:PRESet:USER[n]:SET:VOLTage .........................................................................................2-42
:RECorder Commands .............................................................................................................2-43
:RECorder:DESTination? ...................................................................................................2-43
:RECorder:MEMory ...........................................................................................................2-43
:RECorder:MMEMory.........................................................................................................2-44
:RECorder:PERIod ............................................................................................................2-44
:RECorder[:STATe]............................................................................................................2-45
:SOURce Commands ...............................................................................................................2-46
[:SOURce[n]]:CURRent[:LEVel][:IMMediate][:AMPLitude]...................................................2-46
[:SOURce[n]]:CURRent:PROTection[:LEVel]........................................................................2-47
[:SOURce[n]]:CURRent:PROTection:STATe .........................................................................2-48
[:SOURce[n]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] ...................................................2-48
[:SOURce[n]]:VOLTage:PROTection[:LEVel]........................................................................2-49
[:SOURce[n]]:VOLTage:PROTection:STATe .........................................................................2-50
:SYSTem Commands ...............................................................................................................2-51
:SYSTem:BEEPer[:IMMediate] ...........................................................................................2-52

RIGOL
DP800 Programming Guide IX
:SYSTem:BEEPer:STATe.................................................................................................... 2-52
:SYSTem:BRIGhtness ....................................................................................................... 2-52
:SYSTem:COMMunicate:GPIB:ADDRess ............................................................................. 2-53
:SYSTem:COMMunicate:LAN:APPLy ................................................................................... 2-53
:SYSTem:COMMunicate:LAN:AUTOip[:STATe]..................................................................... 2-53
:SYSTem:COMMunicate:LAN:DHCP[:STATe] ....................................................................... 2-54
:SYSTem:COMMunicate:LAN:DNS...................................................................................... 2-54
:SYSTem:COMMunicate:LAN:GATEway .............................................................................. 2-55
:SYSTem:COMMunicate:LAN:IPADdress............................................................................. 2-55
:SYSTem:COMMunicate:LAN:MAC?.................................................................................... 2-56
:SYSTem:COMMunicate:LAN:MANualip[:STATe].................................................................. 2-56
:SYSTem:COMMunicate:LAN:SMASK.................................................................................. 2-57
:SYSTem:COMMunicate:RS232:BAUD ................................................................................ 2-57
:SYSTem:COMMunicate:RS232:DATABit............................................................................. 2-58
:SYSTem:COMMunicate:RS232:FLOWCrl............................................................................ 2-58
:SYSTem:COMMunicate:RS232:PARItybit........................................................................... 2-58
:SYSTem:COMMunicate:RS232:STOPBit............................................................................. 2-59
:SYSTem:CONTrast........................................................................................................... 2-59
:SYSTem:ERRor?.............................................................................................................. 2-59
:SYSTem:LANGuage:TYPE................................................................................................. 2-60
:SYSTem:LOCal................................................................................................................ 2-60
:SYSTem:LOCK ................................................................................................................ 2-60
:SYSTem:OTP .................................................................................................................. 2-61
:SYSTem:POWEron .......................................................................................................... 2-61
:SYSTem:RGBBrightness................................................................................................... 2-61
:SYSTem:SAVer................................................................................................................ 2-62
:SYSTem:SELF:TEST:BOARD? ........................................................................................... 2-62
:SYSTem:SELF:TEST:FAN? ................................................................................................ 2-62
:SYSTem:SELF:TEST:TEMP?.............................................................................................. 2-62
:TIMEr Commands.................................................................................................................. 2-63
:TIMEr:CYCLEs ................................................................................................................ 2-64
:TIMEr:ENDState ............................................................................................................. 2-65
:TIMEr:GROUPs ............................................................................................................... 2-66
:TIMEr:PARAmeter........................................................................................................... 2-67
:TIMEr[:STATe]................................................................................................................ 2-68
:TIMEr:TEMPlet:CONSTruct............................................................................................... 2-68
:TIMEr:TEMPlet:FALLRate................................................................................................. 2-68
:TIMEr:TEMPlet:INTErval.................................................................................................. 2-69
:TIMEr:TEMPlet:INVErt..................................................................................................... 2-69
:TIMEr:TEMPlet:MAXValue................................................................................................ 2-70
:TIMEr:TEMPlet:MINValue ................................................................................................ 2-70
:TIMEr:TEMPlet:OBJect .................................................................................................... 2-71
:TIMEr:TEMPlet:PERIod.................................................................................................... 2-71
:TIMEr:TEMPlet:POINTs.................................................................................................... 2-72
:TIMEr:TEMPlet:RISERate................................................................................................. 2-72
:TIMEr:TEMPlet:SELect..................................................................................................... 2-73
:TIMEr:TEMPlet:SYMMetry................................................................................................ 2-73
:TIMEr:TEMPlet:WIDTh.................................................................................................... 2-73
:TRIGger Commands .............................................................................................................. 2-74
:TRIGger:IN[:ENABle]...................................................................................................... 2-74
:TRIGger:IN:RESPonse..................................................................................................... 2-75
:TRIGger:IN:SENSitivity.................................................................................................... 2-75
:TRIGger:IN:SOURce........................................................................................................ 2-76
:TRIGger:IN:TYPE............................................................................................................ 2-76
:TRIGger:OUT:CONDition ................................................................................................. 2-77
:TRIGger:OUT:DUTY ........................................................................................................ 2-78
:TRIGger:OUT[:ENABle]................................................................................................... 2-78
:TRIGger:OUT:PERIod...................................................................................................... 2-79

RIGOL
X DP800 Programming Guide
:TRIGger:OUT:POLArity.....................................................................................................2-79
:TRIGger:OUT:SIGNal.......................................................................................................2-80
:TRIGger:OUT:SOURce .....................................................................................................2-80
Chapter 3 Application Examples ........................................................................................ 3-1
CV Output ................................................................................................................................3-2
Track Function ..........................................................................................................................3-2
Timing Output ..........................................................................................................................3-3
Delay Output ............................................................................................................................3-3
To Use the Recorder..................................................................................................................3-4
To Use the Analyzer ..................................................................................................................3-4
To Use the Monitor....................................................................................................................3-5
To Use the Trigger.....................................................................................................................3-6
Trigger Input......................................................................................................................3-6
Trigger Output....................................................................................................................3-6
Chapter 4 Programming Demos......................................................................................... 4-1
Programming Preparations.........................................................................................................4-2
Excel Programming Demo..........................................................................................................4-3
Matlab Programming Demo........................................................................................................4-7
LabVIEW Programming Demo....................................................................................................4-8
Visual Basic Programming Demo..............................................................................................4-12
Visual C++ Programming Demo...............................................................................................4-14
Chapter 5 Appendix............................................................................................................ 5-1
Appendix A: Command List........................................................................................................5-1
Appendix B: Factory Setting.......................................................................................................5-6
Appendix C: Warranty ...............................................................................................................5-9
Appendix D: Any Question or Comment? ..................................................................................5-10

Chapter 1 Programming Overview RIGOL
DP800 Programming Guide 1-1
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

RIGOL Chapter 1 Programming Overview
1-2 DP800 Programming Guide
To Build Remote Communication
You can build the remote communication between DP800 and PC over USB, LAN, RS232 or GPIB (option,
can be extended via the USB-GPIB interface converter) interface.
Note: the end mark of the command sent through RS232 interface is "\r\n".
Operation Steps:
1Install the Ultra Sigma common PC software
Download the Ultra Sigma common PC software from www.rigol.com and install it according to the
instructions.
2Connect the instrument and PC and configure the interface parameters of the instrument
DP800 supports USB, LAN, RS232 and GPIB (option, can be extended via the USB-GPIB interface
converter) communication interfaces, as shown in the figure below.
Figure 1-1 DP800 Communication Interfaces
(1) Use the USB interface: connect the USB Device interface at the rear panel of DP800 and the USB
Host interface of the PC using USB cable.
(2) Use the LAN interface:
Make sure that your PC is connected to the local network.
Make sure whether your local network supports DHCP or auto IP mode. If not, you need to
acquire the network interface parameters available, including the IP address, subnet mask,
gateway and DNS.
Connect DP800 to the local network using network cable.
Press Utility I/O LAN to configure the IP address, subnet mask, gateway and DNS of
the instrument.
(3) Use the RS232 interface:
Connect the RS232 interface with the PC or data terminal equipment (DTE) using RS232
cable.
Press Utility I/O RS232 to set interface parameters (baud rate, parity and etc) that
match the PC or terminal equipment.
LAN USB Device RS232

Chapter 1 Programming Overview RIGOL
DP800 Programming Guide 1-3
(4) Use the GPIB interface:
Connect the USB-GPIB interface converter to the USB Device interface at the rear panel of
DP800 to extend a GPIB interface.
Connect the instrument with your PC using GPIB cable.
Press Utility I/O GPIB to set the GPIB address of the instrument.
3Check whether the connection is successful
Run the Ultra Sigma, search for resource, right-click the resource name and select “SCPI Panel Control”
in the pop-up menu. Enter the correct command in the pop-up SCPI control panel and click Send
Command, Read Response or Send&Read to check whether the connection is successful, as
shown in the figure below (take the USB interface as an example).

RIGOL Chapter 1 Programming Overview
1-4 DP800 Programming Guide
Remote Control Methods
1User-defined Programming
You can program and control the instrument using the SCPI (Standard Commands for Programmable
Instruments) commands listed in chapter 2 Command System in various development environments
(such as Visual C++, Visual Basic and LabVIEW). For details, refer to the introductions in chapter 4
Programming Demos.
2Send SCPI Commands via the PC Software
You can control the power supply remotely by sending SCPI commands via the PC software (Ultra
Sigma) provided by RIGOL.Besides, you can also control the instrument using the “Measurement &
Automation Explorer” of NI (National Instruments Corporation) or the “Agilent IO Libraries Suite” of
Agilent (Agilent Technologies, Inc.).
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
SCPI commands present a hierarchical tree structure and contain multiple sub-systems, each of consists of
a root keyword and one or more sub-keywords. 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 parameter are separated by "space".
For example,
:SYSTem:COMMunicate:LAN:IPADdress <ip>
:SYSTem:COMMunicate:LAN:IPADdress?
SYSTem is the root keyword of the command. COMMunicate, LAN and IPADdress are the second-level,
third-level and forth-level keywords respectively. The command string starts with ":" which separates the
multiple-level keywords. <ip> represents the parameters available for setting. "?" represents query and the
power supply returns the response information (the output value or internal setting value of the instrument)
when recieving a query command. The command :SYSTem:COMMunicate:LAN:IPADdress and parameter
<ip> are separated by space.
"," is generally used for separating multiple parameters contained in the same command, for example,
:DELAY:PARAmeter <secnum>,{ON|OFF},<time>

Chapter 1 Programming Overview RIGOL
DP800 Programming Guide 1-5
Symbol Description
The following four symbols are not the content of SCPI commands and will not be sent with the commands.
They are usually used to describe the parameters in the commands.
1Braces { }
Usually, multiple optional parameters are enclosed in the braces and one of the parameters must be
selected when sending the command. For example, :DISPlay:MODE {NORMal|WAVE|DIAL}.
2Vertical Bar |
The vertical bar is used to separate multiple parameters and one of the parameters must be selected
when sending the command. For example, :DISPlay:MODE {NORMal|WAVE|DIAL}.
3Square Brackets [ ]
The content (command keyword) enclosed in the square brackets can be omitted. When the
parameter is omitted, the instrument will set the parameter to its default. For example, for
the :MEASure[:VOLTage][:DC]? command, sending any of the four commands below can achieve the
same effect.
:MEASure?
:MEASure:DC?
:MEASure:VOLTage?
:MEASure:VOLTage:DC?
4Triangle Brackets < >
The parameter enclosed in the triangle brackets must be replaced by an effective value. For example,
send the :ANALyzer:CURRTime <value> command in :ANALyzer:CURRTime 5 form.
Parameter Type
The parameters of the commands introduced in this manual contains 5 types: bool, integer, real number,
discrete and ASCII character string.
1Bool
The parameter could be OFF or ON. For example, :RECorder[:STATe] {ON|OFF}.
2Integer
Unless otherwise noted, the parameter can be any integer within the effective value range. Note that
do not set the parameter to a decimal; otherwise, errors will occur. For example, in
the :SYSTem:BRIGhtness <brightness> command, <brightness> can be any integer from 0 to 100.
3Real Number
Unless otherwise noted, the parameter can be any real number within the effective value range.
For example, for CH1 of DP831A, the ranges of <volt> and <curr> in the :APPLy
{CH1|CH2|CH3},<volt>,<curr> command are 0 to 8.4V and 0 to 5.3A respectively.
4Discrete
The parameter could only be one of specified values or characters. For example, in
the :ANALyzer:OBJect {V|C|P} command, the parameter can be V, C or P.
5ASCII Character String
The parameter should be the combinations of ASCII characters. For example, in the :MMEMory:STORe
<file_name> command, <file_name> is the filename of the file to be saved and can include Chinese
characters, English characters and numbers.

RIGOL Chapter 1 Programming Overview
1-6 DP800 Programming Guide
Besides, many commands contain the MINimum and MAXimum parameters which are used to set the
parameter to its minimum or maximum value. For example, MINimum and MAXimum in
the :SYSTem:BRIGhtness {<brightness>|MINimum|MAXimum} command are used to set the brightness to
the minimum or maximum.
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 :ANALyzer:ANALyze command can be
abbreviated to :ANAL:ANAL.

Chapter 2 Command System RIGOL
DP800 Programming Guide 2-1
Chapter 2 Command System
This chapter introduces the syntax, function, parameter and using instruction of each DP800 command in
A-Z order.
Main topics of this chapter:
:ANALyzer Commands
:APPLy Command
:DELAY Commands
:DISPlay Command
IEEE488.2 Common Commands
:INSTrument Commands
:MEASure Commands
:MEMory Commands
:MMEMory Commands
:MONItor Commands
:OUTPut Commands
:PRESet Commands
:RECorder Commands
:SOURce Commands
:SYSTem Commands
:TIMEr Commands
:TRIGger Commands
Explanation: In this command system, setting commands relating to the time, voltage, current and power
parameters can be sent with units. Unless otherwise noted, the units available and the default unit of each
parameter are as shown in the table below.
Parameter Type
Units Available
Default Unit
Time s
[1]
s
Voltage
V, mV
V
Current A, mA A
Power
W, mW
W
Note[1]:For the :TRIGger:OUT:PERIod [D0|D1|D2|D3,]<value> command (setting the period of the
square waveform of trigger output), <value> is a time parameter and the units available are s, ms and us.
The default unit is s.

RIGOL Chapter 2 Command System
2-2 DP800 Programming Guide
:ANALyzer Commands
The :ANALyzer commands are used to set the analyzer parameters, execute analysis and query the analysis
results.
Command List[1]:
:ANALyzer:ANALyze
:ANALyzer:ENDTime
:ANALyzer:FILE?
:ANALyzer:MEMory
:ANALyzer:MMEMory
:ANALyzer:OBJect
:ANALyzer:RESult?
:ANALyzer:STARTTime
:ANALyzer:VALue?
:ANALyzer:ANALyze
Syntax :ANALyzer:ANALyze
Description When receiving this command, the instrument executes the analysis operation
according to the current setting.
Explanation You can send the :ANALyzer:RESult? command to view the analysis results.
Related
Command :ANALyzer:RESult?
Note[1]: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.