Products

Industries

Company

Blog

Contact

Book a demo

Equipment

/

Rigol

/

Rigol DP712

SCPI COMMAND REFERENCE

Rigol DP712

Rigol DP712

The Rigol DP712 is Rigol's power supply in the DP700 family. Its SCPI remote-control interface exposes 63 commands across 10 subsystems - 44 settable and 19 queries - and every command is documented here with its parameters, accepted values, return format, and a copy-paste PyVISA example for automating test and measurement.

63

Commands

44

Settable

19

Queries

10

Subsystems

SCPI

Verified

2026-07-16

All commands

63 of 63 commands

:APPLyset / query

Sets the channel output voltage and/or current. Queries the channel voltage and/or current setting value.

NameTypeValuesDescription
channeloptdiscreteCH1 | P30VChannel to apply the settings to (DP711).
channeloptdiscreteCH1 | P50VChannel to apply the settings to (DP712).
voltagereal0 V - 32 VChannel output voltage setting value (DP711).
voltagereal0 V - 53 VChannel output voltage setting value (DP712).
currentoptreal0 A - 5.3 AChannel output current setting value (DP711).
currentoptreal0 A - 3.2 AChannel output current setting value (DP712).
string - Returns both the channel voltage and current setting values when all parameters are omitted or when only <item> is omitted; otherwise returns only the channel voltage or current setting value.
APPLy CH1,5,1
APPLy?
APPLy 3
APPLy? CH1,VOLTage

Turns on or off the display. Queries the on/off state of the display.

NameTypeValuesDescription
stateenumON | OFFTurns the display on or off.
:DISPlay ON /*Turns on the display*/
:DISPlay? /*Queries the on/off state of the display*/

*IDN?query

Queries the identification string.

string - Returns the identification string in the format RIGOL TECHNOLOGIES,<model>,<serial number>,<software version>.
*OPT?query

Queries the installation status of the option.

string - Returns the installation status of the trigger, timer, and high-resolution options as a comma-separated list of three states.
*RCLset / query

Recalls the state file or timer file stored in the specified location in the internal non-volatile memory of the power supply.

NameTypeValuesDescription
positiondiscrete1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12Specifies the storage location to recall.
*RCL 2 /*Recalls the state file stored in the storage location State2*/
*RSTset / query

Restores the instrument to the default settings (refer to Appendix A: Default Settings).

*SAVset / query

Saves the current state or timer parameters of the power supply with the default file names to the specified location of the internal memory.

NameTypeValuesDescription
positiondiscrete1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12Storage location in internal non-volatile memory.
*TST?query

Queries the self-test result.

string - A string giving the self-test result, such as Fan:PASS.

Selects the current channel. Queries the currently selected channel.

NameTypeValuesDescription
channeldiscrete1 - 1

Selects the current channel. Queries the currently selected channel.

NameTypeValuesDescription
channelenumCH1 | P30V | P50VCurrent channel to select.

Selects the current channel. Queries the currently selected channel.

NameTypeValuesDescription
channelenumCH1 | P30V | P50V

:LIC:SETset / query

Installs an option license for the instrument.

NameTypeValuesDescription
licensestring-Option license string to install the option; a 28-character ASCII string consisting of English letters and numbers, with hyphens omitted.
:LIC:SET 4SN2M2HBB2H4PLHTJFM4PFCEUAVB

Queries the voltage, current, and power value measured on the channel output terminal.

NameTypeValuesDescription
channeloptdiscreteCH1 | P30V | P50VChannel output terminal to measure.
real - Returns three real numbers separated by commas, representing voltage, current, and power from left to right.
:MEASure:ALL? CH1

Queries the current value measured on the channel output terminal.

NameTypeValuesDescription
channeloptdiscrete-Channel to measure.
real - Returns one real number representing the measured current value.
:MEASure:CURRent?

Queries the power value measured on the channel output terminal.

NameTypeValuesDescription
channeloptdiscrete-Measurement channel.
real - Returns one real number representing the measured power value on the channel output terminal.
:MEASure:POWEr? CH1

Queries the voltage value measured on the channel output terminal.

NameTypeValuesDescription
channeloptdiscrete-Channel to measure.
real - Returns one real number representing the measured voltage value on the channel output terminal.
:MEASure? /*Queries the voltage value measured on the channel output terminal*/

Deletes the state files (RSF) or timer files (RTF) stored in the specified locations of the internal non-volatile memory.

