Products

Industries

Blog

Contact

Book a demo

Equipment

Rigol

Rigol DP2031

SCPI COMMAND REFERENCE

Rigol DP2031

The Rigol DP2031 is Rigol's power supply in the DP2000 family. Its SCPI remote-control interface exposes 135 commands across 12 subsystems - 104 settable and 31 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.

135

Commands

104

Settable

Queries

Subsystems

SCPI

1999.0

Verified

2026-07-16

All commands

135 of 135 commands

:ANALyzer:COMMon:MEASure:TYPEset / query

Sets or queries the analysis object of the common analysis function.

Name	Type	Values	Description
ch	enum	CH1_V \| CH1_C \| CH1_P \| CH2_V \| CH2_C \| CH2_P \| CH3_V \| CH3_C \| CH3_P	Analysis object for the common analysis function.

:ANALyzer:CURRent:MEASure:TYPEset / query

Sets or queries the analysis object of the pulse current analysis.

Name	Type	Values	Description
ch	enum	CH1 \| CH2

enum - The query returns CH1, CH2, or CH1,CH2.

:ANALyzer:CURRent:MEASure:TYPE CH1,CH2 /*Sets the analysis object
of pulse current analysis to CH1 and CH2.*/
:ANALyzer:CURRent:MEASure:TYPE? /*Queries the analysis object of
pulse current analysis. The query returns CH1,CH2.*/

:ANALyzer:CURRent:THREset / query

Sets the threshold settings for pulse current analysis. The syntax shows four parameters: channel, type, boolean, and value.

Name	Type	Values	Description
ch	discrete	CH1 - CH3	Channel selection.
type	null	-	Threshold type.
bool	boolean	-	Boolean enable/disable setting.
val	real	-	Threshold value.

:ANALyzer:SAVE:ROUTeset / query

Sets the analyzer save route destination. The query form returns the current save route.

Name	Type	Values	Description
dest	enum	-

returns

:ANALyzer:SAVE:STATeset / query

Sets or queries whether to save the logged data.

Name	Type	Values	Description
bool	boolean	-	Whether to save the logged data.

:ANALyzer:STATeset / query

Sets or queries the run/stopped state of the analyzer.

Name	Type	Values	Description
bool	enum	0 \| 1 \| ON \| OFF	Run/stopped state of the analyzer.

enum - Returns 0 or 1.

:ANALyzer:STATe ON /*Turns on the analyzer.*/
:ANALyzer:STATe? /*Queries the on/off state of the analyzer. The query returns 1.*/

:ANALyzer:TYPEset / query

Sets or queries the type of analysis. Selects common analysis (COM) or pulse current analysis (CURR).

Name	Type	Values	Description
type	enum	COM \| CURR	Analysis type to select.

enum - The query returns the current analysis type.

:ANALyzer:TYPE CURR
:ANALyzer:TYPE?

:APPLyset / query

Selects the specified channel as the present channel and sets the voltage/current value for that channel. The query returns the voltage/current value for the specified channel.

Name	Type	Values	Description
sourceopt	discrete	CH1 \| CH2 \| CH3	Channel to select or query.
voltopt	real	-	Voltage value for the specified channel.
curropt	real	-	Current value for the specified channel.
optionopt	discrete	CURR \| VOLT	Selects whether the query targets current or voltage.
appopt	discrete	MINimum \| MAXimum \| DEF	Keyword shortcut for minimum, maximum, or default value.

string - Returns the voltage/current value for the specified channel.

*CLSset / query

Clears all event registers.

*ESR?query

Queries the Standard Event register and clears all bits in the register. The query returns a decimal value corresponding to the binary-weighted sum of the bits set.

integer - Decimal value corresponding to the binary-weighted sum of all bits set in the Standard Event register; reading it clears the register.

*ESEset / query

Enables or queries the bits in the enable register of the Standard Event register.

Name	Type	Values	Description
<enable_value	integer	0	Decimal value corresponding to the binary-weighted sum of the bits to be enabled in the Standard Event register enable register.

integer - Returns the current enable register value of the Standard Event register.

*IDN?query

Queries the instrument’s identification string.

string - The ID string in the format Rigol Technologies,<model>,<serial number>,<software version>.

*OPCset / query

Sets the bit0 (OPC, “Operation Complete” bit) of the Standard Event register after the command is executed. The query form checks whether all previous commands have completed.

*OPT?query

Queries the installation status of the options.

string - The installed options status.

*PSCset / query

Enables or disables clearing the enable registers of the Status Byte and Standard Event registers at power-on. The query reports the on/off state of this function.

Name	Type	Values	Description
bool	boolean	0 - 1	Controls whether the enable registers of the Status Byte and Standard Event registers are cleared at power-on.

enum - Returns the on/off state of the power-on clearing function.

*RCLset / query

Recalls a previously stored instrument state from internal memory. Number 0 to 9 selects the state file RIGOL0.RSF through RIGOL9.RSF.

Name	Type	Values	Description
n	discrete	0 - 9	Index of the stored state to recall.

*RCL 5 /*Recalls the state file named RIGOL5.RSF stored in the internal memory.*/

*RSTset / query

Restores the power supply to its factory default.

*SAVset / query

Saves the current instrument state to the specified location in internal memory using the filename RIGOLn.RSF.

Name	Type	Values	Description
n	integer	0 - 9	Specifies the storage location number for the saved state file.

*SREset / query

Enables bits in the enable register of the Status Byte register. The query returns the enabled bits as a decimal value corresponding to the binary-weighted sum of the bits set in that register.

Name	Type	Values	Description
<enable_value>	discrete	-	Decimal value corresponding to the binary-weighted sum of the bits to be enabled in the Status Byte enable register.

