Rigol DP800, DP831A, DP832A, DP832 Programming Manual

Download

Page 1

RIGOL

Programming Guide

DP800 Series Programmable Linear

DC Power Supply

Mar. 2013

RIGOL Technologies, Inc.

Page 2

Page 3

RIGOL

Guaranty and Declaration

Trademark Information

RIGOL is a registered trademark of RIGOL Technologies, Inc.

Publicatio n 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 corre sp onding 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.

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.

DP800 Programming Guide I

Page 4

RIGOL

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 author ized 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 inpu ts 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 specif ied 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 ventilati on may cause inc reasing of temperatur e or damages to th e devic e. So please k eep well ventilated and inspe ct 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 injuri es, it is important to oper ate 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

II DP800 Programming Guide

Page 5

RIGOL

discharges. Always ground both the internal and external conduct ors of the cable to release static before connecting.

Handling Sa fety.

Please handle with care during transportation to avoid damages to buttons, knob interfaces and other parts on the panels.

DP800 Programming Guide III

Page 6

RIGOL

WARNING

CAUTION DANGER

indicates an injury or hazard may immediately happen.

WARNING

indicates an injury or hazard may be accessible potentially.

CAUTION

Hazardous

Safety

Protective

Chassis

Test

Safety Terms and Symbols

Terms in this Manual. These terms may appear in this manual:

Warning statements indicate the conditions or practices that could result in injury or loss of life.

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:

indicates a potential damage to the instrument or other property might occur.

Symbols on the Product. These symbols may appear on the product:

Voltage

Warning

Earth Terminal

Ground

IV DP800 Programming Guide

Page 7

RIGOL

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:

1 Button

The function key at the front panel is denoted by the format of “Button Name (Bold) + Text Box” in the manual, for example, Utility denotes the “System Auxiliary Function Setting” key.

2 Menu

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.

3 Operation Step

The next step of the operation is denoted by an arrow “” in the manual. For example, Utility  System denotes pressing Utility at the front panel and then pressing System.

DP800 Programming Guide V

Page 8

RIGOL

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 e ach 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

VI DP800 Programming Guide

Page 9

Contents

RIGOL

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

DP800 Programming Guide VII

Page 10

RIGOL

: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

VIII DP800 Programming Guide

Page 11

RIGOL

: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

DP800 Programming Guide IX

Page 12

RIGOL

: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

X DP800 Programming Guide

Page 13

Chapter 1 Programming Overview RIGOL

Chapter 1 Programming Overview

This chapter introduces how to build the remote communication between the PC and ins trument 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

DP800 Programming Guide 1-1

Page 14

RIGOL Chapter 1 Programming Overview

LAN USB Device RS232

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: 1 Install the Ultra Sigma common PC software

Download the Ultra Sigma common PC software from instructions.

2 Connect 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 convert er) communicatio n interfaces, as shown in the figure below.

www.rigol.com and install it according to the

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, s ubnet mask, gateway an d 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.

1-2 DP800 Programming Guide

Page 15

Chapter 1 Programming Overview RIGOL

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

3 Check whether the connection is successful

Run the Ultra Sigma, search for resource, right-click the resource name and selec t “SCPI Panel Control” in the pop-up menu. E nter the correct co mmand in the pop-up SCPI control panel and click Send Command, Read Response or Send&Read to check whe ther the connection is successful, as shown in the figure below (take the USB interface as an example).

DP800 Programming Guide 1-3

Page 16

RIGOL Chapter 1 Programming Overview

Remote Control Methods

1 User-defined Programming

You can program and control the instrument using the SCPI (Standard Commands for Programmable Instruments) commands listed in chapter 2 (such as Visual C++, Visual Basic and LabVIEW). For details, refer to the introductions in chapter 4

Programming Demos.

2 Send 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 Automation Explorer” of NI (National Instruments Corporation) or the “Agilent IO Libraries Suite” of Agilent (Agilent Technologies, Inc.).

. Besides, you can also control the instrument using the “Measurement &

Command System in various development environments

SCPI Command Overview