NameTypeValuesDescription
file_typeenumRSF | RTFSelects whether the file is a state file or a timer file.
positioninteger1 - 10Specifies the storage location index for the selected file type.
:MEMory:DELete RTF,2 /*Deletes the file stored in the storage location Timer2*/

Reads state files (RSF) or timer files (RTF) stored in the specified locations of the internal non-volatile memory.

NameTypeValuesDescription
file_typeenumRSF | RTFSelects whether the command operates on a state file or a timer file.
positionenum1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10Specifies the storage location number. For RSF, valid positions are 1 to 10; for RTF, valid positions are 1 to 2.
:MEMory:LOAD RSF,2 /*Reads the file stored in the storage location Timer2*/

Locks or unlocks the state files (RSF) or timer files (RTF) stored in the specified locations of the internal non-volatile memory. The query checks whether the file in the specified location has been locked.

NameTypeValuesDescription
file_typeenumRSF | RTFSelects whether the target file is a state file or a timer file.
positiondiscrete1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10Specifies the storage location of the file; the allowed range depends on file_type.
stateenumON | OFFSets whether the file is locked or unlocked.

Saves the current state or timer parameters of the power supply with the default file names to the specified location of the internal non-volatile memory.

NameTypeValuesDescription
file_typeenumRSF | RTFSelects whether a state file or timer file is stored.
positionenum1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10Specifies the storage location for the selected file type.
:MEMory:LOCK RSF,2,ON
:MEMory:LOCK? RSF,2

Queries whether a valid file has been saved to the specified location of the internal non-volatile memory.

NameTypeValuesDescription
file_typeenumRSF | RTFSpecifies whether the file is a state file or a timer file.
positionenum1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10Specifies the storage location to check; valid positions depend on <file_type>.
boolean - Returns whether a valid file is saved at the specified location.

Queries the channel output mode.

NameTypeValuesDescription
channeloptdiscreteCH1 | P30V | P50VSelects the output channel to query.
enum - Constant voltage, constant current, or unregulated output mode.

Queries the channel output mode.

NameTypeValuesDescription
channeloptdiscreteCH1 | P30V | P50VSelects the output channel to query.
enum - Returns the present output mode of the specified channel.

Queries whether the overcurrent protection (OCP) has occurred for the selected output channel.

NameTypeValuesDescription
channeloptdiscrete-
enum - Returns whether overcurrent protection has currently occurred.
:OUTPut:OCP:ALAR? CH1

Queries whether the overcurrent protection (OCP) has occurred.

NameTypeValuesDescription
channeloptdiscrete-
enum - Returns whether the overcurrent protection has currently occurred.
:OUTPut:OCP:QUES?
:OUTPut:OCP:QUES? /*Queries whether the overcurrent protection has currently occurred*/

Clears the internal OCP flag and the OCP prompt message.

NameTypeValuesDescription
channeloptdiscrete-Output channel to clear.
:OUTPut:OCP:CLEAR /*Clears the internal OCP flag and the OCP prompt message*/

Enable or disable the overcurrent protection (OCP) function. The query returns the on/off state of the OCP function.

NameTypeValuesDescription
channeloptdiscrete-Output channel to address.
statebooleanON | OFFTurns OCP on or off.
enum - Returns the on/off state of the overcurrent protection (OCP) function.
:OUTPut:OCP[:STATe] [<channel>,]<state>
:OUTPut:OCP[:STATe]? [<channel>]

Sets or queries the channel overcurrent protection (OCP) value.

NameTypeValuesDescription
channeloptdiscreteCH1 | P30V | P50VChannel for which the OCP value is set or queried.
valuereal0.01 A - 5.5 AOvercurrent protection value.
qualifierenumMINimum | MAXimumSpecifies the minimum or maximum settable OCP value.
real (A) - Returns the channel overcurrent protection value. MINimum queries the minimum settable value; MAXimum queries the maximum settable value.
:OUTPut:OCP:VALue 5
:OUTPut:OCP:VALue? CH1

Queries whether the overvoltage protection (OVP) has occurred for the specified channel.

NameTypeValuesDescription
channeloptdiscreteCH1 | P30V | P50VChannel to query.
enum - Returns whether the OVP has occurred.
:OUTPut:OVP:ALAR? CH1

Queries whether the overvoltage protection (OVP) has occurred.

NameTypeValuesDescription
channeloptdiscreteCH1 | P30V | P50V
enum - Returns whether the overvoltage protection has currently occurred.
:OUTPut:OVP:QUES? /*Queries whether the overvoltage protection has currently occurred*/