integer - Decimal value corresponding to the binary-weighted sum of the bits enabled in the Status Byte enable register.

*SRE 5
*SRE?

*STB?query

Queries the SUMMARY register of the Status Byte register.

integer - Returns a decimal value corresponding to the binary-weighted sum of all bits set in the SUMMARY register of the Status Byte register. The query might return +72.

*STB? /*Queries the SUMMARY register of the Status Byte register. The query returns +72.*/

*TRGset / query

Generates an event trigger.

*TST?query

Queries the self-test result of the instrument. The power supply performs a power-on self-test and this command returns that result.

integer - Returns +0 if the self-test passes and +1 if it fails.

*WAIset / query

Waits until all pending operations are completed before continuing. It is applicable to the trigger system when "BUS (software) trigger" is selected as the trigger source.

*WAI

:INSTrument:NSELectset / query

Selects the channel to be programmed or queries the channel currently selected.

Name	Type	Values	Description
n	discrete	1 \| 2 \| 3	Channel number to select; 1, 2, and 3 represent CH1, CH2, and CH3 respectively.

discrete - Returns the currently selected channel number.

:INSTrument[:SELect]set / query

Selects the channel to be programmed or queries the channel currently selected.

Name	Type	Values	Description
source	enum	CH1 \| CH2 \| CH3	Channel to select.

string - Returns the selected channel name and its rated voltage/current, for example CH1:32V/3A or CH2:32V/3A.

:INST CH2 /*Selects CH2 as the current channel.*/
:INST? /*Queries the channel currently selected. The query returns CH2:32V/3A.*/

:INSTrument[:SELEct]set / query

Selects the channel to be programmed or queries the channel currently selected.

Name	Type	Values	Description
source	enum	CH1 \| CH2 \| CH3	Channel to select.

:LIC:SETset / query

Installs the option license for the instrument. The license is a fixed ASCII string unique to each instrument.

Name	Type	Values	Description
license	string	-	Option license string to install.

:LIC:INSTallset / query

Installs the option license.

Name	Type	Values	Description
license	string	-	The option license string.

:MEASure[:SCALar]:ALL[:DC]?query

Queries the voltage, current, and power at the output terminal of the specified channel.

Name	Type	Values	Description
sourceopt	enum	CH1 \| CH2 \| CH3 \| SERies \| PARallel	Specifies the output terminal source to measure.

string - Returns the measured voltage, current, and power for the specified channel.

:MEASure[:SCALar]:CURRent[:DC]?query

Queries the current measured at the output terminal of the specified channel. If <source> is omitted, it queries the current measured at the output terminal of the specified channel currently selected.

Name	Type	Values	Description
<source>opt	enum	CH1 \| CH2 \| CH3 \| ALL \| SERies \| PARallel	Specifies the channel or loop source to measure.

real - Returns the measured current value at the output terminal of the specified channel.

:MEAS:ALL? CH1 /*Queries the voltage, current, and power measured
at the output terminal of CH1. The query returns
2.0000,0.0500,0.100.*/

:MEASure[:SCALar]:CURRent:DATA?query

Queries the current data measured at the output terminal of the specified channel. If <source> is omitted, the specified channel is queried by default.

Name	Type	Values	Description
sourceopt	discrete	CH1 \| CH2 \| CH3	Specifies the channel whose current data is queried.

string - Returns a string starting with #, followed by a data block header and the specified current parameters.

:MEAS:CURR:DATA? CH1 /*Queries the 512 current parameters measured at the output terminal of CH1.*/

:MEASure[:SCALar]:POWEr[:DC]?query

Queries the power measured at the output terminal of the specified channel. If <source> is omitted, it queries the power measured on the output terminal of the currently selected channel.

Name	Type	Values	Description
sourceopt	enum	CH1 \| CH2 \| CH3 \| ALL \| SERies \| PARallel	Specifies the channel or loop whose output-terminal power is queried.

real - Returns the power measured on the output terminal of the specified channel, for example, 0.100.

:MEAS:POWE? CH1 /*Queries the power measured on the output terminal of CH1. The query returns 0.100.*/

:MEASure[:SCALar][:VOLTage][:DC]?query

Queries the voltage measured at the output terminal of the specified channel.

Name	Type	Values	Description
sourceopt	enum	CH1 \| CH2 \| CH3 \| ALL \| SERies \| PARallel	Selects the channel or loop whose output-terminal voltage is queried.

real - Returns the voltage measured on the output terminal of the specified channel.

:MEASure[:SCALar][:VOLTage]:DATA?query

Queries the voltage data measured at the output terminal of the specified channel. If <source> is omitted, the command queries the voltage data measured at the output terminal of the specified channel.

Name	Type	Values	Description
sourceopt	enum	CH1 \| CH2 \| CH3	Specifies the channel whose voltage data is queried.

string - Returns a string starting with #.

:MEMory:CATalog?query

Queries all the files and folders in the current path.

string - Returns the names of all files and folders in the current path.

:MEMory:CDIRectoryset / query

Sets or queries the current directory.

Name	Type	Values	Description
directory_name	string	-	The current directory to set; must be a valid directory name.

string - The current directory, for example C:/.

:MEMory:CDIRectory C:/ /*Sets the current directory to C disk.*/
:MEMory:CDIRectory? /*Queries the current directory. The query returns C:/.*/

:MEMory:DELeteset / query

Deletes the specified file and empty folders in the current directory.

Name	Type	Values	Description
filename	string	-	Name of the file to be deleted, or the name of the empty folder.

:MEM:DEL NEW.RSF /*Deletes the state file named NEW in the current directory.*/

:MEMory:DISK?query

Queries the available external storage disk(s).

returns

:MEMory:LOADset / query