SCPI (Standard Comm ands for Programmable Instruments) is a standardized instrument programming language that is built upon the standard IEEE488.1 and IEEE 488.2 and conforms t o various standards (such as the floating point operation rule in IEEE754 standard, ISO646 7-bit coded character for information intercha nge (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 av ailable 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>

1-4 DP800 Programming Guide

Page 17

Chapter 1 Programming Overview RIGOL

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.

1 Braces { }

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

2 Vertical 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}.

3 Square 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?

4 Triangle Brackets < >

The parameter enclosed in the tri ang le br ack ets m us t be replac ed by an ef fec tive valu e. F o r examp le,

send the :ANALyzer:CURRTime <value> command in :ANALyzer:CURRTime 5 form.

Parameter Type

The parameters of the commands introduced in this manua l contains 5 types: bool, integer, real number, discrete and ASCII character string.

1 Bool

The parameter could be OFF or ON. For example, :RECorder[:STATe] {ON|OFF}.

2 Integer

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.

3 Real 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.

4 Discrete

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.

5 ASCII 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 f ile to be saved and can include Chinese characters, English characters and numbers.

DP800 Programming Guide 1-5

Page 18

RIGOL Chapter 1 Programming Overview

Besides, many commands conta in 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 Abb r eviation

All the commands are case-insensitive and you can use any of them. If abbreviation is used, all the capital letters in the comman d must be written c ompletely. For example, the :ANALyzer:ANALyze command can be abbreviated to :ANAL:ANAL.

1-6 DP800 Programming Guide

Page 19

Chapter 2 Command System RIGOL

Parameter Type

Units Available

Default Unit

[1]

Voltage

V, mV

Power

W, mW

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.

Time s

Current A, mA A

[1]

Note

: 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 an d th e u nits a v ailable are s, ms and us. The default unit is s.

DP800 Programming Guide 2-1

Page 20

RIGOL Chapter 2 Command System

:ANALyzer Commands

The :ANALyzer commands are used to set th e analyzer parameter s, execute an alysis and qu ery the analysis results.

Command List

 :ANALyzer:ANALyze  :ANALyzer:ENDTime  :ANALyzer:FILE?  :ANALyzer:MEMory  :ANALyzer:MMEMory  :ANALyzer:OBJect  :ANALyzer:RESult?  :ANALyzer:STARTTime  :ANALyzer:VALue?

:ANALyzer:ANALyze

[1]

Syntax :ANALyzer:ANALyze

Description When receiving this command, the instrument executes the analysis operation

according to the curre nt setting.

Explanation You can send the

Command

[1]

Note

commands are not included and you can refer to the complete introductions of the commands in the text according to the keyword.

: In the “Command List” in this m anual, the parameters in the setting commands and the query

:ANALyzer:RESult?

:ANALyzer:RESult? command to view the analysis results.

2-2 DP800 Programming Guide

Page 21

Chapter 2 Command System RIGOL

:ANALyzer:ENDTime

Syntax :ANALyzer:ENDTime {<value>|MINimum|MAXimum}

:ANALyzer:ENDTime? [MINimum|MAXimum]

Description Set the end time of the analyzer.

Query the end time of the analyzer.

Parameter

Name Type Range Default

<value> Integer Start time to the current maximum record time

Explanation  You can only set the end time when valid record file is opened (refer to

:ANALyzer:FILE? command).

the

 When receiving the

:ANALyzer:ANALyze command, the analyzer will analyze the

recorded data between the start time and end time.

Return Format The query returns an integer, for example, 125.

Example :ANAL:ENDT 125 /*Set the end time to 125s*/

:ANAL:ENDT? /*Query the current end time and the query returns 125*/

Commands

:ANALyzer:ANALyze :ANALyzer:FILE? :ANALyzer:STARTTime

:ANALyzer:FILE?

Syntax :ANALyzer:FILE?

Description Query the record file currently opened.

Return Format The query returns the directory of the file currently opened, for example, C:\REC

10:test.ROF.

:ANALyzer:MEMory

Syntax :ANALyzer:MEMory {1|2|3|4|5|6|7|8|9|10}

Description Open the specified record file in the internal memory.

Parameter

{1|2|3|4|5|6|7|8|9|10} Discrete 1|2|3|4|5|6|7|8|9|10 None

Name Type Range Default

Explanation This command is only available when valid record file is stored in the specified

location.

Example :ANAL:MEMory 10 /*Open the record file currently stored in record file storage

location 10 in C disk*/

DP800 Programming Guide 2-3

Page 22

RIGOL Chapter 2 Command System

<dest>

ASCII character string

Valid directory under D disk

None

:ANALyzer:MMEMory

Syntax :ANALyzer:MMEMory <dest>

Description Open the specified record file.

Parameter

Name Type Range Default

Explanation This command is only available when valid record file is stored in the specified

location.

Example :ANAL:MMEMory D:\record.ROF /*Open the record.ROF file under D disk*/

:ANALyzer:OBJect

Syntax :ANALyzer:OBJect {V|C|P}

:ANALyzer:OBJect?

Description Set the analysis object of the analyzer to voltage, current or power.

Query the anal ysis object of the analyzer.

Parameter

Explanation You can only set the analysis object when valid record file is opened (refer to

Return Format The query returns V, C or P.

Example :ANAL:OBJ V /*Set the analysis object of the analyzer to voltage*/

Name Type Range Default

{V|C|P} Discrete V|C|P V

the :ANALyzer:FILE?

command).

:ANAL:OBJ? /*Query the analysis object of the analyzer and the query returns V*/

:ANALyzer:FILE?

Command

:ANALyzer:RESult?

Syntax :ANALyzer:RESult?

Description Query the analysis results, including the number of groups, median, mode, average,

variance, range, min, max and mean deviation.

Return Format The query returns the analysis results with the data separated by commas, for

example, Group:1029,Median:0.0155V,Mode:0.0155V,Average:0.0154V,Variance:0.0000V, Range:0.0005V,Min:0.0152V,Max:0.0157V,Mean:0.0000V.

Example :ANAL:RES? /*Query the analysis results */

2-4 DP800 Programming Guide

Page 23

Chapter 2 Command System RIGOL

:ANALyzer:STARTTime

Syntax :ANALyzer:STARTTime {<value>|MINimum|MAXimum}

:ANALyzer:STARTTime? [MINimum|MAXimum]

Description Set the start time of the analyzer.

Query the start time of the analyzer.

Parameter

Name Type Range Default

<value> Integer 1s to end time 1

Explanation  You can only set the start time when valid record file is opened (refer to

:ANALyzer:FILE? command).

the

 Send the

:ANALyzer:ANALyze command and the analyzer analyzes the

recorded data between the start time and end time.

Return Format The query returns an integer, for example, 1.

Example :ANAL:STARTT 1 /*Set the start time to 1s*/

:ANAL:STARTT? /*Query the current start time and the query returns 1*/

Commands

:ANALyzer:ANALyze :ANALyzer:FILE? :ANALyzer:ENDTime

:ANALyzer:VALue?

Syntax :ANALyzer:VALue? <time>

Description Query the voltage, current and powe r at the specified time in the record file

opened.

Parameter

Name Type Range Default

<time> Integer Start time to end time None

Return Format The query returns the voltage, current and power separated by commas, for

example, Volt:1.2817V,Curr:0.0485A,Power:0.0622W.

Example :ANAL:VAL? 5 /*Query the voltage, current and power at 5s and the query returns

Volt:1.2817V,Curr:0.0485A,Power:0.0622W*/

Commands

:ANALyzer:ENDTime :ANALyzer:FILE? :ANALyzer:STARTTime

DP800 Programming Guide 2-5

Page 24

RIGOL Chapter 2 Command System

:APPLy Command

The :APPLy command provides the most straightforward method to program the power supply over the remote interface.

Syntax :APPLy {CH1|CH2|CH3}

[,<volt>|MINimum|MAXimum][,<curr>|MINimum|MAXimum] :APPLy? {CH1|CH2|CH3}[,CURRent|VOLTage]

Description Set the voltage/current of the specified channel.

Query the voltage/current of the specified channel.

Parameter

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

<volt> Real Refer to the “Explanation” <curr> Real Refer to the “Explanation”

Explanation  <volt> and <curr> can be omitted. If both of them are omitted, the command

will select the desired channel; if only one of them is omitted, the command will set the voltage of the specified channel.

 The p arameter r anges and def aults of each channel for diff erent models are as

listed in the table below. Channel <volt> Range <volt> Default <curr> Range <curr> 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 Channel <volt> Range <volt> Default <curr> Range <curr> 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

 If [,CURRent|VOLTage] is omitted in the query command, the command

queries the voltage and current of the specified channel.

Return Format If [,CURRent|VOLTage] is not omitted, the query returns the voltage or current, for

example, 5.000; if the parameter is omitted, the query returns the label, voltage and current of the specified channel (separated by commas), for example, CH1,5.000,1.0000.

Example :APPL CH1,5,1 /*Set the voltage and current of CH1*/

:APPL? CH1 /*Query the voltage and current of CH1 and the query returns

CH1,5.000,1.0000*/

2-6 DP800 Programming Guide

Page 25

Chapter 2 Command System RIGOL

:DELAY Commands

The :DELAY commands are used to set the delayer parameters (the number of groups, number of cycles, end state and etc) as well as enable or disable the delayer.

Command List:

 :DELAY:CYCLEs  :DELAY:ENDState  :DELAY:GROUPs  :DELAY:PARAmeter  :DELAY[:STATe]  :DELAY:STATe:GEN  :DELAY:STOP  :DELAY:TIME:GEN

:DELAY:CYCLEs

Syntax :DELAY:CYCLEs {N|I}[,<value>]

:DELAY:CYCLEs?

Description Set the number of cycles of the delayer.

Query the number of cycles of the delayer.

Parameter

Name Type Range Default

{N|I} Discrete N|I N

<value> Integer 1 to 99999 1

Explanation  The number of cycles refers to the number of times that the instrument

performs delay output according to the preset state. Wherein, I represents infinite number of cycles; N represents finite number of cycles, the number of cycles is specified by <value> and when this parameter is omit ted, the number of cycles is set to 1 by default.

 The total number of groups in each delay output = the number of groups × the

number of cycles; wherein, the numb er of groups is s et by the

:DELAY:GROUPs

command.

 The power supply will terminate the delay er funct ion when the to tal number of

groups of delays is finished. At this point, the state of the power supply depends on the setting of the

:DELAY:ENDState command.

Return Format The query returns I or N,<value>, for example, N,100.

Example :DELAY:CYCLE I /*Set the number of cycles to “Infinite” */

:DELAY:CYCLE N /*Set the number of cycles to 1*/ :DELAY:CYCLE N,100 /*Set the number of cycles to 100*/

:DELAY:CYCLE? /*Query the curr ent number of cycles and the query returns

N,100*/

Commands

DP800 Programming Guide 2-7

:DELAY:ENDState :DELAY:GROUPs

Page 26

RIGOL Chapter 2 Command System

depends on the setting of the :DELAY:ENDState command.

:DELAY:ENDState

Syntax :DELAY:ENDState {ON|OFF|LAST}

:DELAY:ENDState?

Description Set the end state of the delayer to On, Off or Last.

Query the end state of the delayer.

Parameter

Name Type Range Default

{ON|OFF|LAST} Discrete ON|OFF|LAST OFF

Explanation  The end state refers to the state of the instrument when the delayer stops.

 ON: output on , the instrument tur ns on the output automatically; OFF: output

off, the instrume nt turns off the output automatically; LAST: last state, the

instrument stops at the output state of the last group.

 The total number of groups in each delay output = the number of groups × the

number of cycles. Wherei n, the number of grou ps is set by the

command and the number of cycles is set by the

:DELAY:CYCLEs command.

:DELAY:GROUPs

Return Format The query returns ON, OFF or LAST.

Example :DELAY:ENDS LAST /*Set the end state to Last*/

:DELAY:ENDS? /*Query the current end state and the query r eturns LAST */

Commands

:DELAY:GROUPs :DELAY:CYCLEs

:DELAY:GROUPs

Syntax :DELAY:GROUPs <value>

:DELAY:GROUPs?

Description Set the number of output groups of the delayer.

Query the number of output groups of the delayer.

Parameter

Name Type Range Default

<value> Integer 1 to 2048 1

Explanation  The number of output groups refers to the number of times that the

instrument turns on or off the output a ccording to the preset state.

 The total number of groups in each delay output = the number of groups × the

number of cycles. Wherein, the number of cycles is set by the

command.

 The power supply will terminate the delay er funct ion when the to tal number of

groups of delays is finished. At this point, the state of the power supply

Return Format The query returns an integer from 1 to 2048.

Example :DELAY:GROUP 125 /*Set the number of groups to 125*/

:DELAY:GROUP? /*Query the current number of groups and the query

returns 125*/

Commands

:DELAY:CYCLEs :DELAY:ENDState

:DELAY:CYCLEs

2-8 DP800 Programming Guide

Page 27

Chapter 2 Command System RIGOL

:DELAY:PARAmeter

Syntax :DELAY:PARAmeter <secnum>,{ON|OFF},<time>

:DELAY:PARAmeter? <firnum>,<timercount>

Description Set the delayer parameters of the specified groups.

Query the delayer parameters of the specified groups.

Parameter

Name Type Range Default

<secnum> Integer 0 to 2047 None

{ON|OFF} Bool ON|OFF

OFF (even group);

ON (odd group)

<time> Integer 1 to 99999 1s

<firnum> Integer 0 to 2047 None

<timercount> Integer 1 to 2048 None

Explanation  <secnum> is the group number of the delayer parameters; {ON|OFF} is the

output state; <time> is the delay time.

 <firnum> is the group number of the first group of delayer parameters to be

queried; <timercount> is the total number of groups of delayer parameters to be queried.

Return Format

For example, #90000000151,ON,1;2,OFF,1; wherein, #90000 is the data block header; 00015

is the number of bytes followed; 1,ON,1;2,OFF,1; are the delayer parameters returned. The format of each group of parameters is “number,output state,delay time”, multiple groups of return values are separated by semicolons and parameters of the same group are separated by commas.

Example :DELAY:PARA 1,ON,2 /*Set the state of the first group to ON and the time to 2s*/

:DELAY:PARA? 3,2 /*Q uery two groups of delay er parameters starting from the

third group*/

/*The query returns #90000000153,ON,1;4,OFF,1;*/

:DELAY[:STATe]

Syntax :DELAY[:STATe] {ON|OFF}

:DELAY[:STATe]?

Description Enable or disable the delay output function.

Query the state of the delay output function.

Parameter

Explanation  Enabling the delayer will change the output state of the channel. Make sure

Return Format The query returns ON or OFF.

Example :DELAY ON /*Enabl e the delay output*/

DP800 Programming Guide 2-9

Name Type Range Default

{ON|OFF} Bool ON|OFF OFF

that the devices connected to the power supply will not be affected before enabling the delayer.



The delayer parameters cannot be modified when the delayer is enabled.

:DELAY? /*Query the status of the delay output and the query returns ON*/

Page 28

RIGOL Chapter 2 Command System

:DELAY:STATe:GEN

Syntax :DELAY:STATe:GEN {01P|10P}

:DELAY:STATe:GEN?

Description Select the pattern used when generating state automatically.

Query the pattern used when generating state automatically.

Parameter

Name Type Range Default

{01P|10P} Discrete 01P|10P 01P

Explanation  01P: 0 1 pattern. The state is set to “Off” and “On” alternately.



10P: 1 0 pattern. The state is set to “On” and “Off” alternately.

Return Format The query returns 01P or 10P.

Example :DELAY:STAT:GEN 10P /*Select 1 0 pattern*/

:DELAY:STAT:GEN? /*Query the pattern used when generating state

automatically and the query returns 10P */

:DELAY:STOP

Syntax :DELAY:STOP {NONE|<V|>V|<C|>C|<P|>P}[,<value>|MINimum|MAXimum]

:DELAY:STOP? [MINimum|MAXimum]

Description Set the stop condition of the delayer.

Query the stop condition of the delayer.

Parameter

Name Type Range Default

{NONE|<V|>V| <C|>C|<P|>P}

Discrete NONE|<V|>V|<C|>C|<P|>P NONE

0 to the maximum

<value> Real

voltage/current/power of the

current channel

Explanation  This command sets a stop condition. The power supply monitors the output

voltage, current and po wer during delay output and stops the delay output when state that fulfills this condition is detected.

 {NONE|<V|>V|<C|>C|<P|>P} can set the stop condi tion to “None”, “<Volt”,

“>Volt”, “<Curr”, “>Curr”, “<Power” or “>Power”. <value> is used to set the voltage, current or power of the stop condition and when it is omitted, the corresponding value will be set to 0.

Return Format The query returns NONE or “stop condition,value”, for example, >V,8.000.

Example :DELAY:STOP >V,8 /*Set the stop condition to “>Volt” and the voltage to 8V*/

:DELAY:STOP? /*Query the current stop condition and the query

returns >V,8.000*/

2-10 DP800 Programming Guide

Page 29

Chapter 2 Command System RIGOL

:DELAY:TIME:GEN

Syntax :DELAY:TIME:GEN {FIX|INC|DEC}[,<value0>[,<value1>]]

:DELAY:TIME:GEN?

Description Set the method used to generate time automatically as well as the corresponding

on/off delay time or the time base value and step value. Query the method used t o generate time au tomatically as well as the correspon ding

parameters.

Parameter

Name Type Range Default

{FIX|INC|DEC} Discrete FIX|INC|DEC FIX

<value0> Integer Refer to the “Explanation” 1s <value1> Integer Refer to the “Explanation” 1s

Explanation  When FIX (fixed time) is selected, <value0> and <value1> are used to set the

on/off delay time and the range is from 1s to 99999s. When both of the parameters are omitted, the on/off delay time will be set to 1s; when only one of the parameters is omitted, the on delay time will be set.

 When INC (monotonic increase) or DEC (monotonic decline) is selected,

<value0> and <value1> are used to set the time base value and step value. The time increases or declines gradually from the time base value at the specified step to generate time. The two fulfills the relation: time base value + number of output groups*step value≤99999s. When both of the two parameters are omit ted , th e ti me base value and step v al ue will both be set to 1s; when only one of the par ameters is omitted, th e time base valu e will be set.

Return Format Fix: the query returns FIX,<value0>,<value1>, for exa mple, FIX,1,2;

INC: the query returns INC,<value0>,<value1>, for example, INC,2,5; DEC: the query returns DEC,<value0>,<value1>, for example, DEC,200,5.

Example :DELAY:TIM E :G EN I NC,2,5 /*Monotonic increase, the time base value is 2s and

the step is 5s*/

:DELAY:TIME:GEN? /*Query the method used to generate time automatically

and the parameters; the query returns INC,2,5*/

DP800 Programming Guide 2-11

Page 30

RIGOL Chapter 2 Command System

:DISPlay Command

Syntax :DISPlay:MODE {NORMal|WAVE|DIAL}

:DISPlay:MODE?

Description Set the display mode to normal, wave or dial.

Query the current display mode.

Parameter

{NORMal|WAVE|DIAL} Discrete NORMal|WAVE|DIAL NORMal

Name Type Range Default

Explanation  NORMal: normal mode. The parameters (such as the voltage and curren t) of all

the channels are displayed in number format.

 WAVE: waveform mode. The parameters (such as the voltage and current) of

the channel currently selected are displayed in both waveform and number formats.

 DIAL: dial mode. The parameters (such as the voltage and current) of the

channel currently selected are displayed in both dial and number format s.

Return Format The query returns NORMAL, WAVE or DIAL.

Example :DISP:MODE WAVE /*Select the waveform display mode*/

:DISP:MODE? /*Query the current display mode and the query returns WAVE */

2-12 DP800 Programming Guide

Page 31

Chapter 2 Command System RIGOL

IEEE488.2 Common Commands

Command List:

 *IDN?  *RCL  *RST  *SAV  *TST?

*IDN?

Syntax *IDN?

Description Query the ID character string of the instrument.

Return Format The query returns the ID character string of the instrument, for example, RIGOL

TECHNOLOGIES,DP831A,DP8A000001,00.01.01.

*RCL

Syntax *RCL {1|2|3|4|5|6|7|8|9|10}

Description Read the instrument state stored.

Parameter

{1|2|3|4|5|6|7|8|9|10} Discrete 1|2|3|4|5|6|7|8|9|10 None

Explanation  The power supply provid es 10 storage locat ions (numbered 1 to 10) for

 This command is only available when the specified storage location contains a

Command

:MEMory[:STATe]:LOAD

Name Type Range Default

instrument states. This command reads the instrument state stored in the specified location.

state file.

*RST

Syntax *RST

Description Restore the power supply to factory state (refer to

clear the error queue.

Commands

:PRESet:KEY :PRESet[:APPLy]

Appendix B: Factory Setting) and

DP800 Programming Guide 2-13

Page 32

RIGOL Chapter 2 Command System

*SAV

Syntax *SAV {1|2|3|4|5|6|7|8|9|10}

Description Save the current system state to the specified storage location using the default

name. The default name is RIGOLn.RSF; n corresponds to the number of the storage location.

Parameter

{1|2|3|4|5|6|7|8|9|10} Discrete 1|2|3|4|5|6|7|8|9|10 None

Name Type Range Default

Explanation  The power supply provid es 10 storage locat ions (numbered 1 to 10) for

instrument states.

 If the specified storage location already contains a state file, this command will

directly overwrite the original file. If the state file stored in the specified storage location is locked (refer to the

:MEMory[:STATe]:LOCK command), this

command will not overwrite the original file and the storage operation is invalid.

Example *SAV 5 /*Save the current instrument state to storage location 5 with the

filename RIGOL5.RSF*/

:MEMory[:STATe]:STORe

Command

*TST?

Syntax *TST?

Description Query the self-test results of the instrument.

Explanation The power supply executes self-test at start-up. This command queries the self-test

results (including TopBoard, BottomBoard and fan).

Return Format The query returns the se lf-test results of TopBoard, BottomBoard and fan

respectively, for example, TopBoard:PASS,BottomBoardPASS,Fan:PASS.

Commands

:SYSTem:SELF:TEST:BOARD? :SYSTem:SELF:TEST:FAN?

2-14 DP800 Programming Guide

Page 33

Chapter 2 Command System RIGOL

:INSTrument Commands

Command List:

 :INSTrument:NSELect  :INSTrument[:SELEct]

:INSTrument:NSELect

Syntax :INSTrument:NSELect {1|2|3}

:INSTrument:NSELect?

Description Select the desired channel.

Query the channel currently selected.

Parameter

Name Type Range Default

{1|2|3} Discrete 1|2|3 1

Explanation In this command, numbers are used in place of the channel lab els in

:INSTrument[:SELEct] command.

the

Return Format The query returns 1, 2 or 3.

Example :INST:NSEL 3 /*Select CH3*/

:INST:NSEL? /*Query the channel cur rently selecte d and the query returns 3*/

:INSTrument[:SELEct]

Command

:INSTrument[:SELEct]

Syntax :INSTrument[:SELEct] {CH1|CH2|CH3}

:INSTrument[:SELEct]?

Description Select the desired channel.

Query the channel currently selected.

Parameter

Return Format The query returns CH1:8V/5A, CH2:30V/2A, CH3:-30V/2A (DP831A) or CH1:30V/3A,

CH2:30V/3A, CH3:5V/3A (DP 832A and DP832).

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 CH1

Example :INST CH3 /*Sele c t CH3*/

:INST? /*Query the channel currently selected and

the query returns CH3:-30V/2A */

:INSTrument:NSELect

Command

DP800 Programming Guide 2-15

Page 34

RIGOL Chapter 2 Command System

:MEASure Commands

Command List:

 :MEASure:ALL[:DC]?  :MEASure:CURRent[:DC]?  :MEASure:POWEr[:DC]?  :MEASure[:VOLTage][:DC]?

:MEASure:ALL[:DC]?

Syntax :MEASure:ALL[:DC]? [{CH1|CH2|CH3}]

Description Query the voltage, current and power measured in ternally on th e specified channel.

Parameter

Name Type Range Default

[{CH1|CH2|CH3}] Discrete CH1|CH2|CH3 None

Explanation  If the parameter is omitted, the command queries the voltage, current and

power of the channel currently selected.

 You can send the

:MEASure[:VOLTage][:DC]? commands to query the current, power and

and

:MEASure:CURRent[:DC]?, :MEASure:POWEr[:DC]?

voltage respectively.

Return Format The query returns the voltage, current and power separated by commas, for

example, 5.0000,1.0000,5.000.

Example :MEAS:ALL? CH1 /*Query the voltage, current and power of CH1 and the query

returns 5.0000,1.0000,5.000*/

Commands

:MEASure:CURRent[:DC]? :MEASure:POWEr[:DC]? :MEASure[:VOLTage][:DC]?

:MEASure:CURRent[:DC]?

Syntax :MEASure:CURRent[:DC]? [{CH1|CH2|CH3}]

Description Query the output current measured interna lly on the specified channel.

Parameter

Name Type Range Default

[{CH1|CH2|CH3}] Discrete CH1|CH2|CH3 None

Explanation  If the parameter is omitted, the command queries the current of the channel

currently selected.

 You can send the

:MEASure:POWEr[:DC]? and :MEASure[:VOLTage][:DC]?

commands to query the power and voltage respectively, or send

:MEASure:ALL[:DC]? command to query the voltage, curr ent and p ower at

the the same time.

Return Format The query returns the current, for example, 1.0000.

Example :MEAS:CURR? CH1 /*Query the current of CH1 and the query returns 1.0000*/

Commands

:MEASure:ALL[:DC]? :MEASure:POWEr[:DC]? :MEASure[:VOLTage][:DC]?

2-16 DP800 Programming Guide

Page 35

Chapter 2 Command System RIGOL

:MEASure:POWEr[:DC]?

Syntax :MEASure:POWEr[:DC]? [{CH1|CH2|CH3}]

Description Query the output power measured internally on the specified channel.

Parameter

Name Type Range Default

[{CH1|CH2|CH3}] Discrete CH1|CH2|CH3 None

Explanation  If the parameter is omitted, the command queries the power of the channel

currently selected.

 You can send the

:MEASure:CURRent[:DC]? and :MEASure[:VOLTage][:DC]?

commands to query the current and voltage respectively, or send

:MEASure:ALL[:DC]? command to query the voltage, cu rrent an d power at

the the same time.

Return Format The query returns the power, for example, 5.000.

Example :MEAS:POWE? CH1 /*Query the p ower of CH1 and the query returns 5.000*/

Commands

:MEASure:ALL[:DC]? :MEASure:CURRent[:DC]? :MEASure[:VOLTage][:DC]?

:MEASure[:VOLTage][:DC]?

Syntax :MEASure[:VOLTage][:DC]? [{CH1|CH2|CH3}]

Description Query the output voltage measured internally on the specified channel.

Parameter

Name Type Range Default

[{CH1|CH2|CH3}] Discrete CH1|CH2|CH3 None

Explanation  If the parameter is omitted, the command queries the voltage of the channel

currently selected.

 You can send the

:MEASure:CURRent[:DC]? and :MEASure:POWEr[:DC]?

commands to query the current and power respectively, or send

:MEASure:ALL[:DC]? command to query the voltage, cu rrent an d power at

the the same time.

Return Format The query returns the voltage, for example, 5.0000.

Example :MEAS? CH1 /*Query the volt age of CH1 and t he query returns 5.0000*/

Commands

:MEASure:ALL[:DC]? :MEASure:CURRent[:DC]? :MEASure:POWEr[:DC]?

DP800 Programming Guide 2-17

Page 36

RIGOL Chapter 2 Command System

:MEMory Commands

The :MEMory commands are used to save, delete, read or lock the file stored in the specified storage location in the internal memory. DP800 allows four kinds of files to be saved in the internal memory.

1. State File (RSF): store the current system state, including the voltage, current, OVP, OCP and track function status of each channel as well as the system parameters.

2. Record File (ROF): store the output voltage, current and power of each channel when the recorder is enabled (for the channel of which the output is disabled, the correspo nding recorded data will be 0).

3. Timer File (RTF): store the timer parameters edited (the voltage, current and time of each group of parameters).

4. Delay File (RDF): store the delayer parameters edited (the state and time of each group of parameters).

Command List:

 :MEMory[:STATe]:DELete  :MEMory[:STATe]:LOAD  :MEMory[:STATe]:LOCK  :MEMory[:STATe]:STORe  :MEMory[:STATe]:VALid?

:MEMory[:STATe]:DELete

Syntax :MEMory[:STATe]:DELete {RSF|ROF|RTF|RDF},{1|2|3|4|5|6|7|8|9|10}

Description Delete the specified file stored, including state file (RSF), record fi l e (ROF), timer file

(RTF) and delay file (RDF).

Parameter

Name Type Range Default

{RSF|ROF|RTF|RDF} Discrete RSF|ROF|RTF|RDF None

{1|2|3|4|5|6|7|8|9|10} Discrete 1|2|3|4|5|6|7|8|9|10 None

Explanation  This command is only available when the specified storage location contains file.

 This command is invalid when the file stored in the specified storage location is

locked (refer to the

:MEMory[:STATe]:LOCK command).

Example :MEM:DEL RSF,5 /*Delete the state file currently stored in storage location 5*/

:MEMory[:STATe]:LOAD

Syntax :MEMory[:STATe]:LOAD {RSF|RTF|RDF},{1|2|3|4|5|6|7|8|9|10}

Description Read the specified file stored, including state file ( RSF), timer file (RTF) and delay file

(RDF).

Parameter

Name Type Range Default

{RSF|RTF|RDF} Discrete RSF|RTF|RDF None

{1|2|3|4|5|6|7|8|9|10} Discrete 1|2|3|4|5|6|7|8|9|10 None

Explanation This command is only available when the specified storage location contains file.

Example :MEM:LOAD RSF,5 /*Read the state file currently stored in storage location 5*/

*RCL

Command

2-18 DP800 Programming Guide

Page 37

Chapter 2 Command System RIGOL

:MEMory[:STATe]:LOCK

Syntax :MEMory[:STATe]:LOCK {RSF|ROF|RTF|RDF},{1|2|3|4|5|6|7|8|9|10},{ON|OFF}

:MEMory[:STATe]:LOCK? {RSF|ROF|RTF|RDF},{1|2|3|4|5|6|7|8|9|10}

Description Lock or unlock the file in the specified storage location.

Query whether the file in the specified storage location is locked.

Parameter

Name Type Range Default

{RSF|ROF|RTF|RDF} Discrete RSF|ROF|RTF|RDF None

{1|2|3|4|5|6|7|8|9|10} Discrete 1|2|3|4|5|6|7|8|9|10 None

{ON|OFF} Discrete ON|OFF OFF

Explanation The locked file cannot be saved and deleted, but can be read.

Return Format The query returns YES or NO.

Example :MEM:LOCK RSF,5,ON /*Lock the file in state file storage location 5*/

:MEM:LOCK? RSF,5 /*Query the locking state of the file in state file storage

location 5 and the query returns YES*/

:MEMory[:STATe]:STORe

Syntax :MEMory[:STATe]:STORe {RSF|RTF|RDF},{1|2|3|4|5|6|7|8|9|10}

Description Save the specified type of file to the specified storage location.

Parameter

{1|2|3|4|5|6|7|8|9|10} Discrete 1|2|3|4|5|6|7|8|9|10 None

Explanation  This command is used to st ore state file, timer file and delay file. The storage

Name Type Range Default

{RSF|RTF|RDF} Discrete RSF|RTF|RDF None

directory o f the record file is specified by the

:RECorder:MEMory command and

the record file is stored automatically when the recorder is turned off.

 If the specified storage location already contains file, this command will

overwrite the original file directly. If the file stored in the specified storage location is locked (refer to the

:MEMory[:STATe]:LOCK command), this

command will not overwrite the original file and the storage operation is invalid.

Example :MEM:STOR RSF,5 /*Store the current instrument state to location 5*/

Commands

*SAV :RECorder:MEMory

DP800 Programming Guide 2-19

Page 38

RIGOL Chapter 2 Command System

{RSF|ROF|RTF|RDF}

Discrete

RSF|ROF|RTF|RDF

None

:MEMory[:STATe]:VALid?

Syntax :MEMory[:STATe]:VALid? {RSF|ROF|RTF|RDF},{1|2|3|4|5|6|7|8|9|10}

Description Query whether the specified storage location contains a valid file.

Parameter

{1|2|3|4|5|6|7|8|9|10} Discrete 1|2|3|4|5|6|7|8|9|10 None

Name Type Range Default

Explanation The read and delete operations are only available when the specified storage

location contains a valid file.

Return Format The query returns YES or NO.

Example :MEM:VAL? RSF,5 /*Query whether the state file storage location 5 contains a

valid file and the query ret urns YES*/

2-20 DP800 Programming Guide

Page 39

Chapter 2 Command System RIGOL

:MMEMory Commands

The :MMEMory commands are used to store the file to the specified external storage directory, read or delete the specified file in the external memory as well as query the disk information of the external memory.

Command List:

 :MMEMory:CATalog?  :MMEMory:CDIRectory  :MMEMory:DELete  :MMEMory:DISK?  :MMEMory:LOAD  :MMEMory:MDIRectory  :MMEMory:STORe

:MMEMory:CATalog?

Syntax :MMEMory:CATalog?

Description Query all the files and folders in the current operation directory.

Explanation This command is only applicable to external memory.

Return Format The query returns all the files and folders under the current operation directory, for

example, RIGOL0.BMP,RIGOL1.BMP,RIGOL2.BMP,cc.RSF.

DP800 Programming Guide 2-21

Page 40

RIGOL Chapter 2 Command System

:MMEMory:CDIRectory

Syntax :MMEMory:CDIRector y <d ire ct ory_ na me >

:MMEMory:CDIRectory?

Description Set the current operation directory.

Query the current operation directory.

Parameter

Name Type Range Default

<directory_name> ASCII character string Valid directory NULL

Explanation  This command is only applicable to external memory. If the directory set does

not exist, “Invalid directory.” will be displayed.

 After setting the external storage directory to the current operation directory,

send the

:MMEMory:DELete, :MMEMory:LOAD or :MMEMory:STORe command

to delete or read the file under the current directory or to save the file to the current directory. Sending the folder under the current directory.

:MMEMory:MDIRectory command will create a

Return Format The query returns the current operation directory, for example, D:\RIGOL.

Example :MMEM:CDIR D:\RIGOL /*Set the current operation directory to D:\RIGOL*/

:MMEM:CDIR? /*Query the current operation directory and the query

returns D:\RIGOL*/

Commands

:MMEMory:DELete :MMEMory:LOAD :MMEMory:MDIRectory :MMEMory:STORe

:MMEMory:DELete

Syntax :MMEMory:DELete <file_name>

Description Delete the specified file under the current operation directory.

Parameter

Name Type Range Default

<file_name> ASCII character string

Filename of the file to

be deleted

Explanation  This command is only available when the current operation dir ectory contains

the specified file.

 If the file to be deleted is not under the current oper ation direct ory, please use

:MMEMory:CDIRectory command to modify the current operati on directory .

the

Example :MMEM:DEL STA.RSF /*Delete the STA.RSF file under the current operation

directory*/

:MMEMory:CDIRectory

Command

None

2-22 DP800 Programming Guide

Page 41

Chapter 2 Command System RIGOL

:MMEMory:DISK?

Syntax :MMEMory:DISK?

Description Query the drive letter available of the power supply.

Explanation This command only queries the drive letter of the external memory of the power

supply.

Return Format The query returns the drive letter available, for example, D:\.

Example :MMEM:DISK? /*Query the drive letter available and the query returns D:\*/

:MMEMory:LOAD

Syntax :MMEMory:LOAD <file_name>

Description Read the specified file under the current operation directory.

Parameter

Name Type Range Default

<file_name> ASCII character string

Filename of the file to be

read

Explanation  With this command, you can read the state file (RSF), timer file (RTF) and

delay file (RDF).

 This command is only available when the current operatio n directory contains

the specified file.

 If the file to be read is not under the current operation directory, please use

the

:MMEMory:CDIRectory command to modify the current operati on directory.

Example :MMEM:LOAD STT.RSF /*Read the STT.RSF file under the current operation

directory*/

:MMEMory:CDIRectory

Command

:MMEMory:MDIRectory

Syntax :MMEMory:MDIRect ory <d i r_na me >

Description Create a new folder under the current o peration directory.

Parameter

Name Type Range Default

None

Filename of the folder to be created, up to 9 characters,

<dir_name> ASCII character string

including Chinese

None

characters, English

characters or numbers

Example :MMEM:MDIR NEW /*Create a folder with the name NEW under the current

operation directory*/

DP800 Programming Guide 2-23

Page 42

RIGOL Chapter 2 Command System

:MMEMory:STORe

Syntax :MMEMory:STORe <f ile_name>

Description Save the file with the specified filename under the current operation directory.

Parameter

Name Type Range Default

Filename of the file to be saved,

including Chinese characters, English

characters or numbers

<file_name>

ASCII character

string

None

Explanation  With this command, you can save the state file (RSF), timer file (RTF) and delay file

(RDF).

 If the current operation directory alread y contains a f ile with the same filename,

this command will overwrite the original file directly.

Example :MMEM:STORe STB.RSF /*Save the current instrument state under the current

operation directory wit h the name STB.RSF*/

2-24 DP800 Programming Guide

Page 43

Chapter 2 Command System RIGOL

:MONItor Commands

The :MONItor commands are used to set the monitor condition and stop mode of the monitor as well as enable or disable the monitor.

Command List:

 :MONItor:CURRent:CONDition  :MONItor:CURRent[:VALue]  :MONItor:POWER:CONDition  :MONItor:POWER[:VALue]  :MONItor[:STATe]  :MONItor:STOPway  :MONItor:VOLTage:CONDition  :MONItor:VOLTage[:VALue]

:MONItor:CURRent:CONDition

Syntax :MONItor:CURRent:CONDition {<C|>C|NONE},{AND|OR|NONE}

:MONItor:CURRent:CONDition?

Description Set the current monitor condition of the monitor.

Query the current monitor condition of the monitor.

Parameter

Name Type Range Default

{<C|>C|NONE} Discrete <C|>C|NONE NONE

{AND|OR|NONE} Discrete AND|OR|NONE NONE

Explanation  After setting the current moni tor condition, sending

:MONItor:CURRent[:VALue] command can set the cur rent value.

the

 You can set the current monitor condition to “<Curr” ot “>Curr”.  The actual monitor condition is the logic c ombination of the voltage, current

and power. You need to set the logic relation between the current monitor condition and the voltage/power monitor conditions; you can set the logic relation to “AND”, “OR” or “None”; wherein, “None” indicates that no logic relation will be set.

Return Format The query returns “condition,logic relation”, for example, <C,AND.

Example :MONI:CURR:COND <C,AND /*Set the current monitor condition to “<Curr”

and the logic relation to “AND” */

:MONI:CURR:COND? /*Query the current monitor condition and the

query returns <C,AND*/

Commands

:MONItor:CURRent[:VALue] :MONItor:POWER:CONDition :MONItor:POWER[:VALue] :MONItor:VOLTage:CONDition :MONItor:VOLTage[:VALue]

DP800 Programming Guide 2-25

Page 44

RIGOL Chapter 2 Command System

:MONItor:CURRent[:VALue]

Syntax :MONItor:CURRent[:VALue] {<value>|MINimum|MAXimum}

:MONItor:CURRent[:VALue]? [MINimum|MAXimum]

Description Set the current of the monitor condition.

Query the current of the monitor condition.

Parameter

Name Type Range Default

<value> Real

0 to the maximum

current of the current

channel

0.5*rated current of the current channel

Return Format The query returns the current of the monitor condition, for example, 4.0000.

Example :MONI:CURR 4 /*Set the current of the monitor condition to 4A*/

:MONI:CURR? /*Query the current of the monitor condition and the query

returns 4.0000*/

Commands

:MONItor:CURRent:CONDition :MONItor:POWER:CONDition :MONItor:POWER[:VALue] :MONItor:VOLTage:CONDition :MONItor:VOLTage[:VALue]

:MONItor:POWER:CONDition

Syntax :MONItor:POWER:CONDition {<P|>P|NONE}

:MONItor:POWER:CONDition?

Description Set the power monitor condition of the m onitor to “<Power” or “>Power”. NONE

indicates that no power monitor condition will be set. Query the power monitor condition of the monitor.

Parameter

Name Type Range Default

{<P|>P|NONE} Discrete <P|>P|NONE NONE

Explanation  After setting the power monitor condition, sending

:MONItor:POWER[:VALue] command can set the power value.

the

 The actual monitor condition is the logic combination of the voltage, current

and power.

Return Format The query returns “condition”, for example, <P.

Example :MONI:POWER:COND <P /*Set the power monitor condition to “<Power”*/

:MONI:POWER:COND? /*Query the current power monitor condition and the

query returns <P*/

Commands

:MONItor:POWER[:VALue] :MONItor:CURRent:CONDition :MONItor:CURRent[:VALue] :MONItor:VOLTage:CONDition :MONItor:VOLTage[:VALue]

2-26 DP800 Programming Guide

Page 45

Chapter 2 Command System RIGOL

:MONItor:POWER[:VALue]

Syntax :MONItor:POWER[:VALue] {<value>|MINimum|MAXimum}

:MONItor:POWER[:VALue]? [MINimum|MAXimum]

Description Set the power of the monitor condition.

Query the power of the monitor condition.

Parameter

Name Type Range Default

<value> Real

0 to the maxim um power

of the current channel

0.25*rated power of the current channel

Return Format The query returns the power of the current monitor condition, for example, 20.000.

Example :MONI:POWER 20 /*Set the power of the monitor condition to 20W*/

:MONI:POWER? /*Query the power of the current monitor condition and the

query returns 20.000*/

Commands

:MONItor:CURRent:CONDition :MONItor:CURRent[:VALue] :MONItor:POWER:CONDition :MONItor:VOLTage:CONDition :MONItor:VOLTage[:VALue]

:MONItor[:STATe]

Syntax :MONItor[:STATe] {ON|OFF}

:MONItor[:STATe]?

Description Enable or disable the monitor.

Query the state of the monitor.

Parameter

Name Type Range Default

{ON|OFF} Bool ON|OFF OFF

Explanation When the monitor is enabled and t he channel output state meets the monitor

condition set, the instrument will turn off the output, display the corresponding prompt message or sound the beeper according to the stop mode selected.

Return Format The query returns ON or OFF.

Example :MONI ON /*Enable the monitor*/

:MONI? /*Query the state of the monitor and the query returns ON*/

DP800 Programming Guide 2-27

Page 46

RIGOL Chapter 2 Command System

:MONItor:STOPway

Syntax :MONItor:STOPway {OUTOFF|WARN|BEEPER|NONE},{ON|OFF}

:MONItor:STOPway?

Description Set the stop mode of the monitor. Multiple stop modes can be enabled at the same

time. Query the stop mode of the monitor.

Parameter

{OUTOFF|WARN|BEEPER|

Name Type Range Default

NONE}

Discrete OUTOFF|WARN|BEEPER None

{ON|OFF} Bool ON|OFF ON

Explanation When the channel output state meets the monitor condition set, the instrument will

turn off the output, display the corresponding prompt message or sound the beeper according to the stop mode selected.

Return Format The query returns the on/off status o f OUTOFF, WARN and BEEPER, for example,

OutputOff:ON,Warn:ON,Beep:ON.

Example :MONI:STOP BEEPER,OFF /*Disable the “Beeper” stop mode*/

:MONI:STOP? /*Query the current states of the stop modes of the monitor*/

/*The query returns OutputOff:ON,Warn:ON,Beep:OFF*/

2-28 DP800 Programming Guide

Page 47

Chapter 2 Command System RIGOL

:MONItor:VOLTage:CONDition

Syntax :MONItor:VOLTage:CONDition {<V|>V|NONE},{AND|OR|NONE}

:MONItor:VOLTage:CONDition?

Description Set the voltage monitor condition of the monitor.

Query the voltage monitor condition of the monitor.

Parameter

Name Type Range Default

{<V|>V|NONE} Discrete <V|>V|NONE NONE

{AND|OR|NONE} Discrete AND|OR|NONE NONE

Explanation  After setting the voltage monitor condition, se nding

:MONItor:VOLTage[:VALue] <value> command can set the voltage value.

the

 You can set the voltage monitor condition to “<Volt” ot “>Volt”.  The actual monitor condition is the logic combination of the voltage, current

and power. You need to set the logic relation between the voltage monitor condition and the current/power monitor conditions; you can set the logic relation to “AND”, “OR” or “None”; wherein, “None” indicates tha t no logic relation will be set.

Return Format The query returns “condition,logic relation”, for exampl e, <V,AND.

Example :MONI:VOLT:COND <V,AND /*Set the voltage monitor condition to “<Volt” and

logic relation to “AND”*/

:MONI:VOLT:COND? /*Query the current voltage monitor condition and

the query returns <V,AND*/

Commands

:MONItor:CURRent:CONDition :MONItor:CURRent[:VALue] :MONItor:POWER:CONDition :MONItor:POWER[:VALue] :MONItor:VOLTage[:VALue]

DP800 Programming Guide 2-29

Page 48

RIGOL Chapter 2 Command System

:MONItor:VOLTage[:VALue]

Syntax :MONItor:VOLTage[:VALue] {<value>|MINimum|MAXimum}

:MONItor:VOLTage[:VALue]? [MINimum|MAXimum]

Description Set the voltage of the monitor condition.

Query the voltage of the monitor condition.

Parameter

Name Type Range Default

<value> Real

0 to the maximum voltage

of the current channel

0.5*rated voltage of the current channel

Return Format The query returns the voltage of the current monitor condition, for example, 5.000.

Example :MONI:VOLT 5 /*Set the voltage of the monitor condition to 5V*/

:MONI:VOLT? /*Query the voltage of the current monitor condition and the

query returns 5.000*/

Commands

:MONItor:CURRent:CONDition :MONItor:CURRent[:VALue] :MONItor:POWER:CONDition :MONItor:POWER[:VALue] :MONItor:VOLTage:CONDition

2-30 DP800 Programming Guide

Page 49

Chapter 2 Command System RIGOL

:OUTPut Commands

Command List:

 :OUTPut:MODE?  :OUTPut:OCP:CLEAR  :OUTPut:OCP:QUES?  :OUTPut:OCP[:STATe]  :OUTPut:OCP:VALue  :OUTPut:OVP:CLEAR  :OUTPut:OVP:QUES?  :OUTPut:OVP[:STATe]  :OUTPut:OVP:VALue  :OUTPut[:STATe]  :OUTPut:TRACk

:OUTPut:MODE?

Syntax :OUTPut:MODE? {CH1|CH2|CH3}

Description Query the current output mode of the specified channel.

Parameter

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

Explanation The output modes of the power supply include CV (Constant Voltage), CC (Constant

Current) and UR. In CV mode, the output voltage equals the voltage setting value and the output curr ent is determined by the load; in CC mode, the output current equals the current s etting value and the output voltage is determined by the load; UR is the critical mode between CV and CC.

Return Format The query returns C V, CC or UR.

Example :OUTP:MODE? CH1 /*Query the output mode of CH1 and the query returns CV*/

:OUTPut:OCP:CLEAR

Syntax :OUTPut:OCP:CLEAR {CH1|CH2|CH3}

Description Clear the overcurrent protection occurred on the specified channel.

Parameter

Example :OUTP:OCP:QUES? CH1 /*Query whether overcurrent protection currently

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

occurred on CH1 and the query returns YES*/

:OUTP:OCP:CLEAR CH1 /*Clear the overcurrent protection occurred on CH1*/

:OUTP:OCP:QUES? CH1 /*The query returns NO*/

Commands

DP800 Programming Guide 2-31

:OUTPut:OCP:VALue :OUTPut:OCP:QUES?

Page 50

RIGOL Chapter 2 Command System

:OUTPut:OCP:QUES?

Syntax :OUTPut:OCP:QUES? {CH1|CH2|CH3}

Description Query whether overcurrent protection occurs to the specified channel currently,

namely the output current exceeds the overcurrent protection limit and the output turns off automatically.

Parameter

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

Explanation You can clear the overcurrent protection occurred on the specified channel using

:OUTPut:OCP:CLEAR command.

the

Return Format The query returns YES or NO.

Example :OUTP:OCP:QUES? CH1 /*Query whether overcurrent protection occurs to CH1

currently and the query returns YES*/

Commands

:OUTPut:OCP:CLEAR :OUTPut:OCP[:STATe] :OUTPut:OCP:VALue

:OUTPut:OCP[:STATe]

Syntax :OUTPut:OCP[:STATe] {CH1|CH2|CH3},{ON|OFF}

:OUTPut:OCP[:STATe]? {CH1|CH2|CH3}

Description Enable or disable the overcurrent protection functio n of the specified channel.

Query the status of the overcurrent protection function of the specifi ed channel.

Parameter

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

{ON|OFF} Bool ON|OFF OFF

Explanation When the overcurrent protection function is e nabled, the output wi ll turn off

automatically when the output current exceeds the overcurr ent protection limit currently set (

:OUTPut:OCP:VALue). You can send the :OUTPut:OCP:QUES?

command to query whether overcurrent protection occurs to the specified channel currently.

Return Format The query returns ON or OFF.

Example :OUTP:OCP CH1,ON /*Enable the overcurrent protection function of CH1*/

:OUTP:OCP? CH1 /*Query the status of the overcurrent protection function of

CH1 and the query ret urns ON*/

Commands

:OUTPut:OCP:QUES? :OUTPut:OCP:VALue

2-32 DP800 Programming Guide

Page 51

Chapter 2 Command System RIGOL

:OUTPut:OCP:VALue

Syntax :OUTPut:OCP:VALue {CH1|CH2|CH3},{<value>|MINimum|MAXimum}

:OUTPut:OCP:VALue? {CH1|CH2|CH3}[,MINimum|MAXimum]

Description Set the overcurrent protection limit of the specifi ed channel.

Query the overcurrent protection limit of the specified channel.

Parameter

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

<value> Real

Current range of the

current channel

Maximum current of

the current channel

Explanation When the overcurrent protection function is enabled, the output will turn off

automatically when the output current exceeds the overcurr ent protection limit currently set. You can send the

:OUTPut:OCP:QUES? command to query whether

overcurrent protection occurs to the specified channel currently.

Return Format The query returns the overcurrent protection limit, for example, 5.0000.

Example :OUTP:OCP:VAL CH1,5

:OUTP:OCP:VAL? CH1

Commands

:OUTPut:OCP:QUES? :OUTPut:OCP[:STATe]

:OUTPut:OVP:CLEAR

Syntax :OUTPut:OVP:CLEAR {CH1|CH2|CH3}

Description Clear the overvoltage protection occurred on the specified channel.

Parameter

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

Example :OUTP:OVP:QUES? CH1 /*Query whether overvoltage protection currently

occurred on CH1 and the query returns YES*/ :OUTP:OVP:CLEAR CH1 /*Clear the overvoltage protection occurred on CH1*/ :OUTP:OVP:QUE S? CH1 /*The query returns NO*/

Commands

:OUTPut:OVP:QUES? :OUTPut:OVP:VALue

DP800 Programming Guide 2-33

Page 52

RIGOL Chapter 2 Command System

Return Format

The query returns ON or OFF.

:OUTPut:OVP:QUES?

Syntax :OUTPut:OVP:QUES? {CH1|CH2|CH3}

Description Query whether overvoltage protection occurs to the specified channel, namely the

output voltage exceeds the overvoltage protection limit and the output turns off automatically.

Parameter

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

Explanation You can clear the overvoltage protection occurred on the specified channel using

:OUTPut:OVP:CLEAR command.

the

Return Format The query returns YES or NO.

Example :OUTP:OVP:QUES? CH1

Command

:OUTPut:OVP:CLEAR

:OUTPut:OVP[:STATe]

Syntax :OUTPut:OVP[:STATe] {CH1|CH2|CH3},{ON|OFF}

:OUTPut:OVP[:STATe]? {CH1|CH2|CH3}

Description Enable or disable the overvoltage protection function of the specified channel.

Query the status of the overvoltage protect ion function of the specified channel.

Parameter

Explanation When the overvoltage protection functio n i s enabled, the output will turn off

automatically when the output voltage exceeds the overvoltage protection limit currently set ( command to query whether overvoltage protection occurs to the specified channel currently.

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

{ON|OFF} Bool ON|OFF OFF

:OUTPut:OVP:VALue). You can send the :OUTPut:OVP:QUES?

Example :OUTP:OVP CH1,ON /*Enable the overvoltage protection function of CH1*/

Commands

2-34 DP800 Programming Guide

:OUTP:OVP? CH1 /*Query the status of the overvoltage protection function

of CH1 and the query returns ON*/

:OUTPut:OVP:QUES? :OUTPut:OVP:VALue

Page 53

Chapter 2 Command System RIGOL

{ON|OFF}

Bool

ON|OFF

OFF

:OUTPut:OVP:VALue

Syntax :OUTPut:OVP:VALue {CH1|CH2|CH3},{<value>|MINimum|MAXimum}

:OUTPut:OVP:VALue? {CH1|CH2|CH3}[,MINimum|MAXimum]

Description Set the overvoltage protection limit of the specified cha nnel.

Query the overvoltage protection limit of the specified channel.

Parameter

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

<value> Real

Voltage range of the

current channel

Maximum voltage of

the current channel

Explanation When the overvoltage protection functio n i s enabled, the output will turn off

automatically when the output voltage exceeds the overvoltage protection limit currently set. You can send the

:OUTPut:OVP:QUES? command to query whether

overvoltage protection occurs to the specified channel currently.

Return Format The query returns the overvoltage protection limit, for example, 8.800.

Example :OUTP:OVP:VAL CH1,8.8 /*Set the overvoltage protection limit of CH1 to 8.8V*/

:OUTP:OVP:VAL? CH1 /*Query the overvoltage protection limit of CH1 and the

query returns 8.800*/

Commands

:OUTPut:OVP[:STATe] :OUTPut:OVP:QUES?

:OUTPut[:STATe]

Syntax :OUTPut[:STATe] [{CH1|CH2|CH3},]{ON|OFF}

:OUTPut[:STATe] ? [{CH1|CH2|CH3}]

Description Enable or disable the output of the specified channel.

Query the output status of the specified channel.

Parameter

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

Explanation Make sure that the current setting will not affect the device connected to the power

supply before enabling the channel output.

Return Format The query returns ON or OFF.

Example :OUTP CH1,ON /*Enable the output of CH1*/

:OUTP? CH1 /*Query the current output status of CH1 and the query returns

ON*/

DP800 Programming Guide 2-35

Page 54

RIGOL Chapter 2 Command System

:OUTPut:TRACk

Syntax :OUTPut:TRACk {CH1|CH2|CH3},{ON|OFF}

:OUTPut:TRACk? [{CH1|CH2|CH3}]

Description Enable or disable the track function of the specified channel.

Query the status of the track function of the specified channel.

Parameter

Name Type Range Default

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 None

{ON|OFF} Bool ON|OFF OFF

Explanation  This command is only applicable to channels supporting the track function:

CH2 and CH3 of DP831A as well as CH1 and CH2 of DP832A/DP832. For channels that do not support the track function, the query returns NONE.

 For two channels supporting the track function, when the track function of one

channel (the tracked channel) is enabled, the vo ltage setting v alue of the other channel (the tracking channel, the track status label (for example,

) is displayed in the display area corresponding to this channel and the voltage value can not be set) will change accordingly when the voltage setting val ue of this channel is change d.

 By default, the track function is disabled and it is usually used to provide

symmetric voltage for the calculation amplifier or other circuits.

 The track function only tracks the voltage setting value and the actual output

voltage will not be affected.

Return Format The query returns ON or OFF. For channels that do not support the track function,

the query returns NONE.

Example :OUTP:TRAC CH1,ON

:OUTP:TRAC? CH1

2-36 DP800 Programming Guide

Page 55

Chapter 2 Command System RIGOL

:PRESet Commands

Command List:

 :PRESet[:APPLy]  :PRESet:KEY  :PRESet:USER[n]:SET:CURRent  :PRESet:USER[n]:SET:DEFault  :PRESet:USER[n]:SET:TRACk  :PRESet:USER[n]:SET:OCP  :PRESet:USER[n]:SET:OVP  :PRESet:USER[n]:SET:OTP  :PRESet:USER[n]:SET:SURE  :PRESet:USER[n]:SET:VOLTage

Note: When [n] is omitted, the operation is performed on the user-preset state currently selected by default.

:PRESet[:APPLy]

Syntax :PRESet[:APPLy]

Description Restore the instrument to default value or user-preset value.

Explanation

Command

Sending this command is equivalent to pressing Preset at the front panel, namely recalling the default value or user-preset value related to the key (depend on

:PRESet:KEY command).

the

:PRESet:KEY

DP800 Programming Guide 2-37

Page 56

RIGOL Chapter 2 Command System

:PRESet:KEY

Syntax :PRESet:KEY {DEFAULT|USER1|USER2|USER3|USER4}

:PRESet:KEY?

Description

Define the setting recalled by Preset at the front panel. Query the setting recalled by Preset at the front panel.

Parameter

{DEFAULT|USER1|USER2| USER3|USER4}

Name Type Range Default

Discrete

DEFAULT|USER1|USER2| USER3|USER4

Explanation  DP800 supports to restore the instrument to default state or user-preset state

(up to 4 kinds).

 After sending this command to set the instrument, sending the

:PRESet[:APPLy]

command or pressing Preset at the front panel can restore the inst rument to the default value or user-preset value.

 When user-preset state is selected, you can use the :PRESet:USER:SET series

commands to set the parameters of the user-preset state currently selected.

Return Format The query returns DEFAULT, USER1, USER2, USER3 or USER4.

Example :PRES:KEY USER1

:PRES:KEY?

Command

:PRESet Commands

DEFAULT

2-38 DP800 Programming Guide

Page 57

Chapter 2 Command System RIGOL

:PRESet:USER[n]:SET:CURRent

Syntax :PRESet:USER[n]:SET:CURRent {<current>|MINimum|MAXimum}

:PRESet:USER[n]:SET:CURRent? [MINimum|MAXimum]

Description Set the current of the specified user-preset state.

Query the current of the specified user-preset state.

Parameter

Name Type Range Default

[n] Discrete 1|2|3|4 None

<current> Real Current range of the current channel

Refer to the

“Explanation”

Explanation  By default, this command sets the parameter of the channel currently selected.

If you want to set the parameter of other channel, please use

:INSTrument[:SELEct] command to select the desired channel.

the

 The current default values of each us er-preset state are as shown in the table

below. DP831A DP832A/DP832 CH1 CH2 CH3 CH1 CH2 CH3 USER1 0.5000A 1.0000A 1.0000A 1.0000A 1.0000A 1.0000A USER2 1.0000A 1.0000A 1.0000A 1.0000A 1.0000A 1.0000A USER3 1.0000A 1.5000A 1.5000A 2.0000A 2.0000A 1.0000A USER4 1.0000A 2.0000A 2.0000A 3.0000A 3.0000A 2.0000A

Return Format The query returns the current, for example, 1.5000.

Example :PRES:USER1:SET:CURR 1.5

:PRES:USER1:SET:CURR?

:PRESet:USER[n]:SET:DEFault

Syntax :PRESet:USER[n]:SET:DEFault

Description Restore the parameters of the specified user-preset state to default values.

Parameter

Name Type Range Default

[n] Discrete 1|2|3|4 None

Explanation For the default values of the user-preset states, refer to the “Explanation” of

:PRESet:USER[n]:SET:CURRent and :PRESet:USER[n]:SET:VOLTage

the commands.

Commands

:PRESet:USER[n]:SET:CURRent :PRESet:USER[n]:SET:VOLTage

DP800 Programming Guide 2-39

Page 58

RIGOL Chapter 2 Command System

:PRESet:USER[n]:SET:TRACk

Syntax :PRESet:USER[n]:SET:TRACk {ON|OFF}

:PRESet:USER[n]:SET:TRACk?

Description Enable or disable the track function of the specifie d user-preset state.

Query the status of the track function of the specified user-preset state.

Parameter

Name Type Range Default

[n] Discrete 1|2|3|4 None

{ON|OFF} Bool ON|OFF OFF

Explanation  By default, this command sets the par ameter of the chan nel curren tly selected.

If you want to set the parameter of other channel, please use

:INSTrument[:SELEct] command to select the desired channel.

the

 This command is only applicable to channels suppo rting the track function:

CH2 and CH3 of DP831A as well as CH1 and CH2 of DP832A/DP832. For channels that do not support the track function, the query returns NONE.

Return Format The query returns ON or OFF. For channels that do not support the track function,

the query returns NONE.

Example :PRES:USER1:SET:TRAC ON

:PRES:USER1:SET:TRAC?

:PRESet:USER[n]:SET:OCP

Syntax :PRESet:USER[n]:SET:OCP {ON|OFF}[,<current>|MINimum|MAXimum]

:PRESet:USER[n]:SET:OCP? [MINimum|MAXimum]

Description Enable or disable the overcurrent protection function of the specified user-preset

state and set the overcurrent protection limit. Query the status and limit of the overcurrent protection function of the specified

user-preset state.

Parameter

Name Type Range Default

[n] Discrete 1|2|3|4 None

{ON|OFF} Bool ON|OFF OFF

<current> Real

Current range of the

current channel

Maximum current of the

current channel

Explanation By default, this command sets the parameter of the channel currently selected. If

you want to set the parameter of other channel, please use

:INSTrument[:SELEct] command to select the desired channel.

the

Return Format The query returns OFF or ON,limit of overcurrent protection, for exam ple,

ON,1.5000.

Example :PRES:USER1:SET:OCP ON,1.5

:PRES:USER1:SET:OCP?

2-40 DP800 Programming Guide

Page 59

Chapter 2 Command System RIGOL

:PRESet:USER[n]:SET:OVP

Syntax :PRESet:USER[n]:SET:OVP {ON|OFF}[,<voltage>|MINimum|MAXimum]

:PRESet:USER[n]:SET:OVP? [MINimum|MAXimum]

Description Enable or disable the overvoltage protection function of the specified user-preset

state and set the overvoltage protection limit. Query the status and limit of the overvoltage protection function of the specified

user-preset state.

Parameter

Name Type Range Default

[n] Discrete 1|2|3|4 None

{ON|OFF} Bool ON|OFF OFF

<voltage> Real

Voltage range of the

current channel

Maximum voltage of the

current channel

Explanation By default, this command sets the parameter of the channel currently selected. If

you want to set the parameter of other channel, please use

:INSTrument[:SELEct] command to select the desired channel.

the

Return Format The query returns OFF or ON,limit of overvoltage protection,for example, ON,8.800.

Example :PRES:USER1:SET:OVP ON,8.8

:PRES:USER1:SET:OVP?

:PRESet:USER[n]:SET:OTP

Syntax :PRESet:USER[n]:SET:OTP {ON|OFF}

:PRESet:USER[n]:SET:OTP?

Description Enable or disable the over-temperature protection function of the specified

user-preset state. Query the status of the over-temperature protection function of the specified

user-preset state.

Parameter

Name Type Range Default

[n] Discrete 1|2|3|4 None

{ON|OFF} Bool ON|OFF ON

Return Format The query returns ON or OFF.

Example :PRES:USER1:SET:OTP ON

:PRES:USER1:SET:OTP?

DP800 Programming Guide 2-41

Page 60

RIGOL Chapter 2 Command System

[n]

Discrete

1|2|3|4

None

:PRESet:USER[n]:SET:SURE

Syntax :PRESet:USER[n]:SET:SURE

Description Confirm the setting of the specified user-preset state.

Parameter

Name Type Range Default

:PRESet:USER[n]:SET:VOLTage

Syntax :PRESet:USER[n]:SET:VOLTage <voltage>|MINimum|MAXimum}

