Page 1
RIGOL Programming Guide DP800 Series Programmable Linear DC Power Supply Mar. 2013 RIGOL Technologies, Inc.
Page 3
Notices RIGOL products are protected by patent law in and outside of P.R.C. RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at company’s sole decision. Information in this publication replaces all previously corresponding material.
If you suspect damage occurs to the instrument, have it inspected by qualified service personnel before further operations. Any maintenance, adjustment or replacement especially to circuits or accessories must be performed by RIGOL authorized personnel. Keep Well Ventilation. Inadequate ventilation may cause increasing of temperature or damages to the device. So please keep well ventilated and inspect the intake and fan regularly.
Page 5
RIGOL discharges. Always ground both the internal and external conductors of the cable to release static before connecting. Handling Safety. Please handle with care during transportation to avoid damages to buttons, knob interfaces and other parts on the panels. DP800 Programming Guide...
RIGOL Safety Terms and Symbols Terms in this Manual. These terms may appear in this manual: WARNING Warning statements indicate the conditions or practices that could result in injury or loss of life. CAUTION Caution statements indicate the conditions or practices that could result in damage to this product or other property.
C++, Visual Basic and LabVIEW. Chapter 5 Appendix This chapter provides various information, such as the command list and factory setting list. For the newest version of this manual, please download it from www.rigol.com. Format Conventions in this Manual: Button The function key at the front panel is denoted by the format of “Button Name (Bold) + Text Box”...
Page 8
DP800 series programmable linear DC power supply includes the following models. The programmable ranges of the voltage and current for each model are as listed below. Unless otherwise noted, in this manual, DP831A is taken as an example to illustrate the using method of each DP800 series command. DP831A...
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 ........................
RIGOL Chapter 1 Programming Overview Chapter 1 Programming Overview This chapter introduces how to build the remote communication between the PC and instrument and provides an overview of the syntax, symbol, parameter type and abbreviation rules of the SCPI commands.
RIGOL Chapter 1 Programming Overview 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".
Page 15
RIGOL Chapter 1 Programming Overview (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.
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 Besides, you can also control the instrument using the “Measurement & Automation Explorer” of NI (National Instruments Corporation) or the “Agilent IO Libraries Suite” of Agilent (Agilent Technologies, Inc.).
RIGOL Chapter 1 Programming Overview 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. Braces { } Usually, multiple optional parameters are enclosed in the braces and one of the parameters must be selected when sending the command.
RIGOL Chapter 1 Programming Overview Besides, many commands contain the MINimum and MAXimum parameters which are used to set the parameter to its minimum or maximum value. For example, MINimum and MAXimum in the :SYSTem:BRIGhtness {<brightness>|MINimum|MAXimum} command are used to set the brightness to the minimum or maximum.
RIGOL Chapter 2 Command System 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 ...
RIGOL Chapter 2 Command System :ANALyzer Commands The :ANALyzer commands are used to set the analyzer parameters, execute analysis and query the analysis results. Command List :ANALyzer:ANALyze :ANALyzer:ENDTime :ANALyzer:FILE? :ANALyzer:MEMory :ANALyzer:MMEMory :ANALyzer:OBJect :ANALyzer:RESult? ...
RIGOL Chapter 2 Command System :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...
RIGOL Chapter 2 Command System :ANALyzer:MMEMory Syntax :ANALyzer:MMEMory <dest> Description Open the specified record file. Parameter Name Type Range Default <dest> ASCII character string Valid directory under D disk None Explanation This command is only available when valid record file is stored in the specified location.
RIGOL Chapter 2 Command System :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 Explanation You can only set the start time when valid record file is opened (refer to ...
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.
RIGOL Chapter 2 Command System :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 ...
RIGOL Chapter 2 Command System :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 Explanation The end state refers to the state of the instrument when the delayer stops.
RIGOL Chapter 2 Command System :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 OFF (even group);...
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 Explanation 01P: 0 1 pattern. The state is set to “Off” and “On” alternately.
RIGOL Chapter 2 Command System :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 to generate time automatically as well as the corresponding parameters.
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 Name Type Range Default {NORMal|WAVE|DIAL} Discrete NORMal|WAVE|DIAL NORMal Explanation NORMal: normal mode. The parameters (such as the voltage and current) of all ...
*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...
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 Name...
RIGOL Chapter 2 Command System :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 Explanation In this command, numbers are used in place of the channel labels in :INSTrument[:SELEct] command.
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 internally on the specified channel. Parameter Name Type Range Default [{CH1|CH2|CH3}]...
RIGOL Chapter 2 Command System :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 ...
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.
RIGOL Chapter 2 Command System :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...
RIGOL Chapter 2 Command System :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 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 The read and delete operations are only available when the specified storage location contains a valid file.
RIGOL Chapter 2 Command System :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.
:MMEMory:MDIRectory command will create a folder under the current directory. 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...
RIGOL Chapter 2 Command System :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:\.
RIGOL Chapter 2 Command System :MMEMory:STORe Syntax :MMEMory:STORe <file_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, ASCII character <file_name> including Chinese characters, English...
RIGOL Chapter 2 Command System :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] ...
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 0 to the maximum 0.5*rated current of <value> Real...
RIGOL Chapter 2 Command System :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 0 to the maximum power 0.25*rated power of <value>...
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 Name Type Range Default...
RIGOL Chapter 2 Command System :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...
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 0 to the maximum voltage 0.5*rated voltage of the <value>...
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...
RIGOL Chapter 2 Command System :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 specified channel. Query the overcurrent protection limit of the specified channel. Parameter Name Type Range Default {CH1|CH2|CH3} Discrete CH1|CH2|CH3 None Current range of the Maximum current of <value>...
RIGOL Chapter 2 Command System :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}...
RIGOL Chapter 2 Command System :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 channel. Query the overvoltage protection limit of the specified channel. Parameter Name Type Range Default {CH1|CH2|CH3} Discrete CH1|CH2|CH3 None Voltage range of the Maximum voltage of <value>...
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...
RIGOL Chapter 2 Command System :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.
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 Name Type Range Default {DEFAULT|USER1|USER2| DEFAULT|USER1|USER2| Discrete DEFAULT...
RIGOL Chapter 2 Command System :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 Discrete 1|2|3|4 None Refer to the <current>...
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 specified user-preset state. Query the status of the track function of the specified user-preset state. Parameter Name Type Range Default Discrete...
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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 Discrete 1|2|3|4 None :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.
RIGOL Chapter 2 Command System :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:MEMory ...
RIGOL Chapter 2 Command System :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 <dest> ASCII character string Directory of the external memory None...
RIGOL Chapter 2 Command System :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 Explanation When the recorder is enabled, you cannot set the record period and storage ...
RIGOL Chapter 2 Command System :SOURce Commands The :SOURce commands are used to set the voltage, current, OVP and OCP of the specified channel. Their functions are equivalent to that of :APPLy Command. Although the :APPLy command provides the most straightforward method to program the power supply over the remote interfaces, the :SOURce commands give you more flexibility to change individual parameters.
RIGOL Chapter 2 Command System [:SOURce[n]]:CURRent:PROTection[:LEVel] Syntax [:SOURce[n]]:CURRent:PROTection[:LEVel] {<current>|MINimum|MAXimum} [:SOURce[n]]:CURRent:PROTection[:LEVel]? [{MINimum|MAXimum}] Description Set the overcurrent protection limit of the specified channel. Query the overcurrent protection limit of the specified channel. Parameter Name Type Range Default Integer 1|2|3 Current range of the Maximum current of the <current>...
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 specified channel. Parameter Name Type Range Default Integer...
RIGOL Chapter 2 Command System [: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 Integer 1|2|3 Voltage range of the Maximum voltage of the <voltage>...
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 Integer...
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...
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:GPIB:ADDRess Syntax :SYSTem: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 Explanation Before using the GPIB interface, extend a GPIB interface using the USB-GPIB interface converter;...
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN:DHCP[:STATe] :SYSTem:COMMunicate:LAN:DHCP[:STATe] {ON|OFF} Syntax :SYSTem:COMMunicate:LAN:DHCP[:STATe]? Description Enable or disable the DHCP mode. Query the status of the DHCP mode. Parameter Name Type Range Default {ON|OFF} Bool ON|OFF Explanation In DHCP mode, the DHCP server in the current network assigns network ...
RIGOL Chapter 2 Command System :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 the first nnn ranges from 1 to 223 <gateway>...
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.
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN:SMASK Syntax :SYSTem:COMMunicate:LAN:SMASK <submask> :SYSTem:COMMunicate:LAN:SMASK? Description Set the subnet mask. Query the current subnet mask. Parameter Name Type Range Default The format is ASCII nnn.nnn.nnn.nnn; <submask> character None wherein, the range of string nnn is from 0 to 255...
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 Return Format The query returns 5, 6, 7 or 8.
RIGOL Chapter 2 Command System :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 Return Format The query returns 1 or 2. Example...
RIGOL Chapter 2 Command System :SYSTem:LANGuage:TYPE Syntax :SYSTem:LANGuage:TYPE {EN|CH} :SYSTem:LANGuage:TYPE? Description Set the system language to English or Chinese. Query the system language. Parameter Name Type Range Default {EN|CH} Discrete EN|CH Return Format The query returns English or Chinese. Example...
RIGOL Chapter 2 Command System :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 Explanation When the OTP function is enabled, the instrument turns off the output automatically when the temperature inside the instrument reaches the limit.
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 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.
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 <value> Integer 1 to 99999...
RIGOL Chapter 2 Command System :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 Explanation The end state refers to the state of the instrument after it finishes outputting ...
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...
RIGOL Chapter 2 Command System :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>...
RIGOL Chapter 2 Command System :TIMEr[:STATe] :TIMEr[:STATe] {ON|OFF} Syntax :TIMEr[:STATe]? Description Enable or disable the timing output function. Query the status of the timing output function. Parameter Name Type Range Default {ON|OFF} Bool ON|OFF Explanation Enabling the timer will change the output state of the channel; make sure that ...
RIGOL Chapter 2 Command System :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 Explanation The interval refers to the time required for the instrument to output each group of timer parameters created using the templet currently selected.
RIGOL Chapter 2 Command System :TIMEr:TEMPlet:MAXValue :TIMEr:TEMPlet:MAXValue {<value>|MINimum|MAXimum} Syntax :TIMEr:TEMPlet:MAXValue? [MINimum|MAXimum] Description Set the maximum voltage or current of the templet currently selected. Query the maximum voltage or current of the templet currently selected. Parameter Name Type Range Default Voltage or current range of the <value>...
RIGOL Chapter 2 Command System :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.
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 number of points. Parameter Name Type Range Default <value> Integer 10 to 2048 Explanation The total number of points refers to the number of groups of timer parameters ...
RIGOL Chapter 2 Command System :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 Name Type Range Default {SINE|SQUARE|RAMP| SINE|SQUARE|RAMP| Discrete SINE UP|DN|UPDN|RISE|FALL} UP|DN|UPDN|RISE|FALL Return Format The query returns SINE, SQUARE, RAMP, UP, DN, UPDN, RISE or FALL.
RIGOL Chapter 2 Command System :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 line. Query the output response of the trigger input of the specified data line. Parameter Name...
RIGOL Chapter 2 Command System :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 control of the trigger input of the specified data line. Query the source under control of the trigger input of the specified data line.
RIGOL Chapter 2 Command System :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...
RIGOL Chapter 2 Command System :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.
RIGOL Chapter 2 Command System :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.
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...
RIGOL Chapter 3 Application Examples 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: The examples in this chapter are based on DP831A. For other models, the ranges of some parameters might be different.
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...
RIGOL Chapter 3 Application Examples Timing Output Requirement Use the SCPI commands to realize the following functions: Set the timer parameters of CH1: set the number of groups to 25, the number of cycles to 20 and the end state to last; use the Sine templet to create the timer parameters; set the editing object to voltage and the current to 2A;...
Requirement Use the SCPI commands to realize the following functions: Set the record period to 2s and the storage directory of the record file to C:\REC 1:RIGOL.ROF; enable the recorder, wait for about 2 minutes and disable the recorder. Method...
RIGOL Chapter 3 Application Examples To Use the Monitor Requirement Use the SCPI commands to realize the following functions: Monitor CH1. Set the monitor condition: >Volt, >Curr or >Power; set the voltage to 5V, the current to 3A and the ...
RIGOL Chapter 3 Application Examples To Use the Trigger Trigger Input Requirement Use the SCPI commands to realize the following functions: Set the trigger input parameters of D0: set the source under control to CH1, the trigger type to falling ...
RIGOL Chapter 4 Programming Demos Chapter 4 Programming Demos This chapter provides the demos for programming and controlling the power supply using SCPI commands under Excel, Matlab, LabVIEW, Visual Basic and Visual C++ environment on the basis of NI-VISA. NI-VISA (National Instrument-Virtual Instrument Software Architecture) is an advanced application programming interface developed by NI (National Instrument) for communicating with various instrument buses.
RIGOL Chapter 4 Programming Demos Programming Preparations Before programming, you need to make the following preparations: Make sure that your PC has installed the NI-VISA library (can be downloaded from NI website: http://www.ni.com/visa/). Here, the default installation path is C:\Program Files\IVI Foundation\VISA.
RIGOL Chapter 4 Programming Demos Excel Programming Demo The program used in this demo: Microsoft Excel 2010 The function realized in this demo: send the *IDN? Command to read the device information. Create a new Excel file that enables the Macros. In this demo, the file is named as DP800_Demo_Excel.xlsm.
Page 108
RIGOL Chapter 4 Programming Demos Select Tools(T) in the Microsoft Visual Basic menu bar and click References. Select VISA Library in the pop-up dialog box and click OK to refer to the VISA Library. Explanation: If you cannot find VISA Library in the list at the left of the figure above, please follow the method below to find it.
Page 109
RIGOL Chapter 4 Programming Demos Click View Code in the Developer menu to enter the Microsoft Visual Basic interface. Add the following codes and save the file. Note: If the Excel file created at step 2 does not enable the Macros, at this point, the prompt message “The following features cannot be saved in macro-free workbooks”will be displayed.
Page 110
RIGOL Chapter 4 Programming Demos Click *IDN? to run the program. DP800 Programming Guide...
RIGOL Chapter 4 Programming Demos Matlab Programming Demo The program used in this demo: MATLAB R2009a The function realized in this demo: read the output voltage, current and power measured internally on CH1. Run the Matlab software and modify the current directory (namely modify the Current Directory at the top of the software).
RIGOL Chapter 4 Programming Demos LabVIEW Programming Demo The program used in this demo: LabVIEW 2009 The functions realized in this demo: search for the instrument address, connect the instrument, send command and read the return value. Run LabVIEW 2009, create a VI file and name it as DP800_Demo_LABVIEW.
Page 115
RIGOL Chapter 4 Programming Demos (4) Exit: Run the program and the interface as shown in the figure below is displayed. Click the Address dropdown box and select the VISA resource name; click Connect to connect the instrument; enter the command into the Command textbox and click Write to write the command into the instrument.
RIGOL Chapter 4 Programming Demos Visual Basic Programming Demo The program used in this demo: Visual Basic 6.0 The function realized in this demo: enable the three channels of the power supply and show the colors of the channels. Build a standard application program project (Standard EXE) and name it as DP800_Demo_VB.
Page 117
RIGOL Chapter 4 Programming Demos Dim nmatches As Long Dim matches As String * 200 ' Acquire the usb resource of visa Call viOpenDefaultRM(defrm) Call viFindRsrc(defrm, "USB?*", list, nmatches, matches) ' Turn on the device Call viOpen(defrm, matches, 0, 0, vi) ' Send command to query the CH1 status Call viVPrintf(vi, ":OUTP? CH1"...
RIGOL Chapter 4 Programming Demos Visual C++ Programming Demo The program used in this demo: Microsoft Visual C++ 6.0 The functions realized in this demo: search for the instrument address, connect the instrument, send command and read the return value.
Page 119
RIGOL Chapter 4 Programming Demos Add the Text, Edit and Button controls and the layout is as shown in the figure below. Click ViewClassWizard and add the control varibles in the Member Variables tab in the pop-up interface. Instrument address: CString m_strInstrAddr...
Page 120
RIGOL Chapter 4 Programming Demos Encapsulate the write and read operations of VISA. Encapsulate the write operation of VISA for easier operation. bool CDP800_DEMO_VCDlg::InstrWrite(CString strAddr, CString strContent) //write function ViSession defaultRM,instr; ViStatus status; ViUInt32 retCount; char * SendBuf = NULL;...
Page 121
RIGOL Chapter 4 Programming Demos status = viWrite(instr, (unsigned char *)SendBuf, strlen(SendBuf), &retCount); //close the instrument status = viClose(instr); status = viClose(defaultRM); return bWriteOK; Encapsulate the read operation of VISA for easier operation. bool CDP800_DEMO_VCDlg::InstrRead(CString strAddr, CString *pstrResult) //Read from the instrument ViSession defaultRM,instr;...
Page 122
RIGOL Chapter 4 Programming Demos Add the control message response code. Connect the instrument void CDP800_DEMO_VCDlg::OnConnect() // TODO: Add your control notification handler code here ViStatus status; ViSession defaultRM; ViString expr = "?*"; ViPFindList findList = new unsigned long; ViPUInt32 retcnt = new unsigned long;...
Page 123
RIGOL Chapter 4 Programming Demos Write operation void CDP800_DEMO_VCDlg::OnSend() // TODO: Add your control notification handler code here UpdateData(true); if (m_strInstrAddr.IsEmpty()) MessageBox("Please connect to the instrument first!"); InstrWrite(m_strInstrAddr,m_strCommand); m_strResult.Empty(); UpdateData(false); Read operation void CDP800_DEMO_VCDlg::OnRead() // TODO: Add your control notification handler code here UpdateData(true);...
Page 131
Generation Method FixTime On Delay Off Delay Time Base Value Step Stop Condition None Recorder Recorder Switch Record Period Destination C:\REC 10:RIGOL.ROF Analyzer Channel Number Analysis Object Volt Display Curve Current Time Start Time End Time Monitor Channel Monitor Switch Monitor Condition >Volt...
Page 132
RIGOL Chapter 5 Appendix Control Source Trigger Condition OutpClose Output Signal Level Polarity Enable Store Browser Directory File Type StateFile Note*: these parameters don’t change when the instrument is restored to its factory settings (restarting the instrument *RST when “Default” is selected in Utility System PowerOn or sending the command can restore the instrument to its factory settings).
To get repair service, please contact with your nearest RIGOL sales and service office. RIGOL does not provide any other warranty items except the one being provided by this summary and the warranty statement. The warranty items include but not being subjected to the hint guarantee items related to tradable characteristic and any particular purpose.
RIGOL Chapter 5 Appendix Appendix D: Any Question or Comment? If you have any question or comment on our document, please mail to: service@rigol.com 5-10 DP800 Programming Guide...
Need help?
Do you have a question about the DP800 Series and is the answer not in the manual?
Questions and answers