Reads the specified file stored in the current directory, including state file (.RSF) and Arb file (.RTF).

Name	Type	Values	Description
filename	string	-	Filenames (with suffix) of the files stored in the current directory

:MEM:LOAD NEW.RSF /*Reads the file named NEW.RSF in the current directory.*/

:MEMory:LOCKset / query

Locks or unlocks the specified file stored in C disk, or queries whether the specified file in C disk is locked.

Name	Type	Values	Description
filename	string	-	The filename of the file stored in C disk; it must be an existing filename with suffix.
bool	enum	0 \| 1 \| ON \| OFF	Locks or unlocks the specified file.

:MEM:LOCK NEW.RSF,ON /*Locks the file named NEW.RSF in C disk.*/
:MEM:LOCK? NEW.RSF /*Queries whether the file named NEW.RSF in C disk is locked. The query returns 1.*/

:MEMory:MDIRectoryset / query

Creates a new folder in the current directory.

Name	Type	Values	Description
<folder_name>	string	-	Name of the folder to create.

:MEMory:STOReset / query

Saves the file including the instrument state file (.RSF) and Arb file (.RTF) with the specified filename in the current directory.

Name	Type	Values	Description
filename	string	-	Filename with the file extension .RSF/.RTF to use when saving the file.

:MEMory:VALid?query

Queries whether the specified file is stored in the current directory.

Name	Type	Values	Description
filename	string	-	The filename with suffix, which can contain Chinese characters, English letters as well as numbers.

integer - Returns 0 or 1 indicating whether the specified file is stored in the current directory.

" :MEM:VAL? NEW.RSF /*Queries whether the the state file named NEW is stored in the current directory. The query returns 1.*/"

:OUTPut:CVCC?query

Queries the output mode for the specified channel. If <source> is omitted, it queries the output mode of the current channel.

Name	Type	Values	Description
sourceopt	discrete	CH1 \| CH2 \| CH3	Specifies the channel whose output mode is queried.

enum - Returns the output mode of the specified channel.

:OUTPut:MODE?query

Queries the output mode (CV, CC, or UR) for the specified channel. If <source> is omitted, the current channel is queried.

Name	Type	Values	Description
sourceopt	enum	CH1 \| CH2 \| CH3	Specifies the output channel to query.

enum - Returns the output mode of the specified channel.

:OUTP:MODE? CH1 /*Queries the current output mode of CH1. The query returns CV.*/

:OUTPut:OCP:ALAR?query

Queries the OCP alarm state for the specified channel. If <source> is omitted, the command queries the current channel.

Name	Type	Values	Description
<source>opt	enum	CH1 \| CH2 \| CH3	Channel to query.

:OUTPut:OCP:QUES?query

Queries whether an overcurrent protection (OCP) event occurred on the specified channel.

Name	Type	Values	Description
sourceopt	enum	CH1 \| CH2 \| CH3	Channel to query.

enum - The query returns 0 or 1.

:OUTPut:OCP:ALAR? CH1 /*Queries whether an overcurrent protection
(OCP) event occurred on CH1.*/

:OUTPut:OCP:CLEarset / query

Clears an overcurrent protection (OCP) event on the specified channel. If <source> is omitted, it clears the OCP event on the current channel.

Name	Type	Values	Description
<source>opt	discrete	CH1 \| CH2 \| CH3	Channel on which to clear the OCP event.

::OUTP:OCP:CLE CH1 /*Clears an OCP event that occurred on CH1.*/

:OUTPut:OCP:DELayset / query

Sets or queries the time in milliseconds that the overcurrent protection (OCP) is temporarily disabled. If <source> is omitted, the command executes on the current channel.

Name	Type	Values	Description
sourceopt	discrete	CH1 \| CH2 \| CH3	Selects the channel source.
value	real	0 - 1000	Sets the OCP delay time.
qualifieropt	enum	MINimum \| MAXimum	Selects the minimum or maximum OCP delay.

real (ms) - Returns the OCP delay in milliseconds, for example 200 ms.

:OUTPut:OCP:DELay CH1 200 /*Sets the OCP delay to 200 ms for CH1.*/
:OUTPut:OCP:DELay? CH1 /*Queries the OCP delay for CH1. The query returns 200ms.*/

:OUTPut:OCP[:STATe]set / query

Sets or queries the overcurrent protection (OCP) state. If <source> is omitted, the command acts on the current channel.

Name	Type	Values	Description
sourceopt	discrete	CH1 \| CH2 \| CH3	Selects the source channel.
bool	boolean	-	Enables or disables OCP.

boolean - Returns the OCP state.

:OUTPut:OCP:VALueset / query

Sets or queries the overcurrent protection (OCP) level of the specified channel. If <source> is omitted, the command applies to the current channel.

Name	Type	Values	Description
sourceopt	enum	CH1 \| CH2 \| CH3	Specifies the channel to use.
value	real	-	Sets the OCP level.
lim	enum	lim	Query qualifier as documented in the syntax line.

:OUTPut:OVP:ALAR?query

Queries whether an overvoltage protection (OVP) event occurred on the specified channel.

Name	Type	Values	Description
sourceopt	enum	CH1 \| CH2 \| CH3	Specifies the channel to query.

boolean - Returns whether an OVP event occurred on the specified channel.

:OUTPut:OVP:QUES?query

Queries whether an overvoltage protection (OVP) event occurred on the specified channel. If <source> is omitted, it queries the current channel.

Name	Type	Values	Description
sourceopt	discrete	CH1 \| CH2 \| CH3	Channel to query for an OVP event.

integer - Returns 1 if an OVP event occurred, or 0 otherwise.

:OUTP:OVP:QUES? CH1 /*Queries whether an OVP event occurred on
CH1.*/

:OUTPut:OVP:CLEarset / query

