I SO9001:2008 standard and the I SO14001:2004 standard. Other international standard conformance certif ication is in progress. Contact Us I f you have any problem or requirement when using our products or this manual, please contact RIGOL E-mail: service@rigol.com Website: www.rigol.com DP800 Programming Guide www.valuetronics.com...
C+ + , Visual Basic and LabVI EW. 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 “...
Page 5
RIGOL Content Conventions in this Manual: DP800 series programmable linear DC power supply includes the following models. Unless otherwise noted, in this manual, DP831A is taken as an example to illustrate the using method of each DP800 series command. Model...
RIGOL Contents Contents Guaranty and Declaration ......................I Document Overview ......................... I I 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 ........................
Page 10
RIGOL Contents To Trigger the Power Supply ...................... 3-4 To Use the Recorder ........................3-4 To Use the Analyzer ........................3-5 To Use the Monitor ........................3-5 To Use the Trigger ........................3-6 Trigger I nput ........................3-6 Trigger Output ........................3-6 Chapter 4 Programming Demos ..................
Chapter 1 Programming Overview RIGOL Chapter 1 Programming Overview This chapter introduces how to build the remote communication between the PC and instrument and control the power supply remotely. I t also provides an overview of the syntax, symbols, parameter types and abbreviation rules of the SCPI commands and the SCPI status system.
Operation Steps: I nstall the Ultra Sigma common PC softw are Download the Ultra Sigma common PC software from www.rigol.com and install it according to the instructions. Connect the instrument and PC and configure the interface parameters of the instrument DP800 supports USB, LAN, RS232 and GPI B (option, can be extended via the USB-GPI B interface converter) communication interfaces, as shown in the f igure below.
Page 13
Chapter 1 Programming Overview RIGOL (4) Use the GPI B interface: Connect the USB-GPI B interface converter to the USB Host interface at the rear panel of DP800 to extend a GPI B interface. Connect the instrument with your PC using GPI B cable.
Send SCPI Commands via the PC Softw are You can control the power supply remotely by sending SCPI commands via the PC software (Ultra RIGOL . Sigma) provided by Besides, you can also control the instrument using the “Measurement &...
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. Braces { } Usually, multiple optional parameters are enclosed in the braces and one of the parameters must be selected when sending the command.
The status byte register records the advanced summary information reported by other register sets. The SCPI status systems of the DP800 series multi-channel models (take DP831A as an example) and single-channel model are as shown in Figure 1-2 and Figure 1-3 respectively.
Page 17
Chapter 1 Programming Overview RIGOL CH1 Questionable Status SUMMARY Register STATus:QUEStionable:I NSTrument:I SUMmary1 Event Register Enable Register VOLTage CURRent Overvoltage Protection Overcurrent Protection Not used Not used Not used “OR” Not used Not used Not used Not used Not used...
Page 18
* ESE < value> = 256 * ESE? = 512 = 1024 = 2048 = 4096 = 8192 = 16384 = 32768 Figure 1-2 The SCPI Status System of DP800 Series Multi-channel Models (Take DP831A as an Example) DP800 Programming Guide www.valuetronics.com...
Page 19
* ESR? * ESE < value> = 256 * ESE? = 512 = 1024 = 2048 = 4096 = 8192 = 16384 = 32768 Figure 1-3 The SCPI Status System of DP800 Series Single-channel Model (DP811A) DP800 Programming Guide www.valuetronics.com...
RIGOL Chapter 1 Programming Overview Questionable Status Register Questionable Status Register of Multi-channel Models The SCPI status system of the multi-channel models is as shown in Figure 1-2. Wherein, the channel questionable status register indicates in which channel questionable event occurs. While for each specif ic logic output, the channel questionable status SUMMARY register is a pseudo-questionable status register.
Page 21
Chapter 1 Programming Overview RIGOL Table 1-2 Def initions of the bits in the channel questionable status register of the multi-channel model and the decimal values corresponding to their binary weights Decimal Value Definition Not used Always be 0. I NST1 event summary Summary information of CH1 events.
Page 22
RIGOL Chapter 1 Programming Overview Questionable Status Register of Single-channel Model The SCPI status system of the single-channel model is as shown in Figure 1-3. Wherein, the questionable status register provides voltage control, current control, over-temperature, overvoltage, overcurrent and fan failure information. You can send the : STATus:QUEStionable[ :EVENt] ? command to read the register.
Chapter 1 Programming Overview RIGOL Standard Event Register The standard event register reports the following instrument events: power-on detection command syntax error, command execution error, self-test or calibration error, query error or operation complete. All these events or anyone of these events can be reported by the enable register to the bit5 (ESB, Event Summary Bit) of the status byte register.
RIGOL Chapter 1 Programming Overview Status Byte Register The status byte register reports the status information of the other status registers. The bit4 (MAV, Message Available Bit) in the status byte register will report immediately when querying the data waiting to be queried in the output buffer of the power supply.
Chapter 2 Command System RIGOL 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. [ 1] Command List :ANALyzer:ANALyze :ANALyzer:CURRTime :ANALyzer:ENDTime :ANALyzer:FI LE? :ANALyzer:MEMory ...
Chapter 2 Command System RIGOL :ANALyzer:CURRTime Syntax :ANALyzer:CURRTime < value> :ANALyzer:CURRTime? Description Set the current time of the analyzer. Query the current time of the analyzer. Parameter Name Type Range Default Start time to end time of < value> I nteger...
RIGOL Chapter 2 Command System :ANALyzer:ENDTime Syntax :ANALyzer:ENDTime { < value> | MI Nimum| MAXimum} :ANALyzer:ENDTime? [ MI Nimum| MAXimum] Description Set the end time of the analyzer. Query the end time of the analyzer. Parameter Name Type Range Default <...
Chapter 2 Command System RIGOL :ANALyzer:MEMory Syntax :ANALyzer:MEMory { 1| 2| 3| 4| 5| 6| 7| 8| 9| 10} Description Open the specif ied record f ile in the internal memory (C disk). Parameter Name Type Range Default { 1| 2| 3| 4| 5| 6| 7| 8| 9| 10}...
RIGOL Chapter 2 Command System :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 analysis object of the analyzer. Parameter Name Type Range Default { V| C| P}...
Chapter 2 Command System RIGOL :ANALyzer:STARTTime Syntax :ANALyzer:STARTTime { < value> | MI Nimum| MAXimum} :ANALyzer:STARTTime? [ MI Nimum| MAXimum] Description Set the start time of the analyzer. Query the start time of the analyzer. Parameter Name Type Range Default...
RIGOL Chapter 2 Command System :APPLy Command The :APPLy command provides the most straightforward method to program the power supply over the remote interface. For the multi-channel models, you can select the specif ied channel and set the voltage and current in a single command; for the single-channel model, you can set the voltage and current in a single command.
Chapter 2 Command System RIGOL :APPLy Syntax :APPLy { CH1| CH2| CH3} [ ,< volt> | MI Nimum| MAXimum| DEF[ ,< curr> | MI Nimum| MAXimum| DEF] ] :APPLy [ < volt> | MI Nimum| MAXimum| DEF[ ,< curr> | MI Nimum| MAXimum| DEF] ]...
Page 34
RIGOL Chapter 2 Command System (multi-channel models) or current range (single-channel model) when only [ CH1| CH2| CH3] is specif ied, for example, CH1:8V/ 5A,5.000,1.0000. The query returns the voltage setting value and current setting value of the current channel (multi-channel models) or current range (single-channel model) when all the parameters are omitted, for example, 5.000,1.0000.
Chapter 2 Command System RIGOL :DELAY Commands The : DELAY commands are used to set the delayer parameters (such as the number of groups, number of cycles and end state) as well as enable or disable the delayer. Command List: ...
RIGOL Chapter 2 Command System :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 }...
Chapter 2 Command System RIGOL :DELAY:ENDState Syntax :DELAY:ENDState { ON| OFF| LAST} :DELAY:ENDState? Description Set the end state of the delayer. Query the end state of the delayer. Parameter Name Type Range Default { ON| OFF| LAST} Discrete ON| OFF| LAST ...
RIGOL Chapter 2 Command System :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> I nteger 1 to 2048 ...
Chapter 2 Command System RIGOL :DELAY:PARAmeter Syntax :DELAY:PARAmeter < secnum> ,{ ON| OFF} ,< time> :DELAY:PARAmeter? < f irnum> ,< timercount> Description Set the delayer parameters of the specif ied group. Query the delayer parameters of the specif ied groups.
RIGOL Chapter 2 Command System :DELAY[ :STATe] Syntax :DELAY[ :STATe] { ON| OFF} :DELAY[ :STATe] ? Description Enable or disable the delay output function of the current channel. Query the state of the delay output function of the current channel.
RIGOL Chapter 2 Command System :DELAY:TI ME:GEN Syntax :DELAY: TI ME: GEN { FI X| I NC| DEC} [ ,< value0> [ ,< value1> ] ] :DELAY: TI ME: GEN? Description Set the method used to generate time automatically and the corresponding parameters.
NORMal| WAVE| DI AL NORMal Explanation DP800 series power supply provides three display modes (normal, waveform and dial) and the default is normal. NORMal: normal mode. The parameters (such as the voltage and current) of all the channels are displayed in number format.
Chapter 2 Command System RIGOL * ESE Syntax * ESE < enable value> * ESE? Description Enable the bits in the enable register of the standard event register. Query the bits currently enabled in the enable register of the standard event register.
RIGOL Chapter 2 Command System * ESR? Syntax * ESR? Description Query the event register of the standard event register. Explanation This command returns a decimal value (corresponding to the sum of the binary weights of all the bits in the register) and clears the status of this register. For the def initions of the bits in the standard event register and their corresponding decimal values, refer to Table 1-5.
Chapter 2 Command System RIGOL * OPC Syntax * OPC * OPC? Description After executing this command, the bit0 (OPC, “operation complete” bit) in the event register of the standard event register is set. Query whether the * OPC command is executed. The query returns “1” to the output buffer when the command is executed.
RIGOL Chapter 2 Command System * PSC Syntax * PSC { 0| 1} * PSC? Description Enable or disable the function to clear the enable registers of the status byte and standard event registers at power-on. Query the state of the function to clear the enable registers of the status byte and standard event registers at power-on.
Chapter 2 Command System RIGOL * RST Syntax * RST Description Restore the power supply to factory state (refer to “ Appendix B: Factory Setting ”) and clear the error queue. Related :PRESet:KEY Commands :PRESet[ :APPLy] * SAV Syntax * SAV { 1| 2| 3| 4| 5| 6| 7| 8| 9| 10}...
RIGOL Chapter 2 Command System * SRE Syntax * SRE < enable value> * SRE? Description Enable the bits in the enable register of the status byte register. Query the bits currently enabled in the enable register of the status byte register.
Chapter 2 Command System RIGOL * TRG Syntax * TRG Description Generate a trigger operation. Explanation This command is only available when “Bus (software) trigger” (:TRI Gger[ :SEQuence] : SOURce) is selected. When “ Bus (software) trigger” is selected, sending this command will trigger...
RIGOL Chapter 2 Command System :I NI Tiate Command The :I NI Tiate command is used to initialize the trigger system of the instrument. :I NI Tiate Syntax :I NI Tiate[ :I MMediate] Description I nitialize the trigger system. ...
RIGOL Chapter 2 Command System :I NSTrument:NSELect Syntax :I NSTrument:NSELect { 1| 2| 3} :I NSTrument:NSELect? Description Select the current channel. Query the channel currently selected. Parameter Name Type Range Default { 1| 2| 3} Discrete 1| 2| 3 ...
RIGOL Chapter 2 Command System :MEASure:CURRent[ :DC] ? Syntax :MEASure:CURRent[ : DC] ? [ CH1| CH2| CH3] Description Query the current measured on the output terminal of the specif ied channel. Parameter Name Type Range Default [ CH1| CH2| CH3]...
Chapter 2 Command System RIGOL :MEASure[ :VOLTage] [ :DC] ? Syntax :MEASure[ :VOLTage] [ :DC] ? [ CH1| CH2| CH3] Description Query the voltage measured on the output terminal of the specif ied channel. Parameter Name Type Range Default [ CH1| CH2| CH3]...
None Explanation The internal memory of DP800 series power supply can store at most 10 state f iles, 10 record f iles, 10 timer f iles and 10 delay f iles respectively. This command is only available when a f ile has been stored in the specif ied...
Chapter 2 Command System RIGOL :MEMory[ :STATe] :LOAD Syntax :MEMory[ :STATe] : LOAD { RSF| RTF| RDF} ,{ 1| 2| 3| 4| 5| 6| 7| 8| 9| 10} Description Read the specif ied f ile stored in the internal memory, including state f ile (RSF), timer f ile (RTF) and delay f ile (RDF).
RIGOL Chapter 2 Command System :MEMory[ :STATe] :STORe Syntax :MEMory[ :STATe] :STORe { RSF| RTF| RDF} ,{ 1| 2| 3| 4| 5| 6| 7| 8| 9| 10} Description Save the specif ied type of f ile to the specif ied storage location in the internal memory, including state f ile (RSF), timer f ile (RTF) and delay f ile (RDF).
Chapter 2 Command System RIGOL :MMEMory Commands The :MMEMory commands are used to store the f ile to the specif ied external storage directory, read or delete the specif ied f ile in the external memory as well as query the disk information of the external memory.
RIGOL Chapter 2 Command System :MMEMory:CDI Rectory Syntax :MMEMory:CDI Rectory < directory_name> :MMEMory:CDI Rectory? Description Set the current operation directory. Query the current operation directory. Parameter Name Type Range Default < directory_name> ASCI I string Refer to the “Explanation” NULL ...
Chapter 2 Command System RIGOL :MMEMory:DELete Syntax :MMEMory: DELete < f ile_name> Description Delete the specif ied f ile or empty folder under the current operation directory. Parameter Name Type Range Default Filenames of the f iles stored in < f ile_name>...
RIGOL Chapter 2 Command System :MMEMory:LOAD Syntax :MMEMory: LOAD < f ile_name> Description Read the specif ied f ile under the current operation directory. Parameter Name Type Range Default Filenames of the f iles stored < f ile_name> ASCI I string...
Chapter 2 Command System RIGOL :MMEMory:STORe Syntax :MMEMory: STORe < f ile_name> Description Save the f ile with the specif ied f ilename under the current operation directory. Parameter Name Type Range Default < f ile_name> ASCI I string Refer to the “Explanation”...
RIGOL Chapter 2 Command System :MONI tor Commands The :MONI tor commands are used to set the monitor condition and stop mode of the monitor as well as enable or disable the monitor (the current channel). For multi-channel models, the instrument can monitor the output states of multiple channels at the same time.
Chapter 2 Command System RIGOL :MONI tor:CURRent[ :VALue] Syntax :MONI tor:CURRent[ :VALue] { < value> | MI Nimum| MAXimum} :MONI tor:CURRent[ :VALue] ? [ MI Nimum| MAXimum] Description Set the current value of the monitor condition (the current channel). Query the current value of the monitor condition (the current channel).
RIGOL Chapter 2 Command System :MONI tor:POWER[ :VALue] Syntax :MONI tor:POWER[ :VALue] { < value> | MI Nimum| MAXimum} :MONI tor:POWER[ :VALue] ? [ MI Nimum| MAXimum] Description Set the power value of the monitor condition (the current channel). Query the power value of the monitor condition (the current channel).
Chapter 2 Command System RIGOL :MONI tor:STOPw ay Syntax :MONI tor:STOPway { OUTOFF| WARN| BEEPER| NONE} ,{ ON| OFF} :MONI tor:STOPway? Description Set the stop mode of the monitor (the current channel). Query the stop mode of the monitor (the current channel).
RIGOL Chapter 2 Command System :MONI tor:VOLTage:CONDition Syntax :MONI tor:VOLTage:CONDition { < V| > V| NONE} ,{ AND| OR| NONE} :MONI tor:VOLTage:CONDition? Description Set the voltage monitor condition of the monitor (the current channel). Query the voltage monitor condition of the monitor (the current channel).
Chapter 2 Command System RIGOL :MONI tor:VOLTage[ :VALue] Syntax :MONI tor:VOLTage[ :VALue] { < value> | MI Nimum| MAXimum} :MONI tor:VOLTage[ :VALue] ? [ MI Nimum| MAXimum] Description Set the voltage value of the monitor condition (the current channel). Query the voltage value of the monitor condition (the current channel).
(multi-channel models) or range (single-channel model) of different models are as shown in the table below. Table 2-2 Range and default value of overvoltage/ overcurrent protection of each channel (range) of different models of DP800 series Channel Range (Min.
None Explanation DP800 series power supply provides three output modes, including CV (Constant Voltage), CC (Constant Current) and UR (Unregulated). I n CV mode, the output voltage equals the voltage setting value and the output current is determined by the load; in CC mode, the output current equals the current setting value and the output voltage is determined by the load;...
Chapter 2 Command System RIGOL :OUTPut:OCP:CLEAR Syntax :OUTPut:OCP:CLEAR [ CH1| CH2| CH3] Description Clear the label of the overcurrent protection occurred on the specif ied channel. Parameter Name Type Range Default [ CH1| CH2| CH3] Discrete CH1| CH2| CH3 None ...
RIGOL Chapter 2 Command System :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 (OCP) function of the specif ied channel. Query the status of the overcurrent protection (OCP) function of the specif ied channel.
Chapter 2 Command System RIGOL :OUTPut:OVP:CLEAR Syntax :OUTPut:OVP:CLEAR [ CH1| CH2| CH3] Description Clear the label of the overvoltage protection occurred on the specif ied channel. Parameter Name Type Range Default [ CH1| CH2| CH3] Discrete CH1| CH2| CH3 None ...
RIGOL Chapter 2 Command System :OUTPut:RANGe Syntax :OUTPut:RANGe { P20V| P40V| LOW| HI GH} :OUTPut:RANGe? Description Select the range of the channel. Query the range currently selected of the channel. Parameter Name Type Range Default { P20V| P40V| LOW| HI GH}...
Chapter 2 Command System RIGOL :OUTPut:SENSe Syntax :OUTPut: SENSe [ CH1| CH2| CH3,] { ON| OFF} :OUTPut: SENSe? [ CH1| CH2| CH3] Description Enable or disable the Sense function of the channel. Query the status of the Sense function of the channel.
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 specif ied channel. Query the status of the track function of the specif ied channel.
DP832A/ DP832) of the user-def ined setting. The default voltage/ current values of each channel in the user-def ined setting of different models of DP800 series are as shown in the table below. Table 2-3 Default voltage/ current values of each channel in the user-def ined setting of different models of...
Chapter 2 Command System RIGOL :PRESet:KEY Syntax :PRESet:KEY { DEFAULT| USER1| USER2| USER3| USER4} :PRESet:KEY? Description Def ine the setting recalled by Preset at the front panel. Preset Query the setting recalled by at the front panel. Parameter Name Type...
RIGOL Chapter 2 Command System :PRESet:USER[ < n> ] :SET:CURRent Syntax :PRESet:USER[ < n> ] : SET:CURRent { < current> | MI Nimum| MAXimum} :PRESet:USER[ < n> ] : SET:CURRent? [ MI Nimum| MAXimum] Description Set the current value of the current channel in the specif ied user-def ined setting.
Chapter 2 Command System RIGOL :PRESet:USER[ < n> ] :SET:DEFault Syntax :PRESet:USER[ < n> ] : SET:DEFault Description Restore the parameters of the specif ied user-def ined setting to default values. Parameter Name Type Range Default [ < n> ]...
RIGOL Chapter 2 Command System :PRESet:USER[ < n> ] :SET:OCP Syntax :PRESet:USER[ < n> ] : SET:OCP { ON| OFF} [ ,< current> | MI Nimum| MAXimum] :PRESet:USER[ < n> ] : SET:OCP? [ MI Nimum| MAXimum] Description Enable or disable the overcurrent protection (OCP) function of the current channel in the specif ied user-def ined setting and set the overcurrent protection value.
RIGOL Chapter 2 Command System :PRESet:USER[ < n> ] :SET:OVP Syntax :PRESet:USER[ < n> ] : SET:OVP { ON| OFF} [ ,< voltage> | MI Nimum| MAXimum] :PRESet:USER[ < n> ] : SET:OVP? [ MI Nimum| MAXimum] Description Enable or disable the overvoltage protection (OVP) function of the current channel in the specif ied user-def ined setting and set the overvoltage protection value.
Chapter 2 Command System RIGOL :PRESet:USER[ < n> ] :SET:SURE Syntax :PRESet:USER[ < n> ] : SET:SURE Description Conf irm the parameter and status settings of the specif ied user-def ined setting. Parameter Name Type Range Default [ < n> ]...
RIGOL Chapter 2 Command System :PRESet:USER[ < n> ] :SET:VOLTage Syntax :PRESet:USER[ < n> ] : SET:VOLTage { < voltage> | MI Nimum| MAXimum} :PRESet:USER[ < n> ] : SET:VOLTage? [ MI Nimum| MAXimum] Description Set the voltage of the current channel of the specif ied user-def ined setting.
Chapter 2 Command System RIGOL :RECorder Commands Command List: :RECorder:DESTination? :RECorder:MEMory :RECorder:MMEMory :RECorder:PERI od :RECorder[ :STATe] :RECorder:DESTination? Syntax :RECorder:DESTination? Description Query the storage directory of the record f ile. Explanation Before enabling the recorder, use the...
RIGOL Chapter 2 Command System :RECorder:MEMory Syntax :RECorder:MEMory { 1| 2| 3| 4| 5| 6| 7| 8| 9| 10} ,< f ilename> Description Store the record f ile to the specif ied storage location in the internal memory with the specif ied f ilename.
Chapter 2 Command System RIGOL :RECorder:MMEMory Syntax :RECorder:MMEMory < dest> Description Store the record f ile to the specif ied storage directory in the external memory. Parameter Name Type Range Default < dest> ASCI I string Valid 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 ...
Chapter 2 Command System RIGOL :SOURce Commands The :SOURce commands are used to set the voltage, current, OVP and OCP values of the specif ied channel. 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.
Chapter 2 Command System RIGOL [ :SOURce[ < n> ] ] :CURRent:PROTection:CLEar Syntax [ :SOURce[ < n> ] ] :CURRent: PROTection:CLEar Description Clear the circuit and label of the OCP occurred on the specif ied channel and turn on the output of the corresponding channel.
RIGOL Chapter 2 Command System [ :SOURce[ < n> ] ] :VOLTage:PROTection:CLEar Syntax [ :SOURce[ < n> ] ] :VOLTage: PROTection:CLEar Description Clear the circuit and label of the OVP occurred on the corresponding channel and turn on the output of the corresponding channel.
RIGOL Chapter 2 Command System :STATus:QUEStionable:ENABle Syntax :STATus:QUEStionable:ENABle < enable value> :STATus:QUEStionable:ENABle? Description Enable the bits in the enable register of the questionable status register. Query the bits currently enabled in the enable register of the questionable status register. Parameter...
Chapter 2 Command System RIGOL :STATus:QUEStionable[ :EVENt] ? Syntax :STATus:QUEStionable[ :EVENt] ? Description Query the event register of the questionable status register. Explanation This command returns a decimal value (corresponding to the sum of the binary weights of all the bits in the register) and clears the status of the register. For...
RIGOL Chapter 2 Command System :STATus:QUEStionable:I NSTrument:ENABle Syntax :STATus:QUEStionable:I NSTrument:ENABle < enable value> :STATus:QUEStionable:I NSTrument:ENABle? Description Enable the bits in the enable register of the channel questionable status register. Query the bits enabled in the enable register of the channel questionable status register.
Chapter 2 Command System RIGOL :STATus:QUEStionable:I NSTrument[ :EVENt] ? Syntax :STATus:QUEStionable:I NSTrument[ :EVENt] ? Description Query the event register of the channel questionable status register. Explanation This command is only applicable to multi-channel models. This command returns a decimal value (corresponding to the sum of the binary weights of all the bits in the register) and clears the status of the register.
Chapter 2 Command System RIGOL :SYSTem:BEEPer[ :I MMediate] Syntax :SYSTem:BEEPer[ :I MMediate] Description Send this command and the beeper immediately 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.
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:GPI B:ADDRess Syntax :SYSTem:COMMunicate:GPI B:ADDRess < gpibaddress> :SYSTem:COMMunicate:GPI B:ADDRess? Description Set the GPI B address. Query the current GPI B address. Parameter Name Type Range Default < gpibaddress> I nteger 0 to 30 Explanation Before using the GPI B interface, extend a GPI B interface using the USB-GPI B interface converter;...
Chapter 2 Command System RIGOL :SYSTem:COMMunicate:LAN:AUTOip[ :STATe] Syntax :SYSTem:COMMunicate:LAN:AUTOip[ :STATe] { ON| OFF} :SYSTem:COMMunicate:LAN:AUTOip[ :STATe] ? Description Enable or disable the auto I P conf iguration mode. Query the status of the auto I P conf iguration mode. Parameter Name...
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}...
Chapter 2 Command System RIGOL :SYSTem:COMMunicate:LAN:DNS Syntax :SYSTem:COMMunicate:LAN: DNS < dns> :SYSTem:COMMunicate:LAN: DNS? Description Set the DNS (Domain Name Service) address. Query the current DNS address. Parameter Name Type Range Default < dns> ASCI I string Refer to the “Explanation”...
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN:GATEw ay 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 < gateway> ASCI I string Refer to the “Explanation” None ...
Chapter 2 Command System RIGOL :SYSTem:COMMunicate:LAN:I PADdress Syntax :SYSTem:COMMunicate:LAN:I PADdress < ip> :SYSTem:COMMunicate:LAN:I PADdress? Description Set the I P address. Query the current I P address. Parameter Name Type Range Default < ip> ASCI I string Refer to the “Explanation”...
RIGOL Chapter 2 Command System :SYSTem:COMMunicate:LAN:MANualip[ :STATe] Syntax :SYSTem:COMMunicate:LAN:MANualip[ :STATe] { ON| OFF} :SYSTem:COMMunicate:LAN:MANualip[ :STATe] ? Description Enable or disable the manual I P conf iguration mode. Query the status of the manual I P conf iguration mode. Parameter Name...
Chapter 2 Command System RIGOL :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 < submask> ASCI I string Refer to the “Explanation” None Explanation...
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}...
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. Query the current stop bit. Parameter Name Type Range Default { 1| 2} Discrete 1| 2 Return Format The query returns 1 or 2.
RIGOL Chapter 2 Command System :SYSTem:KLOCk[ :STATe] Syntax :SYSTem:KLOCk[ : STATe] { ON| OFF} :SYSTem:KLOCk[ : STATe] ? Description Enable or disable the remote lock. Query the status of the remote lock. Parameter Name Type Range Default { ON| OFF}...
Chapter 2 Command System RIGOL :SYSTem:LOCal Syntax :SYSTem: LOCal Description The power supply returns from remote mode to local mode. Explanation When the instrument is in remote mode, all the front panel keys (except the Back output switch key...
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...
Chapter 2 Command System RIGOL :SYSTem:REMote Syntax :SYSTem: REMote Description Return the power supply from local mode to remote mode. Explanation When the instrument is in local mode, all the front panel keys are available and is not displayed in the status bar in the user interface. Executing this command will return the instrument from local mode to remote mode;...
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...
Chapter 2 Command System RIGOL :SYSTem:SELF:TEST:TEMP? Syntax :SYSTem:SELF: TEST: TEMP? Description Query the self-test result of the temperature. ℃ Return Format The query returns the temperature value and the unit is , for example, 23.67. :SYSTem:VERSion? Syntax :SYSTem: VERSion? Description Query the SCPI version number of the system.
Chapter 2 Command System RIGOL :TI MEr:CYCLEs Syntax :TI MEr:CYCLEs { N| I } [ ,< value> ] :TI MEr:CYCLEs? Description Set the number of cycles of the timer. Query the current number of cycles of the timer. Parameter Name...
RIGOL Chapter 2 Command System :TI MEr:ENDState Syntax :TI MEr:ENDState { OFF| LAST} :TI MEr:ENDState? Description Set the end state of the timer. Query the current end state of the timer. Parameter Name Type Range Default { OFF| LAST} Discrete OFF| LAST ...
Chapter 2 Command System RIGOL :TI MEr:GROUPs Syntax :TI MEr:GROUPs < value> :TI MEr: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>...
RIGOL Chapter 2 Command System :TI MEr:PARAmeter Syntax :TI MEr:PARAmeter < secnum> ,< volt> ,< curr> ,< time> :TI MEr:PARAmeter? < f irnum> ,< timercount> Description Set the timer parameters of the specif ied group. Query the timer parameters of the specif ied groups.
Chapter 2 Command System RIGOL :TI MEr[ :STATe] :TI MEr[ :STATe] { ON| OFF} Syntax :TI MEr[ :STATe] ? Description Enable or disable the timing output function. Query the status of the timing output function. Parameter Name Type Range Default...
RIGOL Chapter 2 Command System :TI MEr:TEMPlet:FALLRate Syntax :TI MEr:TEMPlet:FALLRate < value> :TI MEr:TEMPlet:FALLRate? Description Set the fall index of ExpFall. Query the fall index of ExpFall. Parameter Name Type Range Default < value> I nteger 0 to 10 Explanation...
Chapter 2 Command System RIGOL :TI MEr:TEMPlet:I NVErt Syntax :TI MEr:TEMPlet:I NVErt { ON| OFF} :TI MEr:TEMPlet:I NVErt? Description Enable or disable the invert function of the templet currently selected. Query whether the invert function of the templet currently selected is enabled.
For the DP800 series (except CH3 (-30V/ 2A) of DP831A), the maximum voltage and current of all the templets are 1V and 1A. For CH3 (-30V/ 2A) of DP831A, the maximum voltage and current of all the templets are -1V and 1A.
Chapter 2 Command System RIGOL :TI MEr:TEMPlet:MI NValue Syntax :TI MEr:TEMPlet:MI NValue { < value> | MI Nimum| MAXimum} :TI MEr:TEMPlet:MI NValue? [ MI Nimum| MAXimum] Description Set the minimum voltage or current of the templet currently selected. Query the minimum voltage or current of the templet currently selected.
RIGOL Chapter 2 Command System :TI MEr:TEMPlet:OBJect Syntax :TI MEr:TEMPlet:OBJect { V| C} [ ,< value> | MI Nimum| MAXimum] :TI MEr:TEMPlet:OBJect? [ MI Nimum| MAXimum] Description Select the editing object of the templet and set the current or voltage.
Chapter 2 Command System RIGOL :TI MEr:TEMPlet:PERI od Syntax :TI MEr:TEMPlet:PERI od < value> :TI MEr:TEMPlet:PERI od? Description Set the period of Pulse. Query the period of Pulse. Parameter Name Type Range Default < value> I nteger 2s to 99999s ...
RIGOL Chapter 2 Command System :TI MEr:TEMPlet:RI SERate Syntax :TI MEr:TEMPlet:RI SERate < value> :TI MEr:TEMPlet:RI SERate? Description Set the rise index of ExpRise. Query the rise index of ExpRise. Parameter Name Type Range Default < value> I nteger 0 to 10...
Chapter 2 Command System RIGOL :TI MEr:TEMPlet:SYMMetry Syntax :TI MEr:TEMPlet:SYMMetry < value> :TI MEr:TEMPlet:SYMMetry? Description Set the symmetry of RAMP . Query the symmetry of RAMP . Parameter Name Type Range Default < value> I nteger 0% to 100% Explanation Symmetry refers to the ratio of the duration of the rising edge within a period to the whole period.
RIGOL Chapter 2 Command System :TRI Gger:I N:SENSitivity Syntax :TRI Gger:I N: SENSitivity [ D0| D1| D2| D3,] { LOW| MI D| HI GH} :TRI Gger:I N: SENSitivity? [ D0| D1| D2| D3] Description Set the trigger sensitivity of the trigger input of the specif ied data line.
Chapter 2 Command System RIGOL :TRI Gger:I N:TYPE Syntax :TRI Gger:I N: TYPE [ D0| D1| D2| D3,] { RI SE| FALL| HI GH| LOW} :TRI Gger:I N: TYPE? [ D0| D1| D2| D3] Description Set the trigger type of the trigger input of the specif ied data line.
Chapter 2 Command System RIGOL :TRI Gger:OUT:DUTY Syntax :TRI Gger:OUT: DUTY [ D0| D1| D2| D3,] < value> :TRI Gger:OUT: DUTY? [ D0| D1| D2| D3] Description Set the duty cycle of the square waveform of the trigger output on the specif ied data line.
Chapter 2 Command System RIGOL :TRI Gger:OUT:PERI od Syntax :TRI Gger:OUT:PERI od [ D0| D1| D2| D3,] < value> :TRI Gger:OUT:PERI od? [ D0| D1| D2| D3] Description Set the period of the square waveform of the trigger output on the specif ied data line.
RIGOL Chapter 2 Command System :TRI Gger:OUT:POLArity Syntax :TRI Gger:OUT:POLArity [ D0| D1| D2| D3,] { POSI tive| NEGAtive} :TRI Gger:OUT:POLArity? [ D0| D1| D2| D3] Description Set the polarity of the trigger output signal of the specif ied data line.
Chapter 2 Command System RIGOL :TRI Gger:OUT:SI GNal Syntax :TRI Gger:OUT:SI GNal [ D0| D1| D2| D3,] { LEVEL| SQUARE} :TRI Gger:OUT:SI GNal? [ D0| D1| D2| D3] Description Set the type of the trigger output signal of the specif ied data line.
RIGOL Chapter 2 Command System :TRI Gger[ :SEQuence] :DELay Syntax :TRI Gger[ :SEQuence] :DELay { < seconds> | MI N| MAX} :TRI Gger[ :SEQuence] :DELay? Description Set the trigger delay. Query the current trigger delay. Parameter Name Type Range Default <...
Chapter 2 Command System RIGOL :TRI Gger[ :SEQuence] :SOURce Syntax :TRI Gger[ :SEQuence] :SOURce { BUS| I MM} :TRI Gger[ :SEQuence] :SOURce? Description Select the trigger source. Query the trigger source currently selected. Parameter Name Type Range Default { BUS| I MM}...
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: 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 value to 5.3A. Method 1...
Chapter 3 Application Examples RIGOL 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;...
RIGOL Chapter 3 Application Examples To Trigger the Pow er Supply Requirement Use the SCPI commands to realize the following functions: Set the trigger source to “BUS” and the delay time to 3s. Set the trigger voltage and trigger current of CH1 to 3V and 1A.
Chapter 3 Application Examples RIGOL To Use the Analyzer Requirement Use the SCPI commands to realize the following functions: Open the C:\ REC 1:RI GOL.ROF f ile; set the start time to 1s (it is assumed that the record period of C:\ REC 1:RI GOL.ROF is 1s.
RIGOL Chapter 3 Application Examples To Use the Trigger Trigger I nput 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 edge, the output response to ON and the trigger sensitivity to low.
Chapter 4 Programming Demos RIGOL Chapter 4 Programming Demos This chapter provides the demos for programming and controlling the power supply using SCPI commands under Excel, Matlab, LabVI EW, Visual Basic and Visual C+ + environment on the basis of NI -VI SA.
Before programming, you need to make the following preparations: I nstall the Ultra Sigma common PC software. Please download this software from www.rigol.com and install it according to the instructions. After installing the Ultra Sigma, the NI -VI SA library will be installed automatically.
Chapter 4 Programming Demos RIGOL Excel Programming Demo The program used in this demo: Microsoft Excel 2010 The function realized in this demo: send the * I DN? Command to read the device information. Create a new Excel f ile that enables the Macros. I n this demo, the f ile is named as DP800_Demo_Excel.xlsm.
Page 178
RIGOL Chapter 4 Programming Demos Select Tools( T) in the Microsoft Visual Basic menu bar and click References Select VI SA Library in the pop-up dialog box and click to refer to the VI SA Library. Explanation: I f you cannot f ind VI SA Library in the list at the left of the f igure above, please follow the method below to f ind it.
Page 179
Chapter 4 Programming Demos RIGOL Click View Code in the Developer menu to enter the Microsoft Visual Basic interface. Add the following codes and save the f ile. Note: I f 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”...
Page 180
RIGOL Chapter 4 Programming Demos Click * I DN? to run the program. DP800 Programming Guide www.valuetronics.com...
Chapter 4 Programming Demos RIGOL 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. Current Directory Run the Matlab software and modify the current directory (namely modify the the top of the software).
RIGOL Chapter 4 Programming Demos LabVI EW Programming Demo The program used in this demo: LabVI EW 2009 The functions realized in this demo: search for the instrument address, connect the instrument, send command and read the return value. Run LabVI EW 2009, create a VI f ile and name it as DP800_Demo_LABVI EW.
Page 185
Chapter 4 Programming Demos RIGOL (4) Exit: Run the program and the interface as shown in the f igure below is displayed. Click the Address dropdown box and select the VI SA resource name; click Connect to connect the instrument; enter the...
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 by taking DP831A as an example.
Page 187
Chapter 4 Programming Demos RIGOL 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 189
Chapter 4 Programming Demos RIGOL Add the Text Edit Button controls and the layout is as shown in the f igure below. View ClassWizard Click and add the control variables in the Member Variables tab in the pop-up interface. I nstrument address: CString m_strI nstrAddr...
Page 190
RIGOL Chapter 4 Programming Demos Encapsulate the write and read operations of VI SA. Encapsulate the write operation of VI SA for easier operation. bool CDP800_DEMO_VCDlg::I nstrWrite(CString strAddr, CString strContent) / / write function ViSession defaultRM,instr; ViStatus status; ViUI nt32 retCount;...
Page 191
Chapter 4 Programming Demos RIGOL 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 VI SA for easier operation. bool CDP800_DEMO_VCDlg::I nstrRead(CString strAddr, CString * pstrResult) / / Read from the instrument ViSession defaultRM,instr;...
Page 192
RIGOL Chapter 4 Programming Demos Add the control message response code. Connect the instrument void CDP800_DEMO_VCDlg::OnConnect() / / TODO: Add your control notif ication handler code here ViStatus status; ViSession defaultRM; ViString expr = "?* "; ViPFindList f indList = new unsigned long;...
Page 193
Chapter 4 Programming Demos RIGOL Write operation void CDP800_DEMO_VCDlg::OnSend() / / TODO: Add your control notif ication handler code here UpdateData(true); if (m_strI nstrAddr.I sEmpty()) MessageBox("Please connect to the instrument f irst!"); I nstrWrite(m_strI nstrAddr,m_strCommand); m_strResult.Empty(); UpdateData(false); Read operation void CDP800_DEMO_VCDlg::OnRead() / / TODO: Add your control notif ication handler code here UpdateData(true);...
Chapter 5 Appendix RIGOL Appendix B: Factory Setting Note: These parameters with * don’t change when the instrument is restored to its factory settings Utility System Pow erOn (restarting the instrument when “ Default ” is selected in or sending the * RST command can restore the instrument to its factory settings).
Page 202
RIGOL Chapter 5 Appendix CH1: 00.000V/ 1.0000A Voltage/ Current Setting Values CH2: 0.000V/ 10.000A CH1: 66.000V/ 1.1000A Voltage/ Current Limits CH2: 8.800V/ 11.000A CH1: Off/ Off OVP/ OCP On/ Off CH2: Off/ Off DP821A CH1: Off Output On/ Off CH2: Off...
Page 203
Chapter 5 Appendix RIGOL Manual I P Timer Channel Timer On/ Off Output Groups Timer Parameters Volt: 1V; Curr: 1A; Set: 1s Cycles End State Output Off Templet Sine Sine Object Voltage Current Max Value Min Value Points I nterval...
Page 204
RIGOL Chapter 5 Appendix Mode Average Variance Range Min Value Max Value Mead Deviation Monitor Channel Monitor Switch Monitor Condition > Volt Voltage Half of the rated value of CH1 (for DP811A, it is half of the rated value of...
Chapter 5 Appendix RIGOL Appendix C: Warranty warrants that its products mainframe and accessories will be free from defects in materials and RIGOL workmanship within the warranty period. I f a product is proven to be defective within the respective period,...
Need help?
Do you have a question about the DP800 Series and is the answer not in the manual?
Questions and answers