:PRESet:USER[n]:SET:VOLTage? [MINimum|MAXimum]

Description Set the voltage of the specified user-preset state.

Query the voltage of the specified user-preset state.

Parameter

Explanation  By default, this command sets the parameter of th e c h ann el c u rren tly s elec ted.

Name Type Range Default

[n] Discrete 1|2|3|4 None

<voltage> Real

Voltage range of the

current channel

Refer to the

“Explanation”

If you want to set the parameter of other channel, please use

:INSTrument[:SELEct] command to select the desired channel.

the

 The voltage default values of each user-preset state are as shown in the tab le

below. DP831A DP832A/DP832 CH1 CH2 CH3 CH1 CH2 CH3 USER1 1.500V 3.300V -5.000V 3.300V 3.300V 1.500V USER2 3.300V 4.200V -4.200V 4.200V 4.200V 4.200V USER3 3.300V 5.000V -8.000V 5.000V 8.000V 3.300V USER4 5.000V 12.000V -12.000V 12.000V 24.000V 5.000V

Return Format The query returns the voltage, for example, 5.000.

Example :PRES:USER1:SET:VOLT 5

:PRES:USER1:SET:VOLT?

2-42 DP800 Programming Guide

Page 61

Chapter 2 Command System RIGOL

:RECorder Commands