Clears an overvoltage protection (OVP) event occurred on the specified channel. If <source> is omitted, the command clears an OVP event that occurred on the current channel.

Name	Type	Values	Description
sourceopt	enum	CH1 \| CH2 \| CH3	Channel on which to clear the OVP event.

:OUTPut:OVP[:STATe]set / query

Sets the on/off state of the overvoltage protection (OVP) function of the specified channel.

Name	Type	Values	Description
sourceopt	discrete	CH1 \| CH2 \| CH3	Specifies the channel.
state	boolean	-	Turns OVP on or off.

:OUTP:OVP CH1,ON
:OUTP:OVP? CH1

:OUTPut:OVP:VALueset / query

Sets or queries the overcurrent protection (OVP) level for the specified channel.

Name	Type	Values	Description
sourceopt	enum	CH1 \| CH2 \| CH3	Specifies the channel.
value	real	-	OVP level to set.
lim	enum	MINimum \| MAXimum	Limit keyword used in the command syntax.

real - Returns the OVP level for the specified channel.

:OUTPut:PAIRset / query

Sets or queries the channel connection mode.

Name	Type	Values	Description
type	enum	OFF \| PARallel \| SERies	Channel connection mode to set.

enum - The query returns the connection mode.

:OUTPut[:STATe]set / query

Sets or queries the on/off state for the specified channel. If <source> is omitted, the command executes the corresponding operation on the current channel.

Name	Type	Values	Description
sourceopt	discrete	CH1 \| CH2 \| CH3 \| ALL	Channel whose output state is controlled.
bool	boolean	0 \| 1 \| ON \| OFF	On/off state to set.

enum - The query returns 1 or 0.

:OUTP CH1,ON /*Enables the output for CH1.*/
:OUTP? CH1 /*Queries whether the CH1 output is enabled. The query returns 1*/

:OUTPut:TRACk[:STATe]set / query

Sets or queries the on/off state of the tracking function.

Name	Type	Values	Description
bool	enum	0 \| 1 \| ON \| OFF	Turns tracking on or off.

enum - The query returns 1 or 0.

:STATus:OPERation:CONDition?query

Queries the value of the condition register of the Operation Status register.

integer - Returns the value of the condition register.

:STATus:OPERation:ENABleset / query

Enables the bits in the enable register of the Operation Status register. The query returns a decimal value corresponding to the binary-weighted sum of the bits enabled in that register.

Name	Type	Values	Description
<value>	integer	-	Decimal value corresponding to the binary-weighted sum of the bits to be enabled in the enable register of the Operation Status register.

STATus:OPERation:ENABle 16 /*Enables bit4 in the enable register.*/
:STATus:OPERation:ENABle? /*Queries the enabled bits. The query returns +16.*/

:STATus:OPERation[:EVENt]?query

Queries the value of the event register of the Operation Status register. The query returns a decimal value corresponding to the binary-weighted sum of all bits set in the register, and clears the status register.

integer - Decimal value corresponding to the binary-weighted sum of the bits in the register; for example, +17.

:STAT:OPER? /*Queries the value of the event register of the Operation Status register.*/

:STATus:PRESetset / query

Sets the enable registers of the Questionable Status register to their power-on defaults.

:STATus:PRESet /*Sets the enable registers of the Questionable Status register to their power-on defaults.*/

:STATus:QUEStionable:ENABleset / query

Sets the enable register of the Questionable Status register. The query returns the enabled bits in that register as a decimal value.

Name	Type	Values	Description
enable value	integer	-	Decimal value corresponding to the binary-weighted sum of the bits to be enabled in the Questionable Status register.

integer - Returns a decimal value corresponding to the binary-weighted sum of the bits enabled in the Questionable Status register.

:STAT:QUES:ENAB 17 /*Enables bit0 and bit4 in the enable register
:STAT:QUES:ENAB? /*Queries the enabled bits in the enable register

:STATus:QUEStionable[:EVENt]?query

Queries the enable register of the Questionable Status register.

integer - Returns the decimal value corresponding to the binary-weighted sum of the bits enabled in the enable register of the Questionable Status register.

:STATus:QUEStionable:INSTrument:ENABleset / query

Enables the bits in the enable register of the Questionable Status register. The query returns the enabled bits in that register.

Name	Type	Values	Description
enable value	integer	-	Decimal value corresponding to the binary-weighted sum of the bits to be enabled in the enable register of the Questionable Status register.

integer - Decimal value corresponding to the binary-weighted sum of the bits set in the enable register of the Questionable Status register.

:STATus:QUEStionable:INSTrument[:EVENt]?query

Queries the event register of the channel Questionable Status register. Reading the register returns a decimal value and clears the status of the register.

integer - Decimal value corresponding to the binary-weighted sum of all bits set in the event register of the channel Questionable Status register. Reading the register clears it.

:STAT:QUES:INST? /*Queries the event register of the channel Questionable Status register. The query returns +10.*/

:STATus:QUEStionable:INSTrument:ISUMmary[<n>]:CONDition?query

Queries the output mode for the specified channel. If <n> is omitted, the current channel is queried; the query returns +0, +1, +2, or +3.

Name	Type	Values	Description
nopt	integer	1 - 3	Channel number to query.

integer - Returns +0 for output off, +1 for CC mode, +2 for CV mode, or +3 for UR mode.

:STAT:QUES:INST:ISUM1:COND? /*Queries the output mode of CH1. The
query returns +1.*/

:STATus:QUEStionable:INSTrument:ISUMmary[<n>]:ENABleset / query

Enables bits in the enable register of the specified channel Questionable Status SUMMARY register. The query version returns the decimal value corresponding to the enabled bits.