Clears the internal OVP flag and the OVP prompt message.

NameTypeValuesDescription
channeloptdiscreteCH1 | P30V | P50VOutput channel to apply the command to.
:OUTPut:OVP:CLEAR /*Clears the internal OVP flag and the OVP prompt message*/

Enable or disable the overvoltage protection (OVP) function. The query returns the on/off state of the OVP function.

NameTypeValuesDescription
channeloptdiscreteCH1 | P30V | P50VOutput channel to target.
statebooleanON | OFFEnables or disables OVP.
enum - Returns the current on/off state of the overvoltage protection function.

Sets the channel overvoltage protection (OVP) value. The query form returns the channel overvoltage protection value, and MINimum/MAXimum can be used to set or query the limits.

NameTypeValuesDescription
channeloptdiscreteCH1 | P30V | P50VChannel to apply the OVP setting to.
valuereal0.01 V - 33 VOVP threshold value to set.
qualifieroptenumMINimum | MAXimumUse MINimum to set or query the minimum settable OVP value, or MAXimum for the maximum settable value.
:OUTPut:OVP:VALue 30
:OUTPut:OVP:VALue? CH1
:OUTPut[:STATe]set / query

Enable or disable the channel output. Queries the on/off state of the channel output.

NameTypeValuesDescription
channeloptdiscrete-Selects the channel whose output state is controlled or queried.
stateenumON | OFFTurns the channel output on or off.
enum - Returns the on/off state of the channel output.
:OUTPut:STATe CH1,ON /*Enable the channel output*/
:OUTPut:STATe? CH1 /*Queries the on/off state of the channel output*/

Turns the beeper on or off. Queries the on/off state of the beeper.

NameTypeValuesDescription
stateenumON | OFFBeeper state.
enum - Returns the beeper on/off state.
:SYSTem:BEEPer ON
:SYSTem:BEEPer?

Sets screen brightness. Queries screen brightness.

NameTypeValuesDescription
brightinteger1 - 100Screen brightness value.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum settable brightness.
:SYSTem:BRIGhtness 55 /*Sets screen brightness to 55%*/
:SYSTem:BRIGhtness? /*Queries screen brightness*/

Sets the baud rate of the RS232 interface. The query returns the current baud rate.

NameTypeValuesDescription
baudenum7200 | 9600 | 14400 | 19200 | 38400 | 57600 | 115200Baud rate to set for the RS232 interface.
enum - Returns the current RS232 baud rate.

Sets the number of the data bits of the RS232 interface. The number of data bits is fixed at 8 and cannot be modified.

NameTypeValuesDescription
bitenum8Number of data bits for the RS232 interface.

Sets or queries the parity of the RS232 interface.

NameTypeValuesDescription
parityenumNONE | ODD | EVENParity setting for the RS232 interface.
enum - Returns the current RS232 parity setting.

Sets the number of the stop bits of the RS232 interface. The number of stop bits is fixed at 1 and cannot be modified.

NameTypeValuesDescription
bitenum1Number of stop bits.

Queries the last error message in the error queue and clears the error message. DP700 series allows you to view the last 5 errors.

string - The number and contents of the error message, such as -113,"Undefined header; keyword cannot be found".

Queries the self-test result of the fan.

string - The fan self-test result, for example FAN:PASS.
:SYSTem:KLOCkset / query

Locks or unlocks the specified front-panel key, and the query form checks whether that key is locked.

NameTypeValuesDescription
keydiscrete-Specified front-panel key; refer to the Remarks for valid values.
statebooleanON | OFF | 1 | 0Lock state to set for the specified key.
boolean - For the query form, returns whether the specified front-panel key is locked or not.

Enables or disables the remote locking. Queries the on/off state of the remote locking.

NameTypeValuesDescription
stateenumON | OFFEnables or disables remote locking.
enum - Returns the on/off state of the remote locking.
:SYSTem:KLOCk:STATe ON /*Enables the remote locking*/
:SYSTem:KLOCk:STATe? /*Queries the on/off state of the remote locking*/

Selects the system language. Queries the currently selected language.

NameTypeValuesDescription
typeenumEN | CHLanguage to select.
enum - Returns the currently selected language.
SYSTem:LANGuage:TYPE EN
SYSTem:LANGuage:TYPE?
:SYSTem:LOCalset / query

Enables the power supply to shift from remote mode to local mode.