Command List:

 :RECorder:DESTination?  :RECorder:MEMory  :RECorder:MMEMory  :RECorder:PERIod  :RECorder[:STATe]

:RECorder:DESTination?

Syntax :RECorder:DESTination?

Description Query the storage directory of the record file.

Explanation  Before enabling the recorder, use the

:RECorder:MMEMory command to set the storage directory.

 After the recording is finished , the instrument stores the record file to the

storage directory using the specified filename.

Return Format The query returns the current storage directory, for example, C:\REC

10:RIGOL.ROF.

Commands

:RECorder:MEMory :RECorder:MMEMory :RECorder[:STATe]

:RECorder:MEMory

Syntax :RECorder:MEMory {1|2|3|4|5|6|7|8|9|10},<filename>

Description Set the storage directory of the record file to a storage location of the internal

memory.

Parameter

Explanation  You can use the :RECorder:MMEMory command to set the stor age dir ecto ry of

Name Type Range Default

{1|2|3|4|5|6|7|

8|9|10}

the record file to a directory of the external memory.

Discrete 1|2|3|4|5|6|7|8|9|10 10

<name>.ROF; wherein,

ASCII

character

string

<name> can be Chinese

characters, En glish ch arac ters

or numbers with up to 9

characters

RIGOL.ROF

 Using the