Name	Type	Values	Description
nopt	discrete	1 - 3	Specifies the channel number for multi-channel models.
enable value	integer	-	Decimal value corresponding to the binary-weighted sum of bits to enable in the register.

:STATus:QUEStionable:INSTrument:ISUMmary[<n>][:EVENt]?query

Queries the value of the event register of the specified channel Questionable Status SUMMARY register. Reading the register clears it.

Name	Type	Values	Description
nopt	discrete	1 - 3	Specifies the channel number for multi-channel models.

integer - Returns a decimal value corresponding to the binary-weighted sum of the bits enabled in the channel Questionable Status SUMMARY register; reading clears the register.

:STAT:QUES:INST:ISUM1? /*Queries the value of the event register of the Questionable Status SUMMARY register for CH1. The query returns +1.*/

:SYSTem:BEEPer:IMMediateset / query

Issues a single beep immediately.

:SYSTem:BEEPer[:STATe]set / query

Sets or queries the on/off state of the beeper.

Name	Type	Values	Description
bool	enum	ON \| OFF \| 1 \| 0	On/off state of the beeper.

:SYSTem:BRIGhtnessset / query

Sets or queries the brightness of the LCD screen.

Name	Type	Values	Description
brightness	integer	1 - 100	Brightness value to set for the LCD screen.
limopt	enum	MINimum \| MAXimum	Optional query qualifier that returns the minimum or maximum brightness value available.

integer - Returns the current brightness value, for example 60. With the optional <lim> qualifier, returns the corresponding minimum or maximum brightness value.

:SYST:BRIG 60 /*Sets the screen brightness to 60%.*/
:SYST:BRIG? /*Queries the screen brightness. The query returns 60.*/

:SYSTem:COMMunicate:LANset / query

:SYSTem:COMMunicate:LAN:APPLyset / query

Applies the network parameters currently set. The new setting is valid only when executed after the LAN parameters are set.

*SYST:COMM:LAN:APPL /*Applies the network parameters currently set.*/

:SYSTem:COMMunicate:LAN:AUTOip[:STATe]set / query

Sets or queries the on/off state of Auto IP.

Name	Type	Values	Description
bool	boolean	-	On/off state of Auto IP.

boolean - Returns the on/off state of Auto IP.

:SYSTem:COMMunicate:LAN:DHCP[:STATe]set / query

Sets or queries the on/off state of DHCP. In DHCP mode, the DHCP server in the current network assigns network parameters such as the IP address to the instrument.

Name	Type	Values	Description
bool	enum	0 \| 1 \| ON \| OFF	On/off state of DHCP.

enum - The query returns 1 or 0.

:SYSTem:COMMunicate:LAN:DNSset / query

Sets or queries the Domain Name Service (DNS) address. The command is valid only when Manual IP is enabled, and the address format is nnn.nnn.nnn.nnn.

Name	Type	Values	Description
dns	string	-	DNS address to set.

string - Returns the DNS address.

:SYSTem:COMMunicate:LAN:IPADdressset / query

Sets or queries the IP address. The command is valid only when Manual IP is enabled, and the IP format is nnn.nnn.nnn.nnn.

Name	Type	Values	Description
ip	string	-	IP address to set.

string - Returns the IP address, for example, 172.16.3.128.

:SYSTem:COMMunicate:LAN:GATEwayset / query

Sets or queries the default gateway. The command is valid only when Manual IP is enabled and the network parameters should be applied with :SYSTem:COMMunicate:LAN:APPLy after setting it.

Name	Type	Values	Description
gateway	string	-	Default gateway address in nnn.nnn.nnn.nnn format.

string - Returns the default gateway address, for example 172.16.3.1.

:SYST:COMM:LAN:GATE 172.16.3.1 /*Sets the default gateway to
:SYST:COMM:LAN:GATE? /*Queries the current default gateway. The

:SYSTem:COMMunicate:LAN:MAC?query

Queries the LAN MAC address.

string - Returns the LAN MAC address.

:SYSTem:COMMunicate:LAN:MANualip[:STATe]set / query

Sets or queries the on/off state of Manual IP.

Name	Type	Values	Description
bool	enum	0 \| 1 \| ON \| OFF	Boolean state for Manual IP.

enum - Returns the on/off state of Manual IP.

:SYSTem:COMMunicate:LAN:SMASkset / query

Sets or queries the subnet mask. The command is valid only when Manual IP is enabled, and after sending it you must execute :SYSTem:COMMunicate:LAN:APPLy to apply the current network parameters.

Name	Type	Values	Description
submask	string	-	Subnet mask in the format nnn.nnn.nnn.nnn, where each nnn ranges from 0 to 255.

string - Returns the subnet mask.

:SYSTem:COMMunicate:RLSTateset / query

Sets the power supply to remote, local, or remote lock mode. Queries the current operation mode.

Name	Type	Values	Description
mode	enum	LOCal \| REMote \| RWLock	Operation mode to set.

enum - Returns the current operation mode.

:SYSTem:COMMunicate:RLSTate REMote /*Sets the power supply to remote mode.*/
:SYSTem:COMMunicate:RLSTate? /*Queries the operation mode. The query returns REMote.*/

:SYSTem:COMMunicate:RS232set / query

Sets or queries the RS232 interface settings. This section is the parent heading for the RS232 command group; the slice documents the BAUD subcommand, not a standalone :SYSTem:COMMunicate:RS232 action.

:SYSTem:COMMunicate:RS232:BAUDset / query

Sets or queries the baud rate of the RS232 interface. The unit is Baud.

Name	Type	Values	Description
baud	enum	9600 \| 19200 \| 38400 \| 57600 \| 115200	Baud rate of the RS232 interface.

enum (Baud) - The query returns the baud rate, for example, 19200.