:SYSTem:LOCKset / query

Locks or unlocks the front panel. Queries whether the front panel is locked or not.

NameTypeValuesDescription
statebooleanON | OFF | 1 | 0
enum - Returns whether the front panel is locked or not.
:SYSTem:LOCK ON /*Locks the front panel*/
:SYSTem:LOCK? /*Queries whether the front panel is locked or not*/
:SYSTem:POWEronset / query

Selects the power-on setting for the instrument when it is powered on. Queries the currently selected power-on setting.

NameTypeValuesDescription
stateenumDEFault | LASTSets the power-on configuration used when the instrument is powered on.
enum - Returns the currently selected power-on setting.
:SYSTem:POWEron DEFault /*Selects "DEFault" as the power-on setting*/
:SYSTem:POWEron? /*Queries the currently selected power-on setting*/

Reads the data stream of the image currently displayed on the screen (screen shot).

string - A string
:SYSTem:REMoteset / query

Enables the power supply to shift from the local mode to the remote mode.

Enables or disables the remote locking.

NameTypeValuesDescription
stateoptboolean-Enables or disables remote locking.
:SYSTem:SAVerset / query

Enables or disables the screen saver function. Queries the on/off state of the screen saver function.

NameTypeValuesDescription
stateenumON | OFFEnables or disables the screen saver function.
enum - ON or OFF
:SYSTem:SAVer ON /*Enables the screen saver function*/
:SYSTem:SAVer? /*Queries the on/off state of the screen saver function*/

Queries the self-test results of the instrument.

string - The self-test result string, for example "Fan:PASS".

Turns on or off the trigger input. Queries the on/off state of the trigger input.

NameTypeValuesDescription
stateenumON | OFFSets the trigger input on or off.
enum - Returns the on/off state of the trigger input.

Turns on or off the trigger output. The query returns the on/off status of the trigger output.

NameTypeValuesDescription
stateenumON | OFFSets the trigger output state.
enum - Returns the trigger output status.

Queries the SCPI version of the system.

string - Returns the SCPI version in the format YYYY.V, for example 1999.0.

:TIMEr:CYCLEsset / query

Sets the number of cycles for the timer. Queries the number of cycles selected for the timer.

NameTypeValuesDescription
cyclesdiscreteN[,<value>] | ISelects a finite cycle count or infinite cycles.
valueoptinteger1 - 99999Finite cycle count used when cycles is set to N.
:TIMEr:ENDStateset / query

Sets the end state of the timer. Queries the end state selected for the timer.

NameTypeValuesDescription
stateenumOFF | LASTEnd state to apply after timer output completes.
enum - Returns the end state selected for the timer.
:TIMEr:ENDState LAST /*Sets the end state of the timer to "LAST"*/
:TIMEr:ENDState? /*Queries the end state selected for the timer*/
:TIMEr:GROUPsset / query

Sets the number of output groups for the timer. Queries the number of output groups selected for the timer.

NameTypeValuesDescription
valueinteger1 - 2048Number of output groups.
integer - Returns the number of output groups selected for the timer.
:TIMEr:GROUPs <value>
:TIMEr:GROUPs?
:TIMEr:PARAmeterset / query

Sets the timing parameters for a specified group. Queries the timing parameters for one or more groups.

NameTypeValuesDescription
numinteger1 - 2048Group ID to set.
voltagereal0 - 32Output voltage for the group.
currentreal0 - 5.3Output current for the group.
timereal10 ms - 99999Duration time for the group.
firnuminteger1 - 2048Start group ID for the query.
countoptinteger1 - 2048Number of groups to query; when omitted, defaults to 1.
string - A string beginning with # containing a data block header and the specified timing parameters.
:TIMEr:PARAmeter 1,8,2,10
:TIMEr:PARAmeter? 1,2
:TIMEr[:STATe]set / query

Enables or disables the timing output. Queries the on/off state of the timing output.

NameTypeValuesDescription
stateenumON | OFFTurns the timing output on or off.
enum - Returns the current timing output state.
:TIMEr ON
:TIMEr?
:TIMEr:TRIGgerset / query

Sets the trigger mode of the timer (timing output mode). Queries the trigger mode selected for the timer.

NameTypeValuesDescription
modeenumDEFault | SINGleTrigger mode for the timer.
enum - Returns the selected trigger mode.
**Note:** I can't extract verbatim example lines from the manual text provided because the slice does not preserve them as standalone lines in a reliable way.