directory.

Example :REC:MEM 5,test1

Commands

DP800 Programming Guide 2-43

:RECorder:DESTination? :RECorder:MMEMory :RECorder[:STATe]

:RECorder:DESTination? command can query the current storage

Page 62

RIGOL Chapter 2 Command System

<dest>

ASCII character string

Directory of the exter nal memory

None

:RECorder:MMEMory

Syntax :RECorder:MMEMory <dest>

Description Set the storage directory of the record file to a directory of the external memory.

Parameter

Name Type Range Default

Explanation  This command is only available when an USB storage device is connected to the

power supply.

 You can use the

:RECorder:MEMory command to set the storage directory of the

record file t o a storage location of the internal memory.

 Using the

:RECorder:DESTination? command can query the current storage

directory.

Example :RECorder:MMEMory D:\ra.ROF

Commands

:RECorder:DESTination? :RECorder:MEMory :RECorder[:STATe]

:RECorder:PERIod

Syntax :RECorder:PERIod <value>

:RECorder:PERIod?

Description Set the record period, namely the time interval at which the instrument samples and

records the output of each channel when the recorder is enabled. Query the record period.

Parameter

Name Type Range Default

<value> Integer 1s to 99999s 1s

Explanation The query returns an integer from 1 to 99999.

Example :REC:PERI 5 /*Set the record period to 5s*/

:REC:PERI? /*Query the record period and the query returns 5*/

:RECorder[:STATe]

Command

2-44 DP800 Programming Guide

Page 63

Chapter 2 Command System RIGOL

:RECorder[:STATe]

Syntax :RECorder[:STATe] {ON|OFF}

:RECorder[:STATe]?

Description Enable or disable the recorder.

Query the status of the recorder.

Parameter

Name Type Range Default

{ON|OFF} Bool ON|OFF OFF

Explanation  When the recorder is enabled, you cannot set the record period and storage

directory. The instrument samples and records the output of each channel at the time interval equaling the current record period.

 During the recording, make sure that the output of each channel is enabled.

For the channel of which t he output is disabled, the corresponding recorded data will be 0.

 When the recorder is disabled, the recordin g finishes and the instrument stores

the record file to the storage directory currently set.

Return Format The query returns ON or OFF.

Example :REC ON /*Enable the recorder*/

:REC? /*Query the current status of the recorder and the query returns ON*/

Commands

:RECorder:DESTination? :RECorder:MEMory :RECorder:MMEMory :RECorder:PERIod

DP800 Programming Guide 2-45

Page 64

RIGOL Chapter 2 Command System

:SOURce Commands

The :SOURce commands are used to set the voltage, cu rrent, OVP and OCP of the specified channel. Their functions are equivalent to that of straightforward method to program the power supply over the remote interfaces, the :SOURce commands give you more flexibility to change individual parameters.

Command List:

 [:SOURce[n]]:CURRent[:LEVel][:IMMediate][:AMPLitude]  [:SOURce[n]]:CURRent:PROTection[:LEVel]  [:SOURce[n]]:CURRent:PROTection:STATe  [:SOURce[n]]:VOLTage[:LEVel][:IMMediate][:AMPLitude]  [:SOURce[n]]:VOLTage:PROTection[:LEVel]  [:SOURce[n]]:VOLTage:PROTection:STATe

Note: When [:SOURce[n]] or [n] is omitted, the parameter of the channel cu rrently sel ected will be s et by default.

[:SOURce[n]]:CURRent[:LEVel][:IMMediate][:AMPLitude]

:APPLy Command. Although the :APPLy command provides the most

Syntax [:SOURce[n]]:CURRent[:LEVel][:IMMediate][:AMPLitude]

{<current>|MINimum|MAXimum} [:SOURce[n]]:CURRent[:LEVel][:IMMediate][:AMPLitude]?

[{MINimum|MAXimum}]

Description Set the current of the specified channel.

Query the current of the specified channe l.

Parameter

Name Type Range Default

[n] Integer 1|2|3 1

<current> Real Refer to the “Explanation” of :APPLy Command

Explanation When [:SOURce[n]] is omitted, the command sets the parameter of the channel

currently select ed by default.

Return Format The query returns the current of the specified channel, for example, 1.5000.

Example :CURR 1.5

:CURR?

:APPLy Command

Command

2-46 DP800 Programming Guide

Page 65

Chapter 2 Command System RIGOL

[:SOURce[n]]:CURRent:PROTection[:LEVel]

Syntax [:SOURce[n]]:CURRent:PROTection[:LEVel] {<current>|MINimum|MAXimum}

[:SOURce[n]]:C URRent:PROTection[:LEVel]? [{MINimum|MAXimum}]

Description Set the overcurrent protection limit of the specifi ed channel.

Query the overcurrent protection limit of the specified channel.

Parameter

Name Type Range Default

[n] Integer 1|2|3 1

<current> Real

Current range of the

current channel

Maximum current of the

current channel

Explanation  When the overcurrent protection function is enabled, the output turns off

automatically when the output current exceeds the overcurrent protection limit currently set. You can send the

:OUTPut:OCP:QUES? command to query

whether overcurrent pr otection occurs to the specified channel currently.

 The function of this command is equivalent to that of the

:OUTPut:OCP:VALue

command.

 When [:SOURce[n]] is omitted, the command sets the parameter of the

channel currently selected by default.

Return Format The query returns the overcurrent protection limit, for example, 5.0000.

Example :CURR:PROT 5

:CURR:PROT?

Commands

:OUTPut:OCP:QUES? :OUTPut:OCP[:STATe] :OUTPut:OCP:VALue

DP800 Programming Guide 2-47

Page 66

RIGOL Chapter 2 Command System

[:SOURce[n]]:CURRent:PROTection:STATe

Syntax [:SOURce[n]]:CURRent:PROTection:STATe {ON|OFF}

[:SOURce[n]]:CURRent:PROTection:STATe?

Description Enable or disable the overcurrent protection function of the specified channel.

Query the status of the overcurrent protection function of the specifi ed channel.

Parameter

Name Type Range Default

[n] Integer 1|2|3 1

{ON|OFF} Bool ON|OFF OFF

Explanation  When the overcurrent protection function is enable d, the output turns off

automatically when the output current exceeds the overcurrent protection limit currently set. You can send the

:OUTPut:OCP:QUES? command to query

whether overcurrent protection occurs to the specified channel.

 The function of this command is equivalent to that of

:OUTPut:OCP[:STATe] command.

the

 When [:SOURce[n]] is omitted, the command sets the parameter of the

channel currently selected by default.

Return Format The query returns ON or OFF.

Example :CURR:PROT:STAT ON

:CURR:PROT:STAT?

Commands

:OUTPut:OCP:QUES? :OUTPut:OCP[:STATe] :OUTPut:OCP:VALue

[:SOURce[n]]:VOLTage[:LEVel][:IMMediate][:AMPLitude]

Syntax [:SOURce[n]]:VOLTage[:LEVel][:IMMediate][:AMPLitude]

{<voltage>|MINimum|MAXimum} [:SOURce[n]]:VOLTage[:LEVel][:IMMediate][:AMPLitude]?

[{MINimum|MAXimum}]

Description Set the voltage of the specified channel.

Query the voltage of the specified channel.

Parameter

Name Type Range Default

[n] Integer 1|2|3 1

<voltage> Real Refer to the “Explanation” of :APPLy Command

Explanation When [:SOURce[n]] is omitted, the command sets the parameter of the channel

currently selected by default.

Return Format The query returns the voltage of the specified channel, for example, 8.500.

Example :VOLT 8.5

:VOLT?

:APPLy Command

Command

2-48 DP800 Programming Guide

Page 67

Chapter 2 Command System RIGOL

[:SOURce[n]]:VOLTage:PROTection[:LEVel]

Syntax [:SOURce[n]]:VOLTage:PROTection[:LEVel] {<voltage>|MINimum|MAXimum}

[:SOURce[n]]:VOLTage:PROTection[:LEVel]? [{MINimum|MAXimum}]

Description Set the overvoltage protection limit of the specified channel.

Query the overvoltage protection limit of the specified channel.

Parameter

Name Type Range Default

[n] Integer 1|2|3 1

<voltage> Real

Voltage range of the

current channel

Maximum voltage of the

current channel

Explanation  When the overvoltage protection function is enabled , the output turns off

automatically when the output voltage exceeds the overvoltage protection limit currently set. You can send the

:OUTPut:OVP:QUES? command to query

whether overvoltage protection occurs to the specified channel currently.

 The function of this command is equivalent to that of the

:OUTPut:OVP:VALue

command.

 When [:SOURce[n]] is omitted, the command sets the parameter of the

channel currently selected by default.

Return Format The query returns the overvoltage protection limit, for example, 8.800.

Example :VOLT:PROT 8.8

:VOLT:PROT?

Commands

:OUTPut:OVP:QUES? :OUTPut:OVP[:STATe] :OUTPut:OVP:VALue

DP800 Programming Guide 2-49

Page 68

RIGOL Chapter 2 Command System

[:SOURce[n]]:VOLTage:PROTection:STATe

Syntax [:SOURce[n]]:VOLTage:PROTection:STATe {ON|OFF}

[:SOURce[n]]:VOLTage:PROTection:STATe?

Description Enable or disable the overvoltage protection function of the specified channel.

Query the status of the overvoltage protection function of the specified channel.

Parameter

Name Type Range Default

[n] Integer 1|2|3 1

{ON|OFF} Bool ON|OFF OFF

Explanation  When the overvoltage protection function is enabled , the output turns off

automatically when the output voltage exceeds the overvo ltage protection limit currently set. You can send the

:OUTPut:OVP:QUES? command to query

whether overvoltage protection occurs to the specified channel currently.

 The function of this command is equivalent to that of

:OUTPut:OVP[:STATe] command.

the

 When [:SOURce[n]] is omitted, the command sets the parameter of the

channel currently selected by default.

Return Format The query returns ON or OFF.

Example :VOLT:PROT:STAT ON

:VOLT:PROT:STAT?

Commands

:OUTPut:OVP:QUES? :OUTPut:OVP[:STATe] :OUTPut:OVP:VALue

2-50 DP800 Programming Guide

Page 69

Chapter 2 Command System RIGOL

:SYSTem Commands

Command List:

 :SYSTem:BEEPer[:IMMediate]  :SYSTem:BEEPer:STATe  :SYSTem:BRIGhtness  :SYSTem:COMMunicate:GPIB:ADDRess  :SYSTem:COMMunicate:LAN:APPLy  :SYSTem:COMMunicate:LAN:AUTOip[:STATe]  :SYSTem:COMMunicate:LAN:DHCP[:STATe]  :SYSTem:COMMunicate:LAN:DNS  :SYSTem:COMMunicate:LAN:GATEway  :SYSTem:COMMunicate:LAN:IPADdress  :SYSTem:COMMunicate:LAN:MAC?  :SYSTem:COMMunicate:LAN:MANualip[:STATe]  :SYSTem:COMMunicate:LAN:SMASK  :SYSTem:COMMunicate:RS232:BAUD  :SYSTem:COMMunicate:RS232:DATABit  :SYSTem:COMMunicate:RS232:FLOWCrl  :SYSTem:COMMunicate:RS232:PARItybit  :SYSTem:COMMunicate:RS232:STOPBit  :SYSTem:CONTrast  :SYSTem:ERRor?  :SYSTem:LANGuage:TYPE  :SYSTem:LOCal  :SYSTem:LOCK  :SYSTem:OTP  :SYSTem:POWEron  :SYSTem:RGBBrightness  :SYSTem:SAVer  :SYSTem:SELF:TEST:BOARD?  :SYSTem:SELF:TEST:FAN?  :SYSTem:SELF:TEST:TEMP?

DP800 Programming Guide 2-51

Page 70

RIGOL Chapter 2 Command System

:SYSTem:BEEPer[:IMMediate]

Syntax :SYSTem:BEEPer[:IMMediate]

Description Send this command and the beeper sounds.

Example :SYST:BEEP

:SYSTem:BEEPer:STATe

Syntax :SYSTem:BEEPer:STATe {ON|OFF}

:SYSTem:BEEPer:STATe?

Description Enable or disable the beeper.

Query the status of the beeper.

Parameter

Name Type Range Default

{ON|OFF} Bool ON|OFF ON

Explanation When the beeper is enabled, the instrument generates prompt sound during front

panel operation or when error occurs during remote operation.

Return Format The query returns ON or OFF.

Example :SYST:BEEP:STAT ON

:SYST:BEEP:STAT?

:SYSTem:BRIGhtness

Syntax :SYSTem:BRIGhtness {<brightness>|MINimum|MAXimum}

:SYSTem:BRIGhtness? [{MINimum|MAXimum}]

Description Set the brightness o f the screen.

Query the brightness of the screen.

Parameter

Return Format The query returns an integer, for example, 60.

Name Type Range Default

<brightness> Integer 1 to 100 50 (factory setting)

Example :SYST:BRIG 60

:SYST:BRIG?

2-52 DP800 Programming Guide

Page 71

Chapter 2 Command System RIGOL

:SYSTem:COMMunicate:GPIB:ADDRess

Syntax :SYSTe m :COMMunicate:GPIB:ADDRess <gpibaddress>

:SYSTem:COMMunicate:GPIB:ADDRess?

Description Set the GPIB address.

Query the current GPIB address.

Parameter

Name Type Range Default

<gpibaddress> Integer 0 to 30 2

Explanation Before using the GPIB interface, extend a GPIB interface using the USB-GPIB

interface converter; then, connect the instrument and PC using GPIB cable and set the GPIB address.

Return Format The query returns an integer, for example, 7.

Example :SYST:COMM:GPIB:ADDR 7

:SYST:COMM:GPIB:ADDR?