:SYST:COMM:RS232:BAUD 19200 /*Sets the baud rate of the RS232
interface to 19200.*/
:SYST:COMM:RS232:BAUD? /*Queries the baud rate of the RS232
interface. The query returns 19200.*/

:SYSTem:COMMunicate:RS232:DBITset / query

Sets or queries the data bit of the RS232 interface.

Name	Type	Values	Description
databit	-	-

:SYSTem:COMMunicate:RS232:PBITset / query

Sets or queries the parity check of the RS232 interface.

Name	Type	Values	Description
bit	enum	NONE \| ODD \| EVEN	Parity check setting for RS232.

enum - The query returns the current parity check setting.

:SYST:COMM:RS232:PBIT ODD /*Sets the parity check to Odd.*/
:SYST:COMM:RS232:PBIT? /*Queries the parity check. The query returns ODD.*/

:SYSTem:ERRor[:NEXT]?query

Queries and removes errors from the error queue. Errors are retrieved in first-in-first-out (FIFO) order.

string - Returns the next error from the queue.

:SYSTem:COMMunicate:RS232:SBITset / query

Sets or queries the stop bit of RS232.

Name	Type	Values	Description
n	enum	1 \| 2	Stop bit setting.

enum - The query returns 1 or 2.

:SYSTem:KLOCk:STATeset / query

Sets or queries the on/off state of remote lock.

Name	Type	Values	Description
<bool>	enum	0 \| 1 \| ON \| OFF	On/off state of remote lock.

enum - The query returns 1 or 0.

:SYST:KLOC:STAT ON /*Enables the remote lock.*/
:SYST:KLOC:STAT? /*Queries the on/off state of remote lock. The query returns 1.*/

:SYSTem:LANGuage:TYPEset / query

Sets or queries the system language.

Name	Type	Values	Description
type	enum	EN \| CH \| DE \| ES \| FR	Sets the system language.

enum - The query returns ENGLISH, CHINESE, GERMAN, SPANISH, or FRENCH.

:SYST:LANG:TYPE EN /*Sets the system language to English.*/
:SYST:LANG:TYPE? /*Queries the system language. The query returns
ENGLISH.*/

:SYSTem:LOCalset / query

Returns the power supply from remote mode to local mode.

:SYSTem:POWEronset / query

Sets or queries the power-on setting.

Name	Type	Values	Description
poweron	enum	DEFault \| LAST	Selects the power-on setting to use after startup.

enum - Returns the power-on setting used at startup.

:SYST:POWE LAST /*Sets the instrument to use the system configuration before the last power-off at power-on.*/
:SYST:POWE? /*Queries the instrument configuration to be used at power-on. The query returns LAST.*/

:SYSTem:PRINt?query

Queries the byte stream of the current screen image.

string - Returns the hexadecimal string of the screen image in bitmap (*.bmp) format.

:SYSTem:REMoteset / query

Returns the power supply from local mode to remote mode.

:SYSTem:RWLockset / query

Enables or disables remote lock. If <bool> is omitted, the command enables the remote lock.

Name	Type	Values	Description
stateopt	boolean	-	Enables or disables remote lock.

:SYST:RWL ON /*Enables the remote lock.*/

:SYSTem:SAMPlingset / query

Sets or queries the sampling mode.

Name	Type	Values	Description
mode	enum	AUTO \| HIGH \| LOW	Selects the sampling mode.

enum - Returns the current sampling mode.

:SYSTem:SAMPling HIGH /*Sets the sampling mode to high range mode.*/
:SYSTem:SAMPling? /*Queries the sampling mode. The query returns HIGH.*/

:SYSTem:SAVerset / query

Sets or queries the on/off state of the screen saver function.

Name	Type	Values	Description
bool	boolean	1 \| 0 \| ON \| OFF	On/off state of the screen saver function.

integer - The query returns 1 or 0.

@SYST:SAV ON /*Enables the screen saver function.*/
@SYST:SAV? /*Queries the on/off state of the screen saver function.
The query returns 1.*/

:SYSTem:SENSeset / query

Sets or queries the on/off state of the Sense function for the specified channel.

Name	Type	Values	Description
source	enum	CH1 \| CH2 \| CH3 \| ALL	Specifies the channel whose Sense function is controlled.
bool	enum	1 \| 0 \| ON \| OFF	Turns the Sense function on or off.

:SYSTem:SYNC[:STATe]set / query

Sets or queries the state of the on/off sync function. For CH1 and CH2, the state of one channel changes accordingly when the other is modified; the command is valid only when tracking is enabled.

Name	Type	Values	Description
<bool>	boolean	0 \| 1 \| ON \| OFF	State of the sync function.

enum - The query returns the sync state as 1 or 0.

:SYST:SYNC ON /*Enables the on/off sync function.*/
:SYST:SYNC? /*Queries the state of the on/off sync function. The query returns 1.*/

:SYSTem:TMODeset / query

Sets or queries the tracking function on/off state. The command functions the same as :OUTPut:TRACk[:STATe].

Name	Type	Values	Description
trackmode	enum	SYNC \| INDE	Selects the track mode.

enum - The query returns SYNCHRONOUS or INDEPENDENT.

:SYST:TMOD SYNC /*Enables the track mode.*/
:SYST:TMOD? /*Queries the on/off status of the track mode. The query returns SYNCHRONOUS.*/

:SYSTem:TLOCkset / query

Sets or queries the tracking lock state.

Name	Type	Values	Description
<bool>	boolean	-

:SYSTem:VERSion?query

Queries the present SCPI version of the system.

string - A string in the form YYYY.V, where YYYY is the year of the version and V is the current SCPI version number.

:SYST: VERS? /*Queries the present SCPI version of the system. The query returns 1999.0.*/

