*CLSset / query
Clears all the event registers.
SCPI COMMAND REFERENCE
The Rigol DL3021 is Rigol's electronic load in the DL3000 Series family. Its SCPI remote-control interface exposes 53 commands across 7 subsystems - 16 settable and 37 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.
53
Commands
16
Settable
37
Queries
7
Subsystems
SCPI
Verified
2026-07-16
All commands
53 of 53 commands
*ESEset / query
Enables the bit in the enable register part of the standard event status register. The query returns the decimal value corresponding to the enabled bits in that register.
| Name | Type | Values | Description |
|---|---|---|---|
| enable value | integer | 0 | Decimal value corresponding to the binary-weighted sum of the enabled bits in the standard event status register. |
*ESE 20 *ESE?
*ESR?query
Queries the event status register of the standard event status register. The query returns a decimal value and also clears the register.
integer - Returns a decimal value corresponding to the binary-weighted sum of all bits in the event register part of the standard event status register.
*ESR? /*Queries the event register part of the standard event status register. The query returns 20*/
*IDN?query
Queries the instrument information.
string - Returns the instrument information in strings, which includes four parts: manufacturer, model number, serial number, and the version number of the digital board. The four parts are separated by commas.
*OPCset / query
Sets bit 0 (operation complete) in the standard event status register after the command completes. The query form *OPC? returns "1" when the operation is complete.
*OPC *OPC?
*OPT?query
Queries the installation status of the installed options. Installed options are returned by name, and unavailable options are returned as 0, with multiple options separated by commas.
enum - Returns the installation status of the option. Different options are separated by commas; installed options return the option name, otherwise 0.
*OPT?
*PSCset / query
Enables or disables clearing of the enable register part of the status byte register and the standard event status register at power-on. The query reports whether power-on clearing is enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | 1 | Enables (1) or disables (0) clearing at power-on. |
enum - Returns whether power-on clearing of the affected registers is enabled.
*PSC 1 *PSC?
*RSTset / query
Restores the instrument to factory default settings and clears the error queue.
*SREset / query
Enables bits in the enable register part of the status byte register. The query returns the enabled bits as a decimal value.
| Name | Type | Values | Description |
|---|---|---|---|
| enable value | integer | 0 - 65535 | Decimal value corresponding to the binary-weighted sum of the bits to enable in the register. |
integer - Decimal value corresponding to the binary-weighted sum of the bits enabled in the enable register part of the status byte register.
*SRE 24 *SRE?
*STB?query
Queries the condition register of the current status byte register. The query returns the decimal sum of the set bits and does not clear the register.
integer - Decimal value corresponding to the binary-weighted sum of all bits in the condition register of the status byte register.
*STB? /*Queries the condition register of the current status byte register. The query returns 72.*/
*TRGset / query
Generates a trigger action. The command is only applicable when the trigger source is set to bus (software) trigger.
*TRG
*TST?query
Queries the self-test results of the instrument. The query returns self-test results such as Vmon trig reference voltage, Imon trig reference voltage, and radiator temperature.
string - Returns the self-test results such as VmonTrig, ImonTrig, OcpRef, OvpRef, Temp1, and Temp2 status values.
*WAIset / query
Configures the instrument to wait for all pending operations to complete before executing any additional commands.
*WAI /*Configures the instrument to wait for all pending operations to complete before executing any additional commands.*/
Queries the condition register of the questionable status register.
decimal - Returns a decimal value corresponding to the binary-weighted sum of all bits in the questionable status register condition register.
:STAT:QUES:COND? /*Queries the condition register of the questionable status register. The query returns 1.*/
:STATus:QUEStionable:ENABleset / query
Enables bits in the enable register part of the questionable status register. The query returns the enabled bits as a decimal value.
| Name | Type | Values | Description |
|---|---|---|---|
| enable value | discrete | - | Decimal value corresponding to the binary-weighted sum of enabled bits in the questionable status register. |
:STAT:QUES:ENAB 17 /*Enables Bit 0 and Bit 4 in the enable register part of the questionable status register.*/ :STAT:QUES:ENAB? /*Queries the bit enabled in the enable register part of the questionable status register. The query returns 17.*/
Queries the event register of the questionable status register. The query returns a decimal value corresponding to the binary-weighted sum of the bits in the event register, and reading it clears the register.
integer - Decimal value corresponding to the binary-weighted sum of all bits in the event register part of the questionable status register; reading the register clears it.
::STAT:QUES?
:STATus:PRESetset / query
Clears all the bits in the event register part of the questionable status register. The cleared event registers include the query event enable register, channel summary event enable register, and operation event enable register; other registers are not affected.
:STAT:PRES /*Clears all the bits in the event register part of the questionable status register.*/
Queries the operation condition register of the questionable status register. It returns a decimal value corresponding to the binary-weighted sum of the bits in the register.
integer - Decimal value corresponding to the binary-weighted sum of all the bits in the register.
:STAT:OPER:COND? /*Queries the operation condition register of the questionable status register. The query returns 1.*/
:STATus:OPERation:ENABleset / query
Enables bits in the operation enable register of the questionable status register. The query form returns the enabled bits as a decimal value.
| Name | Type | Values | Description |
|---|---|---|---|
| enable value | integer | 0 - 65535 | Decimal value corresponding to the binary-weighted sum of the bit to be enabled in the enable register part of the questionable status register. |
:STAT:OPER:ENAB 17 :STAT:OPER:ENAB?
Queries the operation event register of the questionable status register. Reading the register returns a decimal value and clears the register.
decimal - The query returns a decimal value corresponding to the binary-weighted sum of all bits in the operation event register of the questionable status register; reading it clears the register.
:STAT:OPER? /*Queries the operation event register of the questionable status register. The query returns 17.*/
:FETCh:VOLTage[:DC]?query
Reads the input voltage of the instrument.
real - The query returns a real number.
:FETCh:VOLTage:MAX?query
Reads the maximum input voltage of the instrument.
real - The query returns a real number.
:FETCh:VOLTage:MIN?query
Reads the minimum input voltage of the instrument.
real - The query returns a real number.
:FETCh:CURRent[:DC]?query
Reads the input current of the instrument.
real - Returns the input current as a real number.
:FETCh:CURRent:MAX?query
Reads the maximum input current of the instrument.
real - The query returns a real number.
:FETCh:CURRent:MIN?query
Reads the minimum input current of the instrument.
real - The query returns a real number.
Reads the resistance of the instrument.
real - The query returns a real number.
:FETCh:POWer[:DC]?query
Reads the input power of the instrument.
real - The query returns a real number.
:FETCh:CAPability?query
Reads the battery capacity.
real - The query returns a real number.
:FETCh:WATThours?query
Reads the battery energy.
real - The query returns a real number.
Reads the discharge time of the battery.
real - The query returns a real number.
:FETCh:TIME?query
Reads the integration time of the instrument.
real (ms) - The query returns the integration time of 10 PLC. It is 200, and its unit is ms.
:FETCh:WAVedata?query
Reads the data points in the data cache area in the waveform display interface. The query returns 400 consecutive data points.
numeric - Returns 400 consecutive data points.
Reads the input voltage of the instrument.
real - The query returns a real number.
Reads the maximum input voltage of the instrument.
real - The query returns a real number.
Reads the minimum input voltage of the instrument.
real - The query returns a real number.
Reads the input current of the instrument.
real - The query returns a real number.
Reads the maximum input current of the instrument.
real - The query returns a real number.
Reads the minimum input current of the instrument.
real - The query returns a real number.
Reads the resistance of the instrument.
real - The query returns a real number.
:MEASure:POWer[:DC]?query
Reads the input power of the instrument.
real - The query returns a real number.
:MEASure:CAPability?query
Reads the battery capacity.
real - The query returns a real number.
:MEASure:WATThours?query
Reads the battery energy.
real - The query returns a real number.
Reads the discharge time of the battery.
real - The query returns a real number.
:MEASure:TIME?query
Reads the integration time of the instrument.
real (ms) - It is the integration time of 10 PLC. It is 200, and its unit is ms.
:MEASure:WAVedata?query
Reads the data points in the waveform display interface data cache area. The query returns 400 consecutive data points.
real - Returns 400 consecutive data points.
:TRIGgerset / query
When SCPI command trigger (Bus) is selected as the trigger source, executing this command immediately initiates a trigger.
:TRIG:SOUR BUS
:TRIGger:SOURceset / query
Selects the trigger source. Queries the trigger source that is set for the instrument.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | BUS | EXTernal | MANUal | Trigger source to select. |
enum - Returns the selected trigger source.
:SYSTem:KEYset / query
Simulates the front-panel keys remotely. The key value selects a specific key or control action from the documented table.
| Name | Type | Values | Description |
|---|---|---|---|
| keyval | integer | 0 - 42 | Key value identifying which front-panel key action to simulate. |
:SYST:KEY 2 /*Simulates the CR key on the front panel remotely.*/
:SYSTem:ERRor?query
Queries the last error message in the error queue and clears the error message.
string - Returns the number and contents of the error message, such as -113,"Undefined header; keyword cannot be found".
:SYSTem:VERSion?query
Queries the SCPI version of the current system. The version is returned as a string in YYYY.V format, where YYYY is the year and V is the version number for that year.
string - The SCPI version of the current system in YYYY.V format.
:SYST:VERS? /*Queries the SCPI version of the current system.*/
:SYSTem:IDNset / query
Self-defines the required identification string to be returned through this command. The identification string contains four comma-separated fields and conforms to IEEE-488 standards.
| Name | Type | Values | Description |
|---|---|---|---|
| manufacturer | - | - | Manufacturer string. |
| model | - | - | Product model string. |
| sn | - | - | Serial number string. |
| firmware | - | - | Firmware version string. |
SYSTem:IDN:SET RIGOL,DL3031A,DL3000A000001,00.01.00.04.05
:LIC:SETset / query
Installs an option using the supplied option license string.
| Name | Type | Values | Description |
|---|---|---|---|
| sn | string | - | Option license string to install the option; it is a 28-character uppercase alphanumeric string. |
:LIC:SET UVF2L3N3XXKYTB73PPRSA4XDMSRT