:SYSTem:COMMunicate:LAN:APPLy

Syntax :SYSTem:COMMunicate:LAN:APPLy

Description Apply the network parameters currently set.

:SYSTem:COMMunicate:LAN:AUTOip[:STATe]

Syntax :SYSTem:COMMunicate:LAN:AUTOip[:STATe] {ON|OFF}

:SYSTem:COMMunicate:LAN:AUTOip[:STATe]?

Description Enable or disable the auto IP configuration mode.

Query the status of the auto IP configuration mode.

Parameter

Name Type Range Default

{ON|OFF} Bool ON|OFF ON

Explanation  In auto IP configuration mode, the instrument acquires the IP address from

169.254.0.1 to 169.254.255.254 and subnet mask 255.255.0.0 according to the current networ k configuration automatically.

 When all the three configuration modes are set to “On”, the priority order of

parameter configuration is “DHCP”, “AutoIP” and “ManualIP”.



The three IP configuration modes cannot all be set to “Off” at the same time.

Return Format The query returns ON or OFF.

Example :SYST:COMM:LAN:AUTO ON

:SYST:COMM:LAN:AUTO?

Commands

:SYSTem:COMMunicate:LAN:DHCP[:STATe] :SYSTem:COMMunicate:LAN:MANualip[:STATe]

DP800 Programming Guide 2-53

Page 72

RIGOL Chapter 2 Command System

:SYSTem:COMMunicate:LAN:DHCP[:STATe]

Syntax

Description Enable or disable the DHCP mode.

:SYSTem:COMMunicate:LAN:DHCP[:STATe] {ON|OFF} :SYSTem:COMMunicate:LAN:DHCP[:STATe]?

Query the status of the DHCP mode.

Parameter

Name Type Range Default

{ON|OFF} Bool ON|OFF ON

Explanation  In DHCP mode, the DHCP server in the current network assigns network

parameters (such as the IP address) for the instrument.

 When all the three configuration modes are set to “On”, the priority order of

parameter configuration is “DHCP”, “AutoIP” and “ManualIP”.



The three IP configuration modes cannot all be set to “Off” at the same time.

Return Format The query returns ON or OFF.

Example

:SYST:COMM:LAN:D HCP ON :SYST:COMM:LAN:DHCP?

Commands

:SYSTem:COMMunicate:LAN:AUTOip[:STATe] :SYSTem:COMMunicate:LAN:MANualip[:STATe]

:SYSTem:COMMunicate:LAN:DNS

Syntax :SYSTem:COMMunicate:LAN:DNS <dns>

:SYSTem:COMMunicate:LAN:DNS?

Description Set the DNS (Domain Name Service).

Query the current DNS.

Parameter

Name Type Range Default

The format is nnn.nnn.nnn.nnn;

<dns>

ASCII character

string

the first nnn ranges from 1 to 223

(except 127), the other three range

from 0 to 255

Explanation  This command is only available when the manual IP configuration mode is

enabled.

 You are recommended to ask your network administrator for an address

available.

Return Format The query returns the DNS address, for example, 172.16.3.2.

Example :SYST:COMM:LAN:DNS 172.16.3.2

:SYST:COMM:LAN:DNS?

:SYSTem:COMMunicate:LAN:MANualip[:STATe]

Command

None

2-54 DP800 Programming Guide

Page 73

Chapter 2 Command System RIGOL

Return Format

The query returns the IP address, for example, 172.16.3.128.

:SYSTem:COMMunicate:LAN:GATEway

Syntax :SYSTem:COMMunicate:LAN:GATEway <gateway>

:SYSTem:COMMunicate:LAN:GATEway?

Description Set the default gateway.

Query the current default gateway.

Parameter

Name Type Range Default

The format is nnn.nnn.nnn.nnn;

ASCII character

string

the first nnn ranges from 1 to 223

(except 127), the other three range

from 0 to 255

Explanation  This command is only available when the manual IP confi guration mode is

enabled.

 You are recommended to ask your network administrator for a gateway

address available.

Return Format The query returns the default gateway, for example, 172.16.3.1.

Example :SYST:COMM:LAN:GATE 172.16.3.1

:SYST:COMM:LAN:GATE?

:SYSTem:COMMunicate:LAN:MANualip[:STATe]

Command

:SYSTem:COMMunicate:LAN:IPADdress

Syntax :SYSTem:COMMunicate:LAN:IPADdress <ip>

:SYSTem:COMMunicate:LAN:IPADdress?

None

Description Set the IP address.

Query the current IP address.

Parameter

Name Type Range Default

The format is nnn.nnn.nnn.nnn;

<ip>

ASCII character

string

the first nnn ranges from 1 to 223

(except 127), the other three range

from 0 to 255

Explanation  This command is only available when the manual IP configuration mode is

enabled.

 You are recommended to ask your network administrator for an address

available.

Example :SYST:COMM:LAN:IPAD 172.16.3.128

:SYST:COMM:LAN:IPAD?

:SYSTem:COMMunicate:LAN:MANualip[:STATe]

Command

None

DP800 Programming Guide 2-55

Page 74

RIGOL Chapter 2 Command System

:SYSTem:COMMunicate:LAN:MAC?

Syntax :SYSTem:COMMunicate:LAN:MAC?

Description Query the MAC address.

Explanation The MAC (Media Access Control) address is also called hardware address and is

used to define the location of the network device. For a power supply, the MAC address is unique and is usually used to recognize the instrument when assigning IP address for the instrument. The MAC address (48 bits, namely 6 bytes) is usually expressed in hexadecimal form, for example, 00-2A-A0-AA-E0-56.

Return Format The query returns the MAC address, for example, 00-2A-A0-AA-E0-56.

:SYSTem:COMMunicate:LAN:MANualip[:STATe]

Syntax :SYSTem:COMMunicate:LAN:MANualip[:STATe] {ON|OFF}

:SYSTem:COMMunicate:LAN:MANualip[:STATe]?

Description Enable or disable the manual IP configuration mode.

Query the status of the manual IP configuration mode.

Parameter

Name Type Range Default

{ON|OFF} Bool ON|OFF ON

Explanation  In manual IP configuration mode, us ers define the network parameters (such as

the IP address).

 When all the three configuration modes are set to “On”, the priority order of

parameter configuration is “DHCP”, “AutoIP” and “ManualIP”.



The three IP configuration modes cannot all be set to “Off” at the same time.

Return Format The query returns ON or OFF.

Commands

:SYSTem:COMMunicate:LAN:AUTOip[:STATe] :SYSTem:COMMunicate:LAN:DHCP[:STATe]

2-56 DP800 Programming Guide

Page 75

Chapter 2 Command System RIGOL

:SYSTem:COMMunicate:LAN:SMASK

Syntax :SYSTem:COMMunica te :LAN:SMASK <subma s k>

:SYSTem:COMMunicate:LAN:SMASK?

Description Set the subnet mask.

Query the current subnet mask.

Parameter

Name Type Range Default

The format is

nnn.nnn.nnn.nnn;

wherein, the range of

nnn is from 0 to 255

ASCII

character

string

Explanation  This command is only available when the manual IP configuration mode is

enabled.

 You are recommended to ask your network administrator for a subnet mask

available.

Return Format The query returns the subnet mask, for example, 255.255.255.0.

Example :SYST:COMM:LAN:SMASK 255.255.255.0

:SYST:COMM:LAN:SMASK?

:SYSTem:COMMunicate:LAN:MANualip[:STATe]

Command

:SYSTem:COMMunicate:RS232:BAUD

Syntax :SYSTem:COMMunicate:RS232:BAUD

{4800|7200|9600|14400|19200|38400|57600|115200|128000} :SYSTem:COMMunicate:RS232:BAUD?

None

Description Set the baud rate of the RS232 interface and the uni t is Baud.

Query the baud rate of the RS232 interface.

Parameter

{4800|7200|9600|14400|

19200|38400|57600|

Name Type Range Default

4800|7200|9600|14400|

Discrete

115200|128000}

19200|38400|57600|

115200|128000

Return Format The query returns the current baud rate, for example, 19200.

Example :SYST:COMM:RS232 :BA U D 19200

:SYST:COMM:RS232:BAUD?

9600

DP800 Programming Guide 2-57

Page 76

RIGOL Chapter 2 Command System

:SYSTem:COMMunicate:RS232:DATABit

Syntax :SYSTem:COMMunicate:RS232:DATABit {5|6|7|8}

:SYSTem:COMMunicate:RS232:DATABit?

Description Set the data bit of the RS232 interface.

Query the data bit of the RS232 interface.

Parameter

Name Type Range Default

{5|6|7|8} Discrete 5|6|7|8 8

Return Format The query returns 5, 6, 7 or 8.

Example :SYST:COMM:RS232:DATAB 8

:SYST:COMM:RS232:DATAB?

:SYSTem:COMMunicate:RS232:FLOWCrl

Syntax :SYSTem:COMMunicate:RS232:FLOWCrl {ON|OFF}

:SYSTem:COMMunicate:RS232:FLOWCrl?

Description Enable or disable the hardware flow control.

Query the status of the hardware flow control.

Parameter

Explanation This power suppl y uses RTS/CTS hardware flow control mode. The instrument

monitors the status of the CTS pin. When the status is “True”, the instrument sends data; when the status is “False”, the instrument stops sending data. The instrument sets the CTS pin to “False” when the input buffer area is almost full and sets the CTS pin to “True” when the input buffer area is available again.

Name Type Range Default

{ON|OFF} Bool ON|OFF OFF

Return Format The query returns ON or OFF.

Example :SYST:COMM:RS232:FLOWC ON

:SYST:COMM:RS232:FLOWC?

:SYSTem:COMMunicate:RS232:PARItybit

Syntax :SYSTem:COMMunicate:RS232:PARItybit {NONE|ODD|EVEN}

:SYSTem:COMMunicate:RS232:PARItybit?

Description Set the parity mode to “None”, “Odd” or “Even”.

Query the current pa rity mode.

Parameter

Return Format The query returns NONE, ODD or EVEN.

Example :SYST:COMM:RS232 :PARI OD D

:SYST:COMM:RS232:PARI?

Name Type Range Default

{NONE|ODD|EVEN} Discrete NONE|ODD|EVEN NONE

2-58 DP800 Programming Guide

Page 77

Chapter 2 Command System RIGOL

:SYSTem:COMMunicate:RS232:STOPBit

Syntax :SYSTem:COMMunicate:RS232:STOPBit {1|2}

:SYSTem:COMMunicate:RS232:STOPBit?

Description Set the stop bit to 1 or 2.

Query the current stop bit.

Parameter

Name Type Range Default

{1|2} Discrete 1|2 1

Return Format The query returns 1 or 2.

Example :SYST:COMM:RS232:STOPB 2

:SYST:COMM:RS232:STOPB?

:SYSTem:CONTrast

Syntax :SYSTem:CONTrast {<value>|MINimum|MAXimum}

:SYSTem:CONTrast? [{MINimum|MAXimum}]

Description Set the contrast of the screen.

Query the contrast of the screen.

Parameter

Name Type Range Default

<value> Integer 1 to 100 25 (factory setting)

Return Format The query returns an integer, for example, 50.

Example :SYST:CONT 50

:SYST:CONT?

:SYSTem:ERRor?

Syntax :SYSTem:ERRor?

Description Query and clear the error messages in the error queue.

Explanation Sending the

*RST command will clear the error queue.

Return Format The query returns the number and content of the error message, for example,

-113,"Undefined hea de r; keyw o rd cannot be found".

*RST

Command

DP800 Programming Guide 2-59

Page 78

RIGOL Chapter 2 Command System

:SYSTem:LANGuage:TYPE

Syntax :SYSTem:LANGuage:TYPE {EN|CH}

:SYSTem:LANGuage:TYPE?

Description Set the system language t o English or Chinese.

Query the system language.

Parameter

Name Type Range Default

{EN|CH} Discrete EN|CH CH

Return Format The query returns English or Chinese.

Example :SYST:LANG:TYPE EN

:SYST:LANG:TYPE?

:SYSTem:LOCal

Syntax :SYSTem:LOCal

Description The power supply returns from remote mode to local mode.

Explanation

When the instrument is i n remote mode, th e f ron t p anel keys are locked and displayed in the status bar in the user interface; when this command is sent, the

instrument returns to local mode, the front panel keys are available and status bar in the user interface disappears.

:SYSTem:LOCK

Syntax :SYSTem:LOCK {ON|OFF}

:SYSTem:LOCK?

in the

Description Lock (ON) or unlock (OFF) the front p anel.

Query whether the fr ont panel is locked.

Parameter

Name Type Range Default

{ON|OFF} Bool ON|OFF OFF

Explanation DP800 allows users to lock the front panel keys to avoid danger caused by

mis-operation. When the front panel is locked,

is displayed in the status bar in

the user interface.

Return Format The query returns ON or OFF.

2-60 DP800 Programming Guide

Page 79

Chapter 2 Command System RIGOL

:SYSTem:OTP

Syntax :SYSTem:OTP {ON|OFF}

:SYSTem:OTP?

Description Enable or disable the over-temperature protection (OTP) function.

Query the status of the over-temperature protection function.

Parameter

Name Type Range Default

{ON|OFF} Bool ON|OFF ON

Explanation When the OTP function is enabled, the instrument turns off the output automatically

when the temperature inside the instrument reaches the limit.

Return Format The query returns ON or OFF.

Example :SYST:OTP ON

:SYST:OTP?

:SYSTem:POWEron

Syntax :SYSTem:POWEron {DEFault|LAST}

:SYSTem:POWEron?

Description Set the instrument config uration to be used at power-on to “Default” or “Last”.

Query the instrument configuration to be used at power-on.

Parameter

Explanation LAST: the instrument uses the system configuration before the last power-off at

power-on. DEFault: the instrument uses the factory values at p ower-on (except those parameters that will not be affected by reset; refer to

Name Type Range Default

{DEFault|LAST} Discrete DEFault|LAST DEFault

Appendix B: Factory Setting).

Return Format The query returns DEFAULT or LAST.

Example :SYST:POWE LAST

:SYST:POWE?

:SYSTem:RGBBrightness

Syntax :SYSTem:RGBBrightness {<RGBbrightness>|MINimum|MAXimum}

:SYSTem:RGBBrightness? [{MINimum|MAXimum}]

Description Set the RGB brightness of the screen.

Query the RGB brightness of the screen.

Parameter

Return Format The query returns an integer from 1 to 100, for example, 47.

Example :SYST:RGBB 47

:SYST:RGBB?

Name Type Range Default

<RGBbrightness> Integer 1 to 1 00 50 (factory setting)

DP800 Programming Guide 2-61

Page 80

RIGOL Chapter 2 Command System

:SYSTem:SAVer

Syntax :SYSTem:SAVer {ON|OFF}

:SYSTem:SAVer?

Description Enable or disable the screen saver function.

Query the status of the screen saver function.

Parameter

Name Type Range Default

{ON|OFF} Bool ON|OFF OFF

Explanation When the screen saver function is enabled, the instrument will enter the screen saver

mode automatically after standing by for 25 minutes and will enter the black screen state after another 12.5 minutes.

Return Format The query returns ON or OFF.

Example :SYST:SAV ON

:SYST:SAV?

:SYSTem:SELF:TEST:BOARD?

Syntax :SYSTem:SELF:TEST:BOARD? [{TOP|BOTTOM}]

Description Query the self-test results of TopBoard and BottomBoard.

Parameter

Explanation TOP: query the self-test result of TopBoard; BOTTOM: query the self-test result of

BottomBoard; when the parameter is omitted, the command queries the self-test results of TopBoard and BottomBoard at the same time.

Name Type Range Default

{TOP|BOTTOM} Discrete TOP|BOTTOM None

Return Format The query returns PASS or FAIL. When the parameter is omitted, the query returns

the self-test results of T opBoard and BottomBoard (separated by comma) at the same time.

Example :SYST:SELF:TEST:BOARD?

*TST?

Command

:SYSTem:SELF:TEST:FAN?

Syntax :SYSTem:SELF:TEST:FAN?

Description Query the self-test result of the fan.

Return Format The query returns PASS or FAIL.

*TST?

Command

:SYSTem:SELF:TEST:TEMP?

Syntax :SYSTem:SELF:TEST:TEMP?

Description Query the self-test result of the temperature.

Return Format

2-62 DP800 Programming Guide

The query returns the temperature value in ℃, for example, 23.67.

Page 81

Chapter 2 Command System RIGOL

:TIMEr Commands

Command List:

 :TIMEr:CYCLEs  :TIMEr:ENDState  :TIMEr:GROUPs  :TIMEr:PARAmeter  :TIMEr[:STATe]  :TIMEr:TEMPlet:CONSTruct  :TIMEr:TEMPlet:FALLRate  :TIMEr:TEMPlet:INTErval  :TIMEr:TEMPlet:INVErt  :TIMEr:TEMPlet:MAXValue  :TIMEr:TEMPlet:MINValue  :TIMEr:TEMPlet:OBJect  :TIMEr:TEMPlet:PERIod  :TIMEr:TEMPlet:POINTs  :TIMEr:TEMPlet:RISERate  :TIMEr:TEMPlet:SELect  :TIMEr:TEMPlet:SYMMetry  :TIMEr:TEMPlet:WIDTh