:TIMEr:CYCLEsset / query

Sets or queries the repetition cycle for the currently selected channel. The cycle can be infinite or a specified count.

Name	Type	Values	Description
cycle	enum	N \| I	Selects infinite repetition or a specified cycle count.
valueopt	integer	1 - 99999	Specifies the number of cycles when the cycle mode is N.

enum - Returns the repetition cycle setting as I or N,<value> (for example, N,20).

:TIME:CYCLE N,20 /*Sets the repetition cycle to 20.*/
:TIME:CYCLE? /*Queries the repetition cycle. The query returns
N,20.*/

:TIMEr:CHANNelset / query

Sets or queries the channel currently edited.

Name	Type	Values	Description
<ch>	enum	CH1 \| CH2 \| CH3	Selects the channel currently edited.

enum - The query returns the currently edited channel.

":TIMEr:CHANNel CH2"
":TIMEr:CHANNel?"

:TIMEr:ENDStateset / query

Sets or queries the end state of the generator. End state refers to the state of the instrument after it has completed outputting groups of voltage/current when the number of cycles is finite.

Name	Type	Values	Description
<end>	enum	OFF \| LAST	End state to use after finite-cycle output completes.

:TIMEr:GROUPs:NUM?query

Queries the number of output groups in the Arb editor.

integer - Returns the number of output groups.

:TIME:GROUP:NUM? /*Queries the number of output groups. The query returns 25.*/

:TIMEr:GROUP:PARAmeterset / query

Inserts a group of data to the currently selected row in the Arb editor. The query returns the parameters of one or more groups starting from the index set by :TIMEr:GROUP:INDEx.

Name	Type	Values	Description
volt	real	V	Voltage of the group.
curr	real	A	Current of the group.
time	real	3600 s	Time of the group.
groupcountopt	integer	1 - 512	Number of groups to query.

string - Returns a string starting with # containing the requested group parameter data in a data block format.

:TIMEr:GROUP:DELeteset / query

Deletes groups of parameters starting from the group currently edited.

Name	Type	Values	Description
groupcountopt	integer	1 - 512	The number of groups to be deleted.

:TIMEr:GROUP:DELete 2 /*Deletes the 25th and 26th group of
parameters.*/

:TIMEr:RUNset / query

Sets or queries the run type of the generator.

Name	Type	Values	Description
run	enum	CONTinue \| SINGle	Run type to set for the generator.

:TIMEr[:STATe]set / query

Sets or queries the run/stop state of the generator.

Name	Type	Values	Description
<bool>	enum	0 \| 1 \| ON \| OFF	Run/stop state.

enum - Returns the current run/stop state as ON or OFF.

:TIMEr:TEMPlet:CONSTructset / query

Sets the Arb parameters based on the currently selected template and the parameters already set.

:TIMEr:TEMPlet:CONSTruct /*Sets the Arb parameters based on the template currently selected and the parameters set.*/

:TIMEr:TEMPlet:FALLRateset / query

Sets or queries the fall index of ExpFall.

Name	Type	Values	Description
value	real	-	Fall index value for ExpFall.

:TIMEr:TEMPlet:INTErvalset / query

Sets or queries the Time Interval for the currently selected template. It is not available for Stair Up, Stair Dn, Stair UpDn, and Pulse.

Name	Type	Values	Description
value	real	0.001 - 3600	Time interval required for the instrument to output each group of parameters using the selected template.

real - Returns the time interval as a real number, for example 15.000.

:TIMEr:TEMPlet:INTErval <value>
:TIMEr:TEMPlet:INTErval?

:TIMEr:TEMPlet:INVErtset / query

Sets or queries the on/off state of the invert function of the currently selected template.

Name	Type	Values	Description
bool	enum	0 \| 1 \| ON \| OFF	Selects whether the template invert function is enabled or disabled.

enum - The query returns 1 or 0.

:TIME:TEMP:INVE ON /*Enables the invert function for the template currently selected.*/
:TIME:TEMP:INVE? /*Queries whether the invert function is enabled. The query returns 1.*/

:TIMEr:TEMPlet:MAXValueset / query

Sets or queries the maximum voltage or current value of the selected template.

Name	Type	Values	Description
value	real	-	Maximum voltage or current value to set.
qualifieropt	enum	MINimum \| MAXimum	Optional keyword to use the minimum or maximum allowed value.

:TIMEr:TEMPlet:MINValueset / query

Sets or queries the minimum voltage or current value of the currently selected template.

Name	Type	Values	Description
value	real	-	Voltage or current range of the channel currently selected.
qualifieropt	enum	MINimum \| MAXimum	Query qualifier that returns the minimum or maximum available value.

real - Returns the minimum voltage or current of the template currently selected.

:TIMEr:TEMPlet:OBJectset / query

Sets or queries the editing object of the currently selected template, and updates the corresponding current or voltage value. For the query form, it returns the minimum voltage or current value of the selected template.

Name	Type	Values	Description
obj	enum	V \| C	Selects voltage or current as the editing object.
valueopt	real	0	Sets the corresponding current or voltage value; when omitted, the object is set alone.
qualifieropt	enum	MINimum \| MAXimum	Use MINimum or MAXimum in place of a numeric value.

:TIMEr:TEMPlet:PERIodset / query

Sets or queries the period of the waveform. The period is required for all waveforms except ExpRise and ExpFall.

Name	Type	Values	Description
value	real	0.001 s - 3600 s	Duration of one waveform cycle.

returns

:TIMEr:TEMPlet:POINTsset / query

Sets or queries the total number of points. The total number of points refers to the number of groups of parameters created based on the currently selected template.

Name	Type	Values	Description
value	integer	1 - 512	Total number of points.

