Rigol DL3000 Series Programming Manual
  1. Manuals
  2. Brands
  3. Rigol Manuals
  4. Test Equipment
  5. DL3000 Series
  6. Programming manual

Rigol DL3000 Series Programming Manual

Programmable dc electronic load
Hide thumbs Also See for DL3000 Series:
Table of Contents

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the DL3000 Series and is the answer not in the manual?

Questions and answers

Related Manuals for Rigol DL3000 Series

Summary of Contents for Rigol DL3000 Series

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

  • Page 3: Guaranty And Declaration

    Notices RIGOL products are covered by P.R.C. and foreign patents, issued and pending.  RIGOL reserves the right to modify or change parts of or all the specifications and pricing policies at  the company’s sole decision. Information in this publication replaces all previously released materials.

  • Page 4: Document Overview

    RIGOL Document Overview This manual is your guide to programming the RIGOL DL3000 series programmable DC power supply. Main Topics in this Manual: Chapter 1 Programming Overview This chapter introduces how to set up remote communication between the electronic load and the PC, the remote control methods, the syntax, symbols, parameters, and abbreviation rules of the SCPI commands.

  • Page 5: Table Of Contents

    RIGOL Contents Contents Guaranty and Declaration ......................I Document Overview ......................... II Chapter 1 Programming Overview..................1-1 To Build Remote Communication ....................1-2 Remote Control Method ......................1-3 SCPI Command Overview ......................1-4 Syntax ..........................1-4 Symbol Description ......................1-4 Parameter Type ........................
  • Page 6 RIGOL Contents :MEASure:POWer[:DC]? ....................2-15 :FETCh:CAPability? ......................2-15 :MEASure:CAPability? ......................2-15 :FETCh:WATThours? ......................2-15 :MEASure:WATThours? ..................... 2-15 :FETCh:DISChargingTime? ....................2-16 :MEASure:DISChargingTime? .................... 2-16 :FETCh:TIME? ........................2-16 :MEASure:TIME? ......................2-16 :FETCh:WAVedata? ......................2-16 :MEASure:WAVedata? ....................... 2-16 :TRIGger Commands ....................... 2-17 :TRIGger.......................... 2-17 :TRIGger:SOURce ......................
  • Page 7 RIGOL Contents [:SOURce]:BATTary:TIMestop ................... 2-38 [:SOURce]:BATTary:VON ....................2-39 [:SOURce]:BATTary:VENabstop ..................2-39 [:SOURce]:BATTary:CENabstop ..................2-39 [:SOURce]:BATTary:TENabstop ..................2-40 [:SOURce]:OCP:RANGe ....................2-40 [:SOURce]:OCP:VON ......................2-40 [:SOURce]:OCP:VONDelay ....................2-41 [:SOURce]:OCP:ISET ......................2-41 [:SOURce]:OCP:ISTep ...................... 2-42 [:SOURce]:OCP:IDELaystep ....................2-42 [:SOURce]:OCP:IMAX ....................... 2-42 [:SOURce]:OCP:IMIN ....................... 2-43 [:SOURce]:OCP:VOCP ......................

  • Page 9: Chapter 1 Programming Overview

    RIGOL Chapter 1 Programming Overview Chapter 1 Programming Overview This chapter introduces how to set up remote communication between the electronic load and the PC, the remote control methods, the syntax, symbols, parameters, and abbreviation rules of the SCPI commands.

  • Page 10: To Build Remote Communication

    Chapter 1 Programming Overview To Build Remote Communication DL3000 series electronic load can communicate with the PC via USB, LAN (option), RS232, or GPIB (extended using the USB-GPIB module) interface. Note: The RS232 protocol command ends with "\r\n" for the DL3000 series.

  • Page 11: Remote Control Method

    Chapter 4 in this manual. Send SCPI commands via the PC software You can use the PC software to send commands to control DL3000 remotely. RIGOL Ultra Sigma is recommended. You can download the software from RIGOL official website (www.rigol.com).

  • Page 12: Scpi Command Overview

    RIGOL Chapter 1 Programming Overview SCPI Command Overview SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming language that is built upon the existing standard IEEE 488.1 and IEEE 488.2 and conforms to various standards, such as the floating point operation rule in IEEE 754 standard, ISO 646 7-bit coded character set for information interchange (equivalent to ASCII programming).

  • Page 13: Parameter Type

    RIGOL Chapter 1 Programming Overview Parameter Type The parameters contained in this manual can be divided into the following five types: Bool, Integer, Real, Discrete, and ASCII String. Bool The parameter can be set to ON (1) or OFF (0).

  • Page 14: Scpi Status Register

    The status byte register is used to record advanced summary information, which is reported by other registers. The SCPI status system of the DL3000 is shown in Figure 1-2. Figure 1-2 SCPI Status System of the DL3000 Series DL3000 Programming Guide...

  • Page 15: Questionable Status Register

    RIGOL Chapter 1 Programming Overview Questionable Status Register The SCPI status system of the DL3000 is shown in Figure 1-2. The questionable status register monitors the overall instrument condition, such as voltage/current control, OTP, OVP, OCP, and fan failure. You can send :STATus:QUEStionable[:EVENt]? command to read the register.

  • Page 16: Standard Event Status Register

    RIGOL Chapter 1 Programming Overview Standard Event Status Register The standard event status register records the following events that might occur on your instrument: power-on inspection, command syntax error, command execution error, self-test/calibration error, query error, or operation completed. All these events or any one of the events can be reported to Bit 5 (ESB, Event Summary Bit) of status byte register via the enable register.
  • Page 17 RIGOL Chapter 1 Programming Overview Table 1-3 Definitions for the bits in the status byte register and the decimal value that corresponds to the binary-weighted value Weight Name Description Not used Not used This bit is always set to 0.

  • Page 19: Chapter 2 Command System

    RIGOL Chapter 2 Command System Chapter 2 Command System This chapter introduces the syntax, function, parameters, and usage of each command. Contents in this chapter: IEEE 488.2 Common Commands  :STATus Commands  :MEASure commands and :FETCh commands  :TRIGger Commands ...

  • Page 20: Ieee 488.2 Common Commands

    RIGOL Chapter 2 Command System IEEE 488.2 Common Commands Command List: *CLS  *ESE  *ESR?  *IDN?  *OPC  *OPT?  *PSC  *RST  *SRE  *STB?  *TRG  *TST?  *WAI  *CLS Syntax *CLS Description Clears all the event registers.

  • Page 21: Ese

    RIGOL Chapter 2 Command System *ESE Syntax *ESE <enable value> *ESE? Description Enables the bit in the enable register part of the standard event status register. Queries the enabled bit in the enable register part of the standard event status register.

  • Page 22: Esr

    RIGOL Chapter 2 Command System *ESR? Syntax *ESR? Description Queries the event status register of the standard event status register. Remarks The query returns a decimal value. It corresponds to the binary-weighted sum of all  the bits in the enable register part of the standard event status register. The command also clears the status of the register.

  • Page 23: Opc

    RIGOL Chapter 2 Command System *OPC Syntax *OPC *OPC? Description After you run the command, Bit 0 (operation complete bit) in the event register part of the standard event status register is set to 1. Queries whether the *OPC command has been executed. If yes, it returns "1" in the output buffer.

  • Page 24: Psc

    RIGOL Chapter 2 Command System *PSC Syntax *PSC {0|1} *PSC? Description Enables (1) or disables (0) clearing of the enable register part of the status byte register and the standard event status register at power-on. Queries the state of enable register part when clearing of the enable register part of the status byte register and the standard event status register at power-on.

  • Page 25: Sre

    RIGOL Chapter 2 Command System *SRE Syntax *SRE <enable value> *SRE? Description Enables bits in the enable register part of the status byte register. Queries the bit enabled in the enable register part of the status byte register. The parameter <enable value> is a decimal value. It corresponds to the Remarks ...

  • Page 26: Trg

    RIGOL Chapter 2 Command System *TRG Syntax *TRG Description Generates a trigger action. Remarks The command is only applicable to the trigger system with the bus (software) trigger  source (:STATus:QUEStionable:CONDition?) being selected. After you select the bus (software) trigger source, sending the command will trigger ...

  • Page 27: Status Commands

    RIGOL Chapter 2 Command System :STATus Commands Command List: :STATus:QUEStionable:CONDition?  :STATus:QUEStionable:ENABle  :STATus:QUEStionable[:EVENt]?  :STATus:PRESet  :STATus:OPERation:CONDition?  :STATus:OPERation:ENABle  :STATus:OPERation[:EVENt]?  :STATus:QUEStionable:CONDition? Syntax :STATus:QUEStionable:CONDition? Description Queries the condition register of the questionable status register. Remarks The query returns a decimal value. It corresponds to the binary-weighted sum of all the bits in the register.

  • Page 28: Status:questionable:enable

    RIGOL Chapter 2 Command System :STATus:QUEStionable:ENABle Syntax :STATus:QUEStionable:ENABle <enable value> :STATus:QUEStionable:ENABle? Description Enables bits in the enable register part of the questionable status register. Queries the bit enabled in the enable register part of the questionable status register. Parameter Name...

  • Page 29: Status:preset

    RIGOL Chapter 2 Command System :STATus:PRESet Syntax :STATus:PRESet Description Clears all the bits in the event register part of the questionable status register. Remarks The event registers that have been cleared include query event enable register, channel summary event enable register, and operation event enable register. Other registers will not be affected by the command.

  • Page 30: Status:operation:enable

    RIGOL Chapter 2 Command System :STATus:OPERation:ENABle Syntax :STATus:OPERation:ENABle <enable value> :STATus:OPERation:ENABle? Description Enables bits in the operation enable register of the questionable status register. Queries the bit enabled in the operation enable register of the questionable status register. Parameter Name...

  • Page 31: Measure Commands And :Fetch Commands

    RIGOL Chapter 2 Command System :MEASure commands and :FETCh commands Command List: :FETCh:VOLTage[:DC]?  :MEASure:VOLTage[:DC]?  :FETCh:VOLTage:MAX?  :MEASure:VOLTage:MAX?  :FETCh:VOLTage:MIN?  :MEASure:VOLTage:MIN?  :FETCh:CURRent[:DC]?  :MEASure:CURRent[:DC]?  :FETCh:CURRent:MAX?  :MEASure:CURRent:MAX?  :FETCh:CURRent:MIN?  :MEASure:CURRent:MIN?  :FETCh:RESistance[:DC]?  :MEASure:RESistance[:DC]? ...

  • Page 32: Fetch:voltage:max

    RIGOL Chapter 2 Command System :FETCh:VOLTage:MAX? :MEASure:VOLTage:MAX? Syntax :FETCh:VOLTage:MAX? :MEASure:VOLTage:MAX? Description Reads the maximum input voltage of the instrument. Return The query returns a real number. Format :FETCh:VOLTage:MIN? :MEASure:VOLTage:MIN? Syntax :FETCh:VOLTage:MIN? :MEASure:VOLTage:MIN? Description Reads the minimum input voltage of the instrument.

  • Page 33: Fetch:resistance[:Dc]

    RIGOL Chapter 2 Command System :FETCh:RESistance[:DC]? :MEASure:RESistance[:DC]? Syntax :FETCh:RESistance[:DC]? :MEASure:RESistance[:DC]? Description Reads the resistance of the instrument. Return The query returns a real number. Format Related [:SOURce]:RESistance[:LEVel][:IMMediate] Command :FETCh:POWer[:DC]? :MEASure:POWer[:DC]? Syntax :FETCh:POWer[:DC]? :MEASure:POWer[:DC]? Description Reads the input power of the instrument.

  • Page 34: Fetch:dischargingtime

    RIGOL Chapter 2 Command System :FETCh:DISChargingTime? :MEASure:DISChargingTime? Syntax :FETCh:DISChargingTime? :MEASure:DISChargingTime? Description Reads the discharge time of the battery. Return The query returns a real number. Format :FETCh:TIME? :MEASure:TIME? Syntax :FETCh:TIME? :MEASure:TIME? Description Reads the integration time of the instrument. Return It is the integration time of 10 PLC.

  • Page 35: Trigger Commands

    RIGOL Chapter 2 Command System :TRIGger Commands Command List: :TRIGger  :TRIGger:SOURce  :TRIGger Syntax :TRIGger[:IMMediate] Description When SCPI command trigger (Bus) is selected to be the trigger source, running the command will immediately initiate a trigger. Related :TRIGger:SOURce Command...

  • Page 36: [:Source] Commands

    RIGOL Chapter 2 Command System [:SOURce] Commands Command List: [:SOURce]:INPut  [:SOURce]:FUNCtion  [:SOURce]:FUNCtion:MODE  [:SOURce]:TRANsient  [:SOURce]:CURRent[:LEVel][:IMMediate]  [:SOURce]:CURRent:RANGe  [:SOURce]:CURRent:SLEW  [:SOURce]:CURRent:SLEW:POSitive  [:SOURce]:CURRent:SLEW:NEGative  [:SOURce]:CURRent:VON  [:SOURce]:CURRent:VLIMt  [:SOURce]:CURRent:ILIMt  [:SOURce]:CURRent:TRANsient:MODE  [:SOURce]:CURRent:TRANsient:ALEVel  [:SOURce]:CURRent:TRANsient:BLEVel  [:SOURce]:CURRent:TRANsient:AWIDth ...
  • Page 37 RIGOL Chapter 2 Command System [:SOURce]:LIST:WIDth  [:SOURce]:LIST:SLEW  [:SOURce]:LIST:END  [:SOURce]:BATTary:RANGe  [:SOURce]:BATTary[:LEVel][:IMMediate]  [:SOURce]:BATTary:VSTop  [:SOURce]:BATTary:CSTop  [:SOURce]:BATTary:TIMestop  [:SOURce]:BATTary:VON  [:SOURce]:BATTary:VENabstop  [:SOURce]:BATTary:CENabstop  [:SOURce]:BATTary:TENabstop  [:SOURce]:OCP:RANGe  [:SOURce]:OCP:VON  [:SOURce]:OCP:VONDelay  [:SOURce]:OCP:ISET  [:SOURce]:OCP:ISTep  [:SOURce]:OCP:IDELaystep ...

  • Page 38: [:Source]:Input

    RIGOL Chapter 2 Command System [:SOURce]:INPut Syntax [:SOURce]:INPut[:STATe] {0|1|ON|OFF} [:SOURce]:INPut[:STATe]? Description Sets the input of the electronic load to be on or off. Queries whether the input of the electronic load is on or off. Remarks Once you power on the load, it will not sink the current immediately, and you need to ...

  • Page 39: [:Source]:Transient

    RIGOL Chapter 2 Command System activated list command. WAVe: indicates that the input regulation mode is determined by the waveform display command. BATTery: indicates that the input regulation mode is determined by the battery discharge command. OCP: indicates that the input regulation mode is determined by the OCP command. OPP: indicates that the input regulation mode is determined by the OPP command.

  • Page 40: [:Source]:Current:range

    RIGOL Chapter 2 Command System the maximum value of the load's regulated current; and the parameter "DEFault" indicates querying the default value of the load's regulated current. Return The query returns a real number. Format Example :SOUR:CURR:LEV:IMM 3 /*Sets the load's regulated current in CC mode to be 3 A.*/ :SOUR:CURR:LEV:IMM? /*Queries the load's regulated current set in CC mode.*/...

  • Page 41: [:Source]:Current:slew:positive

    RIGOL Chapter 2 Command System [:SOURce]:CURRent:SLEW:POSitive Syntax [:SOURce]:CURRent:SLEW:POSitive {<value>|MINimum|MAXimum|DEFault} [:SOURce]:CURRent:SLEW:POSitive? [MINimum|MAXimum|DEFault] Description Sets the rising rate in transient operation mode. Queries the rising rate set in transient operation mode. Remarks The rising rate of the load set in transient operation mode is the slew rate of the load ...

  • Page 42: [:Source]:Current:von

    RIGOL Chapter 2 Command System [:SOURce]:CURRent:VON Syntax [:SOURce]:CURRent:VON {<value>|MINimum|MAXimum|DEFault} [:SOURce]:CURRent:VON? [MINimum|MAXimum|DEFault] Description Sets the starting voltage in CC mode. Queries the starting voltage set in CC mode. Remarks When the input voltage increases and reaches a value above the set starting voltage ...

  • Page 43: [:Source]:Current:transient:mode

    RIGOL Chapter 2 Command System Remarks The current limit refers to the upper limit of the current working in CC mode. Its unit  is A. In the setting command, the parameter "MINimum" indicates setting the minimum  current; the parameter "MAXimum" indicates setting the maximum current; and the parameter "DEFault"...

  • Page 44: [:Source]:Current:transient:blevel

    RIGOL Chapter 2 Command System parameter "DEFault" indicates querying the default value of Level A. Return The query returns a real number. Format Example :SOUR:CURR:TRAN:ALEV 5 /*Sets Level A in transient operation mode to be 5 A.*/ :SOUR:CURR:TRAN:ALEV? /*Queries Level A set in transient operation mode.*/...

  • Page 45: [:Source]:Current:transient:bwidth

    RIGOL Chapter 2 Command System Return The query returns a real number. Format Example :SOUR:CURR:TRAN:AWID 1 /*Sets the width of Level A in continuous or pulsed transient operation to be 1 ms.*/ :SOUR:CURR:TRAN:AWID? /*Queries the width of Level A in continuous or pulsed transient operation.*/...

  • Page 46: [:Source]:Current:transient:period

    RIGOL Chapter 2 Command System frequency; the parameter "MAXimum" indicates querying the maximum frequency; and the parameter "DEFault" indicates querying the default frequency. Return The query returns a real number. Format Example :SOUR:CURR:TRAN:FREQ 5 /*Sets the frequency in continuous mode to be 5 kHz.*/ :SOUR:CURR:TRAN:FREQ? /*Queries the frequency set in continuous mode.*/...

  • Page 47: [:Source]:Voltage[:Level][:Immediate]

    RIGOL Chapter 2 Command System Format Example :SOUR:CURR:TRAN:ADUT 50 /*Sets the duty cycle in continuous mode to be 50%.*/ :SOUR:CURR:TRAN:ADUT? /*Queries the duty cycle set in continuous mode.*/ Related [:SOURce]:CURRent:TRANsient:AWIDth Command [:SOURce]:VOLTage[:LEVel][:IMMediate] Syntax [:SOURce]:VOLTage[:LEVel][:IMMediate] {<value>|MINimum|MAXimum|DEFault} [:SOURce]:VOLTage[:LEVel][:IMMediate]? [MINimum|MAXimum|DEFault] Description Sets the load voltage in CV mode.

  • Page 48: [:Source]:Voltage:vlimt

    RIGOL Chapter 2 Command System [:SOURce]:VOLTage:VLIMt Syntax [:SOURce]:VOLTage:VLIMt {<value>|MINimum|MAXimum|DEFault} [:SOURce]:VOLTage:VLIMt? [MINimum|MAXimum|DEFault] Description Sets the voltage limit in CV mode. Queries the voltage limit set in CV mode. Remarks The voltage limit refers to the upper limit of the voltage working in CV mode. The unit ...

  • Page 49: [:Source]:Resistance:range

    RIGOL Chapter 2 Command System Remarks The load resistance refers to the constant resistance in CR mode. Its unit is Ω.  In the setting command, the parameter "MINimum" indicates setting the minimum  load resistance; the parameter "MAXimum" indicates setting the maximum load resistance;...

  • Page 50: [:Source]:Resistance:ilimt

    RIGOL Chapter 2 Command System Return The query returns a real number. Format Example :SOUR:RES:VLIM 5 /*Sets the voltage limit in CR mode to be 5 V.*/ :SOUR:RES:VLIM? /*Queries the voltage limit set in CR mode.*/ [:SOURce]:RESistance:ILIMt Syntax [:SOURce]:RESistance:ILIMt {<value>|MINimum|MAXimum|DEFault}...

  • Page 51: [:Source]:Power:vlimt

    RIGOL Chapter 2 Command System [:SOURce]:POWer:VLIMt Syntax [:SOURce]:POWer:VLIMt {<value>|MINimum|MAXimum|DEFault} [:SOURce]:POWer:VLIMt? [MINimum|MAXimum|DEFault] Description Sets the voltage limit in CP mode. Queries the voltage limit set in CP mode. Remarks The voltage limit refers to the upper limit of the voltage working in CP mode. The unit ...

  • Page 52: [:Source]:List:range

    RIGOL Chapter 2 Command System current/voltage/resistance/power modes accurately and rapidly, which may be synchronized with internal or external signals. In this way, you can complete the sophisticated test. The list function supports CC, CV, CR, and CP modes.  Return The query returns CC, CV, CR, or CP.

  • Page 53: [:Source]:List:step

    RIGOL Chapter 2 Command System [:SOURce]:LIST:STEP Syntax [:SOURce]:LIST:STEP {<value>|MINimum|MAXimum} [:SOURce]:LIST:STEP? [MINimum|MAXimum] Description Sets the number of steps executed in each cycle. Queries the number of steps executed in each cycle. Remarks Its range is from 2 to 512.  The step value starts from 0.

  • Page 54: [:Source]:List:slew

    RIGOL Chapter 2 Command System Example :SOUR:LIST:WID 3,3 /*Sets the width for Step 4 to 3 s.*/ :SOUR:LIST:WID? 3 /*Queries the width for Step 4.*/ [:SOURce]:LIST:SLEW Syntax [:SOURce]:LIST:SLEW <step>,<value> [:SOURce]:LIST:SLEW? <step> Description Sets the slew rate for CC mode in List operation.

  • Page 55: [:Source]:Battary[:Level][:Immediate]

    RIGOL Chapter 2 Command System In the setting command, the parameter "MINimum" indicates setting a low range;  the parameter "MAXimum" indicates setting a high range; and the parameter "DEFault" indicates setting the default range. In the query command, the parameter "MINimum" indicates querying a low range;...

  • Page 56: [:Source]:Battary:cstop

    RIGOL Chapter 2 Command System the parameter "DEFault" indicates querying the default voltage. Return The query returns a real number. Format Example :SOUR:BATT:VST 5 /*Sets the voltage at which the battery stops discharging in Battery mode to be 5 V.*/...

  • Page 57: [:Source]:Battary:von

    RIGOL Chapter 2 Command System [:SOURce]:BATTary:VON Syntax [:SOURce]: BATTary:VON {<value>|MINimum|MAXimum|DEFault} [:SOURce]: BATTary:VON? [MINimum|MAXimum|DEFault] Description Sets the starting voltage in Battery mode. Queries the starting voltage in Battery mode. Remarks The default unit for the starting voltage is V, and it ranges from 0 V to 150 V.

  • Page 58: [:Source]:Battary:tenabstop

    RIGOL Chapter 2 Command System [:SOURce]:BATTary:TENabstop Syntax [:SOURce]:BATTary:TENabstop {0|1|ON|OFF} [:SOURce]:BATTary:TENabstop? Description Sets the discharge cut-off time switch of the electronic load. Queries the on/off status of the discharge cut-off time of the electronic load. Return 0 (OFF) or 1 (ON)

  • Page 59: [:Source]:Ocp:vondelay

    RIGOL Chapter 2 Command System Return The query returns a real number. Format Example :SOUR:OCP:VON 5 /*Sets the starting voltage in OCP mode to be 5 V.*/ :SOUR:OCP:VON? /*Queries the starting voltage in OCP mode.*/ [:SOURce]:OCP:VONDelay Syntax [:SOURce]:OCP:VONDelay {<value>|MINimum|MAXimum|DEFault} [:SOURce]:OCP:VONDelay? [MINimum|MAXimum|DEFault] Description Sets the delay time of the starting voltage in OCP mode.

  • Page 60: [:Source]:Ocp:istep

    RIGOL Chapter 2 Command System [:SOURce]:OCP:ISTep Syntax [:SOURce]:OCP:ISTep {<value>|MINimum|MAXimum|DEFault} [:SOURce]:OCP:ISTep? [MINimum|MAXimum|DEFault] Description Sets the step current in OCP mode. Queries the step current in OCP mode. Remarks The step current is called the step value of the current in OCP mode. The default unit ...

  • Page 61: [:Source]:Ocp:imin

    RIGOL Chapter 2 Command System OCP mode. The default unit for the value is A. In the setting command, the parameter "MINimum" indicates setting the minimum  value of the maximum current; the parameter "MAXimum" indicates setting the maximum value of the maximum current; and the parameter "DEFault" indicates setting the default value of the maximum current.

  • Page 62: [:Source]:Ocp:tocp

    RIGOL Chapter 2 Command System In the query command, the parameter "MINimum" indicates querying the minimum  protection voltage; the parameter "MAXimum" indicates querying the maximum protection voltage; and the parameter "DEFault" indicates querying the default protection voltage. Return The query returns a real number.

  • Page 63: [:Source]:Opp:vondelay

    RIGOL Chapter 2 Command System Return The query returns a real number. Format Example :SOUR:OPP:VON 5 /*Sets the starting voltage in OPP mode to be 5 V.*/ :SOUR:OPP:VON? /*Queries the starting voltage in OPP mode.*/ [:SOURce]:OPP:VONDelay Syntax [:SOURce]:OPP:VONDelay {<value>|MINimum|MAXimum|DEFault} [:SOURce]:OPP:VONDelay? [MINimum|MAXimum|DEFault] Description Sets the delay time of the starting voltage in OPP mode.

  • Page 64: [:Source]:Opp:pstep

    RIGOL Chapter 2 Command System [:SOURce]:OPP:PSTep Syntax [:SOURce]:OPP:PSTep {<value>|MINimum|MAXimum|DEFault} [:SOURce]:OPP:PSTep? [MINimum|MAXimum|DEFault] Description Sets the step power in OPP mode. Queries the step power in OPP mode. Remarks The step power is called the step value of the power in OPP mode. The default unit ...

  • Page 65: [:Source]:Opp:pmin

    RIGOL Chapter 2 Command System mode. The default unit for the value is W. In the setting command, the parameter "MINimum" indicates setting the minimum  value of the maximum power; the parameter "MAXimum" indicates setting the maximum value of the maximum power; and the parameter "DEFault" indicates setting the default value of the maximum power.

  • Page 66: [:Source]:Opp:topp

    RIGOL Chapter 2 Command System In the query command, the parameter "MINimum" indicates querying the minimum  protection voltage; the parameter "MAXimum" indicates querying the maximum protection voltage; and the parameter "DEFault" indicates querying the default protection voltage. Return The query returns a real number.

  • Page 67: [:Source]:Wave:tstep

    RIGOL Chapter 2 Command System Related [:SOURce]:FUNCtion:MODE Command [:SOURce]:WAVe:TSTep Syntax [:SOURce]:WAVe:TSTep{1|10} [:SOURce]:WAVe: TSTep? Description Sets the time step scale in the waveform display interface. Queries the set time step scale. Remarks The time step scale includes *1 and *10. When the time step is set to "*1", it ...

  • Page 68: System Commands

    RIGOL Chapter 2 Command System :SYSTem Commands Command List: :SYSTem:KEY  :SYSTem:ERRor?  :SYSTem:VERSion?  :SYSTem:IDN  :SYSTem:KEY Syntax :SYSTem:KEY <keyval> Description Simulates the keys on the front panel remotely. Remarks keyval is the key value. For its detailed key name, refer to the following table.

  • Page 69: System:error

    Identification string contains four comma separated fields and conforms to the IEEE-488 standards. After the system is reset, the identification string will be cleared. Example SYSTem:IDN:SET RIGOL,DL3031A,DL3000A000001,00.01.00.04.05 /*Defines the manufacturer, the product model, the serial number, and the firmware version.*/...

  • Page 70: Lxi Commands

    RIGOL Chapter 2 Command System :LXI Commands Command List: LXI:IDENtify[:STATE]  LXI:MDNS[:ENABle]  LXI:RESet  LXI:RESTart  LXI:IDENtify[:STATE] Syntax LXI:IDENtify[:STATE] {0|1|ON|OFF} LXI:IDENtify[:STATE]? Description Sets the LXI identifier in the interface to be on or off. Queries the state of the LXI identifier in the interface.

  • Page 71: Lxi:reset

    RIGOL Chapter 2 Command System LXI:RESet Syntax LXI:RESet Description Restores the LAN settings to defaults. Remarks The default state of LAN is as follows: DHCP:ON AutoIP:ON ManualIP:OFF LXI:RESTart Syntax LXI:RESTart Description Applies the currently set parameters. DL3000 Programming Guide 2-53...

  • Page 72: Lic Command

    To obtain the option license, first purchase the required option to obtain the key,  and then use the key to generate the option license according to the following steps. Log in to the RIGOL official website (www.rigol.com), click SERVICE   Software License Register to enter the "Registered product license code" interface.

  • Page 73: Chapter 3 Application Instances

    RIGOL Chapter 3 Application Instances Chapter 3 Application Instances This chapter provides the application instances of the SCPI commands. The main functions of the load can be realized through a series of SCPI commands. Note: The instances in this chapter take DL3031A as an example. The range of certain parameters for other models may be different.
  • Page 74 RIGOL Chapter 3 Application Instances (15) :SOUR:LIST:SLEW 2,0.2 /*Sets the slew rate at Step 3 to be 0.2 A/μs.*/ (16) :TRIG:SOUR MANU /*Sets the trigger source of the load to be manual. Pressing the TRAN key can enable the trigger.*/ (17) :SOUR:INP:STAT 1 /*Sets the input of the load to be on.*/...

  • Page 75: Chapter 4 Programming Instances

    Chapter 4 Programming Instances Chapter 4 Programming Instances This chapter illustrates how to program DL3000 series with SCPI commands based on NI-VISA in Excel, MATLAB, LabVIEW, Visual C++, and Visual C#. NI-VISA (National Instrument-Virtual Instrument Software Architecture), developed by NI (National Instrument), provides an advanced programming interface to communicate with various instruments through their bus lines.
  • Page 76 RIGOL Chapter 4 Programming Instances Obtain the USB VISA descriptor of the load. Press Utility, and then the VISA descriptor is displayed at the bottom of the interface. The VISA descriptor of the load used in this instance is USB0::0x1AB1::0x0E11::DL3000A000001::INSTR.

  • Page 77: Excel Programming Instance

    RIGOL Chapter 4 Programming Instances Excel Programming Instance Program used in this instance: Microsoft Excel 2007 Function realized in this example: sending the *IDN? command and reading the instrument information. Create a new Excel file that enables the Macros, and name it "DL3000_Demo_Excel.xlsm".
  • Page 78 RIGOL Chapter 4 Programming Instances Select Tools(T) in the Microsoft Visual Basic menu bar and click References. In the displayed dialog box, select VISA Library, and click OK to refer to the VISA Library. Remarks: If you cannot find VISA Library in the left section of the above dialog box, please follow the method below to find it.
  • Page 79 RIGOL Chapter 4 Programming Instances Click View Code under Developer menu to enter the interface of Microsoft Visual Basic. Add the following codes and save the file. Note: If the Excel file created at Step 2 does not enable the Macros, a prompt message "The following features cannot be saved in macro-free workbooks"...

  • Page 80: Matlab Programming Instance

    %display the device information already read Save the M file to the current path. In this instance, the M file is named as "dl3000_Demo_MATLAB.m". Run the M file and the running results are displayed as follows: IDN= RIGOL TECHNOLOGIES,DL3031A,LS000001,00.01.00.04.05 DL3000 Programming Guide...

  • Page 81: Labview Programming Instance

    RIGOL Chapter 4 Programming Instances LabVIEW Programming Instance Program used in this example: LabVIEW 2010 Function realized in this instance: search for the instrument address, connect to the instrument, send and read commands. Run LabVIEW 2010, and then create a VI file named DL_Demo_LABVIEW.
  • Page 82 RIGOL Chapter 4 Programming Instances (1) Connect (including error correction advice): (2) Write (including error confirmation): DL3000 Programming Guide...
  • Page 83 RIGOL Chapter 4 Programming Instances (3) Read (including error correction advice): DL3000 Programming Guide...
  • Page 84 RIGOL Chapter 4 Programming Instances (4) Exit: 4-10 DL3000 Programming Guide...
  • Page 85 RIGOL Chapter 4 Programming Instances Run the program, and then the following interface is displayed below. Click the VISA resource name from the drop-down list under Address, and click Connect to connect the instrument. Then, input *IDN? in the Command field. Click Write to write the command to the instrument. If it is a query command, click Read, and then the query result will be displayed in the Return field.

  • Page 86: Visual C++ Programming Instance

    RIGOL Chapter 4 Programming Instances Visual C++ Programming Instance Program used in this example: Microsoft Visual C++6.0 Function realized in this example: sending the *IDN? command and reading the instrument information. Run Microsoft Visual C++6.0. Create a MFC project based on a dialog box.
  • Page 87 RIGOL Chapter 4 Programming Instances Select Include files from the drop-down list under Show directories for. Double click the empty space under Directories to enter the specified path of Include files: C:\Program Files\IVI Foundation\VISA\WinNT\include. Click OK to close the dialog box.
  • Page 88 RIGOL Chapter 4 Programming Instances Add codes. Double-click Send and Read to enter the programming environment. Declare the VISA library "#include <visa.h>" in the header file and then add the following codes: ViSessiondefaultRM, vi; charbuf [256] = {0}; CStrings,strTemp; char* stringTemp;...
  • Page 89 RIGOL Chapter 4 Programming Instances strTemp = strTemp + "\n"; stringTemp = (char *)(LPCTSTR)strTemp; viPrintf (vi,stringTemp); //read results viScanf (vi, "%t\n", &buf); //display the results UpdateData (TRUE); m_receive = buf; UpdateData (FALSE); viClose (vi); viClose (defaultRM); Save, compile, and run the project to obtain a single exe file. When the electronic load is successfully connected to the PC, select "*IDN?"...

  • Page 90: Visual C# Programming Instance

    RIGOL Chapter 4 Programming Instances Visual C# Programming Instance Program used in this instance: Microsoft Visual Studio 2010 Function realized in this example: sending the *IDN? command and reading the instrument information. 1. Run Microsoft Visual Studio 2010, and create a project. Search for visa32.cs from the VISA installation directory and add it to the project.
  • Page 91 RIGOL Chapter 4 Programming Instances viError = visa32.viOpenDefaultRM(out viDefRm); viError = visa32.viOpen(viDefRm, cDEVICE_INSTR, 0, 5000, out viSession); visa32.viPrintf(viSession, "*IDN?\n"); byteReadBuf = new byte[128]; visa32.viRead(viSession, byteReadBuf, 128, out retCnt); strIdn = ""; for ( i = 0; i < retCnt; i++ ) strIdn = strIdn + Convert.ToChar(byteReadBuf[i]);...

  • Page 93: Chapter 5 Appendix

    RIGOL Chapter 5 Appendix Chapter 5 Appendix Appendix A: Default Settings Note*: These parameters will not be affected by the default setting operations. You can restore the instruments to factory defaults by doing either of the following operations: Send the *RST command.
  • Page 94 RIGOL Chapter 5 Appendix Trigger Source TRAN Range A_Level B_Level Rising slew rate 0.001 A/μs Falling slew rate 0.001 A/μs Trigger Source TRAN List Mode Range Circle Steps Last State Trigger Source TRAN Step Value Step Duration Step Slew 0.001 A/μs...
  • Page 95 RIGOL Chapter 5 Appendix Mode Current Range 60 A Maximum Value 10 A Minimum Value Pass_Tip Fail_Tip Pass_Sound Fail_Sound CC+CV Current C_Range 60 A Voltage V_Range 150 V V_Limit 155 V C_Limit 70 A System Language* 简体中文 Power-on Default Beeper...

  • Page 96: Appendix B: Warranty

    Chapter 5 Appendix Appendix B: Warranty RIGOL warrants that the product mainframe and product accessories will be free from defects in materials and workmanship within the warranty period. If a product proves defective within the warranty period, RIGOL guarantees free replacement or repair for the defective product.

This manual is also suitable for:

Dl3021Dl3021aDl3031Dl3031a

Table of Contents