DP800 Programming Guide 2-63

Page 82

RIGOL Chapter 2 Command System

:TIMEr:CYCLEs

Syntax :TIMEr:CYCLEs {N|I}[,<value>]

:TIMEr:CYCLEs?

Description Set the number of cycles of the timer.

Query the current number of cycles of the timer.

Parameter

Name Type Range Default

{N|I} Discrete N|I N

<value> Integer 1 to 99999 1

Explanation  The number of cycles is defined as the number of times that the instrument

performs timing output according to the preset voltage/current.

 The total number of groups in e ach timing output = the number of groups ×

the number of cycles; wherein, the number of groups is set by

:TIMEr:GROUPs command.

the

The power supply will terminate the ti mer function when the total number of groups of outputs is finished. At this point, the state of the power supply depends on the setting of the

:TIMEr:ENDState command.

Return Format The query returns I or N,<value>, for example, N,20.

Example :TIME:CY CLE N,20

:TIME:CYCLE?

Commands

:TIMEr:ENDState :TIMEr:GROUPs

2-64 DP800 Programming Guide

Page 83

Chapter 2 Command System RIGOL

:TIMEr:ENDState

Syntax :TIMEr:ENDState {OFF|LAST}

:TIMEr:ENDState?

Description Set the end state of the timer to “Off” or “Last”.

Query the current end state of the timer.

Parameter

Name Type Range Default

{OFF|LAST} Discrete OFF|LAST OFF

Explanation  The end state refers to the state of the instrument after it finishes outputting

the total number of groups of voltage/current values when the number of cycles is a specified value.

 OFF: the instrument turns off the output automatically after finishing the

output.

 LAST: the instrument stops at the output state of the last group after finishing

the output.

 The total number of groups in e ach timing output = the number of groups ×

the number of cycles; wherein, the number of groups is set by

:TIMEr:GROUPs command and the number of cycles is set by

the

:TIMEr:CYCLEs command.

the

Return Format The query returns OFF or LAST.

Example :TIME :EN DS LAST

:TIME:ENDS?

Commands

:TIMEr:CYCLEs :TIMEr:GROUPs

DP800 Programming Guide 2-65

Page 84

RIGOL Chapter 2 Command System

:TIMEr:GROUPs

Syntax :TIMEr:GROUPs <value>

:TIMEr:GROUPs?

Description Set the number of output groups of the timer.

Query the current number of output groups of the timer.

Parameter

Name Type Range Default

<value> Integer 1 to 2048 1

Explanation  The number of groups is defined as the number of groups of preset

voltage/current values that the pow er supply outputs in each cycle.

 The total number of groups in e ach timing output = the number of groups ×

the number of cycles; wherein, the number of cycles is set by

:TIMEr:CYCLEs command.

the

The power supply will terminate the ti mer function when the total number of groups of outputs is finished. At this point, the state of the power supply depends on the setting of the

:TIMEr:ENDState command.

Return Format The query returns an integer from 1 to 2048, for example, 25.

Example :TIME:GROUP 25

:TIME:GROUP?

Commands

:TIMEr:CYCLEs :TIMEr:ENDState

2-66 DP800 Programming Guide

Page 85

Chapter 2 Command System RIGOL

:TIMEr:PARAmeter

Syntax :TIMEr:PARAmeter <secnum>,<volt>,<curr>,<time>

:TIMEr:PARAmeter? <firnum>,<timercount>

Description Set the timer parameters of the specified group.

Query the timer parameters of the specified groups.

Parameter

Name Type Range Default

<secnum> Integer 0 to 2047 None

The voltage range and default value of the current

<volt> Real

channel; refer to the “Explanation” of :APPLy

Command

The current range and defaul t value of the current

<curr> Real

channel; refer to the “Explanation” of :APPLy

Command

<time> Real 1s to 99999s 1s

<firnum> Integer 0 to 2047 None

<timercount> Integer 1 to 2048 None

Explanation  <secnum> is the group number of the timer parameters; <volt>, <curr> and

<time> are the voltage, current and time of the timer parameters.

 <firnum> is t he group number of the first group of timer parameters to be

queried. <timercount> is the total number of groups of timer parameters to b e queried.

Return Format

For example, #90000000381,8.000,1.0000,10;2,6.000,1.0000,10; wherein, #90000 is the data block header; 00038

repr esents the number of bytes following; 1,8.000,1.0000,10;2,6.000,1.0000,10; are the timer par ameters returned. The format of each group of parameters is “number,voltage,current,time” and multiple groups of return values are separated by semicolons.

Example :TIME:PARA 1,8,1,10

:TIME:PARA 2,6,1,10 :TIME:PARA? 1,2 /*Query two groups of timer parameters starting from the first

group and the query returns

/*#90000000381,8.000,1.0000,10;2,6.000,1.0000,10;*/

DP800 Programming Guide 2-67

Page 86

RIGOL Chapter 2 Command System

:TIMEr[:STATe]

Syntax

Description Enable or disa b le the timing output function.

:TIMEr[:STATe] {ON|OFF} :TIMEr[:STATe]?

Query the status of the timing output function.

Parameter

Name Type Range Default

{ON|OFF} Bool ON|OFF OFF

Explanation  Enabling the timer will change the output state of the channel; make sure that

the change in the output state will not affect the device connected to the power supply before enabling the timer.

 The timing output is valid only when both the timer and the channel output are

enabled.



When the timer is enabled, the timer parameters cannot be modified.

Return Format The query returns ON or OFF.

Example :TIME ON /*Enable the timing output*/

:TIME? /*Query the status of the timing output and the query returns ON*/

:TIMEr:TEMPlet:CONSTruct

Syntax :TIMEr:TEMPlet:CONSTruct

Description Send this command and the instrument will create the timer parameters according

to the templet currently selected and the parameters set.

:TIMEr:TEMPlet:FALLRate

Syntax :TIM Er:TEMPlet:FALLRate <value>

:TIMEr:TEMPlet:FALLRate?

Description Set the fall inde x of ExpFall.

Query the fall index of ExpFall.

Parameter

Name Type Range Default

<value> Integer 0 to 10 0

Explanation When the templet currently selected is ExpRise or ExpFall, the timer parameters

created cannot reach the maximum or minimum due to the characteristic of the exponential function. The range of the timer parameters created is related to the rise index or fall index currently set. The larger the rise index or fall index is, the larger the range of the timer parameters will be.

Return Format The query returns an integer from 0 to 10, for example, 5.

Example :TIME:TEMP:FALLR 5

:TIME:TEMP:FALLR?

:TIMEr:TEMPlet:SELect

Command

2-68 DP800 Programming Guide

Page 87

Chapter 2 Command System RIGOL

:TIMEr:TEMPlet:INTErval

Syntax :TIMEr:TEMPlet:INTErval <value>

:TIMEr:TEMPlet:INTErval?

Description Set the time interval.

Query the current time interval.

Parameter

Name Type Range Default

<value> Integer 1 to 99999 1

Explanation The interval refers to the time required for the instrument to output each group of

timer parameters created using the templet currently selected.

Return Format The query returns an integer from 1 to 99999, for example, 15.

Example :TIME:TEMP:INTE 15

:TIME:TEMP:INTE?

:TIMEr:TEMPlet:SELect

Command

:TIMEr:TEMPlet:INVErt

Syntax :TIMEr:TEMPlet:INVErt {ON|OFF}

:TIMEr:TEMPlet:INVErt?

Description Enable or disable the invert of the templet currently selected.

Query whether the invert of the templet currently selected is enabled.

Parameter

Explanation When the invert is enabled, the instrument will first turn the preset waveform

Name Type Range Default

{ON|OFF} Bool ON|OFF OFF

upside down and then create timer parameters.

Return Format The query returns ON or OFF.

Example :TIME:TEMP:INVE ON

:TIME:TEMP:INVE?

:TIMEr:TEMPlet:SELect

Command

DP800 Programming Guide 2-69

Page 88

RIGOL Chapter 2 Command System

:TIMEr:TEMPlet:MAXValue

Syntax

Description Set the maximum voltage or current of the templet currently selected.

:TIMEr:TEMPlet:MAXValue {<value>|MINimum|MAXimum} :TIMEr:TEMPlet:MAXValue? [MINimum|MAXimum]

Query the maximum voltage or current of the templet currently selected.

Parameter

Name Type Range Default

<value> Real

Voltage or current range of the

channel currently selected

Explanation This command sets the maximum voltage or current (depend on

:TIMEr:TEMPlet:OBJect command).

the

Return Format The query returns the maximum voltage or current, for example, 8.400 or 5.3000.

Example

:TIME:TEMP:MAXV 5 :TIME:TEMP:MAXV?

Commands

:TIMEr:TEMPlet:OBJect :TIMEr:TEMPlet:SELect

:TIMEr:TEMPlet:MINValue

Syntax :TIMEr:TEMPlet:MINValue {<value>|MINimum|MAXimum}

:TIMEr:TEMPlet:MINValue? [MINimum|MAXimum]

Description Set the minimum voltage or current of the templet currently selected.

Query the minimum voltage or current of the templet currently selected.

Parameter

Name Type Range Default

<value> Real

Voltage or current range of the

channel currently selected

Explanation This command sets the minimum voltage or current (depend on

:TIMEr:TEMPlet:OBJect command).

the

Return Format The query returns the minimum voltage or current, for example, 1.000 or 1.0000.

Example

:TIME:TEMP:MINV 1 :TIME:TEMP:MINV?

Commands

:TIMEr:TEMPlet:OBJect :TIMEr:TEMPlet:SELect

2-70 DP800 Programming Guide

Page 89

Chapter 2 Command System RIGOL

Return Format

The query returns an integer from 2 to 99999, for example, 15.

:TIMEr:TEMPlet:OBJect

Syntax :TIMEr:TEMPlet:OBJect {V|C}[,<value>|MINimum|MAXimum]

:TIMEr:TEMPlet:OBJect? [MINimum|MAXimum]

Description Select the editing object of the templet and set the current or voltage.

Query the editing object of the templet as well as the corresponding current or voltage.

Parameter

Name Type Range Default

{V|C} Discrete V|C V

<value> Real

Voltage or current range of the

channel currently selected

Explanation When V is selected, the editing object is set to voltage and <val> sets the curr ent

value; when C is selected, the editing ob ject is set to current and <val> sets the voltage value.

Return Format The query returns the editing object an d the v ol tage or curr ent v alue, f or exampl e,

V,2.0000.

Example :TIME:TEMP:OBJ V,2

:TIME:TEMP:OBJ?

:TIMEr:TEMPlet:SELect

Command

:TIMEr:TEMPlet:PERIod

Syntax :TIMEr:TEMPlet:PERIod <value>

:TIMEr:TEMPlet:PERIod?

Description Set the period of Square.

Query the period of Square.

Parameter

Name Type Range Default

<value> Integer 2 to 99999 10

Example :TIME:TEMP:PERI 15

:TIME:TEMP:PERI?

Commands

:TIMEr:TEMPlet:SELect :TIMEr:TEMPlet:WIDTh

DP800 Programming Guide 2-71

Page 90

RIGOL Chapter 2 Command System

:TIMEr:TEMPlet:POINTs

Syntax :TIMEr:TEMPlet:POINTs <value>

:TIMEr:TEMPlet:POINTs?

Description Set the total number of points.

Query the total n umber of points.

Parameter

Name Type Range Default

<value> Integer 10 to 2048 10

Explanation  The total number of points refers to the number of group s of timer par ameters

created using the templet currently selected.

 When the total number of points (denoted by P) a nd the current number of

output groups (denoted by G) are different, P groups of parameters will be created using the templet; then, the number of output groups will change to P automatically.

Return Format The query returns an integer from 10 to 2048, for example, 50.

Example :TIME:TEMP:POINT 50

:TIME:TEMP:POINT?

:TIMEr:TEMPlet:SELect

Command

:TIMEr:TEMPlet:RISERate

Syntax :TIMEr:TEMPlet:RISERate <value>

:TIMEr:TEMPlet:RISERate?

Description Set the rise index of ExpRise.

Query the rise index of ExpRise.

Parameter

Name Type Range Default

<value> Integer 0 to 10 0

Explanation When the templet currently selected is ExpRise or ExpFall, the timer parameters

Return Format The query returns an integer from 0 to 10, for example, 5.

Example :TIME:TEMP:RISER 5

:TIME:TEMP:RISER?

:TIMEr:TEMPlet:SELect

Command

2-72 DP800 Programming Guide

Page 91

Chapter 2 Command System RIGOL

:TIMEr:TEMPlet:SELect

Syntax :TIMEr:TEMPlet:SELect {SINE|SQUARE|RAMP|UP|DN|UPDN|RISE|FALL}

:TIMEr:TEMPlet:SELect?

Description Select the desired templet.

Query the templet currently selected.

Parameter

{SINE|SQUARE|RAMP|

UP|DN|UPDN|RISE|FALL}

Name Type Range Default

Discrete

SINE|SQUARE|RAMP|

UP|DN|UPDN|RISE|FALL

Return Format The query returns SINE, SQUARE, RAMP, UP, DN, UPDN, RISE or FALL.

Example :TIME :TEM P :SE L SQUA RE

:TIME:TEMP:SEL?

:TIMEr:TEMPlet:SYMMetry

Syntax :TIMEr:TEMPlet:SYMMetry <value>

:TIMEr:TEMPlet:SYMMetry?

Description Set the symmetry of RAMP.

Query the symmetry of RAMP.

Parameter

Explanation Symmetry refers to the ratio of the duration of the rising edge within a period to the

whole period.

Return Format The query returns an integer from 0 to 100, for example, 60.

Name Type Range Default

<value> Integer 0 to 100 50

SINE

Example :TIME:TEMP:SYMM 60

:TIME:TEMP:SYMM?

:TIMEr:TEMPlet:SELect

Command

:TIMEr:TEMPlet:WIDTh

Syntax :TIMEr:TEMPlet:WIDTh <value>

:TIMEr:TEMPlet:WIDTh?

Description Set the pulse width of Square.

Query the pulse wid th of Square.

Parameter

Explanation Pulse width refers to the duration of high level within a period.

Return Format The query returns an integer, for example, 14.

Example :TIME:TEMP:WIDT 14

:TIME:TEMP:WIDT?

Commands

:TIMEr:TEMPlet:PERIod :TIMEr:TEMPlet:SELect

Name Type Range Default

<value> Integer 1 to (period-1) 5

DP800 Programming Guide 2-73

Page 92

RIGOL Chapter 2 Command System

:TRIGger Commands

Command List:

 :TRIGger:IN[:ENABle]  :TRIGger:IN:RESPonse  :TRIGger:IN:SENSitivity  :TRIGger:IN:SOURce  :TRIGger:IN:TYPE  :TRIGger:OUT:CONDition  :TRIGger:OUT:DUTY  :TRIGger:OUT[:ENABle]  :TRIGger:OUT:PERIod  :TRIGger:OUT:POLArity  :TRIGger:OUT:SIGNal  :TRIGger:OUT:SOURce

:TRIGger:IN[:ENABle]

Syntax :TRIGger:IN[:ENABle] [D0|D1|D2|D3,]{ON|OFF}

:TRIGger:IN[:ENABle]? [D0|D1|D2|D3]

Description Enable or disable the trigger input function of the specified data line.

Query the status of the trigger input function of the specified data line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

{ON|OFF} Bool ON|OFF OFF

Explanation  If [D0|D1|D2|D3] is omitted, the command enables the trigger input function

of the data line currently selected.

 After enabling the trigger input function, the specified source under control will

turn on the output, turn off the output or toggle the output state according to the setting of the

:TRIGger:IN:RESPonse command when the i nput signal on

the specified data line meets the current trigger type.

Return Format The query returns Dn,ON or Dn,OFF; wherein, n=0, 1, 2 or 3.

Example :TRIG:IN D1,ON /*Enable the trigger input function of D1*/

:TRIG:IN? D1 /*Query the status of the trigger input function of D1 and the

query returns D1,ON*/

:TRIGger:IN:RESPonse

Command

2-74 DP800 Programming Guide

Page 93

Chapter 2 Command System RIGOL

:TRIGger:IN:RESPonse

Syntax :TRIGger:IN:RESPonse [D0|D1|D2|D3,]{ON|OFF|ALTER}

:TRIGger:IN:RESPonse? [D0|D1|D2|D3]

Description Set the output response of the trigger input of the specified data li ne.

Query the output response of the trigger input of the specified data line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

{ON|OFF|ALTER} Discrete ON|OFF|ALTER OFF

Explanation  If [D0|D1|D2|D3] is omitted, the command sets the output response of the