integer - The query returns the total number of points currently set.

:TIME:TEMP:POINT 80 /*Sets the total number of points to 80.*/
:TIME:TEMP:POINT? /*Queries the total number of points currently
set. The query returns 80.*/

:TIMEr:TEMPlet:RISERateset / query

Sets or queries the rise index of ExpRise.

Name	Type	Values	Description
value	integer	0 - 10	Rise index of ExpRise.

integer - The query returns an integer between 0 and 10, for example, 5.

:TIME:TEMP:RISER 5 /*Sets the rise index of ExpRise to 5.*/
:TIME:TEMP:RISER? /*Queries the rise index of ExpRise currently set. The query returns 5.*/

:TIMEr:TEMPlet:SELectset / query

Sets or queries the template type.

Name	Type	Values	Description
temp	enum	SINE \| PULSE \| RAMP \| UP \| DN \| UPDN \| RISE \| FALL	Template type to select.

:TIMEr:TEMPlet:SYMMetryset / query

Sets or queries the Symmetry of Ramp. Symmetry is specified as the ratio of the duration of the rising edge within a period to the whole period.

Name	Type	Values	Description
value	integer	0 - 100	Symmetry value.

real (%) - The query returns the symmetry, for example, 60%.

:TIME:TEMP:SYMM 60 /*Sets the Symmetry to 60%.*/
:TIME:TEMP:SYMM? /*Queries the Symmetry. The query returns 60%.*/

:TIMEr:TEMPlet:WIDThset / query

Sets or queries the width of the selected template.

Name	Type	Values	Description
<value>	real	-	Width value for the template.

:TIMEr:TEMPlet:STAIrset / query

Sets or queries the number of steps between the maximum and minimum for StairUp, StairDn, or StairUpDn.

Name	Type	Values	Description
val	integer	3 - 99999	Number of steps between the maximum and minimum.

integer - The query returns the number of steps as an integer.

:TIMEr:TRIGset / query

Sets or queries the Trigger Source. The trigger source specifies how the arbitrary waveform output is started.

Name	Type	Values	Description
trig	enum	MANual \| BUS	Selects the trigger source.

enum - Returns the trigger source as MANual or BUS.

:TRIGger:IN[:ENABle]set / query

Sets or queries the on/off state of the trigger input function for the specified data line.

Name	Type	Values	Description
d	discrete	D1 \| D2 \| D3 \| D4	Specified data line.
bool	boolean	1 \| ON \| 0 \| OFF	Enables or disables the trigger input function.

:TRIG:IN D1,ON /*Enables the trigger input function for D1.*/
:TRIG:IN? D1 /*Queries the on/off state of the trigger input function for D1. The query returns 1.*/

:TRIGger:IN:IMMEdiateset / query

As soon as the trigger system is initiated, the analog hardware sends the trigger signal immediately.

:TRIGger:IN:RESPonseset / query

Sets or queries the output response of the trigger input for the specified data line.

Name	Type	Values	Description
d	enum	D1 \| D2 \| D3 \| D4	Specified data line.
res	enum	ON \| OFF \| ALTER	Output response for the trigger input.

enum - Returns the output response of the trigger input for the specified data line.

:TRIGger:IN:SOURceset / query

Sets or queries the source under control of the trigger input for the specified data line.

Name	Type	Values	Description
d	discrete	D1 \| D2 \| D3 \| D4	Specifies the data line.
ch	string	-	Selects one or more channels from CH1, CH2, and CH3 as the source under control.

string - Returns the name of the source under control; if multiple channels are selected, they are separated by commas.

:TRIG:IN:SOUR D1,CH1,CH2 /*Sets the source under control of D1
trigger input to CH1 and CH2.*/

:TRIGger:IN:TYPEset / query

Sets or queries the trigger type of the trigger input for the specified data line.

Name	Type	Values	Description
d	enum	D1 \| D2 \| D3 \| D4	Specifies the data line whose trigger input type is set or queried.
type	enum	RISE \| FALL \| HIGH \| LOW	Selects the trigger type: rising edge, falling edge, high level, or low level.

enum - Returns the trigger type of the specified trigger input.

:TRIG:IN:TYPE D1,FALL /*Sets the trigger type of D1 trigger input to the falling edge.*/
:TRIG:IN:TYPE? D1 /*Queries the trigger type of D1 trigger input. The query returns FALL.*/

:TRIGger:OUT:POLArityset / query

Sets or queries the output response of the trigger output for the specified data line.

Name	Type	Values	Description
d	discrete	D1 \| D2 \| D3 \| D4	Specifies the data line for the trigger output.
pol	discrete	-	Sets the polarity or response of the trigger output.

:TRIGger:OUT:SOURceset / query

Sets or queries the control source of the trigger output function of the specified data line.

Name	Type	Values	Description
d	enum	D1 \| D2 \| D3 \| D4
source	enum	CH1 \| CH2 \| CH3

returns

:TRIGger:OUT[:ENABle]set / query

Sets or queries the on/off state of the trigger output function for the specified data line.

Name	Type	Values	Description
d	discrete	D1 \| D2 \| D3 \| D4	Specified data line.
bool	boolean	0 \| 1 \| ON \| OFF	On/off state of the trigger output function.

:TRIG:OUT D1,ON /*Enables the trigger output function of D1.*/
:TRIG:OUT? D1 /*Queries the on/off state of the D1 trigger output function. The query returns 1.*/

Products

Industries

Company

Blog

Rigol DP2031

Rigol DP2031

All commands

▶ANALyzer7

▶APPLy1

▶*15

▶INSTrument3

▶LIC2

▶MEASure6

▶MEMory9

▶OUTPut16

▶STATus11

▶SYSTem34

▶TIMEr23

▶TRIGger8