data line currently selected.

 OutpOpen: when the trigger condition is met, turn on the output of the

channel currently selected as the source unde r cont rol .

 OutpClose: when the trigger condition is met, turn off the output of the

channel currently selected as the source under control.

 OutpToggle: when the trigger condition is met, toggle the output state of the

channel currently selected as the source under control.

Return Format The query returns ON, OFF or ALTER.

Example :TRIG:IN:RESP D1,ON /*Set the output response of the trigger input of D1 to

OutpOpen */

:TRIG:IN:RESP? D1 /*Query the output response of the trigger input of D1 and

the query returns ON*/

:TRIGger:IN:SENSitivity

Syntax :TRIGger:IN:SENSitivity [D0|D1|D2|D3,]{LOW|MID|HIGH}

:TRIGger:IN:SENSitivity? [D0|D1|D2|D3]

Description Set the trigge r sensitivity of the trigger input of the specified data lin e.

Query the trigger sensitivity of the trigger input of the specified data line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

{LOW|MID|HIGH} Discrete LOW|MID|HIGH LOW

Explanation  If [D0|D1|D2|D3] is omitted, the command sets the trigger sensitivity of the

data line currently selected.



Selecting relatively lower trigger sensitivity can avoid mis-trigger at the noise.

Return Format The query returns LOW, MID or HIGH.

Example :TRIG:IN:SENS D1,HIGH /*Set the trigger sensitivity of the trigger input of D1 to

high*/

:TRIG:IN:SENS? D1 /*Query the trigger sensitivity of the trigger input of D 1

and the query returns HIGH*/

DP800 Programming Guide 2-75

Page 94

RIGOL Chapter 2 Command System

{RISE|FALL|HIGH|LOW}

Discrete

RISE|FALL|HIGH|LOW

RISE

:TRIGger:IN:SOURce

Syntax :TRIGger:IN:SOURce [D0|D1|D2|D3,][CH1[,CH2[,CH3]]]

:TRIGger:IN:SOURce? [D0|D1|D2|D3]

Description Set the source under co ntrol of the trigger input of the spe cified data line.

Query the source under control of the trigger input of the specified data line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

[CH1[,CH2[,CH3]]]

ASCII character

string

One or more of

CH1|CH2|CH3

Explanation  If [D0|D1|D2|D3] is omitted, the command sets the source under control of

the data line currently selected.

 One or more channels can be selected as the sour ce under control at the same

time.

Return Format The query returns the source under control. Multiple sources under control are

separated by commas, for example, CH1 or CH1,CH2.

Example :TRIG:IN:SOUR D1,CH1 /*Set the source under control of the trigg er input of D1

to CH1*/

:TRIG:IN:SOUR? D1 /*Query the source under control of the trigger input of

D1 and the query re turns CH1*/

:TRIGger:IN:TYPE

Syntax :TRIGger:IN:TYPE [D0|D1|D2|D3,]{RISE|FALL|HIGH|LOW}

:TRIGger:IN:TYPE? [D0|D1|D2|D3]

CH1

Description Set the trigger type of the trigger input of the specified data line.

Query the trigger type of the trigger input of the specified data line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

Explanation  If [D0|D1|D2|D3] is omitted, the command sets the trigger type of the data

line currently selected.

 You can select to trigger on the rising edge (RISE), falling edge (FALL), high

level (HIGH) or low level (LOW) of the inp ut signal.

Return Format The query returns RISE, FALL, HIGH or LOW.

Example :TRIG:IN:TYPE D1,FALL /*Set the trigger type of the trigger input of D1 to the

falling edge */

:TRIG:IN:TYPE? D1 /*Query the trigger type of the trigger input of D1 and

the query returns FALL*/

2-76 DP800 Programming Guide

Page 95

Chapter 2 Command System RIGOL

example, >V,8.800.

:TRIGger:OUT:CONDition

Syntax :TRIGger:OUT:CONDition

[D0|D1|D2|D3,]{OUTOFF|OUTON|>V|<V|=V|>C|<C|=C|>P|<P|=P|AUTO}[,<val ue>|MINimum|MAXimum]

:TRIGger:OUT:CONDition? [D0|D1|D2|D3][,MINimum|MAXimum]

Description Set the trigger condition of the trigger output of the specified data line.

Query the trigger condition of the trigger output of the specified data line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

{OUTOFF|OUTON|

>V|<V|=V|>C|<C|=C|

>P|<P|=P|AUTO}

Discrete

OUTOFF|OUTON|

>V|<V|=V|>C|<C|=C|

>P|<P|=P|AUTO

OUTOFF

0.5*maximum

Voltage/current/power

<value> Real

range of the channel

currently selected

voltage/current/

power of the

channel currently

selected

Explanation  If [D0|D1|D2|D3] is omitted, the command sets the trigger condition of the

trigger output of the data line currently selected.

 When OUTOFF, OUTON or AUTO is selected, <value> is omitted; when >V, <V,

=V, >C, <C, =C, >P, <P or =P is selected, <value> is the corresponding voltage, current or power.

Return Format

When the condition is set to OUTOFF, OUTON or AUTO, the query returns OUTOFF, OUTON or AUTO; when the condition is set to >V, <V, =V, >C, <C, =C, >P, <P or =P, the query returns the condition and the voltage/current/power, for

Example :TRIG:OUT:COND D1,>V,8.8 /*Set the trigger condition of the trigger output of

D1 to >V and set the voltage to 8.8V*/

:TRIG:OUT:COND? D1 /* Query the trigger condition of the trigger output of

D1 and the query re turns >V,8.800*/

DP800 Programming Guide 2-77

Page 96

RIGOL Chapter 2 Command System

{ON|OFF}

Bool

ON|OFF

OFF

:TRIGger:OUT:DUTY

Syntax :TRIGger:OUT:DUTY [D0|D1|D2|D3,]<value>

:TRIGger:OUT:DUTY? [D0|D1|D2|D3]

Description Set the duty cycle of the square waveform of the trigger output on the specified

data line. Query the duty cycle of the square waveform of the trigger output on the specified

data line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

<value> Integer 10 to 90 50

Explanation  If [D0|D1|D2|D3] is omitted, the command sets the duty cycle of the square

waveform of the trigger output on the data line currently selected.

 Duty cycle is defined as the perce ntage that the high level takes up within a

whole square waveform period.

Return Format The query returns an integer from 10 to 90.

Example :TRIG:OUT:DUTY D1,60 /*Set the duty cycle of the square waveform of the

trigger output on D1 to 60%*/

:TRIG:OUT:DUTY? D1 /*Query the duty cycle of the square waveform of the

trigger output on D1 and the query returns 60*/

:TRIGger:OUT[:ENABle]

Syntax :TRIGger:OUT[:ENABle] [D0|D1|D2|D3,]{ON|OFF}

:TRIGger:OUT[:ENABle]? [D0|D1|D2|D3]

Description Enable or disa b le the trigger output function of the specified data line.

Query the status of the trigger output function of the specified data line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

Explanation  If [D0|D1|D2|D3] is omitted, the command enables or disables the trigger

output function of the data line currently selected.

 When the trigger output functio n is enabled, the specified data line outputs

level or square waveform according to the setting of the output signal when the output signal of the control source meets the trigger condition set.

Return Format The query returns Dn,ON or Dn,OFF; wherein, n=0, 1, 2 or 3.

Example :TRIG:IN D1,ON /*Enable the trigger output function o f D1 */

:TRIG:IN? D1 /*Query the status of the trigger output function of D1 and the

query returns D1,ON*/

2-78 DP800 Programming Guide

Page 97

Chapter 2 Command System RIGOL

D1 /* Query the polarity of the trigger output signal of

:TRIGger:OUT:PERIod

Syntax :TRIGger:OUT:PERIod [D0|D1|D2|D3,]<value>

:TRIGger:OUT:PERIod? [D0|D1|D2|D3]

Description

Set the period of the square waveform of the trigger output on the specified data line. Query the period of the square waveform of the trigger output on the specified data

line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

<value> Real 0.0001 to 2.5 1

Explanation If [D0|D1|D2|D3] is om itted, the command sets the period o f the square wavef orm of

the trigger output on the data line currently selected.

Return Format The query returns a value from 0.0001 to 2.5.

Example :TRIG:OUT:PERI D1,0.005 /*Set the period of the square waveform of the trigger

output on D1 to 5ms*/

:TRIG:OUT:PERI? D1 /*Query the period of the square waveform of the trigger

output on D1 and the query returns 0.005000*/

:TRIGger:OUT:POLArity

Syntax :TRIGger:OUT:POLArity [D0|D1|D2|D3,]{POSItive|NEGAtive}

:TRIGger:OUT:POLArity? [D0|D1|D2|D3]

Description Set the polarity of the trigger output signal of the specified data line.

Query the polarity of the trigger output signal of the specified data line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

{POSItive|NEGAtive} Discrete POSItive|NEGAtive POSItive

Explanation  If [D0|D1|D2|D3] is omitted, the command sets the polarity of the trigger

output signal of the data line currently selected.

 POSItive: output according to the signal selected using

:TRIGger:OUT:SIGNal command;

the NEGAtive: turn the signa l selected using the

:TRIGger:OUT:SIGNal command

upside down and then output the signal .

Return Format The query returns POSITIVE or NEGATIVE.

Example

:TRIG:OUT:POLA D1,NEGAtive /* Set the polarity of the trigger o utput signal of

D1 to negative */

:TRIG:OUT:POLA?

D1 and the query returns NEGATIVE*/

DP800 Programming Guide 2-79

Page 98

RIGOL Chapter 2 Command System

:TRIGger:OUT:SIGNal

Syntax :TRIGger:OUT:SIGNal [D0|D1|D2|D3,]{LEVEL|SQUARE}

:TRIGger:OUT:SIGNal? [D0|D1|D2|D3]

Description Set the type of the trigger output signal of the specified data line.

Query the type of the trigger output signal of the specified data line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

{LEVEL|SQUARE} Discrete LEVEL|SQUARE LEVEL

Explanation  If [D0|D1|D2|D3] is omitted, the command sets the type of the trigger output

signal of the data line currently selected.

 When LEVEL is selected, the corresponding data line outputs level signal when

the trigger condition is met; when SQUARE is selected, the corresponding data line outputs squa re waveform when the trigger condition is met.

Return Format The query returns LEVEL or SQUARE.

Example :TRIG:OUT:SIGN D1,LEVEL /* Set the type of the trigger output signal of D1 to

level */

:TRIG:OUT:SIGN? D1 /* Query the type of the trigger output signal of D1

and the query returns LEVEL*/

:TRIGger:OUT:SOURce

Syntax :TRIGger:OUT:SOURce [D0|D1|D2|D3,]{CH1|CH2|CH3}

:TRIGger:OUT:SOURce? [D0|D1|D2|D3]

Description Set the control source of the trigger output of the specified data line.

Query the control s ource of the trigger output of the specified data line.

Parameter

Name Type Range Default

[D0|D1|D2|D3] Discrete D0|D1|D2|D3 D0

{CH1|CH2|CH3} Discrete CH1|CH2|CH3 CH1

Explanation  If [D0|D1|D2|D3] is omitted, the command sets the control source of the

trigger output of the data line currently selected.



Any channel can be selected as the control source of the trigger output.

Return Format The query returns the control source, for example, CH1.

Example :TRIG:IN:SOUR D1,CH1 /* Set the control source of D1 to CH1*/

:TRIG:IN:SOUR? D1 /* Query the control source of D1 and the query returns

CH1*/

2-80 DP800 Programming Guide

Page 99

Chapter 3 Application Examples RIGOL

Chapter 3 Application Examples

This chapter provides some application examples of the SCPI commands. A series of SCPI commands are combined to realize the main functions of the power supply.

Note:

1 The examples in this chapter ar e based on DP831A. For other m odels, the r anges of s ome par ameters

might be different. When using the commands, please make proper adjustment according to the model of your instrument.

2 Before using the examples in this chapter, please select the desired communication interface (USB,

LAN, RS232 or GPIB) and make correct connections (refer to the introductions in

Communication). Besides, you have to install Ultra Sigma or other PC software fo r sending command s

on your PC.

3 The content enclosed in “/*” and “*/” after each command is anno tation for easier understanding and

is not a part of the command.

Main topics of this chapter:

 CV Output  Track Function

To Build Remote

 Timing Output  Delay Output  To Use the Recorder  To Use the Analyzer  To Use the Monitor  To Use the Trigger

DP800 Programming Guide 3-1

Page 100

RIGOL Chapter 3 Application Examples

CV Output

Requirement

Use the SCPI commands to realize the following functions: CH1 CV output; set the output voltage to 5V , the output current to 5A and the overcurrent protection limit to

5.3A.

Method 1

1 *IDN? /*Query the ID character string of the power supply to check whe ther the

remote communication is normal*/ 2 :INST CH1 /*Select CH1*/ 3 :CURR 5 /*Set the current to 5A*/ 4 :CURR:PROT 5.3 /*Set the overcurrent protection limit of CH1 to 5.3A*/ 5 :CURR:PROT:STAT ON /*Enable the overcurrent protection function of CH1*/ 6 :VOLT 5 /*Set the voltage to 5V*/ 7 :OUTP CH1,ON /*Enable the output of CH1*/

Method 2

1 *IDN? /*Query the ID character string of the power supply to check whe ther the

remote communication is normal*/ 2 :CURR:PROT 5.3 /*Set the overcurrent protection limit of CH1 to 5.3A*/ 3 :CURR:PROT:STAT ON /*Enable the overcurrent protection function of CH1*/ 4 :APPL CH1,5,5 /*Select CH1, set the voltage to 5V and current to 5A*/ 5 :OUTP CH1,ON /*Enable the output of CH1*/

Track Function

Some channels of DP800 support the track function, including CH2 and CH3 of DP831A as well as CH1 and CH2 of DP832A/DP832.

Requirement

Use the SCPI commands to realize the following functions by taking DP831A as an example: Enable the track function of CH3; change the voltage setting value of CH3 from -5V to -30V; at this point, the voltage setting value of CH2 changes accordingly.

Method 1 *IDN? /*Query the ID character string of the power supply to check whe ther the

remote communication is normal*/ 2 :OUTP:TRAC CH3,ON /*Enable the track function of CH3*/ 3 :APPL CH3,-5,1 /*Set the voltage of CH3 to -5V and the current t o 1A*/ 4 :APPLy? CH2,VOLTage /*Query the voltage of CH2 and the query re turns 5.000*/ 5 :APPL CH3,-30,1 /*Change the voltage of CH3 to -30V*/ 6 :APPLy? CH2,VOLTage /*Query the voltage of CH2 and the query re turns 30.000*/

3-2 DP800 Programming Guide

Rigol DP800, DP831A, DP832A, DP832 Programming Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Guaranty and Declaration

Safety Requirement

General Safety Summary

Safety Terms and Symbols

Document Overview

Chapter 1 Programming Overview RIGOL

To Build Remote Communication

Remote Control Methods

SCPI Command Overview

Syntax

Symbol Description

Parameter Type

Command Abb r eviation

Chapter 2 Command System

:ANALyzer Commands

:ANALyzer:ANALyze

:ANALyzer:ENDTime

:ANALyzer:FILE?

:ANALyzer:MEMory

:ANALyzer:MMEMory

:ANALyzer:OBJect

:ANALyzer:RESult?

:ANALyzer:STARTTime

:ANALyzer:VALue?

:APPLy Command

:DELAY Commands

:DELAY:CYCLEs

:DELAY:ENDState

:DELAY:GROUPs

:DELAY:PARAmeter

:DELAY[:STATe]

:DELAY:STATe:GEN

:DELAY:STOP

:DELAY:TIME:GEN

:DISPlay Command

IEEE488.2 Common Commands

*IDN?

*RCL

*RST

*SAV

*TST?

:INSTrument Commands

:INSTrument:NSELect

:INSTrument[:SELEct]

:MEASure Commands

:MEASure:ALL[:DC]?

:MEASure:CURRent[:DC]?

:MEASure:POWEr[:DC]?

:MEASure[:VOLTage][:DC]?

:MEMory Commands

:MEMory[:STATe]:DELete

:MEMory[:STATe]:LOAD

:MEMory[:STATe]:LOCK

:MEMory[:STATe]:STORe

:MEMory[:STATe]:VALid?

:MMEMory Commands

:MMEMory:CATalog?

:MMEMory:CDIRectory

:MMEMory:DELete

:MMEMory:DISK?

:MMEMory:LOAD

:MMEMory:MDIRectory

:MMEMory:STORe

:MONItor Commands

:MONItor:CURRent:CONDition

:MONItor:CURRent[:VALue]

:MONItor:POWER:CONDition

:MONItor:POWER[:VALue]

:MONItor[:STATe]

:MONItor:STOPway

:MONItor:VOLTage:CONDition

:MONItor:VOLTage[:VALue]

:OUTPut Commands

:OUTPut:MODE?

:OUTPut:OCP:CLEAR

:OUTPut:OCP:QUES?